rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
workspace-v1/orchestration/templates/HERENCIA-SIMCO.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

314 lines
12 KiB
Markdown
Raw Permalink Blame History

# Template: Herencia SIMCO para Proyectos
**Versión:** 1.0.0
**Sistema:** SIMCO v2.2.0 + CAPVED + CCA
**Uso:** Copiar y adaptar para cada proyecto
---
## Instrucciones de Uso
1. Copiar este archivo a `{proyecto}/orchestration/00-guidelines/HERENCIA-SIMCO.md`
2. Reemplazar todas las variables `{VARIABLE}` con valores del proyecto
3. Eliminar secciones que no apliquen según el nivel del proyecto
4. Este archivo REEMPLAZA el antiguo `HERENCIA-DIRECTIVAS.md`
---
# Herencia SIMCO - {NOMBRE_PROYECTO}
## Configuración del Proyecto
| Propiedad | Valor |
|-----------|-------|
| **Proyecto** | {NOMBRE_PROYECTO} |
| **Nivel** | {STANDALONE / SUITE / SUITE_CORE / VERTICAL / PRODUCT} |
| **Padre** | {PROYECTO_PADRE o "core" si es standalone} |
| **SIMCO Version** | 2.2.0 |
| **CAPVED** | Habilitado |
| **CCA Protocol** | Habilitado |
## Jerarquía de Herencia
```
{AJUSTAR SEGÚN NIVEL DEL PROYECTO}
Nivel 0: core/orchestration/ ← FUENTE PRINCIPAL
│
└── Nivel 1: {suite}/orchestration/ ← (si aplica)
│
└── Nivel 2: {suite-core}/orchestration/ ← (si aplica)
│
└── Nivel 3: {ESTE_PROYECTO}/orchestration/
```
**Regla:** Las directivas de nivel inferior pueden EXTENDER las superiores, nunca REDUCIRLAS.
---
## 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 |
### 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
Usar según las tecnologías del proyecto:
| Alias | Archivo | Tecnologías | Aplica a {NOMBRE_PROYECTO} |
|-------|---------|-------------|---------------------------|
| `@OP_DDL` | `SIMCO-DDL.md` | PostgreSQL, SQL | {SI/NO} |
| `@OP_BACKEND` | `SIMCO-BACKEND.md` | NestJS, Express, TypeORM, Prisma | {SI/NO} |
| `@OP_FRONTEND` | `SIMCO-FRONTEND.md` | React, TypeScript, Vite | {SI/NO} |
| `@OP_MOBILE` | `SIMCO-MOBILE.md` | React Native, Expo | {SI/NO} |
| `@OP_ML` | `SIMCO-ML.md` | Python, FastAPI, ML/AI | {SI/NO} |
---
## Directivas de Niveles y Propagación
| Alias | Archivo | Propósito |
|-------|---------|-----------|
| `@NIVELES` | `SIMCO-NIVELES.md` | Identificar nivel jerárquico del proyecto |
| `@PROPAGACION` | `SIMCO-PROPAGACION.md` | Propagar cambios a niveles superiores |
| `@ALINEACION` | `SIMCO-ALINEACION.md` | Validar alineación DDL↔Entity↔DTO |
| `@DECISION_MATRIZ` | `SIMCO-DECISION-MATRIZ.md` | Decidir qué directiva usar |
---
## Patrones Heredados (RECOMENDADOS)
Ubicación: `core/orchestration/patrones/`
| Patrón | Cuándo Usar |
|--------|-------------|
| `MAPEO-TIPOS-DDL-TYPESCRIPT.md` | Mapear tipos PostgreSQL ↔ TypeScript |
| `PATRON-VALIDACION.md` | Validar inputs con class-validator/Zod |
| `PATRON-EXCEPTION-HANDLING.md` | Manejo de errores y excepciones |
| `PATRON-TESTING.md` | Escribir tests unitarios/integración |
| `PATRON-LOGGING.md` | Configurar logging estructurado |
| `PATRON-CONFIGURACION.md` | Variables de entorno y config |
| `PATRON-SEGURIDAD.md` | Implementar auth, OWASP Top 10 |
| `PATRON-PERFORMANCE.md` | Optimización y caching |
| `PATRON-TRANSACCIONES.md` | Transacciones de base de datos |
| `ANTIPATRONES.md` | Lo que NUNCA hacer |
| `NOMENCLATURA-UNIFICADA.md` | Convenciones de nombres |
---
## Impactos y Dependencias
Ubicación: `core/orchestration/impactos/`
| Documento | Consultar Cuando |
|-----------|------------------|
| `IMPACTO-CAMBIOS-DDL.md` | Modificar schema de BD |
| `IMPACTO-CAMBIOS-BACKEND.md` | Modificar servicios/controllers |
| `IMPACTO-CAMBIOS-ENTITY.md` | Modificar entities TypeORM |
| `IMPACTO-CAMBIOS-API.md` | Modificar endpoints REST |
| `MATRIZ-DEPENDENCIAS.md` | Ver cascada completa de dependencias |
---
## Checklists de Verificación
Ubicación: `core/orchestration/checklists/`
| Checklist | Usar Para |
|-----------|-----------|
| `CHECKLIST-CODE-REVIEW-API.md` | Revisar código de APIs |
| `CHECKLIST-REFACTORIZACION.md` | Antes de refactorizar |
| `CHECKLIST-PROPAGACION.md` | Verificar propagación de cambios |
---
## Perfiles de Agentes Disponibles
Ubicación: `core/orchestration/agents/perfiles/`
### Técnicos
| Perfil | Especialización |
|--------|-----------------|
| `PERFIL-DATABASE.md` | PostgreSQL, DDL, migraciones |
| `PERFIL-BACKEND.md` | NestJS, TypeORM |
| `PERFIL-BACKEND-EXPRESS.md` | Express.js, Prisma/Drizzle |
| `PERFIL-FRONTEND.md` | React, TypeScript |
| `PERFIL-MOBILE-AGENT.md` | React Native |
| `PERFIL-ML-SPECIALIST.md` | Python, ML/AI, FastAPI |
### Coordinación
| Perfil | Especialización |
|--------|-----------------|
| `PERFIL-ORQUESTADOR.md` | Coordinación general |
| `PERFIL-ARCHITECTURE-ANALYST.md` | Análisis de arquitectura |
| `PERFIL-REQUIREMENTS-ANALYST.md` | Análisis de requerimientos |
### Calidad
| Perfil | Especialización |
|--------|-----------------|
| `PERFIL-CODE-REVIEWER.md` | Revisión de código |
| `PERFIL-BUG-FIXER.md` | Corrección de bugs |
| `PERFIL-DOCUMENTATION-VALIDATOR.md` | Validación de documentación |
| `PERFIL-WORKSPACE-MANAGER.md` | Gestión de workspace |
---
## Directivas Heredadas del Padre (si aplica)
{SOLO PARA NIVELES 2, 3, 4 - AJUSTAR SEGÚN PROYECTO}
### Heredadas de {PROYECTO_PADRE}
Ubicación: `{RUTA_PADRE}/orchestration/directivas/`
| Directiva | Propósito | Cómo se Extiende |
|-----------|-----------|------------------|
| {DIRECTIVA_1} | {PROPÓSITO} | {EXTENSIÓN_LOCAL} |
| {DIRECTIVA_2} | {PROPÓSITO} | {EXTENSIÓN_LOCAL} |
---
## Directivas Específicas de {NOMBRE_PROYECTO}
Ubicación: `./directivas/`
| Directiva Local | Extiende | Propósito Específico |
|-----------------|----------|---------------------|
| {DIRECTIVA_LOCAL_1} | `@{ALIAS}` | {PROPÓSITO} |
| {DIRECTIVA_LOCAL_2} | `@{ALIAS}` | {PROPÓSITO} |
---
## Variables de Contexto del Proyecto
Para el protocolo CCA, este proyecto define:
```yaml
# Variables para resolver en ALIASES y templates
PROJECT_NAME: "{NOMBRE_PROYECTO}"
PROJECT_LEVEL: "{NIVEL}"
PROJECT_ROOT: "{RUTA_ABSOLUTA}"
# Rutas específicas
DB_DDL_PATH: "{RUTA}/database/ddl"
BACKEND_ROOT: "{RUTA}/backend"
FRONTEND_ROOT: "{RUTA}/frontend"
# Inventarios
MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"
```
---
## Flujo de Trabajo con SIMCO + CAPVED
```
┌─────────────────────────────────────────────────────────────┐
│ RECIBIR TAREA/HU │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 1. LEER @TAREA (SIMCO-TAREA.md) │
│ - Activa ciclo CAPVED │
└─────────────────────────────────────────────────────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ C │ → │ A │ → │ P │
│Contexto │ │Análisis │ │ Plan │
└─────────┘ └─────────┘ └─────────┘
│ │ │
▼ ▼ ▼
@BUSCAR @CATALOG_INDEX @TOKENS
@NIVELES @IMPACTOS @DELEGAR
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐
│ V │ → │ E │ → │ D │
│Validar │ │Ejecutar │ │ Doc │
│ Plan │ │ │ │ │
└─────────┘ └─────────┘ └─────────┘
│ │ │
▼ ▼ ▼
@ALINEACION @OP_DDL @DOCUMENTAR
@DECISION_MATRIZ @OP_BACKEND @PROPAGACION
@OP_FRONTEND
@VALIDAR
```
---
## Mapeo: Directivas Antiguas → SIMCO
Si este proyecto usaba el sistema anterior:
| 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 |
| `ESTANDARES-API-REST-GENERICO.md` | `SIMCO-BACKEND.md` | @OP_BACKEND |
---
## Checklist de Configuración
- [ ] Archivo copiado a `orchestration/00-guidelines/HERENCIA-SIMCO.md`
- [ ] Variables `{VARIABLE}` reemplazadas
- [ ] Secciones no aplicables eliminadas
- [ ] Directivas por dominio marcadas SI/NO
- [ ] Directivas heredadas del padre documentadas (si aplica)
- [ ] Directivas específicas locales listadas
- [ ] Variables de contexto CCA definidas
- [ ] `CONTEXTO-PROYECTO.md` actualizado con referencia a este archivo
---
**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol
**Template Version:** 1.0.0
Reference in New Issue View Git Blame Copy Permalink