gtiandClaude Sonnet 5
156392e7e3
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>
4.4 KiB
4.4 KiB
Matriz de Fontes de Evidência e Bases Utilizadas — GTI Fiscal
Important
CORREÇÃO (Missão 9, 2026-09-29): o rótulo
DADO_DE_TESTE=trueabaixo, para CONSTRUCAO/ MMMODAS/RINCAO/UNIAO, estava errado — generalizava incorretamente a partir das características do Agent 2 (esse sim, ambiente de teste/homologação). Confirmado diretamente com o operador: esses 4 bancos são cópias reais de clientes de verdade, trazidas para desenvolvimento. Verdocs/MISSAO_9_LOG.mdedocs/PROJECT_STATE.md. A partir desta missão, são tratados com as regras de dado real (anonimização, cópia de trabalho com hash, nunca escrita no original).
1. Bases de Dados Utilizadas até Hoje
| Identificador / Base | Tipo de Instalação | CRT Declarado | Finalidade Técnica | Status |
|---|---|---|---|---|
Agent 2 (GTI.FDB / C000025) |
Instalação Windows E2E-PROD-TEST (bb50884a-...) |
1 (Simples Nacional) | Validação ponta a ponta do Agent, heartbeat, jobs de enriquecimento, inventário de 521 produtos e 27 bloqueios NCM. | DADO_DE_TESTE=true (Laboratório, confirmado) |
| TESTESOFICIAIS.FDB | Arquivo Firebird local | N/A | Único banco com autorização explícita de desenvolvimento para escritas de teste (CLAUDE.md). |
DADO_DE_TESTE=true (Laboratório descartável) |
CONSTRUCAO (CONSTRUCAO.FDB) |
Cópia real de cliente (Cliente A, Missão 9) | 1 (Simples Nacional) | Análise de variabilidade de CFOP_ENTRADA e conferência de ausência de CST PIS/COFINS na emissão NFC-e. | DADO_REAL=true (corrigido) |
MMMODAS (MMMODAS.FDB) |
Cópia real de cliente (Cliente B, Missão 9) | 1 (Simples Nacional) | Análise de dispersão de campos cadastrais e teste de invariantes de CSOSN. | DADO_REAL=true (corrigido) |
RINCAO (RINCAO.FDB) |
Cópia real de cliente (Cliente C, Missão 9) | 3 (Regime Normal) | Teste de detecção de empresa com incidência de IPI e perfil de débito/crédito ICMS em Regime Normal. | DADO_REAL=true (corrigido) |
UNIAO (UNIAO.FDB) |
Cópia real de cliente (Cliente D, Missão 9) | 1 (Simples Nacional) | Comparação cruzada de histórico de emissão e uso de CFOP de entrada. | DADO_REAL=true (corrigido) |
2. O que Ainda NÃO Foi Validado (Exclusivo para o Piloto com Cliente Real)
As seguintes premissas e comportamentos foram modelados no motor, mas dependem fundamentalmente da operação do primeiro cliente real para confirmação empírica:
-
Cobertura Real de NCM e GTIN Comercial:
- As bases de laboratório continham produtos com nomes de depuração ("KLEBER TESTANDO", "BUG") e nenhum código de barras EAN/GTIN válido de fabricante (todos NULL ou gerados por balança interna).
- Com clientes reais de varejo (supermercados, mercearias, pet shops, lojas de materiais), será medida pela primeira vez a taxa real de hit da Knowledge Base de GTIN (EAN-13 oficial) e a distribuição real de NCMs ativas vs revogadas.
-
Comportamento Efetivo de PIS e COFINS no SGV:
- Observou-se nos bancos de laboratório que a emissão da NFC-e ignorava campos cadastrais de PIS/COFINS em CRT 1.
- Em cliente real, é necessário confirmar com a assessoria contábil se o cliente tributa pelo PGDAS-D monofásico segregado ou se utiliza emissão unificada sem destaque no cupom.
-
Performance de Leitura e Carga Concorrente no Firebird em Produção:
- Em laboratório, as consultas executaram sem concorrência de múltiplos caixas (PDVs) ou terminais de venda emitindo NFC-e simultaneamente.
- No cliente real, a leitura em lote pelo Agent deve respeitar estritamente o isolamento de transação (
READ COMMITTED RECORD_VERSION READ ONLY), tempo de espera (WAIT 5) e pausas de throttling (50ms–100ms) para garantir impacto zero na velocidade de emissão no caixa.
-
Dinâmica de Atualização de Cadastros Novos:
- A frequência de cadastro de novos produtos pelo operador do cliente e a latência de reconciliação com o Hub (ciclos de enriquecimento) serão medidas em condições operacionais autênticas.
-
Atestação Contábil / Humana das Decisões de Loja (
Contexto Fiscal):- Decisões como
store_ipi_profile(preenchimento ou não da taxa referencial da TIPI para optantes do Simples Nacional) eentry_scope(tratamento de CFOP de entrada) serão submetidas e validadas diretamente pelo contador responsável pela escrita fiscal do cliente.
- Decisões como