Commit 4c8f2e7
committed
docs(ci-cd): agregar indice completo de workflows CI/CD y proceso SDLC
Documentacion completa del sistema CI/CD y SDLC del proyecto IACT.
ARCHIVOS CREADOS:
1. docs/gobernanza/ci_cd/INDICE.md
- Indice general de toda la documentacion CI/CD
- Quick start para Developer, QA, DevOps
- Estructura completa de archivos
- Metricas y KPIs
2. docs/gobernanza/ci_cd/GUIA_USO.md (104 KB)
- Guias especificas por rol:
* Developer: Workflow diario, pre-push checklist, comandos utiles
* QA: Testing workflow, test pyramid validation, tipos de testing
* DevOps: Deployment workflow, incident response, monitoring
* Tech Lead: Code review, architecture review, metricas
- Checklists ejecutables para cada rol
- Comandos utiles y scripts
3. docs/gobernanza/ci_cd/TROUBLESHOOTING.md (90 KB)
- Problemas comunes y soluciones:
* Tests fallando (coverage, pyramid, local vs CI)
* Lint errors (flake8, isort)
* Security issues (RNF-002, SQL injection, npm vulnerabilities)
* Deployment issues (health check, database connection, rollback)
* Performance issues (slow response, memory, N+1 queries)
* Workflow failures (timeout, artifacts)
* Migration conflicts
- Debugging general y escalation paths
4. docs/gobernanza/ci_cd/EJEMPLOS.md (85 KB)
- Flujos completos end-to-end:
* Feature completo (Dark Mode): Planning → Production (2 dias)
* Bugfix critico: Incident detection → Resolution (12 min MTTR)
* Database migration risky: Multi-step approach (1 semana)
* Security vulnerability fix: Detection → Production (4 horas)
* Performance optimization: Problem → Fix → Deploy
* Test pyramid violation fix: Detection → Refactor
- Checklist general para cada fase
5. docs/gobernanza/procesos/INDICE_WORKFLOWS.md (ACTUALIZADO)
- Seccion nueva: "ACTUALIZACION 2025-11-06 (Segunda Sesion)"
- Estado de 8 workflows implementados
- Estado de 4 scripts shell locales
- Estado de 5 agentes SDLC
- Documentacion CI/CD completa
ESTRUCTURA FINAL docs/gobernanza/ci_cd/:
- README.md (vista general)
- INDICE.md (indice completo)
- GUIA_USO.md (guias por rol)
- TROUBLESHOOTING.md (problemas y soluciones)
- EJEMPLOS.md (flujos end-to-end)
- workflows/ (para docs detallada de cada workflow)
- scripts/ (para docs detallada de cada script)
BENEFICIOS:
- Developer sabe exactamente que hacer cada dia
- QA tiene checklist completo de validaciones
- DevOps tiene playbooks para deployment e incidents
- Tech Lead tiene metricas y KPIs para tracking
- Troubleshooting rapido con soluciones documentadas
- Ejemplos reales de flujos completos
REFERENCIAS:
- SDLC Process: docs/gobernanza/procesos/SDLC_PROCESS.md
- DevOps Automation: docs/gobernanza/procesos/DEVOPS_AUTOMATION.md
- Agentes SDLC: docs/gobernanza/procesos/AGENTES_SDLC.md
- Scripts CI: scripts/ci/
- Workflows: .github/workflows/1 parent 220db70 commit 4c8f2e7
5 files changed
Lines changed: 1919 additions & 2 deletions
File tree
- docs/gobernanza
- ci_cd
- procesos
0 commit comments