QualiBooth

Automazione

Integrazione CI/CD dell'accessibilità

Individua le regressioni di accessibilità nel momento in cui vengono introdotte. Colleghiamo i test WCAG automatici alla tua pipeline così ogni pull request viene controllata — e l'accessibilità compromessa non raggiunge mai la produzione.

Un diagramma di pipeline CI/CD con un gate di accessibilità automatico che controlla ogni pull request prima del merge.

Cosa ottieni

01

Controlli a ogni pull request

Le scansioni di accessibilità automatiche vengono eseguite su ogni PR e riportano i rilievi in linea, così i problemi vengono individuati in fase di revisione — non settimane dopo in un audit.

02

Rilevamento delle regressioni

Ogni scansione viene confrontata con uno snapshot di riferimento, così i nuovi problemi introdotti da una modifica sono chiaramente separati dal backlog preesistente — gli sviluppatori vedono esattamente cosa ha rotto il loro commit, nulla di più.

03

Integrazione GitHub Actions

La GitHub Action di QualiBooth si integra in qualsiasi repository in tre passaggi: aggiungere il secret dell'organizzazione, committare il file di workflow, fare push. L'action open-source è disponibile su github.com/QualiBooth/code-analysis. Il supporto per ulteriori piattaforme CI è in programma.

04

Segnalazione precisa per file e riga

Ogni violazione viene mostrata con il percorso esatto del file e il numero di riga — senza supposizioni né ricerche manuali. I livelli di severità Error e Warning consentono agli sviluppatori di stabilire le priorità rapidamente.

05

Storico dei Scan Runs

Ogni esecuzione di workflow GitHub viene registrata come Scan Run — ricercabile per repository, branch o hash di commit — con il numero totale di problemi, il numero di problemi risolti e lo stato dell'esecuzione.

06

Tarata per ridurre il rumore

Configuriamo regole e baseline così la pipeline segnala le regressioni reali senza sommergere gli sviluppatori di falsi positivi.

Il bug di accessibilità più economico è quello che non viene mai integrato. L’integrazione CI/CD dell’accessibilità sposta i test verso le prime fasi della tua pipeline di sviluppo, così le regressioni vengono individuate automaticamente a ogni pull request anziché emergere mesi dopo in un audit — o in un reclamo.

Perché integrare l’accessibilità nel CI/CD

La maggior parte dei team testa l’accessibilità a posteriori: un audit periodico produce un lungo elenco, il team lo corregge, e poi le stesse classi di problemi si insinuano di nuovo silenziosamente con le funzionalità successive. Automatizzare i controlli nella pipeline interrompe questo ciclo. Ogni modifica viene valutata mentre viene fatta, gli sviluppatori ricevono feedback mentre il codice è fresco e la conformità faticosamente conquistata è protetta dalle regressioni silenziose.

Come funziona

La funzionalità Code Analysis di QualiBooth si integra con GitHub Actions. Una volta configurato, il workflow viene eseguito automaticamente a ogni push e pull request:

  1. Installa la GitHub Action di QualiBooth e aggiungi il secret QUALIBOOTH_ORG_UUID.
  2. Committa il file di workflow — GitHub attiva automaticamente le scansioni di accessibilità da quel momento in poi.
  3. I risultati appaiono nel dashboard Scan Runs di QualiBooth, ricercabile per repository, branch o hash di commit.
  4. Ogni violazione viene localizzata a un percorso di file e un numero di riga con severità Error o Warning.
  5. Quando una correzione viene integrata, la scansione successiva contrassegna il problema come risolto — i progressi sono misurabili scansione per scansione.

La scansione basata su ESLint supporta attualmente codebase React, Vue, JavaScript e TypeScript. Il supporto per framework aggiuntivi e piattaforme CI è in programma.

Cosa configuriamo

  1. Integrazione GitHub Action — l’action di QualiBooth collegata al workflow del tuo repository.
  2. Feedback sulle PR — controlli automatici che commentano i rilievi direttamente sulle pull request.
  3. Rilevamento delle regressioni — ogni scansione viene confrontata con una baseline, così i nuovi problemi sono chiaramente separati dal backlog preesistente.
  4. Baseline — un’istantanea dei problemi esistenti così applichi il gate sui nuovi problemi, non sull’intero backlog tutto in una volta.
  5. Dashboard Scan Runs — ogni esecuzione registrata con branch, commit, conteggio dei problemi e tracciamento dei problemi risolti.

Dove vengono eseguiti i controlli

  • Pull request — scansioni veloci dei file modificati per un rapido feedback ai revisori
  • Push di branch — monitoraggio continuo così le regressioni vengono individuate prima della revisione della PR
  • Controlli pre-merge — rilevare le nuove regressioni prima che raggiungano il branch principale
  • Scansioni pianificate — scansioni notturne o di rilascio più complete sull’intera applicazione

Un confine onesto

I test automatici individuano in modo affidabile solo il 30–40% dei criteri di successo WCAG. Su questo siamo espliciti: l’integrazione CI/CD è il modo per evitare che i problemi automatizzabili vadano in produzione e per proteggerti dalle regressioni — ma non sostituisce il giudizio umano. La nostra guida ai test di accessibilità automatici nel CI/CD illustra dove si colloca questo confine nella pratica. Il quadro completo nasce dalla combinazione dei gate automatici con gli audit manuali svolti da persone con disabilità e gli audit ricorrenti.

A chi si rivolge

Team di ingegneria e di piattaforma che rilasciano in continuazione e vogliono che l’accessibilità sia un gate di qualità standard e automatico — proprio come i test e il linting. È una componente naturale di un più ampio programma di miglioramento dei processi di accessibilità.

Domande frequenti

I test automatici sostituiscono gli audit manuali?

No — e non lo affermeremo mai. I controlli automatici individuano in modo affidabile solo una parte dei WCAG. L'integrazione CI/CD previene le regressioni e individua presto i problemi facili; gli audit manuali svolti da persone con disabilità restano essenziali per il resto.

Quali sistemi CI supportate?

Code Analysis si integra attualmente tramite GitHub Actions — l'action è open-source su github.com/QualiBooth/code-analysis. Il supporto per ulteriori piattaforme CI è in programma.

Questo rallenterà le nostre build?

Le scansioni sono veloci e possono essere eseguite in parallelo agli altri controlli. Definiamo cosa testare per ogni fase — ad esempio, le pagine modificate sulle PR e una scansione più completa di notte — per mantenere rapido il feedback.

Come evitate che i falsi positivi blocchino gli sviluppatori?

Stabiliamo una baseline dei problemi esistenti, applichiamo il gate solo sulle nuove regressioni e tariamo l'insieme di regole sul tuo stack, così il segnale resta alto e gli sviluppatori si fidano del gate.

Potete configurarlo voi o solo fornire consulenza?

Entrambe le cose. Possiamo implementare l'integrazione end-to-end nella tua pipeline, oppure guidare il tuo team di piattaforma e rivedere la configurazione.

Richiedi una demo

Parla con i nostri esperti di accessibilità, incluse persone con disabilità.

Richiedi una demo