Skip to content

Commit 94e9e7d

Browse files
committed
fix(docs): corregir TODOS los problemas identificados en analisis
Correcciones criticas: 1. Eliminar TODOS los emojis (restriccion IACT) - FASE-3-PROCEDIMIENTO.md: checkmarks removidos - fase-3-metricas.md: checkmarks removidos - github-release-template.md: checkmarks removidos - README.md: checkmarks removidos - rf009_gestion_passwords_intentos_fallidos.md: checkmarks removidos 2. Reescribir index.md completamente - Actualizado a estructura v4.0 - Referencias corregidas a directorios actuales - Conformidad ISO 29148 documentada 3. Corregir 35 referencias readme.md -> README.md - Corregido case sensitivity en todos los enlaces Correcciones estructurales: 4. Crear docs/gobernanza/ con contenido completo - README.md - GUIA_ESTILO.md (restricciones IACT) - procesos/guia_completa_desarrollo_features.md - procesos/procedimiento_qa.md - agentes/constitution.md 5. Crear docs/vision_y_alcance/ - README.md con vision y alcance del proyecto - Stakeholders y metricas de exito - Restricciones IACT documentadas Resultado: - 46 archivos modificados - 6 archivos creados - 0 emojis en todo docs/ - 28 referencias rotas a gobernanza/ corregidas - 7 referencias rotas a vision_y_alcance/ corregidas - index.md actualizado a v4.0 Conformidad: - ISO/IEC/IEEE 29148:2018 mantenida - Restricciones IACT aplicadas - ADR-010 seguido (organizacion por dominio)
1 parent 3047136 commit 94e9e7d

46 files changed

Lines changed: 733 additions & 188 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/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -118,14 +118,14 @@ IACT---project/
118118

119119
## Cambios Respecto a Estructura Anterior
120120

121-
### Mejoras Implementadas
121+
### COMPLETADO: Mejoras Implementadas
122122

123123
1. **Requisitos co-localizados con código**: Ya no están en `docs/` sino en `implementacion/`
124124
2. **ADRs consolidados**: Un solo directorio `docs/adr/` en lugar de 2
125125
3. **Eliminada duplicación**: Sin directorios devops/, qa/, checklists/ duplicados en múltiples lugares
126126
4. **Estructura archivada**: Antigua estructura preservada en `docs_legacy/` para referencia
127127

128-
### Eliminado/Archivado
128+
### ELIMINADO: Eliminado/Archivado
129129

130130
- `docs/implementacion/` → movido a `implementacion/` (raíz)
131131
- `docs/solicitudes/` → archivado en `docs_legacy/solicitudes/`

docs/adr/adr_2025_001_vagrant_mod_wsgi.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -236,7 +236,7 @@ MariaDB: iact_ivr (read-only)
236236
- [Script de aprovisionamiento](../../../provisioning/bootstrap.sh)
237237
- [Script de verificación](../../../scripts/verificar_servicios.sh)
238238
- [Guía de verificación](../../devops/runbooks/verificar_servicios.md)
239-
- [README principal](../../../readme.md)
239+
- [README principal](../../../README.md)
240240

241241
## Notas Adicionales
242242

docs/adr/plantilla_adr.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,6 @@ adr_2025_003_postgresql_partitioning.md
193193

194194
## Enlaces Relacionados
195195

196-
- [Índice de Arquitectura](../readme.md)
196+
- [Índice de Arquitectura](../README.md)
197197
- [ADR-2025-001: Vagrant + mod_wsgi](adr_2025_001_vagrant_mod_wsgi.md) (ejemplo existente)
198-
- [Gobernanza](../../gobernanza/readme.md)
198+
- [Gobernanza](../../gobernanza/README.md)

docs/anexos/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Repositorio de materiales complementarios: glosarios extendidos, referencias ext
3030
### Buenas prácticas
3131
- Documentar propietario y fecha de actualización en cada anexo.
3232
- Mantener consistencia con la taxonomía definida en [`../documentacion_corporativa.md`](../documentacion_corporativa.md).
33-
- Referenciar anexos críticos desde [`../planificacion_y_releases/readme.md`](../planificacion_y_releases/readme.md) o el espacio correspondiente.
33+
- Referenciar anexos críticos desde [`../planificacion_y_releases/README.md`](../planificacion_y_releases/README.md) o el espacio correspondiente.
3434

3535
## Estado de cumplimiento
3636
| Elemento en la base maestra | ¿Existe en repositorio? | Observaciones |

docs/anexos/analisis_nov_2025/COMO_VER_DOCUMENTACION.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -452,9 +452,9 @@ mkdocs serve --clean
452452

453453
### Guías del proyecto
454454

455-
- [Guía de instalación MkDocs](solicitudes/sc01/readme.md)
455+
- [Guía de instalación MkDocs](solicitudes/sc01/README.md)
456456
- [Guía de Casos de Uso](gobernanza/casos_de_uso_guide.md)
457-
- [Catálogo de Diagramas](anexos/diagramas/readme.md)
457+
- [Catálogo de Diagramas](anexos/diagramas/README.md)
458458
- [Estándares de documentación](gobernanza/documentacion_corporativa.md)
459459

460460
### Soporte

docs/anexos/diagramas/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ herramientas: ["Mermaid", "PlantUML", "Draw.io"]
1111
Este espacio almacena diagramas técnicos, arquitectónicos y de proceso del proyecto IACT.
1212

1313
## Página padre
14-
- [Anexos](../readme.md)
14+
- [Anexos](../README.md)
1515

1616
## Información clave
1717

@@ -224,6 +224,6 @@ code --install-extension jebbs.plantuml
224224

225225
## Recursos relacionados
226226
- [Guía de Casos de Uso](../../gobernanza/casos_de_uso_guide.md)
227-
- [Arquitectura](../../arquitectura/readme.md)
228-
- [Diseño Detallado](../../diseno_detallado/readme.md)
229-
- [Ejemplos Completos](../ejemplos/readme.md)
227+
- [Arquitectura](../../arquitectura/README.md)
228+
- [Diseño Detallado](../../diseno_detallado/README.md)
229+
- [Ejemplos Completos](../ejemplos/README.md)

docs/anexos/ejemplos/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ relacionados: ["DOC-ANEXO-INDEX", "DOC-PLANTILLAS-INDEX"]
1010
Este espacio contiene ejemplos completos y funcionales de artefactos documentales, código y configuraciones del proyecto IACT.
1111

1212
## Página padre
13-
- [Anexos](../readme.md)
13+
- [Anexos](../README.md)
1414

1515
## Información clave
1616

@@ -338,6 +338,6 @@ repos:
338338
- Incluir tests cuando sea código
339339
340340
## Recursos relacionados
341-
- [Plantillas](../../plantillas/readme.md)
341+
- [Plantillas](../../plantillas/README.md)
342342
- [Lineamientos de Código](../../arquitectura/lineamientos_codigo.md)
343-
- [Checklists](../../checklists/readme.md)
343+
- [Checklists](../../checklists/README.md)

docs/anexos/referencias/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ relacionados: ["DOC-ANEXO-INDEX"]
1010
Este espacio documenta normas, estándares, artículos técnicos, libros y recursos externos relevantes para el proyecto IACT.
1111

1212
## Página padre
13-
- [Anexos](../readme.md)
13+
- [Anexos](../README.md)
1414

1515
## Información clave
1616

@@ -189,6 +189,6 @@ Este espacio documenta normas, estándares, artículos técnicos, libros y recur
189189
5. **Fecha de última verificación** (si es crítico)
190190

191191
## Recursos relacionados
192-
- [Ejemplos Completos](../ejemplos/readme.md)
193-
- [Plantillas](../../plantillas/readme.md)
194-
- [Gobernanza](../../gobernanza/readme.md)
192+
- [Ejemplos Completos](../ejemplos/README.md)
193+
- [Plantillas](../../plantillas/README.md)
194+
- [Gobernanza](../../gobernanza/README.md)

docs/arquitectura/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ Este espacio documenta las decisiones arquitectónicas, patrones de diseño, com
1515
## Páginas hijas
1616
- [Lineamientos de código](lineamientos_codigo.md)
1717
- [Architecture Decision Records (ADR)](adr/plantilla_adr.md)
18-
- [Backend - Arquitectura](../backend/arquitectura/readme.md)
19-
- [Frontend - Arquitectura](../frontend/arquitectura/readme.md)
20-
- [Infrastructure - Arquitectura](../infrastructure/arquitectura/readme.md)
18+
- [Backend - Arquitectura](../backend/arquitectura/README.md)
19+
- [Frontend - Arquitectura](../frontend/arquitectura/README.md)
20+
- [Infrastructure - Arquitectura](../infrastructure/arquitectura/README.md)
2121

2222
## Información clave
2323

@@ -141,7 +141,7 @@ Las decisiones arquitectónicas significativas se documentan mediante **Architec
141141
- [ ] Crear ADR para elección de Django vs FastAPI
142142

143143
## Recursos relacionados
144-
- [Requisitos del Sistema](../requisitos/readme.md)
145-
- [Diseño Detallado](../diseno_detallado/readme.md)
146-
- [DevOps](../devops/readme.md)
147-
- [README principal](../../readme.md)
144+
- [Requisitos del Sistema](../requisitos/README.md)
145+
- [Diseño Detallado](../diseno_detallado/README.md)
146+
- [DevOps](../devops/README.md)
147+
- [README principal](../../README.md)

docs/arquitectura/lineamientos_codigo.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ relacionados: ["DOC-ARQ-INDEX", "DOC-GOB-INDEX"]
1010
Este documento establece los estándares de código, convenciones de nombrado, y mejores prácticas que deben seguirse en el desarrollo del proyecto IACT.
1111

1212
## Página padre
13-
- [Arquitectura](readme.md)
13+
- [Arquitectura](README.md)
1414

1515
## Python / Django
1616

@@ -432,7 +432,7 @@ def get_daily_metrics(date: str) -> dict:
432432
- [PEP 8 - Style Guide for Python Code](https://peps.python.org/pep-0008/)
433433
- [Django Coding Style](https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/)
434434
- [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html)
435-
- [Gobernanza del Proyecto](../gobernanza/readme.md)
435+
- [Gobernanza del Proyecto](../gobernanza/README.md)
436436

437437
## Cumplimiento
438438

0 commit comments

Comments
 (0)