Cada valor de un informe de inspect.software — componentes agregados en métricas, métricas agregadas en categorías y el índice de salud general — vive en una única escala estandarizada de 1–100, donde más alto es mejor. Para que esos números sean legibles de un vistazo, cada valor se asigna a una de siete bandas estandarizadas, utilizadas de forma consistente en las mediciones de salud, seguridad y calidad. Cada banda lleva además una calificación por letras compacta (de C a AAA) para las superficies donde una palabra no cabe.
Qué significa cada banda
| Banda | Calificación | Rango | Significado |
|---|---|---|---|
| Excepcional | AAA | 93–100 | El nivel más alto del registro (≈ el 5% superior); cumple prácticamente todos los criterios evaluados |
| Excelente | AA | 80–92 | Sólido en todos los frentes; carencias menores |
| Bueno | A | 65–79 | Saludable; carencias limitadas y manejables |
| Moderado | BBB | 50–64 | Aceptable con carencias notables; se recomienda revisión |
| Débil | BB | 35–49 | Debilidades sustanciales en varias áreas |
| En riesgo | B | 20–34 | Debilidades significativas; la adopción exige cautela |
| Crítico | C | 1–19 | Problemas graves — p. ej. abandonado, un solo mantenedor, sin higiene |
Calibrado con el registro público
Los umbrales inferiores de las bandas del índice de salud general no son números redondos arbitrarios: el índice está calibrado contra la distribución empírica del registro público (47.516 repositorios inspeccionados en la instantánea de calibración), de modo que cada banda indica dónde se sitúa un repositorio dentro del código abierto inspeccionado. En la media ponderada sin calibrar, la mitad del registro se apiñaba en un tramo de 20 puntos de la escala y el decil superior del código abierto se quedaba en los setenta altos — números que aprovechaban mal el rango 1–100 y hacían engañoso cada límite de banda. Tras la calibración, las bandas dividen el registro en poblaciones significativas y de tamaño comparable, y Excepcional significa lo que un lector supone que significa: aproximadamente el 5% superior del código abierto inspeccionado.
La curva de calibración es una constante fija de la metodología versionada, no un percentil vivo: la puntuación de un repositorio solo se mueve cuando se mueve su propia evidencia, nunca porque se hayan inspeccionado otros repositorios. Recalibrar contra una instantánea más reciente es un cambio de versión de la metodología como cualquier otro, registrado en cada informe.
Ciertas políticas de señales de alerta acotan el índice con independencia del resultado ponderado: una exposición no resuelta a jurisdicciones de alto riesgo mantiene el índice en el tope de En riesgo (34), y una dependencia maliciosa confirmada o un proyecto declarado muerto lo mantienen dentro de Crítico (19).
Cómo deben leerse las bandas
- Las bandas son gruesas a propósito. La diferencia entre 71 y 74 es ruido; la diferencia entre bueno y en riesgo es información. Las decisiones de adquisición y de revisión deben apoyarse en las bandas y en el perfil por categorías, no en diferencias de un solo punto. La vista de comparación está construida en torno a esto: enuncia la distancia entre los registros en pantalla en puntos de índice, de modo que una brecha de tres puntos pueda reconocerse como tal y dejarse a un lado.
- Las bandas se aplican en todos los niveles. Un repositorio puede situarse en la banda bueno en conjunto mientras una categoría está en crítico — las bandas por categoría existen precisamente para que la fortaleza en un área no pueda enmascarar silenciosamente el riesgo en otra. (La calibración se aplica al índice general; los valores de categorías y métricas se asignan directamente a los mismos umbrales.)
- Los umbrales están versionados. Los límites de las bandas forman parte de la metodología y solo cambian con un cambio de versión registrado en cada informe — véase versiones de la metodología.
Niveles de certificación
Las tres bandas por encima de Moderado llevan los niveles de certificación del registro: Certified (Bueno, calificación A), Certified with Excellence (Excelente, calificación AA) y Certified AAA (Excepcional). Un nivel es la banda que la evidencia publicada respalda, enunciada como una marca de certificación — véase cómo se obtienen y cambian los niveles, y certificación y precios para la vía de pago bajo demanda.
Dónde aparecen las bandas
Las bandas determinan el código de colores en todo el registro: las tarjetas del catálogo, el indicador del informe, los encabezados de categoría, las tarjetas de cada métrica y la insignia de GitHub. Un repositorio sin ninguna inspección completada muestra un estado neutro de pendiente en lugar de una banda.
Relacionado: el índice de salud explica cómo se calculan los valores 1–100 subyacentes; señales, no garantías explica qué afirman y qué no.