Roadmap Técnico-Funcional

Este roadmap organiza o desenvolvimento do Cidade Gov em fases estratégicas, priorizando segurança, estabilidade e valor incremental. Cada fase constrói sobre a anterior, garantindo que funcionalidades críticas sejam consolidadas antes de avançar para integrações complexas.

Visão Geral e Prioridades

• Fundação: Multitenancy, login, integrações básicas (já ok)
• Núcleo Crítico: Farmácia + Prontuário (receita assistencial)
• Operacional: Care + Logistics (dia a dia UBS)
• Analítico: Surveillance + relatórios
• Integrações: RNDS/SINAN no final (depende de dados)
• Mobile: Paralelo, após MVP web

Fase	Duração	Módulos/Foco	Entregável Principal
0 (Atual)	Concluída	Multitenancy, Login, Farmácia básica	Login tenant + estoque simples
1	✅ CONCLUÍDA	Farmácia completa + Integration básica	Dispensação + validação CNS
2	✅ CONCLUÍDA	Clinical (Prontuário MVP)	Atendimentos assinados + prescrição
3	3 semanas	Care (Atenção Básica/ACS)	Cadastro familiar + visitas
4	3 semanas	Logistics (Agendamento + Senhas)	Agendas + filas Reverb
5	4 semanas	Imunização/Gestantes + Surveillance base	Carteira vacinal + notificações SINAN
6	3 semanas	Transporte/Frota + VISA/ACE	GPS frota + inspeções
7	3 semanas	Integrações RNDS/BNAFAR + Relatórios	Envio dados nacionais + dashboards
8	4 semanas	NativePHP Mobile + Otimizações	App ACS/offline + testes

Revisar Migrations e Models

• Garantir que todos os dados assistenciais estejam 100% isolados no banco do tenant, sem exceções.
• Auditar relacionamentos entre tabelas centrais e tenants para evitar vazamentos de dados.
• Implementar Row Level Security (RLS) adicional se necessário para isolamento granular.

Tenant-Awareness em Componentes Assíncronos

• Configurar jobs, notificações, cache, Reverb e logs para serem tenant-aware.
• Sempre carregar o contexto do tenant antes da execução de jobs (devido ao multi-database).
• Testar cenários de concorrência e failover entre tenants.

Métricas de Sucesso

• Zero vazamentos de dados entre tenants.
• Auditoria completa de todas as operações críticas.
• Performance consistente em ambientes multi-tenant.

Fase 1: Farmácia Completa + Integração Base (3 semanas)

Status: ✅ CONCLUÍDA - Implementação completa com APIs, Actions e testes

Objetivo: Módulo "vitrine" gerando receita (dispensação).

Funcionalidades Implementadas:

• ✅ Semana 1: Catálogo local + entrada estoque (TenantMedicines, MedicineStock)
• ✅ Semana 2: Dispensação FEFO + inventário + relatórios básicos (DispenseMedicationAction)
• ✅ Semana 3: Validação CNS + APIs completas + testes end-to-end

Entregáveis Concluídos:

• 12 Actions de negócio implementadas
• APIs REST completas com OpenAPI
• 12 testes de feature
• Dashboard com 7 KPIs em tempo real
• Relatórios CSV/PDF
• Controle de estoque com FEFO
• Auditoria completa (OwenIt)
• Isolamento tenant 100%

Critérios de Sucesso: ✅ Farmacêutico completa ciclo entrada-dispensação sem papel.

Fase 2: Clinical/Prontuário MVP (4 semanas)

Status: ✅ CONCLUÍDA - Implementação completa com PEP funcional

Objetivo: Conformidade S-RES SBIS, base para todos atendimentos.

Funcionalidades Implementadas:

• ✅ Semana 1-2: Paciente + atendimento/evolução versionada (ClinicalEncounter, Patient)
• ✅ Semana 3: Prescrição digital + integração Farmácia (ClinicalPrescription)
• ✅ Semana 4: Assinatura + auditoria + testes CFM (Evolution versionada)

Entregáveis Concluídos:

• 13 Actions de negócio implementadas
• Controllers completos para todas as entidades
• 8 testes de feature
• Dashboard com 4 KPIs em tempo real
• Prontuário eletrônico completo
• Prescrições digitais
• Auditoria e versionamento
• Isolamento tenant 100%

Critérios de Sucesso: ✅ Médico assina prontuário, receita vai Farmácia automaticamente.

Fase 3: Care - Atenção Básica/ACS (3 semanas)

Objetivo: Cobertura territorial ESF.

• Semana 1: Cadastro familiar + estratificação risco
• Semana 2: Visitas ACS mobile-ready
• Semana 3: Relatórios e-SUS + integração Prontuário

Critérios: ACS registra visita offline, sync servidor.

Fase 4: Logistics - Agendamento/Senhas (3 semanas)

Objetivo: Reduzir filas UBS 50%.

• Semana 1: Agendas profissionais + booking paciente
• Semana 2: Painel senhas Reverb
• Semana 3: Lembretes Whatsapp + relatórios ocupação

Critérios: Paciente agenda via WhatsApp, recepção emite senha digital.

Fase 5: Imunização/Gestantes + Surveillance Base (4 semanas)

Objetivo: Programas prioritários + notificações.

• Semana 1-2: Imunização (carteira + RNDS)
• Semana 3: Gestantes pré-natal
• Semana 4: SINAN notificações + integração Care

Critérios: Cobertura vacinal reportada RNDS.

Fase 6: Transporte/Frota + VISA/ACE (3 semanas)

Objetivo: Otimização logística vigilância.

• Semana 1: Transporte sanitário + despacho
• Semana 2: Frota GPS (listener MQTT) + roteirização
• Semana 3: Inspeções VISA/ACE + dashboards geo

Critérios: Gestor vê frota real-time, otimiza nebulização.

Fase 7: Integrações Completas + Relatórios (3 semanas)

Objetivo: Conformidade 100% SUS.

• Semana 1: RNDS/BNAFAR envio produção
• Semana 2: SIGTAP faturamento + CNES sync
• Semana 3: Relatórios consolidados todos módulos

Critérios: 95% envios RNDS OK, dashboards executivo.

Fase 8: NativePHP + Lançamento (4 semanas)

Objetivo: Mobile para campo.

• Semana 1-2: App ACS (visitas/imunização offline)
• Semana 2: App Frota (motoristas)
• Semana 3: Testes UAT + deploy produção

Critérios: 1º tenant beta live com app.

Recursos e Métricas por Fase

Fase	Esforço Estimado (h)	Status	Métricas Sucesso
1	✅ 120h (Concluído)	✅ Implementado	100 dispensações teste
2	✅ 160h (Concluído)	✅ Implementado	50 prontuários assinados
3	100h	Pendente	200 visitas sync
4	110h	Pendente	90% agendas ocupadas
5	140h	Pendente	95% notificações RNDS
6	100h	Pendente	Rotas 20% mais eficientes
7	110h	Pendente	98% uptime integrações
8	150h	Pendente	1 tenant beta live

Dicas de Execução

• Sprints: 1 semana review/demo com cliente fictício
• Testes: 20% tempo em automação (Pest/Dusk), foco fluxos críticos
• Monitoramento: Sentry + Laravel Telescope desde Fase 1
• Cliente Beta: Após Fase 4, 1 prefeitura pequena (Formosa-GO ideal)
• Receita: Venda após Fase 2 (Farmácia + Prontuário)
• Status Atual: Fases 1-2 ✅ CONCLUÍDAS - Pronto para iniciar Fase 3 (Care/Assistencial)

📊 Arquivos de Apoio Detalhados

A pasta docs/externos/ contém arquivos complementares com visualizações detalhadas do roadmap:

📋 CidadeGov_Roadmap_Detalhado.xlsx

Planilha Excel completa com 3 abas detalhadas:

Roadmap: 26 tarefas detalhadas com:

• ID único, fase, duração e esforço (horas)
• Dependências entre tarefas
• Status atual e datas de início/fim
• Milestones críticos marcados

Resumo por Fase: Totalizadores consolidados:

• Semanas e horas por fase
• Quantidade de tarefas por fase
• Dependências críticas

Métricas de Sucesso: Critérios de aceite específicos:

• "100 dispensações teste" (Fase 1)
• "95% notificações RNDS" (Fase 5)
• "1 tenant beta live" (Fase 8)

📈 CidadeGov_Gantt_Roadmap_Detalhado.png

Gráfico Gantt visual profissional com:

✅ 26 tarefas distribuídas em 8 fases com cores diferenciadas ✅ Marcadores de milestone (losango dourado) para entregas críticas ✅ Linha "HOJE" para referência temporal atual ✅ Grid temporal com marcação mensal e semanal ✅ Duração total: 27 semanas (10/03/2026 a 14/09/2026)

� CidadeGov_Gantt_Roadmap.png

Versão adicional do gráfico Gantt com visualização alternativa para apresentações.

📈 Estatísticas Consolidadas do Roadmap

Métrica	Valor	Status
Total de Horas	1.130 horas	Estimado
Duração Total	27 semanas (~6,7 meses)	Estimado
Total de Tarefas	26 tarefas	Estimado
Milestones	6 marcos críticos	Estimado
Data Início	10/03/2026 (hoje)	✅ Realizado
Data Fim Estimada	14/09/2026	Estimado
Fases Concluídas	2/8 (25%)	✅ Fases 1-2 Finalizadas
Horas Executadas	~280h	✅ Farmácia + Clinical
Valor Agregado	Alto	✅ Núcleo assistencial funcional

💡 Dica: Use estes arquivos para apresentações executivas, planejamento detalhado de recursos e acompanhamento visual do progresso.

Métricas de Sucesso

• Prontuário funcional para atendimento diário.
• Auditoria impecável e compliance regulatório.
• Base para análise de saúde pública.