# Contexto del Proyecto: ERP Retail / Punto de Venta

## Metadatos

| Campo | Valor |
|-------|-------|
| **Nombre** | ERP Retail - Punto de Venta |
| **Tipo** | Vertical Especializada |
| **Estado** | Por iniciar |
| **Progreso** | 0% |
| **Version** | 0.0.1 |
| **Workspace** | `/home/isem/workspace/projects/erp-suite/apps/verticales/retail/` |

## Descripcion

ERP especializado para comercio minorista y punto de venta. Extiende el ERP Core con funcionalidades especificas de retail, POS y gestion de tiendas.

**Funcionalidades principales:**
- Punto de Venta (POS) tactil
- Gestion de caja y turnos
- Control de inventario multi-sucursal
- Tarjetas de lealtad y promociones
- Facturacion electronica (CFDI)
- Reportes de ventas en tiempo real
- Integracion con lectores de codigo de barras

---

## Stack Tecnologico

Hereda completamente del ERP Core:
- **Backend:** Node.js + Express + TypeScript
- **Frontend:** React + TypeScript + Tailwind
- **Database:** PostgreSQL 15+
- **Auth:** JWT + Multi-tenant
- **POS:** PWA para funcionamiento offline

---

## Paths del Proyecto

```
/home/isem/workspace/projects/erp-suite/apps/verticales/retail/
├── backend/              # Extensiones backend
├── frontend/             # UI especializada (incluye POS)
├── database/             # DDL vertical
├── docs/                 # Documentacion
└── orchestration/        # Sistema NEXUS
```

---

## Modulos Especificos (MRT-*)

| Codigo | Modulo | Descripcion |
|--------|--------|-------------|
| MRT-001 | pos | Punto de venta tactil |
| MRT-002 | caja | Gestion de caja y turnos |
| MRT-003 | sucursales | Multi-sucursal |
| MRT-004 | promociones | Ofertas y descuentos |
| MRT-005 | lealtad | Tarjetas y puntos |
| MRT-006 | codigo-barras | Integracion lectores |

---

## Modulos del Core que Extiende

| Modulo Core | Extension |
|-------------|-----------|
| MGN-002 Users | Roles (cajero, supervisor, gerente) |
| MGN-005 Catalogs | Categorias retail |
| MGN-010 Financial | Caja, cortes, arqueos |
| MGN-011 Inventory | Multi-ubicacion, minimos |
| MGN-013 Sales | POS, tickets |
| MGN-014 CRM | Clientes frecuentes |

---

## Schemas de Base de Datos

```
vertical_retail            # Schema principal
├── pos_sessions          # Sesiones de caja
├── cash_movements        # Movimientos de caja
├── cash_closings         # Cortes de caja
├── promotions            # Promociones activas
├── loyalty_cards         # Tarjetas de lealtad
├── loyalty_transactions  # Acumulacion/Redencion
└── branches              # Sucursales
```

---

## Principios Especificos

1. **Velocidad:** POS debe responder en <100ms
2. **Offline:** Funcionar sin conexion (sincronizar despues)
3. **Fiscal:** Cumplir CFDI 4.0 en tiempo real
4. **Multi-sucursal:** Inventario centralizado pero distribuido

---

## Referencias

| Recurso | Path |
|---------|------|
| Directivas globales | `/home/isem/workspace/core/orchestration/directivas/` |
| Directivas ERP-Core | `/home/isem/workspace/projects/erp-suite/apps/erp-core/orchestration/directivas/` |
| Herencia directivas | `./HERENCIA-DIRECTIVAS.md` |

---
*Ultima actualizacion: Diciembre 2025*
