6 min lectura • Guide 843 of 877
Gobernanza de Calidad de Código
La gobernanza de calidad de código asegura estándares y prácticas consistentes entre equipos de desarrollo. GitScrum proporciona métricas de calidad y seguimiento de gobernanza para mantener altos estándares de código.
Framework de Gobernanza de Calidad
CICLO DE GOBERNANZA:
┌─────────────────────────────────────────────────────────────┐
│ │
│ Definir ──► Implementar ──► Monitorear ──► Mejorar │
│ Estándares Controles Cumplimiento Continuo │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ Guías de Checks Métricas de Loops de │
│ Código Automatizados Calidad Feedback │
│ │
└─────────────────────────────────────────────────────────────┘
Métricas de Calidad
Métricas Clave a Rastrear
DASHBOARD DE MÉTRICAS DE CALIDAD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ COBERTURA DE CÓDIGO: │
│ • Porcentaje de código cubierto por tests automatizados │
│ • Objetivo: > 80% para código crítico │
│ • Actual: 78% ▲ │
│ │
│ DEUDA TÉCNICA: │
│ • Carga de mantenimiento acumulada │
│ • Medido en días/horas de trabajo │
│ • Actual: 15 días │ Tendencia: ▼ mejorando │
│ │
│ COMPLEJIDAD DE CÓDIGO: │
│ • Complejidad ciclomática │
│ • Índice de mantenibilidad │
│ • Archivos con complejidad alta: 12 │
│ │
│ DENSIDAD DE DEFECTOS: │
│ • Bugs por líneas de código │
│ • Actual: 0.5 bugs/1000 LOC │
│ • Objetivo: < 1 bug/1000 LOC ✅ │
│ │
└─────────────────────────────────────────────────────────────┘
Estándares de Código
Definiendo Estándares
ESTRUCTURA DE ESTÁNDARES DE CÓDIGO:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ESTILO Y FORMATO: │
│ ├── Usar ESLint/Prettier con configuración estándar │
│ ├── Indentación: 2 espacios │
│ ├── Longitud máxima de línea: 100 caracteres │
│ └── Nombres: camelCase para variables, PascalCase clases │
│ │
│ ARQUITECTURA: │
│ ├── Patrones de diseño aprobados │
│ ├── Estructura de carpetas estándar │
│ ├── Separación de responsabilidades │
│ └── Límites de dependencias │
│ │
│ TESTING: │
│ ├── Tests unitarios para lógica de negocio │
│ ├── Tests de integración para APIs │
│ ├── Coverage mínimo: 80% │
│ └── Tests E2E para flujos críticos │
│ │
│ DOCUMENTACIÓN: │
│ ├── JSDoc para funciones públicas │
│ ├── README actualizado │
│ ├── Comentarios para lógica compleja │
│ └── Changelog mantenido │
│ │
└─────────────────────────────────────────────────────────────┘
Quality Gates
Implementación de Gates
QUALITY GATES EN CI/CD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ GATE 1: PR/MERGE REQUEST │
│ ├── ✓ Lint pasa sin errores │
│ ├── ✓ Tests unitarios pasan │
│ ├── ✓ Coverage > 80% │
│ ├── ✓ Sin vulnerabilidades críticas │
│ └── ✓ Code review aprobado │
│ │
│ GATE 2: BUILD │
│ ├── ✓ Compilación exitosa │
│ ├── ✓ Tests de integración pasan │
│ ├── ✓ Análisis estático pasa │
│ └── ✓ Artefacto generado │
│ │
│ GATE 3: DEPLOY STAGING │
│ ├── ✓ Deploy exitoso │
│ ├── ✓ Smoke tests pasan │
│ ├── ✓ Tests E2E pasan │
│ └── ✓ Performance dentro de límites │
│ │
│ GATE 4: DEPLOY PRODUCCIÓN │
│ ├── ✓ Staging validado │
│ ├── ✓ Aprobación manual (si requerida) │
│ └── ✓ Ventana de deployment apropiada │
│ │
└─────────────────────────────────────────────────────────────┘
Monitoreo de Cumplimiento
Dashboard de Gobernanza
DASHBOARD DE CUMPLIMIENTO:
┌─────────────────────────────────────────────────────────────┐
│ │
│ CUMPLIMIENTO DE ESTÁNDARES - ENERO 2024 │
│ ═══════════════════════════════════════ │
│ │
│ PROYECTO │ LINT │ COVERAGE │ SEGURIDAD │ DOCS │ OVERALL │
│ ────────────┼──────┼──────────┼───────────┼──────┼─────────│
│ Frontend │ 98% │ 85% │ 100% │ 75% │ 🟢 90% │
│ Backend │ 95% │ 82% │ 98% │ 80% │ 🟢 89% │
│ Mobile │ 92% │ 70% │ 100% │ 60% │ 🟡 80% │
│ Legacy API │ 78% │ 45% │ 85% │ 40% │ 🔴 62% │
│ ────────────┼──────┼──────────┼───────────┼──────┼─────────│
│ PROMEDIO │ 91% │ 71% │ 96% │ 64% │ 🟡 80% │
│ │
│ TENDENCIAS: │
│ ├── Coverage: ▲ +5% vs mes anterior │
│ ├── Deuda técnica: ▼ -12% reducida │
│ └── Issues de seguridad: → estable │
│ │
│ ACCIONES REQUERIDAS: │
│ ⚠️ Legacy API: Plan de mejora necesario │
│ ⚠️ Mobile: Aumentar coverage a 80% │
│ ⚠️ Todos: Mejorar documentación │
│ │
└─────────────────────────────────────────────────────────────┘
Mejora Continua
Proceso de Revisión
CICLO DE MEJORA DE CALIDAD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ SEMANAL: │
│ • Revisar métricas de calidad │
│ • Identificar regresiones │
│ • Abordar issues críticos │
│ │
│ MENSUAL: │
│ • Revisión de cumplimiento de estándares │
│ • Análisis de tendencias │
│ • Actualizar prioridades de deuda técnica │
│ │
│ TRIMESTRAL: │
│ • Auditoría de gobernanza completa │
│ • Revisar y actualizar estándares │
│ • Planificar mejoras mayores │
│ • Capacitación del equipo │
│ │
│ ANUAL: │
│ • Evaluación del framework de gobernanza │
│ • Benchmarking con industria │
│ • Actualización de herramientas │
│ • Roadmap de calidad │
│ │
└─────────────────────────────────────────────────────────────┘
Integración con GitScrum
Seguimiento en GitScrum
GITSCRUM PARA GOBERNANZA DE CALIDAD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ TABLERO DE DEUDA TÉCNICA: │
│ ├── Columnas: Por Hacer, En Progreso, Completado │
│ ├── Items etiquetados por prioridad │
│ ├── Tracking de esfuerzo │
│ └── Vinculado a métricas │
│ │
│ AUTOMATIZACIONES: │
│ ├── Crear issue cuando coverage baja │
│ ├── Alertar cuando deuda aumenta │
│ ├── Reporte semanal de métricas │
│ └── Notificar violaciones de estándares │
│ │
│ DASHBOARD EJECUTIVO: │
│ ├── Resumen de salud de código │
│ ├── Tendencias de calidad │
│ ├── Estado de cumplimiento │
│ └── Acciones pendientes │
│ │
└─────────────────────────────────────────────────────────────┘