# =============================================================================
# TRACEABILITY MATRIX - ERP Retail/POS (Vertical)
# =============================================================================
# Generado: 2025-12-08
# Sistema: NEXUS + SIMCO v2.2.0
# Propósito: Matriz de trazabilidad Módulos -> SPECS -> Componentes
# =============================================================================

metadata:
  proyecto: ERP Retail / Punto de Venta
  codigo: RT
  version: 1.0.0
  fecha_actualizacion: 2025-12-08
  base_core: erp-core v0.6.0

# =============================================================================
# RESUMEN GLOBAL
# =============================================================================
resumen:
  modulos_total: 10
  modulos_documentados: 10
  epicas_completas: 10
  story_points_total: 353
  specs_core_aplicables: 26
  specs_implementadas: 0
  cobertura_specs: 0%
  estado: EPICAS_COMPLETAS

# =============================================================================
# TRAZABILIDAD POR MÓDULO
# =============================================================================
trazabilidad:
  # ---------------------------------------------------------------------------
  # RT-001: Fundamentos (100% herencia core)
  # ---------------------------------------------------------------------------
  RT-001:
    nombre: Fundamentos
    herencia: 100%
    prioridad: P0
    sp: 0
    extiende:
      - MGN-001 (auth)
      - MGN-002 (users)
      - MGN-003 (roles)
      - MGN-004 (tenants)
    database:
      heredadas: [auth.users, auth.sessions, auth.roles, tenants.tenants]
      extensiones: []
    backend:
      heredados: [AuthService, UserService, RoleService, TenantService]
      extensiones: []
    frontend:
      heredados: [LoginForm, UserProfile, RoleSelector]
      extensiones: []
    specs_core:
      - SPEC-SISTEMA-SECUENCIAS
      - SPEC-SEGURIDAD-API-KEYS-PERMISOS

  # ---------------------------------------------------------------------------
  # RT-002: POS (Terminal Punto de Venta)
  # ---------------------------------------------------------------------------
  RT-002:
    nombre: POS
    herencia: 0%
    prioridad: P0
    sp: 55
    epica: docs/08-epicas/EPIC-RT-002-pos.md
    critico: true
    database:
      tablas:
        - pos.pos_sessions
        - pos.pos_orders
        - pos.pos_order_lines
        - pos.payment_methods
        - pos.payment_transactions
    backend:
      servicios:
        - POSSessionService
        - POSOrderService
        - PaymentService
        - OfflineSyncService
    frontend:
      componentes:
        - POSTerminal
        - ProductSearch
        - BarcodeScanner
        - PaymentModal
        - QuickButtons
        - OrderSummary
        - CustomerDisplay
    specs_core: []
    caracteristicas:
      - offline_first: true
      - hardware_integration: [printer, scanner, cash_drawer]

  # ---------------------------------------------------------------------------
  # RT-003: Inventario Multi-Sucursal
  # ---------------------------------------------------------------------------
  RT-003:
    nombre: Inventario
    herencia: 70%
    prioridad: P0
    sp: 42
    epica: docs/08-epicas/EPIC-RT-003-inventario.md
    database:
      tablas:
        - inventory.branches
        - inventory.branch_stock
        - inventory.stock_transfers
        - inventory.transfer_lines
    backend:
      servicios:
        - BranchService
        - BranchStockService
        - StockTransferService
    frontend:
      componentes:
        - BranchSelector
        - StockDashboard
        - TransferForm
        - StockAlertPanel
        - MultiBranchView
    specs_core:
      - SPEC-VALORACION-INVENTARIO
      - SPEC-INVENTARIOS-CICLICOS
      - SPEC-TRAZABILIDAD-LOTES-SERIES

  # ---------------------------------------------------------------------------
  # RT-004: Compras
  # ---------------------------------------------------------------------------
  RT-004:
    nombre: Compras
    herencia: 60%
    prioridad: P0
    sp: 21
    database:
      tablas:
        - purchasing.purchase_orders
        - purchasing.purchase_order_lines
        - purchasing.goods_receipts
    backend:
      servicios:
        - PurchaseOrderService
        - GoodsReceiptService
        - SupplierService
    frontend:
      componentes:
        - PurchaseOrderForm
        - PurchaseOrderList
        - GoodsReceiptForm
        - SupplierSelector
    specs_core:
      - SPEC-SISTEMA-SECUENCIAS

  # ---------------------------------------------------------------------------
  # RT-005: Clientes (CRM + Fidelización)
  # ---------------------------------------------------------------------------
  RT-005:
    nombre: Clientes
    herencia: 50%
    prioridad: P0
    sp: 34
    database:
      tablas:
        - crm.retail_customers
        - loyalty.loyalty_cards
        - loyalty.loyalty_transactions
        - loyalty.reward_tiers
    backend:
      servicios:
        - RetailCustomerService
        - LoyaltyCardService
        - RewardService
    frontend:
      componentes:
        - CustomerLookup
        - CustomerForm
        - LoyaltyCardView
        - PointsHistory
        - RewardCatalog
    specs_core:
      - SPEC-MAIL-THREAD-TRACKING (comunicación clientes)

  # ---------------------------------------------------------------------------
  # RT-006: Precios y Promociones
  # ---------------------------------------------------------------------------
  RT-006:
    nombre: Precios
    herencia: 40%
    prioridad: P0
    sp: 42
    database:
      tablas:
        - pricing.price_lists
        - pricing.promotions
        - pricing.promotion_rules
        - pricing.discount_coupons
    backend:
      servicios:
        - PriceListService
        - PromotionEngine
        - CouponService
        - PriceCalculator
    frontend:
      componentes:
        - PriceListManager
        - PromotionBuilder
        - PromotionCalendar
        - CouponGenerator
        - DiscountPreview
    specs_core:
      - SPEC-PRICING-RULES (motor de promociones)

  # ---------------------------------------------------------------------------
  # RT-007: Caja (Arqueos y Cortes)
  # ---------------------------------------------------------------------------
  RT-007:
    nombre: Caja
    herencia: 30%
    prioridad: P0
    sp: 34
    database:
      tablas:
        - pos.cash_registers
        - pos.cash_movements
        - pos.cash_closings
        - pos.denomination_counts
    backend:
      servicios:
        - CashRegisterService
        - CashClosingService
        - CashReportService
    frontend:
      componentes:
        - CashDrawer
        - CashClosingForm
        - DenominationCounter
        - CashMovementLog
        - ClosingReport
    specs_core:
      - SPEC-WIZARD-TRANSIENT-MODEL (asistente cierre)

  # ---------------------------------------------------------------------------
  # RT-008: Reportes y Dashboards
  # ---------------------------------------------------------------------------
  RT-008:
    nombre: Reportes
    herencia: 40%
    prioridad: P1
    sp: 34
    database:
      tablas: []
    backend:
      servicios:
        - SalesReportService
        - InventoryReportService
        - AnalyticsService
    frontend:
      componentes:
        - SalesDashboard
        - SalesReport
        - InventoryReport
        - TopProductsChart
        - SalesTrendChart
        - BranchComparison
    specs_core: []

  # ---------------------------------------------------------------------------
  # RT-009: E-commerce
  # ---------------------------------------------------------------------------
  RT-009:
    nombre: E-commerce
    herencia: 20%
    prioridad: P2
    sp: 47
    database:
      tablas:
        - ecommerce.online_orders
        - ecommerce.shopping_carts
        - ecommerce.product_catalog
        - ecommerce.shipping_methods
    backend:
      servicios:
        - OnlineOrderService
        - CartService
        - CatalogSyncService
        - ShippingService
    frontend:
      componentes:
        - OnlineOrderManager
        - CatalogEditor
        - ShippingConfigurator
        - OrderFulfillment
    specs_core:
      - SPEC-MAIL-THREAD-TRACKING (notificaciones pedidos)

  # ---------------------------------------------------------------------------
  # RT-010: Facturación CFDI
  # ---------------------------------------------------------------------------
  RT-010:
    nombre: Facturacion
    herencia: 80%
    prioridad: P0
    sp: 21
    database:
      tablas:
        - invoicing.retail_invoices
        - invoicing.invoice_complements
    backend:
      servicios:
        - RetailInvoiceService
        - CFDIService
        - ComplementService
    frontend:
      componentes:
        - InvoiceGenerator
        - InvoiceList
        - CFDIViewer
        - ComplementForm
    specs_core:
      - SPEC-FACTURACION-CFDI
      - SPEC-INTEGRACION-BANCARIA (complementos pago)

# =============================================================================
# REFERENCIAS CRUZADAS CON ERP-CORE
# =============================================================================
referencias_core:
  specs_implementadas: []

  specs_pendientes:
    - spec: SPEC-SISTEMA-SECUENCIAS
      modulos: [RT-001, RT-002, RT-004]
      prioridad: P0
      estado: PENDIENTE

    - spec: SPEC-VALORACION-INVENTARIO
      modulos: [RT-003]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "Valorización multi-sucursal con costo promedio"

    - spec: SPEC-INVENTARIOS-CICLICOS
      modulos: [RT-003]
      prioridad: P1
      estado: PENDIENTE
      adaptacion: "Conteos por sucursal"

    - spec: SPEC-PRICING-RULES
      modulos: [RT-006]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "Promociones, combos, descuentos por volumen"

    - spec: SPEC-FACTURACION-CFDI
      modulos: [RT-010]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "CFDI 4.0 con complementos de pago"

  modulos_extendidos:
    - core: MGN-001 (auth)
      vertical: RT-001
      tipo: herencia_directa

    - core: MGN-011 (inventory)
      vertical: RT-003
      tipo: extension_multi_sucursal

    - core: MGN-013 (sales)
      vertical: RT-002
      tipo: extension_pos

    - core: MGN-016 (cfdi)
      vertical: RT-010
      tipo: extension_retail

# =============================================================================
# VALIDACIONES
# =============================================================================
validaciones:
  modulos_huerfanos: 0
  specs_sin_modulo: 0

  alertas:
    - tipo: implementacion_pendiente
      mensaje: "0% de código implementado - fase planificación"

    - tipo: modulo_critico
      modulo: RT-002
      mensaje: "POS es crítico - requiere modo offline"

    - tipo: integracion_hardware
      modulo: RT-002
      mensaje: "Requiere integración con impresoras térmicas, scanners"

# =============================================================================
# METADATA
# =============================================================================
metadata_documento:
  creado_por: Claude-Code
  fecha_creacion: 2025-12-08
  ultima_actualizacion: 2025-12-08
  version_documento: 1.0.0