404 lines
11 KiB
YAML
404 lines
11 KiB
YAML
# =============================================================================
|
|
# 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
|