Add 'fiscal/' from commit '102ba84500dbd9655a0471288c3e278652593ca9'

git-subtree-dir: fiscal
git-subtree-mainline: d95165fc8f
git-subtree-split: 102ba84500

fiscal/central/static/control-panel.css

@@ -0,0 +1,241 @@
+/* GTI Fiscal — componentes específicos do Fiscal sobre o design system do
+   GTI Gerenciador (gti-theme.css, carregado antes). Nenhuma cor própria:
+   tudo vem dos tokens --cor-* do Gerenciador, inclusive no tema escuro. */
+
+/* Aliases usados pelos templates do Fiscal -> tokens do Gerenciador */
+:root {
+  --ink: var(--cor-texto);
+  --muted: var(--cor-texto-secundario);
+  --paper: var(--cor-fundo);
+  --card: var(--cor-superficie);
+  --line: var(--cor-borda);
+  --accent: var(--cor-acento-texto);
+  --accent-soft: var(--cor-acento-suave);
+  --danger: var(--cor-perigo);
+  --warn: var(--cor-aviso);
+  --shadow: var(--sombra-card);
+}
+
+/* ---------- layout: mesma sidebar do Gerenciador, conteúdo um pouco mais largo ---------- */
+.conteudo-fiscal { max-width: 1280px; }
+.sidebar-nav a.sidebar-voltar { color: var(--cor-texto-secundario); font-size: 0.9rem; }
+.sidebar-nav a.sidebar-voltar:hover { color: var(--cor-texto); }
+.sidebar-secao { padding: 14px 12px 4px; font-size: 0.72rem; font-weight: 700; letter-spacing: .12em; text-transform: uppercase; color: var(--cor-texto-secundario); }
+.sidebar.recolhida .sidebar-secao { display: none; }
+
+/* ---------- tipografia de página ---------- */
+.page-heading, .detail-head { display: flex; justify-content: space-between; align-items: flex-end; gap: 20px; margin-bottom: 20px; }
+.page-heading h1, .detail-head h1 { margin-bottom: 4px; }
+p { margin-top: 0; }
+.eyebrow { color: var(--cor-acento-texto); font-size: 0.72rem; font-weight: 700; letter-spacing: .12em; text-transform: uppercase; margin: 0 0 6px; }
+.muted, small { color: var(--cor-texto-secundario); }
+small { display: block; font-size: 0.78rem; }
+.live-dot { color: var(--cor-sucesso); font-size: 0.8rem; white-space: nowrap; }
+
+/* ---------- cartões (mesmo visual de .cartao do Gerenciador) ---------- */
+.metric, .panel { background: var(--cor-superficie); border: 1px solid var(--cor-borda); box-shadow: var(--sombra-card); border-radius: 12px; }
+.panel { padding: 20px; margin-bottom: 20px; }
+.panel h2 { font-size: 1.05rem; margin: 0 0 12px; }
+.panel-title { display: flex; justify-content: space-between; align-items: center; gap: 12px; margin-bottom: 12px; }
+.panel-title h2 { margin-bottom: 0; }
+.panel-title a { font-size: 0.85rem; }
+.cards { display: grid; grid-template-columns: repeat(6, 1fr); gap: 12px; margin-bottom: 20px; }
+.cards.compact { grid-template-columns: repeat(4, 1fr); }
+.metric { padding: 16px; }
+.metric span { color: var(--cor-texto-secundario); font-size: 0.8rem; }
+.metric strong { font-size: 1.75rem; display: block; margin-top: 6px; }
+.metric-inline strong { display: inline; }
+.split { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-bottom: 20px; }
+.split .panel { margin-bottom: 0; }
+
+.coverage { display: grid; grid-template-columns: repeat(5, 1fr); gap: 12px; }
+.coverage div { border-left: 3px solid var(--cor-acento); padding-left: 12px; }
+.coverage strong { display: block; font-size: 1.4rem; }
+.coverage span { color: var(--cor-texto-secundario); font-size: 0.78rem; }
+.coverage-status { margin: 16px 0 0; color: var(--cor-sucesso); font-size: 0.8rem; font-weight: 700; }
+.registry-summary { display: flex; flex-wrap: wrap; gap: 16px; margin-top: 14px; padding-top: 12px; border-top: 1px solid var(--cor-borda); color: var(--cor-texto-secundario); font-size: 0.8rem; }
+.registry-summary a { text-decoration: none; }
+.bar-row { display: flex; justify-content: space-between; border-bottom: 1px solid var(--cor-borda); padding: 8px 0; }
+.bar-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 0 24px; }
+.list-row { display: flex; justify-content: space-between; align-items: center; gap: 12px; padding: 12px 8px; margin: 0 -8px; border-bottom: 1px solid var(--cor-borda); border-radius: 8px; text-decoration: none; color: inherit; transition: background var(--transicao); }
+.list-row:last-child { border-bottom: 0; }
+.list-row:hover { background: var(--cor-superficie-alt); }
+.rtc-empty-state { display: flex; align-items: center; justify-content: space-between; gap: 18px; border-left: 4px solid var(--cor-acento); background: var(--cor-superficie-alt); }
+.rtc-empty-copy { min-width: 0; }
+.rtc-empty-copy h2 { margin: 0 0 8px; }
+.rtc-empty-copy p:last-child { margin-bottom: 0; }
+.rtc-empty-state .botao { flex: 0 0 auto; margin: 0; }
+.empty-state { color: var(--cor-texto-secundario); border: 1px dashed var(--cor-borda); border-radius: 8px; padding: 18px; margin: 0; }
+
+/* ---------- badges: mesma forma do .badge do Gerenciador, cores semânticas dos tokens ---------- */
+.badge, .severity { display: inline-flex; align-items: center; border: 0; border-radius: 999px; padding: 3px 10px; font-size: 0.78rem; font-style: normal; font-weight: 600; white-space: nowrap; background: var(--cor-superficie-alt); color: var(--cor-texto-secundario); }
+.badge.large { padding: 6px 12px; }
+.badge-stack { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 8px; }
+.online, .fiscal-complete, .status-completed, .info { background: var(--cor-sucesso-fundo); color: var(--cor-sucesso); }
+.degraded, .warning, .fiscal-incomplete, .status-pending, .status-running, .priority-high { background: var(--cor-aviso-fundo); color: var(--cor-aviso); }
+.offline, .unknown, .priority-low { background: var(--cor-superficie-alt); color: var(--cor-texto-secundario); }
+.failed, .error.badge, .priority-critical, .status-failed, .critical { background: var(--cor-perigo-fundo); color: var(--cor-perigo); }
+.blocked, .priority-normal, .fiscal-blocked { background: var(--cor-acento-suave); color: var(--cor-acento-texto); }
+
+/* ---------- formulários e botões (padrão do Gerenciador) ---------- */
+.conteudo-fiscal button { margin-top: 0; }
+.filters { display: flex; flex-wrap: wrap; align-items: end; gap: 10px; }
+.filters label { color: var(--cor-texto-secundario); display: grid; gap: 4px; font-size: 0.8rem; font-weight: 600; margin: 0; }
+.filters input, .filters select { width: auto; min-width: 150px; }
+.filters button { align-self: end; }
+textarea { padding: 9px 10px; border-radius: 8px; border: 1px solid var(--cor-borda); background: var(--cor-fundo); color: var(--cor-texto); font: inherit; width: 100%; }
+/* Como no Gerenciador: <button> é a ação principal (laranja, gti-theme.css);
+   link com cara de botão (a.secondary ~ a.botao) tem só contorno. */
+a.secondary { display: inline-block; padding: 9px 14px; border-radius: 8px; border: 1px solid var(--cor-borda); background: transparent; color: var(--cor-texto); font-weight: 400; text-decoration: none; }
+a.secondary:hover { border-color: var(--cor-acento); color: var(--cor-acento); }
+.blocker-filters label { flex: 1 1 170px; }
+.compact-filters { margin-top: 12px; }
+.form-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 14px; }
+.form-grid label { display: grid; gap: 5px; color: var(--cor-texto-secundario); font-weight: 600; margin: 0; }
+.form-grid .wide { grid-column: 1 / -1; }
+.form-grid textarea { min-height: 100px; resize: vertical; }
+.error, .error-text { color: var(--cor-perigo); }
+.alert.error { padding: 10px 14px; border-radius: 8px; background: var(--cor-perigo-fundo); color: var(--cor-perigo); }
+
+/* ---------- tabelas (mesmo cartão de .tabela-wrap do Gerenciador) ---------- */
+.table-wrap { overflow-x: auto; border: 1px solid var(--cor-borda); border-radius: 12px; background: var(--cor-superficie); box-shadow: var(--sombra-card); }
+.panel .table-wrap { box-shadow: none; }
+/* Tabelas do Fiscal são largas: mantêm a largura mínima (rolagem horizontal no
+   .table-wrap) e só quebram palavras que não cabem — o overflow-wrap:anywhere
+   do tema quebraria nomes letra por letra em colunas estreitas. */
+.conteudo-fiscal table { width: 100%; min-width: 960px; }
+.conteudo-fiscal td { vertical-align: top; overflow-wrap: break-word; }
+.conteudo-fiscal td a.secondary, .conteudo-fiscal td .badge { white-space: nowrap; }
+caption { text-align: left; font-size: 1rem; font-weight: 700; padding: 14px 14px 4px; }
+td a { text-decoration: none; }
+
+.pagination { display: flex; justify-content: center; align-items: center; gap: 12px; margin: 12px 0 20px; color: var(--cor-texto-secundario); }
+.pagination a { border: 1px solid var(--cor-borda); background: transparent; color: var(--cor-texto); border-radius: 8px; padding: 6px 12px; text-decoration: none; }
+.pagination a:hover { border-color: var(--cor-acento); color: var(--cor-acento); }
+
+.tabs { display: flex; flex-wrap: wrap; gap: 4px; margin-bottom: 20px; border-bottom: 1px solid var(--cor-borda); }
+.tabs a { padding: 9px 13px; text-decoration: none; color: var(--cor-texto-secundario); }
+.tabs a.active { color: var(--cor-acento-texto); border-bottom: 3px solid var(--cor-acento); font-weight: 700; }
+
+.facts { display: grid; grid-template-columns: minmax(130px, .7fr) 1fr; gap: 10px 18px; margin: 0; }
+.facts dt { color: var(--cor-texto-secundario); font-weight: 600; }
+.facts dd { margin: 0; overflow-wrap: anywhere; }
+.event-row { display: grid; grid-template-columns: 120px 1fr auto; align-items: start; gap: 12px; padding: 11px 0; border-bottom: 1px solid var(--cor-borda); }
+.event-row:last-child { border-bottom: 0; }
+.event-time { color: var(--cor-texto-secundario); font-size: 0.8rem; }
+.evidence { white-space: pre-wrap; overflow-wrap: anywhere; font: 0.8rem/1.4 ui-monospace, monospace; }
+
+/* ---------- páginas avulsas (acesso de emergência, erro de SSO, saída) — mesmo visual do login do Gerenciador ---------- */
+.login-page { min-height: 100vh; display: flex; align-items: center; justify-content: center; padding: 16px; background: radial-gradient(circle at top, var(--cor-superficie-alt), var(--cor-fundo)); }
+.login-card { width: 100%; max-width: 380px; text-align: center; margin: 0; }
+.login-card form { text-align: left; }
+.login-card form button[type="submit"] { width: 100%; }
+.login-logo { width: 64px; height: 64px; border-radius: 16px; margin-bottom: 12px; }
+.login-card h1 { font-size: 1.3rem; margin-bottom: 4px; }
+.login-subtitle { color: var(--cor-texto-secundario); font-size: 0.9rem; margin: 0 0 20px; }
+.login-actions { display: grid; gap: 10px; margin-top: 16px; }
+.login-actions a.botao { margin: 0; }
+
+@media (max-width: 1100px) {
+  .cards { grid-template-columns: repeat(3, 1fr); }
+  .bar-grid { grid-template-columns: repeat(2, 1fr); }
+  .page-heading, .detail-head { align-items: flex-start; flex-direction: column; }
+  .badge-stack { justify-content: flex-start; }
+}
+@media (max-width: 768px) {
+  .cards, .cards.compact, .split { grid-template-columns: 1fr 1fr; }
+  .rtc-empty-state { align-items: stretch; flex-direction: column; }
+  .coverage { grid-template-columns: repeat(2, 1fr); }
+  .form-grid { grid-template-columns: 1fr; }
+  .form-grid .wide { grid-column: auto; }
+  .event-row { grid-template-columns: 1fr; gap: 4px; }
+}
+@media (max-width: 520px) {
+  .cards, .cards.compact, .split, .bar-grid { grid-template-columns: 1fr; }
+  .filters label, .filters input, .filters select, .filters button { width: 100%; }
+}
+
+/* ---------- painel operacional: drill-down, filtros ativos, tabelas densas ---------- */
+a.metric-link { display: block; color: inherit; text-decoration: none; transition: border-color .15s, transform .15s; }
+a.metric-link:hover { border-color: var(--cor-acento); transform: translateY(-1px); }
+a.metric-link small { color: var(--cor-acento-texto); margin-top: 6px; font-weight: 600; }
+a.metric-link:focus-visible, .coverage-item:focus-visible, .bar-link:focus-visible, .row-primary-link:focus-visible, .list-row:focus-visible,
+.filter-clear:focus-visible, .navigable-row:focus-visible { outline: 3px solid var(--cor-acento); outline-offset: 2px; }
+.coverage-item { display: block; color: inherit; text-decoration: none; border-left: 3px solid var(--cor-acento); padding-left: 12px; border-radius: 4px; }
+.coverage-item:hover { background: var(--cor-superficie-alt); }
+.coverage-item strong { display: block; font-size: 1.4rem; }
+.coverage-item span { color: var(--cor-texto-secundario); font-size: 0.78rem; }
+.coverage-status.error { color: var(--cor-perigo); }
+.registry-summary { display: flex; flex-wrap: wrap; gap: 8px 20px; margin-top: 14px; font-size: 0.85rem; color: var(--cor-texto-secundario); }
+a.bar-link { color: inherit; text-decoration: none; }
+a.bar-link:hover { background: var(--cor-superficie-alt); }
+.bar-row.muted { opacity: .65; }
+.attention-row b, .list-row b { display: block; }
+.attention-row { border-left: 3px solid var(--cor-aviso); padding-left: 12px; }
+.filter-panel { padding: 14px 20px; }
+.active-filters { margin: 12px 0 0; font-size: 0.82rem; color: var(--cor-texto-secundario); display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
+.filter-chip { display: inline-flex; background: var(--cor-acento-suave); color: var(--cor-acento-texto); border-radius: 999px; padding: 2px 10px; font-weight: 600; }
+.filter-clear { align-self: end; font-size: 0.85rem; }
+.filter-search { flex: 1 1 260px; }
+.filter-search input { width: 100%; }
+.agents-table-wrap, .table-wrap { overflow-x: auto; }
+.agents-table { width: 100%; table-layout: auto; }
+.agents-table td small, .agents-table th small { display: block; }
+.agents-table td { vertical-align: top; }
+.navigable-row { cursor: pointer; }
+.navigable-row:hover { background: var(--cor-superficie-alt); }
+.historical-row { opacity: .7; }
+.row-primary-link { color: inherit; text-decoration: none; display: block; }
+.row-primary-link b { color: var(--cor-acento-texto); }
+.warning-text { color: var(--cor-aviso); font-weight: 600; }
+.compact-table td, .compact-table th { padding: 8px 10px; }
+.job-error-summary { max-width: 46ch; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+@media (max-width: 1100px) { .agents-table th:nth-child(5), .agents-table td:nth-child(5) { display: none; } }
+@media (max-width: 640px) {
+  .agents-table thead { position: absolute; left: -9999px; }
+  .agents-table, .agents-table tbody, .agents-table tr, .agents-table td { display: block; width: 100%; }
+  .agents-table tr { border: 1px solid var(--cor-borda); border-radius: 10px; padding: 10px 12px; margin-bottom: 10px; }
+  .agents-table td { display: flex; justify-content: space-between; gap: 12px; border: 0; padding: 4px 0; }
+  .agents-table td::before { content: attr(data-label); color: var(--cor-texto-secundario); font-size: 0.75rem; font-weight: 600; }
+  .agents-table td:nth-child(5) { display: flex; }
+  .agents-table td:first-child { display: block; }
+  .agents-table td:first-child::before { content: none; }
+  .coverage { grid-template-columns: repeat(2, 1fr); }
+}
+@media (prefers-reduced-motion: reduce) { a.metric-link { transition: none; } a.metric-link:hover { transform: none; } }
+.job-failed-row td:first-child { border-left: 3px solid var(--cor-perigo); }
+.job-failed-row .badge { font-weight: 700; }
+/* grid children must be allowed to shrink, otherwise a wide table/link inside a panel widens the whole page */
+.split { grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); }
+.split > *, .cards > *, .coverage > * { min-width: 0; }
+.list-row > span { min-width: 0; overflow-wrap: anywhere; }
+code { overflow-wrap: anywhere; }
+@media (max-width: 900px) { .split { grid-template-columns: minmax(0, 1fr); } }
+@media (max-width: 768px) { .cards, .cards.compact { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
+@media (max-width: 520px) { .cards, .cards.compact, .bar-grid { grid-template-columns: minmax(0, 1fr); } }
+@media (max-width: 520px) { .cards { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; } .cards .metric { padding: 12px; } .cards .metric strong { font-size: 1.5rem; } }
+
+/* ---------- detalhe do Agent: badges de status e hierarquia das ações de processamento ---------- */
+.status-stack { display: flex; flex-wrap: wrap; gap: 16px; }
+.status-block { display: grid; gap: 4px; justify-items: start; }
+.status-label { font-size: 0.7rem; letter-spacing: .08em; text-transform: uppercase; color: var(--cor-texto-secundario); }
+.ops-actions { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+.ops-actions form { margin: 0; }
+button.caution { background: var(--cor-aviso-fundo); color: var(--cor-aviso); border: 1px solid var(--cor-aviso); }
+button.caution:hover { filter: brightness(1.08); }
+.ops-actions .botao.secondary, .ops-actions button.secondary { background: transparent; }
+
+/* ---------- Jobs com falha (Resumo): lista sem tabela, erro resumido, sem scroll horizontal ---------- */
+.failed-jobs { list-style: none; margin: 0; padding: 0; display: grid; gap: 0; }
+.failed-job { display: flex; justify-content: space-between; align-items: flex-start; gap: 12px; padding: 10px 0 10px 12px; border-bottom: 1px solid var(--cor-borda); border-left: 3px solid var(--cor-perigo); margin-bottom: 8px; border-radius: 4px; }
+.failed-job:last-child { border-bottom: 0; }
+.failed-job-main { min-width: 0; display: grid; gap: 2px; }
+.failed-job-main b, .failed-job-main small { overflow-wrap: anywhere; }
+.failed-job-kind { font-size: 0.82rem; font-weight: 600; }
+.failed-job .job-error-summary { max-width: none; white-space: normal; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
+.failed-job-side { flex: none; display: grid; gap: 4px; justify-items: end; font-size: 0.8rem; color: var(--cor-texto-secundario); white-space: nowrap; }
+@media (max-width: 520px) { .failed-job { flex-direction: column; } .failed-job-side { justify-items: start; grid-auto-flow: column; gap: 12px; } }
+.ops-actions button:disabled, .ops-actions .primary-action:disabled { opacity: .45; cursor: not-allowed; filter: grayscale(.4); }
+.table-wrap table { min-width: 0; }
+.panel .table-wrap { overflow-x: auto; max-width: 100%; }
+@media (max-width: 640px) { .table-wrap table { font-size: 0.82rem; } .table-wrap td, .table-wrap th { padding: 6px 8px; } }

fiscal/central/static/control-panel.js

@@ -0,0 +1,10 @@
+document.addEventListener("DOMContentLoaded", () => {
+  document.documentElement.classList.add("js");
+  // Whole-row navigation for dense tables; the primary cell keeps a native link (keyboard/screen readers).
+  document.querySelectorAll("tr.navigable-row[data-href]").forEach((row) => {
+    row.addEventListener("click", (event) => {
+      if (event.target.closest("a, button, input, select, textarea, label")) return;
+      window.location.href = row.dataset.href;
+    });
+  });
+});

fiscal/central/static/docs/dossie_contador.md

@@ -0,0 +1,81 @@
+# Dossiê para o contador (2026-09-28)
+
+Este documento não afirma nenhuma regra fiscal. Cada pergunta mostra a evidência real medida
+(somente leitura, sem gravação em nenhum banco) e qual clique na tela "Contexto Fiscal" do painel
+a resposta libera. Identificadores de cliente foram substituídos por rótulos genéricos
+(Cliente A–E); nenhum nome de produto, CNPJ ou razão social aparece aqui.
+
+## (a) Em CRT=1, o PIS/COFINS por item segue o cadastro do produto ou a operação/regime?
+
+**Evidência**: em 5 instalações auditadas (Cliente A, CRT 1; Clientes B/C/E, CRT 1; Cliente D,
+CRT 3), o cadastro do produto **nunca** tem os campos de PIS/COFINS usados pela emissão: mesmo
+quando a nota fiscal emitida traz um CST de PIS/COFINS preenchido, o cadastro está em branco para
+o mesmo produto (23 casos confirmados no Cliente A). Nos Clientes B, C, D e E, a emissão nunca
+preenche o CST de PIS/COFINS (0% dos itens, em todos os anos de histórico disponíveis). Isso indica
+que a emissão não lê o cadastro — mas não decide se o valor correto é "não aplicável", "por
+operação" ou um perfil fixo por empresa. **Libera**: card "Perfil de PIS/COFINS" → escolher
+`NOT_APPLICABLE`, `OPERATION_TIME` ou um perfil JSON de 6 campos.
+
+## (b) O CST 01 emitido em ~9,5% dos itens é intencional?
+
+**Evidência**: dos itens de NFC-e emitidos pelo Cliente A, 9,5% trazem CST de PIS/COFINS = "01" —
+e são exclusivamente de um único mês (dezembro de um ano específico), não do ano inteiro: 90,9%
+dos itens daquele mês têm o campo preenchido, todos os outros meses (incluindo o resto do mesmo
+ano) têm 0%. Testamos se o NCM, o grupo do produto, o CFOP ou o código de ICMS do item explicam
+quais itens recebem o valor: não há uma fórmula fiscal por trás — é um conjunto pequeno e
+homogêneo de vendas reais concentrado nesse único mês, que já havia sido sinalizado em outra
+auditoria interna como um período com problema de integridade de dados. A leitura mais provável
+é que **não é uma política fiscal deliberada** — é um efeito técnico de um evento pontual (ex.:
+uma migração de dados ou uma versão diferente do software de emissão usada só naquele mês). Não
+decidimos isso por evidência insuficiente para confirmar a causa exata; a pergunta é se o contador
+reconhece esse episódio.
+
+## (c) CFOP_ENTRADA no cadastro do produto é necessário ou é sempre definido na nota de compra?
+
+**Evidência**:
+- **Schema do banco**: a coluna é opcional no próprio banco de dados (sem obrigatoriedade, sem
+  valor padrão, sem regra de validação) — o sistema nunca exige um valor aqui a nível de banco.
+- **Uso real é muito diferente entre clientes**: em dois clientes o campo está praticamente sempre
+  em branco; em outros três está preenchido em quase 100% dos produtos, com valores plausíveis —
+  ou seja, alguns clientes efetivamente mantêm esse cadastro, outros não.
+- Isso mostra que não existe uma regra universal: depende de como cada loja opera. Por isso o motor
+  já trata isso como uma decisão por instalação (`entry_scope`), nunca uma regra fixa do sistema.
+- **Não verificado ainda** (requer acesso à tela de entrada de nota do sistema, que não fizemos):
+  se a tela de lançamento de nota de compra lê o CFOP_ENTRADA do cadastro como sugestão inicial, ou
+  sempre pede a digitação manual. Roteiro de 5 passos para teste manual:
+  1. Anote o CFOP_ENTRADA atual de um produto de teste (ou deixe em branco).
+  2. Abra o cadastro do produto e grave um CFOP_ENTRADA diferente (ex.: 1102).
+  3. Lance uma nota de entrada (compra) desse mesmo produto.
+  4. Veja se o CFOP do item da nota já vem preenchido com o valor do cadastro, ou em branco.
+  5. Repita com CFOP_ENTRADA em branco no cadastro e confirme se a nota exige digitação manual.
+- **Libera**: card "CFOP de entrada padrão" → `INTRA`, `INTER` ou `MIXED_OR_DYNAMIC` (este último
+  não bloqueia mais a completude do produto).
+
+## (d) O que mais o levantamento deixou como decisão pendente com evidência insuficiente?
+
+- **Origem da mercadoria** (nacional/importado): nenhuma fonte automática existe para decidir isso
+  — a grande maioria dos produtos não tem nenhuma evidência. Só pode ser respondido produto a
+  produto ou por grupo, nunca por uma regra geral.
+- **Tratamento de ICMS** para um pequeno grupo de produtos cujo código fiscal está em branco —
+  parte é cadastro de teste/incompleto, mas alguns produtos reais também aparecem.
+- Um pequeno número de produtos com o código fiscal (CSOSN) em branco hoje. Nenhuma simulação
+  escreve nada; um valor padrão só se aplica de fato após a confirmação do "Tratamento padrão de
+  ICMS" no card correspondente, e mesmo assim o motor consulta o tratamento antes de propor o
+  código (nunca aplica um padrão cegamente).
+
+## Atualização: o que foi realmente transmitido é NÃO_CONCLUSIVO
+
+Procuramos por XML/documento fiscal armazenado nos bancos auditados: não existe — o sistema só
+guarda o caminho do arquivo no disco da loja, nunca o conteúdo. As colunas de PIS/COFINS por item
+de venda são a melhor evidência disponível no banco, mas essas colunas estão em branco para quase
+todos os itens, e sem o XML de verdade não sabemos se "em branco" significa que nada foi
+transmitido ou que o sistema transmitiu um valor sem gravá-lo de volta no banco — as duas
+explicações combinam com os mesmos dados. O que continua certo: o cadastro do produto nunca é
+consultado (também em branco).
+
+## Como usar este dossiê
+
+Cada resposta é dada uma única vez, no painel ("Contexto Fiscal", aba do Agent), nunca escrevendo
+nada no ERP diretamente — a decisão fica registrada e auditada, e só depois disso o motor passa a
+considerar o campo resolvido (ou explicitamente não-bloqueante). Nenhuma decisão aqui é assumida
+por padrão.

fiscal/central/static/gti-theme.css

@@ -0,0 +1,320 @@
+/* GTI design system — cópia fiel de painel-clientes-web/app/static/estilo.css (GTI Gerenciador @ b0c6d3e).
+   Não editar aqui: altere no Gerenciador e copie de novo. Ajustes específicos do Fiscal ficam em control-panel.css. */
+/* app/static/estilo.css — tokens de cor e componentes compartilhados do painel */
+
+:root {
+  --cor-fundo: #f7f7f9;
+  --cor-superficie: #ffffff;
+  --cor-superficie-alt: #f1f1f4;
+  --cor-texto: #1c1c1f;
+  --cor-texto-secundario: #6b6b74;
+  --cor-borda: #e4e4e9;
+  --cor-acento: #F5821F;
+  --cor-acento-contraste: #17171a;
+  --cor-acento-suave: #fff1e4;
+  --cor-acento-texto: #B3510C;
+  --cor-sucesso: #15803d;
+  --cor-sucesso-fundo: #dcfce7;
+  --cor-perigo: #b91c1c;
+  --cor-perigo-fundo: #fee2e2;
+  --cor-aviso: #b45309;
+  --cor-aviso-fundo: #fef3c7;
+  --sombra-card: 0 1px 2px rgba(0,0,0,0.05), 0 1px 8px rgba(0,0,0,0.04);
+  --transicao: 0.16s ease;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-tema="claro"]) {
+    --cor-fundo: #121214;
+    --cor-superficie: #1c1c1f;
+    --cor-superficie-alt: #232326;
+    --cor-texto: #f4f4f5;
+    --cor-texto-secundario: #9a9aa2;
+    --cor-borda: #2e2e33;
+    --cor-acento-contraste: #17171a;
+    --cor-acento-suave: rgba(245,130,31,0.16);
+    --cor-acento-texto: #F5821F;
+    --cor-sucesso: #4ade80;
+    --cor-sucesso-fundo: rgba(74,222,128,0.14);
+    --cor-perigo: #f87171;
+    --cor-perigo-fundo: rgba(248,113,113,0.14);
+    --cor-aviso: #fbbf24;
+    --cor-aviso-fundo: rgba(251,191,36,0.14);
+    --sombra-card: 0 1px 2px rgba(0,0,0,0.3), 0 1px 8px rgba(0,0,0,0.25);
+  }
+}
+
+:root[data-tema="escuro"] {
+  --cor-fundo: #121214;
+  --cor-superficie: #1c1c1f;
+  --cor-superficie-alt: #232326;
+  --cor-texto: #f4f4f5;
+  --cor-texto-secundario: #9a9aa2;
+  --cor-borda: #2e2e33;
+  --cor-acento-contraste: #17171a;
+  --cor-acento-suave: rgba(245,130,31,0.16);
+  --cor-acento-texto: #F5821F;
+  --cor-sucesso: #4ade80;
+  --cor-sucesso-fundo: rgba(74,222,128,0.14);
+  --cor-perigo: #f87171;
+  --cor-perigo-fundo: rgba(248,113,113,0.14);
+  --cor-aviso: #fbbf24;
+  --cor-aviso-fundo: rgba(251,191,36,0.14);
+  --sombra-card: 0 1px 2px rgba(0,0,0,0.3), 0 1px 8px rgba(0,0,0,0.25);
+}
+
+* { box-sizing: border-box; }
+
+body {
+  font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
+  margin: 0;
+  background: var(--cor-fundo);
+  color: var(--cor-texto);
+  transition: background var(--transicao), color var(--transicao);
+}
+
+h1, h2, h3 { font-weight: 700; line-height: 1.25; }
+h1 { font-size: 1.5rem; margin: 0 0 16px; }
+h2 { font-size: 1.15rem; margin: 28px 0 12px; }
+
+a { color: var(--cor-acento-texto); }
+
+/* ---------- layout raiz: sidebar + área de conteúdo ---------- */
+
+.layout { display: flex; min-height: 100vh; }
+
+.sidebar {
+  width: 240px;
+  flex-shrink: 0;
+  background: var(--cor-superficie);
+  border-right: 1px solid var(--cor-borda);
+  display: flex;
+  flex-direction: column;
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  overflow-y: auto;
+  transition: width var(--transicao), transform var(--transicao);
+}
+
+.sidebar-topo {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 18px 16px;
+  border-bottom: 1px solid var(--cor-borda);
+}
+.sidebar-logo { width: 32px; height: 32px; border-radius: 8px; flex-shrink: 0; }
+.sidebar-titulo { font-weight: 700; white-space: nowrap; overflow: hidden; }
+
+.sidebar-nav { flex: 1; padding: 12px 8px; display: flex; flex-direction: column; gap: 2px; overflow-y: auto; }
+.sidebar-nav a {
+  display: flex; align-items: center; gap: 12px;
+  padding: 10px 12px; border-radius: 8px;
+  color: var(--cor-texto); text-decoration: none; white-space: nowrap;
+  transition: background var(--transicao), color var(--transicao);
+}
+.sidebar-nav a:hover { background: var(--cor-superficie-alt); }
+.sidebar-nav a.ativo { background: var(--cor-acento-suave); color: var(--cor-acento-texto); font-weight: 600; }
+.sidebar-nav svg { flex-shrink: 0; width: 20px; height: 20px; }
+.sidebar-nav span { overflow: hidden; text-overflow: ellipsis; }
+
+.sidebar-rodape {
+  border-top: 1px solid var(--cor-borda);
+  padding: 12px 8px;
+  display: flex; flex-direction: column; gap: 8px;
+}
+.sidebar-usuario { padding: 6px 12px; font-size: 0.85rem; color: var(--cor-texto-secundario); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.sidebar-rodape .form-logout { margin: 0; }
+.botao-tema, .botao-recolher, .botao-sair, .topbar-menu-btn {
+  display: flex; align-items: center; gap: 10px; width: 100%;
+  padding: 10px 12px; border-radius: 8px; border: none;
+  background: transparent; color: var(--cor-texto); cursor: pointer;
+  font: inherit; font-weight: 400; margin: 0; text-align: left;
+}
+.botao-tema:hover, .botao-recolher:hover, .botao-sair:hover { background: var(--cor-superficie-alt); }
+.botao-tema svg, .botao-recolher svg, .botao-sair svg { flex-shrink: 0; width: 20px; height: 20px; }
+
+/* Sidebar recolhida (desktop): só ícones */
+.sidebar.recolhida { width: 64px; }
+.sidebar.recolhida .sidebar-titulo,
+.sidebar.recolhida .sidebar-nav span,
+.sidebar.recolhida .sidebar-usuario,
+.sidebar.recolhida .botao-tema span,
+.sidebar.recolhida .botao-recolher span,
+.sidebar.recolhida .botao-sair span { display: none; }
+
+.sidebar-backdrop {
+  display: none;
+  position: fixed; inset: 0; background: rgba(0,0,0,0.45); z-index: 40;
+}
+
+.conteudo-area { flex: 1; min-width: 0; display: flex; flex-direction: column; }
+
+.topbar-mobile {
+  display: none;
+  align-items: center; gap: 12px;
+  padding: 12px 16px; border-bottom: 1px solid var(--cor-borda);
+  background: var(--cor-superficie);
+}
+.topbar-menu-btn { width: auto; padding: 8px; }
+.topbar-titulo { font-weight: 700; }
+
+.conteudo { padding: 24px; max-width: 1080px; width: 100%; margin: 0 auto; }
+
+/* ---------- mobile: sidebar vira gaveta ---------- */
+@media (max-width: 900px) {
+  .sidebar {
+    position: fixed; top: 0; bottom: 0; left: 0; z-index: 50;
+    transform: translateX(-100%);
+  }
+  .sidebar.aberta { transform: translateX(0); }
+  .sidebar.recolhida { width: 240px; } /* recolher não se aplica no mobile */
+  .sidebar.recolhida .sidebar-titulo,
+  .sidebar.recolhida .sidebar-nav span,
+  .sidebar.recolhida .sidebar-usuario,
+  .sidebar.recolhida .botao-tema span,
+  .sidebar.recolhida .botao-recolher span,
+  .sidebar.recolhida .botao-sair span { display: inline; }
+  .sidebar-backdrop.aberta { display: block; }
+  .topbar-mobile { display: flex; }
+  .conteudo { padding: 16px; }
+}
+
+/* ---------- componentes ---------- */
+
+.cartao {
+  background: var(--cor-superficie);
+  border: 1px solid var(--cor-borda);
+  border-radius: 12px;
+  box-shadow: var(--sombra-card);
+  padding: 20px;
+  margin-bottom: 20px;
+}
+
+.tabela-wrap { overflow-x: auto; border: 1px solid var(--cor-borda); border-radius: 12px; background: var(--cor-superficie); box-shadow: var(--sombra-card); }
+/*
+ * min-width (não width) faz a tabela continuar esticando pra preencher o
+ * cartão em telas largas (comportamento de sempre), mas permite crescer
+ * além disso quando o conteúdo não cabe — em telas estreitas (celular) o
+ * .tabela-wrap acima assume a rolagem horizontal, em vez do texto quebrar
+ * letra por letra pra caber à força numa coluna espremida.
+ */
+table { min-width: 100%; border-collapse: collapse; }
+th, td { text-align: left; padding: 10px 14px; border-bottom: 1px solid var(--cor-borda); }
+th { white-space: nowrap; }
+td { overflow-wrap: anywhere; }
+tr:last-child td { border-bottom: none; }
+th a { color: inherit; text-decoration: none; }
+th a:hover { color: var(--cor-acento); }
+
+input, select {
+  padding: 9px 10px; border-radius: 8px; border: 1px solid var(--cor-borda);
+  background: var(--cor-fundo); color: var(--cor-texto); width: 100%;
+}
+input:focus-visible, select:focus-visible, a:focus-visible, button:focus-visible {
+  outline: 2px solid var(--cor-acento); outline-offset: 2px;
+}
+label { display: block; margin-top: 10px; margin-bottom: 4px; font-size: 0.85rem; color: var(--cor-texto-secundario); }
+
+button, a.botao {
+  display: inline-block; margin-top: 14px; padding: 10px 16px;
+  border: 1px solid transparent; border-radius: 8px;
+  background: var(--cor-acento); color: var(--cor-acento-contraste);
+  font-weight: 700; cursor: pointer; text-decoration: none; text-align: center;
+  white-space: nowrap;
+}
+a.botao { background: transparent; border-color: var(--cor-borda); color: var(--cor-texto); font-weight: 400; margin-right: 6px; }
+a.botao:hover { border-color: var(--cor-acento); color: var(--cor-acento); }
+
+.mensagem { padding: 10px 14px; border-radius: 8px; margin-bottom: 16px; }
+.mensagem.success { background: var(--cor-sucesso-fundo); color: var(--cor-sucesso); }
+.mensagem.danger { background: var(--cor-perigo-fundo); color: var(--cor-perigo); }
+.mensagem.warning { background: var(--cor-aviso-fundo); color: var(--cor-aviso); }
+
+.badge { display: inline-block; padding: 3px 10px; border-radius: 999px; font-size: 0.78rem; font-weight: 600; }
+.badge-acento { background: var(--cor-acento-suave); color: var(--cor-acento-texto); }
+.badge-neutro { background: var(--cor-superficie-alt); color: var(--cor-texto-secundario); }
+.badge-sucesso { background: var(--cor-sucesso-fundo); color: var(--cor-sucesso); }
+
+.grid-form { display: grid; grid-template-columns: 1fr 1fr; gap: 0 16px; }
+.grid-form-largura-total { grid-column: 1 / -1; }
+@media (max-width: 640px) {
+  .grid-form { grid-template-columns: 1fr; }
+}
+
+.paginacao { display: flex; align-items: center; gap: 12px; justify-content: center; margin-top: 16px; }
+.paginacao-rodape { display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 12px; margin-top: 16px; }
+.paginacao-rodape .paginacao { margin-top: 0; }
+.paginacao-por-pagina { display: flex; align-items: center; gap: 8px; }
+.paginacao-por-pagina label { margin: 0; white-space: nowrap; }
+.paginacao-atual { display: inline-flex; align-items: center; justify-content: center; min-width: 32px; height: 32px; padding: 0 6px; border-radius: 6px; background: var(--cor-acento); color: var(--cor-acento-texto); font-weight: 600; }
+.paginacao-reticencias { padding: 0 4px; color: var(--cor-texto-secundario); }
+
+.chave-feedback { margin-left: 6px; font-size: 0.85rem; color: var(--cor-sucesso); }
+.chave-feedback-erro { color: var(--cor-perigo); }
+.botao-gerar-chave { margin-left: 6px; }
+
+.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; }
+
+.status-dot { display: inline-block; width: 12px; height: 12px; padding: 0; margin: 0; border: none; border-radius: 50%; cursor: pointer; vertical-align: middle; }
+.status-dot-ativo { background: var(--cor-sucesso); }
+.status-dot-inativo { background: var(--cor-perigo); }
+
+.secao-log { margin-bottom: 20px; }
+.secao-log summary {
+  display: flex; align-items: center; gap: 10px; cursor: pointer;
+  list-style: none; padding: 10px 0; user-select: none;
+}
+.secao-log summary::-webkit-details-marker { display: none; }
+.secao-log summary::before {
+  content: "▸"; display: inline-block; color: var(--cor-texto-secundario);
+  transition: transform 0.15s ease;
+}
+.secao-log[open] summary::before { transform: rotate(90deg); }
+.secao-log-titulo { font-size: 1.17em; font-weight: 700; }
+.botao-toggle-log {
+  margin-top: 0; padding: 6px 12px; font-size: 0.85rem; font-weight: 400;
+  background: transparent; border: 1px solid var(--cor-borda); color: var(--cor-texto);
+}
+.botao-toggle-log:hover { border-color: var(--cor-acento); color: var(--cor-acento); }
+.secao-log-conteudo { padding-top: 4px; }
+
+/*
+ * table-layout:fixed + min-width faz as colunas respeitarem exatamente as
+ * larguras abaixo (necessário pro Abrir/Gerar chave não quebrar linha —
+ * ver commit da tarefa de UI da tabela). Em telas estreitas (celular), o
+ * min-width impede a tabela de ser espremida a ponto de zerar a largura
+ * das colunas percentuais — o .tabela-wrap (overflow-x: auto) assume a
+ * rolagem horizontal nesse caso, em vez do texto quebrar letra por letra.
+ * Nas telas largas (desktop) o min-width nunca entra em jogo, então o
+ * visual de lá continua idêntico.
+ */
+.table-clientes { table-layout: fixed; min-width: 990px; }
+
+.table-clientes th.col-codigo, .table-clientes td.col-codigo,
+.table-clientes th.col-cnpj, .table-clientes td.col-cnpj,
+.table-clientes th.col-status, .table-clientes td.col-status {
+  text-align: center;
+}
+.table-clientes th.col-acoes, .table-clientes td.col-acoes { text-align: right; }
+
+.table-clientes td.col-codigo, .table-clientes td.col-cnpj {
+  font-variant-numeric: tabular-nums;
+}
+.table-clientes td.col-cnpj { white-space: nowrap; }
+
+.table-clientes col.col-codigo { width: 90px; }
+.table-clientes col.col-razao, .table-clientes col.col-fantasia { width: 220px; }
+.table-clientes col.col-cnpj { width: 160px; }
+.table-clientes col.col-status { width: 70px; }
+.table-clientes col.col-acoes { width: 230px; }
+
+.table-clientes th, .table-clientes td { padding: 7px 14px; }
+
+.botao.botao-tabela { margin-top: 0; padding: 7px 12px; font-size: 0.875rem; vertical-align: middle; }
+.table-clientes td.col-acoes { white-space: nowrap; }
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { transition: none !important; }
+}

fiscal/central/static/sidebar.js

@@ -0,0 +1,39 @@
+// app/static/sidebar.js — abre/fecha a gaveta da sidebar no mobile e
+// recolhe/expande no desktop, persistindo a preferência de recolher.
+(function () {
+  var sidebar = document.getElementById("sidebar");
+  var backdrop = document.getElementById("sidebar-backdrop");
+  var btnMenuMobile = document.getElementById("btn-menu-mobile");
+  var btnRecolher = document.getElementById("botao-recolher");
+  if (!sidebar) return;
+
+  function abrirGaveta() {
+    sidebar.classList.add("aberta");
+    if (backdrop) backdrop.classList.add("aberta");
+  }
+  function fecharGaveta() {
+    sidebar.classList.remove("aberta");
+    if (backdrop) backdrop.classList.remove("aberta");
+  }
+
+  if (btnMenuMobile) {
+    btnMenuMobile.addEventListener("click", function () {
+      if (sidebar.classList.contains("aberta")) fecharGaveta();
+      else abrirGaveta();
+    });
+  }
+  if (backdrop) backdrop.addEventListener("click", fecharGaveta);
+  sidebar.querySelectorAll("a").forEach(function (link) {
+    link.addEventListener("click", fecharGaveta);
+  });
+
+  if (btnRecolher) {
+    if (localStorage.getItem("sidebarRecolhida") === "1") {
+      sidebar.classList.add("recolhida");
+    }
+    btnRecolher.addEventListener("click", function () {
+      var recolhida = sidebar.classList.toggle("recolhida");
+      localStorage.setItem("sidebarRecolhida", recolhida ? "1" : "0");
+    });
+  }
+})();

fiscal/central/static/tema.js

@@ -0,0 +1,17 @@
+// app/static/tema.js — alterna e persiste o tema claro/escuro do painel.
+(function () {
+  var botao = document.getElementById("botao-tema");
+  if (!botao) return;
+
+  function temaAtual() {
+    var salvo = localStorage.getItem("tema");
+    if (salvo === "claro" || salvo === "escuro") return salvo;
+    return "escuro"; // padrão do painel sem preferência salva
+  }
+
+  botao.addEventListener("click", function () {
+    var novo = temaAtual() === "escuro" ? "claro" : "escuro";
+    document.documentElement.setAttribute("data-tema", novo);
+    localStorage.setItem("tema", novo);
+  });
+})();