Nove módulos que conversam por evento

Monolito modular, e não microsserviços

Nove módulos com fronteira explícita, publicados como pacotes separados, compilando e subindo como uma aplicação só.

O que eu descartei: microsserviços. Numa operação deste tamanho eles trocariam um problema de organização de código por um problema de rede, com transação distribuída, versão de contrato e rastreamento entre serviços, tudo isso sem ninguém de plantão para cuidar.

A fronteira entre módulos existe no código e é cobrada pelo compilador. O custo operacional de uma aplicação distribuída, não.

Os módulos publicam eventos, em vez de chamar uns aos outros

A proposta aprovada dispara um evento, e quem escuta reage: o módulo de projeto cria o repasse, o financeiro monta o plano de pagamento. Projeto concluído aciona compras. Material disponível abre a ordem de serviço com as seis etapas. Obra concluída registra as garantias, e a nota fiscal assinada libera o pagamento.

O que eu descartei: chamada direta entre módulos. Ela funciona com três e vira um grafo impossível com nove, onde acrescentar um módulo novo obriga a editar os antigos.

Um módulo novo passa a escutar um evento que já existe, e nenhum dos outros oito é tocado.

Multiempresa desde a primeira tabela

A coluna que identifica a empresa dona do registro existe desde a primeira migração, e o filtro por empresa é conferido no CI em toda consulta nova. São seis papéis de acesso por empresa, do dono ao instalador.

O que eu descartei: deixar para depois. Fazer no começo custa uma coluna. Fazer depois significa reescrever toda consulta do sistema, e conviver com o risco de esquecer exatamente uma delas, que é a que vaza dado de um cliente para outro.

O campo de formulário nasce num arquivo só, e um script confere as três pontas

A visita técnica é preenchida no computador e no celular, em telas escritas separadamente. O campo é definido num arquivo único de origem, implementado nas duas telas, e um script confere as três pontas.

O que eu descartei: combinar com o time que todo mundo lembre de alterar os dois lados. Uma regra que depende de ninguém errar, todo dia, durante meses, não se sustenta.

Um registro declara a origem verdadeira de cada campo de negócio

Existe um arquivo que mapeia, campo a campo, qual é a fonte canônica do dado e quais cópias são permitidas.

Por quê: sem isso, dois lugares passam a responder a mesma pergunta com números diferentes, e não há como saber qual está certo. Num sistema que calcula comissão e fluxo de caixa, isso não é inconveniência.

Teste de ponta a ponta sem subir servidor

Os testes de integração chamam o roteador tRPC diretamente, em processo, em vez de levantar a aplicação e bater em HTTP.

O que eu ganho: a suíte roda em cada alteração sem depender de porta livre, de tempo de inicialização ou de limpeza de processo pendurado. Teste que demora é teste que alguém desliga.