- 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>
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:
- Ajustar paths con nombres exactos verificados
- Confirmar actualizacion de docs/_MAP.md
- Finalizar plan con detalles corregidos
- Aprobar para ejecucion
Documento generado por: DOCUMENTATION-MAINTAINER Sistema: SIMCO v3.7.0 Metodologia: CAPVED (Fase D - Dependencias) Estado: COMPLETADO