Sistema de agenda e prontuário feito sob medida
O software antigo não conversava com o atendente de IA. O sistema novo agenda sozinho, nunca marca dois pacientes no mesmo horário e já roda em duas clínicas.
Clínicas de saúde. Em produção. Desde jul. de 2026.
- 2
- clínicas usando o mesmo sistema
- Zero
- pacientes marcados no mesmo horário
- 1.074
- testes automáticos antes de cada atualização
O problema
O consultório já tinha um atendente de IA no WhatsApp, mas o sistema de prontuário não deixava nenhum outro programa ler ou marcar consultas. O atendente não enxergava a agenda.
Antes de construir, testei a migração para um sistema de prontuário do mercado. O teste foi cancelado: a conexão era lenta e limitada. Ficar sem integração custava mais do que ter um sistema próprio.
Na prática




O resultado
- Em uso em duas clínicas, com o mesmo sistema.
- O atendente de IA agenda, confirma e remarca sem passar pela secretária.
- Cada atualização só vai ao ar depois de passar por 1.074 testes automáticos.
O que ficou de aprendizado
Quando quem mais usa o sistema é um atendente de IA, toda função nova nasce pensando nele, e não só na tela da equipe.
Em saúde, o sistema cresce por etapas: a agenda veio primeiro, já com espaço previsto para o prontuário.
Detalhes técnicosArquitetura, desafios e ferramentas, para quem é da área.
Painel da equipe e agente de IA usam a mesma API. A regra que impede conflito de horário mora no banco.
Agenda
- Calendário de dia, semana, mês e lista, com janelas de atendimento abertas e fechadas clicando na grade.
- Pré-reserva com validade: o horário fica segurado e se libera sozinho.
- Google Agenda e sala de vídeo nos dois sentidos, e webhooks de eventos para o agente.
Prontuário
- Permissão clínica separada da administrativa.
- Registro assinado não se apaga nem se altera: o que existe é retificação com autor e motivo.
- Log de acesso encadeado por hash, para provar que ninguém mexeu no histórico.
- Prescrições com catálogo, modelos e receitas programadas para assinar em lote.
- Assistente de IA dentro do prontuário: o médico vê exatamente o texto que a IA vai receber, o contexto vai sem identificadores e o trecho só entra no rascunho por ação dele.
Para quem opera é máquina
- API REST com chaves por escopo (leitura, escrita, admin), idempotência nas escritas e limite de requisições.
- Modo de simulação para testar escrita sem gravar.
- O contrato da API nasceu do lado do agente: o que ele precisava virou o documento de integração.
- Telas por função: médico, secretária e gestão entram cada um no próprio trabalho do dia.
Operação
- Um único código atende várias instalações, cada uma com servidor e banco próprios e identidade visual calculada a partir de uma cor (OKLCH, com contraste acessível garantido).
- Deploy automático a cada merge, uma instalação por vez: a primeira serve de canário.
- Backup cifrado com teste de restauração, vigia externo de saúde e segundo fator no login.
- Importadores do sistema anterior.
Desafios
- Constraint de exclusão GiST no Postgres: duas consultas no mesmo horário são impossíveis no banco, não só na tela. Uma ganha, a outra recebe 409.
- Triggers que impedem apagar registro assinado.
- Schema separado para o arquivo histórico importado.
- LGPD de verdade: exportar os dados de um paciente, anonimizar mantendo o histórico e trilha de auditoria.
Decisão difícil
Construir em vez de comprar
Ferramenta pronta não expunha o que o agente precisava. O piloto com um sistema de mercado provou isso na prática, e o custo de construir ficou menor que o de continuar sem integração.
Ferramentas: Next.js 15, TypeScript estrito, PostgreSQL 16, Prisma, Docker Compose, GitHub Actions, Google Calendar API.