# MATRIZ DE MAPEO: ERP-CORE → RETAIL

**Fecha:** 2025-12-18
**Fase:** 1 - Planeacion
**Objetivo:** Mapear componentes del core hacia requerimientos de retail

---

## 1. MAPEO MODULO A MODULO

### 1.1 Herencia Directa (100%)

| Modulo Retail | Modulo Core | Tipo | Accion |
|---------------|-------------|------|--------|
| RT-001 Fundamentos | MGN-001 Auth | HEREDAR | Import directo |
| RT-001 Fundamentos | MGN-002 Users | HEREDAR | Import directo |
| RT-001 Fundamentos | MGN-003 Roles | HEREDAR | Import directo |
| RT-001 Fundamentos | MGN-004 Tenants | HEREDAR | Import directo |

### 1.2 Herencia con Extension

| Modulo Retail | Modulo Core | % Herencia | Extensiones Requeridas |
|---------------|-------------|------------|------------------------|
| RT-003 Inventario | MGN-011 Inventory | 60% | Stock por sucursal, transferencias |
| RT-004 Compras | MGN-012 Purchasing | 80% | Distribucion a sucursales |
| RT-005 Clientes | MGN-014 CRM | 40% | Programa de lealtad, puntos |
| RT-006 Precios | MGN-013 Sales (pricing) | 30% | Promociones complejas, cupones |
| RT-008 Reportes | MGN-009 Reports | 70% | Dashboard POS, metricas ventas |
| RT-010 Facturacion | MGN-010 Financial | 60% | CFDI 4.0, timbrado PAC |

### 1.3 Componentes Nuevos (Sin herencia directa)

| Modulo Retail | % Herencia | Componentes Nuevos |
|---------------|------------|-------------------|
| RT-002 POS | 20% | Terminal POS, offline, hardware |
| RT-007 Caja | 10% | Arqueos, cortes, denominaciones |
| RT-009 E-commerce | 20% | Tienda online, carrito, checkout |

---

## 2. MAPEO DE TABLAS DDL

### 2.1 Tablas Heredadas de Core

| Schema Core | Tablas | Uso en Retail |
|-------------|--------|---------------|
| auth.users | 26 tablas | Autenticacion completa |
| auth.tenants | | Multi-tenancy |
| auth.roles | | Roles (cajero, supervisor, gerente) |
| auth.permissions | | Permisos granulares |
| core.partners | 12 tablas | Clientes y proveedores |
| core.countries | | Paises |
| core.currencies | | Monedas |
| financial.accounts | 15 tablas | Contabilidad basica |
| financial.invoices | | Facturas base para CFDI |
| financial.payments | | Pagos |
| inventory.products | 20 tablas | Productos base |
| inventory.warehouses | | Almacenes (sucursales) |
| inventory.locations | | Ubicaciones |
| inventory.stock_moves | | Movimientos de stock |
| sales.orders | 10 tablas | Ordenes de venta base |
| sales.pricelists | | Listas de precios |

### 2.2 Tablas Nuevas de Retail

| Tabla Retail | Schema | Relaciona Con Core |
|--------------|--------|-------------------|
| retail.branches | retail | auth.tenants, inventory.warehouses |
| retail.cash_registers | retail | retail.branches |
| retail.pos_sessions | retail | auth.users, retail.cash_registers |
| retail.pos_orders | retail | core.partners, retail.pos_sessions |
| retail.pos_order_lines | retail | inventory.products |
| retail.pos_payments | retail | retail.pos_orders |
| retail.cash_movements | retail | retail.pos_sessions |
| retail.branch_stock | retail | retail.branches, inventory.products |
| retail.stock_transfers | retail | retail.branches |
| retail.stock_transfer_lines | retail | inventory.products |
| retail.product_barcodes | retail | inventory.products |
| retail.promotions | retail | auth.tenants |
| retail.promotion_products | retail | inventory.products |
| retail.loyalty_programs | retail | auth.tenants |
| retail.loyalty_cards | retail | core.partners |
| retail.loyalty_transactions | retail | retail.loyalty_cards |

---

## 3. MAPEO DE SERVICIOS BACKEND

### 3.1 Servicios a Heredar (Import)

| Servicio Retail | Servicio Core | Metodo |
|-----------------|---------------|--------|
| AuthService | auth.service.ts | Import directo |
| UsersService | users.service.ts | Import directo |
| RolesService | roles.service.ts | Import directo |
| TenantsService | tenants.service.ts | Import directo |
| CountriesService | countries.service.ts | Import directo |
| CurrenciesService | currencies.service.ts | Import directo |

### 3.2 Servicios a Extender (class extends)

| Servicio Retail | Servicio Core Base | Extensiones |
|-----------------|-------------------|-------------|
| RetailProductsService | products.service.ts | + barcodes, + promotions |
| RetailInventoryService | inventory.service.ts | + branch_stock, + transfers |
| RetailSalesService | orders.service.ts | + pos_orders, + payments |
| RetailPricelistService | pricelists.service.ts | + promotions, + cupones |
| RetailInvoiceService | invoices.service.ts | + CFDI 4.0, + timbrado |
| RetailCustomersService | partners.service.ts | + loyalty, + points |

### 3.3 Servicios Nuevos (Crear)

| Servicio | Modulo | Descripcion |
|----------|--------|-------------|
| POSSessionService | RT-002 | Sesiones de caja |
| POSOrderService | RT-002 | Ventas POS |
| CashRegisterService | RT-007 | Gestion de cajas |
| CashMovementService | RT-007 | Movimientos efectivo |
| CashClosingService | RT-007 | Cortes de caja |
| BranchService | RT-003 | Gestion sucursales |
| BranchStockService | RT-003 | Stock por sucursal |
| TransferService | RT-003 | Transferencias |
| PromotionService | RT-006 | Promociones |
| LoyaltyService | RT-005 | Programa puntos |
| EcommerceCartService | RT-009 | Carrito compras |
| EcommerceCheckoutService | RT-009 | Checkout |
| CFDIService | RT-010 | Timbrado CFDI |

---

## 4. MAPEO DE ENTIDADES TYPEORM

### 4.1 Entidades Heredadas

| Entidad Core | Uso en Retail |
|--------------|---------------|
| User | Usuarios y cajeros |
| Tenant | Empresas retail |
| Company | Companias |
| Role | Roles (cajero, supervisor) |
| Permission | Permisos |
| Partner | Clientes y proveedores |
| Product | Productos base |
| ProductVariant | Variantes |
| Warehouse | Almacenes (por sucursal) |
| Location | Ubicaciones |
| Invoice | Facturas base |
| Payment | Pagos |
| Pricelist | Listas de precios |

### 4.2 Entidades Nuevas de Retail

| Entidad | Relaciones |
|---------|-----------|
| Branch | → Tenant, → Warehouse |
| CashRegister | → Branch |
| POSSession | → CashRegister, → User |
| POSOrder | → POSSession, → Partner |
| POSOrderLine | → POSOrder, → Product |
| POSPayment | → POSOrder |
| CashMovement | → POSSession |
| BranchStock | → Branch, → Product |
| StockTransfer | → Branch (source), → Branch (dest) |
| StockTransferLine | → StockTransfer, → Product |
| ProductBarcode | → Product |
| Promotion | → Tenant |
| PromotionProduct | → Promotion, → Product |
| LoyaltyProgram | → Tenant |
| LoyaltyCard | → LoyaltyProgram, → Partner |
| LoyaltyTransaction | → LoyaltyCard |

---

## 5. MAPEO DE ESPECIFICACIONES TRANSVERSALES

### 5.1 SPECs Aplicables

| SPEC Core | Modulo Retail | Aplicacion |
|-----------|---------------|------------|
| SPEC-PRICING-RULES | RT-006 | Motor de precios y promociones |
| SPEC-INVENTARIOS-CICLICOS | RT-003 | Conteos de inventario |
| SPEC-TRAZABILIDAD-LOTES-SERIES | RT-003 | Productos con caducidad |
| SPEC-VALORACION-INVENTARIO | RT-003 | Costeo de productos |
| SPEC-SISTEMA-SECUENCIAS | RT-002, RT-010 | Foliado tickets, facturas |
| SPEC-REPORTES-FINANCIEROS | RT-008 | Reportes de caja |

### 5.2 SPECs No Aplicables

| SPEC Core | Razon |
|-----------|-------|
| SPEC-INTEGRACION-CALENDAR | No requiere calendario |
| SPEC-PROYECTOS-DEPENDENCIAS | No hay proyectos largos |
| SPEC-FIRMA-ELECTRONICA-NOM151 | Solo CFDI, no NOM 151 |

---

## 6. MAPEO DE ENDPOINTS API

### 6.1 Endpoints Heredados

| Endpoint Core | Uso en Retail |
|---------------|---------------|
| POST /auth/login | Login cajeros |
| POST /auth/logout | Logout |
| GET /users | Listado usuarios |
| GET /products | Productos |
| GET /partners | Clientes |
| GET /pricelists | Listas de precios |

### 6.2 Endpoints Nuevos

| Endpoint | Metodo | Descripcion |
|----------|--------|-------------|
| /pos/sessions | GET, POST | Sesiones de caja |
| /pos/sessions/:id/close | POST | Cerrar sesion |
| /pos/orders | GET, POST | Ventas POS |
| /pos/orders/:id/pay | POST | Pagar orden |
| /cash/movements | GET, POST | Movimientos efectivo |
| /cash/closings | GET, POST | Cortes de caja |
| /branches | GET, POST, PUT | Sucursales |
| /branches/:id/stock | GET | Stock sucursal |
| /transfers | GET, POST | Transferencias |
| /promotions | GET, POST, PUT | Promociones |
| /loyalty/cards | GET, POST | Tarjetas lealtad |
| /loyalty/transactions | GET, POST | Movimientos puntos |
| /cfdi/timbrar | POST | Timbrar factura |
| /cfdi/cancelar | POST | Cancelar CFDI |

---

## 7. MATRIZ DE DEPENDENCIAS CRUZADAS

### 7.1 Core → Retail

```
MGN-001 Auth ───────► RT-001 Fundamentos (100%)
MGN-002 Users ──────► RT-001 Fundamentos (100%)
MGN-003 Roles ──────► RT-001 Fundamentos (100%)
MGN-004 Tenants ────► RT-001 Fundamentos (100%)
MGN-010 Financial ──► RT-010 Facturacion (60%)
MGN-011 Inventory ──► RT-003 Inventario (60%)
MGN-012 Purchasing ─► RT-004 Compras (80%)
MGN-013 Sales ──────► RT-006 Precios (30%)
MGN-014 CRM ────────► RT-005 Clientes (40%)
MGN-009 Reports ────► RT-008 Reportes (70%)
```

### 7.2 Retail Interno

```
RT-001 ──► RT-002 (base auth)
RT-001 ──► RT-003 (base auth)
RT-001 ──► RT-004 (base auth)
RT-001 ──► RT-005 (base auth)
RT-001 ──► RT-006 (base auth)
RT-001 ──► RT-007 (base auth)
RT-001 ──► RT-008 (base auth)
RT-001 ──► RT-009 (base auth)
RT-001 ──► RT-010 (base auth)

RT-006 ──► RT-002 (precios en POS)
RT-003 ──► RT-002 (stock en POS)
RT-005 ──► RT-002 (clientes en POS)

RT-003 ◄──► RT-004 (inventario y compras)

RT-002 ──► RT-007 (ventas → caja)
RT-002 ──► RT-010 (ventas → factura)

RT-003 ──► RT-009 (stock en ecommerce)
RT-005 ──► RT-009 (clientes en ecommerce)
RT-006 ──► RT-009 (precios en ecommerce)

RT-002, RT-003, RT-005, RT-006, RT-007 ──► RT-008 (reportes)
```

---

## 8. RESUMEN DE ACCIONES

### 8.1 Por Tipo de Integracion

| Tipo | Cantidad | Modulos |
|------|----------|---------|
| HEREDAR (100%) | 4 | RT-001 |
| EXTENDER (30-80%) | 6 | RT-003, RT-004, RT-005, RT-006, RT-008, RT-010 |
| CREAR NUEVO (10-20%) | 3 | RT-002, RT-007, RT-009 |

### 8.2 Por Capa

| Capa | Heredar | Extender | Crear |
|------|---------|----------|-------|
| Database | 144 tablas | 0 | 26 tablas |
| Backend Services | 6 | 6 | 13 |
| Entities | 13 | 0 | 16 |
| Endpoints | 10+ | 5 | 20+ |

---

**Documento generado:** 2025-12-18
**Fase:** 1 - Planeacion - Mapeo Core-Retail
**Estado:** COMPLETO