rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
workspace-v1/projects/erp-retail/docs/00-vision-general/VISION-RETAIL.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4 
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
2026-01-04 03:37:42 -06:00

2.3 KiB
Raw Permalink Blame History

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