QualiBooth

Automatización

Integración de accesibilidad en CI/CD

Detecta las regresiones de accesibilidad en el momento en que se introducen. Conectamos pruebas automáticas de WCAG a tu pipeline para que cada pull request se compruebe, y la accesibilidad rota nunca llegue a producción.

Un diagrama de pipeline de CI/CD con una puerta automática de accesibilidad que comprueba cada pull request antes de la fusión.

Lo que obtienes

01

Comprobaciones en cada pull request

Los escaneos automáticos de accesibilidad se ejecutan en cada PR e informan de los hallazgos en línea, de modo que los problemas se detectan en la revisión, no semanas después en una auditoría.

02

Detección de regresiones

Cada análisis se compara con un snapshot de línea base, de modo que los nuevos problemas introducidos por un cambio se separan claramente del backlog existente — los desarrolladores ven exactamente qué rompió su commit, nada más.

03

Integración con GitHub Actions

La GitHub Action de QualiBooth se añade a cualquier repositorio en tres pasos: añade el secreto de organización, confirma el archivo de workflow y haz push. La acción de código abierto está en github.com/QualiBooth/code-analysis. La compatibilidad con otras plataformas de CI está en la hoja de ruta.

04

Informes exactos de archivo y línea

Cada infracción se muestra con la ruta exacta del archivo y el número de línea: sin suposiciones, sin búsquedas. Los niveles de gravedad Error y Warning permiten a los desarrolladores priorizar rápidamente.

05

Historial de Scan Runs

Cada ejecución de workflow de GitHub se registra como un Scan Run —con búsqueda por repositorio, rama o hash de commit— con recuentos de problemas totales, problemas corregidos y estado de la ejecución.

06

Ajustado para reducir el ruido

Configuramos reglas y referencias para que el pipeline señale las regresiones reales sin ahogar a los desarrolladores en falsos positivos.

El error de accesibilidad más barato es el que nunca se fusiona. La integración de accesibilidad en CI/CD desplaza las pruebas hacia la izquierda, hacia tu pipeline de desarrollo, de modo que las regresiones se detecten automáticamente en cada pull request en lugar de aflorar meses después en una auditoría, o en una reclamación.

Por qué integrar la accesibilidad en CI/CD

La mayoría de los equipos prueban la accesibilidad a posteriori: una auditoría periódica produce una larga lista, el equipo la corrige y luego las mismas clases de problemas vuelven a colarse silenciosamente con las siguientes funciones. Automatizar las comprobaciones en el pipeline rompe ese ciclo. Cada cambio se evalúa a medida que se hace, los desarrolladores reciben retroalimentación mientras el código está reciente y tu conformidad, lograda con esfuerzo, queda protegida frente a regresiones silenciosas.

Cómo funciona

La función Code Analysis de QualiBooth se integra con GitHub Actions. Una vez configurado, el workflow se ejecuta automáticamente en cada push y pull request:

  1. Instala la GitHub Action de QualiBooth y añade tu secreto QUALIBOOTH_ORG_UUID.
  2. Confirma el archivo de workflow: GitHub activará los escaneos de accesibilidad automáticamente desde ese momento.
  3. Los resultados aparecen en el panel Scan Runs de QualiBooth, con búsqueda por repositorio, rama o hash de commit.
  4. Cada infracción se ubica en una ruta de archivo y número de línea con gravedad Error o Warning.
  5. Cuando se aplica una corrección, el siguiente escaneo marca el problema como corregido: el progreso es medible ejecución a ejecución.

El escaneo basado en ESLint admite actualmente proyectos React, Vue, JavaScript y TypeScript. La compatibilidad con más frameworks y plataformas de CI está en la hoja de ruta.

Qué configuramos

  1. Integración con GitHub Actions — la acción de QualiBooth conectada al workflow de tu repositorio.
  2. Retroalimentación en los PR — comprobaciones automáticas que comentan los hallazgos directamente en los pull requests.
  3. Detección de regresiones — cada análisis se compara con una línea base para que los nuevos problemas se separen claramente del backlog existente.
  4. Referencias — una instantánea de los problemas existentes para que apliques puertas a los problemas nuevos, no a todo tu backlog de una vez.
  5. Panel de Scan Runs — cada ejecución registrada con rama, commit, recuentos de problemas y seguimiento de problemas corregidos.

Dónde se ejecutan las comprobaciones

  • Pull requests — escaneos rápidos de los archivos modificados para una retroalimentación ágil al revisor
  • Pushes de rama — monitorización continua para detectar regresiones antes de la revisión del PR
  • Comprobaciones pre-merge — detectar nuevas regresiones antes de que lleguen a la rama principal
  • Barridos programados — escaneos nocturnos o de versión más completos de toda la aplicación

Un límite honesto

Las pruebas automáticas detectan de forma fiable solo entre el 30 y el 40 % de los criterios de éxito de WCAG. Somos explícitos al respecto: la integración en CI/CD es la forma de evitar que los problemas automatizables lleguen a publicarse y de protegerte frente a las regresiones, pero no sustituye al juicio humano. Nuestra guía sobre pruebas de accesibilidad automatizadas en CI/CD explica dónde se sitúa esa línea en la práctica. La imagen completa surge de combinar las puertas automáticas con auditorías manuales por personas con discapacidad y auditorías periódicas.

Para quién es

Equipos de ingeniería y de plataforma que publican de forma continua y quieren que la accesibilidad sea una puerta de calidad estándar y automática, igual que las pruebas y el linting. Es un componente natural de un programa más amplio de mejora de procesos de accesibilidad.

Preguntas frecuentes

¿Las pruebas automáticas sustituyen a las auditorías manuales?

No, y nunca afirmaremos que lo hagan. Las comprobaciones automáticas solo detectan de forma fiable una parte de WCAG. La integración en CI/CD previene las regresiones y detecta pronto los problemas fáciles; las auditorías manuales por personas con discapacidad siguen siendo esenciales para el resto.

¿Qué sistemas de CI admiten?

Code Analysis se integra actualmente mediante GitHub Actions: la acción es de código abierto en github.com/QualiBooth/code-analysis. La compatibilidad con otras plataformas de CI está en la hoja de ruta.

¿Esto ralentizará nuestras compilaciones?

Los escaneos son rápidos y pueden ejecutarse en paralelo con otras comprobaciones. Definimos el alcance de lo que se prueba en cada fase —por ejemplo, las páginas modificadas en los PR y un barrido más completo cada noche— para mantener la retroalimentación ágil.

¿Cómo evitan que los falsos positivos bloqueen a los desarrolladores?

Establecemos una referencia de los problemas existentes, aplicamos puertas solo a las regresiones nuevas y ajustamos el conjunto de reglas a tu pila, de modo que la señal se mantenga alta y los desarrolladores confíen en la puerta.

¿Pueden configurarlo o solo asesoran?

Cualquiera de las dos. Podemos implementar la integración de principio a fin en tu pipeline, o guiar a tu equipo de plataforma y revisar la configuración.

Solicitar demo

Habla con nuestros expertos en accesibilidad, incluidas personas con discapacidad.

Solicitar demo