Saltar para o conteúdo
Henrique Vieira
Todos os projectos

Gestão escolar multi-tenant, em produção

Plataforma escolar

Numa plataforma escolar em produção, sou responsável pelo sistema financeiro, pela hospedagem, pela segurança e pela aprovação do que entra em produção.

Papel
Sistema financeiro, hospedagem, segurança e aprovação final das alterações
Período
Jul 2026 - presente
Estado
Em produção
Tecnologias
NestJS 11PrismaPostgreSQLRedisBullMQNext.js 15React NativeDocker

O problema

Uma plataforma escolar em produção cobra propinas por referência Multicaixa. Quando um pagamento não é reconhecido, uma família que pagou aparece como devedora.

O meu trabalho é manter os pagamentos certos, a plataforma no ar e a segurança à altura dos dados que guarda, sem parar o serviço.

A abordagem

  1. 01

    Reconciliação que lê todas as cobranças

    A tarefa de reconciliação percorre todas as páginas da listagem do gateway, com duas protecções: detecta páginas repetidas e tem um limite máximo de páginas. Se o formato da resposta mudar, regista o motivo e pára, em vez de terminar com uma leitura incompleta.

  2. 02

    Repetir quando o número já foi usado

    Quando o gateway recusa um número de transacção por já estar usado, o sistema avança para o seguinte e tenta de novo, até 15 vezes, registando cada recusa. Ninguém tem de repetir o pedido à mão.

  3. 03

    Hospedagem e cópias de segurança

    Contentores com imagens versionadas, publicação controlada e cópias de segurança com o restauro testado: uma cópia só conta se se conseguir restaurar.

  4. 04

    Aprovação final

    Tudo entra por pedido de alteração, e sou eu que o aprovo. Verifico os testes e as regras automáticas, o que acontece se a alteração falhar em produção e como se volta atrás.

Os resultados

100%
das cobranças da janela reconciliadas, com paginação e protecções contra estagnação
Em produção
com cada alteração revista e aprovada antes de entrar
15
tentativas automáticas quando o número de transacção já foi usado, sem intervenção manual

O que aprendi

Uma tarefa de verificação que termina incompleta sem avisar é pior do que uma que falha. Desenho estas tarefas para registarem o motivo e pararem quando não conseguem fazer o trabalho todo.

Caso seguinte

AutoPropina

API de cobranças por referência Multicaixa, multi-tenant

Ler o caso