Documentação Técnica e Compliance

Visão Geral do Sistema

O Museu Povo de Fé e de Festa é um museu virtual do Pontão de Cultura Rede Foliar e da AAFCP, voltado para o registro e a difusão de festas, romarias, promessas e folguedos das comunidades do Amapá. O sistema web permite organizar e consultar imagens, vídeos, documentos e descrições, com recursos de acessibilidade e mediação cultural assistida por inteligência artificial.

Arquitetura e Tecnologias

Backend em Django 6.x (Python), app principal cultural_acervos.
Banco de dados padrão em desenvolvimento: SQLite.
Templates HTML com herança a partir de base.html.
Estilos em static/css/modern_gallery.css, com uso de Bootstrap 5.3 e Font Awesome 6.4 via CDN.
Arquivos estáticos servidos em /static/ e mídia em /media/.

Páginas Públicas Principais

Página inicial (landing_clone.html): apresenta o museu, destaques do acervo e acesso ao chat.
Coleções (colecoes.html): organiza o acervo em ciclos e coleções, com navegação visual e textual.
Sobre (sobre.html): reúne informações institucionais sobre o museu, o Pontão e a AAFCP.
Páginas complementares: política de privacidade, termos de uso, LGPD, cookies, direitos autorais, aviso legal, acessibilidade, FAQ e contato.

Chat do Museu e IA (Museu Syn)

O sistema conta com um agente conversacional chamado Museu Syn, que responde em português brasileiro a perguntas sobre o museu, as festas e o acervo. O chat é acessado por um botão flutuante no canto inferior direito da tela e utiliza um modelo de linguagem executado via servidor Ollama.

Endpoint de API: /api/ollama-chat/, definido em cultural_acervos/api_views.py.
O backend monta um contexto com descrições do acervo e de documentos de referência.
O modelo é configurável via variáveis OLLAMA_BASE_URL e OLLAMA_MODEL em settings.py.
Erros de rede ou da IA são tratados e retornados ao usuário em mensagens claras.

Acessibilidade Digital

A plataforma foi desenvolvida com foco em acessibilidade para diferentes perfis de público, incluindo pessoas cegas, com baixa visão e pessoas surdas usuárias de Libras.

Marcação semântica em HTML com lang="pt-br", uso de <main>, <nav> e <footer>.
Link de atalho “Ir para o conteúdo principal” para navegação por teclado.
Integração oficial com o widget VLibras, permitindo tradução do conteúdo textual para Libras.
Chat acessível com foco gerenciado, suporte a teclado, aria-labels e área de log com aria-live.
Guia em áudio na página inicial, com player HTML5, permitindo que usuários escutem uma descrição da página.

Execução e Ambiente de Desenvolvimento

Instalação de dependências via pip install -r requirements.txt.
Aplicação de migrações com python manage.py migrate.
Coleta de arquivos estáticos com python manage.py collectstatic --noinput.
Execução local do servidor de desenvolvimento com python manage.py runserver.
Integração com Ollama rodando localmente em http://127.0.0.1:11434 ou em servidor dedicado.

Políticas, Termos e Contatos

Os documentos de compliance e as políticas relacionadas à privacidade, proteção de dados e uso do acervo podem ser acessados pelos links abaixo: