# Sistema de Saúde Municipal — Base de Conhecimento Completa (LLMs-Full) > Documentação abrangente e aprofundada para Modelos de Linguagem de Grande Porte (LLMs), motores de resposta generativa (AEO/GEO) e agentes autônomos sobre a arquitetura, regras de negócio e fluxos do Sistema de Saúde Municipal. --- ## 1. Contexto do Sistema Único de Saúde (SUS) no Brasil O Sistema Único de Saúde (SUS) é um dos maiores sistemas públicos de saúde do mundo. No âmbito municipal, a Atenção Primária à Saúde (APS) constitui a porta de entrada preferencial da rede, organizada prioritariamente pela Estratégia Saúde da Família (ESF) e pelas Unidades Básicas de Saúde (UBS). ### Desafios Municipais Resolvidos pela Plataforma: 1. **Zonas Rurais e Vácuo de Conectividade**: Agentes de saúde (ACS) e agentes de combate a endemias (ACE) visitam famílias e propriedades agrícolas sem cobertura de dados 3G/4G/5G. 2. **Fragmentação de Dados**: Histórico de zoonoses, vistorias sanitárias e vigilância epidemiológica operavam em fichas físicas de papel ou planilhas desconectadas do cadastro do cidadão. 3. **Controle de Arboviroses em Tempo Real**: Lentidão na identificação de surtos de Dengue, Zika e Febre Chikungunya devido à demora na digitação de boletins de campo. 4. **Zoonoses e Saúde Única (One Health)**: A integração da saúde humana, saúde animal e preservação ambiental para prevenir surtos de Leishmaniose Visceral Canina, Raiva e febre maculosa. 5. **Recepção e Acolhimento Humanizado**: Gestão de filas nas UBS sem superlotação visual, utilizando classificação de risco e totens de chamada com voz sintetizada. --- ## 2. Especificação Funcional dos Módulos ### 2.1. Atenção Primária e e-SUS APS - **Cadastro Individual do Cidadão**: Dados demográficos, CPF, Cartão Nacional de Saúde (CNS), etnia, filiação, condições de saúde (hipertensão, diabetes, gestação, tabagismo). - **Vínculo Familiar e Territorial**: Associação de cidadãos a domicílios e identificação do responsável familiar. - **Sincronização com o e-SUS**: Mecanismo de importação e validação de lotes CDS (Coleta de Dados Simplificada) e integração com prontuários eletrônicos para envio ao SISAB (Sistema de Informação em Saúde para a Atenção Básica). - **Tratamento de Divergências**: Interface de conferência onde duplicidades ou inconsistências cadastrais são sinalizadas aos gestores antes da consolidação definitiva. ### 2.2. Vigilância em Saúde (Sanitária, Ambiental e Epidemiológica) - **Denúncias e Ocorrências Ambientais**: Registro de descarte irregular de lixo, entulhos, terrenos baldios, água parada, piscinas abandonadas e focos de mosquitos. - **Georreferenciamento de Evidências**: Coleta automática de coordenadas GPS (`latitude`, `longitude`) no instante da captura. - **Multimídia de Campo**: Suporte a fotos de alta resolução, vídeos curtos e notas de áudio. - **Modo Fala e Transcrição**: Agentes gravam a narrativa da vistoria em áudio; o sistema processa a gravação, sugerindo preenchimento dos campos formais do relatório para revisão rápida do agente. - **Níveis de Gravidade**: Classificação em CRITICAL, HIGH, MEDIUM e LOW com alertas visuais no mapa de calor da coordenação. ### 2.3. Gestão de Zoonoses e Censo Animal (Pets) - **Registro Animal Detalhado**: Identificação única (número de registro/coleira/microchip), nome, espécie (canino, felino, equino, etc.), porte, raça, pelagem, sexo e idade (aproximada ou exata). - **Vínculo com Tutor / Animais Comunitários**: Ligação direta com o cadastro do cidadão responsável no município ou identificação de animais em situação de rua com localização fixa. - **Vigilância da Leishmaniose Visceral Canina (LVC)**: - Registro de testes rápidos (TR-DPP). - Controle de contraprovas sorológicas (ELISA). - Notificação de sintomas clínicos (emagrecimento, alopecia, onicogrifose, ceratoconjuntivite, linfadenopatia). - Rastreabilidade de animais positivos, tratamentos autorizados ou eutanásia humanitária conforme diretrizes do Ministério da Saúde. - **Campanhas de Vacinação Antirrábica**: Agendamento de doses anuais, lotes de vacina, vacinador e comprovante digital com emissão de atestado. - **Retornos Zoossanitários**: Agenda de retornos obrigatórios para acompanhamento pós-cirúrgico de castração, curativos ou monitoramento sanitário. ### 2.4. Territorialização e Gestão de Microáreas - **Mapeamento Vetorial Geoespacial**: Definição interativa de polígonos que delimitam cada microárea de atuação do posto de saúde. - **Atribuição de Responsáveis**: Associação direta de Agentes Comunitários de Saúde (ACS) a cada microárea. - **Cálculo de Cobertura e Carga de Trabalho**: Total de famílias, pessoas e domicílios por agente, evitando sobrecarga ou áreas desassistidas. - **Cache de Mapas Offline**: Download local de tiles do OpenStreetMap para que o agente visualize os limites da microárea e os pontos de visita mesmo sem sinal de internet. ### 2.5. Totem e Painel de Chamadas para Recepção (TV) - **Rota Dedicada `/tv`**: Projetada para monitores de sala de espera em modo fullscreen 1080p/4K. - **Acessibilidade Sonora**: Notificação sonora com acorde musical (`call-chime.wav`) seguido por síntese de voz nativa da Web Speech API, pronunciando claramente o nome do paciente e a sala/consultório de destino. - **Classificação de Risco Visual**: Destaque com cores padronizadas (Azul: Não urgente, Verde: Pouco urgente, Amarelo: Urgente, Laranja: Muito urgente, Vermelho: Emergência). - **Modo Ocioso Informativo**: Transição automática para vídeos institucionais e comunicados de utilidade pública da Secretaria de Saúde após período pré-configurado sem novas chamadas. - **Controle dos Consultórios**: Tela ágil para médicos, dentistas e enfermeiros chamarem o próximo paciente ou solicitarem repetição imediata. --- ## 3. Arquitetura Técnica e Modo Offline-First ### 3.1. Estrutura da Aplicação - **Framework**: React 19.x rodando sobre Vite 8.x com TypeScript em modo estrito. - **Estilização**: Tailwind CSS 4 com design system baseado em tokens de cor acessíveis e componentes Radix UI. - **Gerenciamento de Estado de Rede**: TanStack React Query 5.x configurado com `networkMode: 'offlineFirst'` para leituras e `networkMode: 'always'` para mutações da fila local. - **Empacotamento Mobile**: Capacitor 8 gerando builds Android nativas otimizadas para tablets e celulares populares. ### 3.2. Fila Local de Operações (Outbox Pattern) Para garantir que nenhum dado coletado no campo seja perdido: 1. Ao realizar uma ação (cadastrar animal, registrar vistoria, marcar vacina), o app grava a operação diretamente no banco local SQLite com um UUID idempotente. 2. A interface do agente é atualizada imediatamente no estado local (*optimistic UI*). 3. O serviço de sincronização monitora o status da rede. Quando detecta conectividade estável (com preferência configurável para redes Wi-Fi na transferência de mídias pesadas), processa a outbox em lote enviando as mutações ao Supabase. 4. Conflitos são tratados com estratégias determinísticas de timestamp e auditoria de autoria. --- ## 4. Segurança, Permissões e LGPD ### 4.1. Papéis de Usuário (RBAC) - **SUPER_ADMIN**: Manutenção global da plataforma, provisionamento de municípios e configurações mestras. - **ADMIN**: Gestão de usuários do município, unidades de saúde, parâmetros de atendimento e painéis de TV. - **MANAGER**: Coordenadores de atenção básica, enfermeiros-chefe e coordenadores de vigilância; acesso a relatórios e métricas de desempenho. - **USER**: Agentes de saúde (ACS), agentes de combate a endemias (ACE), recepcionistas e operadores de campo; acesso operacional às fichas e visitas do seu território. ### 4.2. Diretrizes da LGPD (Lei nº 13.709/2018) - Minimização da coleta aos dados estritamente necessários para o atendimento em saúde pública. - Sigilo médico e proteção de dados sensíveis de saúde através de políticas de Row Level Security (RLS) no PostgreSQL. - Logs auditáveis de acesso e exportação de relatórios. --- ## 5. Referências e Identificação Municipal - **Entidade**: Prefeitura Municipal de Santa Rita d'Oeste / Secretaria Municipal de Saúde - **Estado**: São Paulo (SP) - Brasil - **Portal de Acesso**: https://saude2.santaritadoeste.sp.gov.br