Frida

Visão geral

O Frida gerencia toda a operação clínica e administrativa de uma instituição geriátrica. Desenvolvido na Digitan Agency para um cliente, de ponta a ponta sozinho: modelagem de domínio, backend, frontend e testes.

Problema

Uma residência geriátrica opera com turnos rotativos, dispositivos compartilhados entre cuidadores e uma carga de registro clínico que, no papel, se perde ou se duplica. Sem rastreabilidade individual não há como saber quem administrou qual dose, nem auditar o histórico de um residente.

Solução

Sete áreas funcionais sobre doze bounded contexts:

• Residentes: histórico clínico, consultas e notas
• Sinais vitais: registro e acompanhamento
• Medicação: prescrições e geração de doses
• Equipe: turnos, atividade e rastreabilidade individual por meio de action_code em dispositivos compartilhados
• Quartos e leitos: atribuição e ocupação
• Alertas: avisos derivados do estado clínico
• Administração: controle administrativo e faturamento

Arquitetura

O backend está organizado em doze bounded contexts — account, activity, alerts, clinical_record, consultation, medical, notes, prescription, resident, room, shift e worker — cada um com arquitetura DDD de três camadas: domínio, aplicação e infraestrutura.

Uma camada shared concentra as bases de DDD, a infraestrutura genérica e um event bus construído sobre o pyventus. Os padrões event-driven são aplicados de forma seletiva, só onde o desacoplamento entre contextos justifica.

Qualidade

• 356 testes unitários e de integração com pytest, distribuídos em 76 arquivos
• 38 testes E2E com Playwright, cobrindo autenticação e papéis de autorização

Stack técnica

• Frontend: Next.js, React, TypeScript
• Backend: FastAPI, Python, arquitetura DDD em camadas
• Banco de dados: PostgreSQL
• Eventos: pyventus
• Testes: pytest, Playwright