193 lines
4.3 KiB
Markdown
193 lines
4.3 KiB
Markdown
# 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*
|