admin/clientflow_backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document Reconciliation v2 #3

Closed
admin wants to merge 0 commits from feature/document-reconciliation-v2 into main
pull from: feature/document-reconciliation-v2
merge into: admin:main
Conversation 0 Commits - Files Changed -
admin commented 2026-08-06 00:02:14 +00:00
Owner
Copy Link

Resumo

Implementa a arquitetura Document Reconciliation v2 para gestão canónica das relações entre oportunidades e documentos comerciais.

Principais alterações

  • Relações canónicas:

    • PRIMARY
    • SECONDARY
    • HISTORICAL
    • IGNORED
    • REMOVED
    • REASSIGNED
    • REVIEW_REQUIRED

  • Ledger de auditoria append-only.

  • Um PRIMARY por oportunidade e tipo documental.

  • Preservação de decisões manuais durante sync Jasmin.

  • Reassociação sem apagar documentos, linhas ou histórico.

  • Totais e workflow baseados apenas no PRIMARY válido.

  • Compatibilidade antes da migração 007 e durante backfill parcial.

  • Backfill atómico por grupo documental.

  • Preflight antes da migração.

  • Down migration protegida.

  • Idempotência e validação de pertença.

  • UI corrigida para distinguir document_id e link_id.

Migrações

  • migrations/007_document_reconciliation_v2.sql
  • migrations/007_document_reconciliation_v2_down.sql

Validação

  • 30 testes específicos passaram.
  • 3 testes PostgreSQL reais passaram.
  • Suite completa: 591 passed.
  • compileall passou.
  • git diff --check passou.

Deployment

Este PR não aplica automaticamente a migração nem o backfill.

Ordem prevista:

  1. Backup da base.
  2. Executar preflight.
  3. Publicar código compatível.
  4. Aplicar migration 007.
  5. Executar dry-run do backfill.
  6. Aplicar backfill por grupos completos.
  7. Resolver REVIEW_REQUIRED.
  8. Validar paridade.
## Resumo Implementa a arquitetura Document Reconciliation v2 para gestão canónica das relações entre oportunidades e documentos comerciais. ## Principais alterações - Relações canónicas: - PRIMARY - SECONDARY - HISTORICAL - IGNORED - REMOVED - REASSIGNED - REVIEW_REQUIRED - Ledger de auditoria append-only. - Um PRIMARY por oportunidade e tipo documental. - Preservação de decisões manuais durante sync Jasmin. - Reassociação sem apagar documentos, linhas ou histórico. - Totais e workflow baseados apenas no PRIMARY válido. - Compatibilidade antes da migração 007 e durante backfill parcial. - Backfill atómico por grupo documental. - Preflight antes da migração. - Down migration protegida. - Idempotência e validação de pertença. - UI corrigida para distinguir document_id e link_id. ## Migrações - migrations/007_document_reconciliation_v2.sql - migrations/007_document_reconciliation_v2_down.sql ## Validação - 30 testes específicos passaram. - 3 testes PostgreSQL reais passaram. - Suite completa: 591 passed. - compileall passou. - git diff --check passou. ## Deployment Este PR não aplica automaticamente a migração nem o backfill. Ordem prevista: 1. Backup da base. 2. Executar preflight. 3. Publicar código compatível. 4. Aplicar migration 007. 5. Executar dry-run do backfill. 6. Aplicar backfill por grupos completos. 7. Resolver REVIEW_REQUIRED. 8. Validar paridade.
admin added 1 commit 2026-08-06 00:02:15 +00:00
Implement document reconciliation v2 29382ec6c1
admin closed this pull request 2026-08-06 00:10:09 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
admin
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: admin/clientflow_backend#3
Delete Branch "feature/document-reconciliation-v2"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?