# Herencia de ERP Core - Vertical Retail / POS

**Version:** 1.0.0
**Vertical:** Retail / Punto de Venta
**Nivel:** STANDALONE (proyecto independiente)
**Version ERP-Core:** 1.2.0
**Ruta ERP-Core:** projects/erp-core
**Herencia:** 60-70% de funcionalidad base de erp-core
**Fecha Migracion:** 2025-12-27

---

## RESUMEN DE HERENCIA

Este documento especifica exactamente que hereda la vertical Retail del ERP Core y como lo extiende.

---

## 1. MODULOS HEREDADOS (100%)

| Modulo Core | Codigo | Uso en Retail |
|-------------|--------|---------------|
| Auth | MGN-001 | Autenticacion rapida para POS |
| Users | MGN-002 | Cajeros, supervisores, gerentes |
| Roles | MGN-003 | Roles por puesto |
| Audit | MGN-007 | Auditoria de transacciones |
| Notifications | MGN-008 | Alertas de stock bajo |
| Reports | MGN-009 | Reportes de ventas |

**Accion:** NO crear codigo para estos modulos. Usar directamente del core.

---

## 2. MODULOS HEREDADOS Y EXTENDIDOS

### MGN-004: Tenants → Tiendas/Sucursales

```yaml
herencia_base:
  - Multi-tenancy basico

extension_retail:
  - Empresa matriz → sucursales
  - Campos adicionales:
    - tipo_establecimiento
    - horario_operacion
    - numero_cajas
    - zona_geografica
  - Relaciones:
    - empresa → sucursales (1:N)
    - sucursal → cajas (1:N)
```

### MGN-005: Catalogs → Catalogos de Productos

```yaml
herencia_base:
  - CRUD de catalogos genericos

extension_retail:
  - Catalogo de categorias de productos
  - Catalogo de marcas
  - Catalogo de proveedores retail
  - Catalogo de promociones
  - Catalogo de formas de pago
```

### MGN-011: Inventory → Inventario Multi-Sucursal

```yaml
herencia_base:
  - Productos y variantes
  - Movimientos de stock

extension_retail:
  - Stock por sucursal
  - Transferencias entre sucursales
  - Minimos/maximos por sucursal
  - Reposicion automatica
```

---

## 3. ESPECIFICACIONES TRANSVERSALES HEREDADAS

### Obligatorias

| Especificacion | Gap | Uso |
|----------------|-----|-----|
| `SPEC-PRICING-RULES.md` | GAP-MGN-007 | Precios, promociones, descuentos |
| `SPEC-INVENTARIOS-CICLICOS.md` | GAP-MGN-005 | Conteo de productos |
| `SPEC-TRAZABILIDAD-LOTES-SERIES.md` | GAP-MGN-005 | Productos con caducidad |

### Recomendadas

| Especificacion | Gap | Uso |
|----------------|-----|-----|
| `SPEC-VALORACION-INVENTARIO.md` | GAP-MGN-005 | Costeo de productos |
| `SPEC-SISTEMA-SECUENCIAS.md` | GAP-MGN-004 | Foliado de tickets |
| `SPEC-REPORTES-FINANCIEROS.md` | GAP-MGN-004 | Cortes de caja |

---

## 4. MODULOS PROPIOS (No heredados)

| Codigo | Modulo | Descripcion |
|--------|--------|-------------|
| RT-001 | pos | Punto de venta tactil |
| RT-002 | cash_register | Gestion de caja y turnos |
| RT-003 | branches | Multi-sucursal |
| RT-004 | promotions | Ofertas y descuentos |
| RT-005 | loyalty | Tarjetas y puntos |
| RT-006 | barcode | Integracion lectores |
| RT-007 | invoicing | Facturacion CFDI |

---

## 5. SCHEMAS DE BASE DE DATOS

### Heredados de Core

```yaml
schemas_core:
  - auth
  - core_users
  - core_rbac
  - core_tenants (extendido)
  - core_catalogs (extendido)
  - core_audit
```

### Propios de Retail

```yaml
schemas_vertical:
  - vertical_retail
    - pos_sessions
    - cash_movements
    - cash_closings
    - promotions
    - loyalty_cards
    - loyalty_transactions
    - branches
```

---

## 6. CONSIDERACIONES ESPECIALES

### Rendimiento POS

**CRITICO:** El POS debe responder en menos de 100ms.

- Queries optimizados para ventas
- Cache de productos frecuentes
- Modo offline con sincronizacion

### Operacion Offline

El POS debe funcionar sin conexion:
- Base de datos local (SQLite/IndexedDB)
- Sincronizacion al reconectar
- Cola de transacciones pendientes

### CFDI en Tiempo Real

- Timbrado al momento de la venta
- Manejo de errores de timbrado
- Reintento automatico

### Hardware

- Lectores de codigo de barras
- Impresoras de tickets
- Cajones de dinero
- Terminales de pago

---

## 7. REFERENCIAS

| Recurso | Ubicacion |
|---------|-----------|
| MASTER_INVENTORY Core | `erp-core/orchestration/inventarios/MASTER_INVENTORY.yml` |
| Specs Transversales | `erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/` |
| HERENCIA-DIRECTIVAS | `./HERENCIA-DIRECTIVAS.md` |

---

*Sistema NEXUS + SIMCO v2.2.0*
*Vertical: Retail/POS (Nivel 2B.2)*
*Ultima actualizacion: 2025-12-08*