erp-retail/orchestration/00-guidelines/HERENCIA-SIMCO.md

3.0 KiB

Herencia SIMCO - ERP Retail

Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol Fecha: 2025-12-08


Configuración del Proyecto

Propiedad Valor
Proyecto ERP Retail - Vertical para Comercios
Nivel VERTICAL (Nivel 3)
Padre erp-core
Suite erp-suite
SIMCO Version 2.2.0
CAPVED Habilitado
CCA Protocol Habilitado
Estado 0% - Futuro

Jerarquía de Herencia

Nivel 0: core/orchestration/                    ← FUENTE PRINCIPAL
    └── Nivel 1: erp-suite/orchestration/
            └── Nivel 2: erp-core/orchestration/ ← PADRE DIRECTO
                    └── Nivel 3: retail/orchestration/ ← ESTE PROYECTO

Directivas Heredadas de CORE (OBLIGATORIAS)

Ciclo de Vida

Alias Propósito
@TAREA Punto de entrada para toda HU
@CAPVED Ciclo de 6 fases
@INICIALIZACION Bootstrap de agentes

Operaciones Universales

Alias Propósito
@CREAR Crear archivos nuevos
@MODIFICAR Modificar existentes
@VALIDAR Validar código
@DOCUMENTAR Documentar trabajo
@BUSCAR Buscar información
@DELEGAR Delegar a subagentes

Principios Fundamentales

Alias Resumen
@CAPVED Toda tarea pasa por 6 fases
@DOC_PRIMERO Consultar docs/ antes de implementar
@ANTI_DUP Verificar que no existe
@VALIDACION Build y lint DEBEN pasar
@TOKENS Desglosar tareas grandes

Directivas por Dominio Técnico

Alias Aplica Notas
@OP_DDL Schemas de comercio
@OP_BACKEND Servicios POS, inventario
@OP_FRONTEND UI de punto de venta
@OP_MOBILE App de ventas
@OP_ML Futuro Predicción de demanda

Patrones Heredados (OBLIGATORIOS)

Todos los patrones de core/orchestration/patrones/ aplican.


Directivas Heredadas de ERP Core

Directiva Extensión Local
DIRECTIVA-MULTI-TENANT.md Por comercio_id
DIRECTIVA-EXTENSION-VERTICALES.md Módulos de retail

Variables de Contexto CCA

PROJECT_NAME: "retail"
PROJECT_LEVEL: "VERTICAL"
PROJECT_ROOT: "./"
PARENT_PROJECT: "erp-core"
SUITE_PROJECT: "erp-suite"

DB_DDL_PATH: "database/ddl"
BACKEND_ROOT: "backend/src"
FRONTEND_ROOT: "frontend/src"

TENANT_COLUMN: "comercio_id"
RLS_CONTEXT: "app.current_comercio_id"

Módulos Específicos de Retail (Por definir)

Módulo Descripción Estado
RET-POS Punto de venta Por definir
RET-INV Inventario Por definir
RET-PRO Productos Por definir
RET-CLI Clientes/fidelización Por definir
RET-REP Reportes de ventas Por definir

Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol Nivel: VERTICAL (3) Última actualización: 2025-12-08