# 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**