|
1 | 1 | --- |
2 | | -id: DOC-GOBERNANZA |
| 2 | +id: DOC-GOB-INDEX |
3 | 3 | estado: activo |
4 | 4 | propietario: equipo-gobernanza |
5 | | -ultima_actualizacion: 2025-11-06 |
| 5 | +ultima_actualizacion: 2025-11-02 |
| 6 | +relacionados: ["DOC-INDEX-GENERAL", "DOC-REQ-INDEX", "DOC-ARQ-INDEX"] |
6 | 7 | --- |
7 | 8 | # Gobernanza del Proyecto IACT |
8 | 9 |
|
9 | | -Politicas, procesos y lineamientos para el desarrollo del proyecto IACT. |
| 10 | +Este espacio documenta las políticas, estándares, procesos de revisión y control de cambios que rigen el desarrollo del proyecto IACT. |
10 | 11 |
|
11 | | -## Estructura |
| 12 | +## Página padre |
| 13 | +- [Índice de espacios documentales](../index.md) |
12 | 14 |
|
13 | | -- [Procesos](procesos/) - Procedimientos de desarrollo y gestion |
14 | | -- [Agentes](agentes/) - Configuracion de agentes IA |
15 | | -- [Politicas](politicas/) - Politicas de desarrollo y calidad |
| 15 | +## Páginas hijas |
16 | 16 |
|
17 | | -## Procesos Clave |
| 17 | +### Procesos Operativos |
| 18 | +- [Procesos de Gobernanza](procesos/readme.md) NUEVO |
| 19 | + - [Procedimiento: Diseño Técnico](procesos/procedimiento_diseno_tecnico.md) |
| 20 | + - [Procedimiento: Análisis de Seguridad](procesos/procedimiento_analisis_seguridad.md) |
| 21 | + - [Procedimiento: Trazabilidad de Requisitos](procesos/procedimiento_trazabilidad_requisitos.md) |
18 | 22 |
|
19 | | -### Desarrollo de Features |
20 | | -- [Guia Completa de Desarrollo Features](procesos/guia_completa_desarrollo_features.md) |
| 23 | +### Guías y Estándares |
| 24 | +- [Estándares de Código](estandares_codigo.md) |
| 25 | +- [Guía de Casos de Uso](casos_de_uso_guide.md) |
| 26 | +- [Guía de Shell Scripting](shell_scripting_guide.md) |
21 | 27 |
|
22 | | -### Control de Calidad |
23 | | -- [Procedimiento QA](procesos/procedimiento_qa.md) |
| 28 | +### Gobernanza por Dominio |
| 29 | +- [Backend - Gobernanza](../backend/gobernanza/readme.md) |
| 30 | +- [Frontend - Gobernanza](../frontend/gobernanza/readme.md) |
| 31 | +- [Infrastructure - Gobernanza](../infrastructure/gobernanza/readme.md) |
24 | 32 |
|
25 | | -### Guias de Estilo |
26 | | -- [Guia de Estilo](GUIA_ESTILO.md) |
| 33 | +## Información clave |
27 | 34 |
|
28 | | -## Agentes IA |
| 35 | +### Políticas de Desarrollo |
| 36 | +- **Test-Driven Development (TDD)**: Implementación obligatoria para nuevas funcionalidades |
| 37 | +- **Cobertura mínima**: 80% en todas las capas |
| 38 | +- **Revisión de código**: Obligatoria antes de merge a develop/main |
| 39 | +- **Conventional Commits**: Estándar para mensajes de commit |
29 | 40 |
|
30 | | -### Constitution |
31 | | -- [Constitution para Agentes](agentes/constitution.md) |
| 41 | +### Estándares de Calidad |
| 42 | +- Análisis estático de código mediante linters |
| 43 | +- **Output profesional**: Prohibido uso de emojis en scripts de producción |
| 44 | +- Revisión de seguridad en dependencias |
| 45 | +- Documentación obligatoria para APIs públicas |
| 46 | +- Pruebas de integración para flujos críticos |
32 | 47 |
|
33 | | -## Referencias |
| 48 | +Ver detalles completos en: [Estándares de Código](estandares_codigo.md) |
34 | 49 |
|
35 | | -- ISO/IEC/IEEE 29148:2018 - Requirements Engineering |
36 | | -- BABOK v3 - Business Analysis |
37 | | -- PMBOK 7th Ed - Project Management |
| 50 | +### Proceso de Control de Cambios |
| 51 | +1. Crear issue describiendo el cambio propuesto |
| 52 | +2. Crear rama `feature/` desde develop |
| 53 | +3. Implementar cambios siguiendo TDD |
| 54 | +4. Crear Pull Request con descripción detallada |
| 55 | +5. Pasar revisión de código y tests automatizados |
| 56 | +6. Merge solo después de aprobación |
| 57 | + |
| 58 | +### Arquitectura de Ramas |
| 59 | +- `main/master`: Código en producción |
| 60 | +- `develop`: Integración continua |
| 61 | +- `feature/*`: Nuevas funcionalidades |
| 62 | +- `hotfix/*`: Correcciones urgentes |
| 63 | +- `bugfix/*`: Corrección de bugs |
| 64 | +- `docs/*`: Cambios exclusivos de documentación |
| 65 | + |
| 66 | +## Estado de cumplimiento |
| 67 | + |
| 68 | +| Elemento | Estado | Observaciones | |
| 69 | +|----------|--------|---------------| |
| 70 | +| Políticas documentadas | OK Sí | Documentado en este archivo | |
| 71 | +| Estándares de código establecidos | OK Sí | Ver `estandares_codigo.md` | |
| 72 | +| Proceso de revisión definido | OK Sí | Requiere PR review antes de merge | |
| 73 | +| Procedimientos operativos | OK Sí | 3 procedimientos core creados (2025-11-04) | |
| 74 | +| Trazabilidad ISO 29148 | 🔶 Parcial | Procedimiento creado, pendiente workflows CI/CD | |
| 75 | +| Métricas de calidad activas | WARNING Parcial | Falta dashboard de métricas | |
| 76 | + |
| 77 | +## Acciones prioritarias |
| 78 | + |
| 79 | +### Corto Plazo (1-2 semanas) |
| 80 | +- [ ] Implementar workflows CI/CD para trazabilidad ISO 29148 |
| 81 | +- [ ] Capacitar equipos en procedimientos operativos (4h sesión) |
| 82 | +- [ ] Aplicar PROC-DISENO-TEC-001 a 3 componentes (piloto) |
| 83 | + |
| 84 | +### Mediano Plazo (1-2 meses) |
| 85 | +- [ ] Implementar dashboard de métricas de calidad |
| 86 | +- [ ] Establecer SLAs para revisión de PRs |
| 87 | +- [ ] Auditar cumplimiento de frontmatter YAML en requisitos |
| 88 | +- [ ] Validar generación de índices ISO 29148 end-to-end |
| 89 | + |
| 90 | +### Largo Plazo (3-6 meses) |
| 91 | +- [ ] Documentar proceso de releases |
| 92 | +- [ ] Definir proceso de escalamiento para decisiones arquitectónicas |
| 93 | +- [ ] Crear registro de decisiones de gobernanza (GDR - Governance Decision Records) |
| 94 | +- [ ] Certificar conformidad ISO/IEC/IEEE 29148:2018 Full Conformance |
| 95 | + |
| 96 | +## Recursos relacionados |
| 97 | +- [Convenciones de Claude Code](../../.github/claude-code-conventions.md) |
| 98 | +- [Copilot Instructions](../../.github/copilot-instructions.md) |
| 99 | +- [Estrategia de QA](../qa/estrategia_qa.md) |
0 commit comments