From e493017e864033047d38c6edc07ffd02cdff2091 Mon Sep 17 00:00:00 2001 From: rckrdmrd Date: Sat, 17 Jan 2026 04:19:07 -0600 Subject: [PATCH] [MCH-DOC-VAL] docs: Validacion documental inicial Cambios aplicados: - MASTER_INVENTORY.yml: Sincronizados conteos (tablas 47, controllers 20, entities 37) - _inheritance.yml: Corregido stack tecnologico (NestJS, React 19.2.0) - MCH-001: Estandarizada con HU formales (MCH-US-XXX), Story Points, Criterios de Aceptacion - Creado PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md con plan de tareas Tarea: MCH-DOC-VAL-2026-01-17 Co-Authored-By: Claude Opus 4.5 --- .../01-epicas/MCH-001-infraestructura-base.md | 96 ++++- orchestration/_inheritance.yml | 281 +++++++------ .../inventarios/MASTER_INVENTORY.yml | 6 +- .../PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md | 379 ++++++++++++++++++ 4 files changed, 636 insertions(+), 126 deletions(-) create mode 100644 orchestration/tareas/PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md diff --git a/docs/01-epicas/MCH-001-infraestructura-base.md b/docs/01-epicas/MCH-001-infraestructura-base.md index 106188bce..1a891ae68 100644 --- a/docs/01-epicas/MCH-001-infraestructura-base.md +++ b/docs/01-epicas/MCH-001-infraestructura-base.md @@ -6,9 +6,10 @@ code: MCH-001 status: Completado phase: 1 priority: P0 +story_points: 8 created_at: 2026-01-04 -updated_at: 2026-01-10 -simco_version: "3.8.0" +updated_at: 2026-01-17 +simco_version: "4.0.1" dependencies: blocks: ["MCH-002", "MCH-003", "MCH-010"] depends_on: [] @@ -21,6 +22,7 @@ dependencies: - **Fase:** 1 - MVP Core - **Prioridad:** P0 - **Estado:** Completado +- **Story Points:** 8 - **Fecha inicio:** 2026-01-04 - **Fecha fin:** 2026-01-05 @@ -101,13 +103,91 @@ michangarrito/ - **Base de datos:** michangarrito_platform - **Multi-tenant:** Via tenant_id + RLS -## Historias de Usuario Relacionadas +--- -| ID | Historia | Estado | -|----|----------|--------| -| US-001 | Como DevOps, quiero poder recrear la BD facilmente | Completado | -| US-002 | Como Dev, quiero estructura clara de proyecto | Completado | +## Historias de Usuario + +### MCH-US-001: Estructura Monorepo + +**Como** desarrollador +**Quiero** una estructura de proyecto monorepo bien organizada +**Para** poder trabajar eficientemente en multiples apps del mismo proyecto + +**Story Points:** 3 + +**Criterios de Aceptacion:** +- [CA-001-1] ✅ Carpeta apps/ con backend, web, mobile, mcp-server, whatsapp-service +- [CA-001-2] ✅ Carpeta database/ con schemas, seeds, scripts +- [CA-001-3] ✅ Carpeta docs/ con documentacion estructurada +- [CA-001-4] ✅ Carpeta orchestration/ con inventarios y trazas +- [CA-001-5] ✅ Archivo .env.example con variables requeridas + +**Tareas:** +| ID | Tarea | Tipo | Estado | +|----|-------|------|--------| +| MCH-TT-001-01 | Crear estructura de carpetas | Setup | Completado | +| MCH-TT-001-02 | Configurar .gitignore | Setup | Completado | +| MCH-TT-001-03 | Crear .env.example | Setup | Completado | --- -**Ultima actualizacion:** 2026-01-07 +### MCH-US-002: Base de Datos Multi-Tenant + +**Como** arquitecto +**Quiero** PostgreSQL configurado con multi-tenant via RLS +**Para** asegurar aislamiento de datos entre negocios + +**Story Points:** 3 + +**Criterios de Aceptacion:** +- [CA-002-1] ✅ PostgreSQL 16+ ejecutandose en puerto 5432 +- [CA-002-2] ✅ Extensiones uuid-ossp, pgcrypto habilitadas +- [CA-002-3] ✅ 11 schemas creados (public, auth, catalog, sales, etc.) +- [CA-002-4] ✅ RLS habilitado en tablas con tenant_id +- [CA-002-5] ✅ Funcion current_tenant_id() operativa + +**Tareas:** +| ID | Tarea | Tipo | Estado | +|----|-------|------|--------| +| MCH-TT-002-01 | DDL 00-extensions.sql | DDL | Completado | +| MCH-TT-002-02 | DDL 01-schemas.sql | DDL | Completado | +| MCH-TT-002-03 | DDL 02-functions.sql | DDL | Completado | +| MCH-TT-002-04 | DDL 03-public.sql (tenants) | DDL | Completado | + +--- + +### MCH-US-003: Scripts de Base de Datos + +**Como** DevOps +**Quiero** scripts para recrear la BD facilmente +**Para** poder resetear el ambiente de desarrollo rapidamente + +**Story Points:** 2 + +**Criterios de Aceptacion:** +- [CA-003-1] ✅ Script create-database.sh funcional +- [CA-003-2] ✅ Script recreate-database.sh funcional +- [CA-003-3] ✅ Scripts ejecutables desde cualquier directorio + +**Tareas:** +| ID | Tarea | Tipo | Estado | +|----|-------|------|--------| +| MCH-TT-003-01 | Crear script create-database.sh | DevOps | Completado | +| MCH-TT-003-02 | Crear script recreate-database.sh | DevOps | Completado | +| MCH-TT-003-03 | Documentar uso de scripts | Docs | Completado | + +--- + +## Resumen de Story Points + +| Historia | SP | Estado | +|----------|-----|--------| +| MCH-US-001: Estructura Monorepo | 3 | Completado | +| MCH-US-002: Base de Datos Multi-Tenant | 3 | Completado | +| MCH-US-003: Scripts de Base de Datos | 2 | Completado | +| **Total** | **8** | **100%** | + +--- + +**Ultima actualizacion:** 2026-01-17 +**Estandarizado por:** Validacion Documental MCH-DOC-VAL-2026-01-17 diff --git a/orchestration/_inheritance.yml b/orchestration/_inheritance.yml index 45fc7302b..855915790 100644 --- a/orchestration/_inheritance.yml +++ b/orchestration/_inheritance.yml @@ -1,33 +1,76 @@ -# ═══════════════════════════════════════════════════════════════════════════════ +# =============================================================================== # DECLARACION DE HERENCIA - MICHANGARRITO -# ═══════════════════════════════════════════════════════════════════════════════ +# =============================================================================== # # Proyecto: michangarrito -# Rol: POS simplificado para pequenos negocios -# Nivel: STANDALONE (Integra selectivamente de template-saas) -# Estado: PRODUCTION +# Descripcion: Plataforma POS inteligente multi-tenant para micro-negocios con +# asistente IA via WhatsApp, facturacion CFDI 4.0 y marketplace B2B +# Nivel: INTEGRATES (Integra selectivamente de template-saas) +# Estado: MVP 95% Completado # -# ═══════════════════════════════════════════════════════════════════════════════ +# =============================================================================== -version: "1.0.0" +version: "2.0.0" created: "2026-01-16" -updated: "2026-01-16" +updated: "2026-01-17" proyecto: "michangarrito" +updated_by: "Agente Orquestador - Validacion Documental" -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- # RELACION DE HERENCIA -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- herencia: parent: "template-saas" parent_version: "1.2.1" tipo: "INTEGRATES" cadena: "template-saas -> michangarrito" - descripcion: "Integracion selectiva de modulos SaaS para POS" + descripcion: "Integracion selectiva de capacidades SaaS para POS inteligente" -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- +# STACK TECNOLOGICO (CORREGIDO) +# ----------------------------------------------------------------------------- + +configuracion: + stack: + backend: "NestJS 10.3.0, TypeScript, TypeORM" + frontend: "React 19.2.0, Vite 7.2.4, Tailwind CSS" + mobile: "React Native, Expo SDK" + database: "PostgreSQL 16+" + cache: "Redis 7" + mcp_server: "TypeScript, MCP SDK" + whatsapp_service: "NestJS, Meta Cloud API" + + puertos: + backend: 3141 + frontend: 3140 + mobile: 8081 + mcp_server: 3142 + whatsapp_service: 3143 + postgres: 5432 + redis: 6379 + + schemas_bd: + - "public" + - "auth" + - "catalog" + - "sales" + - "inventory" + - "customers" + - "orders" + - "subscriptions" + - "messaging" + - "billing" + - "marketplace" + + deployment: + tipo: "Docker Compose / Cloud" + region: "LATAM (Mexico)" + escala: "Micro-negocios (tiendas de abarrotes, fondas, puestos)" + +# ----------------------------------------------------------------------------- # MODULOS INTEGRADOS DE TEMPLATE-SAAS -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- modulos: integrados: @@ -35,164 +78,172 @@ modulos: id_origen: "SAAS-001" version: "1.0.0" status: "active" - descripcion: "Autenticacion simplificada" - adaptacion: "Sin MFA, login basico" + descripcion: "Autenticacion OTP + JWT + PIN + Biometrico" + adaptacion: "Multiples metodos de auth para usuarios moviles" - name: "tenants" id_origen: "SAAS-002" version: "1.0.0" status: "active" - descripcion: "Multi-tenancy para negocios" - adaptacion: "Cada negocio = 1 tenant" + descripcion: "Multi-tenancy con RLS" + adaptacion: "Cada negocio = 1 tenant con configuracion propia" - name: "billing" id_origen: "SAAS-004" version: "1.0.0" status: "active" - descripcion: "Suscripciones" - adaptacion: "Planes simplificados: Free, Pro" + descripcion: "Suscripciones y tokens IA" + adaptacion: "Plan Changarrito ($99), Plan Tiendita ($199), paquetes tokens" - name: "notifications" id_origen: "SAAS-007" version: "1.0.0" status: "active" - descripcion: "Notificaciones basicas" - adaptacion: "Solo email y push" + descripcion: "Notificaciones multi-canal" + adaptacion: "Push, WhatsApp, Email" - excluidos: - - name: "ai-integration" - razon: "No requerido para POS simple" - - name: "whatsapp" - razon: "No aplica" - - name: "oauth" - razon: "No se requiere login social" - - name: "webhooks" - razon: "No hay integraciones externas" + - name: "email-providers" + id_origen: "SAAS-010" + version: "1.0.0" + status: "planificado" + descripcion: "Email multi-proveedor" + adaptacion: "SendGrid/SES/SMTP con fallback" - # Modulos propios de michangarrito + - name: "storage-cloud" + id_origen: "SAAS-011" + version: "1.0.0" + status: "planificado" + descripcion: "Almacenamiento cloud" + adaptacion: "S3/R2/MinIO para imagenes productos" + + - name: "oauth-social" + id_origen: "SAAS-012" + version: "1.0.0" + status: "planificado" + descripcion: "OAuth Google/Apple" + adaptacion: "Login social opcional" + + - name: "redis-cache" + id_origen: "SAAS-013" + version: "1.0.0" + status: "planificado" + descripcion: "Cache y queues" + adaptacion: "BullMQ para webhooks" + + - name: "webhooks-outbound" + id_origen: "SAAS-014" + version: "1.0.0" + status: "planificado" + descripcion: "Eventos salientes" + adaptacion: "Integraciones con terceros" + + # Modulos PROPIOS de michangarrito (epicas principales) propios: - - name: "pos" + - name: "infraestructura-base" id: "MCH-001" - version: "1.0.0" - estado: "100%" - descripcion: "Punto de Venta principal" - features: - - "Venta rapida" - - "Escaneo de codigo de barras" - - "Calculadora de cambio" - - "Recibos digitales" + estado: "completado" + descripcion: "Monorepo, PostgreSQL multi-tenant, CI/CD" - - name: "inventario-simple" + - name: "autenticacion" id: "MCH-002" - version: "1.0.0" - estado: "100%" - descripcion: "Inventario basico" - features: - - "Alta de productos" - - "Control de stock" - - "Alertas de reorden" + estado: "completado" + descripcion: "OTP, JWT, PIN, Biometrico" - - name: "clientes" + - name: "catalogo-productos" id: "MCH-003" - version: "1.0.0" - estado: "100%" - descripcion: "Gestion de clientes" - features: - - "Registro rapido" - - "Historial de compras" - - "Creditos simples" + estado: "completado" + descripcion: "CRUD productos, categorias, templates 75 productos" - - name: "reportes-ventas" + - name: "punto-venta" id: "MCH-004" - version: "1.0.0" - estado: "100%" - descripcion: "Reportes de ventas" - features: - - "Ventas del dia" - - "Ventas por periodo" - - "Productos mas vendidos" + estado: "completado" + descripcion: "Registro ventas, carrito, ticket, calculadora cambio" - - name: "caja" + - name: "integraciones-pago" id: "MCH-005" - version: "1.0.0" - estado: "100%" - descripcion: "Control de caja" - features: - - "Apertura/cierre de caja" - - "Corte de caja" - - "Movimientos de efectivo" + estado: "completado" + descripcion: "Stripe, MercadoPago (pendiente), Clip (mock), CoDi (mock)" - - name: "gastos" + - name: "onboarding-inteligente" id: "MCH-006" - version: "1.0.0" - estado: "100%" - descripcion: "Registro de gastos" - features: - - "Gastos por categoria" - - "Comprobantes" + estado: "completado" + descripcion: "Setup via WhatsApp, fotos, audio" -# ───────────────────────────────────────────────────────────────────────────────── -# CONFIGURACION -# ───────────────────────────────────────────────────────────────────────────────── + - name: "mcp-server" + id: "MCH-010" + estado: "completado" + descripcion: "Gateway LLM agnostico con 15 herramientas" -configuracion: - stack: - backend: "Node.js, Express, TypeScript" - frontend: "React 18, Vite, Tailwind CSS" - database: "PostgreSQL" - mobile: "PWA (Progressive Web App)" + - name: "whatsapp-service" + id: "MCH-011" + estado: "completado" + descripcion: "Meta Cloud API, webhooks, multi-tenant" - schemas: - - "pos_core" - - "pos_inventory" - - "pos_sales" + - name: "planes-suscripciones" + id: "MCH-018" + estado: "completado" + descripcion: "Changarrito/Tiendita con tokens IA" - deployment: - tipo: "Cloud" - region: "LATAM" - escala: "Pequenos negocios" + - name: "modo-offline" + id: "MCH-022" + estado: "completado" + descripcion: "SQLite, sync, conflictos" -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- # CONSUMIDORES -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- consumidores: # michangarrito es aplicacion final, no tiene consumidores proyectos: [] -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- # VALIDACION -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- validacion: - ultima_validacion: "2026-01-16" - estado_general: "production" - completitud: "100%" + ultima_validacion: "2026-01-17" + estado_general: "MVP 95%" + completitud: "95%" checklist: - - item: "POS operativo" + - item: "Backend NestJS operativo" status: "passed" - - item: "Inventario funcional" + - item: "Frontend React operativo" status: "passed" - - item: "Reportes disponibles" + - item: "Mobile Expo operativo" status: "passed" - - item: "En produccion" + - item: "WhatsApp Service operativo" status: "passed" + - item: "MCP Server operativo" + status: "passed" + - item: "Multi-tenant con RLS" + status: "passed" + - item: "Integraciones LLM multi-tenant" + status: "passed" + - item: "Configuracion produccion" + status: "pending" - bloqueos: [] # Proyecto completado + bloqueos: + - "Cuenta Meta Business verificada (requerida para WhatsApp)" + - "API keys Stripe produccion" + - "API keys LLM produccion" -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- # METADATA -# ───────────────────────────────────────────────────────────────────────────────── +# ----------------------------------------------------------------------------- metadata: created_by: "Claude Opus 4.5" created_at: "2026-01-16" - task_id: "TASK-2026-01-16-002" + updated_by: "Agente Orquestador - Validacion Documental" + updated_at: "2026-01-17" + task_id: "MCH-DOC-VAL-2026-01-17" related_documents: - - "orchestration/DEPENDENCY-GRAPH.yml" - - "orchestration/TRACEABILITY.yml" + - "orchestration/MAPA-DOCUMENTACION.yml" + - "orchestration/inventarios/MASTER_INVENTORY.yml" + - "docs/_definitions/_INDEX.yml" -# ═══════════════════════════════════════════════════════════════════════════════ +# =============================================================================== # FIN DE DECLARACION DE HERENCIA -# ═══════════════════════════════════════════════════════════════════════════════ +# =============================================================================== diff --git a/orchestration/inventarios/MASTER_INVENTORY.yml b/orchestration/inventarios/MASTER_INVENTORY.yml index 1f47ac69f..ebfafb02b 100644 --- a/orchestration/inventarios/MASTER_INVENTORY.yml +++ b/orchestration/inventarios/MASTER_INVENTORY.yml @@ -27,7 +27,7 @@ resumen: database: schemas: 11 - tablas: 53 + tablas: 47 # Sincronizado con DATABASE_INVENTORY.yml funciones: 15 triggers: 22 extensiones: 4 @@ -36,9 +36,9 @@ resumen: backend: modulos: 17 - controllers: 25 + controllers: 20 # Sincronizado con BACKEND_INVENTORY.yml endpoints: 195 - entities: 42 + entities: 37 # Sincronizado con BACKEND_INVENTORY.yml frontend: paginas: 12 diff --git a/orchestration/tareas/PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md b/orchestration/tareas/PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md new file mode 100644 index 000000000..cbf82d594 --- /dev/null +++ b/orchestration/tareas/PLAN-VALIDACION-DOCUMENTAL-2026-01-17.md @@ -0,0 +1,379 @@ +# PLAN DE VALIDACION DOCUMENTAL - MICHANGARRITO + +**ID:** MCH-DOC-VAL-2026-01-17 +**Tipo:** Validacion y Mejora Documental +**Fecha:** 2026-01-17 +**Autor:** Agente Orquestador +**Estado:** En Revision +**Ciclo:** CAPVED + +--- + +## 1. RESUMEN EJECUTIVO + +### Analisis Realizado +Se realizo un analisis exhaustivo de la documentacion del proyecto michangarrito, cubriendo: +- 35 epicas (MCH-001 a MCH-035) +- 4 catalogos de definiciones +- 5 inventarios de orquestacion +- 14 integraciones externas +- 11 ADRs + +### Estado Global + +| Area | Calificacion | Estado | +|------|--------------|--------| +| Estructura de Epicas | 70% | Requiere estandarizacion | +| Definiciones Tecnicas | 40% | Gaps criticos | +| Inventarios | 75% | Inconsistencias de conteos | +| Integraciones | 88% | Excelente | +| ADRs | 90% | Excelente | +| Trazabilidad | 50% | Incompleta | + +### Conclusion +**Estado: PARCIALMENTE VALIDO - REQUIERE CORRECCIONES** + +--- + +## 2. GAPS IDENTIFICADOS (PRIORIZADOS) + +### P0 - CRITICOS (Bloquean implementacion) + +| ID | Gap | Area | Descripcion | Impacto | +|----|-----|------|-------------|---------| +| GAP-001 | HU sin formato estandar | Epicas | MCH-001 a MCH-027 no tienen HU formales (MCH-US-XXX) ni Story Points | Planificacion imposible | +| GAP-002 | Metodos de services no documentados | Definiciones | SERVICES-CATALOG.md no especifica metodos, parametros ni retornos | Backend devs sin referencia | +| GAP-003 | Conteo de tablas inconsistente | Inventarios | MASTER: 53 vs DATABASE: 47 tablas | Incertidumbre de alcance | +| GAP-004 | Propiedades de entities no documentadas | Definiciones | ENTITIES-CATALOG.md no lista campos de cada entity | Backend devs sin referencia | + +### P1 - ALTOS (Impactan integridad) + +| ID | Gap | Area | Descripcion | Impacto | +|----|-----|------|-------------|---------| +| GAP-005 | DATABASE-SCHEMA incompleto | Definiciones | Solo 4 de 47 tablas detalladas con columnas | DDL manual | +| GAP-006 | Trazas desactualizadas | Trazabilidad | TRAZA-BACKEND 2026-01-07, TRAZA-FRONTEND incompleta | Estado desconocido | +| GAP-007 | Herencia framework conflictiva | Integracion WS | _inheritance.yml dice Express, inventarios dicen NestJS | Confusion arquitectural | +| GAP-008 | Controllers no documentados | Definiciones | 20 controllers sin documentacion (65 DTOs tampoco) | Frontend devs sin referencia | + +### P2 - MEDIOS (Impactan mantenibilidad) + +| ID | Gap | Area | Descripcion | Impacto | +|----|-----|------|-------------|---------| +| GAP-009 | Falta EPICTRACES.yml | Trazabilidad | No existe mapeo Epica → Tarea → Objeto | Rastreo imposible | +| GAP-010 | Carpeta tareas/ no existe | Gobernanza | Obligatoria por CLAUDE.md Regla 7 | Gobernanza incompleta | +| GAP-011 | Story Points faltantes | Epicas | MCH-001 a MCH-027 sin SP | Estimacion imposible | +| GAP-012 | Estado de entregables inconsistente | Epicas | Algunos con estado, otros sin | Tracking incompleto | + +### P3 - BAJOS (Mejoras deseables) + +| ID | Gap | Area | Descripcion | +|----|-----|------|-------------| +| GAP-013 | Integraciones mock sin clarificar | Integraciones | INT-005, INT-006 estado ambiguo | +| GAP-014 | Metricas de exito faltantes | Epicas | Solo MCH-006, MCH-029 las tienen | +| GAP-015 | ADRs no vinculados a epicas | Trazabilidad | Epicas tempranas sin ref a ADRs | + +--- + +## 3. PLAN DE TAREAS + +### Estructura de Ejecucion + +``` +VALIDACION-DOCUMENTAL-MCH +│ +├── TAREA-001: Estandarizar Epicas (P0) +│ ├── 001-A: Agregar HU formales a MCH-001 a MCH-027 +│ ├── 001-B: Agregar Story Points a todas las epicas +│ └── 001-C: Estandarizar estado de entregables +│ +├── TAREA-002: Completar Definiciones (P0) +│ ├── 002-A: Documentar metodos de services +│ ├── 002-B: Documentar propiedades de entities +│ ├── 002-C: Completar DATABASE-SCHEMA +│ └── 002-D: Documentar Controllers y DTOs +│ +├── TAREA-003: Sincronizar Inventarios (P1) +│ ├── 003-A: Auditoria de tablas reales vs documentadas +│ ├── 003-B: Sincronizar conteos en todos los inventarios +│ └── 003-C: Corregir herencia framework +│ +├── TAREA-004: Completar Trazabilidad (P1) +│ ├── 004-A: Actualizar TRAZA-TAREAS-BACKEND +│ ├── 004-B: Completar TRAZA-TAREAS-FRONTEND +│ ├── 004-C: Crear EPICTRACES.yml +│ └── 004-D: Crear estructura tareas/ +│ +├── TAREA-005: Mejorar Integraciones (P2) +│ ├── 005-A: Completar INT-004 (MercadoPago) +│ └── 005-B: Clarificar estado de INT-005, INT-006 +│ +└── TAREA-006: Integracion Workspace (P2) + ├── 006-A: Actualizar trazabilidad bidireccional + └── 006-B: Registrar en TRACEABILITY-MASTER del workspace +``` + +--- + +## 4. DETALLE DE TAREAS + +### TAREA-001: Estandarizar Epicas + +**Objetivo:** Normalizar todas las epicas al formato MCH-029/MCH-032 + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 001-A | Agregar HU formales (MCH-US-XXX) | 27 epicas (MCH-001 a MCH-027) | Alto | +| 001-B | Agregar Story Points totales | 27 epicas | Medio | +| 001-C | Estandarizar estado entregables | 35 epicas | Bajo | + +**Criterios de Aceptacion:** +- [ ] Todas las epicas tienen seccion "Historias de Usuario" con formato MCH-US-XXX +- [ ] Todas las HU tienen: AS/WANT/FOR, Story Points, Criterios de Aceptacion +- [ ] Todas las epicas tienen Story Points totales en frontmatter +- [ ] Todos los entregables tienen estado (Completado/En Progreso/Pendiente) + +**Dependencias:** Ninguna (puede ejecutarse en paralelo) + +--- + +### TAREA-002: Completar Definiciones + +**Objetivo:** Documentar especificaciones tecnicas para implementadores + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 002-A | Documentar metodos de services | SERVICES-CATALOG.md | Alto | +| 002-B | Documentar propiedades de entities | ENTITIES-CATALOG.md | Alto | +| 002-C | Completar tablas en DATABASE-SCHEMA | DATABASE-SCHEMA.md | Alto | +| 002-D | Crear CONTROLLERS-CATALOG.md, DTOS-CATALOG.md | Nuevos archivos | Alto | + +**Criterios de Aceptacion:** +- [ ] Cada service tiene lista de metodos con parametros y retornos +- [ ] Cada entity tiene lista de propiedades con tipos +- [ ] DATABASE-SCHEMA tiene todas las 47+ tablas con columnas +- [ ] Controllers documentados con endpoints +- [ ] DTOs documentados con validaciones + +**Dependencias:** +- 002-C depende de TAREA-003-A (auditoria de tablas) + +--- + +### TAREA-003: Sincronizar Inventarios + +**Objetivo:** Resolver inconsistencias de conteos entre inventarios + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 003-A | Auditoria de tablas reales | Scripts SQL, inventarios | Medio | +| 003-B | Sincronizar conteos | 5 inventarios | Medio | +| 003-C | Corregir herencia framework | _inheritance.yml | Bajo | + +**Criterios de Aceptacion:** +- [ ] Conteo de tablas coincide en MASTER y DATABASE inventarios +- [ ] Conteo de entities coincide en MASTER y BACKEND inventarios +- [ ] _inheritance.yml refleja NestJS (no Express) +- [ ] Fechas de actualizacion sincronizadas + +**Dependencias:** Ninguna + +--- + +### TAREA-004: Completar Trazabilidad + +**Objetivo:** Establecer trazabilidad completa Epica → Tarea → Objeto + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 004-A | Actualizar TRAZA-BACKEND | TRAZA-TAREAS-BACKEND.md | Medio | +| 004-B | Completar TRAZA-FRONTEND | TRAZA-TAREAS-FRONTEND.md | Medio | +| 004-C | Crear EPICTRACES.yml | Nuevo archivo | Alto | +| 004-D | Crear estructura tareas/ | orchestration/tareas/ | Bajo | + +**Criterios de Aceptacion:** +- [ ] Trazas actualizadas a fecha actual +- [ ] Estados consistentes con inventarios +- [ ] EPICTRACES.yml mapea cada MCH-XXX a sus tareas y objetos +- [ ] Carpeta tareas/ existe con estructura SIMCO + +**Dependencias:** +- 004-C depende de TAREA-001 (para tener HU definidas) + +--- + +### TAREA-005: Mejorar Integraciones + +**Objetivo:** Completar documentacion de integraciones pendientes + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 005-A | Completar INT-004 | INT-004-mercadopago.md | Medio | +| 005-B | Clarificar INT-005, INT-006 | INT-005-clip.md, INT-006-codi-banxico.md | Bajo | + +**Criterios de Aceptacion:** +- [ ] INT-004 tiene checklist de implementacion completo +- [ ] INT-004 tiene ejemplos de flujo de pago +- [ ] INT-005, INT-006 tienen estado clarificado (Mock/Future/Deprecated) + +**Dependencias:** Ninguna + +--- + +### TAREA-006: Integracion Workspace + +**Objetivo:** Establecer trazabilidad con workspace padre + +**Subtareas:** + +| ID | Subtarea | Archivos | Estimacion | +|----|----------|----------|------------| +| 006-A | Actualizar trazabilidad bidireccional | WS-REFERENCES.yml | Bajo | +| 006-B | Registrar en TRACEABILITY-MASTER | orchestration/TRACEABILITY-MASTER.yml (workspace) | Bajo | + +**Criterios de Aceptacion:** +- [ ] Workspace tiene entrada para michangarrito en TRACEABILITY-MASTER +- [ ] Michangarrito referencia correctamente directivas del workspace + +**Dependencias:** +- Depende de TAREA-003 (inventarios sincronizados) + +--- + +## 5. ORDEN DE EJECUCION RECOMENDADO + +``` + PARALELO SECUENCIAL + ──────── ────────── + +┌─────────────────────────┐ ┌─────────────────────────┐ +│ TAREA-003: Inventarios │───►│ TAREA-002-C: DB Schema │ +│ (Auditoria primero) │ │ (Requiere conteo real) │ +└─────────────────────────┘ └─────────────────────────┘ + │ +┌─────────────────────────┐ ▼ +│ TAREA-001: Epicas │ ┌─────────────────────────┐ +│ (Estandarizacion) │───►│ TAREA-004-C: EPICTRACES │ +└─────────────────────────┘ │ (Requiere HU definidas) │ + └─────────────────────────┘ +┌─────────────────────────┐ │ +│ TAREA-002-A,B,D: │ ▼ +│ Services, Entities │ ┌─────────────────────────┐ +│ Controllers, DTOs │ │ TAREA-006: Workspace │ +└─────────────────────────┘ │ (Al final) │ + └─────────────────────────┘ +┌─────────────────────────┐ +│ TAREA-005: Integraciones│ +│ (Independiente) │ +└─────────────────────────┘ +``` + +### Fases Recomendadas + +**Fase 1 (Paralelo):** TAREA-001, TAREA-003, TAREA-005 +**Fase 2 (Secuencial):** TAREA-002-C (tras 003), TAREA-004-C (tras 001) +**Fase 3 (Paralelo):** TAREA-002-A,B,D, TAREA-004-A,B,D +**Fase 4 (Final):** TAREA-006 + +--- + +## 6. PERFILES DE AGENTES RECOMENDADOS + +| Tarea | Perfil | Alias | +|-------|--------|-------| +| TAREA-001 | Requirements Analyst | @PERFIL_REQUIREMENTS | +| TAREA-002-A,B,D | Backend Developer | @PERFIL_BACKEND | +| TAREA-002-C | Database Specialist | @PERFIL_DATABASE | +| TAREA-003 | Architecture Analyst | @PERFIL_ARCHITECT | +| TAREA-004 | Documentation | @PERFIL_DOCS | +| TAREA-005 | Backend Developer | @PERFIL_BACKEND | +| TAREA-006 | KB Manager | @PERFIL_KB_MANAGER | + +--- + +## 7. METRICAS DE EXITO + +### Al Completar Todas las Tareas + +| Metrica | Antes | Despues | +|---------|-------|---------| +| Epicas con HU formales | 8/35 (23%) | 35/35 (100%) | +| Epicas con Story Points | 8/35 (23%) | 35/35 (100%) | +| Entities documentadas | 25/37 (68%) | 37/37 (100%) | +| Services con metodos | 0/22 (0%) | 22/22 (100%) | +| Tablas en DB-SCHEMA | 4/47 (9%) | 47/47 (100%) | +| Inventarios coherentes | 75% | 100% | +| Trazas actualizadas | 50% | 100% | +| Integracion Workspace | 80% | 100% | + +--- + +## 8. REFERENCIAS + +- [CLAUDE.md](../../../../CLAUDE.md) - Reglas de gobernanza +- [PRINCIPIO-CAPVED.md](../../../../orchestration/directivas/principios/PRINCIPIO-CAPVED.md) - Ciclo de vida +- [_MAP.md](../../docs/_MAP.md) - Mapa de documentacion +- [MAPA-DOCUMENTACION.yml](../MAPA-DOCUMENTACION.yml) - Mapa de orquestacion + +--- + +**Estado:** EN PROGRESO +**Siguiente Paso:** Continuar con tareas pendientes + +--- + +## 9. REGISTRO DE EJECUCION + +### Tareas Completadas + +| Tarea | Subtarea | Estado | Archivos Modificados | +|-------|----------|--------|----------------------| +| TAREA-003 | 003-A: Auditoria tablas | Completado | - | +| TAREA-003 | 003-B: Sincronizar conteos | Completado | MASTER_INVENTORY.yml | +| TAREA-003 | 003-C: Corregir herencia | Completado | _inheritance.yml | +| TAREA-001 | MCH-001 estandarizada | Completado | MCH-001-infraestructura-base.md | + +### Cambios Aplicados + +1. **MASTER_INVENTORY.yml:** + - Corregido conteo tablas: 53 → 47 + - Corregido conteo controllers: 25 → 20 + - Corregido conteo entities: 42 → 37 + +2. **_inheritance.yml:** + - Corregido stack: Express → NestJS 10.3.0 + - Corregido frontend: React 18 → React 19.2.0 + - Corregidos schemas BD: pos_* → public, auth, catalog, etc. + - Corregidos modulos propios con IDs MCH-XXX correctos + - Agregados modulos SaaS integrados + +3. **MCH-001-infraestructura-base.md:** + - Agregado story_points: 8 al frontmatter + - Actualizado simco_version: 3.8.0 → 4.0.1 + - Agregadas 3 HU formales con formato MCH-US-XXX + - Agregados criterios de aceptacion con formato [CA-XXX-N] + - Agregadas tareas con formato MCH-TT-XXX-NN + - Agregado resumen de Story Points + +### Tareas Pendientes + +| Tarea | Subtareas | Archivos Pendientes | +|-------|-----------|---------------------| +| TAREA-001 | 26 epicas mas | MCH-002 a MCH-028 | +| TAREA-002 | A,B,C,D | SERVICES, ENTITIES, DATABASE-SCHEMA, CONTROLLERS | +| TAREA-004 | A,B,C,D | Trazas, EPICTRACES.yml, tareas/ | +| TAREA-005 | A,B | INT-004, INT-005, INT-006 | +| TAREA-006 | A,B | Workspace TRACEABILITY-MASTER | + +### Fecha Registro +- **Fecha:** 2026-01-17 +- **Agente:** Orquestador - Validacion Documental