# 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
