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 cinco bandas estandarizadas, utilizadas de forma consistente en las mediciones de salud, seguridad y calidad.
Qué significa cada banda
| Banda | Rango | Significado |
|---|---|---|
| Excelente | 85–100 | Ejemplar; cumple prácticamente todos los criterios comprobados |
| Bueno | 70–84 | Saludable; carencias menores |
| Moderado | 50–69 | Aceptable con carencias notables; se recomienda revisión |
| En riesgo | 30–49 | Debilidades significativas; la adopción exige cautela |
| Crítico | 1–29 | Problemas graves — p. ej. abandonado, un solo mantenedor, sin higiene |
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.
- 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.
- 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.
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.