- Prefijo v2: MCH - TRACEABILITY-MASTER.yml creado - Listo para integracion como submodulo Workspace: v2.0.0 | SIMCO: v4.0.0
371 lines
20 KiB
Markdown
371 lines
20 KiB
Markdown
# 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:
|
|
|
|
- [x] Todos los archivos destino de links existen
|
|
- [x] Paths relativos calculados correctamente
|
|
- [x] Nombres de archivos verificados (case-sensitive)
|
|
- [x] ADR-0002 existe (ADR-0002-whatsapp-first-approach.md)
|
|
- [x] No hay dependencias circulares
|
|
- [x] 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
|