GTI_GERENCIADOR_FISCAL/docs/PROJECT_STATE.md

Project State — GTI Fiscal (2026-09-28, fim da Missão 5)

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.

Versões

• Hub (produção): 1.3.14, deploy confirmado (DEPLOY_OK, health 200, https://gtifiscal.gtigrupo.com.br/version).
• Agent (última release Windows PUBLICADA): 1.3.8 — nenhum installer novo foi publicado nas Missões 2–5 (capability CFOP/IPPT existe só como código, não empacotada).
• Agent 2 (installation bb50884a-5e78-4f26-8cac-804932dae8de): 1.3.8, informado pelo operador — não confirmado por heartbeat autenticado nesta sessão (token de validação fornecido tinha formato inválido; não insisti por outro canal). Pendente: operador confirmar por print do painel.
• Hub e Agent são versionados independentemente — ver docs/VERSIONING.md.

Migration head

• main (master): 0034_reference_data_registry (33 migrações). Aplicada em produção.
• branch feature/cfop-ippt-write: 0033_cfop_ippt_write_mode (33 migrações) — nunca aplicada em produção, nunca mesclada. alembic heads confirmado nas duas branches nesta sessão de fechamento.
• Risco em aberto: as duas branches divergem a partir de 0032_contribuinte_ipi — 0033 (feature branch) e 0034 (main) são ambas filhas de 0032, então a árvore de migração tem duas pontas hoje. Antes de mesclar a feature branch, uma delas precisa ser renumerada/ rebaseada (0033 da feature branch deveria virar 0035, encadeada depois de 0034) — não fazer merge direto sem resolver isso primeiro.

Reference Data Registry (Missão 5, Fase 1)

• Modelo novo e aditivo em datasets (licença, vigência, hash, erros de parse, aprovação ADMIN). Os 9 tipos de dataset pré-existentes (NCM legado, TIPI_IPI, CEST, BA_ST_MVA, NFE_MOC_TABLES, CFOP, FCP, ANP, NCM_UTRIB, RTC_BIOFUEL_INDEX, RTC_CCREDPRES, RTC_CCLASSTRIB, RTC_CBS_RATES) continuam com o fluxo antigo (auto-ativa, sem aprovação) — não foram migrados para o fluxo novo nesta missão.
• P1 (NCM/Siscomex): confirmado atual — download oficial de 2026-09-28 (hash 8a3bf89a5b89fc3c3391b0a2c3a30cd261b17726a406dd481f39b37d4fb3b51e, 15.156 linhas) é idêntico ao dataset NCM já ativo. Nenhum DRAFT pendente de aprovação (reconhecido como inalterado). Manifesto: docs/REFERENCE_DATASET_MANIFEST_V1.md.
• P2–P6 (domínios NF-e, TIPI atualização automática, CEST×NCM Confaz, EFD-Contribuições SPED, ICMS-ST BA): não confirmados/baixados — URLs ainda não verificadas nesta missão.
• Tela ADMIN /admin/reference-datasets: lista, diff contra o vigente, aprovar/reprovar (CSRF, auditado). Nenhum DRAFT pendente de decisão no momento.

Decisões ADMIN pendentes (Agent 2, card "Contexto Fiscal")

1. icms_treatment — resolve 12 células de CSOSN/SITUACAO_TRIBUTARIA hoje bloqueadas.
2. pis_cofins_profile — NOT_APPLICABLE, OPERATION_TIME ou perfil JSON (~3.152 células).
3. entry_scope — INTRA/INTER/MIXED_OR_DYNAMIC para CFOP_ENTRADA.

Nenhuma foi clicada. Nenhuma escrita fiscal real ocorreu em nenhuma missão.

O que foi feito (Missões 1–5) e o que falta

• M1/M2 (fechamento de lacunas fiscais): dry-run completo do universo, motor PIS/COFINS/CFOP_ENTRADA com gate por decisão ADMIN auditada, dossiê para o contador (anonimizado em central/static/docs/), UI Contexto Fiscal.
• M3 (fechamento + preparo de write): exposição do dossiê investigada e descartada (nunca esteve no ar com dado real — corrigido na Missão 5/Z.3 quanto ao rótulo de certeza da fonte PIS/COFINS). Núcleo do capability CFOP/IPPT criado.
• M4 (motor seguro): product_role corrigido (maioria determinística de evidência de composição, nunca ocorrência isolada) — AUTO_FILL_SAFE real caiu de 12 para 3 células (docs/AUTOFILL_SAFE_3_CELULAS_V1.md). Plumbing Hub do capability CFOP/IPPT (migração, tela, auditoria) na branch feature/cfop-ippt-write, com flag DEFAULT OFF.
• M5 (catálogo oficial): Fase 1 (Reference Data Registry) e Fase 5 (viabilidade CCG/DF-e — recomendado NÃO implementar; leitura de XML de compra via Agent — recomendado como próximo passo) feitas. Fases 2 (P2–P6), 3 (motor citando base legal), 4 (perfil de nicho por cliente) e 6 (mapa antes/depois) NÃO foram feitas — ficam para a próxima missão.
• Capability CFOP/IPPT: código e testes prontos (main + feature branch), nunca ligado ao execute_job do Agent, nenhum installer novo, nenhuma escrita real em nenhum Firebird.

Riscos abertos

• Migration heads divergentes entre main e a feature branch (ver acima) — resolver antes de qualquer merge.
• Validação de heartbeat do Agent 2 (versão 1.3.8) pendente de confirmação real (só print do operador até agora).
• 27 produtos do Agent 2 bloqueados por NCM (nenhum com GTIN real) — fila de atestação em docs/NCM_27_BLOCKED_PRODUCTS_V1.md, nenhuma promoção automática.
• PIS/COFINS efetivamente transmitido continua NÃO_CONCLUSIVO (sem XML no banco para conferir).
• P2–P6 do catálogo oficial ainda não confirmados/baixados.

Índice de documentos-chave (docs/)

• AI_PROJECT_STATE.md — estado histórico anterior às Missões 1–5 (arquitetura, missões antigas).
• VERSIONING.md — versionamento independente Hub/Agent.
• fiscal_completeness_matrix.md — matriz de completude dos 18 campos fiscais.
• dossie_contador.md (+ cópia anonimizada em central/static/docs/) — perguntas para o contador.
• AGENT2_UPGRADE_RUNBOOK_V1.md — roteiro de upgrade manual do Agent (sem self-update).
• CFOP_IPPT_WRITE_CAPABILITY_V1.md — capability de escrita CFOP/IPPT (núcleo + roteiro de aceite; não ligado).
• AUTOFILL_SAFE_3_CELULAS_V1.md — as 3 células reais AUTO_FILL_SAFE do Agent 2.
• NCM_27_BLOCKED_PRODUCTS_V1.md — os 27 produtos bloqueados por NCM, fila de atestação.
• PISCOFINS_TRANSMITTED_SOURCE_V1.md — busca por XML/BLOB de PIS/COFINS (NÃO_CONCLUSIVO).
• REFERENCE_DATASET_MANIFEST_V1.md — manifesto de datasets oficiais baixados (URL/hash/data).
• VIABILIDADE_CCG_DFE_V1.md — estudos de viabilidade (CCG/SEFAZ, XML de compra, Open Food Facts).
• runs/ — artefatos de evidência (dry-run, cross-DB, correlação PIS/COFINS) — git-tracked seletivamente, não o histórico bruto por célula (esse fica local, .gitignore).