miinventario-v2/orchestration/analisis/ANALISIS-DEPENDENCIAS-DOCUMENTACION-2026-01-13.md
rckrdmrd c24f889f70
Some checks failed
Build / Build Backend (push) Has been cancelled
Build / Build Mobile (TypeScript Check) (push) Has been cancelled
Lint / Lint Backend (push) Has been cancelled
Lint / Lint Mobile (push) Has been cancelled
Test / Backend E2E Tests (push) Has been cancelled
Test / Mobile Unit Tests (push) Has been cancelled
Build / Build Docker Image (push) Has been cancelled
[MIINVENTARIO] feat: Add exports, reports, integrations modules and CI/CD pipeline
- Add exports module with PDF/CSV/Excel generation
- Add reports module for inventory analytics
- Add POS integrations module
- Add database migrations for exports, movements and integrations
- Add GitHub Actions CI/CD workflow with Docker support
- Add mobile export and reports screens with tests
- Update epic documentation with traceability
- Add deployment and security guides

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 06:06:34 -06:00

599 lines
25 KiB
Markdown

# Analisis de Dependencias entre Documentacion
**Fecha:** 2026-01-13
**Version:** 1.0.0
**Autor:** Claude Code
---
## 1. Resumen Ejecutivo
Este documento analiza las dependencias entre archivos de documentacion del proyecto miinventario, identificando:
- Referencias cruzadas entre documentos
- Archivos con mayor riesgo de desactualizacion
- Archivos huerfanos (sin referencias entrantes)
- Orden recomendado de actualizacion
---
## 2. Mapa de Dependencias por Archivo
### 2.1 Epicas (MII-001 a MII-015)
#### MII-001: Infraestructura Base
| Tipo | Archivos |
|------|----------|
| **Referenciado por (38 archivos)** | |
| - docs/_MAP.md | lineas 41, 98, 171 |
| - docs/01-epicas/_MAP.md | lineas 22, 72, 108, 130 |
| - docs/01-epicas/MII-002-autenticacion.md | linea 203 |
| - docs/01-epicas/MII-003-gestion-tiendas.md | linea 205 |
| - docs/01-epicas/MII-004-captura-video.md | linea 247 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 325 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 228 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 137, 149 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 28, 41, 54, 240, 279 |
| - orchestration/PROXIMA-ACCION.md | linea 28 |
| - orchestration/PROJECT-STATUS.md | lineas 28, 42 |
| - orchestration/inventarios/MASTER_INVENTORY.yml | lineas 67, 112 |
| - orchestration/00-guidelines/CONTEXTO-PROYECTO.md | linea 169 |
| **Referencia a** | ARQUITECTURA-TECNICA.md, CONTEXT-MAP.yml, HERENCIA-SIMCO.md |
#### MII-002: Autenticacion
| Tipo | Archivos |
|------|----------|
| **Referenciado por (35+ archivos)** | |
| - docs/_MAP.md | lineas 42, 99 |
| - docs/01-epicas/_MAP.md | lineas 22, 73, 108, 131 |
| - docs/01-epicas/MII-003-gestion-tiendas.md | linea 206 |
| - docs/01-epicas/MII-004-captura-video.md | linea 248 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 326 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 229 |
| - docs/01-epicas/MII-009-wallet-creditos.md | linea 358 |
| - docs/01-epicas/MII-014-referidos.md | linea 424 |
| - docs/01-epicas/MII-001-infraestructura-base.md | linea 103 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 31, 50, 63, 68, 73 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 144, 157 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 41, 43, 54, 68, 243, 279 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md |
#### MII-003: Gestion de Tiendas
| Tipo | Archivos |
|------|----------|
| **Referenciado por (30+ archivos)** | |
| - docs/_MAP.md | lineas 43, 100 |
| - docs/01-epicas/_MAP.md | lineas 22, 74, 108, 132 |
| - docs/01-epicas/MII-002-autenticacion.md | linea 206 |
| - docs/01-epicas/MII-004-captura-video.md | linea 249 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 327 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 230 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 32, 82, 87 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 152, 165 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 55, 58, 69, 83, 246, 280 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md |
#### MII-004: Captura de Video
| Tipo | Archivos |
|------|----------|
| **Referenciado por (35+ archivos)** | |
| - docs/_MAP.md | lineas 44, 101 |
| - docs/01-epicas/_MAP.md | lineas 22, 75, 108, 133 |
| - docs/01-epicas/MII-002-autenticacion.md | linea 207 |
| - docs/01-epicas/MII-003-gestion-tiendas.md | linea 209 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 328 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 231 |
| - docs/02-integraciones/INT-005-s3-storage.md | linea 303 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 33, 34, 96, 103, 108, 117 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 160, 172 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 69, 72, 84, 97, 249, 280 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md, INT-005-s3-storage.md |
#### MII-005: Procesamiento IA
| Tipo | Archivos |
|------|----------|
| **Referenciado por (45+ archivos)** | *ALTO RIESGO* |
| - docs/_MAP.md | lineas 45, 102 |
| - docs/01-epicas/_MAP.md | lineas 22, 76, 108, 134 |
| - docs/01-epicas/MII-003-gestion-tiendas.md | linea 210 |
| - docs/01-epicas/MII-004-captura-video.md | linea 252 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 232 |
| - docs/01-epicas/MII-007-retroalimentacion.md | linea 240 |
| - docs/01-epicas/MII-008-validacion-aleatoria.md | linea 278 |
| - docs/01-epicas/MII-009-wallet-creditos.md | linea 359 |
| - docs/01-epicas/MII-014-referidos.md | linea 427 |
| - docs/01-epicas/MII-015-admin-saas.md | linea 291 |
| - docs/02-integraciones/INT-006-ia-provider.md | linea 401 |
| - docs/02-integraciones/INT-004-firebase-fcm.md | linea 276 |
| - docs/97-adr/ADR-0003-abstraccion-proveedores-ia.md | linea 245 |
| - docs/97-adr/ADR-0002-procesamiento-asincrono.md | linea 219 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 34, 35, 122-157 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 167, 179 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 84, 86, 98, 111, 252, 281 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md, ADR-0003, INT-006 |
#### MII-006: Reportes de Inventario
| Tipo | Archivos |
|------|----------|
| **Referenciado por (35+ archivos)** | |
| - docs/_MAP.md | lineas 46, 103 |
| - docs/01-epicas/_MAP.md | lineas 22, 77, 108, 135 |
| - docs/01-epicas/MII-003-gestion-tiendas.md | linea 211 |
| - docs/01-epicas/MII-004-captura-video.md | linea 253 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 331 |
| - docs/01-epicas/MII-007-retroalimentacion.md | linea 241 |
| - docs/01-epicas/MII-008-validacion-aleatoria.md | linea 279 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 36, 167, 172, 177 |
| - orchestration/CONTEXT-MAP.yml | lineas 104, 174, 186, 193, 200 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 98, 100, 112, 131, 141, 160, 256, 282 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md |
#### MII-007: Retroalimentacion
| Tipo | Archivos |
|------|----------|
| **Referenciado por (25+ archivos)** | |
| - docs/_MAP.md | lineas 47, 109 |
| - docs/01-epicas/_MAP.md | lineas 29, 83, 112, 136 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 332 |
| - docs/01-epicas/MII-006-reportes-inventario.md | linea 235 |
| - docs/01-epicas/MII-008-validacion-aleatoria.md | linea 308 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 37, 186-201 |
| - orchestration/CONTEXT-MAP.yml | lineas 112, 181 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 98, 112, 122, 256, 282 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md |
#### MII-008: Validacion Aleatoria
| Tipo | Archivos |
|------|----------|
| **Referenciado por (22+ archivos)** | |
| - docs/_MAP.md | lineas 48, 110 |
| - docs/01-epicas/_MAP.md | lineas 29, 84, 112, 137 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 38, 210, 215 |
| - orchestration/CONTEXT-MAP.yml | lineas 112, 188 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 98, 112, 133, 256, 282 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, MII-007-retroalimentacion.md |
#### MII-009: Wallet y Creditos
| Tipo | Archivos |
|------|----------|
| **Referenciado por (42+ archivos)** | *ALTO RIESGO* |
| - docs/_MAP.md | lineas 49, 116 |
| - docs/01-epicas/_MAP.md | lineas 36, 90, 115, 138 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 333 |
| - docs/01-epicas/MII-010-paquetes-recarga.md | lineas 311, 342 |
| - docs/01-epicas/MII-011-pagos-tarjeta.md | linea 309 |
| - docs/01-epicas/MII-012-pagos-oxxo.md | linea 365 |
| - docs/01-epicas/MII-013-pagos-7eleven.md | linea 284 |
| - docs/01-epicas/MII-014-referidos.md | linea 425 |
| - docs/01-epicas/MII-015-admin-saas.md | linea 292 |
| - docs/97-adr/ADR-0001-modelo-creditos-tokens.md | linea 164 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 39, 224-244 |
| - orchestration/CONTEXT-MAP.yml | lineas 120, 195, 208, 237, 244 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 112, 151, 161, 171, 222, 233, 259, 283 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ADR-0001, ARQUITECTURA-TECNICA.md |
#### MII-010: Paquetes de Recarga
| Tipo | Archivos |
|------|----------|
| **Referenciado por (28+ archivos)** | |
| - docs/_MAP.md | lineas 50, 117 |
| - docs/01-epicas/_MAP.md | lineas 36, 91, 118, 139 |
| - docs/01-epicas/MII-009-wallet-creditos.md | linea 362 |
| - docs/01-epicas/MII-011-pagos-tarjeta.md | linea 310 |
| - docs/01-epicas/MII-012-pagos-oxxo.md | linea 366 |
| - docs/01-epicas/MII-013-pagos-7eleven.md | linea 285 |
| - docs/97-adr/ADR-0001-modelo-creditos-tokens.md | linea 165 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 40, 253-263 |
| - orchestration/CONTEXT-MAP.yml | lineas 120, 203, 215, 223, 230 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 161, 163, 181, 192, 202, 263, 283 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, MII-009-wallet-creditos.md, VISION-PROYECTO.md |
#### MII-011: Pagos con Tarjeta
| Tipo | Archivos |
|------|----------|
| **Referenciado por (28+ archivos)** | |
| - docs/_MAP.md | lineas 51, 118 |
| - docs/01-epicas/_MAP.md | lineas 36, 92, 118, 140 |
| - docs/01-epicas/MII-009-wallet-creditos.md | linea 363 |
| - docs/01-epicas/MII-010-paquetes-recarga.md | linea 314 |
| - docs/01-epicas/MII-014-referidos.md | linea 426 |
| - docs/02-integraciones/INT-001-stripe.md | linea 249 |
| - docs/97-adr/ADR-0004-pagos-efectivo-mexico.md | linea 202 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 41, 272, 287, 292 |
| - orchestration/CONTEXT-MAP.yml | lineas 120, 210 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 161, 173, 263, 284 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, INT-001-stripe.md, ADR-0004 |
#### MII-012: Pagos OXXO
| Tipo | Archivos |
|------|----------|
| **Referenciado por (28+ archivos)** | |
| - docs/_MAP.md | lineas 52, 119 |
| - docs/01-epicas/_MAP.md | lineas 36, 93, 118, 141 |
| - docs/01-epicas/MII-010-paquetes-recarga.md | linea 315 |
| - docs/01-epicas/MII-013-pagos-7eleven.md | lineas 286, 316 |
| - docs/02-integraciones/INT-002-oxxo.md | linea 216 |
| - docs/97-adr/ADR-0004-pagos-efectivo-mexico.md | linea 203 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 41, 277, 297 |
| - orchestration/CONTEXT-MAP.yml | lineas 120, 218 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 161, 184, 263, 284 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, INT-002-oxxo.md, ADR-0004 |
#### MII-013: Pagos 7-Eleven
| Tipo | Archivos |
|------|----------|
| **Referenciado por (25+ archivos)** | |
| - docs/_MAP.md | lineas 53, 120 |
| - docs/01-epicas/_MAP.md | lineas 36, 94, 121, 142 |
| - docs/01-epicas/MII-010-paquetes-recarga.md | linea 316 |
| - docs/02-integraciones/INT-003-7eleven.md | linea 222 |
| - docs/97-adr/ADR-0004-pagos-efectivo-mexico.md | linea 204 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 41, 282 |
| - orchestration/CONTEXT-MAP.yml | lineas 120, 225 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 161, 194, 268, 284 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, INT-003-7eleven.md, MII-012-pagos-oxxo.md |
#### MII-014: Sistema de Referidos
| Tipo | Archivos |
|------|----------|
| **Referenciado por (28+ archivos)** | |
| - docs/_MAP.md | lineas 54, 126 |
| - docs/01-epicas/_MAP.md | lineas 43, 100, 118, 143 |
| - docs/01-epicas/MII-009-wallet-creditos.md | linea 364 |
| - docs/01-epicas/MII-015-admin-saas.md | linea 293 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 42, 306-336 |
| - orchestration/CONTEXT-MAP.yml | lineas 128, 232, 244 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 161, 212, 233, 263, 285 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, VISION-PROYECTO.md |
#### MII-015: Administracion SaaS
| Tipo | Archivos |
|------|----------|
| **Referenciado por (25+ archivos)** | |
| - docs/_MAP.md | lineas 55, 127, 171 |
| - docs/01-epicas/_MAP.md | lineas 43, 101, 121, 144 |
| - docs/01-epicas/MII-014-referidos.md | linea 430 |
| - docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | lineas 43, 345-365 |
| - orchestration/CONTEXT-MAP.yml | lineas 128, 239 |
| - orchestration/PLAN-IMPLEMENTACION.md | lineas 224, 266, 285 |
| **Referencia a** | REQUERIMIENTOS-FUNCIONALES.md, ARQUITECTURA-TECNICA.md |
---
### 2.2 Integraciones (INT-001 a INT-006)
#### INT-001: Stripe
| Tipo | Archivos |
|------|----------|
| **Referenciado por (15+ archivos)** | |
| - docs/_MAP.md | lineas 66, 135 |
| - docs/02-integraciones/_MAP.md | lineas 17, 30, 58 |
| - docs/01-epicas/MII-011-pagos-tarjeta.md | linea 341 |
| - docs/97-adr/ADR-0004-pagos-efectivo-mexico.md | linea 205 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 342 |
| - orchestration/CONTEXT-MAP.yml | lineas 250, 257 |
| - orchestration/inventarios/MASTER_INVENTORY.yml | linea 364 |
| **Referencia a** | MII-011-pagos-tarjeta.md, ADR-0004 |
#### INT-002: OXXO
| Tipo | Archivos |
|------|----------|
| **Referenciado por (15+ archivos)** | |
| - docs/_MAP.md | lineas 67, 136 |
| - docs/02-integraciones/_MAP.md | lineas 18, 31, 58 |
| - docs/01-epicas/MII-012-pagos-oxxo.md | linea 397 |
| - docs/97-adr/ADR-0004-pagos-efectivo-mexico.md | linea 206 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 343 |
| - orchestration/CONTEXT-MAP.yml | lineas 259, 266 |
| **Referencia a** | MII-012-pagos-oxxo.md, ADR-0004 |
#### INT-003: 7-Eleven
| Tipo | Archivos |
|------|----------|
| **Referenciado por (12+ archivos)** | |
| - docs/_MAP.md | lineas 68, 137 |
| - docs/02-integraciones/_MAP.md | lineas 19, 32, 58 |
| - docs/01-epicas/MII-013-pagos-7eleven.md | linea 315 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 344 |
| - orchestration/CONTEXT-MAP.yml | lineas 268, 275 |
| **Referencia a** | MII-013-pagos-7eleven.md, ADR-0004 |
#### INT-004: Firebase FCM
| Tipo | Archivos |
|------|----------|
| **Referenciado por (12+ archivos)** | |
| - docs/_MAP.md | lineas 69, 138 |
| - docs/02-integraciones/_MAP.md | lineas 20, 33, 58 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 345 |
| - orchestration/CONTEXT-MAP.yml | lineas 277, 284 |
| **Referencia a** | MII-005-procesamiento-ia.md |
#### INT-005: S3 Storage
| Tipo | Archivos |
|------|----------|
| **Referenciado por (12+ archivos)** | |
| - docs/_MAP.md | lineas 70, 139 |
| - docs/02-integraciones/_MAP.md | lineas 21, 34, 58 |
| - docs/01-epicas/MII-004-captura-video.md | linea 293 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 346 |
| - orchestration/CONTEXT-MAP.yml | lineas 286, 293 |
| **Referencia a** | MII-004-captura-video.md |
#### INT-006: IA Provider
| Tipo | Archivos |
|------|----------|
| **Referenciado por (15+ archivos)** | |
| - docs/_MAP.md | lineas 71, 140 |
| - docs/02-integraciones/_MAP.md | lineas 22, 35, 64 |
| - docs/01-epicas/MII-005-procesamiento-ia.md | linea 377 |
| - docs/97-adr/ADR-0003-abstraccion-proveedores-ia.md | linea 244 |
| - docs/97-adr/ADR-0002-procesamiento-asincrono.md | linea 220 |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 347 |
| - orchestration/CONTEXT-MAP.yml | lineas 295, 302 |
| **Referencia a** | MII-005-procesamiento-ia.md, ADR-0003 |
---
### 2.3 Archivos de Inventario y Orquestacion
#### CONTEXT-MAP.yml
| Tipo | Archivos |
|------|----------|
| **Referenciado por (15+ archivos)** | |
| - docs/01-epicas/MII-001-infraestructura-base.md | linea 157 |
| - orchestration/00-guidelines/HERENCIA-SIMCO.md | linea 171 |
| - orchestration/README.md | lineas 25, 33 |
| - orchestration/analisis/*.md | multiples |
| **Referencia a** | Todos los inventarios, epicas, integraciones |
#### MASTER_INVENTORY.yml
| Tipo | Archivos |
|------|----------|
| **Referenciado por (20+ archivos)** | |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 497 |
| - orchestration/00-guidelines/CONTEXTO-PROYECTO.md | linea 261 |
| - orchestration/00-guidelines/HERENCIA-SIMCO.md | linea 172 |
| - orchestration/README.md | lineas 13, 42 |
| - orchestration/CONTEXT-MAP.yml | linea 62 |
| - orchestration/analisis/*.md | multiples |
| **Referencia a** | DATABASE, BACKEND, FRONTEND inventories |
#### BACKEND_INVENTORY.yml
| Tipo | Archivos |
|------|----------|
| **Referenciado por (22+ archivos)** | |
| - docs/02-especificaciones/_MAP.md | linea 59 |
| - orchestration/00-guidelines/CONTEXTO-PROYECTO.md | linea 263 |
| - orchestration/README.md | linea 15 |
| - orchestration/CONTEXT-MAP.yml | linea 64 |
| - orchestration/inventarios/MASTER_INVENTORY.yml | linea 463 |
| - orchestration/analisis/*.md | multiples |
#### DATABASE_INVENTORY.yml
| Tipo | Archivos |
|------|----------|
| **Referenciado por (22+ archivos)** | |
| - docs/00-vision-general/ARQUITECTURA-TECNICA.md | linea 498 |
| - docs/02-especificaciones/_MAP.md | linea 55 |
| - orchestration/00-guidelines/CONTEXTO-PROYECTO.md | linea 262 |
| - orchestration/README.md | linea 14 |
| - orchestration/CONTEXT-MAP.yml | linea 63 |
| - orchestration/inventarios/MASTER_INVENTORY.yml | linea 459 |
| - orchestration/analisis/*.md | multiples |
#### FRONTEND_INVENTORY.yml
| Tipo | Archivos |
|------|----------|
| **Referenciado por (28+ archivos)** | |
| - docs/02-especificaciones/_MAP.md | linea 63 |
| - orchestration/00-guidelines/CONTEXTO-PROYECTO.md | linea 264 |
| - orchestration/README.md | linea 16 |
| - orchestration/CONTEXT-MAP.yml | linea 65 |
| - orchestration/inventarios/MASTER_INVENTORY.yml | linea 467 |
| - orchestration/analisis/*.md | multiples |
---
## 3. Ranking de Riesgo por Dependencias
### 3.1 Archivos con MAS Dependencias Entrantes (Mayor Riesgo)
| Ranking | Archivo | Referencias Entrantes | Nivel de Riesgo |
|---------|---------|----------------------|-----------------|
| 1 | MII-005-procesamiento-ia.md | 45+ | **CRITICO** |
| 2 | MII-009-wallet-creditos.md | 42+ | **CRITICO** |
| 3 | MII-001-infraestructura-base.md | 38+ | **ALTO** |
| 4 | MII-006-reportes-inventario.md | 35+ | **ALTO** |
| 5 | MII-004-captura-video.md | 35+ | **ALTO** |
| 6 | MII-002-autenticacion.md | 35+ | **ALTO** |
| 7 | REQUERIMIENTOS-FUNCIONALES.md | 32+ | **ALTO** |
| 8 | CONTEXT-MAP.yml | 30+ | **ALTO** |
| 9 | MII-003-gestion-tiendas.md | 30+ | **MEDIO** |
| 10 | FRONTEND_INVENTORY.yml | 28+ | **MEDIO** |
| 11 | MII-010-paquetes-recarga.md | 28+ | **MEDIO** |
| 12 | MII-011-pagos-tarjeta.md | 28+ | **MEDIO** |
| 13 | MII-012-pagos-oxxo.md | 28+ | **MEDIO** |
| 14 | MII-014-referidos.md | 28+ | **MEDIO** |
| 15 | ARQUITECTURA-TECNICA.md | 26+ | **MEDIO** |
### 3.2 Archivos con MENOS Dependencias Entrantes
| Ranking | Archivo | Referencias Entrantes | Nivel de Riesgo |
|---------|---------|----------------------|-----------------|
| 1 | INT-003-7eleven.md | 12 | BAJO |
| 2 | INT-004-firebase-fcm.md | 12 | BAJO |
| 3 | INT-005-s3-storage.md | 12 | BAJO |
| 4 | INT-001-stripe.md | 15 | BAJO |
| 5 | INT-002-oxxo.md | 15 | BAJO |
| 6 | INT-006-ia-provider.md | 15 | BAJO |
---
## 4. Archivos Huerfanos (Sin Referencias Entrantes Significativas)
### 4.1 Documentos sin referencias desde otros archivos
| Archivo | Ubicacion | Observacion |
|---------|-----------|-------------|
| GUIA-DESPLIEGUE.md | docs/90-transversal/ | Solo en README.md |
| SEGURIDAD.md | docs/90-transversal/ | Solo en _MAP.md local |
| TESTING.md | docs/90-transversal/ | Solo en _MAP.md local |
| PRODUCTION-CONFIG.md | orchestration/90-transversal/ | Sin referencias externas |
| ADR-0001 a ADR-0004 | docs/97-adr/ | Referencias desde epicas pero no viceversa |
| ENVIRONMENT-INVENTORY.yml | orchestration/environment/ | Sin referencias documentadas |
### 4.2 Posibles archivos sin uso
| Archivo | Estado | Accion Recomendada |
|---------|--------|-------------------|
| REQUERIMIENTOS-ORIGINALES.md | Referenciado solo por _MAP y REQUERIMIENTOS-FUNCIONALES | Verificar si necesario |
| Archivos en orchestration/analisis/ | Archivos temporales de analisis | Posible archivado |
---
## 5. Matriz de Dependencias: Modificacion vs Impacto
### 5.1 Si se modifica una EPICA, actualizar:
```
MII-001 → docs/_MAP.md, 01-epicas/_MAP.md, CONTEXT-MAP.yml,
PLAN-IMPLEMENTACION.md, MASTER_INVENTORY.yml,
MII-002 a MII-006 (referencias de dependencias)
MII-005 → docs/_MAP.md, 01-epicas/_MAP.md, CONTEXT-MAP.yml,
MII-003, MII-004, MII-006, MII-007, MII-008, MII-009,
MII-014, MII-015, INT-004, INT-006, ADR-0002, ADR-0003
MII-009 → docs/_MAP.md, 01-epicas/_MAP.md, CONTEXT-MAP.yml,
MII-005, MII-010, MII-011, MII-012, MII-013, MII-014,
MII-015, ADR-0001
```
### 5.2 Si se modifica un INVENTARIO, actualizar:
```
CONTEXT-MAP.yml → MII-001, HERENCIA-SIMCO.md, README orchestration,
todos los analisis actualizados
MASTER_INVENTORY.yml → ARQUITECTURA-TECNICA.md, CONTEXTO-PROYECTO.md,
HERENCIA-SIMCO.md, README orchestration
BACKEND_INVENTORY.yml → CONTEXTO-PROYECTO.md, _MAP especificaciones,
MASTER_INVENTORY.yml
DATABASE_INVENTORY.yml → ARQUITECTURA-TECNICA.md, _MAP especificaciones,
CONTEXTO-PROYECTO.md, MASTER_INVENTORY.yml
FRONTEND_INVENTORY.yml → CONTEXTO-PROYECTO.md, _MAP especificaciones,
MASTER_INVENTORY.yml
```
### 5.3 Si se modifica una INTEGRACION, actualizar:
```
INT-001 (Stripe) → MII-011, ADR-0004, ARQUITECTURA-TECNICA.md,
02-integraciones/_MAP.md
INT-002 (OXXO) → MII-012, ADR-0004, ARQUITECTURA-TECNICA.md,
02-integraciones/_MAP.md
INT-006 (IA) → MII-005, ADR-0002, ADR-0003, ARQUITECTURA-TECNICA.md,
02-integraciones/_MAP.md
```
---
## 6. Orden Recomendado de Actualizacion
### Fase 1: Archivos Base (PRIMERO)
1. `CONTEXT-MAP.yml` - Fuente de verdad central
2. `MASTER_INVENTORY.yml` - Resumen consolidado
3. `DATABASE_INVENTORY.yml` - Base de datos
4. `BACKEND_INVENTORY.yml` - Modulos backend
5. `FRONTEND_INVENTORY.yml` - Screens mobile
### Fase 2: Documentacion de Vision (SEGUNDO)
6. `ARQUITECTURA-TECNICA.md` - Referencias a inventarios
7. `REQUERIMIENTOS-FUNCIONALES.md` - Estado de features
8. `VISION-PROYECTO.md` - Metricas y KPIs
### Fase 3: Epicas Core (TERCERO - Mayor impacto)
9. `MII-005-procesamiento-ia.md` - 45+ referencias
10. `MII-009-wallet-creditos.md` - 42+ referencias
11. `MII-001-infraestructura-base.md` - 38+ referencias
12. `MII-006-reportes-inventario.md` - 35+ referencias
13. `MII-004-captura-video.md` - 35+ referencias
14. `MII-002-autenticacion.md` - 35+ referencias
### Fase 4: Epicas Secundarias (CUARTO)
15. `MII-003-gestion-tiendas.md`
16. `MII-007-retroalimentacion.md`
17. `MII-008-validacion-aleatoria.md`
18. `MII-010-paquetes-recarga.md`
19. `MII-011-pagos-tarjeta.md`
20. `MII-012-pagos-oxxo.md`
21. `MII-013-pagos-7eleven.md`
22. `MII-014-referidos.md`
23. `MII-015-admin-saas.md`
### Fase 5: Integraciones (QUINTO)
24. `INT-006-ia-provider.md` - 15+ referencias
25. `INT-001-stripe.md`
26. `INT-002-oxxo.md`
27. `INT-003-7eleven.md`
28. `INT-004-firebase-fcm.md`
29. `INT-005-s3-storage.md`
### Fase 6: Mapas y Referencias (ULTIMO)
30. `docs/_MAP.md` - Indice principal
31. `docs/01-epicas/_MAP.md` - Indice epicas
32. `docs/02-integraciones/_MAP.md` - Indice integraciones
33. `orchestration/README.md`
---
## 7. Inconsistencias Detectadas
### 7.1 Nomenclatura
| Archivo | Problema | Recomendacion |
|---------|----------|---------------|
| INT-002-oxxo.md | CONTEXT-MAP referencia `INT-002-oxxo-voucher.md` | Unificar nombre |
| INT-006 | CONTEXT-MAP dice `INT-006-ai-provider.md`, existe `INT-006-ia-provider.md` | Unificar nombre |
### 7.2 Referencias Rotas Potenciales
- `docs/_MAP.md` lista `INT-002-oxxo-voucher.md` pero el archivo es `INT-002-oxxo.md`
- Algunos archivos en `orchestration/analisis/` referencian estados desactualizados
---
## 8. Metricas del Analisis
| Metrica | Valor |
|---------|-------|
| Total archivos analizados | 63 |
| Epicas (MII-001 a MII-015) | 15 |
| Integraciones (INT-001 a INT-006) | 6 |
| Inventarios (.yml) | 5 |
| Archivos con >30 referencias | 8 |
| Archivos huerfanos potenciales | 6 |
| Inconsistencias de nomenclatura | 2 |
---
## 9. Conclusiones
1. **MII-005 y MII-009 son los archivos mas criticos** - Cualquier cambio impacta 40+ documentos
2. **Los inventarios YAML son puntos centrales** - Cambios deben propagarse a docs referenciadores
3. **El orden de actualizacion es importante** - Actualizar fuentes antes que consumidores
4. **Existen inconsistencias de nomenclatura** - INT-002 y INT-006 tienen nombres inconsistentes
5. **Algunos documentos estan aislados** - Archivos en 90-transversal tienen pocas referencias
---
## 10. Proximos Pasos Recomendados
1. [ ] Corregir inconsistencias de nomenclatura (INT-002, INT-006)
2. [ ] Actualizar inventarios YAML como prioridad
3. [ ] Sincronizar estado de epicas con PROJECT-STATUS.md
4. [ ] Revisar documentos huerfanos para posible deprecacion
5. [ ] Implementar validacion automatica de referencias