michangarrito/orchestration/_archive/analisis/historico/FASE-5-ANALISIS-DEPENDENCIAS-2026-01-10.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

20 KiB

FASE 5: Analisis de Dependencias y Archivos Relacionados


id: DEP-VISION-001 title: Analisis de Dependencias para Estandarizacion vision-general type: Analysis status: Completed priority: P0 version: 1.0.0 created_date: 2026-01-10 updated_date: 2026-01-10 perfil_ejecutor: DOCUMENTATION-MAINTAINER depends_on:

  • FASE-4-VALIDACION-PLANEACION-VS-ANALISIS-2026-01-10.md

1. Objetivo de Esta Fase

Identificar y validar todas las dependencias de los archivos de vision-general:

  • Archivos que seran referenciados (destinos de links)
  • Archivos que referencian a vision-general (impacto de cambios)
  • Consistencia con inventarios YAML
  • Actualizaciones necesarias en archivos dependientes

2. Inventario de Archivos Dependientes Verificados

2.1 Epicas (28 archivos)

Ubicacion: /docs/01-epicas/

Epica Archivo RF Relacionado Estado
MCH-001 MCH-001-infraestructura-base.md RF-015 Verificado
MCH-002 MCH-002-autenticacion.md RF-015 Verificado
MCH-003 MCH-003-catalogo-productos.md RF-002 Verificado
MCH-004 MCH-004-punto-venta.md RF-001 Verificado
MCH-005 MCH-005-integraciones-pago.md RF-009, RF-013 Verificado
MCH-006 MCH-006-onboarding-inteligente.md RF-014 Verificado
MCH-007 MCH-007-templates-catalogos.md RF-002.3 Verificado
MCH-008 MCH-008-sistema-fiados.md RF-004 Verificado
MCH-009 MCH-009-prediccion-inventario.md RF-003.3 Verificado
MCH-010 MCH-010-mcp-server.md RF-007 Verificado
MCH-011 MCH-011-whatsapp-service.md RF-008 Verificado
MCH-012 MCH-012-chat-llm-dueno.md RF-007.2 Verificado
MCH-013 MCH-013-chat-llm-cliente.md RF-007.3 Verificado
MCH-014 MCH-014-gestion-clientes.md RF-004, RF-005 Verificado
MCH-015 MCH-015-pedidos-whatsapp.md RF-006 Verificado
MCH-016 MCH-016-entregas-domicilio.md RF-006.4 Verificado
MCH-017 MCH-017-notificaciones.md RF-011 Verificado
MCH-018 MCH-018-planes-suscripciones.md RF-009.1 Verificado
MCH-019 MCH-019-tienda-tokens.md RF-009.3 Verificado
MCH-020 MCH-020-pagos-suscripcion.md RF-009.2 Verificado
MCH-021 MCH-021-dashboard-web.md RF-010 Verificado
MCH-022 MCH-022-modo-offline.md RF-012 Verificado
MCH-023 MCH-023-programa-referidos.md RF-016 Verificado
MCH-024 MCH-024-codi-spei.md RF-001.2 Verificado
MCH-025 MCH-025-widgets-atajos.md - Verificado
MCH-026 MCH-026-multi-idioma-latam.md - Verificado
MCH-027 MCH-027-integracion-sat.md RF-009.4 Verificado
MCH-028 MCH-028-marketplace-proveedores.md - Verificado

Total: 28 epicas verificadas

2.2 ADRs (3 archivos)

Ubicacion: /docs/97-adr/

ADR Archivo Tema Referenciado en
ADR-0001 ADR-0001-multi-tenant-architecture.md Multi-tenant ARQUITECTURA
ADR-0002 ADR-0002-whatsapp-first-approach.md WhatsApp First VISION, ARQUITECTURA
ADR-0003 ADR-0003-llm-agnostic-strategy.md LLM Agnostico ARQUITECTURA

Total: 3 ADRs verificados (todos existen)

2.3 Integraciones (4 archivos)

Ubicacion: /docs/02-integraciones/

INT Archivo Proveedor Referenciado en
INT-001 INT-001-whatsapp-meta.md Meta WhatsApp Business ARQUITECTURA, RF-008
INT-002 INT-002-stripe.md Stripe ARQUITECTURA, RF-009
INT-003 INT-003-openrouter.md OpenRouter ARQUITECTURA, RF-007
INT-004 INT-004-mercadopago.md Mercado Pago ARQUITECTURA, RF-009

Total: 4 integraciones verificadas

2.4 Especificaciones (1 archivo principal)

Ubicacion: /docs/02-especificaciones/

Archivo Referenciado en
ARQUITECTURA-DATABASE.md ARQUITECTURA-TECNICA

2.5 Inventarios YAML (4 archivos)

Ubicacion: /orchestration/inventarios/

Inventario Referenciado en Debe Actualizarse
MASTER_INVENTORY.yml ARQUITECTURA, REQUERIMIENTOS NO (solo consulta)
BACKEND_INVENTORY.yml ARQUITECTURA, REQUERIMIENTOS NO (solo consulta)
FRONTEND_INVENTORY.yml ARQUITECTURA NO (solo consulta)
DATABASE_INVENTORY.yml ARQUITECTURA NO (solo consulta)

3. Matriz de Referencias Actualizada

3.1 Referencias desde VISION-PROYECTO.md

Destino Path Correcto Verificado
REQUERIMIENTOS-FUNCIONALES.md ./REQUERIMIENTOS-FUNCIONALES.md SI
ARQUITECTURA-TECNICA.md ./ARQUITECTURA-TECNICA.md SI
Epicas _MAP ../01-epicas/_MAP.md SI
MCH-001 ../01-epicas/MCH-001-infraestructura-base.md SI
MCH-009 ../01-epicas/MCH-009-prediccion-inventario.md SI
MCH-010 ../01-epicas/MCH-010-mcp-server.md SI
MCH-015 ../01-epicas/MCH-015-pedidos-whatsapp.md SI
ADR-0001 ../97-adr/ADR-0001-multi-tenant-architecture.md SI
ADR-0002 ../97-adr/ADR-0002-whatsapp-first-approach.md SI
PROJECT-STATUS ../../orchestration/PROJECT-STATUS.md SI

3.2 Referencias desde ARQUITECTURA-TECNICA.md

Destino Path Correcto Verificado
VISION-PROYECTO.md ./VISION-PROYECTO.md SI
REQUERIMIENTOS-FUNCIONALES.md ./REQUERIMIENTOS-FUNCIONALES.md SI
ARQUITECTURA-DATABASE ../02-especificaciones/ARQUITECTURA-DATABASE.md SI
INT-001 ../02-integraciones/INT-001-whatsapp-meta.md SI
INT-002 ../02-integraciones/INT-002-stripe.md SI
INT-003 ../02-integraciones/INT-003-openrouter.md SI
INT-004 ../02-integraciones/INT-004-mercadopago.md SI
ADR-0001 ../97-adr/ADR-0001-multi-tenant-architecture.md SI
ADR-0002 ../97-adr/ADR-0002-whatsapp-first-approach.md SI
ADR-0003 ../97-adr/ADR-0003-llm-agnostic-strategy.md SI
MASTER_INVENTORY ../../orchestration/inventarios/MASTER_INVENTORY.yml SI
BACKEND_INVENTORY ../../orchestration/inventarios/BACKEND_INVENTORY.yml SI
DATABASE_INVENTORY ../../orchestration/inventarios/DATABASE_INVENTORY.yml SI

3.3 Referencias desde REQUERIMIENTOS-FUNCIONALES.md

Destino Path Correcto Verificado
VISION-PROYECTO.md ./VISION-PROYECTO.md SI
ARQUITECTURA-TECNICA.md ./ARQUITECTURA-TECNICA.md SI
Epicas _MAP ../01-epicas/_MAP.md SI
MCH-001 ../01-epicas/MCH-001-infraestructura-base.md SI
MCH-002 ../01-epicas/MCH-002-autenticacion.md SI
MCH-003 ../01-epicas/MCH-003-catalogo-productos.md SI
MCH-004 ../01-epicas/MCH-004-punto-venta.md SI
MCH-005 ../01-epicas/MCH-005-integraciones-pago.md SI
MCH-006 ../01-epicas/MCH-006-onboarding-inteligente.md SI
MCH-008 ../01-epicas/MCH-008-sistema-fiados.md SI
MCH-010 ../01-epicas/MCH-010-mcp-server.md SI
MCH-011 ../01-epicas/MCH-011-whatsapp-service.md SI
MCH-012 ../01-epicas/MCH-012-chat-llm-dueno.md SI
MCH-014 ../01-epicas/MCH-014-gestion-clientes.md SI
MCH-015 ../01-epicas/MCH-015-pedidos-whatsapp.md SI
MCH-017 ../01-epicas/MCH-017-notificaciones.md SI
MCH-018 ../01-epicas/MCH-018-planes-suscripciones.md SI
MCH-020 ../01-epicas/MCH-020-pagos-suscripcion.md SI
MCH-021 ../01-epicas/MCH-021-dashboard-web.md SI
MCH-022 ../01-epicas/MCH-022-modo-offline.md SI
MCH-023 ../01-epicas/MCH-023-programa-referidos.md SI
MASTER_INVENTORY ../../orchestration/inventarios/MASTER_INVENTORY.yml SI
BACKEND_INVENTORY ../../orchestration/inventarios/BACKEND_INVENTORY.yml SI

4. Mapeo RF → Epica (Corregido)

Basado en archivos reales:

RF Epica Correcta Nombre Archivo
RF-001 MCH-004 MCH-004-punto-venta.md
RF-002 MCH-003 MCH-003-catalogo-productos.md
RF-003 MCH-009 MCH-009-prediccion-inventario.md
RF-004 MCH-008, MCH-014 MCH-008-sistema-fiados.md, MCH-014-gestion-clientes.md
RF-005 MCH-014 MCH-014-gestion-clientes.md
RF-006 MCH-015 MCH-015-pedidos-whatsapp.md
RF-007 MCH-010 MCH-010-mcp-server.md
RF-008 MCH-011 MCH-011-whatsapp-service.md
RF-009 MCH-005, MCH-018, MCH-020 MCH-005-integraciones-pago.md, etc.
RF-010 MCH-021 MCH-021-dashboard-web.md
RF-011 MCH-017 MCH-017-notificaciones.md
RF-012 MCH-022 MCH-022-modo-offline.md
RF-013 MCH-005 MCH-005-integraciones-pago.md
RF-014 MCH-006 MCH-006-onboarding-inteligente.md
RF-015 MCH-002 MCH-002-autenticacion.md
RF-016 MCH-023 MCH-023-programa-referidos.md
RF-017 - Soporte (no tiene epica dedicada)
RF-018 - Audit Logs (nuevo - sin epica)
RF-019 - Feature Flags (nuevo - sin epica)
RF-020 - Rate Limiting (nuevo - sin epica)

5. Archivos que Deben Actualizarse Post-Ejecucion

5.1 Actualizaciones Obligatorias

Archivo Actualizacion Requerida Prioridad
docs/_MAP.md Agregar referencia a _MAP.md de vision-general P1

5.2 Actualizaciones Opcionales

Archivo Actualizacion Sugerida Prioridad
docs/01-epicas/_MAP.md Agregar links inversos a RF P3
orchestration/PROJECT-STATUS.md Actualizar estado de documentacion P2
docs/README.md Verificar consistencia P3

5.3 Sin Cambios Requeridos

Los siguientes archivos NO requieren actualizacion:

  • Epicas individuales (MCH-XXX) - Solo son destinos de links
  • ADRs - Solo son destinos de links
  • Integraciones (INT-XXX) - Solo son destinos de links
  • Inventarios YAML - Solo son consultados, no modificados
  • ARQUITECTURA-DATABASE.md - Solo es destino de link

6. Validacion de Consistencia con Inventarios

6.1 MASTER_INVENTORY.yml

Campo Valor Esperado Accion
docs.vision_general.status Published Verificar post-ejecucion
docs.vision_general.last_updated 2026-01-10 Actualizar si existe
requirements.total 20 Actualizar si existe
requirements.implemented 15 Verificar

6.2 Consistencia de Conteos

Metrica En RF En Inventario Consistente
Total RF 20 Verificar -
RF Implementados 15 Verificar -
RF Pendientes 5 Verificar -
Epicas 28 28 SI
Integraciones 4 4 SI
ADRs 3 3 SI

7. Diagrama de Dependencias Final

┌─────────────────────────────────────────────────────────────────────────────┐
│                          VISION-GENERAL (Fuente)                            │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────┐  ┌─────────────────────┐  ┌─────────────────────┐    │
│  │ _MAP.md (nuevo) │  │ VISION-PROYECTO.md  │  │ ARQUITECTURA-TEC.md │    │
│  │                 │  │                     │  │                     │    │
│  │ Referencia:     │  │ Referencia:         │  │ Referencia:         │    │
│  │ - 3 docs        │  │ - RF, ARQ           │  │ - VISION, RF        │    │
│  │                 │  │ - Epicas            │  │ - DATABASE          │    │
│  │                 │  │ - ADRs              │  │ - Integraciones     │    │
│  │                 │  │ - PROJECT-STATUS    │  │ - ADRs              │    │
│  │                 │  │                     │  │ - Inventarios       │    │
│  └─────────────────┘  └─────────────────────┘  └─────────────────────┘    │
│                                                                             │
│  ┌───────────────────────────────────────────────────────────────────┐    │
│  │                  REQUERIMIENTOS-FUNCIONALES.md                     │    │
│  │                                                                    │    │
│  │  Referencia:                                                       │    │
│  │  - VISION, ARQ                                                     │    │
│  │  - 28 Epicas (MCH-001 a MCH-028)                                  │    │
│  │  - Inventarios                                                     │    │
│  └───────────────────────────────────────────────────────────────────┘    │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘
                                     │
                                     ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                        DESTINOS DE REFERENCIAS                              │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  01-epicas/ (28 archivos)                                           │   │
│  │  MCH-001 → MCH-028                                                  │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  02-especificaciones/                                               │   │
│  │  ARQUITECTURA-DATABASE.md                                           │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  02-integraciones/ (4 archivos)                                     │   │
│  │  INT-001, INT-002, INT-003, INT-004                                 │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  97-adr/ (3 archivos)                                               │   │
│  │  ADR-0001, ADR-0002, ADR-0003                                       │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  orchestration/inventarios/ (4 archivos YAML)                       │   │
│  │  MASTER, BACKEND, FRONTEND, DATABASE                                │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  orchestration/                                                     │   │
│  │  PROJECT-STATUS.md                                                  │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

8. Resumen de Validacion de Dependencias

Categoria Total Verificados Porcentaje
Epicas 28 28 100%
ADRs 3 3 100%
Integraciones 4 4 100%
Especificaciones 1 1 100%
Inventarios 4 4 100%
Otros (PROJECT-STATUS) 1 1 100%
TOTAL 41 41 100%

9. Checklist Pre-Ejecucion

Basado en el analisis de dependencias:

  • Todos los archivos destino de links existen
  • Paths relativos calculados correctamente
  • Nombres de archivos verificados (case-sensitive)
  • ADR-0002 existe (ADR-0002-whatsapp-first-approach.md)
  • No hay dependencias circulares
  • Inventarios no requieren modificacion
  • Actualizar docs/_MAP.md post-ejecucion (P1)

10. Proximos Pasos (FASE 6)

La siguiente fase (Refinamiento del Plan) debera:

  1. Ajustar paths con nombres exactos verificados
  2. Confirmar actualizacion de docs/_MAP.md
  3. Finalizar plan con detalles corregidos
  4. Aprobar para ejecucion

Documento generado por: DOCUMENTATION-MAINTAINER Sistema: SIMCO v3.7.0 Metodologia: CAPVED (Fase D - Dependencias) Estado: COMPLETADO