# MiInventario - Context Map
# Version: 1.2.0
# Actualizado: 2026-01-13

metadata:
  proyecto: miinventario
  codigo: MII
  tipo: standalone-saas
  nivel_simco: L2-A
  version: "1.2.0"
  simco_version: "4.0.0"
  estado: completado
  creado: 2026-01-10
  actualizado: 2026-01-13
  actualizado_por: "Agente Arquitecto de Documentación"

# ===========================================
# RUTAS ABSOLUTAS DEL PROYECTO
# ===========================================
rutas:
  proyecto: /home/isem/workspace-v2/projects/miinventario
  docs: /home/isem/workspace-v2/projects/miinventario/docs
  orchestration: /home/isem/workspace-v2/projects/miinventario/orchestration
  backend: /home/isem/workspace-v2/projects/miinventario/apps/backend
  mobile: /home/isem/workspace-v2/projects/miinventario/apps/mobile
  database: /home/isem/workspace-v2/projects/miinventario/database

# ===========================================
# ALIASES DEL PROYECTO
# ===========================================
aliases:
  "@PROJECT": /home/isem/workspace-v2/projects/miinventario
  "@DOCS": /home/isem/workspace-v2/projects/miinventario/docs
  "@ORCH": /home/isem/workspace-v2/projects/miinventario/orchestration
  "@BACKEND": /home/isem/workspace-v2/projects/miinventario/apps/backend
  "@BACKEND_SRC": /home/isem/workspace-v2/projects/miinventario/apps/backend/src
  "@MOBILE": /home/isem/workspace-v2/projects/miinventario/apps/mobile
  "@MOBILE_SRC": /home/isem/workspace-v2/projects/miinventario/apps/mobile/src
  "@DDL": /home/isem/workspace-v2/projects/miinventario/database/schemas
  "@SEEDS": /home/isem/workspace-v2/projects/miinventario/database/seeds
  "@INVENTORY": /home/isem/workspace-v2/projects/miinventario/orchestration/inventarios
  "@TRAZAS": /home/isem/workspace-v2/projects/miinventario/orchestration/trazas

# ===========================================
# VARIABLES DEL PROYECTO
# ===========================================
variables:
  PROJECT: miinventario
  PROJECT_CODE: MII
  DB_NAME: miinventario_dev
  BACKEND_PORT: 3142
  MOBILE_PORT: 8082
  POSTGRES_PORT: 5433
  REDIS_PORT: 6380
  MINIO_PORT: 9002
  MINIO_CONSOLE_PORT: 9003

# ===========================================
# SINGLE SOURCE OF TRUTH (SSOT)
# ===========================================
ssot:
  inventario_master: "@INVENTORY/MASTER_INVENTORY.yml"
  inventario_database: "@INVENTORY/DATABASE_INVENTORY.yml"
  inventario_backend: "@INVENTORY/BACKEND_INVENTORY.yml"
  inventario_frontend: "@INVENTORY/FRONTEND_INVENTORY.yml"
  contexto: "@ORCH/00-guidelines/CONTEXTO-PROYECTO.md"
  herencia: "@ORCH/00-guidelines/HERENCIA-SIMCO.md"
  vision: "@DOCS/00-vision-general/VISION-PROYECTO.md"
  requerimientos: "@DOCS/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md"
  arquitectura: "@DOCS/00-vision-general/ARQUITECTURA-TECNICA.md"

# ===========================================
# INTEGRACION CON DOCS
# ===========================================
integracion_docs:
  mapa_docs: "@DOCS/_MAP.md"
  indice: "@DOCS/INDICE-ARQUITECTURA.md"
  estructura:
    vision: "@DOCS/00-vision-general/"
    epicas: "@DOCS/01-epicas/"
    especificaciones: "@DOCS/02-especificaciones/"
    integraciones: "@DOCS/02-integraciones/"
    transversal: "@DOCS/90-transversal/"
    adr: "@DOCS/97-adr/"

# ===========================================
# HERENCIA DEL WORKSPACE
# ===========================================
herencia:
  workspace: /home/isem/workspace-v2
  simco: /home/isem/workspace-v2/orchestration/directivas/simco
  principios: /home/isem/workspace-v2/orchestration/directivas/principios
  templates: /home/isem/workspace-v2/orchestration/templates
  catalog: /home/isem/workspace-v2/shared/catalog
  knowledge: /home/isem/workspace-v2/shared/knowledge-base

# ===========================================
# FASES DEL PROYECTO
# ===========================================
fases:
  - id: 1
    nombre: "MVP Core"
    descripcion: "Funcionalidad base de inventario"
    epicas: [MII-001, MII-002, MII-003, MII-004, MII-005, MII-006]
    story_points: 97
    estado: completado
    progreso: 100

  - id: 2
    nombre: "Retroalimentacion"
    descripcion: "Mejora continua del modelo IA"
    epicas: [MII-007, MII-008]
    story_points: 21
    estado: completado
    progreso: 100

  - id: 3
    nombre: "Monetizacion"
    descripcion: "Sistema de creditos y pagos"
    epicas: [MII-009, MII-010, MII-011, MII-012, MII-013]
    story_points: 50
    estado: completado
    progreso: 100

  - id: 4
    nombre: "Crecimiento"
    descripcion: "Referidos y administracion"
    epicas: [MII-014, MII-015]
    story_points: 34
    estado: completado
    progreso: 100

# ===========================================
# EPICAS
# ===========================================
epicas:
  MII-001:
    nombre: "Infraestructura Base"
    fase: 1
    sp: 8
    estado: completado
    dependencias: []

  MII-002:
    nombre: "Autenticacion"
    fase: 1
    sp: 13
    estado: completado
    dependencias: [MII-001]
    catalogo: ["auth", "session-management"]

  MII-003:
    nombre: "Gestion de Tiendas"
    fase: 1
    sp: 8
    estado: completado
    dependencias: [MII-002]
    catalogo: ["multi-tenancy"]

  MII-004:
    nombre: "Captura de Video"
    fase: 1
    sp: 21
    estado: completado
    dependencias: [MII-003]

  MII-005:
    nombre: "Procesamiento IA"
    fase: 1
    sp: 34
    estado: completado
    dependencias: [MII-004]

  MII-006:
    nombre: "Reportes de Inventario"
    fase: 1
    sp: 13
    estado: completado
    dependencias: [MII-005]

  MII-007:
    nombre: "Retroalimentacion"
    fase: 2
    sp: 13
    estado: completado
    dependencias: [MII-006]

  MII-008:
    nombre: "Validacion Aleatoria"
    fase: 2
    sp: 8
    estado: completado
    dependencias: [MII-006]

  MII-009:
    nombre: "Wallet y Creditos"
    fase: 3
    sp: 13
    estado: completado
    dependencias: [MII-006]
    catalogo: ["audit-logs"]

  MII-010:
    nombre: "Paquetes de Recarga"
    fase: 3
    sp: 8
    estado: completado
    dependencias: [MII-009]

  MII-011:
    nombre: "Pagos con Tarjeta"
    fase: 3
    sp: 8
    estado: completado
    dependencias: [MII-010]
    catalogo: ["payments"]

  MII-012:
    nombre: "Pagos OXXO"
    fase: 3
    sp: 13
    estado: completado
    dependencias: [MII-010]

  MII-013:
    nombre: "Pagos 7-Eleven"
    fase: 3
    sp: 8
    estado: completado
    dependencias: [MII-010]

  MII-014:
    nombre: "Sistema de Referidos"
    fase: 4
    sp: 21
    estado: completado
    dependencias: [MII-009]

  MII-015:
    nombre: "Administracion SaaS"
    fase: 4
    sp: 13
    estado: completado
    dependencias: [MII-009, MII-014]

# ===========================================
# INTEGRACIONES EXTERNAS
# ===========================================
integraciones:
  - id: INT-001
    nombre: Stripe
    tipo: pagos
    proveedor: Stripe Inc.
    proposito: "Pagos con tarjeta y OXXO voucher"
    prioridad: P0
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-001-stripe.md"

  - id: INT-002
    nombre: OXXO
    tipo: pagos
    proveedor: Stripe (via OXXO)
    proposito: "Pagos en efectivo en OXXO"
    prioridad: P0
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-002-oxxo.md"

  - id: INT-003
    nombre: 7-Eleven
    tipo: pagos
    proveedor: Agregador
    proposito: "Pagos en efectivo en 7-Eleven"
    prioridad: P1
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-003-7eleven.md"

  - id: INT-004
    nombre: Firebase FCM
    tipo: notificaciones
    proveedor: Google
    proposito: "Push notifications"
    prioridad: P1
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-004-firebase-fcm.md"

  - id: INT-005
    nombre: S3/MinIO
    tipo: almacenamiento
    proveedor: AWS/MinIO
    proposito: "Almacenamiento de videos y frames"
    prioridad: P0
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-005-s3-storage.md"

  - id: INT-006
    nombre: Proveedor IA
    tipo: ml-vision
    proveedor: Multiples (abstraccion)
    proposito: "Deteccion y conteo de productos"
    prioridad: P0
    estado: implementado
    documentacion: "@DOCS/02-integraciones/INT-006-ia-provider.md"

# ===========================================
# SCHEMAS DE BASE DE DATOS
# ===========================================
schemas:
  - nombre: public
    proposito: "Configuracion global, tenants"
    tablas_principales: [tenants, settings, configurations]

  - nombre: auth
    proposito: "Usuarios, sesiones, tokens"
    tablas_principales: [users, user_profiles, sessions, refresh_tokens]

  - nombre: catalog
    proposito: "Productos, SKUs, categorias"
    tablas_principales: [products, skus, categories, brands]

  - nombre: inventory
    proposito: "Sesiones, lineas, detecciones"
    tablas_principales: [inventory_sessions, session_line_items, detections]

  - nombre: wallet
    proposito: "Saldos, transacciones"
    tablas_principales: [wallets, wallet_transactions]

  - nombre: payments
    proposito: "Pagos, referencias"
    tablas_principales: [payments, payment_references]

  - nombre: referrals
    proposito: "Codigos, relaciones, recompensas"
    tablas_principales: [referral_links, referral_rewards]

  - nombre: ai
    proposito: "Proveedores, costos, feedback"
    tablas_principales: [ai_providers, ai_costs, feedback_events, validation_tasks]

  - nombre: admin
    proposito: "Configuraciones administrativas"
    tablas_principales: [packages, pricing_rules, metrics]

# ===========================================
# MODULOS BACKEND
# ===========================================
modulos_backend:
  - nombre: auth
    ruta: "modules/auth"
    dependencias: []

  - nombre: users
    ruta: "modules/users"
    dependencias: [auth]

  - nombre: stores
    ruta: "modules/stores"
    dependencias: [auth, users]

  - nombre: inventory-sessions
    ruta: "modules/inventory-sessions"
    dependencias: [auth, stores]

  - nombre: products
    ruta: "modules/products"
    dependencias: [auth]

  - nombre: wallet
    ruta: "modules/wallet"
    dependencias: [auth, users]

  - nombre: payments
    ruta: "modules/payments"
    dependencias: [auth, wallet]

  - nombre: referrals
    ruta: "modules/referrals"
    dependencias: [auth, users, wallet]

  - nombre: ai-processing
    ruta: "modules/ai-processing"
    dependencias: [inventory-sessions, products]

  - nombre: feedback
    ruta: "modules/feedback"
    dependencias: [inventory-sessions, products]

  - nombre: admin
    ruta: "modules/admin"
    dependencias: [auth]

# ===========================================
# CHANGELOG
# ===========================================
changelog:
  - version: "1.0.0"
    fecha: 2026-01-10
    cambios:
      - "Creacion inicial del context map"
      - "Definicion de 15 epicas en 4 fases"
      - "Identificacion de 6 integraciones"
      - "Mapeo de 9 schemas de base de datos"
      - "Definicion de 11 modulos backend"