Plataforma hospitalar: notificações, um Drive com permissões e escalas bloqueadas
Software de operações para um hospital na Holanda: escalas e folgas, tarefas e chamados, informações de pacientes e um Drive compartilhado para documentos.
- Função
- Engenheiro de backend
- Período
- dez. de 2025 a abr. de 2026
- Status
- No ar em um hospital na Holanda
- Stack
- NestJS, GraphQL, TypeORM, Postgres, S3
- Problema
- As notificações não chegavam à equipe, os documentos precisavam de compartilhamento no estilo Google Drive que fosse seguro para dados de pacientes, e escalas confirmadas ainda podiam ser editadas.
- O que eu fiz
- Como um dos dois engenheiros de backend, construí notificações em tempo real com GraphQL subscriptions, reconstruí o Drive com permissões herdadas, compartilhamento externo e um log de atividades, e adicionei o bloqueio de períodos da escala com testes end-to-end.
- Resultado
- No ar e em uso no hospital.
O sistema
Um hospital na Holanda roda suas operações do dia a dia nesta plataforma: escalas e folgas da equipe, tarefas e chamados, informações de pacientes e um Drive compartilhado para documentos. Os dados de pacientes e a legislação europeia de privacidade definem o nível de exigência. Cada arquivo e registro precisa estar visível exatamente para as pessoas certas, e todo acesso precisa ser rastreável.
Entrei como um dos dois engenheiros de backend em um time de sete pessoas, com dois engenheiros de frontend, um desenvolvedor mobile, um engenheiro de QA e um líder técnico. O backend é NestJS com GraphQL, TypeORM sobre Postgres e S3 para arquivos.
Engenheiro de backend, de 2025 a 2026. Fui responsável pelo sistema de notificações em tempo real, pela reconstrução do Drive (permissões, compartilhamento, rastreamento de atividades e pastas de pacientes) e pelo bloqueio de períodos da escala, e construí os módulos de Informações do Paciente, de chamados e de DPIA. Documentei a API de cada módulo e trabalhei junto com os engenheiros de frontend, mobile e QA durante a integração. O código pertence ao cliente, então este texto se baseia no meu registro de trabalho, não no repositório.
- em uso no hospital
- Live
- sistemas sob minha responsabilidade
- 3
- pessoas no time
- 7
As partes em que trabalhei. Passe o mouse ou toque em um nó.
Notificações que chegam à pessoa certa
Uma gestora aprova a folga de uma enfermeira.
Minha primeira grande tarefa foi descobrir por que as notificações nunca chegavam nas partes de escala e de Drive do app. Não existia nenhum caminho em tempo real, então construí um com GraphQL subscriptions: um único publisher compartilhado, uma subscription notificationAdded que só entrega eventos endereçados ao usuário logado, e suporte aos dois protocolos de WebSocket para que clientes antigos e novos pudessem se conectar.
Salvar uma notificação a publica uma vez. A partir daí, conectei os eventos que realmente importam para a equipe: pedidos e aprovações de folga, atualizações e remanejamentos de plantões, e comentários em chamados, tarefas e documentos. Uma rodada de ajustes de direcionamento com o time de frontend garantiu que cada evento chegasse exatamente às pessoas envolvidas.
Um Drive com permissões fáceis de entender
Uma enfermeira abre uma escala na pasta da sua ala.
O sistema de documentos precisava funcionar como o Google Drive, mas guardando documentos hospitalares, então o reconstruí a partir do modelo de dados. Os drives dos departamentos e um drive público ficam separados, e os direitos (visualizar, enviar, editar, excluir) são concedidos em pastas e herdados por tudo dentro delas, então o acesso é decidido em um só lugar, não arquivo por arquivo.
Operações que poderiam mudar o acesso sem ninguém perceber são verificadas. Mover uma pasta é validado para que ela não acabe dentro de si mesma nem em um lugar que o usuário não alcança, e mover um arquivo para o drive público remove as permissões antigas, exceto a de edição, então uma movimentação nunca amplia o acesso por acidente. Em volta disso estão as funções do dia a dia: itens com estrela, lixeira, cópia de arquivos e pastas, contagem de arquivos em pastas aninhadas e download de uma pasta inteira.
Compartilhar fora do hospital, e revogar
Alguns documentos precisam sair do prédio. Arquivos e pastas podem ser compartilhados por um link público, opcionalmente protegido por credenciais, ou com pessoas de fora do sistema. Substituí a antiga flag de tipo de acesso por escopos de compartilhamento que descrevem para quem é o link, e removi as colunas obsoletas com uma migration, para que criar, verificar e revogar um compartilhamento sigam uma única regra.
Revogar um compartilhamento corta o acesso externo na hora. Todo compartilhamento, cópia e renomeação é gravado em um log de atividades com seu contexto, junto com contagens de visualizações e downloads, então fica um rastro de quem fez o quê com qual arquivo. Testes unitários cobrem o serviço de atividades e seu listener.
Os pacientes ganharam pastas próprias no Drive, com escopo definido para que arquivos ligados a um paciente só fiquem visíveis para as pessoas autorizadas a vê-los.
Escalas que não mudam depois de confirmadas
Uma escala confirmada não deveria mudar por acidente. Adicionei o bloqueio de períodos: um admin de escalas bloqueia um período confirmado, e a API passa a rejeitar qualquer plantão criado, editado ou excluído dentro dele, então o bloqueio vale seja qual for o cliente que envia a requisição. Períodos bloqueados abrem como somente leitura no app.
Também escrevi testes end-to-end para os fluxos principais da escala: navegar entre períodos, plantões em aberto, upload em massa que salva tudo ou nada, plantões recorrentes editados uma ocorrência por vez ou como série inteira, bloqueio e filtros combinados de área, sala e departamento, verificados para que ninguém veja plantões fora das suas permissões.
Privacidade como funcionalidade
A saúde na Europa funciona sob o GDPR, então a plataforma precisava de mais do que controle de acesso. Construí o módulo de DPIA, onde o hospital registra avaliações de impacto sobre a proteção de dados com seus riscos e as medidas que os mitigam, já populado com um conjunto inicial por meio de uma migration.
Também construí o módulo de Informações do Paciente e a funcionalidade de chamados para solicitar recursos (do modelo de dados e do diagrama ER até a API e a documentação), adicionei a licença pré-parental e atualizei dependências vulneráveis em todo o projeto.
Decisões que valem a pena defender
Um publisher, filtrado por usuário
Toda notificação passa pelo mesmo canal e a subscription filtra pelo destinatário, então um novo tipo de evento é uma chamada de publish, não um novo stream.
Pub/sub em memória em um único servidor
A API rodava em um único servidor, então um publisher dentro do processo bastava. Migrar para um apoiado no Redis é o passo para quando um segundo servidor for adicionado.
Escopos de compartilhamento em vez de uma flag de tipo de acesso
Um escopo diz para quem é o link, o que transforma criar, verificar e revogar compartilhamentos em uma única regra, em vez de casos especiais.
Bloqueios garantidos na API
Um período bloqueado rejeita escritas no servidor, não só na interface, então nenhum cliente consegue alterar uma escala confirmada.
Nas palavras deles
When Emjay joined, we had a project with several key features still outstanding, including Drive and patient-facing modules. He took full ownership of those builds and immediately raised our speed of delivery. Day to day, Emjay is highly independent: he owns features end to end, delivers on time, and asks only the questions that matter. I’d recommend him without hesitation for any full-stack development work.
ThankGod Ajayi