# ═══════════════════════════════════════════════════════════════════════════════
# DEPENDENCY-GRAPH.yml - MiChangarrito
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Propósito: Grafo de dependencias del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════

version: "1.0.0"
proyecto: "michangarrito"
tipo: "CONSUMER"
fecha_actualizacion: "2026-01-24"

# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS ENTRANTES
# ─────────────────────────────────────────────────────────────────────────────

depende_de:
  workspace:
    - ruta: "orchestration/directivas/simco/"
      tipo: "directivas"
      descripcion: "Directivas SIMCO del workspace"

  template_saas:
    - modulo: "auth"
      tipo: "patron"
      adaptacion: "OTP + JWT + PIN + Biométrico"

    - modulo: "tenants"
      tipo: "patron"
      adaptacion: "Multi-tenancy con RLS"

    - modulo: "billing"
      tipo: "patron"
      adaptacion: "Planes de suscripción"

    - modulo: "notifications"
      tipo: "patron"
      adaptacion: "Push, WhatsApp, Email"

  externos:
    - nombre: "PostgreSQL"
      version: "16+"
      tipo: "database"

    - nombre: "Redis"
      version: "7+"
      tipo: "cache"

    - nombre: "Node.js"
      version: "20+"
      tipo: "runtime"

    - nombre: "Meta Cloud API"
      tipo: "external_api"
      descripcion: "WhatsApp Business"

    - nombre: "Stripe"
      tipo: "external_api"
      descripcion: "Pagos con tarjeta"

    - nombre: "MercadoPago"
      tipo: "external_api"
      descripcion: "Pagos LATAM"

    - nombre: "OpenAI/Anthropic"
      tipo: "external_api"
      descripcion: "LLM providers"

# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS SALIENTES
# ─────────────────────────────────────────────────────────────────────────────

consumidores:
  nota: "MiChangarrito es aplicación final, no tiene consumidores de código"
  proyectos: []

# ─────────────────────────────────────────────────────────────────────────────
# DEPENDENCIAS INTERNAS
# ─────────────────────────────────────────────────────────────────────────────

dependencias_internas:
  apps:
    backend:
      depende_de:
        - "database (DDL)"
        - "Redis (cache)"
      consumidores:
        - "frontend"
        - "mobile"
        - "mcp-server"
        - "whatsapp-service"

    frontend:
      depende_de:
        - "backend (API)"
      consumidores: []

    mobile:
      depende_de:
        - "backend (API)"
        - "SQLite (offline)"
      consumidores: []

    mcp_server:
      depende_de:
        - "backend (API)"
        - "OpenAI/Anthropic (LLM)"
      consumidores:
        - "whatsapp-service"

    whatsapp_service:
      depende_de:
        - "backend (API)"
        - "mcp-server"
        - "Meta Cloud API"
      consumidores: []

# ─────────────────────────────────────────────────────────────────────────────
# GRAFO VISUAL
# ─────────────────────────────────────────────────────────────────────────────

grafo_visual: |
  workspace-v2/orchestration/ (directivas)
           │
           ▼
  template-saas (PROVIDER)
           │
           ▼ (integración selectiva)
  ┌─────────────────────────────────────────────────────────────────────────┐
  │                    michangarrito (CONSUMER)                             │
  │                                                                          │
  │  ┌─────────────────────────────────────────────────────────────────┐   │
  │  │                     DATABASE (PostgreSQL)                        │   │
  │  │  public │ auth │ catalog │ sales │ inventory │ messaging │ ...  │   │
  │  └─────────────────────────────────────────────────────────────────┘   │
  │                            ▲                                            │
  │                            │                                            │
  │  ┌─────────────────────────────────────────────────────────────────┐   │
  │  │                        BACKEND (NestJS)                          │   │
  │  │                                                                  │   │
  │  │  ┌──────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌────────────┐  │   │
  │  │  │ auth │ │ catalog │ │  sales  │ │ tenants  │ │ billing    │  │   │
  │  │  └──────┘ └─────────┘ └─────────┘ └──────────┘ └────────────┘  │   │
  │  └─────────────────────────────────────────────────────────────────┘   │
  │           ▲                    ▲                    ▲                   │
  │           │                    │                    │                   │
  │     ┌─────┴─────┐        ┌────┴────┐         ┌────┴────┐              │
  │     │           │        │         │         │         │              │
  │  ┌──────┐  ┌────────┐  ┌────────────┐  ┌───────────────────┐         │
  │  │ Web  │  │ Mobile │  │ MCP Server │  │ WhatsApp Service  │         │
  │  │React │  │  Expo  │  │ (LLM GW)   │  │  (Meta Cloud)     │         │
  │  └──────┘  └────────┘  └────────────┘  └───────────────────┘         │
  │                               │                    │                   │
  │                               ▼                    │                   │
  │                        ┌─────────────┐            │                   │
  │                        │ OpenAI/     │◄───────────┘                   │
  │                        │ Anthropic   │                                 │
  │                        └─────────────┘                                 │
  └─────────────────────────────────────────────────────────────────────────┘
           │
           ▼
  Usuarios finales (Micro-negocios mexicanos)

# ─────────────────────────────────────────────────────────────────────────────
# IMPACTO DE CAMBIOS
# ─────────────────────────────────────────────────────────────────────────────

impacto_cambios:
  alto:
    - modulo: "backend/auth"
      razon: "Todos los servicios dependen de autenticación"

    - modulo: "backend/tenants"
      razon: "Multi-tenancy afecta todos los datos"

    - modulo: "database/schemas"
      razon: "Cambios DDL requieren migraciones"

  medio:
    - modulo: "mcp-server"
      razon: "WhatsApp service depende de él"

    - modulo: "billing"
      razon: "Afecta suscripciones y tokens IA"

  bajo:
    - modulo: "frontend"
      razon: "UI independiente"

    - modulo: "mobile"
      razon: "Tiene modo offline"

# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────

notas:
  - "MiChangarrito es aplicación final sin consumidores de código"
  - "Integra selectivamente patrones de template-saas"
  - "6 aplicaciones en monorepo con dependencias claras"
  - "Backend es el núcleo del que dependen todos los servicios"