# TRAZA DE DOCUMENTACION DEPRECADA/MOVIDA **Proyecto:** GAMILIT **Fecha de creacion:** 2025-12-18 **Proposito:** Registro de archivos movidos de docs/ a orchestration/reportes/ y mapeo de ubicaciones anteriores vs nuevas --- ## PROPOSITO Este archivo sirve como **registro de trazabilidad** para: 1. Localizar documentacion historica que fue movida 2. Actualizar referencias antiguas que apunten a ubicaciones obsoletas 3. Entender la progresion de cambios del proyecto --- ## PRINCIPIO RECTOR > "La documentacion definitiva (docs/) debe contener SOLO el estado actual del sistema." > "Los historicos de cambios y correcciones deben existir en orchestration/reportes/" --- ## MAPEO DE ARCHIVOS MOVIDOS ### Categoria 1: Archivos Historicos 2025-11 | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/archivos-historicos/2025-11/VALIDACION-INTEGRACION-COMPLETA-2025-11-26.md` | `orchestration/reportes/historicos/2025-11/VALIDACION-INTEGRACION-COMPLETA-2025-11-26.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/CORRECCIONES-CRITICAS-2025-11-24.md` | `orchestration/reportes/historicos/2025-11/CORRECCIONES-CRITICAS-2025-11-24.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/BUG-FIX-ADMIN-ENDPOINTS-2025-11-24.md` | `orchestration/reportes/historicos/2025-11/BUG-FIX-ADMIN-ENDPOINTS-2025-11-24.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/BUG-FIX-TEACHER-PORTAL-TESTING-2025-11-24.md` | `orchestration/reportes/historicos/2025-11/BUG-FIX-TEACHER-PORTAL-TESTING-2025-11-24.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/DESARROLLO-TEACHER-PORTAL-COMPLETO-2025-11-24.md` | `orchestration/reportes/historicos/2025-11/DESARROLLO-TEACHER-PORTAL-COMPLETO-2025-11-24.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/IMPLEMENTACION-RANKUP-EJERCICIOS-2025-11-26.md` | `orchestration/reportes/historicos/2025-11/IMPLEMENTACION-RANKUP-EJERCICIOS-2025-11-26.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/INTEGRACION-STUDENT-TEACHER-PORTAL-2025-11-24.md` | `orchestration/reportes/historicos/2025-11/INTEGRACION-STUDENT-TEACHER-PORTAL-2025-11-24.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | `orchestration/reportes/historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/REPORTE-FINAL-LIMPIEZA-DOCUMENTACION-2025-11-29.md` | `orchestration/reportes/historicos/2025-11/REPORTE-FINAL-LIMPIEZA-DOCUMENTACION-2025-11-29.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/PROGRESO-LIMPIEZA-DOCUMENTACION-2025-11-28.md` | `orchestration/reportes/historicos/2025-11/PROGRESO-LIMPIEZA-DOCUMENTACION-2025-11-28.md` | 2025-12-18 | | `docs/90-transversal/archivos-historicos/2025-11/*` | `orchestration/reportes/historicos/2025-11/*` | 2025-12-18 | ### Categoria 2: Correcciones | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/correcciones/CORRECCIONES-BUILD-AUTH-2025-11-25.md` | `orchestration/reportes/correcciones/CORRECCIONES-BUILD-AUTH-2025-11-25.md` | 2025-12-18 | | `docs/90-transversal/correcciones/CORRECCION-GAMIFICACION-RANGOS-2025-11-29.md` | `orchestration/reportes/correcciones/CORRECCION-GAMIFICACION-RANGOS-2025-11-29.md` | 2025-12-18 | | `docs/90-transversal/correcciones/CORRECCION-EJERCICIOS-MODULO3-REQUIRES-MANUAL-GRADING-2025-11-29.md` | `orchestration/reportes/correcciones/CORRECCION-EJERCICIOS-MODULO3-REQUIRES-MANUAL-GRADING-2025-11-29.md` | 2025-12-18 | | `docs/90-transversal/correcciones/REPORTE-VALIDACION-DOCS-FE-059-2025-11-19.md` | `orchestration/reportes/correcciones/REPORTE-VALIDACION-DOCS-FE-059-2025-11-19.md` | 2025-12-18 | | `docs/90-transversal/correcciones/ANALISIS-FORMATOS-DTO-FE-059.md` | `orchestration/reportes/correcciones/ANALISIS-FORMATOS-DTO-FE-059.md` | 2025-12-18 | **NOTA:** `docs/90-transversal/correcciones/ISSUES-CRITICOS.md` NO se mueve - es backlog vigente. ### Categoria 3: Reportes de Implementacion Backend | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/reportes-implementacion/backend/BUG-FIX-*.md` | `orchestration/reportes/implementacion/backend/BUG-FIX-*.md` | 2025-12-18 | | `docs/90-transversal/reportes-implementacion/backend/IMPLEMENTATION-REPORT-*.md` | `orchestration/reportes/implementacion/backend/IMPLEMENTATION-REPORT-*.md` | 2025-12-18 | | `docs/90-transversal/reportes-implementacion/backend/FRONTEND-INTEGRATION-*.md` | `orchestration/reportes/implementacion/backend/FRONTEND-INTEGRATION-*.md` | 2025-12-18 | ### Categoria 4: Reportes de Implementacion Frontend | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/reportes-implementacion/frontend/TYPESCRIPT-FIXES-*.md` | `orchestration/reportes/implementacion/frontend/TYPESCRIPT-FIXES-*.md` | 2025-12-18 | | `docs/90-transversal/reportes-implementacion/frontend/IMPLEMENTATION-REPORT-*.md` | `orchestration/reportes/implementacion/frontend/IMPLEMENTATION-REPORT-*.md` | 2025-12-18 | ### Categoria 5: Gaps Cerrados | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/gaps/GAP-009-SWAGGER-DOCUMENTATION-ANALYSIS.md` | `orchestration/reportes/gaps/GAP-009-SWAGGER-DOCUMENTATION-ANALYSIS.md` | 2025-12-18 | | `docs/90-transversal/gaps/GAP-010-E2E-CONTRACT-TESTING-ANALYSIS.md` | `orchestration/reportes/gaps/GAP-010-E2E-CONTRACT-TESTING-ANALYSIS.md` | 2025-12-18 | | `docs/90-transversal/gaps/GAP-011-*.md` | `orchestration/reportes/gaps/GAP-011-*.md` | 2025-12-18 | | `docs/90-transversal/gaps/RESUMEN-DOCUMENTACION-GAP-003.md` | `orchestration/reportes/gaps/RESUMEN-DOCUMENTACION-GAP-003.md` | 2025-12-18 | ### Categoria 6: Database Changelog | Ubicacion Anterior | Nueva Ubicacion | Fecha Movimiento | |-------------------|-----------------|------------------| | `docs/90-transversal/arquitectura-database/DATABASE-CHANGELOG.md` | `orchestration/reportes/database/DATABASE-CHANGELOG-2025.md` | 2025-12-18 | --- ## REFERENCIAS QUE DEBEN ACTUALIZARSE ### Referencias Activas (documentos vigentes que apuntan a archivos movidos) | Documento Fuente | Referencia Antigua | Nueva Referencia | Estado | |-----------------|-------------------|------------------|--------| | `docs/95-guias-desarrollo/INTEGRACION-STUDENT-TEACHER.md:534` | `docs/90-transversal/archivos-historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | `orchestration/reportes/historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | PENDIENTE | | `docs/95-guias-desarrollo/INTEGRACION-STUDENT-TEACHER.md:727` | `../90-transversal/archivos-historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | `../../orchestration/reportes/historicos/2025-11/DIAGRAMA-FLUJO-SUBMISSIONS-2025-11-19.md` | PENDIENTE | | `docs/01-fase-alcance-inicial/EAI-003-gamificacion/especificaciones/ET-GAM-003-rangos-maya.md:2311` | `docs/90-transversal/correcciones/CORRECCION-GAMIFICACION-RANGOS-2025-11-29.md` | `orchestration/reportes/correcciones/CORRECCION-GAMIFICACION-RANGOS-2025-11-29.md` | PENDIENTE | ### Referencias Internas (se mueven junto con el archivo) Estas referencias estan dentro de archivos que se mueven, por lo que se ajustaran automaticamente: - Referencias dentro de `docs/90-transversal/correcciones/*.md` a otros archivos en la misma carpeta - Referencias dentro de `docs/90-transversal/archivos-historicos/2025-11/*.md` a otros archivos en la misma carpeta --- ## ARCHIVOS QUE PERMANECEN EN DOCS/ (NO DEPRECADOS) | Archivo | Ubicacion | Razon | |---------|-----------|-------| | `ISSUES-CRITICOS.md` | `docs/90-transversal/correcciones/` | Es backlog vigente, no historico | | `FEATURES-IMPLEMENTADAS.md` | `docs/90-transversal/features/` | Estado actual del sistema | | `FLUJO-INICIALIZACION-USUARIO.md` | `docs/90-transversal/arquitectura/` | Arquitectura vigente | | `STORAGE-SYSTEM.md` | `docs/90-transversal/arquitectura/` | Arquitectura vigente | | `README.md` | `docs/90-transversal/` | Indice de la carpeta | | `_MAP.md` | `docs/90-transversal/` | Mapa de navegacion | --- ## COMO USAR ESTA TRAZA ### Para encontrar un archivo movido: 1. Busca el nombre del archivo en la tabla de mapeo 2. La columna "Nueva Ubicacion" indica donde se encuentra ahora 3. Usa la fecha de movimiento para contexto temporal ### Para actualizar una referencia rota: 1. Identifica el archivo fuente con la referencia rota 2. Busca la referencia en la seccion "Referencias que deben actualizarse" 3. Actualiza con la "Nueva Referencia" indicada ### Para buscar historicos de un tema: 1. Navega a `orchestration/reportes/` 2. Usa las subcarpetas por categoria: - `historicos/` - Reportes generales por fecha - `correcciones/` - Bugs y fixes aplicados - `implementacion/` - Reportes de desarrollo - `gaps/` - Analisis de gaps cerrados - `database/` - Changelogs de BD --- ## HISTORIAL DE ACTUALIZACIONES | Fecha | Descripcion | Archivos Afectados | |-------|-------------|-------------------| | 2025-12-18 | Migracion inicial de archivos historicos | ~73 archivos | --- **Generado por:** Requirements-Analyst **Fecha:** 2025-12-18 **Version:** 1.0