erp-vidrio-templado/orchestration/inventarios/TRACEABILITY_MATRIX.yml

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

metadata:
  proyecto: ERP Vidrio Templado
  codigo: VT
  version: 1.0.0
  fecha_actualizacion: 2025-12-08
  base_core: erp-core v0.6.0

# =============================================================================
# RESUMEN GLOBAL
# =============================================================================
resumen:
  modulos_total: 8
  modulos_documentados: 8
  epicas_completas: 8
  story_points_total: 259
  specs_core_aplicables: 25
  specs_implementadas: 0
  cobertura_specs: 0%
  estado: EPICAS_COMPLETAS

# =============================================================================
# TRAZABILIDAD POR MÓDULO
# =============================================================================
trazabilidad:
  # ---------------------------------------------------------------------------
  # VT-001: Fundamentos (100% herencia core)
  # ---------------------------------------------------------------------------
  VT-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

  # ---------------------------------------------------------------------------
  # VT-002: Cotizaciones
  # ---------------------------------------------------------------------------
  VT-002:
    nombre: Cotizaciones
    herencia: 30%
    prioridad: P0
    sp: 34
    epica: docs/08-epicas/EPIC-VT-002-cotizaciones.md
    database:
      tablas:
        - glass.quotations
        - glass.quotation_lines
        - glass.glass_types
        - glass.glass_thicknesses
        - glass.processing_options
    backend:
      servicios:
        - GlassQuotationService
        - GlassCalculatorService
        - GlassTypeService
    frontend:
      componentes:
        - GlassQuotationForm
        - GlassPieceCalculator
        - DimensionInput
        - ProcessingSelector
        - QuotationPreview
        - QuotationList
    specs_core:
      - SPEC-PRICING-RULES (reglas de precio por tipo/espesor)

  # ---------------------------------------------------------------------------
  # VT-003: Producción
  # ---------------------------------------------------------------------------
  VT-003:
    nombre: Produccion
    herencia: 20%
    prioridad: P0
    sp: 42
    epica: docs/08-epicas/EPIC-VT-003-produccion.md
    database:
      tablas:
        - production.production_orders
        - production.production_lines
        - production.production_stages
        - production.work_stations
    backend:
      servicios:
        - ProductionOrderService
        - ProductionPlanningService
        - WorkStationService
    frontend:
      componentes:
        - ProductionOrderList
        - ProductionOrderForm
        - ProductionKanban
        - ProductionScheduler
        - WorkStationMonitor
    specs_core:
      - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN (seguimiento producción)

  # ---------------------------------------------------------------------------
  # VT-004: Inventario
  # ---------------------------------------------------------------------------
  VT-004:
    nombre: Inventario
    herencia: 70%
    prioridad: P0
    sp: 38
    epica: docs/08-epicas/EPIC-VT-004-inventario.md
    database:
      tablas:
        - glass.raw_materials
        - glass.glass_stock
        - glass.stock_movements
    backend:
      servicios:
        - GlassStockService
        - RawMaterialService
    frontend:
      componentes:
        - GlassStockDashboard
        - StockByTypeChart
        - RawMaterialList
        - StockAlertPanel
    specs_core:
      - SPEC-VALORACION-INVENTARIO
      - SPEC-TRAZABILIDAD-LOTES-SERIES

  # ---------------------------------------------------------------------------
  # VT-005: Corte (Nesting)
  # ---------------------------------------------------------------------------
  VT-005:
    nombre: Corte
    herencia: 0%
    prioridad: P1
    sp: 45
    epica: docs/08-epicas/EPIC-VT-005-corte.md
    database:
      tablas:
        - production.cutting_plans
        - production.cutting_patterns
        - production.material_sheets
        - production.cutting_waste
    backend:
      servicios:
        - CuttingPlanService
        - NestingOptimizer
        - WasteTrackingService
    frontend:
      componentes:
        - CuttingPlanViewer
        - NestingVisualizer
        - SheetSelector
        - WasteReport
        - OptimizationControls
    specs_core: []
    nota: "Algoritmo de nesting propietario para optimización de corte"

  # ---------------------------------------------------------------------------
  # VT-006: Templado
  # ---------------------------------------------------------------------------
  VT-006:
    nombre: Templado
    herencia: 0%
    prioridad: P1
    sp: 40
    epica: docs/08-epicas/EPIC-VT-006-templado.md
    database:
      tablas:
        - production.furnaces
        - production.furnace_batches
        - production.tempering_profiles
        - production.batch_items
    backend:
      servicios:
        - FurnaceService
        - TemperingProfileService
        - BatchSchedulerService
    frontend:
      componentes:
        - FurnaceMonitor
        - FurnaceBatchForm
        - TemperatureChart
        - BatchQueueView
        - ProfileEditor
    specs_core: []
    nota: "Control de hornos con perfiles de temperatura por tipo de vidrio"

  # ---------------------------------------------------------------------------
  # VT-007: Calidad
  # ---------------------------------------------------------------------------
  VT-007:
    nombre: Calidad
    herencia: 40%
    prioridad: P0
    sp: 32
    epica: docs/08-epicas/EPIC-VT-007-calidad.md
    database:
      tablas:
        - quality.quality_tests
        - quality.test_results
        - quality.defect_types
        - quality.certifications
    backend:
      servicios:
        - QualityTestService
        - CertificationService
        - DefectTrackingService
    frontend:
      componentes:
        - QualityTestForm
        - TestResultsGrid
        - DefectCapture
        - CertificationViewer
    specs_core:
      - SPEC-TRAZABILIDAD-LOTES-SERIES

  # ---------------------------------------------------------------------------
  # VT-008: Despacho
  # ---------------------------------------------------------------------------
  VT-008:
    nombre: Despacho
    herencia: 50%
    prioridad: P1
    sp: 28
    epica: docs/08-epicas/EPIC-VT-008-despacho.md
    database:
      tablas:
        - logistics.shipments
        - logistics.shipment_items
        - logistics.delivery_routes
        - logistics.packing_lists
    backend:
      servicios:
        - ShipmentService
        - RouteOptimizationService
        - PackingService
    frontend:
      componentes:
        - ShipmentList
        - DeliveryRouteMap
        - PackingListGenerator
        - DeliveryConfirmation
    specs_core:
      - SPEC-MAIL-THREAD-TRACKING (notificaciones entrega)

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

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

    - spec: SPEC-VALORACION-INVENTARIO
      modulos: [VT-004]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "Valorización de vidrio crudo y procesado"

    - spec: SPEC-TRAZABILIDAD-LOTES-SERIES
      modulos: [VT-004, VT-007]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "Trazabilidad desde lámina hasta pieza final"

    - spec: SPEC-PRICING-RULES
      modulos: [VT-002]
      prioridad: P0
      estado: PENDIENTE
      adaptacion: "Precios por tipo vidrio × espesor × proceso"

    - spec: SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN
      modulos: [VT-003]
      prioridad: P1
      estado: PENDIENTE
      adaptacion: "Seguimiento de órdenes de producción"

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

    - core: MGN-002 (users)
      vertical: VT-001
      tipo: herencia_directa

    - core: MGN-011 (inventory)
      vertical: VT-004
      tipo: extension

    - core: MGN-013 (sales)
      vertical: VT-002
      tipo: extension

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

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

    - tipo: spec_critica
      spec: SPEC-TRAZABILIDAD-LOTES-SERIES
      mensaje: "Crítica para certificación de calidad"

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