# FASE 6: Refinamiento del Plan

---
id: REF-VISION-001
title: Plan Refinado para Estandarizacion de vision-general
type: Plan
status: Approved
priority: P0
version: 2.0.0
created_date: 2026-01-10
updated_date: 2026-01-10
perfil_ejecutor: DOCUMENTATION-MAINTAINER
depends_on:
  - FASE-5-ANALISIS-DEPENDENCIAS-2026-01-10.md
---

## 1. Ajustes Realizados al Plan Original

### 1.1 Correcciones de Paths

Basado en la verificacion de dependencias (FASE 5):

| Referencia Original | Path Corregido | Razon |
|---------------------|----------------|-------|
| ADR-0001 | ../97-adr/ADR-0001-multi-tenant-architecture.md | Nombre exacto verificado |
| ADR-0002 | ../97-adr/ADR-0002-whatsapp-first-approach.md | Nombre exacto verificado |
| ADR-0003 | ../97-adr/ADR-0003-llm-agnostic-strategy.md | Existe, agregar referencia |

### 1.2 Mapeo RF → Epica Corregido

| RF | Epica Original | Epica Correcta |
|----|----------------|----------------|
| RF-003 | MCH-006 | MCH-009-prediccion-inventario.md |
| RF-014 | MCH-019 | MCH-006-onboarding-inteligente.md |
| RF-009 | MCH-005 | MCH-005, MCH-018, MCH-020 |

---

## 2. Plan Refinado de Ejecucion

### PASO 1: Crear _MAP.md

**Archivo**: `/docs/00-vision-general/_MAP.md`
**Tipo**: Nuevo
**Lineas**: ~100

```markdown
# Vision General - Indice de Documentacion

---
id: MAP-VISION-001
title: Indice de Documentacion Vision General
type: Index
status: Published
version: 1.0.0
created_date: 2026-01-10
updated_date: 2026-01-10
---

## Resumen

| Metrica | Valor |
|---------|-------|
| **Documentos** | 3 |
| **Total Lineas** | ~1,237 |
| **Ultima Actualizacion** | 2026-01-10 |
| **Cobertura** | Vision, Requerimientos, Arquitectura |

## Contenido de la Carpeta

| # | Documento | Tipo | Estado | Descripcion |
|---|-----------|------|--------|-------------|
| 1 | [VISION-PROYECTO.md](./VISION-PROYECTO.md) | Vision | Published | Propuesta de valor, modelo de negocio, roadmap |
| 2 | [REQUERIMIENTOS-FUNCIONALES.md](./REQUERIMIENTOS-FUNCIONALES.md) | Requirement | Approved | 20 requisitos funcionales |
| 3 | [ARQUITECTURA-TECNICA.md](./ARQUITECTURA-TECNICA.md) | Specification | Published | Stack tecnologico, diagramas, infraestructura |

## Navegacion Rapida

### Por Tema

| Tema | Documento | Seccion |
|------|-----------|---------|
| Problema de mercado | VISION-PROYECTO | El Problema |
| Propuesta de valor | VISION-PROYECTO | La Solucion |
| Modelo de precios | VISION-PROYECTO | Modelo de Negocio |
| Punto de Venta | REQUERIMIENTOS-FUNCIONALES | RF-001 |
| Catalogo Productos | REQUERIMIENTOS-FUNCIONALES | RF-002 |
| Inventario | REQUERIMIENTOS-FUNCIONALES | RF-003 |
| Sistema Fiados | REQUERIMIENTOS-FUNCIONALES | RF-004 |
| Asistente IA | REQUERIMIENTOS-FUNCIONALES | RF-007 |
| WhatsApp Business | REQUERIMIENTOS-FUNCIONALES | RF-008 |
| Audit Logs | REQUERIMIENTOS-FUNCIONALES | RF-018 |
| Feature Flags | REQUERIMIENTOS-FUNCIONALES | RF-019 |
| Rate Limiting | REQUERIMIENTOS-FUNCIONALES | RF-020 |
| Stack tecnologico | ARQUITECTURA-TECNICA | Componentes Principales |
| Base de datos | ARQUITECTURA-TECNICA | Base de Datos |
| Seguridad | ARQUITECTURA-TECNICA | Seguridad |

### Por Rol

| Rol | Documentos Relevantes |
|-----|----------------------|
| Product Manager | VISION-PROYECTO, REQUERIMIENTOS-FUNCIONALES |
| Tech Lead | ARQUITECTURA-TECNICA, REQUERIMIENTOS-FUNCIONALES |
| Backend Developer | ARQUITECTURA-TECNICA (Backend API, BD) |
| Frontend Developer | ARQUITECTURA-TECNICA (Web, Mobile) |
| DevOps | ARQUITECTURA-TECNICA (Infraestructura) |

## Relaciones con Otros Documentos

```
00-vision-general/
├── VISION-PROYECTO.md
│   ├── → ../01-epicas/_MAP.md
│   ├── → ../97-adr/ADR-0001-multi-tenant-architecture.md
│   ├── → ../97-adr/ADR-0002-whatsapp-first-approach.md
│   └── → ../../orchestration/PROJECT-STATUS.md
├── REQUERIMIENTOS-FUNCIONALES.md
│   ├── → ../01-epicas/MCH-XXX.md (28 epicas)
│   └── → ../../orchestration/inventarios/*.yml
└── ARQUITECTURA-TECNICA.md
    ├── → ../02-especificaciones/ARQUITECTURA-DATABASE.md
    ├── → ../02-integraciones/INT-XXX.md (4 integraciones)
    └── → ../97-adr/ADR-XXX.md (3 ADRs)
```

## Historial de Cambios

| Fecha | Version | Cambios |
|-------|---------|---------|
| 2026-01-10 | 1.0.0 | Creacion inicial del indice |

---
**Sistema**: SIMCO v3.7.0
**Generado por**: DOCUMENTATION-MAINTAINER
```

---

### PASO 2: Actualizar VISION-PROYECTO.md

**Archivo**: `/docs/00-vision-general/VISION-PROYECTO.md`
**Tipo**: Modificacion
**Cambios**: Frontmatter, Metadata, Referencias, Links en Roadmap

#### 2.1 Insertar al INICIO del archivo (antes de linea 1):

```yaml
---
id: VIS-MCH-001
title: Vision del Proyecto MiChangarrito
type: Vision
status: Published
priority: P0
module: core
version: 1.1.0
created_date: 2026-01-04
updated_date: 2026-01-10
owner: Product Team
tags:
  - vision
  - estrategia
  - saas
---

```

#### 2.2 Insertar DESPUES del titulo "# MiChangarrito - Vision del Proyecto":

```markdown

| Campo | Valor |
|-------|-------|
| **ID** | VIS-MCH-001 |
| **Tipo** | Vision |
| **Estado** | Published |
| **Version** | 1.1.0 |
| **Ultima Actualizacion** | 2026-01-10 |

```

#### 2.3 Modificar seccion "Roadmap de Alto Nivel" (~linea 170):

Cambiar:
```markdown
### Fase 1: MVP (3-4 meses)
```

Por:
```markdown
### Fase 1: MVP (Completada - 95%)
> **Epicas**: [MCH-001](../01-epicas/MCH-001-infraestructura-base.md) a [MCH-009](../01-epicas/MCH-009-prediccion-inventario.md)
```

Cambiar:
```markdown
### Fase 2: Inteligencia (2-3 meses)
```

Por:
```markdown
### Fase 2: Inteligencia (En Progreso)
> **Epicas**: [MCH-010](../01-epicas/MCH-010-mcp-server.md) a [MCH-015](../01-epicas/MCH-015-pedidos-whatsapp.md)
```

#### 2.4 Reemplazar las ultimas lineas (footer) por seccion Referencias:

Eliminar:
```markdown
---

**Documento vivo** - Última actualización: 2026-01-04
**Autor**: Product Team
**Versión**: 1.0.0
```

Agregar:
```markdown
---

## Referencias

### Documentos Relacionados

| Documento | Relacion | Path |
|-----------|----------|------|
| Requerimientos Funcionales | Define los RF | [REQUERIMIENTOS-FUNCIONALES.md](./REQUERIMIENTOS-FUNCIONALES.md) |
| Arquitectura Tecnica | Define el stack | [ARQUITECTURA-TECNICA.md](./ARQUITECTURA-TECNICA.md) |
| Epicas del Proyecto | Implementacion | [../01-epicas/_MAP.md](../01-epicas/_MAP.md) |
| Estado del Proyecto | Progreso actual | [../../orchestration/PROJECT-STATUS.md](../../orchestration/PROJECT-STATUS.md) |

### ADRs Relacionados

| ADR | Tema |
|-----|------|
| [ADR-0001](../97-adr/ADR-0001-multi-tenant-architecture.md) | Multi-tenancy Architecture |
| [ADR-0002](../97-adr/ADR-0002-whatsapp-first-approach.md) | WhatsApp-First Approach |
| [ADR-0003](../97-adr/ADR-0003-llm-agnostic-strategy.md) | LLM Agnostic Strategy |

---

**Sistema**: SIMCO v3.7.0
**Documento**: VIS-MCH-001 v1.1.0
```

---

### PASO 3: Actualizar ARQUITECTURA-TECNICA.md

**Archivo**: `/docs/00-vision-general/ARQUITECTURA-TECNICA.md`
**Tipo**: Modificacion
**Cambios**: Frontmatter, Metadata, ADRs, Links, Referencias

#### 3.1 Insertar al INICIO del archivo:

```yaml
---
id: ET-ARQ-MCH-001
title: Arquitectura Tecnica MiChangarrito
type: Specification
subtype: Architecture
status: Published
priority: P0
module: core
version: 2.1.0
created_date: 2026-01-04
updated_date: 2026-01-10
owner: Tech Lead
tags:
  - arquitectura
  - tecnico
  - infraestructura
---

```

#### 3.2 Insertar DESPUES del titulo "# MiChangarrito - Arquitectura Tecnica":

```markdown

| Campo | Valor |
|-------|-------|
| **ID** | ET-ARQ-MCH-001 |
| **Tipo** | Especificacion Tecnica |
| **Estado** | Published |
| **Version** | 2.1.0 |
| **Ultima Actualizacion** | 2026-01-10 |

```

#### 3.3 DESPUES de "**Total: 12 schemas, ~49 tablas**" (~linea 381), agregar:

```markdown

> **Referencia completa**: [ARQUITECTURA-DATABASE.md](../02-especificaciones/ARQUITECTURA-DATABASE.md)
> **Inventario**: [DATABASE_INVENTORY.yml](../../orchestration/inventarios/DATABASE_INVENTORY.yml)
```

#### 3.4 DESPUES de tabla de Integraciones IA/ML (~linea 415), agregar:

```markdown

> **Documentacion detallada de integraciones**:
> - [INT-001: WhatsApp Meta](../02-integraciones/INT-001-whatsapp-meta.md)
> - [INT-002: Stripe](../02-integraciones/INT-002-stripe.md)
> - [INT-003: OpenRouter](../02-integraciones/INT-003-openrouter.md)
> - [INT-004: Mercado Pago](../02-integraciones/INT-004-mercadopago.md)
```

#### 3.5 ANTES del footer final, agregar nueva seccion ADRs:

```markdown
## ADRs Relacionados

| ADR | Titulo | Estado |
|-----|--------|--------|
| [ADR-0001](../97-adr/ADR-0001-multi-tenant-architecture.md) | Multi-tenant Architecture | Accepted |
| [ADR-0002](../97-adr/ADR-0002-whatsapp-first-approach.md) | WhatsApp-First Approach | Accepted |
| [ADR-0003](../97-adr/ADR-0003-llm-agnostic-strategy.md) | LLM Agnostic Strategy | Accepted |

```

#### 3.6 Reemplazar footer por Referencias:

Eliminar:
```markdown
---

**Versión**: 2.0.0
**Última actualización**: 2026-01-10
**Correcciones aplicadas**: Versiones actualizadas, módulos corregidos, schemas completos
```

Agregar:
```markdown
## Referencias

### Documentos Internos

| Documento | Relacion |
|-----------|----------|
| [VISION-PROYECTO.md](./VISION-PROYECTO.md) | Contexto de negocio |
| [REQUERIMIENTOS-FUNCIONALES.md](./REQUERIMIENTOS-FUNCIONALES.md) | Requisitos |
| [ARQUITECTURA-DATABASE.md](../02-especificaciones/ARQUITECTURA-DATABASE.md) | Detalle BD |

### Inventarios

| Inventario | Path |
|------------|------|
| MASTER_INVENTORY | [orchestration/inventarios/MASTER_INVENTORY.yml](../../orchestration/inventarios/MASTER_INVENTORY.yml) |
| BACKEND_INVENTORY | [orchestration/inventarios/BACKEND_INVENTORY.yml](../../orchestration/inventarios/BACKEND_INVENTORY.yml) |
| DATABASE_INVENTORY | [orchestration/inventarios/DATABASE_INVENTORY.yml](../../orchestration/inventarios/DATABASE_INVENTORY.yml) |

---

**Sistema**: SIMCO v3.7.0
**Documento**: ET-ARQ-MCH-001 v2.1.0
```

---

### PASO 4: Actualizar REQUERIMIENTOS-FUNCIONALES.md

**Archivo**: `/docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md`
**Tipo**: Modificacion mayor
**Cambios**: Frontmatter, Indice, Metadata por RF, CA ejemplos, RF nuevos, Referencias

(Este es el archivo mas complejo - se ejecutara en sub-pasos)

#### 4.1 Insertar al INICIO del archivo:

```yaml
---
id: RF-MCH-001
title: Requerimientos Funcionales MiChangarrito
type: Requirement
status: Approved
priority: P0
module: core
version: 1.1.0
created_date: 2026-01-04
updated_date: 2026-01-10
total_requirements: 20
implemented: 15
pending: 5
owner: Product Team
tags:
  - requerimientos
  - funcional
  - saas
---

```

#### 4.2 Insertar DESPUES del titulo:

```markdown

| Campo | Valor |
|-------|-------|
| **ID** | RF-MCH-001 |
| **Tipo** | Requirement Specification |
| **Estado** | Approved |
| **Total Requisitos** | 20 |
| **Implementados** | 15 (75%) |
| **Pendientes** | 5 |
| **Version** | 1.1.0 |

## Indice de Requerimientos

| ID | Nombre | Prioridad | Estado | Epica |
|----|--------|-----------|--------|-------|
| RF-001 | Punto de Venta (POS) | P0 | Implementado | [MCH-004](../01-epicas/MCH-004-punto-venta.md) |
| RF-002 | Catalogo de Productos | P0 | Implementado | [MCH-003](../01-epicas/MCH-003-catalogo-productos.md) |
| RF-003 | Inventario | P0 | Implementado | [MCH-009](../01-epicas/MCH-009-prediccion-inventario.md) |
| RF-004 | Sistema de Fiados | P1 | Implementado | [MCH-008](../01-epicas/MCH-008-sistema-fiados.md) |
| RF-005 | Clientes | P1 | Implementado | [MCH-014](../01-epicas/MCH-014-gestion-clientes.md) |
| RF-006 | Pedidos de Clientes | P1 | Implementado | [MCH-015](../01-epicas/MCH-015-pedidos-whatsapp.md) |
| RF-007 | Asistente IA (LLM) | P0 | Implementado | [MCH-010](../01-epicas/MCH-010-mcp-server.md) |
| RF-008 | WhatsApp Business | P0 | Implementado | [MCH-011](../01-epicas/MCH-011-whatsapp-service.md) |
| RF-009 | Pagos y Suscripciones | P0 | Implementado | [MCH-005](../01-epicas/MCH-005-integraciones-pago.md) |
| RF-010 | Reportes y Analytics | P1 | Implementado | [MCH-021](../01-epicas/MCH-021-dashboard-web.md) |
| RF-011 | Notificaciones | P1 | Implementado | [MCH-017](../01-epicas/MCH-017-notificaciones.md) |
| RF-012 | Modo Offline | P1 | Implementado | [MCH-022](../01-epicas/MCH-022-modo-offline.md) |
| RF-013 | Integraciones Terminal | P0 | Implementado | [MCH-005](../01-epicas/MCH-005-integraciones-pago.md) |
| RF-014 | Onboarding | P1 | Implementado | [MCH-006](../01-epicas/MCH-006-onboarding-inteligente.md) |
| RF-015 | Seguridad y Acceso | P0 | Implementado | [MCH-002](../01-epicas/MCH-002-autenticacion.md) |
| RF-016 | Programa de Referidos | P2 | Pendiente | [MCH-023](../01-epicas/MCH-023-programa-referidos.md) |
| RF-017 | Soporte | P2 | Parcial | - |
| RF-018 | Audit Logs | P1 | Pendiente | - |
| RF-019 | Feature Flags | P1 | Pendiente | - |
| RF-020 | Rate Limiting | P1 | Pendiente | - |

---

```

#### 4.3 Agregar metadata tabla en RF-001 (despues de "## RF-001: Punto de Venta (POS)"):

```markdown

| Campo | Valor |
|-------|-------|
| **ID** | RF-001 |
| **Prioridad** | P0 |
| **Estado** | Implementado |
| **Epica** | [MCH-004](../01-epicas/MCH-004-punto-venta.md) |

```

#### 4.4 Agregar CA en RF-001 (al final de la seccion, antes de RF-002):

```markdown

### Criterios de Aceptacion

```gherkin
Feature: RF-001 - Punto de Venta (POS)

  Scenario: Registrar venta con efectivo
    Given el usuario esta autenticado como dueno
    And tiene productos en el carrito por $150 MXN
    When selecciona "Efectivo" como metodo de pago
    And ingresa $200 como monto recibido
    Then el sistema calcula cambio de $50 MXN
    And genera ticket de venta
    And actualiza inventario

  Scenario: Corte de caja
    Given hay ventas registradas en el dia
    When el usuario solicita "Corte de caja"
    Then muestra resumen por metodo de pago
    And calcula diferencia esperado vs real
    And envia resumen por WhatsApp
```

```

(Repetir patron de metadata + CA para RF-007 y RF-008)

#### 4.5 Agregar RF-018, RF-019, RF-020 DESPUES de RF-017 (antes del footer):

(Contenido completo de los 3 nuevos RF como se definio en FASE 3)

#### 4.6 Reemplazar footer por Referencias:

```markdown
---

## Referencias

### Documentos Relacionados

| Documento | Relacion |
|-----------|----------|
| [VISION-PROYECTO.md](./VISION-PROYECTO.md) | Contexto de negocio |
| [ARQUITECTURA-TECNICA.md](./ARQUITECTURA-TECNICA.md) | Implementacion tecnica |
| [Epicas](../01-epicas/_MAP.md) | Implementacion por epica |

### Inventarios

| Inventario | Contenido |
|------------|-----------|
| [MASTER_INVENTORY](../../orchestration/inventarios/MASTER_INVENTORY.yml) | Estado consolidado |
| [BACKEND_INVENTORY](../../orchestration/inventarios/BACKEND_INVENTORY.yml) | Modulos y endpoints |

### Patrones de Referencia (template-saas)

| Patron | Modulo |
|--------|--------|
| SAAS-008 | Audit Logs (RF-018) |
| SAAS-009 | Feature Flags (RF-019) |
| SAAS-005 | Plans/Limits (RF-020) |

---

**Sistema**: SIMCO v3.7.0
**Documento**: RF-MCH-001 v1.1.0
```

---

## 3. Orden Final de Ejecucion

```
1. _MAP.md (crear nuevo)        → Sin dependencias
       ↓
2. VISION-PROYECTO.md           → Depende de: _MAP.md
       ↓
3. ARQUITECTURA-TECNICA.md      → Depende de: VISION
       ↓
4. REQUERIMIENTOS-FUNCIONALES   → Depende de: todos los anteriores
```

---

## 4. Checklist de Ejecucion

### Pre-Ejecucion
- [ ] Backup de archivos originales (opcional)
- [ ] Verificar que no hay cambios pendientes en git

### Durante Ejecucion
- [ ] PASO 1: _MAP.md creado
- [ ] PASO 2: VISION-PROYECTO.md actualizado
- [ ] PASO 3: ARQUITECTURA-TECNICA.md actualizado
- [ ] PASO 4: REQUERIMIENTOS-FUNCIONALES.md actualizado

### Post-Ejecucion
- [ ] Validar frontmatter YAML (parser)
- [ ] Verificar links internos funcionan
- [ ] Verificar links externos funcionan
- [ ] Actualizar docs/_MAP.md si es necesario

---

## 5. Aprobacion del Plan

| Rol | Estado | Fecha |
|-----|--------|-------|
| DOCUMENTATION-MAINTAINER | Aprobado | 2026-01-10 |
| REQUIREMENTS-ANALYST | Aprobado | 2026-01-10 |
| DOCUMENTATION-VALIDATOR | Aprobado | 2026-01-10 |

```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│              PLAN REFINADO: APROBADO                        │
│                                                             │
│   Listo para FASE 7: Ejecucion                             │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

**Documento generado por**: DOCUMENTATION-MAINTAINER
**Sistema**: SIMCO v3.7.0
**Metodologia**: CAPVED (Fase E - Refinamiento)