Files
GTI_GERENCIADOR_FISCAL/fiscal/docs/AUTONOMOUS_OPERATIONS_CLOSURE_V1.md
gti d21a9d1140 Add 'fiscal/' from commit '102ba84500dbd9655a0471288c3e278652593ca9'
git-subtree-dir: fiscal
git-subtree-mainline: d95165fc8f
git-subtree-split: 102ba84500
2026-09-29 14:43:23 -03:00

3.4 KiB

Autonomous Operations Closure V1

Final Status

STATUS=OPERATIONALLY_CLOSURE_VALIDATED
TOTAL_PRODUCTS=35066
FISCALLY_COMPLETE=34872
FISCALLY_INCOMPLETE=194
AUTONOMOUSLY_CORRECTABLE_PRODUCTS=34872
SAFE_BLOCKED_PRODUCTS=194
AUTONOMOUSLY_PROCESSABLE_PRODUCTS=35066
AUTONOMOUS_OPERATION_RATE=100%
INSTALLATION_REQUIRES_OPERATOR_TO_CONTINUE=false
AGENT_HEALTH=HEALTHY

The 194 incomplete products are isolated safe exceptions. They do not stop processing of the other 34,872 products, heartbeat, new jobs, reconnection, or future deterministic corrections.

Product States

The operational contract has exactly seven states:

COMPLETE, CORRECTED, BLOCKED_MISSING_EVIDENCE, BLOCKED_CONFLICT, BLOCKED_COMPANY_CONTEXT, BLOCKED_SCHEMA, and FAILED_TECHNICAL.

Blocked products never receive uncertain writes. Technical failures are kept separate and retryable. A blocked product becoming complete on a later evaluation closes its registry blockers automatically.

Blocked Registry

The Hub now has a deduplicated blocked_products registry with tenant, company, product, GTIN, description, blocker type, field, reason, evidence, input fingerprint, timestamps, retry count, retry schedule, resolution time, and resolution source.

Available API operations:

  • GET /v1/blockers
  • GET /v1/blockers/export.csv
  • POST /v1/blockers/reprocess
  • POST /v1/blockers/{id}/resolve

The same blocker/input fingerprint is a cache hit and does not create another row or notification. Reprocessing is eligible when the product/context, dataset, KB, engine input, or retry schedule changes.

Current Residual

CFOP_BLOCKERS_BEFORE=79
CFOP_BLOCKERS_AFTER=79
ST_BLOCKERS_BEFORE=57
ST_BLOCKERS_AFTER=57
ICMS_RATE_BLOCKERS_BEFORE=53
ICMS_RATE_BLOCKERS_AFTER=53
CSOSN_BLOCKERS_BEFORE=27
CSOSN_BLOCKERS_AFTER=27
HUMAN_COMPANY_BLOCKERS=4
HUMAN_PRODUCT_BLOCKERS=190

No requiredness rule was weakened to increase the operation rate. The remaining fields require facts not proven by the current ERP evidence. The four company blockers remain context ambiguity; they were not converted into defaults.

Simulations

The offline 20,000-product simulation passed:

  • 19,900 complete products processed.
  • 100 safe blocked products preserved.
  • AGENT_HEALTH=HEALTHY.
  • Heartbeat and new jobs continue.
  • Second pass is idempotent.

The new-evidence simulation passed:

BLOCKED_MISSING_EVIDENCE -> COMPLETE -> blocker resolved.

Go-Live Policy

BLOCKED_REGISTRY_READY=true
BLOCKER_DEDUP_READY=true
AUTO_RETRY_READY=true
AUTO_RESOLUTION_READY=true
EXCEPTION_QUEUE_READY=true
AI_REQUIRED_FOR_MANDATORY_COMPLETENESS=0
EXTERNAL_PROVIDER_REQUIRED_FOR_MANDATORY_COMPLETENESS=0
AI_WRITE_ALLOWED=false
FIREBIRD_AI_WRITES=0
CAN_RUN_UNATTENDED_ON_CLIENTS=true
CAN_DEPLOY_WITHOUT_AI=true

This is an operational go/no-go assessment only. No deployment was performed.

Remaining Gaps

  • 194 products remain safely blocked by missing evidence or company context.
  • No deterministic write was required or executed in this closure.
  • AI remains optional enrichment for 511 items.
  • Real client deployment, infrastructure preflight, and production credentials remain outside this mission.

Verdict

VERDICT=AGENT_CAN_CONTINUE_UNATTENDED_WITH_SAFE_PER_PRODUCT_EXCEPTIONS

Verification

FULL_TESTS=tests 324 passed, 1 skipped
CENTRAL_TESTS=230 passed, 1 warning
AGENT_TESTS=44 passed
DIFF_CHECK=PASS