feat: unified fiscal coverage - PIS/COFINS applicability + conditional RTC in one definition, one queue, one panel

- central/app/unified_fiscal_coverage.py: pure rules (PIS/COFINS NOT_APPLICABLE/REQUIRED/OPTIONAL/NEEDS_REVIEW, RTC only when the ERP switch is on)
- agent: read-only loader (unified_fiscal.py) replaces the legacy/expanded module; findings feed the single operational state, coverage and blocker queue
- hub: BLOCKED_FISCAL_DATA blockers (PIS/COFINS/RTC) share the queue; stale ones close on the next full pass; dashboard breakdown gains CEST/PIS/COFINS/RTC
- panel: legacy/expanded coverage block removed; discreet 'Reforma Tributaria: Ativa/Desativada'
- docs: unified_fiscal_completeness, pis_cofins_applicability, rtc_pis_cofins_model + official source manifests; read-only E2E script

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
gti
2026-09-24 16:39:53 -03:00
co-authored by Claude Sonnet 5
parent d897cceebb
commit b15dbea213
32 changed files with 3979 additions and 517 deletions
@@ -0,0 +1,593 @@
{
"mode": "FISCAL_ONLY (no Hub decision)",
"database": "CONSTRUCAO",
"crt": "1",
"products": 3712,
"fiscal_products_read": 3712,
"BEFORE": {
"COMPLETE_PRODUCTS": 3712,
"SAFE_BLOCKED_PRODUCTS": 0,
"COVERAGE_PERCENT": 100.0,
"UNKNOWN_APPLICABILITY_previous_model": 3712
},
"runs": {
"ERP_AS_FOUND": {
"rtc_enabled": true,
"TOTAL_PRODUCTS": 3712,
"COMPLETE_PRODUCTS": 0,
"SAFE_BLOCKED_PRODUCTS": 3712,
"FAILED_PRODUCTS": 0,
"UNCLASSIFIED_PRODUCTS": 0,
"COVERAGE_PERCENT": 0.0,
"INVARIANT_PASS": true,
"PIS_BLOCKERS": 0,
"COFINS_BLOCKERS": 0,
"RTC_BLOCKERS": 3712,
"OTHER_BLOCKERS": 0,
"blockers_by_type": {
"CCLASSTRIB_MISSING": 3712
},
"applicability": {
"NOT_APPLICABLE": 3712
},
"rtc_applicability": {
"REQUIRED": 3712
},
"changed_products": 3712,
"examples": [
{
"product": "000001",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000002",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000003",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000004",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000005",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000006",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000007",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000008",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000009",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000010",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000011",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000012",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000013",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000014",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000015",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000016",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000017",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000018",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000019",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000020",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000021",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000022",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000023",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000024",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000025",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000026",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000027",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000028",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000029",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000030",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
}
],
"context": {
"rtc_enabled": true,
"rtc_supported": true,
"rtc_catalog_valid": true,
"rtc_param": 1,
"catalog_integrity": {
"classes": 145,
"cst": 18,
"orphan_classes": 0,
"bad_class_format": 0,
"bad_cst_format": 0,
"duplicates": 0,
"valid": true
},
"crt": "1",
"products_evaluated": 3712
}
},
"RTC_OFF_SIMULATION": {
"rtc_enabled": false,
"TOTAL_PRODUCTS": 3712,
"COMPLETE_PRODUCTS": 3712,
"SAFE_BLOCKED_PRODUCTS": 0,
"FAILED_PRODUCTS": 0,
"UNCLASSIFIED_PRODUCTS": 0,
"COVERAGE_PERCENT": 100.0,
"INVARIANT_PASS": true,
"PIS_BLOCKERS": 0,
"COFINS_BLOCKERS": 0,
"RTC_BLOCKERS": 0,
"OTHER_BLOCKERS": 0,
"blockers_by_type": {},
"applicability": {
"NOT_APPLICABLE": 3712
},
"rtc_applicability": {
"NOT_APPLICABLE": 3712
},
"changed_products": 0,
"examples": []
},
"RTC_ON_SIMULATION": {
"rtc_enabled": true,
"TOTAL_PRODUCTS": 3712,
"COMPLETE_PRODUCTS": 0,
"SAFE_BLOCKED_PRODUCTS": 3712,
"FAILED_PRODUCTS": 0,
"UNCLASSIFIED_PRODUCTS": 0,
"COVERAGE_PERCENT": 0.0,
"INVARIANT_PASS": true,
"PIS_BLOCKERS": 0,
"COFINS_BLOCKERS": 0,
"RTC_BLOCKERS": 3712,
"OTHER_BLOCKERS": 0,
"blockers_by_type": {
"CCLASSTRIB_MISSING": 3712
},
"applicability": {
"NOT_APPLICABLE": 3712
},
"rtc_applicability": {
"REQUIRED": 3712
},
"changed_products": 3712,
"examples": [
{
"product": "000001",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000002",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000003",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000004",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000005",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000006",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000007",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000008",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000009",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000010",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000011",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000012",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000013",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000014",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000015",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000016",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000017",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000018",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000019",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000020",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000021",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000022",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000023",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000024",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000025",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000026",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000027",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000028",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000029",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
},
{
"product": "000030",
"BEFORE_STATUS": "COMPLETE",
"AFTER_STATUS": "BLOCKED_FISCAL_DATA",
"REASON": [
"CCLASSTRIB_MISSING"
]
}
]
}
},
"SAFETY": {
"FIREBIRD_WRITES": 0,
"WRITE_ATTEMPTS": 0,
"WRITE_SUCCESSES": 0,
"connection_mode": "READ COMMITTED READ ONLY (Agent reader); no write-capable connection opened"
}
}