Enerxia — o ERP de petróleo e gás construído para Angola

O problema que o Enerxia resolve

A maioria das operadoras e prestadores de serviços em Angola gere produção, aprovisionamento e conformidade em folhas de cálculo ligadas por email. Funciona até ao dia em que alguém pergunta: quem aprovou esta alteração de dados bancários do fornecedor? Que versão da regra de IVA estava em vigor quando esta factura foi emitida? Como é que este barril medido no tanque chega à declaração de produção enviada à ANPG?

Nenhuma dessas perguntas tem resposta numa folha de cálculo. Têm resposta num sistema onde cada mutação é auditada, cada regra tem data de efeito, e cada registo transaccional é anulado ou revertido — nunca apagado.

O Enerxia foi construído a partir dessa exigência, e não a partir de um conjunto de ecrãs. A regra de negócio vive na camada de domínio e em mais lado nenhum; uma regra duplicada num componente é um defeito, não uma conveniência.

Como está construído

A arquitectura é deliberadamente aborrecida, porque um ERP industrial é lido durante dez anos e escrito durante dois. Next.js 15 com React 19 no topo, uma camada de API que trata de autenticação, autorização, validação, idempotência, auditoria e limitação de tráfego, os serviços de domínio por baixo, e um repositório que injecta o âmbito de empresa e sucursal sem possibilidade de contorno.

O PostgreSQL 16 não é um depósito passivo: constrangimentos, transacções e uma tabela de auditoria apenas-de-adição fazem parte do desenho. A conta da aplicação não tem permissão de UPDATE nem DELETE sobre as tabelas de auditoria — a separação é ao nível do papel na base de dados, não ao nível da boa intenção do código.

Os seis blocos de negócio

Os trinta e três domínios agrupam-se em seis blocos. Não são módulos vendidos à parte: partilham o mesmo motor de aprovações, o mesmo serviço de numeração, a mesma conversão de unidades e o mesmo registo de auditoria.

Engenharia regulatória angolana

É aqui que um ERP genérico importado falha em Angola. As regras que interessam — IVA, retenções, conteúdo local, partilha de produção — não são as mesmas que em Lisboa ou em Houston, e mudam com data de efeito.

No Enerxia nenhuma dessas regras está escrita em código. São configuração versionada com `effective_from` e `effective_to`, o que significa que uma factura emitida em Março é calculada com a regra de Março mesmo que a regra tenha mudado em Junho. Reemitir um documento antigo não o recalcula com a lei de hoje.

As não-negociáveis

Seis regras decidem o que entra no sistema. Não são aspirações de documento de arquitectura; são as condições que fazem um registo industrial defensável numa auditoria.

1. 01As regras regulatórias são configuração datadaImposto, conteúdo local e limiares de aprovação nunca são código.
2. 02Nada transaccional é apagadoCancela-se, anula-se, reverte-se ou versiona-se. Apagar não é uma operação disponível.
3. 03Toda a mutação é auditadaRegisto apenas-de-adição, imutável para utilizadores comuns, com um identificador de correlação que atravessa o fluxo inteiro.
4. 04Equivalência técnica é decidida por um engenheiroO sistema nunca infere automaticamente que duas peças são substituíveis.
5. 05Nada está completo sem prova de teste167 suites de testes — unitários, integração, permissões, casos negativos e ponta-a-ponta.
6. 06Nenhum facto regulatório é inventadoDesconhecido significa bloqueado e configurável, não um valor plausível colocado por omissão.

A espinha de rastreabilidade

Cada módulo tem de preservar esta cadeia. Uma funcionalidade que a quebre está incompleta, por muito bem que os seus ecrãs funcionem. É o que permite responder, meses depois, como é que um barril medido no tanque se tornou uma linha numa declaração fiscal.

Estado actual, sem inflação

O Enerxia está em produção, em piloto, com duas empresas e trinta e seis utilizadores, e o registo de auditoria já ultrapassou os sessenta e seis mil eventos. Não vamos apresentar isto como um produto adoptado por todo o sector angolano, porque não é — e um número inventado numa página como esta custaria mais do que qualquer contrato que trouxesse.

O que é verdade é mais útil: o sistema existe, corre, é mantido por nós, e pode ser aberto e demonstrado módulo a módulo. Se quiser ver a contabilidade de produção, o motor de aprovações ou a exportação SAF-T a funcionar sobre dados reais, pedimos uma hora e mostramos em vez de descrever.