Retoma de uma plataforma médica que trata dados de saúde

O contexto

Uma plataforma de acompanhamento de doentes para um consultório que pratica medicina integrativa e nutrição. Contém o processo clínico, as consultas, as patologias, os tratamentos e a medicação, os resultados de análises e questionários de saúde preenchidos pelos próprios doentes.

Não partimos de uma folha em branco: a plataforma existia e estava a funcionar. Retomámos o seu desenvolvimento.

O desafio

Retomar uma aplicação que trata dados de saúde acrescenta uma camada de exigência a um exercício já delicado.

Os dados em causa são os mais sensíveis que existem. Patologias, tratamentos, resultados de análises: são dados de saúde na aceção do RGPD, com o regime de proteção reforçada que lhes corresponde. Uma negligência não é um incidente técnico, é um incidente regulamentar.

O modelo de dados médico é intrinsecamente complexo. Um doente tem patologias, que exigem indicações, que correspondem a medicamentos, que interagem com alergias e tratamentos em curso. Não são tabelas ligadas ao acaso: cada relação traduz uma realidade clínica que é preciso compreender antes de modelar.

E herdam-se as decisões dos outros. Retomar código é, antes de mais, aceitar viver com escolhas que não fizemos — e saber distinguir as que realmente atrapalham daquelas que apenas nos desagradam.

O que fizemos

• Uma fase de compreensão antes de qualquer alteração. Numa base existente em produção, o primeiro valor que se traz é não partir nada.
• O desenvolvimento contínuo da plataforma sobre a base instalada: back-end estruturado em módulos, acesso a dados tipado, documentação de API gerada.
• Uma autenticação reforçada — tokens assinados, hash das palavras-passe com um algoritmo concebido para isso, rotação de sessões.
• Painéis de indicadores para a operação corrente: acompanhamento dos doentes, visualização de indicadores, histórico de estados.
• Uma implantação em contentores, reproduzível, com cópias de segurança da base e renovação automática de certificados. Numa aplicação de saúde, a operação faz parte do produto — uma cópia de segurança que nunca foi testada não é uma cópia de segurança.

O resultado

A plataforma está em desenvolvimento contínuo desde 2024, com entregas regulares e versionamento datado.

Este projeto ilustra bem o que é uma retoma bem-sucedida: ao fim de dois anos, a questão de saber quem escreveu que parte já não se coloca. O código passou a ser nosso pelo facto de o mantermos, sem nunca ter sido preciso reescrevê-lo para o tornar nosso.