Factum Parse

Fatto, compiuto, verificato.

Factum Parse estrae dati strutturati da documenti amministrativi italiani — FatturaPA XML, fatture PDF, F24 — con un contratto di output unico e versionato (DocumentEnvelope v2). Nessuna congettura, nessun JSON “piatto” da indovinare: il payload è una union discriminata validata da Pydantic v2.

Fast-Path deterministico

~41 ms roundtrip per FatturaPA XML su produzione. Zero LLM, zero token, costo $0.0. In-process P50/P95 = 0.16 ms.

Coverage >83%

Suite 284 passed / 6 skipped con coverage 83.4% verificato da CI (GitHub Actions: pytest --cov=app --cov-fail-under=70).

Zero Data Retention

Ogni testo con PII passa dal sidecar Rizzo prima dell’LLM. Mapping in RAM, per-request, zero persistenza (ZDR — GDPR Art. 5/32). Sidecar giù = 503 fail-closed, mai testo scoperto.

Auth fail-closed

X-API-Key con confronto constant-time (secrets.compare_digest) e rate limit per tier su Redis. Senza chiave valida: 401, sempre.

Endpoint pubblici

Endpoint	Metodo	Scopo
/health	GET	Liveness operativa
/status	GET	Status page pubblica (senza auth)
/v1/parse	POST	Parse di testo — risposta ParseResponse (envelope v2)
/v1/uploads	POST	Upload documento (XML/PDF) — DocumentResponse
/v1/uploads/{job_id}	GET	Polling risultato upload

Indicatori di qualità (misurati, non promessi)

• Fast-Path XML: ~41 ms roundtrip prod · P95 in-process 0.16 ms · 1.900× sotto la SLA di 300 ms
• Cost-optimal: LLM usato solo dove il deterministico non basta (cascata deepseek-v3 → gpt-4o-mini)
• OpenAPI compliant: securitySchemes con APIKeyHeader, envelope v2 in schemas, DocumentResponse senza result ridondante

Inizia

1. Leggi API Reference per autenticazione e contratti.
2. Consulta Security & ZDR per le garanzie di privacy.
3. Integra con agenti via MCP Integration.