FAQ per sviluppatori

Domande comuni prima e durante l’implementazione

Questa pagina risponde alle domande che emergono più spesso quando un team vuole integrare EEV in un software senza perdersi tra contratto pubblico, scelte architetturali, compatibilità legacy e rilascio del prodotto.

Bisogna implementare tutto EEV in una sola volta?

No. Una prima versione credibile può puntare a un sottoinsieme chiaro, ad esempio la lettura di ENTRY in .eev e .eevz, con una validazione onesta e un writer canonico limitato ai campi che il software padroneggia davvero. Il punto importante non è coprire tutto subito, ma documentare esattamente ciò che è supportato.

Da dove conviene iniziare tecnicamente?

Il punto di partenza più pulito è la via testuale semplice: rilevare il contenitore, ottenere il testo grezzo, analizzare un ENTRY, costruire un modello interno e poi riemettere un testo stabile. Compressione e certificazione arrivano dopo come livelli aggiuntivi, non come un secondo nucleo.

Come gestire le varianti legacy?

In lettura, il parser può restare tollerante e convertire alcune forme legacy nel modello interno moderno, emettendo avvisi. In scrittura, il writer canonico non dovrebbe riciclare automaticamente quelle vecchie forme. Leggere in modo ampio e scrivere in modo pulito resta la regola più sicura.

ENTRY e LIB devono essere trattati come due formati distinti?

Non proprio. Sono due strutture contenitore della stessa famiglia. ENTRY descrive una singola impronta. LIB aggiunge una cornice di libreria capace di includere più voci. È preferibile condividere il più possibile la gestione dei blocchi interni e poi aggiungere intorno uno strato di libreria.

Che cosa deve garantire un writer canonico?

Deve produrre un testo deterministico, ordinato, leggibile e coerente con la versione del contratto pubblico di riferimento. Due esportazioni identiche devono dare la stessa uscita. I campi devono comparire in un ordine stabile, con una normalizzazione prevedibile di valori e sezioni.

Bisogna conservare le righe grezze originali?

Solo se il prodotto ne ha davvero bisogno per ispezione o strumenti di diff. Per la logica principale è meglio convergere rapidamente verso un modello interno pulito. Affidarsi troppo a lungo alle righe grezze rende molto più fragile l’evoluzione di parser e writer.

L’hash riguarda solo i file compressi?

No. La logica dell’hash riguarda l’integrità documentale, non il trasporto compresso. Un file può essere compresso oppure no; la vera questione è quali parti del documento siano protette e come verificare che non siano state alterate.

Il mio strumento deve gestire file EEVC?

È utile supportare la lettura di file EEVC o EEVCZ già emessi se il prodotto deve ispezionare o verificare materiale certificato. Questo sito non documenta la creazione locale di EEVC; per i workflow di verifica certificata usare eevc.link.

Quale messaggio di prodotto è meglio evitare?

È meglio evitare di presentare EEV come una semplice “nota arricchita” o come una promessa magica che da sola direbbe che cosa “fa” un suono. Il formato descrive e struttura in modo fine un comportamento vibratorio; non sostituisce né l’ascolto, né il giudizio umano, né i quadri interpretativi.

Il sito Open EEV richiede un database?

No. Il sito consegnato qui è un sito PHP leggero con i18n semplice. Può essere copiato direttamente nello spazio di hosting. Non è necessario alcun database MySQL e non ci sono comandi SQL da eseguire.