Vero
Plataforma clínica que acompanha a consulta em tempo real e faz a pré-consulta do paciente pelo WhatsApp
Autor principal, pipeline de LLM clínico, agente de pré-consulta e importação de documentos
Repositório privado
Sobre o projeto
Vero dá suporte cognitivo ao médico enquanto o atendimento acontece. O áudio é capturado no navegador e transcrito por streaming; sobre essa transcrição, um serviço de IA clínica levanta hipóteses diagnósticas, aponta sinais de alerta, sugere condutas e prepara um rascunho de prescrição. O médico acompanha tudo em um painel de raciocínio clínico com chat, marcando o que é útil e dispensando o resto, e encerra a consulta com todo o material consolidado. Antes disso, o paciente já foi atendido pelo outro lado da plataforma: um agente no WhatsApp conduz a pré-consulta, coleta queixa, histórico, alergias, medicamentos em uso e exames, e entrega ao médico um caso já organizado em vez de uma ficha em branco. O sistema é um monorepo pnpm em que frontend e backend compartilham os mesmos contratos em TypeScript e Zod, incluindo o formato das mensagens de WebSocket. Dois microsserviços Python completam o conjunto: um cuida do LLM clínico com RAG sobre embeddings, o outro da importação de prontuários e laudos por OCR.
Como funciona
A consulta abre uma sessão com dois canais WebSocket: um para o áudio, outro para o estado. O áudio segue para o Deepgram em streaming e volta como transcrição; a conexão se recupera sozinha com backoff exponencial se a rede oscilar. O serviço de LLM clínico consome a transcrição em andamento, recupera contexto por similaridade sobre a base vetorial e devolve hipóteses, sinais de alerta e sugestões de conduta, que aparecem para o médico à medida que a conversa avança. O painel de raciocínio pode ser maximizado, e o texto chega palavra a palavra em vez de aparecer de uma vez. Documentos em PDF ou imagem passam pelo serviço de importação, que extrai o conteúdo com PyMuPDF ou OCR e organiza os achados no prontuário. Agenda, pacientes, consultas, membros da organização e trilha de auditoria são módulos da API em Fastify, com autenticação por JWT do Supabase.
Arquitetura
- 01
Frontend React com Vite: painel do médico, agenda, consulta ativa e chat de raciocínio clínico
- 02
API Fastify em TypeScript: REST e WebSocket para áudio e estado da consulta
- 03
Módulos da API: consultas, agendamentos, pacientes, médicos, organização e auditoria
- 04
Serviço Python de LLM clínico: pipeline de embeddings, RAG e geração das hipóteses
- 05
Serviço Python de importação: extração de PDF e OCR de prontuários e laudos
- 06
Agente de WhatsApp: pré-consulta conduzida com o paciente antes do atendimento
- 07
Pacote de contratos compartilhados em TypeScript e Zod, inclusive das mensagens WebSocket
- 08
PostgreSQL com Supabase para autenticação, dados e armazenamento
Funcionalidades
- Transcrição da consulta em tempo real, com reconexão automática
- Hipóteses diagnósticas e sinais de alerta durante o atendimento
- Sugestão de conduta e rascunho de prescrição
- Painel de raciocínio clínico com chat, marcando insights úteis ou dispensados
- Tela de encerramento com o material da consulta consolidado
- Pré-consulta conduzida com o paciente pelo WhatsApp
- Importação de prontuários e laudos por OCR
- Agenda e prontuário do paciente com trilha de auditoria
- Contratos compartilhados entre frontend e backend, inclusive no WebSocket
Tecnologias
- Frontend/Backend
- TypeScript
- Frontend
- React 19 · Vite · Tailwind CSS 4 · TanStack Query
- Backend
- Fastify · Node.js · WebSocket · Python · FastAPI
- AI/ML
- Deepgram · OpenAI · RAG
- Tools
- PyMuPDF · pytesseract · Zod
- Database
- PostgreSQL · Supabase
- Infrastructure
- Docker