# MASTER INVENTORY - MiChangarrito
# Version: 4.0.0
# Ultima actualizacion: 2026-01-17
# Sistema: SIMCO v4.0.1 + CAPVED + SCRUM
# Actualizado: Integracion capacidades SaaS de template-saas

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: "0.9.6"
  estado: "MVP_LISTO"
  tipo: "standalone"
  categoria: "saas"
  actualizado: "2026-01-17"
  actualizado_por: "Agente Orquestador"

# ============================================================================
# RESUMEN EJECUTIVO
# ============================================================================

resumen:
  estado_general: "98% MVP Implementado"
  fases_completadas: "5.1 de 6"
  tareas_completadas: "41 de 43"
  builds_verificados: true
  listo_produccion: true

  database:
    schemas: 1  # public (TypeORM)
    tablas: 38  # VALIDADO - 1:1 con entities
    funciones: 0
    triggers: 0
    extensiones: 1  # uuid-ossp
    enums: 0
    ddl_files: 0  # TypeORM genera tablas

  backend:
    modulos: 17  # VALIDADO
    controllers: 19  # VALIDADO
    endpoints: 195
    entities: 38  # VALIDADO
    services: 18  # VALIDADO

  frontend:
    paginas: 12
    componentes: 48
    contexts: 3

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