erp-retail/docs/00-vision-general/VISION-RETAIL.md

2.3 KiB

Visión General - ERP Retail

Versión: 1.0 Fecha: 2025-12-08 Nivel: 2B.2 (Vertical)


Propósito del Sistema

Sistema ERP especializado para comercio minorista con punto de venta (POS), gestión de inventario multi-sucursal, control de caja y programas de fidelización. Optimizado para operación en tienda física con capacidad offline.


Dominio del Negocio

Procesos Principales

  1. Punto de Venta (POS)

    • Venta rápida en mostrador
    • Múltiples métodos de pago
    • Facturación CFDI 4.0
    • Operación offline
  2. Inventario Multi-Sucursal

    • Control de stock por sucursal
    • Transferencias entre tiendas
    • Conteos cíclicos
    • Alertas de reorden
  3. Compras y Reabastecimiento

    • Órdenes de compra centralizadas
    • Distribución a sucursales
    • Control de proveedores
  4. Clientes y Fidelización

    • Programa de lealtad
    • Puntos y recompensas
    • Historial de compras
  5. Gestión de Caja

    • Apertura y cierre de caja
    • Arqueos
    • Control de efectivo

Arquitectura de Módulos

RT-001 Fundamentos  → Auth, Users, Tenants (hereda 100% core)
RT-002 POS          → Punto de venta (20% core)
RT-003 Inventario   → Stock multi-sucursal (60% core)
RT-004 Compras      → Reabastecimiento (80% core)
RT-005 Clientes     → Programa fidelidad (40% core)
RT-006 Precios      → Promociones, descuentos (30% core)
RT-007 Caja         → Arqueos, cortes (10% core)
RT-008 Reportes     → Dashboard ventas (70% core)
RT-009 E-commerce   → Tienda online (20% core)
RT-010 Facturación  → CFDI 4.0 (60% core)

Stack Tecnológico

  • Backend: NestJS + TypeORM + PostgreSQL
  • Frontend POS: React + PWA (offline-first)
  • Base de Datos: PostgreSQL 15+ (hereda ERP Core)
  • Hardware: Impresora térmica, lector de códigos, cajón

Métricas Objetivo

Métrica Valor Objetivo
Módulos 10
Tablas Específicas ~30
Tablas Heredadas ~102
Story Points Est. ~280
Tiempo Venta < 30 segundos
Disponibilidad 99.9%

Referencias

  • ERP Core: apps/erp-core/
  • Herencia DB: database/HERENCIA-ERP-CORE.md
  • SPECS del Core: HERENCIA-SPECS-CORE.md
  • Inventarios: orchestration/inventarios/

Documento de visión oficial Última actualización: 2025-12-08