rckrdmrd
8eaf48e635
- Add CONTEXT-MAP.yml and ENVIRONMENT-INVENTORY.yml - Add propagacion-fase8 directory - Update CONTEXTO-PROYECTO.md and DEPENDENCIAS-SHARED.yml 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
163 lines
4.8 KiB
Markdown
163 lines
4.8 KiB
Markdown
# 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*
|