# ===============================================================================
# DECLARACION DE HERENCIA - MICHANGARRITO
# ===============================================================================
#
# Proyecto: michangarrito
# 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: "2.0.0"
created: "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 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:
    - name: "auth"
      id_origen: "SAAS-001"
      version: "1.0.0"
      status: "active"
      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 con RLS"
      adaptacion: "Cada negocio = 1 tenant con configuracion propia"

    - name: "billing"
      id_origen: "SAAS-004"
      version: "1.0.0"
      status: "active"
      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 multi-canal"
      adaptacion: "Push, WhatsApp, Email"

    - name: "email-providers"
      id_origen: "SAAS-010"
      version: "1.0.0"
      status: "planificado"
      descripcion: "Email multi-proveedor"
      adaptacion: "SendGrid/SES/SMTP con fallback"

    - 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: "infraestructura-base"
      id: "MCH-001"
      estado: "completado"
      descripcion: "Monorepo, PostgreSQL multi-tenant, CI/CD"

    - name: "autenticacion"
      id: "MCH-002"
      estado: "completado"
      descripcion: "OTP, JWT, PIN, Biometrico"

    - name: "catalogo-productos"
      id: "MCH-003"
      estado: "completado"
      descripcion: "CRUD productos, categorias, templates 75 productos"

    - name: "punto-venta"
      id: "MCH-004"
      estado: "completado"
      descripcion: "Registro ventas, carrito, ticket, calculadora cambio"

    - name: "integraciones-pago"
      id: "MCH-005"
      estado: "completado"
      descripcion: "Stripe, MercadoPago (pendiente), Clip (mock), CoDi (mock)"

    - name: "onboarding-inteligente"
      id: "MCH-006"
      estado: "completado"
      descripcion: "Setup via WhatsApp, fotos, audio"

    - name: "mcp-server"
      id: "MCH-010"
      estado: "completado"
      descripcion: "Gateway LLM agnostico con 15 herramientas"

    - name: "whatsapp-service"
      id: "MCH-011"
      estado: "completado"
      descripcion: "Meta Cloud API, webhooks, multi-tenant"

    - name: "planes-suscripciones"
      id: "MCH-018"
      estado: "completado"
      descripcion: "Changarrito/Tiendita con tokens IA"

    - 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-17"
  estado_general: "MVP 95%"
  completitud: "95%"

  checklist:
    - item: "Backend NestJS operativo"
      status: "passed"
    - item: "Frontend React operativo"
      status: "passed"
    - item: "Mobile Expo operativo"
      status: "passed"
    - 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:
    - "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"
  updated_by: "Agente Orquestador - Validacion Documental"
  updated_at: "2026-01-17"
  task_id: "MCH-DOC-VAL-2026-01-17"
  related_documents:
    - "orchestration/MAPA-DOCUMENTACION.yml"
    - "orchestration/inventarios/MASTER_INVENTORY.yml"
    - "docs/_definitions/_INDEX.yml"

# ===============================================================================
# FIN DE DECLARACION DE HERENCIA
# ===============================================================================