Skip to main content

Roadmap tecnica

Milestone 0 — Baseline osservabile​

Obiettivo: poter riprodurre e misurare il comportamento corrente.

  • raccogliere falsi positivi e falsi negativi già osservati;
  • definire schema di annotazione;
  • creare golden dataset v1;
  • implementare evaluation harness;
  • registrare la baseline deterministica e LLM corrente;
  • rendere ripetibili prompt, modelli e configurazioni.

Gate: è disponibile un report riproducibile dell'AS IS.

Milestone 1 — Contratti Requirement Atom v2​

Obiettivo: separare candidato, decisione e atom.

  • definire semantic class e reason code;
  • estendere i contratti API ed eventi;
  • persistere candidati ammessi e rifiutati;
  • rendere obbligatorie citazioni esatte;
  • aggiungere stati di validazione;
  • versionare lo schema.

Gate: nessun atom può esistere senza candidato, decisione e source reference valida.

Milestone 2 — Pipeline multi-stage​

Obiettivo: sostituire l'estrazione monolitica.

  • candidate generation ad alto recall;
  • classificazione semantica;
  • admission gate indipendente;
  • atomicizzazione;
  • validazione strutturale;
  • deduplicazione e consolidamento cross-document;
  • review queue per casi incerti.

Gate: la nuova pipeline supera la baseline e i quality gate critici.

Milestone 3 — Routing LLM policy-aware​

Obiettivo: preparare il passaggio sicuro dai dati pubblici a quelli privati.

  • aggiungere dataClassification ai contratti;
  • centralizzare le policy nel llm-gateway;
  • vietare fallback esterni non autorizzati;
  • introdurre profili di capability locali;
  • configurare almeno un modello self-hosted per profilo richiesto;
  • verificare logging, cache, embedding e callback.

Gate: un test automatico prova che dati CONFIDENTIAL non raggiungono provider esterni.

Milestone 4 — Review UI​

Obiettivo: permettere validazione e correzione efficienti.

  • elenco candidati per stato;
  • confronto con fonte e contesto;
  • accept/reject con reason code;
  • modifica controllata degli atom;
  • gestione conflitti e duplicati;
  • audit delle decisioni;
  • metriche di agreement e carico di revisione.

Gate: un esperto può validare un Topic completo senza accedere direttamente al database.

Milestone 5 — Call Package publication gate​

Obiettivo: impedire che dati non affidabili alimentino le fasi successive.

  • calcolare quality report della versione;
  • bloccare citazioni invalide;
  • richiedere review dei mandatory incerti;
  • risolvere conflitti bloccanti;
  • mostrare copertura e limitazioni;
  • pubblicare solo versioni conformi.

Gate: ogni Call Package pubblicato è auditabile e soddisfa i quality gate configurati.

Milestone 6 — Proposal Workspace​

Questa milestone inizia solo dopo la stabilizzazione dei Requirement Atom:

  • workspace per candidatura;
  • raccolta di evidenze private;
  • correlazione requirement-evidence;
  • risposte atomiche;
  • coverage cockpit;
  • composizione della proposta con playbook PM²/Horizon;
  • rubric builder e quality review loop.

Componenti coinvolti​

ComponenteResponsabilità
call-package-rubric-servicecandidate generation, classificazione, atom e consolidamento
llm-gatewaypolicy, routing e validazione delle capability
data-serviceaccesso autorizzato alla persistenza
document-intelligence-servicestruttura e qualità del testo sorgente
Admin/Helpconfigurazione, diagnostica e documentazione
Bandi frontendreview UI e consultazione quality report

Strategia di rilascio​

Ogni milestone viene introdotta dietro configurazione e confrontata con la pipeline precedente. Le versioni pubblicate restano immutabili. Il passaggio alla nuova pipeline avviene solo dopo benchmark, test di regressione e verifica su almeno un Topic reale end-to-end.