rckrdmrd/michangarrito

Fork 0

Adrian Flores Cortes 2fb9f3f6b5

CI/CD Pipeline / Backend CI (push) Waiting to run

Details

CI/CD Pipeline / Frontend CI (push) Waiting to run

Details

CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run

Details

CI/CD Pipeline / Mobile CI (push) Waiting to run

Details

CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions

Details

CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions

Details

CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions

Details

CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions

Details

[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

17 KiB

Raw Blame History

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

# 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):

---
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":


| 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:

### Fase 1: MVP (3-4 meses)

Por:

### 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:

### Fase 2: Inteligencia (2-3 meses)

Por:

### 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:

---

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

Agregar:

---

## 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:

---
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":


| 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:


> **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:


> **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:

## 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:

---

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

Agregar:

## 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:

---
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:


| 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)"):


| 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):


### 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)

17 KiB Raw Blame History

FASE 6: Refinamiento del Plan

1. Ajustes Realizados al Plan Original

1.1 Correcciones de Paths

1.2 Mapeo RF → Epica Corregido

2. Plan Refinado de Ejecucion

PASO 1: Crear _MAP.md

PASO 2: Actualizar VISION-PROYECTO.md

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

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

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

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

PASO 3: Actualizar ARQUITECTURA-TECNICA.md

3.1 Insertar al INICIO del archivo:

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

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

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

3.5 ANTES del footer final, agregar nueva seccion ADRs:

3.6 Reemplazar footer por Referencias:

PASO 4: Actualizar REQUERIMIENTOS-FUNCIONALES.md

4.1 Insertar al INICIO del archivo:

4.2 Insertar DESPUES del titulo:

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

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

3. Orden Final de Ejecucion

4. Checklist de Ejecucion

Pre-Ejecucion

Durante Ejecucion

Post-Ejecucion

5. Aprobacion del Plan

17 KiB

Raw Blame History