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

98 lines
2.3 KiB
Markdown

# 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