# Herencia SIMCO - ERP Core

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

---

## Configuración del Proyecto

| Propiedad | Valor |
|-----------|-------|
| **Proyecto** | ERP Core - Núcleo del Sistema ERP |
| **Nivel** | SUITE_CORE (Nivel 2) |
| **Padre** | erp-suite |
| **SIMCO Version** | 2.2.0 |
| **CAPVED** | Habilitado |
| **CCA Protocol** | Habilitado |

## Jerarquía de Herencia

```
Nivel 0: core/orchestration/                    ← FUENTE PRINCIPAL (76 docs)
    │
    └── Nivel 1: erp-suite/orchestration/       ← PADRE DIRECTO
            │
            └── Nivel 2: erp-core/orchestration/ ← ESTE PROYECTO
                    │
                    └── Nivel 3: verticales/*/orchestration/
                        ├── construccion     (hereda de aquí)
                        ├── vidrio-templado  (hereda de aquí)
                        ├── mecanicas-diesel (hereda de aquí)
                        ├── retail           (hereda de aquí)
                        └── clinicas         (hereda de aquí)
```

**Regla:** Las directivas de nivel inferior pueden EXTENDER las superiores, nunca REDUCIRLAS.

**Responsabilidad:** ERP Core provee el 60-70% del código base que las verticales extienden.

---

## Directivas Heredadas de CORE (OBLIGATORIAS)

Ubicación: `core/orchestration/`

### 1. Ciclo de Vida - USAR SIEMPRE

| Alias | Archivo | Propósito | Cuándo Usar |
|-------|---------|-----------|-------------|
| `@TAREA` | `directivas/simco/SIMCO-TAREA.md` | Punto de entrada | **Toda HU/tarea que genera commit** |
| `@CAPVED` | `directivas/principios/PRINCIPIO-CAPVED.md` | Ciclo de 6 fases | Contexto→Análisis→Plan→Validación→Ejecución→Doc |
| `@INICIALIZACION` | `directivas/simco/SIMCO-INICIALIZACION.md` | Bootstrap de agentes | Al iniciar cualquier agente |

### 2. Operaciones Universales

| Alias | Archivo | Propósito |
|-------|---------|-----------|
| `@CREAR` | `directivas/simco/SIMCO-CREAR.md` | Crear cualquier archivo nuevo |
| `@MODIFICAR` | `directivas/simco/SIMCO-MODIFICAR.md` | Modificar archivos existentes |
| `@VALIDAR` | `directivas/simco/SIMCO-VALIDAR.md` | Validar código (build, lint, tests) |
| `@DOCUMENTAR` | `directivas/simco/SIMCO-DOCUMENTAR.md` | Documentar trabajo realizado |
| `@BUSCAR` | `directivas/simco/SIMCO-BUSCAR.md` | Buscar archivos e información |
| `@DELEGAR` | `directivas/simco/SIMCO-DELEGACION.md` | Delegar trabajo a subagentes |

### 3. Catálogo de Funcionalidades

| Alias | Archivo | Propósito |
|-------|---------|-----------|
| `@CATALOG` | `catalog/` | Directorio de funcionalidades reutilizables |
| `@CATALOG_INDEX` | `catalog/CATALOG-INDEX.yml` | Índice machine-readable |
| `@REUTILIZAR` | `directivas/simco/SIMCO-REUTILIZAR.md` | ANTES de implementar algo común |
| `@CONTRIBUIR` | `directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md` | DESPUÉS de crear algo reutilizable |

**Funcionalidades del catálogo implementadas en ERP Core:**

| Funcionalidad | Estado | Notas |
|---------------|--------|-------|
| `auth` | Implementada | JWT + bcryptjs |
| `multi-tenancy` | Implementada | RLS por constructora_id |
| `session-management` | Implementada | Tokens de sesión |
| `rate-limiting` | Implementada | express-rate-limit |

### 4. Principios Fundamentales (5)

| Alias | Archivo | Resumen |
|-------|---------|---------|
| `@CAPVED` | `PRINCIPIO-CAPVED.md` | Toda tarea pasa por 6 fases |
| `@DOC_PRIMERO` | `PRINCIPIO-DOC-PRIMERO.md` | Consultar docs/ antes de implementar |
| `@ANTI_DUP` | `PRINCIPIO-ANTI-DUPLICACION.md` | Verificar que no existe antes de crear |
| `@VALIDACION` | `PRINCIPIO-VALIDACION-OBLIGATORIA.md` | Build y lint DEBEN pasar |
| `@TOKENS` | `PRINCIPIO-ECONOMIA-TOKENS.md` | Desglosar tareas grandes |

---

## Directivas por Dominio Técnico

| Alias | Archivo | Tecnologías | Aplica a ERP Core |
|-------|---------|-------------|-------------------|
| `@OP_DDL` | `SIMCO-DDL.md` | PostgreSQL, SQL | **SÍ** - Schemas base |
| `@OP_BACKEND` | `SIMCO-BACKEND.md` | Express, TypeORM | **SÍ** - API principal |
| `@OP_FRONTEND` | `SIMCO-FRONTEND.md` | React, TypeScript | **SÍ** - UI base |
| `@OP_MOBILE` | `SIMCO-MOBILE.md` | React Native | **SÍ** - App móvil |
| `@OP_ML` | `SIMCO-ML.md` | Python, FastAPI | NO |

---

## Patrones Heredados (OBLIGATORIOS para ERP Core)

Ubicación: `core/orchestration/patrones/`

| Patrón | Uso Obligatorio | Notas |
|--------|-----------------|-------|
| `MAPEO-TIPOS-DDL-TYPESCRIPT.md` | **SÍ** | Mapeo consistente BD↔TypeScript |
| `PATRON-VALIDACION.md` | **SÍ** | Zod + class-validator en DTOs |
| `PATRON-EXCEPTION-HANDLING.md` | **SÍ** | HttpException estandarizado |
| `PATRON-TESTING.md` | **SÍ** | Jest + cobertura mínima 80% |
| `PATRON-LOGGING.md` | **SÍ** | Winston con correlation IDs |
| `PATRON-CONFIGURACION.md` | **SÍ** | Validación de env vars |
| `PATRON-SEGURIDAD.md` | **SÍ** | OWASP Top 10 |
| `PATRON-PERFORMANCE.md` | Recomendado | Optimización de queries |
| `PATRON-TRANSACCIONES.md` | **SÍ** | TypeORM QueryRunner |
| `ANTIPATRONES.md` | **SÍ** | Evitar siempre |
| `NOMENCLATURA-UNIFICADA.md` | **SÍ** | Consistencia obligatoria |

---

## Impactos y Dependencias

| Documento | Consultar Cuando |
|-----------|------------------|
| `IMPACTO-CAMBIOS-DDL.md` | Modificar schema base |
| `IMPACTO-CAMBIOS-BACKEND.md` | Modificar servicios core |
| `IMPACTO-CAMBIOS-ENTITY.md` | Modificar entities base |
| `IMPACTO-CAMBIOS-API.md` | Modificar endpoints compartidos |
| `MATRIZ-DEPENDENCIAS.md` | Ver impacto en verticales |

**IMPORTANTE:** Cambios en ERP Core impactan a TODAS las verticales.

---

## Directivas Heredadas de ERP Suite (Nivel 1)

Ubicación: `projects/erp-suite/orchestration/`

| Directiva Suite | Propósito | Aplicación |
|-----------------|-----------|------------|
| `HERENCIA-SIMCO.md` | Configuración SIMCO para suite | Heredar configuración |
| Directivas multi-tenant | RLS por constructora_id | Toda query |

---

## Directivas Específicas de ERP Core

Ubicación: `./directivas/`

### Directivas ACTIVAS

| Directiva Local | Extiende | Propósito |
|-----------------|----------|-----------|
| `DIRECTIVA-MULTI-TENANT.md` | `@PATRON-SEGURIDAD` | RLS obligatorio por tenant |
| `DIRECTIVA-EXTENSION-VERTICALES.md` | `@NIVELES` | Cómo verticales extienden core |
| `DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md` | `@DOC_PRIMERO` | Docs ANTES de código |
| `DIRECTIVA-PATRONES-ODOO.md` | `@PATRONES` | Patrones de diseño ERP |

### Directivas PENDIENTES (por crear con SIMCO)

| Directiva | Extiende | Propósito |
|-----------|----------|-----------|
| `DIRECTIVA-HERENCIA-MODULOS.md` | `@CREAR` | Herencia de módulos base |
| `ESTANDARES-API-REST-GENERICO.md` | `@OP_BACKEND` | APIs RESTful estándar |

---

## Variables de Contexto CCA

```yaml
# Variables para resolver en ALIASES y templates
PROJECT_NAME: "erp-core"
PROJECT_LEVEL: "SUITE_CORE"
PROJECT_ROOT: "./"
PARENT_PROJECT: "erp-suite"

# Rutas específicas
DB_DDL_PATH: "database/ddl"
BACKEND_ROOT: "backend/src"
FRONTEND_ROOT: "frontend/src"
DOCS_ROOT: "./docs/"

# Stack
BACKEND_FRAMEWORK: "Express.js"
ORM: "TypeORM"
FRONTEND_FRAMEWORK: "React"
BUILD_TOOL: "Vite"

# Inventarios
MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"
DATABASE_INVENTORY: "orchestration/inventarios/DATABASE_INVENTORY.yml"
BACKEND_INVENTORY: "orchestration/inventarios/BACKEND_INVENTORY.yml"
FRONTEND_INVENTORY: "orchestration/inventarios/FRONTEND_INVENTORY.yml"

# Multi-tenant
TENANT_COLUMN: "constructora_id"
RLS_CONTEXT: "app.current_constructora_id"
```

---

## Perfiles de Agentes más usados en ERP Core

| Perfil | Especialización | Frecuencia |
|--------|-----------------|------------|
| `PERFIL-DATABASE.md` | Schemas base, RLS | Alta |
| `PERFIL-BACKEND.md` | Servicios, Controllers | Alta |
| `PERFIL-FRONTEND.md` | Componentes React | Alta |
| `PERFIL-ARCHITECTURE-ANALYST.md` | Decisiones de arquitectura | Media |
| `PERFIL-CODE-REVIEWER.md` | Revisión de código | Media |

---

## Mapeo: Directivas Antiguas → SIMCO

| Directiva Antigua | Reemplazada Por | Alias |
|-------------------|-----------------|-------|
| `DIRECTIVA-FLUJO-5-FASES.md` | `SIMCO-TAREA.md` + `PRINCIPIO-CAPVED.md` | @TAREA, @CAPVED |
| `DIRECTIVA-VALIDACION-SUBAGENTES.md` | `SIMCO-VALIDAR.md` | @VALIDAR |
| `POLITICAS-USO-AGENTES.md` | `SIMCO-DELEGACION.md` | @DELEGAR |
| `DIRECTIVA-DOCUMENTACION-OBLIGATORIA.md` | `SIMCO-DOCUMENTAR.md` | @DOCUMENTAR |
| `DIRECTIVA-CALIDAD-CODIGO.md` | `patrones/ANTIPATRONES.md` | @PATRONES |
| `DIRECTIVA-DISENO-BASE-DATOS.md` | `SIMCO-DDL.md` | @OP_DDL |

---

## Módulos Base de ERP Core

| Módulo | Descripción | Extensible |
|--------|-------------|------------|
| `auth` | Autenticación JWT | Sí |
| `users` | Gestión de usuarios | Sí |
| `roles` | RBAC | Sí |
| `companies` | Multi-empresa | Sí |
| `branches` | Sucursales | Sí |
| `catalogs` | Catálogos base | Sí |
| `audit` | Auditoría | No (core only) |

Las verticales EXTIENDEN estos módulos, NUNCA los modifican directamente.

---

## Flujo de Trabajo para Desarrollo en ERP Core

```yaml
# PASO 1: Cargar contexto (CCA)
CARGAR:
  - @TAREA
  - @CAPVED
  - @INICIALIZACION
  - ../erp-suite/HERENCIA-SIMCO.md  # Contexto padre

# PASO 2: Verificar catálogo
VERIFICAR:
  - @CATALOG_INDEX  # ¿Existe funcionalidad similar?
  - @REUTILIZAR     # Si existe, reutilizar

# PASO 3: Seleccionar operación
OPERACION:
  - @OP_DDL         # Si es base de datos
  - @OP_BACKEND     # Si es API
  - @OP_FRONTEND    # Si es UI

# PASO 4: Aplicar patrones
PATRONES:
  - @PATRON-VALIDACION
  - @PATRON-EXCEPTION-HANDLING
  - @PATRON-SEGURIDAD  # Multi-tenant obligatorio

# PASO 5: Validar impactos
IMPACTOS:
  - @MATRIZ-DEPENDENCIAS  # Impacto en verticales

# PASO 6: Documentar y propagar
CIERRE:
  - @DOCUMENTAR
  - @PROPAGACION  # Notificar a verticales si aplica
```

---

## Responsabilidades como SUITE_CORE

1. **Proveer módulos base** que las verticales extienden
2. **Definir interfaces** que las verticales implementan
3. **NO contener lógica de negocio** específica de verticales
4. **Mantener compatibilidad** con todas las verticales
5. **Documentar puntos de extensión** claramente

---

## Propagacion de Mejoras

Este proyecto participa en el sistema de propagacion de mejoras de NEXUS.

### Modulos Base Usados

| Modulo | Version | Estado |
|--------|---------|--------|
| auth-jwt-nestjs | 2.1.0 | Al dia |
| auth-multi-tenant | 2.0.0 | Al dia |
| users-roles-permissions | 2.0.0 | Al dia |
| users-multi-tenant | 2.0.0 | Al dia |
| ui-admin-dashboard | 2.0.0 | Al dia |
| ui-data-tables | 2.0.0 | Al dia |
| api-filtering-sorting | 1.2.0 | Al dia |
| db-audit-trail | 1.5.0 | Al dia |
| db-multi-tenant-schema | 2.0.0 | Al dia |
| integration-odoo-connector | 1.5.0 | Al dia |

Ver estado completo: `shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml`

### Recibir Propagaciones

1. Se crea una tarea de propagacion
2. Evaluar si la mejora aplica a este proyecto
3. **IMPORTANTE:** Evaluar impacto en verticales dependientes
4. Implementar cambios siguiendo guia de migracion
5. Propagar a verticales si aplica
6. Actualizar esta tabla con nueva version

Ver directiva completa: @PROPAGACION

### Propagar Mejoras desde Este Proyecto

```bash
./devtools/scripts/propagation/propagate-module-update.sh <modulo> <version> erp-core
```

**Nota:** Como SUITE_CORE, las mejoras aqui pueden requerir propagacion a verticales.

---

**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Nivel:** SUITE_CORE (2)
**Última actualización:** 2026-01-04
