66161b1566
Sistema NEXUS v3.4 migrado con: Estructura principal: - core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles) - core/catalog: Catalogo de funcionalidades reutilizables - shared/knowledge-base: Base de conocimiento compartida - devtools/scripts: Herramientas de desarrollo - control-plane/registries: Control de servicios y CI/CD - orchestration/: Configuracion de orquestacion de agentes Proyectos incluidos (11): - gamilit (submodule -> GitHub) - trading-platform (OrbiquanTIA) - erp-suite con 5 verticales: - erp-core, construccion, vidrio-templado - mecanicas-diesel, retail, clinicas - betting-analytics - inmobiliaria-analytics - platform_marketing_content - pos-micro, erp-basico Configuracion: - .gitignore completo para Node.js/Python/Docker - gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git) - Sistema de puertos estandarizado (3005-3199) Generated with NEXUS v3.4 Migration System EPIC-010: Configuracion Git y Repositorios
98 lines
2.3 KiB
Markdown
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
|