Preflight QC

Preflight QC è un componente aggiuntivo premium che ti offre un controllo qualità professionale delle release. Invia una release e Preflight QC la analizza da cima a fondo: metadati, date di uscita, audio, copertina e documentazione delle licenze. Ricevi un rapporto di qualità chiaro e su cui agire. Correggi ciò che segnala con i tuoi tempi, poi conferma la release per la revisione quando sei soddisfatto.

Per etichette e integratori dell’API, Preflight QC funziona come un mattone su cui costruire. Recupera il rapporto di qualità in modo programmatico, collegalo alla tua pipeline di QA, vincola il tuo processo interno di approvazione ai suoi risultati e conferma le release per la revisione in automatico. Il tuo team fissa l’asticella della qualità e Preflight QC fa l’analisi.

Una release che arriva pulita attraversa la revisione in fretta. Preflight QC ti ci porta prima ancora di inviarla.

Che cos’è Preflight QC

Con Preflight QC attivo sul tuo account, l’invio di una release per la distribuzione non la manda direttamente nella coda di revisione. La release entra invece in attesa pre-revisione (“in attesa della tua revisione”) mentre Preflight QC esegue la sua analisi di qualità: metadati, date di uscita, audio, copertina e documentazione delle licenze. Il risultato è un rapporto di qualità, e cosa costruirci sopra dipende da te:

• Il tuo processo di QA (API). Fai passare il tuo catalogo dall’analisi di qualità, recupera il rapporto in modo programmatico nella tua pipeline di QA, vincola il tuo processo interno di approvazione ai risultati e conferma ogni release per la revisione solo quando supera la tua asticella. Vedi Usare l’API per le integrazioni.
• Il flusso nell’app. Leggi il rapporto nella pagina della release, correggi ciò che segnala e conferma quando sei soddisfatto.

In entrambi i casi, è la conferma a spostare la release nella coda di revisione normale: nulla entra in revisione finché non dai il via libera.

Preflight QC aggiunge una fase di qualità prima della revisione. Non cambia ciò che accade dopo: una volta che confermi, la tua release segue lo stesso processo di validazione e revisione di qualsiasi altra release.

Come ottenere Preflight QC

Preflight QC è un componente aggiuntivo premium attivato per account dal nostro team. Per attivarlo sul tuo account, contatta il nostro team commerciale e comunica che desideri Preflight QC.

Una volta attivato, vedrai il nuovo passaggio di attesa e conferma alla prossima release che invii per la distribuzione.

Il flusso di lavoro di Preflight QC

Ecco il percorso completo di una release con Preflight QC attivo, dall’invio alla revisione.

1. Invia la tua release per la distribuzione

Crea e completa la tua release come al solito, poi inviala per la distribuzione. Con Preflight QC attivo, questo non mette subito la release nella coda di revisione. La release passa invece in attesa pre-revisione e viene contrassegnata come in attesa della tua revisione.

2. Viene eseguita l’analisi di qualità

Mentre la tua release è in attesa, Preflight QC la analizza da cima a fondo. L’analisi copre:

• Metadati: titoli, artisti, crediti e altri dettagli della release e delle tracce
• Date di uscita: la configurazione delle date e le versioni della release
• Audio: i file audio che hai caricato
• Copertina: l’immagine di copertina
• Licenze: quando una cover, un sample o simili richiedono documentazione a supporto

L’analisi di solito termina qualche minuto dopo il completamento del caricamento e della transcodifica. Mentre è ancora in corso, il rapporto di qualità indica che i controlli sono in corso e non elenca ancora alcun problema.

3. Leggi il tuo rapporto di qualità

Una volta terminata l’analisi, apri il rapporto di qualità della release per vedere cosa richiede la tua attenzione, se c’è qualcosa. Puoi leggerlo in due punti:

• Tramite l’API pubblica, per la tua pipeline di QA; vedi Usare l’API più sotto.
• Nell’app, nella pagina della release.

Il rapporto elenca ogni problema con un titolo chiaro e un messaggio che descrive cosa correggere. Vedi Capire il rapporto di qualità per sapere come leggere i campi.

4. Correggi ciò che è segnalato

Passa in rassegna i problemi del tuo rapporto:

• Problemi di metadati: modifica i dettagli della release o della traccia.
• Problemi di audio o copertina: sostituisci il file interessato.
• Problemi che richiedono un riscontro: rispondi nel thread di note del problema oppure carica il documento richiesto (ad esempio, una licenza per una cover o un sample).

Modificare la tua release mentre è in attesa riesegue le parti pertinenti dell’analisi, e il rapporto si aggiorna con i nuovi risultati. Puoi ripetere questo ciclo tutte le volte che ti servono.

5. Conferma la release

Quando il tuo rapporto è pulito, o hai affrontato tutto ciò che ti serviva, conferma la release. Nell’app è un pulsante di conferma sulla release; per le integrazioni è l’endpoint di conferma.

La conferma toglie la release dall’attesa e la sposta nella coda di revisione normale. La conferma richiede che l’analisi sia completa: se hai modificato la release dopo l’ultima esecuzione, attendi il rapporto aggiornato prima di confermare.

6. Revisione normale

Dopo la conferma, la tua release viene revisionata esattamente come qualsiasi altra. Per sapere cosa accade durante la revisione, i tempi e i possibili esiti, vedi Validazione e revisione.

Capire il rapporto di qualità

Il rapporto di qualità ha due parti: un elenco di problemi e un piccolo blocco di dettagli del report sull’esecuzione stessa.

Problemi

Ogni problema nel rapporto descrive un aspetto da esaminare. I campi con cui lavorerai:

Campo	Cosa ti indica
Titolo	Un nome breve e in linguaggio semplice per il problema.
Messaggio	In cosa consiste il problema e cosa fare al riguardo.
Gravità	L’importanza del problema, per aiutarti a dare le priorità.
Bloccante	Se il problema deve essere risolto prima di poter confermare (vedi sotto).
Richiede un riscontro	Se il problema necessita di una risposta scritta o di un documento caricato da te.
Descrizione personalizzata	Dettagli aggiuntivi specifici della tua release, quando disponibili.
Tracce interessate	A quali tracce si applica il problema. I problemi a livello di release non elencano tracce specifiche.

Bloccante o informativo

• I problemi bloccanti devono essere risolti prima di poter confermare la release per la revisione. Correggi ciò che descrivono, lascia che l’analisi venga rieseguita e spariranno dal tuo rapporto.
• I problemi informativi sono lì per segnalare qualcosa che vale la pena guardare, ma non ti impediscono di confermare. Esaminali e conferma quando sei pronto.

Problemi che richiedono un riscontro

Alcuni problemi non si risolvono con la sola modifica: richiedono qualcosa da parte tua, come una spiegazione scritta o un documento a supporto (ad esempio, una licenza per una cover o un sample). Sono contrassegnati come richiede un riscontro. Per risolverne uno, rispondi nel thread di note del problema o carica il documento richiesto prima di confermare.

I dettagli del report

Accanto ai problemi, il report include alcuni dettagli sull’esecuzione:

Campo	Cosa ti indica
generated_at	Quando è stato prodotto il report attuale. È vuoto mentre la prima analisi è ancora in corso.
checks_in_progress	true mentre l’analisi è ancora in corso; l’elenco dei problemi resta vuoto finché non termina.
hold	Se la release è attualmente in attesa pre-revisione.
review_status	Lo stato di revisione attuale della release.
profile	Il profilo di qualità applicato a questa release.

Usare l’API per le integrazioni

Se sviluppi sull’API pubblica di LabelGrid, puoi collegare Preflight QC alla tua pipeline: fai passare ogni release dall’analisi di qualità, recupera il rapporto nel tuo processo di QA, vincola il tuo processo interno di approvazione ai risultati e conferma per la revisione dai tuoi strumenti. Preflight QC fornisce due endpoint per questo, entrambi con la stessa autenticazione con token Bearer del resto dell’API pubblica. Per gli schemi completi e sempre aggiornati di richiesta e risposta, vedi il riferimento dell’API.

Ottenere il rapporto di qualità

GET /v4/public/release/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Restituisce il rapporto di qualità attuale della release. La risposta contiene:

• issues[]: una voce per problema, ciascuna con code (una stringa stabile; vedi Lavorare con i codici dei problemi), title, message, severity, is_blocking, requires_feedback, custom_description e affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status e profile.

Mentre l’analisi è ancora in corso, il report restituisce checks_in_progress: true con un elenco issues vuoto. Interroga l’endpoint a intervalli regolari finché generated_at non è valorizzato, di solito qualche minuto dopo il termine del caricamento e della transcodifica, poi leggi i problemi.

Un esempio di risposta ad analisi terminata:

{
  "issues": [
    {
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "hold": true,
    "review_status": "…",
    "profile": "…"
  }
}

Confermare la release per la revisione

POST /v4/public/release/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Toglie la release dall’attesa e la sposta nella coda di revisione normale: l’equivalente via API del pulsante di conferma nell’app.

La conferma richiede che l’analisi sia completa. Se la release è stata modificata dopo l’ultima esecuzione dell’analisi, il report si sta rigenerando e l’endpoint restituisce un conflitto. In tal caso, richiedi di nuovo il rapporto di qualità, attendi che generated_at sia di nuovo valorizzato e riprova la conferma.

Lavorare con i codici dei problemi

Se costruisci logica sopra il rapporto di qualità, basala sul code del problema:

• code è una stringa stabile in formato slug (ad esempio, audio.trailing-silence). Puoi mappare i codici nel tuo sistema e costruirci sopra la tua logica in sicurezza.
• Titoli e messaggi sono testi per le persone. Possono essere rifiniti nel tempo, quindi non basare mai la logica sul testo; usalo solo per la visualizzazione.
• Possono comparire nuovi codici man mano che la copertura di Preflight QC si amplia. Gestisci i codici che non riconosci in modo generico: mostra title e message dalla risposta invece di andare in errore.
• I tuoi rapporti ti insegnano i codici che contano. Man mano che fai passare le release da Preflight QC, i codici rilevanti per il tuo catalogo emergono naturalmente nei tuoi rapporti di qualità.
• Cosa copre l’analisi. I problemi rientrano in queste categorie: metadati di release e tracce, date e versioni della release, qualità audio, copertina, licenze e documentazione.

Il catalogo dei problemi

Per mappare i problemi quando costruisci il tuo processo di QA, recupera il catalogo completo in modo programmatico:

GET /v4/public/issue-definitions
Authorization: Bearer YOUR_API_TOKEN

Restituisce tutti i problemi che possono comparire in un rapporto di qualità, indicizzati per codice (stringa stabile), con titolo, modello del messaggio, gravità, indicatore bloccante e requires_feedback. L’endpoint è disponibile solo per gli account con il componente aggiuntivo Preflight QC.

Domande frequenti

E se l’analisi è ancora in corso?

Il report mostrerà checks_in_progress: true senza problemi elencati per ora. È normale subito dopo l’invio. Attendi qualche minuto dopo il termine del caricamento e della transcodifica, poi ricontrolla: nell’app il report si aggiorna da solo e, tramite l’API, puoi interrogarlo a intervalli regolari finché generated_at non è valorizzato.

Posso modificare la mia release mentre è in attesa?

Sì. Modificare una release in attesa pre-revisione riesegue le parti pertinenti dell’analisi e aggiorna il report, così puoi correggere i problemi e vedere i risultati aggiornati senza uscire dall’attesa. Ricorda solo che, dopo una modifica, dovrai attendere il report aggiornato prima di poter confermare.

Cosa succede dopo che confermo?

La tua release lascia l’attesa ed entra nella coda di revisione normale, dove viene revisionata come qualsiasi altra. Vedi Validazione e revisione per sapere come funziona la revisione, quanto dura e i possibili esiti.

Posso riportare una release a bozza?

Sì: finché la tua release è in attesa pre-revisione e non l’hai ancora confermata, non è entrata in revisione, quindi sei libero di continuare a modificarla o di lasciarla come bozza e tornarci più tardi. Entra nella coda di revisione solo quando la confermi.

Devo correggere ogni problema prima di confermare?

Devi risolvere i problemi bloccanti prima di poter confermare. I problemi informativi non ti impediscono di confermare, ma vale la pena guardarli: sistemare quanto più possibile prima della revisione è la via più rapida verso l’approvazione.

---

Domande su Preflight QC? Contatta il nostro team. Saremo felici di aiutarti.