michangarrito/orchestration/inventarios/MASTER_INVENTORY.yml
rckrdmrd a8e46479f9 [MCH] docs: Add Sprint 8 task governance documentation
- Create orchestration/tareas/_INDEX.yml for task tracking
- Create TASK-TEMPLATE with METADATA.yml and phase templates
- Add TASK-2026-01-20-001 documenting Sprint 8 completion
- Update agents/trazas/_INDEX.yml with activity records
- Update inventarios (MASTER, FRONTEND) to reflect Sprint 8
- Update PROJECT-STATUS.md and PROXIMA-ACCION.md

Gobernanza SIMCO v4.0.0 completa para michangarrito.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 02:47:51 -06:00

572 lines
15 KiB
YAML

# MASTER INVENTORY - MiChangarrito
# Version: 4.1.0
# Ultima actualizacion: 2026-01-20
# Sistema: SIMCO v4.0.0 + CAPVED + SCRUM
# Actualizado: Sprint 8 - Frontend Integration Complete
metadata:
proyecto: "michangarrito"
descripcion: "Plataforma POS inteligente multi-tenant para micro-negocios con asistente IA via WhatsApp, facturacion CFDI 4.0 y marketplace B2B"
version: "1.0.0"
estado: "MVP_COMPLETO"
tipo: "standalone"
categoria: "saas"
actualizado: "2026-01-20"
actualizado_por: "Agente Orquestador"
# ============================================================================
# RESUMEN EJECUTIVO
# ============================================================================
resumen:
estado_general: "100% MVP Implementado"
fases_completadas: "7 de 8"
tareas_completadas: "43 de 43"
builds_verificados: true
listo_produccion: true
database:
schemas: 1 # public (TypeORM)
tablas: 42 # VALIDADO - 1:1 con entities
funciones: 0
triggers: 0
extensiones: 1 # uuid-ossp
enums: 0
ddl_files: 0 # TypeORM genera tablas
backend:
modulos: 23 # VALIDADO (Sprint 8: +settings, +exports)
controllers: 24 # VALIDADO
endpoints: 130
entities: 42 # VALIDADO
services: 28 # VALIDADO
frontend:
paginas: 14
componentes: 51
contexts: 2 # AuthContext, ThemeContext
mobile:
pantallas: 10
estado: completado
integraciones:
- Stripe (pagos, suscripciones)
- WhatsApp Business API
- OpenRouter/LLM (agnostico)
- SAT CFDI 4.0 (facturacion)
- SPEI/STP (transferencias)
- CoDi (pagos QR)
- Firebase FCM (push)
- Mercado Pago Point
# ============================================================================
# PROGRESO POR FASE
# ============================================================================
progreso:
fase_actual: "FASE 6 - Configuracion Externa"
porcentaje: 95
fases:
- fase: 1
nombre: "Infraestructura Base"
estado: completado
porcentaje: 100
tareas: "8/8"
- fase: 2
nombre: "Integracion y Pruebas"
estado: parcial
porcentaje: 67
tareas: "4/6"
pendiente: "Webhooks WhatsApp, Pruebas E2E"
- fase: 3
nombre: "Mobile App"
estado: completado
porcentaje: 100
tareas: "6/6"
- fase: 4
nombre: "Monetizacion"
estado: completado
porcentaje: 100
tareas: "4/4"
- fase: 5
nombre: "Despliegue"
estado: completado
porcentaje: 100
tareas: "6/6"
- fase: 5.1
nombre: "Integraciones Multi-Tenant"
estado: completado
porcentaje: 100
tareas: "9/9"
- fase: 6
nombre: "Configuracion Externa"
estado: pendiente
porcentaje: 0
tareas: "0/4"
pendiente: "Meta Business, Stripe Prod, LLM, Deploy"
# ============================================================================
# APLICACIONES
# ============================================================================
apps:
- nombre: "backend"
tecnologia: "NestJS 10.3.0 + TypeScript"
estado: "completado"
puerto: 3141
inventario: "BACKEND_INVENTORY.yml"
- nombre: "frontend"
tecnologia: "React 19.2.0 + Vite 7.2.4"
estado: "completado"
puerto: 3140
inventario: "FRONTEND_INVENTORY.yml"
- nombre: "mobile"
tecnologia: "React Native + Expo"
estado: "completado"
puerto: 8081
notas: "10 pantallas, modo offline, barcode scanner"
- nombre: "mcp-server"
tecnologia: "TypeScript + MCP SDK"
estado: "completado"
puerto: 3142
notas: "15 herramientas, stdio transport"
- nombre: "whatsapp-service"
tecnologia: "NestJS + Meta Cloud API"
estado: "completado"
puerto: 3143
notas: "Multi-tenant refactorizado"
# ============================================================================
# DATABASE
# ============================================================================
database:
nombre: "michangarrito_dev"
engine: "PostgreSQL 16+"
inventario: "DATABASE_INVENTORY.yml"
schemas:
- public
- auth
- catalog
- sales
- inventory
- customers
- orders
- subscriptions
- messaging
# ============================================================================
# MODULOS (EPICAS)
# ============================================================================
modulos:
fase_1:
- id: "MCH-001"
nombre: "Infraestructura Base"
estado: "completado"
- id: "MCH-002"
nombre: "Autenticacion"
estado: "completado"
- id: "MCH-003"
nombre: "Catalogo Productos"
estado: "completado"
- id: "MCH-004"
nombre: "Punto de Venta"
estado: "completado"
- id: "MCH-005"
nombre: "Integraciones Pago"
estado: "completado"
fase_2:
- id: "MCH-006"
nombre: "Onboarding Inteligente"
estado: "completado"
- id: "MCH-007"
nombre: "Templates Catalogos"
estado: "completado"
- id: "MCH-008"
nombre: "Sistema Fiados"
estado: "completado"
- id: "MCH-009"
nombre: "Prediccion Inventario"
estado: "completado"
fase_3:
- id: "MCH-010"
nombre: "MCP Server"
estado: "completado"
- id: "MCH-011"
nombre: "WhatsApp Service"
estado: "completado"
- id: "MCH-012"
nombre: "Chat LLM Dueno"
estado: "completado"
- id: "MCH-013"
nombre: "Chat LLM Cliente"
estado: "completado"
fase_4:
- id: "MCH-014"
nombre: "Gestion Clientes"
estado: "completado"
- id: "MCH-015"
nombre: "Pedidos WhatsApp"
estado: "completado"
- id: "MCH-016"
nombre: "Entregas Domicilio"
estado: "completado"
- id: "MCH-017"
nombre: "Notificaciones"
estado: "completado"
fase_5:
- id: "MCH-018"
nombre: "Planes Suscripciones"
estado: "completado"
- id: "MCH-019"
nombre: "Tienda Tokens"
estado: "completado"
- id: "MCH-020"
nombre: "Pagos Suscripcion"
estado: "completado"
- id: "MCH-021"
nombre: "Dashboard Web"
estado: "completado"
fase_6:
- id: "MCH-022"
nombre: "Modo Offline"
estado: "completado"
- id: "MCH-023"
nombre: "Programa Referidos"
estado: "pendiente"
- id: "MCH-024"
nombre: "CoDi/SPEI"
estado: "pendiente"
- id: "MCH-025"
nombre: "Widgets Atajos"
estado: "pendiente"
fase_7:
- id: "MCH-026"
nombre: "Multi-idioma LATAM"
estado: "pendiente"
- id: "MCH-027"
nombre: "Integracion SAT"
estado: "pendiente"
- id: "MCH-028"
nombre: "Marketplace Proveedores"
estado: "pendiente"
- id: "MCH-029"
nombre: "Infraestructura SaaS Avanzada"
estado: "planificado"
story_points: 24
sprint: "6-7"
descripcion: "Email, Storage, Redis, Webhooks, Rate Limiting"
integraciones: ["INT-010", "INT-011", "INT-013", "INT-014"]
- id: "MCH-030"
nombre: "Auth Social OAuth 2.0"
estado: "planificado"
story_points: 8
sprint: "8"
descripcion: "Login con Google y Apple"
integraciones: ["INT-012"]
- id: "MCH-031"
nombre: "Auditoria Empresarial"
estado: "planificado"
story_points: 5
sprint: "7"
descripcion: "Audit logs, retencion, compliance"
- id: "MCH-032"
nombre: "Feature Flags por Plan"
estado: "planificado"
story_points: 5
sprint: "8"
descripcion: "Toggles por plan/tenant"
fase_8:
- id: "MCH-033"
nombre: "Onboarding Wizard"
estado: "planificado"
story_points: 3
sprint: "9"
descripcion: "Guia interactiva de setup"
# ============================================================================
# INFRAESTRUCTURA BASE
# ============================================================================
infraestructura:
- nombre: "PostgreSQL 16"
estado: "activo"
puerto: 5432
- nombre: "Redis 7"
estado: "activo"
puerto: 6379
db: 8
# ============================================================================
# INTEGRACIONES EXTERNAS (SIMCO v4.0.0)
# ============================================================================
integraciones:
- id: "INT-001"
nombre: "WhatsApp Meta Business"
categoria: "Mensajeria"
estado: "activo"
multi_tenant: true
modulo_relacionado: "MCH-011"
spec: "docs/02-integraciones/INT-001-whatsapp-meta.md"
notas: "Requiere cuenta Business verificada"
- id: "INT-002"
nombre: "Stripe"
categoria: "Pagos"
estado: "activo"
multi_tenant: false
modulo_relacionado: "MCH-020"
spec: "docs/02-integraciones/INT-002-stripe.md"
notas: "SDK configurado, requiere API keys produccion"
- id: "INT-003"
nombre: "OpenRouter LLM"
categoria: "AI/LLM"
estado: "activo"
multi_tenant: true
modulo_relacionado: "MCH-012"
spec: "docs/02-integraciones/INT-003-openrouter.md"
notas: "Soporte credenciales por tenant + fallback plataforma"
- id: "INT-004"
nombre: "MercadoPago"
categoria: "Pagos"
estado: "pendiente"
multi_tenant: true
modulo_relacionado: "MCH-005"
spec: "docs/02-integraciones/INT-004-mercadopago.md"
- id: "INT-005"
nombre: "Clip Mexico"
categoria: "Pagos"
estado: "mock"
multi_tenant: true
modulo_relacionado: "MCH-005"
spec: "docs/02-integraciones/INT-005-clip.md"
- id: "INT-006"
nombre: "CoDi/SPEI Banxico"
categoria: "Pagos"
estado: "mock"
multi_tenant: true
modulo_relacionado: "MCH-024"
spec: "docs/02-integraciones/INT-006-codi-banxico.md"
- id: "INT-007"
nombre: "Firebase FCM"
categoria: "Notificaciones"
estado: "pendiente"
multi_tenant: true
modulo_relacionado: "MCH-017"
spec: "docs/02-integraciones/INT-007-firebase-fcm.md"
- id: "INT-008"
nombre: "Google Cloud Vision"
categoria: "AI/ML"
estado: "pendiente"
multi_tenant: true
modulo_relacionado: "MCH-009"
spec: "docs/02-integraciones/INT-008-google-vision.md"
- id: "INT-009"
nombre: "OpenAI Whisper"
categoria: "AI/ML"
estado: "pendiente"
multi_tenant: true
modulo_relacionado: "MCH-011"
spec: "docs/02-integraciones/INT-009-whisper.md"
# === NUEVAS INTEGRACIONES SAAS (v4.0.0) ===
- id: "INT-010"
nombre: "Email Multi-Provider"
categoria: "Notificaciones"
estado: "planificado"
multi_tenant: true
modulo_relacionado: "MCH-029"
spec: "docs/02-integraciones/INT-010-email-providers.md"
proveedores: ["SendGrid", "AWS SES", "SMTP"]
notas: "Fallback automatico entre proveedores"
- id: "INT-011"
nombre: "Storage Cloud"
categoria: "Almacenamiento"
estado: "planificado"
multi_tenant: true
modulo_relacionado: "MCH-029"
spec: "docs/02-integraciones/INT-011-storage-cloud.md"
proveedores: ["AWS S3", "Cloudflare R2", "MinIO"]
notas: "URLs firmadas, limites por plan"
- id: "INT-012"
nombre: "OAuth Social"
categoria: "Autenticacion"
estado: "planificado"
multi_tenant: true
modulo_relacionado: "MCH-030"
spec: "docs/02-integraciones/INT-012-oauth-social.md"
proveedores: ["Google", "Apple"]
notas: "Passport.js strategies"
- id: "INT-013"
nombre: "Redis Cache"
categoria: "Infraestructura"
estado: "planificado"
multi_tenant: true
modulo_relacionado: "MCH-029"
spec: "docs/02-integraciones/INT-013-redis-cache.md"
notas: "Cache, queues (BullMQ), rate limiting"
- id: "INT-014"
nombre: "Webhooks Outbound"
categoria: "Eventos"
estado: "planificado"
multi_tenant: true
modulo_relacionado: "MCH-029"
spec: "docs/02-integraciones/INT-014-webhooks-outbound.md"
notas: "Firma HMAC, reintentos exponenciales"
# ============================================================================
# DOCUMENTACION
# ============================================================================
documentacion:
vision: "docs/00-vision-general/VISION-PROYECTO.md"
arquitectura: "docs/00-vision-general/ARQUITECTURA-TECNICA.md"
requerimientos: "docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md"
epicas: "docs/01-epicas/"
especificaciones: "docs/02-especificaciones/"
despliegue: "docs/90-transversal/GUIA-DESPLIEGUE.md"
mapa: "docs/_MAP.md"
# ============================================================================
# ORCHESTRATION
# ============================================================================
orchestration:
plan: "orchestration/PLAN-IMPLEMENTACION.md"
status: "orchestration/PROJECT-STATUS.md"
proxima: "orchestration/PROXIMA-ACCION.md"
contexto: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
# ============================================================================
# PROXIMAS ACCIONES
# ============================================================================
proximas_acciones:
prioridad_p0:
- "Desplegar en servidor produccion con Docker"
- "Configurar dominio y SSL"
- "Obtener cuenta Meta Business"
- "Configurar Stripe produccion"
prioridad_p1:
- "Configurar LLM API key"
- "Pruebas E2E completas"
- "Completar documentacion SIMCO"
prioridad_p2:
- "Implementar FASE 6 restante"
- "FASE 7 - Expansion"
# ============================================================================
# NOTAS
# ============================================================================
notas:
- "MVP 95% completado - listo para produccion"
- "Builds verificados: Backend, Frontend, WhatsApp, Mobile"
- "Multi-tenant con RLS habilitado"
- "Integraciones WhatsApp y LLM soportan credenciales por tenant"
- "75 productos predefinidos para onboarding rapido"
- "Sistema de tokens IA con planes y recargas"
# ============================================================================
# TRAZABILIDAD (SIMCO v4.0.0)
# ============================================================================
trazabilidad:
archivo: "docs/04-modelado/trazabilidad/TRACEABILITY-MASTER.yml"
tipo: "YAML"
ultima_actualizacion: "2026-01-10"
modulos_trazados: 33
integraciones_trazadas: 14
cobertura_trazabilidad: 100
metricas:
modulos_completados: 22
modulos_pendientes: 6
modulos_planificados: 5
integraciones_activas: 3
integraciones_mock: 2
integraciones_pendientes: 4
integraciones_planificadas: 5
saas_integration:
fecha: "2026-01-10"
epicas_nuevas: ["MCH-029", "MCH-030", "MCH-031", "MCH-032", "MCH-033"]
integraciones_nuevas: ["INT-010", "INT-011", "INT-012", "INT-013", "INT-014"]
adrs_nuevos: 8
story_points_total: 45
# ============================================================================
# METADATA MIGRACION
# ============================================================================
migracion:
version_anterior: "SIMCO v3.8.0"
version_actual: "SIMCO v4.0.0"
fecha_migracion: "2026-01-10"
cambios_aplicados:
- "Reestructuracion integraciones con IDs INT-*"
- "Separacion infraestructura de integraciones"
- "Agregada seccion trazabilidad"
- "Agregados modulos relacionados a integraciones"
- "Agregadas referencias a specs de integracion"
actualizado_por: "Claude Code (Migracion SIMCO v4.0.0)"