workspace-v1/projects/erp-retail/orchestration/00-guidelines/HERENCIA-DIRECTIVAS.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.7 KiB

Herencia de Directivas - ERP Retail

Jerarquia de Directivas

Este proyecto hereda directivas en el siguiente orden de precedencia:

1. Directivas Globales (CORE)     → /home/isem/workspace/core/orchestration/directivas/
2. Directivas ERP-Core            → /home/isem/workspace/projects/erp-suite/apps/erp-core/orchestration/directivas/
3. Directivas Retail              → ./directivas/  (este proyecto)

Regla: Las directivas especificas pueden EXTENDER las heredadas, nunca REDUCIRLAS.


Directivas Heredadas de CORE

Directiva Proposito
DIRECTIVA-FLUJO-5-FASES.md Flujo de trabajo obligatorio
DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md Docs en tiempo real
DIRECTIVA-CALIDAD-CODIGO.md Estandares de codigo
DIRECTIVA-DISENO-BASE-DATOS.md Diseno BD
DIRECTIVA-CONTROL-VERSIONES.md Git

Directivas Heredadas de ERP-Core

Directiva Proposito
DIRECTIVA-MULTI-TENANT.md Aislamiento por tenant
DIRECTIVA-EXTENSION-VERTICALES.md Como extender el core
DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md Documentar antes de desarrollar
DIRECTIVA-PATRONES-ODOO.md Patrones de diseno
DIRECTIVA-HERENCIA-MODULOS.md Extension de modulos
ESTANDARES-API-REST-GENERICO.md APIs REST

Directivas Especificas de Retail

Directiva Proposito Estado
DIRECTIVA-POS-OFFLINE.md Funcionamiento sin conexion Por crear
DIRECTIVA-SINCRONIZACION.md Sync multi-sucursal Por crear
DIRECTIVA-CAJA-FISCAL.md Cumplimiento fiscal Por crear
DIRECTIVA-RENDIMIENTO-POS.md Performance <100ms Por crear

Modulos que Usa del Core

Modulo Core Uso en Retail
MGN-001 Auth Directo
MGN-002 Users Extendido (cajero, supervisor)
MGN-004 Tenants Extendido (sucursales)
MGN-005 Catalogs Extendido (categorias retail)
MGN-010 Financial Extendido (caja, cortes)
MGN-011 Inventory Extendido (multi-ubicacion)
MGN-013 Sales Extendido (POS, tickets)
MGN-014 CRM Extendido (clientes frecuentes)

Consideraciones Especiales

Performance

  • Transacciones POS en <100ms
  • Cache agresivo de productos
  • Indices optimizados para busqueda

Offline First

  • PWA con Service Worker
  • IndexedDB para datos locales
  • Cola de sincronizacion

Fiscal

  • Timbrado CFDI en tiempo real
  • Folios fiscales por sucursal
  • Bitacora de operaciones

Referencias

  • Core: /home/isem/workspace/core/orchestration/directivas/
  • ERP-Core: /home/isem/workspace/projects/erp-suite/apps/erp-core/orchestration/directivas/

Ultima actualizacion: Diciembre 2025