docs+setup: Missão 9 (parcial, encerrada a pedido do operador mid-execução)

Correção de fato: CONSTRUCAO/MMMODAS/RINCAO/UNIAO são cópias reais de 4
clientes (Cliente A-D), não dado de teste como uma sessão anterior (Missão
6/7) generalizou por engano a partir do Agent 2 (esse sim, teste).
docs/EVIDENCE_SOURCES.md e docs/PROJECT_STATE.md corrigidos.

Bloco 0 (setup seguro) concluído: os 4 originais copiados para work_copies/
(git-ignored, .FDB maiúsculo já coberto pelo padrão existente), hash SHA-256
idêntico antes/depois da cópia (manifestos commitados). CRT/UF/regime
confirmados direto de cada banco via company_context (nunca perguntado ao
operador): A=CONSTRUCAO CRT1, B=MMMODAS CRT1, C=RINCAO CRT3, D=UNIAO CRT1.
4 Agents novos registrados (IDs 618-621, installation_ids novos, nunca
reaproveitando o Agent 2), .env por instalação (gitignored - contém tokens
reais), FIREBIRD_WRITES=0, escrita restrita ao próprio work copy de cada um.
docs/LOCAL_WRITE_ALLOWLIST_V1.json atualizado para apontar a work_copies/ em
vez de Banco/ - os originais nunca mais devem ser abertos em modo de escrita.

Bloco 1.3 concluído: busca web real confirma cClassTrib já obrigatório desde
03/08/2026 para CRT=3 (Cliente C) e só a partir de 2027 para CRT=1 (A/B/D) -
o motor já implementava essa regra corretamente, nenhuma mudança de código.

Restante da missão (diagnóstico completo de 18 campos, aprovação dos
datasets P2-P4, cascata de escrita, lançamento dos Agents C/D) NÃO foi
executado: 3 ações foram negadas pelo classificador de modo automático desta
sessão (nunca contornadas por outra via, por instrução explícita da própria
negação) e a sessão foi encerrada a pedido do operador com 2 jobs reais
(Cliente A e B) ainda RUNNING no Hub local. Detalhe completo, incluindo o
que uma sessão futura deve verificar primeiro, em docs/MISSAO_9_LOG.md.

Nenhuma mudança de código nesta sessão - só documentação, setup de
ambiente de trabalho e tentativas de execução operacional. Nenhuma escrita
fiscal real em nenhum banco (nem original, nem cópia).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
gti
2026-09-29 00:45:14 -03:00
co-authored by Claude Sonnet 5
parent 693cb8b7c1
commit 156392e7e3
9 changed files with 285 additions and 24 deletions
+34 -4
View File
@@ -1,11 +1,24 @@
# Project State — GTI Fiscal (2026-09-28, fim da Missão 8)
# Project State — GTI Fiscal (2026-09-29, fim da Missão 9 — encerrada a meio da execução)
Leitura obrigatória antes de qualquer nova missão fiscal (CLAUDE.md aponta para cá). Sem dado de
cliente (nomes, CNPJ, descrição de produto) — só fatos de estado do sistema.
cliente (nomes, CNPJ, descrição de produto) — só fatos de estado do sistema. **Leia também
`docs/MISSAO_9_LOG.md` antes de continuar** — tem o detalhe completo do que ficou pendente.
> [!IMPORTANT]
> **SEPARAÇÃO RIGOROSA TESTE vs PRODUÇÃO (`DADO_DE_TESTE=true`)**:
> Todas as bases Firebird analisadas até hoje (Agent 2 e os 5 bancos de laboratório CONSTRUCAO, MMMODAS, RINCAO, UNIAO, TESTESOFICIAIS) são **dados de teste e homologação**. Nenhum cliente real passou pelo motor ainda. Qualquer métrica ou constatação levantada sobre essas bases representa validação técnica de mecanismo de software, **não achado ou diagnóstico contábil sobre nenhum cliente**.
> **CORREÇÃO (Missão 9)**: o banner anterior aqui afirmava que CONSTRUCAO/MMMODAS/RINCAO/UNIAO
> eram dado de teste — **estava errado**, generalizava a partir do Agent 2 (esse sim, teste).
> Confirmado com o operador: são **cópias reais de 4 clientes de verdade** (Cliente A–D). A partir
> de agora, escritas só em `work_copies/<nome>.FDB` (nunca nos originais em `Banco/`) — ver
> `docs/LOCAL_WRITE_ALLOWLIST_V1.json` (atualizado) e `docs/MISSAO_9_LOG.md`. Agent 2/GTI.FDB e
> TESTESOFICIAIS.FDB continuam sendo, esses sim, ambiente de teste/homologação.
> [!WARNING]
> **Missão 9 foi interrompida a pedido do operador (desligamento da máquina) com trabalho em
> andamento.** 3 ações foram negadas pelo classificador de modo automático da sessão (diagnóstico/
> cascata completa via `local_completion.py`; lançar 2 Agents em paralelo; aprovar datasets
> P2-P4) — não foram contornadas. 2 jobs reais do Agent (Cliente A e B) ficaram `RUNNING` no
> Postgres do Hub local quando a sessão encerrou — **confira o status deles antes de assumir
> qualquer coisa sobre a instalação A/B**. Detalhe completo em `docs/MISSAO_9_LOG.md`.
## Versões
@@ -67,6 +80,23 @@ cliente (nomes, CNPJ, descrição de produto) — só fatos de estado do sistema
- **Checklist de Onboarding Seguro**: Roteiro formalizado em `docs/ONBOARDING_PRIMEIRO_CLIENTE_REAL.md` (leitura em lotes de 50-100 itens, throttling 50-100ms, transação isolada, rollback instantâneo e operação inicial em DRY-RUN sem auto-fill por N=3 ciclos).
- **Runbook de Disaster Recovery do Hub**: Procedimento de recuperação rápida em menos de 3 minutos formalizado em `docs/RUNBOOK_DR_HUB.md`.
## Missão 9 — Instalações reais em cópia de trabalho (2026-09-29, parcial)
- 4 clientes reais (CONSTRUCAO/MMMODAS/RINCAO/UNIAO — Cliente A–D) copiados para
`work_copies/*.FDB` (git-ignored), hash do original verificado igual antes/depois. Originais em
`Banco/` nunca mais devem ser abertos em modo de escrita.
- 4 Agents novos registrados (IDs 618–621, nunca reaproveitando o Agent 2):
Cliente A `880def5d-09bb-45c4-a5b7-95d32646d122` (CONSTRUCAO, CRT1), Cliente B
`de1b7a5b-dd83-4094-8af9-3787ec4cc2bd` (MMMODAS, CRT1), Cliente C
`c143f1ce-e471-49a4-b090-28d35f8659d3` (RINCAO, CRT3, **cClassTrib já obrigatório desde
03/08/2026**), Cliente D `219a2a5a-3543-47d8-9fd8-5957b52ce133` (UNIAO, CRT1). `.env` de cada um
em `work_copies/agent_envs/` (não versionado). Só A e B chegaram a rodar um job real; C e D
**nunca foram lançados** (bloqueado por permissão, ver `docs/MISSAO_9_LOG.md`).
- `docs/LOCAL_WRITE_ALLOWLIST_V1.json` atualizado: aponta para `work_copies/` em vez de `Banco/`.
- Diagnóstico completo de 18 campos e cascata de escrita **não executados** (3 ações bloqueadas
pelo classificador de modo automático da sessão, nenhuma contornada). Ver `docs/MISSAO_9_LOG.md`
para o detalhe exato e o que fazer numa próxima sessão.
## Índice de Documentos-Chave (docs/)
- `EVIDENCE_SOURCES.md` — matriz de fontes de teste vs o que falta validar com cliente real.