9 reglas
Documentación
README presente y de al menos 500 caracteres, una LICENSE reconocida (en repositorios públicos), CHANGELOG, CONTRIBUTING, una sección de diseño en architecture.md.
Esté listo para la auditoría con un solo informe.
Cumplimiento revisa cada repositorio con una checklist de 36 reglas: documentación, higiene del repositorio, seguridad, CI e integración. Cada análisis produce una puntuación ponderada y una lista de resultados para entregar a un auditor.
Pantallas de una instalación en funcionamiento
36 reglas en cinco categorías
Cumplimiento mira lo que contiene un repositorio y cómo está configurado, no la lógica del código. Cada regla es una pregunta de sí o no con una severidad.
12 reglas
Higiene del repositorio
.gitignore y .editorconfig, descripción y topics, rama por defecto main o master, no archivado; en backends un Dockerfile multietapa y un docker-compose local.
7 reglas
Seguridad
Una política de seguridad, actualizaciones automáticas de dependencias, un .env.example, contenedores que se ejecutan sin root, imágenes base de registros permitidos, NuGet solo desde feeds permitidos.
5 reglas
Integración continua
Existe un workflow de CI y ejecuta las pruebas, un badge de build en el README, un script de lint para frontends, Fastlane para apps móviles.
3 reglas
Integración
La credencial Git del proyecto está sana, ArchPilot revisó un merge request recientemente, el espacio tiene un canal de notificaciones.
Qué reglas se aplican a cada proyecto
Un frontend no tiene Dockerfile que revisar y una app móvil no tiene robots.txt. Usted elige los stacks de cada proyecto; las reglas universales y de integración se aplican siempre.
Una respuesta que falta no es un fallo
Cada resultado es aprobado, fallido, omitido o error. Solo cuentan aprobado y fallido, ponderados por severidad; una regla sin respuesta sale del denominador en lugar de hundir la puntuación.
- Obligatoria×2
- Recomendada×1
- Opcional×0.5
- Aprobado · cuenta
- Fallido · cuenta
- Omitido · excluido
- Error · excluido
Por qué: una caída de la VPN hizo una vez que todos los proyectos marcaran 6/100. Un servidor Git inalcanzable no dice nada del repositorio, así que ya no cuenta.
Cómo se ejecuta un análisis
-
Se lanza
A mano, o con una programación diaria o semanal para un grupo o una lista de proyectos.
-
En cola
Un worker lo toma en segundos; el análisis registra quién o qué lo lanzó.
-
Reglas respondidas
Los archivos, ajustes del repositorio y protección de ramas se leen del proveedor Git; no se clona nada.
-
Puntuado y guardado
La puntuación pasa al historial y a la ficha de salud del proyecto, y al correo resumen si está suscrito.
Las reglas se activan o desactivan en tres niveles: valor por defecto de la instalación, espacio y proyecto. Gana el ajuste más específico.
Míralo en el producto
Todas las capturas
Entre en su próxima auditoría preparado
Elija el stack de cada proyecto, active las reglas que quiera y programe los análisis; la puntuación se mantiene al día sin que nadie tenga que acordarse.