Registo de Certificados de Armazéns de Cereais

Sistema de informação para emissão, rastreamento e gestão de certificados de armazéns de cereais. O sistema serve quatro perfis de utilizador — operadores de armazém, proprietários de cereais, corretores de bolsa e reguladores —, cada um com o seu próprio portal e modelo de permissões.

O domínio é fortemente regulado: cada certificado tem um ciclo de vida definido por lei, as transmissões de titularidade têm de ser auditadas e o sistema tem de se integrar com a infraestrutura da bolsa de mercadorias. A correção não é opcional.

Um engenheiro no papel de Product Owner e de orquestrador de IA. Sete agentes de IA com papéis específicos: analista de negócios, arquiteto, programador, engenheiro de QA, engenheiro DevOps, redator técnico e tradutor.

Cada agente recebeu um briefing estruturado no formato CLAUDE.md: definição do papel, âmbito, restrições, formato de saída e critérios de qualidade. O engenheiro reviu, integrou e tomou todas as decisões finais. Nenhum código gerado foi enviado para o repositório sem avaliação crítica.

O resultado: uma produção equivalente à de uma equipa de 7–9 pessoas, ao custo de um único engenheiro sénior.

13 microsserviços independentes, cada um responsável por um único contexto delimitado:

• Certificate Service — emissão, gestão do ciclo de vida, transições de estado
• Ownership Service — cadeias de transmissão, registo de penhores, pista de auditoria
• Warehouse Service — registo de armazéns, capacidade, estado da acreditação
• Grain Owner Service — perfis dos proprietários, carteira, certificados detidos
• Exchange Integration Service — ponte com a API da bolsa de mercadorias
• Notification Service — alertas orientados a eventos, e-mail, notificações push
• Document Service — geração de PDF, gestão de modelos
• Audit Service — pista de auditoria imutável, relatórios regulamentares
• Auth Service — integração com Keycloak, atribuição de papéis, validação de tokens
• API Gateway — encaminhamento, limitação da taxa de pedidos, rastreamento de pedidos
• Admin Service — operações de back-office, intervenções manuais
• Report Service — análises, painéis, exportações regulamentares
• File Service — armazenamento de documentos, back-end compatível com S3

Cada serviço tem o seu próprio esquema de base de dados, gerido por migrações Flyway. Cada um é executado no seu próprio Deployment do Kubernetes, com limites de recursos, sondas de liveness e readiness e um pipeline dedicado de CI/CD no GitLab.

320 testes automatizados cobrem as camadas unitária, de integração e de contrato. O Testcontainers arranca instâncias reais de PostgreSQL para os testes de integração — sem simulações (mocks) na camada de base de dados.

A abordagem orientada por IA não substitui a competência em engenharia — multiplica-a. A velocidade e a qualidade dependem diretamente da qualificação do orquestrador: compreensão da arquitetura, decomposição de problemas, formulação precisa de prompts e avaliação crítica dos resultados da IA. O ser humano mantém o controlo.

12 dias. 13 serviços. 55 293 linhas. 320 testes. 12 pipelines. 80 endpoints. Um engenheiro.

Cada número é rastreável até um commit no GitLab, um registo de execução de CI/CD ou um relatório de testes. Sem estimativas. Sem maquetas. Sem contagens de linhas inflacionadas por código repetitivo gerado automaticamente.

É este o aspeto da orquestração de IA quando aplicada com disciplina de engenharia — não como atalho, mas como multiplicador de forças.