Entender los resultados

codqual usa varios vocabularios — una severidad, un veredicto, un estado — y es fácil confundirlos. Esta página explica qué significa cada uno y cómo se construyen las puntuaciones.

Severidad, veredicto y estado

Tres escalas distintas hacen tres trabajos distintos. La severidad califica un solo hallazgo; el veredicto del PR controla todo un pull request; el estado del issue registra en qué punto está un problema a lo largo del tiempo. Nunca se sustituyen entre sí.

El veredicto del PR se deriva de la severidad: cualquier hallazgo de severidad alta hace que el veredicto sea falla; cualquier hallazgo medio o bajo lo deja en advertencia; un diff limpio pasa. Un pull request recibe un veredicto, nunca una puntuación de 0 a 100 — la puntuación es una señal de todo el repositorio.

Issues, hallazgos y observaciones

Un hallazgo es lo que produjo un solo escaneo. Una observación es la detección de un problema en un escaneo. Un issue es el registro duradero que codqual mantiene entre escaneos — reúne las observaciones del mismo problema a lo largo del tiempo, para que puedas verlo aparecer, persistir y resolverse.

Cambiar el estado de un issue

Puedes establecer tres estados a mano: abierto, no se corregirá y falso positivo. Usa no se corregirá cuando un problema es real pero aceptado o no vale la pena corregirlo. Usa falso positivo cuando el hallazgo simplemente es incorrecto — esto también alimenta la supresión a nivel de equipo, para que el mismo hallazgo deje de reaparecer.

Resuelto es automático. codqual lo establece cuando un escaneo ya no observa el issue; no puedes establecerlo a mano.

Fusionado significa que un issue se absorbió en otro y quedó como una lápida. Para fusionar, selecciona dos o más issues, elige Fusionar y escoge el issue que se conservará. Hay una breve ventana para deshacer justo después.

Puntuación de salud

Un escaneo completo puntúa cada repositorio de 0 a 100. Las bandas:

Madurez

La madurez es una vista aparte, de más largo plazo: una rúbrica de 25 verificaciones en cinco dimensiones — Mantenibilidad, Corrección y confianza, Arquitectura y escalabilidad, Fiabilidad y operabilidad, y Seguridad y cumplimiento.

Cada verificación es pasa, parcial, falla o no evaluada. No evaluada significa estrictamente que el evaluador no se ejecutó en este escaneo — nunca que a tu repositorio le falte esa práctica.

La puntuación de una dimensión son sus puntos obtenidos (pasa vale 1, parcial vale 0.5) divididos entre sus verificaciones evaluadas, por 100. La puntuación general de madurez es el promedio de las dimensiones que se puntuaron.