# DATABASE INVENTORY - ERP Retail/POS (Vertical)
# Generado: 2025-12-08
# Sistema: NEXUS + SIMCO v2.2.0

proyecto:
  nombre: ERP Retail / Punto de Venta
  codigo: retail
  nivel: 2B.2 (Vertical)
  estado: Planificacion

herencia_core:
  base_de_datos: erp-core
  version_core: "1.2.0"
  tablas_heredadas: 144  # Actualizado 2025-12-09 según conteo real DDL
  schemas_heredados:
    - nombre: auth
      tablas: 26         # Autenticación, MFA, OAuth, API Keys
    - nombre: core
      tablas: 12         # Partners (clientes), catálogos, UoM
    - nombre: financial
      tablas: 15         # Contabilidad, facturas, pagos
    - nombre: inventory
      tablas: 20         # Productos, stock, valoración
    - nombre: purchase
      tablas: 8          # Compras, proveedores
    - nombre: sales
      tablas: 10         # Ventas, cotizaciones
    - nombre: projects
      tablas: 10         # Proyectos (opcional)
    - nombre: analytics
      tablas: 7          # Centros de costo por tienda
    - nombre: system
      tablas: 13         # Mensajes, notificaciones, logs
    - nombre: billing
      tablas: 11         # SaaS (opcional)
    - nombre: crm
      tablas: 6          # Leads, fidelización (opcional)
    - nombre: hr
      tablas: 6          # Empleados, turnos
  referencia_ddl: "apps/erp-core/database/ddl/"
  documento_herencia: "../database/HERENCIA-ERP-CORE.md"
  variable_rls: "app.current_tenant_id"

schemas_especificos:
  - nombre: retail
    descripcion: Schema para operaciones de punto de venta
    estado: PLANIFICADO
    modulos_relacionados: [RT-001, RT-002, RT-003, RT-004, RT-005, RT-006, RT-007]

tablas_planificadas:
  pos:
    - nombre: retail.pos_sessions
      descripcion: Sesiones de punto de venta
      modulo: RT-001
      prioridad: P0

    - nombre: retail.pos_orders
      descripcion: Ventas en punto de venta
      modulo: RT-001
      prioridad: P0

    - nombre: retail.pos_order_lines
      descripcion: Lineas de venta
      modulo: RT-001
      prioridad: P0

    - nombre: retail.cash_registers
      descripcion: Cajas registradoras
      modulo: RT-001
      prioridad: P0

    - nombre: retail.cash_movements
      descripcion: Movimientos de efectivo
      modulo: RT-001
      prioridad: P0

    - nombre: retail.cash_closings
      descripcion: Cortes de caja
      modulo: RT-001
      prioridad: P0

  inventario:
    - nombre: retail.branches
      descripcion: Sucursales
      modulo: RT-002
      prioridad: P0

    - nombre: retail.branch_stock
      descripcion: Stock por sucursal
      modulo: RT-002
      prioridad: P0

    - nombre: retail.stock_transfers
      descripcion: Transferencias entre sucursales
      modulo: RT-002
      prioridad: P1

  productos:
    - nombre: retail.products
      descripcion: Productos de venta
      modulo: RT-003
      prioridad: P0
      extiende: inventory.products

    - nombre: retail.product_barcodes
      descripcion: Codigos de barras
      modulo: RT-003
      prioridad: P0

    - nombre: retail.promotions
      descripcion: Promociones y descuentos
      modulo: RT-003
      prioridad: P1

  clientes:
    - nombre: retail.customers
      descripcion: Clientes
      modulo: RT-004
      prioridad: P1

    - nombre: retail.loyalty_cards
      descripcion: Tarjetas de fidelizacion
      modulo: RT-004
      prioridad: P2

    - nombre: retail.loyalty_transactions
      descripcion: Transacciones de puntos
      modulo: RT-004
      prioridad: P2

  proveedores:
    - nombre: retail.suppliers
      descripcion: Proveedores
      modulo: RT-005
      prioridad: P1

    - nombre: retail.purchase_orders
      descripcion: Ordenes de compra
      modulo: RT-005
      prioridad: P1

  facturacion:
    - nombre: retail.invoices
      descripcion: Facturas CFDI
      modulo: RT-007
      prioridad: P0

specs_core_requeridas:
  - spec: SPEC-PRICING-RULES.md
    aplicacion: Precios, promociones, descuentos
  - spec: SPEC-INVENTARIOS-CICLICOS.md
    aplicacion: Conteo de productos
  - spec: SPEC-TRAZABILIDAD-LOTES-SERIES.md
    aplicacion: Productos con caducidad

consideraciones_especiales:
  - Operacion offline del POS (sincronizacion posterior)
  - Rendimiento critico (<100ms por transaccion)
  - Integracion con hardware (impresoras, lectores)
  - CFDI 4.0 en tiempo real

resumen:
  tablas_heredadas: 140+
  tablas_especificas_planificadas: 18
  schemas_especificos: 1
  estado_general: PLANIFICACION
  ultima_actualizacion: 2025-12-08

referencias:
  herencia_core: "../00-guidelines/HERENCIA-ERP-CORE.md"