rckrdmrd/erp-retail
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
8eaf48e635
erp-retail/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
rckrdmrd 8eaf48e635 feat: Add orchestration context and environment configuration 
- 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>
2026-01-07 05:37:51 -06:00

4.8 KiB
Raw Blame History

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

# 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