Guida Completa Human Structured Intake EVIDE Schema 2.1

Human Structured Intake

Il riferimento completo: ogni campo, ogni valore ammesso, ogni regola condizionale
Human Structured Intake permette a una persona di registrare, in forma strutturata, una decisione, determinazione o intervento — insieme al contesto evidenziario dichiarato disponibile al momento in cui la decisione è stata chiusa.

Preserva che una decisione è stata dichiarata, da chi, in quale ruolo dichiarato, quando è stata chiusa, e sotto quali condizioni dichiarate di soglia, prontezza e tracciabilità. Non determina se quella decisione fosse corretta, lecita o ottimale — e non verifica in modo indipendente la verità di ogni campo che una persona dichiara.
Seleziona la lingua
EnglishItalianoFrançaisDeutschEspañol
Documentazione    Human Structured Intake
Esplora la documentazione — seleziona una guida:
In questa pagina
Panoramica
Perché un’organizzazione dovrebbe usare Human Structured Intake?

La maggior parte delle decisioni organizzative lascia una traccia da qualche parte — un’email, un ticket, un commento in uno strumento di workflow, una riga in un foglio di calcolo. Quella traccia è raramente strutturata, raramente ancorata nel tempo in modo evidente-alla-manomissione, e raramente progettata per sopravvivere fuori dal sistema che l’ha creata. Quando una decisione viene successivamente messa in discussione — in un audit, una controversia, un’indagine regolamentare o un’investigazione interna — ricostruire esattamente cosa è stato deciso, da chi, in quale ruolo dichiarato, e in quali condizioni, può essere lento, incompleto o impossibile.

Human Structured Intake offre a una persona un modo strutturato per dichiarare una decisione nel momento in cui si chiude: il tipo di decisione, chi l’ha dichiarata e in quale ruolo, quando è stata chiusa, il contesto di classificazione e soglia applicabile, se era coinvolto un gate di prontezza, ed eventuali segnali rimasti irrisolti. EVIDE canonicalizza quindi quella dichiarazione, calcola un hash deterministico su di essa, e la preserva come record recuperabile in modo indipendente.

Human Structured Intake preserva che una decisione è stata dichiarata — non che la decisione fosse corretta.
La preservazione di una dichiarazione non è validazione indipendente della verità di quella dichiarazione.

Questa distinzione attraversa ogni campo documentato in questa pagina. Dove un valore usa una parola come «verificato,» quella parola descrive cosa una persona o un meccanismo a monte ha dichiarato — non una valutazione eseguita da EVIDE stessa, salvo diversamente specificato per quel campo specifico.

Prima del Riferimento sui Campi
Casi d’Uso Aziendali

I sette scenari qui sotto sono esempi illustrativi di come diverse funzioni aziendali potrebbero utilizzare Human Structured Intake. Ognuno mostra il tipo di decisione coinvolta, informazioni che potrebbero ragionevolmente essere dichiarate e, altrettanto importante, il confine di ciò che la preservazione di quel record da parte di EVIDE stabilisce e non stabilisce.

Compliance
Approvazione di un’eccezione di compliance

Evento / ContestoA un Compliance Officer viene chiesto di autorizzare temporaneamente un’eccezione a una procedura che normalmente sarebbe bloccata, sotto pressione temporale e con una giustificazione aziendale documentata.

Decisione UmanaL’officer approva un’eccezione temporanea e circoscritta, soggetta a condizioni specifiche e a un punto di revisione definito.

Informazioni che Potrebbero Essere Dichiarate

  • Tipo di decisione — es. «Approvazione eccezione compliance»
  • Ruolo dell’authority — es. «Compliance Officer»
  • Stato di classificazione di quanto sia consolidata la categorizzazione
  • Stato e riferimento della soglia — se una soglia della policy interna è stata raggiunta
  • Attribuzione della soglia — quanto chiaramente la proprietà della soglia è attribuibile
  • Prontezza del boundary — se un gate di prontezza ha confermato le condizioni, o l’officer sta solo dichiarando prontezza
  • Riferimento di tracciabilità — un riferimento al ticket interno o al fascicolo

Valore RicostruttivoUn revisore, auditor o regolatore successivo può ricostruire che l’eccezione è stata dichiarata, da chi, in quale ruolo, sotto quali condizioni dichiarate di soglia e prontezza, senza affidarsi alla memoria dell’officer o a un log di sistema che potrebbe nel frattempo essere stato ruotato.

Confine del claim EVIDE: EVIDE preserva che questa decisione, con questo contesto dichiarato, è stata registrata in questo momento. Non determina se l’eccezione fosse sostanzialmente o legalmente giustificata.
Cybersecurity / SOC
Autorizzazione dopo un alert di sicurezza

Evento / ContestoUn Security Operations Center rileva un comportamento anomalo. Un responsabile umano esamina la telemetria disponibile e deve decidere se consentire la prosecuzione, bloccare, isolare o escalare.

Decisione UmanaIl responsabile autorizza la prosecuzione operativa mentre l’indagine procede, invece di un isolamento immediato.

Informazioni che Potrebbero Essere Dichiarate

  • Tipo di decisione — es. «Autorizzazione a proseguire in attesa di indagine»
  • Stato di classificazione — spesso provisional, poiché l’indagine non è ancora chiusa
  • Prontezza del boundary — spesso verified_partial, se alcuni ma non tutti i segnali rilevanti sono stati esaminati
  • Segnali non risolti — es. «Origine di due richieste API non ancora attribuita»
  • Riferimento di tracciabilità — riferimento al caso SOC o all’ID dell’alert

Valore RicostruttivoSe l’incidente successivamente si aggrava, il record preserva esattamente ciò che era noto, e ciò che era esplicitamente segnalato come sconosciuto, nel momento in cui la decisione è stata presa, distinguendo il senno di poi genuino dalle informazioni realmente disponibili al momento della decisione.

Questo è un caso in cui verified_partial insieme a un array unresolved_signals popolato è spesso più onesto di un prematuro verified, usando solo valori e relazioni realmente supportati dal validatore.
Confine del claim EVIDE: EVIDE preserva che il responsabile ha dichiarato la prosecuzione operativa sotto queste condizioni dichiarate. Non determina se il sistema fosse realmente sicuro, o se la decisione fosse il giudizio di sicurezza corretto.
Risorse Umane
Revisione umana di una raccomandazione automatizzata

Evento / ContestoUn sistema assistito da AI produce una raccomandazione su un candidato o dipendente. Un revisore umano esamina quella raccomandazione e prende la decisione finale.

Decisione UmanaIl revisore accetta, modifica o supera la raccomandazione automatizzata.

Informazioni che Potrebbero Essere Dichiarate

  • Chi ha deciso, e in quale ruolo — es. «HR Director»
  • Momento esatto in cui la decisione è stata chiusa
  • Eventuale soglia utilizzata nel processo di revisione
  • Riferimento alla procedura HR interna che ha governato la revisione
  • Eventuali elementi rimasti contestati o irrisolti alla chiusura

Valore RicostruttivoIl record aiuta a preservare una separazione strutturale tra ciò che il sistema automatizzato ha raccomandato e ciò che l’essere umano ha effettivamente deciso, una distinzione spesso difficile da ricostruire a posteriori solo dai log di sistema.

Confine del claim EVIDE: EVIDE preserva che una decisione umana è stata dichiarata come distinta da una raccomandazione automatica. Non certifica che la revisione umana fosse sostanzialmente adeguata, priva di bias o conforme alla legge.
Prevenzione Frodi
Sblocco manuale di una transazione

Evento / ContestoUn sistema antifrode blocca una transazione come ad alto rischio. Un analista antifrode esamina il caso e deve decidere se rilasciarla, mantenerla bloccata o escalarla.

Decisione UmanaL’analista rilascia la transazione dopo la revisione, giudicando il segnale di rischio un falso positivo.

Informazioni che Potrebbero Essere Dichiarate

  • Tipo di decisione — es. «Rilascio manuale della transazione»
  • Ruolo dell’authority — es. «Fraud Analyst»
  • Stato della soglia — se la soglia di rischio frode che ha innescato il blocco è dichiarata raggiunta, non raggiunta o non chiara in revisione
  • Riferimento di tracciabilità — riferimento al fascicolo o all’ID della transazione

Valore RicostruttivoIl record preserva il contesto dichiarato dell’override umano, chi ha autorizzato il rilascio, quando e su quale base dichiarata, indipendentemente dal fatto che la transazione risulti poi essere stata legittima o meno.

Confine del claim EVIDE: EVIDE preserva che l’override è stato dichiarato sotto questo contesto dichiarato. Non determina se la transazione fosse, di fatto, fraudolenta.
Industriale / Manifatturiero
Autorizzazione al riavvio di una linea di produzione

Evento / ContestoUna linea di produzione si ferma automaticamente dopo il rilevamento di un’anomalia. Un responsabile tecnico esamina le condizioni rilevanti e deve decidere se autorizzare un riavvio.

Decisione UmanaIl responsabile autorizza il riavvio, avendo esaminato le informazioni diagnostiche disponibili.

Informazioni che Potrebbero Essere Dichiarate

  • Riferimento della soglia — es. la procedura tecnica o il limite operativo che governa le condizioni di riavvio
  • Identificatore del gate di prontezza — es. il controllo diagnostico eseguito prima di autorizzare il riavvio
  • Riferimento di ambito del gate di prontezza — es. quale macchina o linea il controllo ha coperto
  • Segnali non risolti, se qualche condizione resta incerta — es. «Lettura del sensore 4 non ancora convalidata incrociata»

Valore RicostruttivoSe un guasto correlato si ripete successivamente, il record preserva esattamente quale gate diagnostico è stato dichiarato essere stato controllato, e con quale ambito, prima che il riavvio fosse autorizzato.

Se qualche condizione resta incerta al momento del riavvio, questo è esattamente il caso per verified_partial più un elenco di segnali non risolti popolato, invece di un verified completo.
Confine del claim EVIDE: EVIDE preserva che un’autorizzazione al riavvio è stata dichiarata sotto questo contesto diagnostico dichiarato. Non verifica il risultato diagnostico stesso, né garantisce che la linea fosse, di fatto, sicura da riavviare.
AI Governance
Autorizzazione umana di un’azione di un agente AI

Evento / ContestoUn agente AI richiede di eseguire un’azione sensibile. Prima dell’esecuzione, un’authority umana deve approvare, rifiutare, condizionare o escalare la richiesta.

Decisione UmanaL’authority umana approva l’azione richiesta, soggetta a condizioni dichiarate.

Informazioni che Potrebbero Essere Dichiarate

  • Tipo di decisione — es. «Autorizzazione di azione richiesta da agente»
  • Ruolo dell’authority della persona che autorizza
  • Prontezza del boundary dell’autorizzazione stessa
  • Riferimento di tracciabilità — riferimento al log della richiesta dell’agente o al ticket di governance

Valore RicostruttivoHuman Structured Intake registra la decisione umana di autorizzare. Non è deliberatamente la stessa funzione di dichiarare il perimetro operativo entro cui l’agente era autorizzato (quella è l’estensione separata delle declarations documentata nella JSON Schema Reference), e non è un meccanismo automatico di autorizzazione all’esecuzione.

Confine del claim EVIDE: EVIDE preserva che un essere umano ha dichiarato questa decisione di autorizzazione, sotto queste condizioni dichiarate. Non verifica che l’agente abbia successivamente agito entro l’ambito autorizzato, e non autorizza né esegue nulla essa stessa.
Incident Response
Decisione durante un incidente attivo

Evento / ContestoDurante un incidente di cybersecurity, un responsabile deve scegliere tra corsi d’azione contrapposti sotto pressione temporale, ad esempio isolare un server rispetto a mantenere un servizio operativo nonostante un indicatore di compromissione.

Decisione UmanaIl responsabile dichiara un corso d’azione scelto, insieme alle informazioni disponibili in quel momento.

Informazioni che Potrebbero Essere Dichiarate

  • Tipo di decisione — es. «Decisione di contenimento dell’incidente»
  • Stato di classificazione, spesso provisional durante un incidente attivo
  • Prontezza del boundary ed eventuali segnali non risolti al momento della decisione
  • Riferimento di tracciabilità — riferimento al ticket dell’incidente

Valore RicostruttivoLe timeline degli incidenti vengono spesso ricostruite a posteriori sotto esame. Una dichiarazione strutturata e ancorata nel tempo riduce la dipendenza dalla ricostruzione dell’intento dalla memoria o da log non progettati per uso evidenziario.

Confine del claim EVIDE: EVIDE preserva lo stato dichiarato delle informazioni disponibili al momento della decisione. Non determina, a posteriori, se la decisione presa fosse oggettivamente il miglior corso d’azione.
Concetto Centrale
Chiusura della Decisione

Due timestamp diversi compaiono in ogni record Human Structured Intake, e rispondono a due domande diverse:

TimestampA cosa risponde
decision.closure_timestamp_utcQuando è stata chiusa la decisione stessa? Questo è il momento in cui la persona dichiara che la decisione è stata effettivamente presa — inserito dalla persona, in UTC.
Intake TimestampQuando EVIDE ha ricevuto e preservato questo record? Questo è generato dal server nel momento in cui l’intake viene elaborato, non inserito dalla persona.

Questi due momenti sono spesso diversi, e quella differenza è attesa, non un errore. Una decisione potrebbe essere chiusa alle 16:00 e registrata in EVIDE solo alle 18:03 — a causa di un passaggio di workflow ritardato, un processo di invio in batch, o semplicemente perché la persona che la registra lo fa più tardi nella giornata.

Perché questa distinzione conta per la ricostruibilità storica: se i due timestamp fossero trattati come intercambiabili, un revisore successivo potrebbe erroneamente concludere che una decisione è stata presa nel momento in cui è stata amministrativamente registrata, invece che nel momento in cui è stata effettivamente chiusa. Mantenerli visivamente e testualmente distinti preserva la capacità di ricostruire la vera sequenza degli eventi.
Cosa questo non stabilisce: decision_closure_timestamp_utc è un valore dichiarato dalla persona che compila l’intake. Non è un timestamp crittografico o «trusted» di quando la decisione è stata effettivamente presa nel mondo reale — EVIDE non ha modo indipendente di confermare che l’orario di chiusura dichiarato sia accurato. Ciò che EVIDE preserva, indipendentemente, è l’Intake Timestamp: il momento in cui il record stesso è stato ricevuto e canonicalizzato.
Prima dei Campi Evidenziari
Campi Comuni / Operativi dell’Intake

I sette campi qui sotto forniscono contesto operativo e organizzativo. Sono condivisi con gli altri tipi di intake di EVIDE e non sono specifici del modello evidenziario Human Structured — sono documentati qui brevemente, per completezza, piuttosto che con la stessa profondità dei campi nella sezione successiva.

CampoTipoRequisitoCos’è
titlestringaObbligatorioEtichetta breve del record. Verificato nel codice: questo valore viene copiato direttamente in decision.summary nel payload canonico — non è un campo separato e slegato.
business_area_idinteroObbligatorioL’area aziendale a cui appartiene l’intake. Verificato nel codice: deve riferirsi a un’area aziendale esistente e attiva, altrimenti la richiesta viene rifiutata.
descriptionstringaFacoltativoDescrizione testuale libera salvata insieme al record. Non inclusa nel payload evidenziario canonico stesso.
context_referencestringaFacoltativoRiferimento operativo testuale libero per uso interno.
notesstringaFacoltativoNote interne testuali libere.
topicstringaFacoltativoEtichetta di argomento testuale libera per organizzare gli intake.
case_referencestringaFacoltativoRiferimento testuale libero al caso o alla pratica. È lo stesso campo usato dalla ricerca «Evidence from the same case» disponibile altrove in EVIDE.
evidence_referencestringaFacoltativoRiferimento evidenziario testuale libero per collegamenti incrociati interni.

Questi campi forniscono contesto operativo e organizzativo per individuare e gestire l’intake all’interno della piattaforma. Non fanno parte del modello evidenziario Human Structured documentato nel resto di questa pagina, e la loro presenza o assenza non influisce sui campi evidenziari sottostanti.

Il Cuore di Questa Guida
Campi Evidenziari di Human Structured

I quattordici campi sotto sono i campi specifici del modello evidenziario Human Structured — verificati individualmente contro HumanStructuredIntakeService.php. La tabella offre un riepilogo rapido; segue una scheda esplicativa completa per ogni campo.

CampoTipoRequisito
decision_typestringaObbligatorio
decision_closure_timestamp_utcdatetimeObbligatorio
authority_rolestringaObbligatorio
authority_idstringaFacoltativo
authority_verification_notestringaFacoltativo
classification_statusenumFacoltativo
threshold_statusenumFacoltativo
threshold_referencestringaCondizionale
threshold_attribution_statusenumFacoltativo
trace_accessstringaFacoltativo
boundary_readiness_statusenumObbligatorio
readiness_gate_identifierstringaCondizionale
readiness_gate_scope_referencestringaCondizionale
unresolved_signals[]array di stringheCondizionale
Tipo di Decisione decision_type #decision-type
Required stringa
Percorso Canonico

decision.type

Cosa Significa

Un’etichetta testuale libera che descrive la categoria della decisione o intervento umano registrato — ad esempio, che tipo di decisione è, non cosa la decisione ha concluso.

Perché Esiste

Senza questo campo, un record non indicherebbe affatto che tipo di decisione o intervento è stato registrato. Dà ad ogni altro campo del record una categoria a cui riferirsi.

Quando Usarlo

Sempre — questo campo è obbligatorio per ogni Human Structured Intake.

Come Scegliere il Valore

Scegli un’etichetta abbastanza specifica da distinguere questa decisione da altre decisioni di tipo diverso, ma non duplicare la narrazione completa che appartiene al campo title (che diventa decision.summary). Un buon tipo di decisione nomina la categoria dell’azione; il title/summary descrive questa specifica istanza.

Relazioni

Distinto dal campo comune title, che viene copiato direttamente in decision.summary — una breve descrizione in linguaggio naturale di questa specifica decisione. decision_type nomina la categoria; decision.summary narra l’istanza.

Esempio Aziendale

Un Compliance Officer che approva un’eccezione temporanea di policy potrebbe registrare il tipo di decisione come «Approvazione eccezione compliance.» Un responsabile tecnico che autorizza un riavvio di produzione potrebbe usare «Autorizzazione riavvio linea di produzione.»

Valore di Esempio
decision_type"Revisione umana di raccomandazione automatizzata"
Errori Interpretativi Comuni
  • Questo non è un’enumerazione fissa — il validatore accetta qualsiasi testo libero non vuoto. La coerenza terminologica tra i record è una disciplina organizzativa, non un vincolo imposto dal sistema.
  • Un tipo di decisione specifico non stabilisce di per sé che la decisione sia stata presa correttamente o appropriatamente — nomina solo di che tipo di decisione si trattasse.

Cosa Preserva EVIDE

  • Che una decisione di questo tipo dichiarato è stata registrata, a questo orario di chiusura dichiarato, da questa authority dichiarata.

Cosa NON Afferma EVIDE

  • Che il tipo dichiarato provenga da un vocabolario controllato o standardizzato, confrontabile tra organizzazioni diverse.
Timestamp di Chiusura Decisione (UTC) decision_closure_timestamp_utc #decision-closure-timestamp
Required datetime
Percorso Canonico

decision.closure_timestamp_utc

Cosa Significa

Il momento dichiarato in cui la decisione umana stessa è stata chiusa — non il momento in cui il record è stato inviato a EVIDE. Vedi la sezione dedicata Chiusura della Decisione sopra per la distinzione completa dall’Intake Timestamp.

Perché Esiste

Una decisione e la sua preservazione evidenziaria raramente accadono nello stesso identico istante. Registrare l’orario di chiusura dichiarato, separatamente dall’orario di intake generato dal server, è ciò che permette una ricostruzione storica accurata di quando la decisione è realmente avvenuta.

Quando Usarlo

Sempre — questo campo è obbligatorio. Inserisci il momento in cui la decisione è stata effettivamente chiusa, in UTC, non il momento in cui stai compilando il modulo.

Come Scegliere il Valore

Usa il momento reale in cui la decisione è stata chiusa, espresso in UTC piuttosto che in ora locale. Se non sei sicuro del tuo scostamento UTC locale, uno strumento come time.is/UTC può aiutare a evitare un errore di alcune ore.

Comportamento Condizionale
Il valore deve essere una data/ora che il server possa interpretare; un valore non valido o vuoto viene rifiutato esplicitamente, invece di ricadere silenziosamente sull’orario corrente.
Esempio Aziendale

Una linea di produzione si ferma alle 14:32 ora locale. Il responsabile tecnico esamina le condizioni e autorizza un riavvio, chiudendo quella decisione alle 16:00 ora locale — ma registra l’intake in EVIDE solo alle 18:03, dopo aver terminato altri compiti urgenti. Il timestamp di chiusura preserva le 16:00 (convertite in UTC); l’Intake Timestamp preserva separatamente le 18:03.

Valore di Esempio
decision_closure_timestamp_utc"2026-04-07T16:00:00Z"
Errori Interpretativi Comuni
  • Questo non è il momento in cui il record è stato ricevuto da EVIDE — quello è il separato Intake Timestamp, generato dal server.
  • Inserire l’ora locale senza convertirla in UTC è l’errore più comune con questo campo, e produce un orario di chiusura sfasato del proprio scostamento UTC locale.

Cosa Preserva EVIDE

  • Il momento dichiarato in cui la decisione è stata chiusa, come dichiarato dalla persona che la registra.

Cosa NON Afferma EVIDE

  • Che questo timestamp sia un record crittograficamente affidabile o verificato in modo indipendente di quando la decisione nel mondo reale è effettivamente avvenuta. È un valore dichiarato.
Ruolo dell’Authority authority_role #authority-role
Required stringa
Percorso Canonico

authority.role

Cosa Significa

Il ruolo organizzativo, in quale veste, la decisione è dichiarata essere stata presa — distinto dall’identità della persona che l’ha presa.

Perché Esiste

Un nome da solo non indica in quale veste organizzativa una decisione è stata presa. Il ruolo aiuta un lettore successivo a ricostruire l’autorità organizzativa dichiarata dietro la decisione, indipendentemente da chi specificamente ricoprisse quel ruolo in quel momento.

Quando Usarlo

Sempre — questo campo è obbligatorio per ogni Human Structured Intake.

Come Scegliere il Valore

Usa il titolo del ruolo organizzativamente significativo per questa decisione — es. «Compliance Officer,» «SOC Manager,» «HR Director,» «Fraud Analyst,» «Plant Manager.» Testo libero, non un elenco fisso.

Relazioni

Distinto da authority_id (chi) e dall’identità DAPI della sessione loggata (vedi Identificativo dell’Authority sotto). Il ruolo risponde a «in quale veste,» non «quale persona specifica.»

Esempio Aziendale

La stessa persona potrebbe ricoprire più ruoli attraverso decisioni diverse; lo stesso ruolo potrebbe essere ricoperto da persone diverse nel tempo. Registrare il ruolo, separatamente dall’individuo, mantiene leggibile il contesto organizzativo anche quando il personale cambia.

Valore di Esempio
authority_role"Compliance Officer"
Errori Interpretativi Comuni
  • Questo campo non verifica che la persona dichiarata ricoprisse effettivamente questo ruolo nell’organizzazione — è un valore dichiarato, come gli altri campi di testo libero in questa pagina.

Cosa Preserva EVIDE

  • Il ruolo organizzativo o la veste dichiarata sotto cui la decisione è stata presa.

Cosa NON Afferma EVIDE

  • Che EVIDE abbia confermato in modo indipendente che la persona ricoprisse questo ruolo all’interno dell’organizzazione.
Identificativo dell’Authority authority_id #authority-id
Optional stringa
Percorso Canonico

authority.id

Cosa Significa

Un identificativo dichiarato di chi ha preso la decisione. Verificato nel codice: se lasciato vuoto, questo campo assume come default il nome e cognome completo dell’utente attualmente loggato — ma può essere modificato, per il caso legittimo di registrare una decisione presa da qualcun altro.

Perché Esiste

Non ogni decisione registrata in EVIDE è stata presa dalla persona che sta operando la tastiera. Permettere che questo campo sia modificabile consente a una persona di registrare accuratamente una decisione presa da un collega, mantenendo comunque separatamente preservata l’identità verificata della sessione sottostante.

Quando Usarlo

Lascialo vuoto quando tu, l’utente loggato, sei la persona che ha preso la decisione — il tuo nome verrà usato automaticamente. Compilalo esplicitamente quando stai registrando una decisione presa da una persona diversa.

Quando Non Usarlo

Non trattare questo campo come un sostituto, o una modifica, della tua identità verificata di account — quell’identità è preservata separatamente e automaticamente, indipendentemente da cosa inserisci qui.

Relazioni

Verificato nel codice: ogni record Human Structured porta anche authority.dapi_number, l’identificativo DAPI della sessione effettivamente loggata e autenticata — impostato automaticamente dal server ad ogni invio e mai letto dal modulo. authority.id e authority.dapi_number sono deliberatamente indipendenti: il primo è un’etichetta dichiarata, il secondo è l’identità verificata della sessione.

Esempio Aziendale

Un assistente inserisce una decisione in EVIDE per conto di un manager che ha effettivamente preso la decisione. L’assistente lascia autenticata la propria sessione (preservata automaticamente come authority.dapi_number), ma imposta authority_id sul nome del manager, riflettendo accuratamente chi ha realmente preso la decisione.

Valore di Esempio
authority_id"Jane Whitfield"
Errori Interpretativi Comuni
  • authority_id non è la stessa cosa di un’authority verificata in modo indipendente. È un valore dichiarato, testo libero, che per default coincide con l’utente loggato, ma può essere sovrascritto.
  • Sovrascrivere questo campo non cambia né sostituisce l’identità DAPI verificata della sessione — quell’identità viene registrata in modo indipendente, in un campo separato, indipendentemente da cosa viene dichiarato qui.

Cosa Preserva EVIDE

  • L’identificativo dichiarato di chi ha preso la decisione (di default, il nome dell’utente loggato se non modificato).
  • Separatamente e sempre: l’identità DAPI della sessione autenticata reale, in authority.dapi_number.

Cosa NON Afferma EVIDE

  • Che il valore authority.id dichiarato sia stato esso stesso verificato in modo indipendente rispetto a un sistema di identità esterno.
Nota di Verifica Authority authority_verification_note #authority-verification-note
Optional stringa
Percorso Canonico

authority.verification

Cosa Significa

Una nota testuale libera, dichiarata facoltativamente, che la persona che registra la decisione può usare se intende collegare l’authority dichiarata a un riferimento più specifico — ad esempio, un riferimento DAPI per la persona o il ruolo coinvolti.

Perché Esiste

Dà a chi dichiara un modo per aggiungere un riferimento più specifico all’authority dichiarata, senza richiederne uno su ogni record.

Quando Usarlo

Quando vuoi dichiarare un riferimento più specifico legato all’authority dietro questa decisione, e tale riferimento è genuinamente disponibile.

Quando Non Usarlo

Non usare questo campo come se scriverlo costituisse una verifica. È una nota dichiarata, non un controllo eseguito da EVIDE.

Comportamento Condizionale
Verificato nel codice: se questo campo è presente e non vuoto, il valore authority_verification_status calcolato lato server nella risposta API diventa claimed invece di declared — documentato per intero nella JSON Schema Reference. Questo riflette che un riferimento è stato dichiarato, non che sia stato verificato.
Esempio Aziendale

Un Compliance Officer referenzia un’identità collegata a DAPI interna come contesto di supporto per l’authority dichiarata dietro l’approvazione di un’eccezione, senza che quel riferimento sia controllato in modo indipendente da EVIDE.

Errori Interpretativi Comuni
  • Una nota di verifica compilata non significa che EVIDE abbia eseguito un controllo di identità. Lo stato claimed risultante descrive cosa è stato dichiarato, non cosa è stato verificato.
  • Questo campo non ha relazione con l’identità DAPI della sessione effettivamente loggata, che è preservata automaticamente e separatamente (vedi Identificativo dell’Authority).

Cosa Preserva EVIDE

  • Che una nota legata alla verifica è stata dichiarata, esattamente come inserita.

Cosa NON Afferma EVIDE

  • Che la nota dichiarata costituisca, o derivi da, una verifica di identità indipendente eseguita da EVIDE.
Stabilità della Classificazione classification_status #classification-status
Optional enum
Percorso Canonico

intervention.classification_status

Valori Ammessi
stable

La classificazione assegnata a questa decisione è considerata consolidata, senza ambiguità note sotto la categorizzazione attiva al momento della chiusura.
Esempio: un caso di frode esaminato e chiuso con una categorizzazione chiara e non contestata.
Non significa: che la classificazione sia fissata permanentemente o immune da future revisioni — solo che nessuna ambiguità era nota alla chiusura.

provisional

La classificazione è ancora provvisoria o in attesa di perfezionamento — potrebbe cambiare man mano che emergono più informazioni.
Esempio: un’indagine di sicurezza attiva dove la categoria dell’incidente potrebbe essere rivista mentre l’indagine prosegue.
Non significa: che la decisione stessa sia incompleta — la decisione può comunque essere finalizzata mentre la sua classificazione resta provvisoria.

contested

La classificazione è assegnata nonostante un disaccordo interpretativo noto, o una sovrapposizione con un’altra categoria.
Esempio: una decisione dove due persone ragionevoli potrebbero categorizzare lo stesso caso diversamente, e quel disaccordo è noto alla chiusura.
Non significa: che la decisione sottostante sia invalida — solo che la sua categorizzazione porta con sé una tensione interpretativa riconosciuta.

Perché Esiste

Rende osservabile la qualità operativa di una classificazione al momento del deposito, invece di presentare ogni classificazione con la stessa fiducia implicita e non dichiarata.

Quando Usarlo

Quando hai una visione di quanto sia consolidata, provvisoria o contestata la classificazione assegnata a questa decisione.

Quando Non Usarlo

Se non hai una base per giudicare la stabilità della classificazione, è accettabile lasciare questo campo non impostato invece di indovinare — il campo è facoltativo, e il sistema non assume alcuno stato di default se è assente.

Valore di Esempio
classification_status"provisional"

Cosa Preserva EVIDE

  • Lo stato di stabilità dichiarato della classificazione assegnata a questa decisione.

Cosa NON Afferma EVIDE

  • Che la classificazione stessa sia corretta — solo quanto consolidata o contestata è stata dichiarata la sua assegnazione.
Stato della Soglia threshold_status #threshold-status
Optional enum
Percorso Canonico

intervention.classification_context.threshold_status

Valori Ammessi
met

Una soglia decisionale rilevante è dichiarata raggiunta.
Esempio: una policy interna richiedeva una giustificazione documentata sopra un certo livello di rischio, ed è stata fornita.

not_met

Una soglia decisionale rilevante è dichiarata non raggiunta.
Esempio: la revisione ha rilevato che le condizioni richieste per l’approvazione automatica non erano soddisfatte, richiedendo un intervento manuale.

unknown

Una soglia esiste in questo contesto, ma se sia stata raggiunta non è noto al momento della chiusura. Questo è diverso da not_defined — qui, una soglia si applica genuinamente, ma il suo stato non ha potuto essere stabilito.

not_defined

Nessuna soglia era definita per questo caso. Questo è diverso da unknown — qui, non c’è una soglia applicabile da valutare, piuttosto che una irrisolta.

Cosa Significa

Una soglia, in questo contesto, è un criterio decisionale predefinito — un limite di policy, una regola operativa, una condizione di approvazione — rispetto al quale una decisione può essere valutata. Questo campo dichiara se una tale soglia è stata raggiunta.

Perché Esiste

Espone se una soglia decisionale si applicasse a questo caso, e in tal caso, il suo stato dichiarato — informazione spesso implicita e non documentata negli ordinari strumenti di workflow.

Quando Usarlo

Quando una soglia, regola o condizione di policy definita è rilevante per questa decisione.

Quando Non Usarlo

Quando nessuna soglia del genere si applica realmente a questa decisione — in quel caso, not_defined è il valore accurato, non semplicemente lasciare il campo vuoto se hai motivo di dichiarare attivamente che nessuna soglia si applica.

Comportamento Condizionale
Verificato nel codice: questo campo governa la visibilità di threshold_reference sotto — se threshold_status è not_defined, qualsiasi valore inserito in threshold_reference viene scartato silenziosamente dal server, anche se inviato.
Valore di Esempio
threshold_status"met"
Errori Interpretativi Comuni
  • unknown non deve essere letto come equivalente a «nessuna soglia esiste.» È questo che significa not_defined. unknown significa che una soglia si applica, ma il suo stato non ha potuto essere stabilito.

Cosa Preserva EVIDE

  • Lo stato dichiarato di una soglia decisionale rilevante per questo caso.

Cosa NON Afferma EVIDE

  • Che EVIDE abbia valutato in modo indipendente se la soglia sia stata effettivamente raggiunta — questo è uno stato dichiarato.
Riferimento della Soglia threshold_reference #threshold-reference
Conditional stringa
Percorso Canonico

intervention.classification_context.threshold_reference

Cosa Significa

Un riferimento testuale libero alla soglia, policy o regola specifica citata in threshold_status sopra.

Perché Esiste

Permette di ricondurre la soglia dichiarata a qualcosa di concreto — un documento di policy, una procedura, un controllo interno — invece di rimanere un’affermazione generale non attribuita.

Quando Usarlo

Quando threshold_status è met, not_met, o unknown, e hai un riferimento specifico disponibile — ad esempio, il nome di una policy, un codice di procedura, o un identificativo di documento, forniti solo come esempi illustrativi compatibili con questo campo di testo libero.

Comportamento Condizionale
Verificato nel codice: se threshold_status è not_defined, questo campo viene scartato dal server anche se viene inviato un valore. Non c’è bisogno di lasciarlo vuoto in modo difensivo — il server lo impone comunque, ma è buona pratica lasciarlo vuoto quando nessuna soglia è definita.
Valore di Esempio
threshold_reference"Policy interna COM-EXC-04, sezione 3.2"

Cosa Preserva EVIDE

  • Il riferimento dichiarato alla soglia specifica citata, quando si applica uno stato della soglia diverso da not_defined.

Cosa NON Afferma EVIDE

  • Che il documento, policy o procedura referenziata sia stata recuperata, letta o validata in modo indipendente da EVIDE.
Attribuzione della Soglia threshold_attribution_status #threshold-attribution
Optional enum
Percorso Canonico

intervention.classification_context.threshold_authority.attribution_status

Valori Ammessi
attributed

Un’authority singola, identificabile e attribuibile per la soglia è stata definita alla chiusura.
Esempio: una policy esplicitamente posseduta da un comitato nominato.
Quando usarlo: quando puoi indicare un unico proprietario chiaro della soglia.

fragmented

La soglia è definita attraverso più fonti, senza un’authority singola attribuibile.
Esempio: una regola assemblata da diversi documenti di linee guida interne sovrapposti senza un unico proprietario.
Errore interpretativo comune: fragmented non significa che la soglia sia invalida — solo che la sua proprietà è distribuita.

implicit

La soglia è presente nella pratica ma non era formalmente definita o attribuibile alla chiusura.
Esempio: una norma interna non scritta ma applicata in modo consistente.
Errore interpretativo comune: implicit non significa che le soglie informali siano illegittime — solo che mancano di attribuzione formale.

unknown

L’authority dietro la soglia non ha potuto essere verificata al momento della chiusura.
Esempio: chi dichiara è consapevole che una soglia esiste ma non può identificare chi la possiede.

Cosa Significa

L’attribuzione della soglia descrive quanto chiaramente l’authority o la proprietà dietro la soglia citata sopra possa essere ricondotta a una persona, ruolo o comitato specifico — non se la soglia stessa sia stata raggiunta.

Perché Esiste

Diventa rilevante proprio quando uno stato della soglia di met o not_met viene dichiarato, ma la proprietà di quella soglia non è chiaramente attribuibile a un’unica fonte — rendendo quell’ambiguità stessa parte del record preservato.

Quando Usarlo

Quando hai una visione di quanto chiaramente attribuibile sia la proprietà della soglia citata.

Valore di Esempio
threshold_attribution_status"attributed"

Cosa Preserva EVIDE

  • Lo stato dichiarato di attribuibilità dell’authority dietro la soglia citata.

Cosa NON Afferma EVIDE

  • Chi dovrebbe possedere la soglia, o che la sostanza della soglia sia stata esaminata in modo indipendente — solo se una fonte di authority attribuibile per essa è stata dichiarata esistere.
Riferimento di Tracciabilità trace_access #trace-access
Optional stringa
Percorso Canonico

intervention.trace.access

Cosa Significa

Un riferimento testuale libero che permette a qualcuno successivamente di individuare il contesto più ampio di questa decisione all’interno del sistema dove è effettivamente avvenuta — un ticket, un ID di caso, un riferimento di audit trail, un riferimento di log, o un riferimento di workflow, forniti come esempi illustrativi di ciò che è semanticamente compatibile con questo campo.

Perché Esiste

Una decisione raramente esiste isolata dal più ampio percorso operativo che l’ha circondata. Questo campo preserva un puntatore a quel percorso, senza che EVIDE debba ricevere o memorizzare il percorso stesso.

Quando Usarlo

Ogni volta che esiste un riferimento specifico e individuabile in un altro sistema — un numero di ticket, un fascicolo di caso, o una voce di log di audit — che un revisore successivo potrebbe usare per trovare più contesto.

Valore di Esempio
trace_access"SOC-CASE-4471"
Errori Interpretativi Comuni
  • Un riferimento di tracciabilità non significa che EVIDE abbia accesso a, o abbia ispezionato, il sistema a cui quel riferimento punta. È un puntatore dichiarato, nient’altro.

Cosa Preserva EVIDE

  • Il riferimento dichiarato per individuare ulteriore contesto su questa decisione.

Cosa NON Afferma EVIDE

  • Che EVIDE abbia accesso a, abbia recuperato, o abbia verificato i contenuti del sistema referenziato.
Prontezza del Boundary boundary_readiness_status #boundary-readiness
Required enum
Percorso Canonico

handoff.boundary_readiness.status

Valori Ammessi
candidate

Nessun gate indipendente ha valutato questo oggetto. Chi dichiara afferma solo di considerarlo pronto, senza che sia stato eseguito un controllo indipendente.
Quando sceglierlo: questo è il default onesto quando nessun meccanismo di prontezza separato era coinvolto — non è un valore più debole o minore, è quello accurato per quella situazione.

verified

Un gate di prontezza indipendente ha confermato la stabilità attraverso ciò che dichiara essere visibilità completa, senza segnali irrisolti.
Quando sceglierlo: solo quando un meccanismo genuinamente separato — distinto dalla persona o dal sistema che ha preso la decisione — ha eseguito questa valutazione.
Errore interpretativo comune: questo valore non può essere auto-dichiarato semplicemente sentendosi fiduciosi riguardo a una decisione; significa specificamente che un gate indipendente era coinvolto.

verified_partial

Un gate indipendente ha confermato ciò che è stato in grado di osservare, ma dichiara esplicitamente che alcuni segnali rilevanti restano irrisolti.
Quando sceglierlo: quando un gate di prontezza era coinvolto ma la sua visibilità era genuinamente incompleta — richiede almeno una voce in unresolved_signals.

unverifiable

Un gate di prontezza ha tentato una valutazione, ma la visibilità a sua disposizione era insufficiente per raggiungere qualsiasi conclusione di stabilità. Questo dimostra che la diligenza è stata tentata, non che il processo sia fallito.
Quando sceglierlo: quando un genuino tentativo di valutazione di prontezza non ha potuto raggiungere una conclusione a causa di visibilità insufficiente — richiede anch’esso almeno una voce in unresolved_signals.

Cosa Significa

La prontezza del boundary dichiara quanto questa decisione sia considerata pronta, al momento della chiusura, per la sua preservazione evidenziaria — nello specifico, se un gate di prontezza indipendente l’ha valutata, e cosa quel gate ha potuto e non ha potuto osservare. È una dichiarazione sullo stato di prontezza, non una proprietà che EVIDE stessa misura o conferma.

Perché Esiste

Decisioni diverse portano gradi molto diversi di prontezza confermata in modo indipendente prima di essere preservate. Comprimere tutte in un unico stato indifferenziato nasconderebbe esattamente l’informazione di cui un revisore successivo ha più bisogno: questa decisione è stata controllata in modo indipendente prima di essere registrata, e se sì, quanto completamente?

Quando Usarlo

Sempre — questo campo è obbligatorio per ogni Human Structured Intake.

Come Scegliere il Valore

Chiediti concretamente: un meccanismo genuinamente separato da chi ha preso la decisione ha valutato la prontezza di questo oggetto prima che fosse registrato? Se nessun meccanismo del genere era coinvolto, il valore onesto è candidate. Se uno era coinvolto, scegli tra verified, verified_partial, o unverifiable in base a quanto genuinamente completa fosse la visibilità di quel meccanismo.

Relazioni

Verificato nel codice: visibility_surface (un campo interno nel payload canonico) è derivato meccanicamente da questo valore attraverso una mappatura fissa — non è mai una scelta separata fatta dalla persona che compila il modulo. Questo valore governa anche se readiness_gate_identifier/readiness_gate_scope_reference e unresolved_signals sono richiesti (vedi Relazioni Condizionali tra i Campi sotto per le regole esatte).

Comportamento Condizionale
Se questo valore è qualsiasi cosa diversa da candidate, sia readiness_gate_identifier sia readiness_gate_scope_reference diventano obbligatori insieme. Se questo valore è verified_partial o unverifiable, almeno una voce in unresolved_signals diventa obbligatoria.
Esempio Aziendale

Un responsabile tecnico che autorizza un riavvio di produzione dopo un’anomalia potrebbe dichiarare verified_partial se un gate diagnostico automatizzato ha controllato la maggior parte, ma non tutti, i sensori rilevanti prima del riavvio — con il sensore specifico non controllato registrato come segnale non risolto.

Valore di Esempio
boundary_readiness_status"verified_partial"
Errori Interpretativi Comuni
  • La parola verified in questo campo è un valore dichiarato nel modello dati, non una valutazione eseguita da EVIDE. EVIDE stessa non controlla se il gate dichiarato abbia effettivamente operato, o se le sue conclusioni fossero accurate.
  • Non leggere candidate come un invio carente o incompleto — è il valore strutturalmente accurato ogni volta che nessun gate di prontezza indipendente era genuinamente coinvolto.

Cosa Preserva EVIDE

  • Lo stato di prontezza dichiarato al boundary, e, quando applicabile, un riferimento al meccanismo dichiarato che ha eseguito la valutazione.

Cosa NON Afferma EVIDE

  • Che EVIDE stessa abbia eseguito, confermato o verificato in modo indipendente qualsiasi valutazione di prontezza. Un valore di verified descrive cosa è stato dichiarato riguardo a un gate a monte o indipendente — non è mai la verifica di EVIDE stessa della decisione.
Identificatore del Gate di Prontezza readiness_gate_identifier #readiness-gate-identifier
Conditional stringa
Percorso Canonico

handoff.boundary_readiness.readiness_gate.identifier

Cosa Significa

Un gate, in questo contesto, è qualsiasi meccanismo — umano o automatizzato — che ha eseguito la valutazione di prontezza dichiarata in boundary_readiness_status. Questo campo nomina o identifica quel meccanismo.

Perché Esiste

Permette di ricondurre la valutazione di prontezza dichiarata a qualcosa di specifico, invece di rimanere un’affermazione generale non attribuita.

Quando Usarlo

Obbligatorio ogni volta che boundary_readiness_status è qualsiasi cosa diversa da candidate — cioè, ogni volta che si dichiara un gate indipendente.

Comportamento Condizionale
Verificato nel codice: obbligatorio insieme a readiness_gate_scope_reference ogni volta che boundary_readiness_status non è candidate. Se uno dei due manca in quella condizione, la richiesta viene rifiutata. Nessuno dei due campi viene richiesto quando lo stato è candidate.
Esempio Aziendale

Un controllo diagnostico usato prima di autorizzare un riavvio di produzione, o il codice della procedura interna che governa una revisione di eccezione di compliance.

Valore di Esempio
readiness_gate_identifier"COM-EXC-04"
Errori Interpretativi Comuni
  • Il nome «gate» non implica che EVIDE stessa abbia eseguito, gestito o abbia accesso a questo meccanismo. È un identificativo dichiarato per un meccanismo che ha operato interamente al di fuori di EVIDE.

Cosa Preserva EVIDE

  • L’identificativo dichiarato del meccanismo che ha eseguito la valutazione di prontezza.

Cosa NON Afferma EVIDE

  • Che EVIDE abbia eseguito, ispezionato o verificato in modo indipendente il meccanismo nominato.
Riferimento di Ambito del Gate di Prontezza readiness_gate_scope_reference #readiness-gate-scope
Conditional stringa
Percorso Canonico

handoff.boundary_readiness.readiness_gate.scope_reference

Cosa Significa

Mentre readiness_gate_identifier nomina il meccanismo o controllo dichiarato aver operato, questo campo descrive il perimetro o ambito che quel meccanismo è dichiarato aver coperto.

Perché Esiste

Un gate nominato è più utile quando anche la sua copertura è specificata — lo stesso controllo diagnostico potrebbe coprire un’intera struttura in un caso e una singola macchina in un altro.

Quando Usarlo

Obbligatorio nella stessa condizione di readiness_gate_identifier sopra: ogni volta che boundary_readiness_status è qualsiasi cosa diversa da candidate.

Relazioni

Distinto da readiness_gate_identifier: uno nomina il meccanismo, l’altro descrive cosa è dichiarato aver coperto.

Esempio Aziendale

Per un riavvio di linea di produzione, l’identificatore potrebbe nominare il controllo diagnostico usato, mentre il riferimento di ambito nomina la macchina o linea specifica che quel controllo copriva.

Valore di Esempio
readiness_gate_scope_reference"Linea 3, modulo di estrusione"

Cosa Preserva EVIDE

  • L’ambito o perimetro dichiarato che il gate di prontezza nominato è dichiarato aver coperto.

Cosa NON Afferma EVIDE

  • Che l’ambito dichiarato sia stato confermato in modo indipendente come accurato o completo.
Segnali Non Risolti unresolved_signals[] #unresolved-signals
Conditional array di stringhe
Percorso Canonico

handoff.boundary_readiness.unresolved_signals

Cosa Significa

Un segnale non risolto è un elemento specifico rimasto irrisolto o non attribuito al momento in cui la valutazione di prontezza è stata fatta — il «perché» dichiarato dietro un risultato verified_partial o unverifiable, non solo il fatto che uno si sia verificato.

Perché Esiste

Senza questo elenco, un lettore che incontra «Prontezza del boundary: verified_partial» saprebbe che qualcosa era incompleto, ma non cosa — spesso l’informazione singola più utile per una ricostruzione successiva della decisione.

Quando Usarlo

Obbligatorio ogni volta che boundary_readiness_status è verified_partial o unverifiable — almeno una voce è richiesta in quel caso.

Quando Non Usarlo

Non usato, e normalmente lasciato vuoto, quando lo stato è candidate o verified, poiché in quei casi non viene dichiarata alcuna lacuna irrisolta.

Come Scegliere il Valore

Elenca ogni elemento specifico rimasto irrisolto, nel modo più concreto possibile — sono supportate più voci quando più di un segnale è rimasto aperto.

Relazioni

Direttamente governato da boundary_readiness_status: obbligatorio (minimo una voce) quando quel valore è verified_partial o unverifiable.

Comportamento Condizionale
Verificato nel codice: se boundary_readiness_status è verified_partial o unverifiable e questo array è vuoto, la richiesta viene rifiutata.
Esempio Aziendale

Per lo scenario di autorizzazione SOC nei Casi d’Uso Aziendali sopra, questo potrebbe leggere: «Origine di due richieste API non ancora attribuita.»

Valore di Esempio
unresolved_signals[]["Origine di due richieste API non ancora attribuita"]
Errori Interpretativi Comuni
  • EVIDE non determina essa stessa la verità, gravità, materialità o rilevanza di alcun segnale non risolto elencato — preserva l’elenco dichiarato esattamente come inserito, senza valutarne autonomamente il contenuto.

Cosa Preserva EVIDE

  • I segnali specifici dichiarati come non risolti al momento della valutazione di prontezza.

Cosa NON Afferma EVIDE

  • Che EVIDE abbia valutato la verità, gravità, materialità o rilevanza di alcun segnale elencato. Preserva la dichiarazione, non un giudizio su di essa.
Come i Campi si Collegano tra Loro
Relazioni Condizionali tra i Campi

Le regole sotto sono verificate direttamente contro il validatore in HumanStructuredIntakeService.php — non assunte dai nomi dei campi o da schemi di documentazione generali.

Se…Allora…
threshold_status = not_definedQualsiasi valore inviato in threshold_reference viene scartato dal server, anche se presente nella richiesta.
boundary_readiness_statuscandidatereadiness_gate_identifier E readiness_gate_scope_reference diventano entrambi obbligatori insieme. Se uno dei due manca, la richiesta viene rifiutata.
boundary_readiness_status ∈ {verified_partial, unverifiable}unresolved_signals[] diventa obbligatorio, con un minimo di una voce. Un array vuoto viene rifiutato sotto questa condizione.
Una voce di evidence_references[] include un hash_valuehash_scope e hashed_by diventano entrambi obbligatori insieme per quella voce. Una dichiarazione hash parziale — un valore senza entrambi — viene rifiutata.
Un fatto correlato, non condizionale, che vale la pena notare qui: visibility_surface, un campo interno dentro il payload canonico, è sempre derivato meccanicamente da boundary_readiness_status attraverso una mappatura fissa. Non è mai un valore scelto direttamente dalla persona che compila il modulo.
Referenziare Ciò che EVIDE Non Detiene
Riferimenti Esterni all’Evidenza

Un riferimento esterno all’evidenza permette a un Human Structured Intake di puntare a un artefatto — un documento, uno screenshot, un file di log, una policy — che resta sotto il controllo dell’organizzazione stessa, senza che quell’artefatto venga mai caricato o detenuto da EVIDE. Verificato nel codice: questo riusa, senza modifiche, l’esatta struttura evidence_references[] già documentata nella JSON Schema Reference — non un meccanismo parallelo o specifico di Human.

Questo conta perché risolve una tensione genuina e comune: un’organizzazione spesso ha bisogno di preservare una dichiarazione verificabile su una decisione, evitando deliberatamente di consegnare un documento interno sensibile a qualsiasi sistema esterno. I riferimenti esterni all’evidenza permettono a entrambe le cose di accadere contemporaneamente.

Esempio aziendale. Un Compliance Officer basa una decisione su un documento interno, POLICY-CREDIT-REV7. L’organizzazione mantiene quel documento sotto il proprio controllo. L’Human Structured Intake può preservare un riferimento dichiarato a quella policy e, quando disponibile, il suo digest SHA-256 — senza che EVIDE riceva mai il documento stesso.
Campi Disponibili Per Riferimento (tutti individualmente facoltativi)
artifact_typeTipo dichiarato testuale libero — es. screenshot, pdf, policy_document. Non un’enumerazione fissa.
pointerUn riferimento specifico dell’implementazione alla posizione dell’artefatto. EVIDE non lo risolve, dereferenzia o recupera.
declared_originDescrizione testuale libera di dove proviene l’artefatto.
declared_relationshipDescrizione testuale libera di come l’artefatto si relaziona a questa decisione.
declared_descriptionDescrizione testuale libera leggibile dall’uomo.
declared_retention_statusUno tra persistent_storage, rolling_buffer, unknown. Verificato nel codice: mai impostato automaticamente per default — incluso solo se la persona lo seleziona attivamente.
Digest Facoltativo (SHA-256)

Un riferimento può opzionalmente portare un digest SHA-256 dichiarato dell’artefatto. Vedi la sezione dedicata SHA-256 sotto per cosa questo stabilisce esattamente e cosa non stabilisce.

Referenziare l’Integrità di un Artefatto
SHA-256

SHA-256 è una funzione hash crittografica: prende qualsiasi file e produce deterministicamente un digest a lunghezza fissa tale che anche una minuscola modifica al file produce un digest completamente diverso. In un riferimento esterno all’evidenza, un digest SHA-256 dichiarato permette a una parte successiva che detiene l’artefatto reale di verificare se corrisponda a ciò che è stato dichiarato al momento dell’intake.

Come viene usato in pratica: un digest dichiarato può successivamente essere confrontato con un digest calcolato ex novo su un artefatto disponibile. Se corrispondono, l’artefatto non è cambiato da quando il digest è stato dichiarato. Se non corrispondono, o l’artefatto è cambiato, o non è lo stesso file originariamente referenziato.

Verificato nel codice: la validazione dell’hash su questo canale è puramente sintattica — il server conferma che il valore dichiarato sia esattamente 64 caratteri esadecimali, nient’altro. EVIDE non riceve l’artefatto e non può controllare se il digest dichiarato corrisponda realmente ad esso. Il valore dichiarato viene preservato esattamente come inserito, mai normalizzato in maiuscolo o minuscolo.

Cosa Stabilisce un Digest Dichiarato

  • Che questo specifico digest è stato dichiarato, dalla persona che invia l’intake, in questo momento specifico.
  • Una base per un confronto successivo e indipendente contro un artefatto detenuto da qualcun altro.

Cosa Non Stabilisce un Digest Dichiarato

  • La paternità dell’artefatto.
  • La provenienza dell’artefatto.
  • La verità o accuratezza sostanziale del contenuto dell’artefatto.
  • Validità legale, proprietà, o originalità.
  • Che EVIDE abbia posseduto, ispezionato o verificato l’artefatto — è rimasto esterno per tutto il tempo.

La distinzione che conta è tra cinque cose separate: l’artefatto esterno stesso (mai ricevuto da EVIDE); il riferimento dichiarato ad esso; il digest dichiarato (facoltativo, controllato solo sintatticamente); un confronto hash successivo che qualcun altro potrebbe eseguire; e la preservazione della dichiarazione da parte di EVIDE — l’unica di queste cinque cose che EVIDE effettivamente esegue.

Confine del Claim
Cosa Preserva EVIDE

Il principio generale: preservazione strutturata della dichiarazione e del suo contesto evidenziario dichiarato associato, esattamente come inviato, canonicalizzato e sottoposto a hash in modo deterministico ed evidente-alla-manomissione.

Concretamente, Quando Presenti

  • Il tipo di decisione dichiarato e l’orario di chiusura.
  • Il contesto di authority dichiarato — ruolo, identificativo dichiarato, e l’identità DAPI verificata della sessione che ha effettuato l’invio.
  • La classificazione dichiarata e il suo stato di stabilità.
  • Il contesto della soglia dichiarato e il suo stato di attribuzione.
  • Il riferimento di tracciabilità dichiarato.
  • Lo stato di prontezza del boundary dichiarato ed eventuali informazioni associate sul gate.
  • Eventuali segnali non risolti dichiarati.
  • Eventuali riferimenti esterni all’evidenza dichiarati, incluso un digest dichiarato facoltativo.
Leggi Questo Prima di Fare Affidamento su Qualsiasi Record
Cosa NON Afferma EVIDE
Mettere Tutto Insieme
Esempio Aziendale Completo

Tornando allo scenario Compliance dai Casi d’Uso Aziendali: a un Compliance Officer, Jane Whitfield, viene chiesto di approvare un’eccezione temporanea alla checklist standard di onboarding fornitori, sotto una giustificazione aziendale documentata e un punto di revisione definito.

Chiude la decisione alle 16:00 UTC, ma registra l’intake più tardi, alle 18:03 UTC, dopo aver terminato una chiamata. Dichiara il suo ruolo come Compliance Officer, referenzia la policy interna che governa eccezioni di questo tipo, e nota che un comitato di revisione interno — un meccanismo indipendente dalla sua stessa decisione — ha confermato le condizioni rilevanti con visibilità completa prima che lei prendesse la sua decisione. Referenzia il ticket interno che traccia questa eccezione, e separatamente dichiara un documento di policy con il suo digest SHA-256, mantenuto internamente invece di essere caricato su EVIDE.

Ogni valore sotto è scelto per essere internamente coerente e compatibile con le regole condizionali documentate sopra — i campi sono inclusi perché si adattano a questo caso specifico, non semplicemente per dimostrare che ogni campo esiste.

Il Payload Risultante
Esempio JSON / Payload

Questo è il payload canonico che EVIDE costruisce dall’esempio sopra — verificato campo per campo contro HumanStructuredIntakeService.php. I campi generati automaticamente dal server (mai letti dal modulo) sono contrassegnati di conseguenza.

"evide_schema": "2.1",
"source_system": "evide_web_human",               // generato dal server, fisso per questo canale
"source_reference": "web:1042:a3f91c2d",          // generato dal server
"source_timestamp_utc": "2026-04-07T18:03:00Z",  // generato dal server -- quando EVIDE ha elaborato questo intake

"decision": {
  "type": "Compliance exception approval",
  "status": "finalized",                    // sempre fisso su questo canale
  "closure_timestamp_utc": "2026-04-07T16:00:00Z", // dichiarato -- vedi Chiusura della Decisione sopra
  "summary": "Temporary exception to vendor onboarding checklist" // copiato dal campo comune "title"
},

"authority": {
  "id": "Jane Whitfield",                     // dichiarato (di default l'utente loggato se vuoto)
  "role": "Compliance Officer",
  "dapi_number": "DAPI-2K9-XXXX",               // sempre generato dal server dalla sessione, mai dal modulo
  "verification": "Linked to internal DAPI reference for the review board"
},

"intervention": {
  "classification_status": "stable",
  "classification_context": {
    "threshold_status": "met",
    "threshold_reference": "Internal policy COM-EXC-04, section 3.2",
    "threshold_authority": { "attribution_status": "attributed" }
  },
  "trace": { "access": "Ticket COMP-2026-0417" }
},

"handoff": {
  "reconstruction_independence": "declared",   // fisso
  "submission_status": "not_submitted",         // fisso al momento dell'intake
  "acceptance_status": "not_claimed",           // fisso al momento dell'intake
  "boundary_readiness": {
    "status": "verified",
    "visibility_surface": "declared_complete", // derivato meccanicamente dallo status sopra
    "readiness_gate": {
      "identifier": "COM-EXC-04 review board",
      "scope_reference": "Vendor onboarding exceptions, Q2 2026"
    }
  }
},

"extensions": ["evidence_references"],
"evidence_references": [
  {
    "artifact_type": "policy_document",
    "pointer": "internal://policies/vendor-onboarding-v3",
    "declared_origin": "internal policy repository",
    "declared_description": "Policy document supporting this exception approval",
    "hash": { "algorithm": "SHA-256", "value": "cabbcf9f83fb765cd82569e477b6b3abf51d81eba9b3b92f8e9904be98a1a2f8" },
    "hash_scope": "full_file",
    "hashed_by": "internal document management system"
  }
]
Nota: unresolved_signals è correttamente assente qui — è richiesto solo quando boundary_readiness.status è verified_partial o unverifiable, non verified come in questo esempio.

Documentazione correlata:
JSON Schema Reference — lo schema completo del payload, inclusi evidence_references e l’estensione declarations condivisa con EVIDE ANCHOR.
API Reference — endpoint e profili operativi.
Architecture Guide — motivazioni architetturali e principi di design.

Human Structured Intake esiste affinché una decisione umana dichiarata, e il suo contesto evidenziario dichiarato, possano sopravvivere fuori dal sistema che li ha prodotti — recuperabili in modo indipendente, sottoposti a hash deterministico, e ancorati nel tempo.

EVIDE preserva che una decisione è stata dichiarata.
Non decide se la decisione fosse giusta.