erp-core/docs/99-historial/CHANGELOG-REESTRUCTURACION.md

CHANGELOG - Reestructuración de Documentación ERP-CORE

Fecha: 2026-01-10

---

TAREA 1: PURGA DE DOCUMENTACIÓN LEGACY

Resumen

Eliminación del directorio _legacy_backup que contenía duplicados exactos de documentación canónica.

Métricas

Métrica	Antes	Después	Diferencia
Total archivos .md	840	821	-19
Directorios legacy	1	0	-1
Tamaño liberado	-	204 KB	-

Archivos Eliminados (20)

MGN-001 (Auth) - 5 archivos

• _legacy_backup/MGN-001/BACKLOG-MGN001.md
• _legacy_backup/MGN-001/US-MGN001-001.md
• _legacy_backup/MGN-001/US-MGN001-002.md
• _legacy_backup/MGN-001/US-MGN001-003.md
• _legacy_backup/MGN-001/US-MGN001-004.md

MGN-002 (Users) - 5 archivos

• _legacy_backup/MGN-002/BACKLOG-MGN002.md
• _legacy_backup/MGN-002/US-MGN002-001.md
• _legacy_backup/MGN-002/US-MGN002-002.md
• _legacy_backup/MGN-002/US-MGN002-003.md
• _legacy_backup/MGN-002/US-MGN002-004.md

MGN-003 (Roles) - 5 archivos

• _legacy_backup/MGN-003/BACKLOG-MGN003.md
• _legacy_backup/MGN-003/US-MGN003-001.md
• _legacy_backup/MGN-003/US-MGN003-002.md
• _legacy_backup/MGN-003/US-MGN003-003.md
• _legacy_backup/MGN-003/US-MGN003-004.md

MGN-004 (Tenants) - 5 archivos

• _legacy_backup/MGN-004/BACKLOG-MGN004.md
• _legacy_backup/MGN-004/US-MGN004-001.md
• _legacy_backup/MGN-004/US-MGN004-002.md
• _legacy_backup/MGN-004/US-MGN004-003.md
• _legacy_backup/MGN-004/US-MGN004-004.md

Justificación

• 100% duplicación: Todos los archivos eran idénticos byte a byte a sus equivalentes canónicos
• Ubicación canónica: /docs/01-fase-foundation/MGN-00X-*/historias-usuario/
• 0 referencias activas: No existían referencias a estos archivos en ningún documento

Verificación Post-Eliminación

• Directorio _legacy_backup eliminado
• 0 referencias rotas nuevas (solo historial)
• Archivos canónicos accesibles

Estado: COMPLETADO (2026-01-10)

---

TAREA 2: CONSOLIDACIÓN DE BACKLOGS

Resumen

Eliminación de 4 backlogs duplicados en /docs/05-user-stories/mgn-00x/ que eran idénticos a los canónicos en /docs/01-fase-foundation/.

Métricas

Métrica	Antes	Después	Diferencia
Total backlogs	8	4	-4
Ubicaciones	2	1	-1

Archivos Eliminados (4)

• 05-user-stories/mgn-001/BACKLOG-MGN-001.md
• 05-user-stories/mgn-002/BACKLOG-MGN-002.md
• 05-user-stories/mgn-003/BACKLOG-MGN-003.md
• 05-user-stories/mgn-004/BACKLOG-MGN-004.md

Archivos Canónicos Mantenidos (4)

• 01-fase-foundation/MGN-001-auth/historias-usuario/BACKLOG-MGN001.md
• 01-fase-foundation/MGN-002-users/historias-usuario/BACKLOG-MGN002.md
• 01-fase-foundation/MGN-003-roles/historias-usuario/BACKLOG-MGN003.md
• 01-fase-foundation/MGN-004-tenants/historias-usuario/BACKLOG-MGN004.md

Justificación

• 100% duplicación: Contenido idéntico en 891 líneas totales
• 0 referencias activas: Ningún documento referenciaba los duplicados
• Ubicación canónica consolidada: Solo /docs/01-fase-foundation/

Estado: COMPLETADO (2026-01-10)

---

TAREA 3: UNIFICACIÓN DE USER STORIES

Resumen

Eliminación de 42 User Stories duplicadas en Foundation y Core Business, manteniendo /docs/05-user-stories/ como fuente única de verdad (más detallada y completa).

Métricas

Métrica	Antes	Después	Diferencia
Total archivos .md	817	775	-42
US en Foundation	17	0	-17
US en Core Business	25	0	-25
US en 05-user-stories	147	147	0
Ubicaciones de US	3	1	-2

Archivos Eliminados (42)

Foundation (17 archivos)

• MGN-001: US-MGN001-001 a US-MGN001-004 (4)
• MGN-002: US-MGN002-001 a US-MGN002-005 (5)
• MGN-003: US-MGN003-001 a US-MGN003-004 (4)
• MGN-004: US-MGN004-001 a US-MGN004-004 (4)

Core Business (25 archivos)

• MGN-005: US-MGN005-001 a US-MGN005-005 (5)
• MGN-006: US-MGN006-001 a US-MGN006-004 (4)
• MGN-007: US-MGN007-001 a US-MGN007-004 (4)
• MGN-008: US-MGN008-001 a US-MGN008-004 (4)
• MGN-009: US-MGN009-001 a US-MGN009-004 (4)
• MGN-010: US-MGN010-001 a US-MGN010-004 (4)

Ubicación Canónica Consolidada

/docs/05-user-stories/mgn-XXX/US-MGN-XXX-00X-00X-nombre.md

• 147 User Stories consolidadas
• Formato más detallado con:
  • Reglas de Negocio explícitas
  • Casos de prueba detallados
  • Tareas técnicas por subsistema
  • Definition of Done completo

Estado: COMPLETADO (2026-01-10)

---

TAREA 4: CONSOLIDACIÓN DE REQUERIMIENTOS FUNCIONALES

Resumen

Eliminación del directorio /docs/03-requerimientos/ completo que contenía duplicados exactos de los RF canónicos en Foundation y Core Business.

Métricas

Métrica	Antes	Después	Diferencia
Total archivos .md	775	747	-28
Directorio eliminado	/docs/03-requerimientos/	-	-1
Archivos RF duplicados	28	0	-28
Ubicaciones de RF	3	2	-1

Directorios y Archivos Eliminados

• /docs/03-requerimientos/RF-auth/ (5 archivos + índice)
• /docs/03-requerimientos/RF-users/ (5 archivos + índice)
• /docs/03-requerimientos/RF-rbac/ (4 archivos + índice)
• /docs/03-requerimientos/RF-tenants/ (4 archivos + índice)
• /docs/03-requerimientos/RF-catalogs/ (5 archivos + índice)

Ubicaciones Canónicas Mantenidas

1. Foundation/Core Business (37 RF detallados - para análisis MVP)

   • /docs/01-fase-foundation/MGN-00X-*/requerimientos/
   • /docs/02-fase-core-business/MGN-00X-*/requerimientos/

2. Modelado (97 RF - para desarrollo)

   • /docs/04-modelado/requerimientos-funcionales/mgn-*/

Justificación

• 100% duplicación: Archivos idénticos (MD5 hash coincidente)
• Estructura redundante: Misma información reorganizada sin valor adicional

Estado: COMPLETADO (2026-01-10)

---

TAREA 5: HOMOLOGACIÓN DE NOMENCLATURA

Resumen

Análisis de inconsistencias de nomenclatura en archivos y directorios.

Inconsistencias Identificadas (32 total)

Tipo	Cantidad	Estado
Directorios en minúsculas (mgn-XXX)	14	Documentado
Archivos BACKLOG sin guiones	4	Documentado
Archivos ET en minúsculas	8	Documentado
Índices con plural	6	Documentado

Estándares Definidos

DIRECTORIOS: MGN-XXX-nombre (mayúsculas en código)
BACKLOGS:    BACKLOG-MGN-XXX.md (con guiones)
ET:          ET-[CONTEXTO]-tipo.md (CONTEXTO en mayúsculas)
RF:          RF-[CONTEXTO]-XXX.md (CONTEXTO en mayúsculas)
ÍNDICES:     INDICE-[TIPO]-[CONTEXTO].md (singular)

Decisión

Las inconsistencias son menores (convenciones de estilo) y NO afectan la funcionalidad. Se documentan para implementación progresiva posterior sin riesgo de romper referencias.

Estado: DOCUMENTADO (2026-01-10) - Implementación pendiente como mejora continua

---

TAREA 6: SINCRONIZACIÓN DOCS-CÓDIGO

Resumen

Creación de documentación básica para 8 módulos backend sin MGN-ID formal.

Estructura Creada

Nuevo directorio: /docs/03-fase-vertical/

MGN-ID	Módulo	Servicios	Complejidad
MGN-011	Sales	5	Alta
MGN-012	Purchases	2	Media
MGN-013	Inventory	9	Muy Alta
MGN-014	HR	7	Muy Alta
MGN-015	CRM	4	Media
MGN-016	Projects	3	Media-Alta
MGN-017	Partners	2	Media
MGN-018	Companies	1	Baja

Archivos Creados (9)

• /docs/03-fase-vertical/README.md
• /docs/03-fase-vertical/MGN-011-sales/README.md
• /docs/03-fase-vertical/MGN-012-purchases/README.md
• /docs/03-fase-vertical/MGN-013-inventory/README.md
• /docs/03-fase-vertical/MGN-014-hr/README.md
• /docs/03-fase-vertical/MGN-015-crm/README.md
• /docs/03-fase-vertical/MGN-016-projects/README.md
• /docs/03-fase-vertical/MGN-017-partners/README.md
• /docs/03-fase-vertical/MGN-018-companies/README.md

Estado: COMPLETADO (2026-01-10)

---

RESUMEN EJECUTIVO DE REESTRUCTURACIÓN

Métricas Finales

Métrica	Antes	Después	Cambio
Total archivos .md	840	756	-84 (10%)
Directorios legacy	1	0	-1
Backlogs duplicados	4	0	-4
User Stories duplicadas	42	0	-42
RF duplicados	28	0	-28
Módulos documentados	10	18	+8

Tareas Completadas

• TAREA 1: Purga de documentación legacy (-19 archivos)
• TAREA 2: Consolidación de backlogs (-4 archivos)
• TAREA 3: Unificación de user stories (-42 archivos)
• TAREA 4: Consolidación de RF (-28 archivos)
• TAREA 5: Homologación de nomenclatura (documentada)
• TAREA 6: Sincronización docs-código (+9 archivos)
• TAREA 7: Actualización de referencias (_MAP.md, README.md)
• TAREA 8: Validación final

Validación Final (2026-01-10)

Verificación	Resultado	Estado
Directorio legacy_backup	0	PASS
Directorio 03-requerimientos	0	PASS
User Stories en 05-user-stories	147	PASS
Backlogs canónicos	4	PASS
Módulos documentados	18	PASS

Tareas de Mejora Continua

• Implementación de renombramientos de nomenclatura (32 archivos)
• Completar RF/ET/US para módulos MGN-011 a MGN-018
• Actualizar referencias en archivos de épicas (12 archivos)

Ubicaciones Canónicas Consolidadas

1. User Stories: /docs/05-user-stories/ (147 archivos)
2. Backlogs: /docs/01-fase-foundation/MGN-XXX/historias-usuario/ (4 archivos)
3. Requerimientos:
   • Foundation/Core: /docs/0X-fase-*/MGN-XXX/requerimientos/ (37 archivos)
   • Modelado: /docs/04-modelado/requerimientos-funcionales/ (97 archivos)

Directorios Eliminados

• /docs/05-user-stories/_legacy_backup/ (20 archivos)
• /docs/03-requerimientos/ (28 archivos)

---

Reestructuración ejecutada: 2026-01-10 Agente: Claude Code - Perfil Documentation Architect