Files
Investidor-V2/docs/investmoz/existing-business/canonical-integrity.md
T
nala 3dc7c5c649
tests / ci (push) Canceled after 0s
commit 30/9
2026-09-30 09:05:43 +02:00

3.0 KiB

Integridade do schema canónico — 29/09/2026

Diagnóstico e âmbito entregue

A aplicação continua a usar public.existing_businesses e os serviços de intake/revisão privados. As 70 tabelas mne são um modelo físico separado, ainda sem ligação aos fluxos da aplicação. A presença das tabelas não significa que o mercado completo esteja implementado.

Foi aplicado migrations/003_mne_integrity.sql ao PostgreSQL 17 local. Acrescenta 81 índices onde nenhuma chave de índice B-tree completo cobre o prefixo da chave estrangeira. Índices parciais não asseguram cobertura de todos os registos. Não cria tabelas, copia negócios ou altera dados.

Os históricos audit_events, business_status_history, document_versions e negotiation_events passam a recusar UPDATE, DELETE e TRUNCATE, incluindo operações sem linhas afectadas. Novas evidências continuam a ser inseridas. Correcções devem ser novos eventos. Os triggers não impedem um administrador da base de dados de os desactivar; a separação de papéis operacionais permanece necessária.

Validação e reversibilidade

  • Teste reproduzível: tools/test-mne-integrity.php, exclusivamente em portal_services_test, porta 55441, APP_ENV=testing.
  • Criação isolada de 001 e 002; aplicação dupla de 003 sem índices duplicados; todas as FK com cobertura; 12 mutações recusadas; DOWN seguido de reaplicação; rollback integral da transacção de teste.
  • Backup completo e restauro isolado com contagens reconciliadas de 204 tabelas: storage/app/private/mne-integrity-backup-20260929-185518/.
  • Aplicação local com contagens preservadas de 91 tabelas mne/investmoz: storage/app/private/mne-integrity-20260929-185534/.
  • Reversão deste incremento: migrations/003_mne_integrity_down.sql. Remove apenas os triggers, a função e os índices identificados como pertencentes a 003. Não executar o DOWN integral 001 para reverter este incremento.

Nenhuma mudança de UI, API ou eventos externos; o OpenAPI mantém o contrato privado existente. Não foi executada a suite completa da aplicação neste incremento SQL. Nenhum commit Git foi criado.

Trabalho ainda necessário

A fase de modelo e integração continua incompleta. Antes de adoptar o schema mne nos serviços é necessário resolver a identidade dos utilizadores (public.users.id bigint versus mne.parties.user_id UUID), o vínculo dos sectores e a migração reconciliada dos negócios existentes, sem criar cópias concorrentes. Publicação com duas aprovações, documentos/scanner, catálogo anonimizado, CRM, sala segura, negociação e facturação continuam pendentes conforme a matriz de implementação. Este incremento não constitui aprovação de produção nem entrega integral do prompt.

Incremento seguinte iniciado e aplicado: ponte de compatibilidade 004, com vínculos, backfill e repositório legado. A integração canónica completa continua pendente; consultar os gates e resultados nesse documento.