Herencia SIMCO - GAMILIT
Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol
Fecha: 2025-12-08
Configuración del Proyecto
| Propiedad |
Valor |
| Proyecto |
GAMILIT - Plataforma EdTech Gamificada |
| Nivel |
STANDALONE |
| Padre |
core/orchestration |
| SIMCO Version |
2.2.0 |
| CAPVED |
Habilitado |
| CCA Protocol |
Habilitado |
Jerarquía de Herencia
Nivel 0: core/orchestration/ ← FUENTE PRINCIPAL (76 docs)
│
└── STANDALONE: gamilit/orchestration/ ← ESTE PROYECTO
Regla: Las directivas locales pueden EXTENDER las de core, nunca REDUCIRLAS.
Estado del Proyecto: MVP 75% completado
Directivas Heredadas de CORE (OBLIGATORIAS)
Ubicación: core/orchestration/
1. Ciclo de Vida - USAR SIEMPRE
| Alias |
Archivo |
Propósito |
@TAREA |
directivas/simco/SIMCO-TAREA.md |
Punto de entrada para toda HU |
@CAPVED |
directivas/principios/PRINCIPIO-CAPVED.md |
Ciclo de 6 fases |
@INICIALIZACION |
directivas/simco/SIMCO-INICIALIZACION.md |
Bootstrap de agentes |
2. Operaciones Universales
| Alias |
Archivo |
Propósito |
@CREAR |
SIMCO-CREAR.md |
Crear archivos nuevos |
@MODIFICAR |
SIMCO-MODIFICAR.md |
Modificar existentes |
@VALIDAR |
SIMCO-VALIDAR.md |
Validar código |
@DOCUMENTAR |
SIMCO-DOCUMENTAR.md |
Documentar trabajo |
@BUSCAR |
SIMCO-BUSCAR.md |
Buscar información |
@DELEGAR |
SIMCO-DELEGACION.md |
Delegar a subagentes |
3. Catálogo de Funcionalidades
| Alias |
Archivo |
Propósito |
@CATALOG |
catalog/ |
Funcionalidades reutilizables |
@CATALOG_INDEX |
catalog/CATALOG-INDEX.yml |
Índice |
@REUTILIZAR |
SIMCO-REUTILIZAR.md |
Antes de implementar |
@CONTRIBUIR |
SIMCO-CONTRIBUIR-CATALOGO.md |
Después de crear |
Funcionalidades del catálogo usadas por GAMILIT:
| Funcionalidad |
Uso |
auth |
JWT + 5 proveedores OAuth |
session-management |
Sesiones de usuario |
notifications |
Sistema de notificaciones |
feature-flags |
Features graduales |
4. Principios Fundamentales (5)
| Alias |
Resumen |
@CAPVED |
Toda tarea pasa por 6 fases |
@DOC_PRIMERO |
Consultar docs/ antes de implementar |
@ANTI_DUP |
Verificar que no existe antes de crear |
@VALIDACION |
Build y lint DEBEN pasar |
@TOKENS |
Desglosar tareas grandes |
Directivas por Dominio Técnico
| Alias |
Aplica |
Notas |
@OP_DDL |
SÍ |
14 schemas, 101 tablas |
@OP_BACKEND |
SÍ |
NestJS, 125+ endpoints |
@OP_FRONTEND |
SÍ |
React 19, Zustand |
@OP_MOBILE |
NO |
(futuro) |
@OP_ML |
NO |
- |
Patrones Heredados (OBLIGATORIOS)
| Patrón |
Uso en GAMILIT |
MAPEO-TIPOS-DDL-TYPESCRIPT.md |
14 schemas ↔ Entities |
PATRON-VALIDACION.md |
class-validator en DTOs |
PATRON-EXCEPTION-HANDLING.md |
Filtros NestJS |
PATRON-TESTING.md |
Jest + e2e tests |
PATRON-LOGGING.md |
Winston estructurado |
PATRON-CONFIGURACION.md |
@nestjs/config |
PATRON-SEGURIDAD.md |
JWT, RBAC, Guards |
PATRON-PERFORMANCE.md |
Query optimization |
PATRON-TRANSACCIONES.md |
TypeORM transactions |
ANTIPATRONES.md |
Evitar siempre |
NOMENCLATURA-UNIFICADA.md |
Consistencia |
Directivas Específicas de GAMILIT
Ubicación: ./directivas/
| Directiva Local |
Extiende |
Propósito |
DIRECTIVA-DISENO-BASE-DATOS.md |
@OP_DDL |
14 schemas PostgreSQL |
DIRECTIVA-POLITICA-CARGA-LIMPIA.md |
@OP_DDL |
DDL-first, sin migraciones |
ESTANDARES-API-ROUTES.md |
@OP_BACKEND |
Convenciones de rutas |
ESTANDARES-TESTING-API.md |
@PATRON-TESTING |
Testing de API |
PITFALLS-API-ROUTES.md |
@ANTIPATRONES |
Errores a evitar |
GUIA-NOMENCLATURA-COMPLETA.md |
@NOMENCLATURA |
Nomenclatura específica |
Variables de Contexto CCA
# Identificación del Proyecto
PROJECT_NAME: "gamilit"
PROJECT_LEVEL: "STANDALONE"
PROJECT_ROOT: "/home/isem/workspace/projects/gamilit"
# Rutas principales
APPS_ROOT: "apps"
DOCS_ROOT: "docs"
ORCHESTRATION: "orchestration"
# Base de Datos
DB_NAME: "gamilit_platform"
DB_DDL_PATH: "apps/database/ddl"
DB_SCRIPTS_PATH: "apps/database"
DB_SEEDS_PATH: "apps/database/seeds"
RECREATE_CMD: "drop-and-recreate-database.sh"
# Backend (NestJS)
BACKEND_ROOT: "apps/backend"
BACKEND_SRC: "apps/backend/src"
BACKEND_TESTS: "apps/backend/tests"
BACKEND_FRAMEWORK: "NestJS"
ORM: "TypeORM"
# Frontend (React)
FRONTEND_ROOT: "apps/frontend"
FRONTEND_SRC: "apps/frontend/src"
FRONTEND_TESTS: "apps/frontend/tests"
FRONTEND_FRAMEWORK: "React"
STATE_MANAGEMENT: "Zustand"
BUILD_TOOL: "Vite"
# Auth
AUTH_SCHEMA: "auth_management"
AUTH_PROVIDERS: "Google, Facebook, Apple, GitHub, Email"
# 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"
Schemas de Base de Datos (14)
| Schema |
Descripción |
Tablas |
auth_management |
Autenticación, OAuth |
~10 |
user_management |
Usuarios, perfiles |
~8 |
gamification_system |
XP, ML Coins, logros |
~15 |
maya_ranks |
Rangos Maya |
~5 |
learning_content |
Contenido educativo |
~12 |
progress_tracking |
Progreso del estudiante |
~10 |
challenge_system |
Desafíos, misiones |
~8 |
reward_system |
Recompensas |
~6 |
social_features |
Social, leaderboards |
~8 |
parent_portal |
Portal de padres |
~5 |
teacher_tools |
Herramientas docentes |
~6 |
analytics |
Analíticas |
~4 |
notifications |
Notificaciones |
~3 |
system_config |
Configuración |
~3 |
Total: 101 tablas
Stack Tecnológico Detallado
Backend
- Framework: NestJS 11.x
- Lenguaje: TypeScript 5.3
- ORM: TypeORM 0.3.x
- Auth: JWT + Passport (5 proveedores OAuth)
- API: 125+ endpoints REST
- Validación: class-validator, class-transformer
- Docs: Swagger/OpenAPI
Frontend
- Framework: React 19.x
- Lenguaje: TypeScript 5.3
- State: Zustand 5.x
- Styling: Tailwind CSS 4.x
- Build: Vite
- Routing: React Router
Database
- Engine: PostgreSQL 15 (Supabase)
- Extensiones: uuid-ossp, pg_trgm
Flujo de Trabajo para Desarrollo
# PASO 1: Cargar contexto (CCA)
CARGAR:
- @TAREA
- @CAPVED
- @INICIALIZACION
- ./CONTEXTO-PROYECTO.md
# PASO 2: Verificar catálogo
VERIFICAR:
- @CATALOG_INDEX
- @REUTILIZAR
# PASO 3: Seleccionar operación
OPERACION:
- @OP_DDL # 14 schemas
- @OP_BACKEND # NestJS
- @OP_FRONTEND # React
# PASO 4: Aplicar patrones
PATRONES:
- @PATRON-VALIDACION
- @PATRON-EXCEPTION-HANDLING
- @PATRON-SEGURIDAD
# PASO 5: Validar
VALIDAR:
- npm run build
- npm run lint
- npm run test
# PASO 6: Documentar
CIERRE:
- @DOCUMENTAR
- Actualizar inventarios
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 |
ANTIPATRONES.md |
@ANTIPATRONES |
Perfiles de Agentes más usados
| Perfil |
Especialización |
Frecuencia |
PERFIL-DATABASE.md |
PostgreSQL, 14 schemas |
Alta |
PERFIL-BACKEND.md |
NestJS, TypeORM |
Alta |
PERFIL-FRONTEND.md |
React, Zustand |
Alta |
PERFIL-CODE-REVIEWER.md |
Revisión de código |
Media |
PERFIL-BUG-FIXER.md |
Corrección de bugs |
Media |
Sistema: SIMCO v2.2.0 + CAPVED + CCA Protocol
Nivel: STANDALONE
Última actualización: 2025-12-08
