Fases 0–3 concluidas · 27 Jun 2026

Plano Evolutivo Enfermagem Fácil

3 módulos em construção sobre a base já funcional — Home Care, Administrativo e Admin Geral — sem quebrar o que está pronto.

Fase 0
Fundações
✅ Concluída
Fase 1
Administrativo
✅ Concluida
Fase 2
Home Care
✅ Concluida
Fase 3
Admin Geral
✅ Concluida
Fase 4
PWA + Polish
→ Em andamento
Recurso crítico · Home Care

Funciona sem internet. Sincroniza automaticamente.

O enfermeiro de home care atende pacientes em residências, clínicas particulares e locais onde o sinal de internet pode falhar ou simplesmente não existir. O aplicativo deve continuar funcionando completamente offline — evoluções, medicações, sinais vitais, diárias — e sincronizar tudo automaticamente com o servidor assim que a conexão voltar, sem perder nenhum registro do turno.

Service Worker + Cache PWA
App e dados do turno armazenados no dispositivo. O enfermeiro usa sem precisar carregar nada da rede.
Background Sync Automático
Quando a internet volta, todos os registros pendentes são enviados ao servidor — sem precisar abrir o app novamente.
IndexedDB no dispositivo
Evoluções, medicações e sinais vitais salvos localmente. O enfermeiro registra tudo mesmo sem sinal nenhum.

Indicador na interface: enquanto offline, o app exibe um banner "Modo offline · 3 registro(s) aguardando sync" para o enfermeiro saber o estado da conexão. Quando tudo sincronizar, o contador zera e o banner some.

Os 3 módulos

Módulo 1 · Fase 2
Home Care

Portal do enfermeiro. Vínculos com hospitais e pacientes. Registros offline com sync. Diárias que alimentam o financeiro.

Funciona offline · Sync automático
  • ○Vínculo enfermeiro ↔ hospital (N:N)
  • ○Atribuição enfermeiro ↔ cliente/paciente
  • ○Registro de diárias de home care
  • ○PWA offline + IndexedDB + Background Sync 🔴
  • ○Portal do enfermeiro (sidebar role=enfermeiro)
  • ○Indicador de status de conexão na UI
Executada após Fase 1 (consome financeiro)
Módulo 2 · Fase 1 → Próxima
Administrativo

Financeiro, boletos, WhatsApp automático, chat em tempo real e portal exclusivo do paciente.

Financeiro
  • ○Clientes / pagadores (CPF/CNPJ)
  • ○Diárias: hospital + home care
  • ○Contas a receber / pagar
  • ○Fechamento mensal + orçamentos + recibos
  • ○Estoque + movimentações
Boletos
  • ○Geração e gestão de boletos por cliente
  • ○Controle de vencimento · boletos do mês
  • ○Baixa automática via webhook do banco
  • ○Envio do boleto por WhatsApp
WhatsApp Automático
  • ○Lembrete de boleto (N dias antes)
  • ○Lembrete de atendimento agendado
  • ○Config de antecedência e templates
Chat + Portal
  • ○Chat em tempo real · busca por CPF
  • ○Portal paciente: diárias + medicações
  • ○Acesso por CPF / código único
← Próxima fase — começa por Clientes
Módulo 3 · Fase 3
Admin Geral

Visão de plataforma. Super-admin controla hospitais, faturamento consolidado e telemetria para evoluir a API.

  • ○Gestão de todos os hospitais (super_admin)
  • ○Faturamento consolidado por hospital
  • ○Telemetria: acessos por dia e hora
  • ○Breakdown por OS: Windows / Android / iOS
  • ○Por módulo: quais telas são mais acessadas
  • ○Dashboard telemetria com gráficos
  • ○Guard de rota (redireciona não-super_admin)
Consome access_logs (Fase 0) + financeiro (Fase 1)
Módulo 2 — Novos recursos
Administrativo expandido
Boletos
  • ○ Geração de boleto por cliente
  • ○ Controle de vencimento mensal
  • ○ Baixa automática via webhook
  • ○ Envio por WhatsApp
  • ○ PDF do boleto
Asaas / Pagar.me / Iugu
WhatsApp Automático
  • ○ Lembrete de boleto (N dias antes)
  • ○ Lembrete de atendimento agendado
  • ○ Templates personalizáveis
  • ○ Configuração de antecedência
  • ○ Log de mensagens enviadas
Zapi / Twilio / Meta Business API
Chat em Tempo Real
  • ○ Consulta de paciente por CPF
  • ○ Admin ↔ paciente / familiar
  • ○ WebSocket (Flask-SocketIO)
  • ○ Indicador de não-lidas
  • ○ Integrado ao Portal do Paciente
Socket.io / SSE
Portal do Paciente
  • ○ Login por CPF + código único
  • ○ Diárias e cobranças do período
  • ○ Medicações consumidas
  • ○ Boletos + link de pagamento
  • ○ Quadro de cuidados (timeline)
JWT escopo portal · isolado por CPF
Concluída em 26 Jun 2025
Fase 0 — Fundações
✅ RBAC completo
User.system_role · @role_required · users_bp protegido com JWT
✅ Entidade Hospital
Model + Migration + CRUD completo em /api/v1/hospitals
✅ Telemetria
access_logs: device / OS / browser / módulo em before/after_request
✅ 3 Migrations
e1f2… → f2a3… → a3b4… encadeadas e prontas para flask db upgrade

Pipeline obrigatório por recurso

1 Model 2 Migration 3 Repository 4 Service 5 Schema 6 Controller 7 Routes + Frontend + Testes
API 127.0.0.1:5007 App localhost:3002 DB head 964bcc0ddf19 Moeda amount_cents Erros 422 · 401 · 404 JWT @jwt_required()

Mapa de novos endpoints

Recurso Prefixo Módulo
Hospitais /api/v1/hospitals Fundação ✅
Enfermeiro ↔ Hospital /api/v1/home-care/nurses/:id/hospitals Módulo 1
Atribuições home care /api/v1/home-care/assignments Módulo 1
Diárias home care /api/v1/home-care/shifts Módulo 1
Clientes / pagadores /api/v1/clients Módulo 2
Contas a receber / pagar /api/v1/finance/receivables · payables Módulo 2
Faturamento + fechamento /api/v1/finance/billing Módulo 2
Orçamentos /api/v1/budgets Módulo 2
Estoque + movimentações /api/v1/products · /stock-movements Módulo 2
Diárias home care (admin) /api/v1/home-care/shifts/admin Módulo 2
Boletos (gerar · baixar · PDF) /api/v1/boletos + /webhook Módulo 2
WhatsApp config + regras /api/v1/whatsapp/config · /notification-rules Módulo 2
Chat em tempo real /api/v1/chat/rooms + SocketIO Módulo 2
Portal do Paciente /api/v1/patient-portal/* Módulo 2
Admin hospitais + faturamento /api/v1/admin/hospitals · billing Módulo 3
Telemetria /api/v1/admin/telemetry/* Módulo 3
Status atual

Fases 0–3 Concluidas · PWA em andamento

Backend completo com 19 endpoints e frontend com 16 paginas operacionais. Service Worker e indicador de conexao instalados.

cd c:/prod/farma/api && .venv/Scripts/flask db upgrade