# Contexto del Proyecto: ERP Retail / Punto de Venta

## Metadatos

| Campo | Valor |
|-------|-------|
| **Nombre** | ERP Retail - Punto de Venta |
| **Tipo** | STANDALONE (Proyecto Independiente) |
| **Nivel** | Vertical que extiende erp-core |
| **Estado** | Por iniciar |
| **Progreso** | 0% |
| **Version** | 0.0.1 |
| **Base** | Extiende projects/erp-core (60-70%) |
| **Extension** | Modulos especificos (+30-40%) |
| **Path** | `/home/isem/workspace-v1/projects/erp-retail/` |
| **Fecha Migracion** | 2025-12-27 |

---

## VARIABLES PARA DIRECTIVAS GLOBALES

```yaml
# Identificacion del Proyecto
PROJECT:             erp-retail
PROJECT_NAME:        ERP Retail
PROJECT_LEVEL:       STANDALONE

# Paths Principales (WORKSPACE-V1)
WORKSPACE_ROOT:      ~/workspace-v1
PROJECT_ROOT:        ~/workspace-v1/projects/erp-retail
APPS_ROOT:           ~/workspace-v1/projects/erp-retail
DOCS_ROOT:           ~/workspace-v1/projects/erp-retail/docs
ORCHESTRATION:       ~/workspace-v1/projects/erp-retail/orchestration

# Herencia de ERP-Core
ERP_CORE_ROOT:       ~/workspace-v1/projects/erp-core
HERENCIA_DOC:        orchestration/00-guidelines/HERENCIA-ERP-CORE.md

# Base Orchestration (Directivas y Perfiles)
DIRECTIVAS_PATH:     ~/workspace-v1/orchestration/directivas
PERFILES_PATH:       ~/workspace-v1/orchestration/agents/perfiles
CATALOG_PATH:        ~/workspace-v1/shared/catalog

# Base de Datos
DB_NAME:             erp_retail
DB_DDL_PATH:         ~/workspace-v1/projects/erp-retail/database/ddl
DB_SCRIPTS_PATH:     ~/workspace-v1/projects/erp-retail/database

# Backend
BACKEND_ROOT:        ~/workspace-v1/projects/erp-retail/backend
BACKEND_SRC:         ~/workspace-v1/projects/erp-retail/backend/src

# Frontend
FRONTEND_ROOT:       ~/workspace-v1/projects/erp-retail/frontend
FRONTEND_SRC:        ~/workspace-v1/projects/erp-retail/frontend/src
```

---

## 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-v1/projects/erp-retail/
├── backend/              # Extensiones backend
├── frontend/             # UI especializada (incluye POS)
├── database/             # DDL vertical
├── docs/                 # Documentacion
└── orchestration/        # Sistema NEXUS
    ├── 00-guidelines/
    └── referencias/
```

---

## 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-v1/orchestration/directivas/` |
| Directivas ERP-Core | `/home/isem/workspace-v1/projects/erp-core/orchestration/directivas/` |
| Herencia directivas | `./HERENCIA-DIRECTIVAS.md` |
| Dependencias ERP-Core | `../referencias/DEPENDENCIAS-ERP-CORE.yml` |
| Dependencias Shared | `../referencias/DEPENDENCIAS-SHARED.yml` |

---
*Ultima actualizacion: Diciembre 2025*