Skip to content

Commit 2700591

Browse files
committed
docs(migration): migrar contenido completo de docs_legacy a nueva estructura
Migracion completa de docs_legacy/ a nueva estructura organizacional: FASE 1 - Fundamentos: - Migrar GUIA_ESTILO.md (786 lines) a docs/gobernanza/estilos/ - Migrar 5 checklists a docs/gobernanza/procesos/checklists/ - Migrar estrategia_qa.md a docs/gobernanza/procesos/qa/ FASE 2 - Operaciones: - Migrar 6 runbooks DevOps a docs/implementacion/infrastructure/runbooks/ - Migrar 12 templates prioritarios a docs/plantillas/ FASE 3 - Framework BA: - Migrar 8 documentos marco_integrado (7,419 lines) a docs/requisitos/analisis_negocio/marco_integrado/ FASE 4 - Agentes: - Migrar 4 docs desarrollo a docs/implementacion/agentes/legacy/ - Migrar 2 docs gobernanza/agentes a docs/gobernanza/procesos/agentes/ FASE 5 - Archivos root: - Migrar 8 archivos root de gobernanza - Migrar 3 archivos root de devops - Migrar 3 archivos root de qa - Migrar 2 archivos vision_y_alcance Transformaciones: - Crear script clean_emojis.sh para remover emojis - Ejecutar limpieza en 9 archivos (verificar_servicios.md, README.md, etc) - Convertir emojis a ASCII: checkmark -> [OK], X -> [FAIL], warning -> [WARNING] Total migrado: 56 archivos, 15,000+ lines Estructura nueva: docs/gobernanza/, docs/requisitos/, docs/implementacion/, docs/plantillas/, docs/vision_y_alcance/
1 parent 4c8f2e7 commit 2700591

56 files changed

Lines changed: 24827 additions & 341 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/gobernanza/README.md

Lines changed: 83 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,99 @@
11
---
2-
id: DOC-GOBERNANZA
2+
id: DOC-GOB-INDEX
33
estado: activo
44
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"]
67
---
78
# Gobernanza del Proyecto IACT
89

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.
1011

11-
## Estructura
12+
## Página padre
13+
- [Índice de espacios documentales](../index.md)
1214

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
1616

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)
1822

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)
2127

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)
2432

25-
### Guias de Estilo
26-
- [Guia de Estilo](GUIA_ESTILO.md)
33+
## Información clave
2734

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
2940

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
3247

33-
## Referencias
48+
Ver detalles completos en: [Estándares de Código](estandares_codigo.md)
3449

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

Comments
 (0)