Modello Requirement Atom
Definizione
Un Requirement Atom è la più piccola richiesta autonoma, azionabile e verificabile derivata da una fonte ufficiale. Non coincide necessariamente con una frase: una frase può contenere più atom, mentre un atom può richiedere la ricostruzione controllata di più paragrafi adiacenti.
Un candidato può diventare Requirement Atom solo se permette di determinare:
- chi deve agire o soddisfare la condizione;
- quale azione, vincolo o risultato è richiesto;
- in quali condizioni si applica;
- come può essere verificato il suo soddisfacimento.
Classi semantiche
Ogni candidato riceve una classe primaria:
| Classe | Diventa requisito | Significato |
|---|---|---|
APPLICANT_REQUIREMENT | sì | Azione richiesta al proponente o alla proposta |
ELIGIBILITY_CONDITION | sì | Condizione formale di ammissibilità |
SCOPE_CONSTRAINT | sì | Limite o vincolo sull'ambito della proposta |
DELIVERABLE_REQUIREMENT | sì | Risultato o artefatto da produrre |
EVIDENCE_REQUIREMENT | sì | Informazione o prova da presentare |
EVALUATION_EXPECTATION | sì | Aspetto sul quale la proposta sarà valutata |
EXPECTED_OUTCOME | no, entità correlata | Cambiamento atteso dal programma |
POLICY_OBJECTIVE | no | Aspirazione o obiettivo di policy |
CONTEXT | no | Descrizione del problema o dello scenario |
DEFINITION | no | Definizione terminologica |
EXAMPLE | no | Esempio non prescrittivo |
PROCESS_INFORMATION | no | Informazione procedurale non richiesta alla proposta |
Questa separazione evita che expected outcome, motivazioni e narrativa di contesto vengano conteggiati come obblighi.
Struttura dati target
Ogni atom deve contenere almeno:
{
"sourceText": "citazione originale esatta",
"canonicalText": "normalizzazione conservativa",
"actionSummary": "azione operativa sintetica",
"actor": "PROPOSAL|APPLICANT|CONSORTIUM|BENEFICIARY",
"action": "DESCRIBE|DEMONSTRATE|PROVIDE|COMPLY|OTHER",
"object": "oggetto dell'azione",
"qualifiers": [],
"conditions": [],
"acceptanceSignals": [],
"strength": "MANDATORY|EXPECTED|RECOMMENDED|OPTIONAL",
"semanticClass": "APPLICANT_REQUIREMENT",
"categories": [],
"criterionCode": null,
"confidence": 0.0,
"validationStatus": "REVIEW_REQUIRED",
"sourceReferences": []
}
sourceText non viene riscritto. canonicalText corregge soltanto problemi di estrazione, mentre actionSummary rende l'atom utilizzabile nel lavoro quotidiano.
Atomicizzazione
La frase:
The proposal must describe the methodology, identify relevant risks and define measurable mitigation actions.
genera tre atom:
- descrivere la metodologia;
- identificare i rischi rilevanti;
- definire azioni di mitigazione misurabili.
Gli atom mantengono lo stesso candidato padre e la stessa citazione. La scomposizione non deve perdere qualificatori condivisi o cambiare la forza normativa.
Consolidamento tra documenti
Lo stesso requisito può comparire in Topic Page, Work Programme, General Annex, template e corrigendum. Il consolidamento deve distinguere:
- duplicato equivalente;
- specializzazione di una regola generale;
- integrazione con dettagli aggiuntivi;
- conflitto;
- sostituzione da corrigendum.
Il requisito canonico mantiene tutte le fonti e la loro priorità. Nessuna deduplicazione deve cancellare lo storico.
Stati di validazione
AUTO_ACCEPTED
REVIEW_REQUIRED
HUMAN_ACCEPTED
HUMAN_REJECTED
SUPERSEDED
Sono sempre inviati a revisione i candidati con soggetto implicito, citazione composta, conflitto documentale, scomposizione incerta o confidence inferiore alla soglia.