rckrdmrd/erp-retail
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
35718d707e
erp-retail/orchestration/00-guidelines/HERENCIA-ERP-CORE.md

4.3 KiB
Raw Blame History

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

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

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

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

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

Propios de Retail

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