michangarrito/orchestration/_archive/analisis/DEPENDENCIAS-ARCHIVOS-SPRINT1-2026-01-10.md

Analisis de Dependencias - Sprint 1

Fecha: 2026-01-10 Version: 1.0.0 Estado: COMPLETADO

---

1. HALLAZGO CRITICO

Los archivos objetivo del Sprint 1 YA EXISTEN pero estan DESACTUALIZADOS.

Archivos Existentes

Archivo	Ubicacion	Estado
docs/_MAP.md	/docs/_MAP.md	DESACTUALIZADO
MASTER_INVENTORY.yml	/orchestration/inventarios/	DESACTUALIZADO
DATABASE_INVENTORY.yml	/orchestration/inventarios/	DESACTUALIZADO
BACKEND_INVENTORY.yml	/orchestration/inventarios/	DESACTUALIZADO
FRONTEND_INVENTORY.yml	/orchestration/inventarios/	DESACTUALIZADO

Accion requerida: ACTUALIZAR en lugar de CREAR

---

2. DISCREPANCIAS DETECTADAS

2.1 MASTER_INVENTORY.yml

Campo	Valor Actual	Valor Correcto
puerto backend	3500	3141
puerto frontend	5175	3140
progreso porcentaje	25%	95%
estado modulos	parcial/pendiente	mayoría completado
schemas database	8	9 (falta integrations)
apps.backend.estado	en_desarrollo	completado
apps.frontend.estado	en_desarrollo	completado
apps.mobile.estado	pendiente	completado

2.2 DATABASE_INVENTORY.yml

Campo	Valor Actual	Valor Correcto
total_schemas	10	9
total_tablas	29	27
extensiones	2	4 (falta unaccent, pg_trgm)
tabla tenant_settings	existe	deberia ser tenant_configs
tablas auth	4	3 (users, sessions, otp_codes)
tablas sales	4	4 (diferente contenido)

2.3 BACKEND_INVENTORY.yml

Campo	Valor Actual	Valor Correcto
total_modulos	14	12
total_entities	29	20+
modulos listados	14	12
endpoint paths	/auth/login	v1/auth/login
swagger_path	falta	/docs

2.4 FRONTEND_INVENTORY.yml

Campo	Valor Actual	Valor Correcto
root	apps/web	apps/frontend
total_paginas	7	9
total_componentes	15	1 (Layout) + UI lib
total_contexts	3	1 (AuthContext)
react version	18	19.2.0
paginas faltantes	-	Orders, Fiado, Inventory, Register
vite	no especificado	7.2.4

2.5 docs/_MAP.md

Campo	Valor Actual	Valor Correcto
referencias epicas	MCH-001-infraestructura/	MCH-001-infraestructura-base.md
epicas listadas	MCH-001 a MCH-022	MCH-001 a MCH-028
estados de fases	algunos incorrectos	actualizar segun PROJECT-STATUS
navegacion inventarios	correcto	correcto

---

3. MATRIZ DE DEPENDENCIAS

3.1 Dependencias de Lectura

Archivo a Actualizar	Lee de
docs/_MAP.md	docs/**/*.md
DATABASE_INVENTORY.yml	database/schemas/*.sql
BACKEND_INVENTORY.yml	apps/backend/src/**
FRONTEND_INVENTORY.yml	apps/frontend/src/**
MASTER_INVENTORY.yml	Todos los anteriores

3.2 Dependencias de Escritura

Archivo	Es leido por
docs/_MAP.md	Usuarios, documentacion
DATABASE_INVENTORY.yml	BACKEND_INVENTORY, MASTER_INVENTORY
BACKEND_INVENTORY.yml	FRONTEND_INVENTORY, MASTER_INVENTORY
FRONTEND_INVENTORY.yml	MASTER_INVENTORY
MASTER_INVENTORY.yml	Orquestacion general

3.3 Orden de Actualizacion (Corregido)

1. DATABASE_INVENTORY.yml   <-- Base de todo
        |
        v
2. BACKEND_INVENTORY.yml    <-- Mapea entidades a BD
        |
        v
3. FRONTEND_INVENTORY.yml   <-- Consume API de backend
        |
        v
4. MASTER_INVENTORY.yml     <-- Consolida todo
        |
        v
5. docs/_MAP.md             <-- Navegacion de docs

---

4. ARCHIVOS QUE NO SE DEBEN MODIFICAR

Archivo	Razon
database/schemas/*.sql	Codigo fuente
apps/backend/src/**	Codigo fuente
apps/frontend/src/**	Codigo fuente
orchestration/PLAN-IMPLEMENTACION.md	Documento maestro
orchestration/PROJECT-STATUS.md	Status oficial

---

5. IMPACTO DE LAS ACTUALIZACIONES

5.1 Bajo Riesgo

• docs/_MAP.md: Solo navegacion, no afecta funcionalidad
• MASTER_INVENTORY.yml: Resumen informativo

5.2 Medio Riesgo

• DATABASE_INVENTORY.yml: Referencia de estructura de BD
• BACKEND_INVENTORY.yml: Referencia de API
• FRONTEND_INVENTORY.yml: Referencia de UI

5.3 Mitigacion

• Mantener backups de archivos originales
• Validar conteos contra codigo fuente
• Revisar referencias cruzadas

---

6. PLAN ACTUALIZADO

Cambio de Estrategia

Original	Actualizado
CREAR 4 archivos	ACTUALIZAR 5 archivos
Usar templates base	Usar contenido existente como base
Sin backups	Considerar versionado

Orden de Ejecucion Revisado

#	Archivo	Accion	Prioridad
1	DATABASE_INVENTORY.yml	ACTUALIZAR	P0
2	BACKEND_INVENTORY.yml	ACTUALIZAR	P0
3	FRONTEND_INVENTORY.yml	ACTUALIZAR	P0
4	MASTER_INVENTORY.yml	ACTUALIZAR	P1
5	docs/_MAP.md	ACTUALIZAR	P1

---

7. CHECKLIST DE VALIDACION POST-ACTUALIZACION

DATABASE_INVENTORY.yml

• 9 schemas documentados
• 27 tablas correctas
• 4 extensiones listadas
• Nombres de tablas correctos

BACKEND_INVENTORY.yml

• 12 modulos documentados
• Endpoints con prefijo v1/
• Entidades mapeadas a tablas reales
• Puerto 3141

FRONTEND_INVENTORY.yml

• Ruta base apps/frontend/
• 9 paginas documentadas
• React 19.2.0 + Vite 7.2.4
• Puerto 3140

MASTER_INVENTORY.yml

• Puertos correctos (3141, 3140)
• Progreso 95%
• Estados de modulos actualizados
• Referencias a inventarios correctas

docs/_MAP.md

• Referencias a archivos .md (no carpetas)
• 28 epicas listadas
• Estados de fases actualizados
• Links funcionales

---

Fin del Analisis de Dependencias