rckrdmrd/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
289c5a4ee5
workspace/projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
rckrdmrd 608e1e2a2e
Some checks are pending
CI Pipeline / changes (push) Waiting to run
Details
CI Pipeline / core (push) Blocked by required conditions
Details
CI Pipeline / trading-backend (push) Blocked by required conditions
Details
CI Pipeline / trading-data-service (push) Blocked by required conditions
Details
CI Pipeline / trading-frontend (push) Blocked by required conditions
Details
CI Pipeline / erp-core (push) Blocked by required conditions
Details
CI Pipeline / erp-mecanicas (push) Blocked by required conditions
Details
CI Pipeline / gamilit-backend (push) Blocked by required conditions
Details
CI Pipeline / gamilit-frontend (push) Blocked by required conditions
Details
Multi-project update: gamilit, orchestration, trading-platform 
Gamilit:
- Backend: Teacher services, assignments, gamification, exercise submissions
- Frontend: Admin/Teacher/Student portals, module 4-5 mechanics, monitoring
- Database: DDL functions, seeds for dev/prod, auth/gamification schemas
- Docs: Architecture, features, guides cleanup and reorganization

Core/Orchestration:
- New workspace directives index
- Documentation directive

Trading-platform:
- Database seeds and inventory updates
- Tech leader validation report

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-18 07:17:46 -06:00

318 lines
9.1 KiB
Markdown
Raw Blame History

# Herencia SIMCO - GAMILIT
**Sistema:** SIMCO v2.3.0 + CAPVED + CCA Protocol
**Fecha:** 2025-12-18
---
## Configuración del Proyecto
| Propiedad | Valor |
|-----------|-------|
| **Proyecto** | GAMILIT - Plataforma EdTech Gamificada |
| **Nivel** | STANDALONE |
| **Padre** | core/orchestration |
| **SIMCO Version** | 2.3.0 |
| **CAPVED** | Habilitado |
| **CCA Protocol** | Habilitado |
## Jerarquía de Herencia
```
Nivel 0: workspace/orchestration/ ← WORKSPACE (directivas globales)
│
Nivel 1: core/orchestration/ ← CORE (76 docs SIMCO)
│
└── STANDALONE: gamilit/orchestration/ ← ESTE PROYECTO
gamilit/docs/00-vision-general/directivas/ ← DIRECTIVAS ESPECIFICAS
```
**Regla:** Las directivas locales pueden EXTENDER las de core, nunca REDUCIRLAS.
**Estado del Proyecto:** MVP 75% completado
---
## Directivas Heredadas de WORKSPACE (OBLIGATORIAS)
Ubicación: `workspace/orchestration/`
| Alias | Archivo | Propósito |
|-------|---------|-----------|
| `@CARGA-CONTEXTO` | `directivas/DIRECTIVA-CARGA-CONTEXTO.md` | Como cargar contexto segun nivel |
| `@INDICE` | `INDICE-DIRECTIVAS-WORKSPACE.yml` | Indice maestro de directivas |
---
## 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 |
| `@DOC-DEFINITIVA` | `directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md` | Docs como estado final |
### 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Í** | 16 schemas, 123 tablas |
| `@OP_BACKEND` | **SÍ** | NestJS, 417 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 Principal: `docs/00-vision-general/directivas/`
| Directiva | Propósito | Estado |
|-----------|-----------|--------|
| `_INDEX.md` | Índice de directivas específicas | Activo |
| `DIRECTIVA-GAMILIT-EJERCICIOS.md` | Estructura de ejercicios | Pendiente |
| `DIRECTIVA-GAMILIT-GAMIFICACION.md` | Sistema de gamificación | Pendiente |
### Ubicación Secundaria: `orchestration/directivas/`
| Directiva Local | Extiende | Propósito |
|-----------------|----------|-----------|
| `DIRECTIVA-DISENO-BASE-DATOS.md` | `@OP_DDL` | 16 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
```yaml
# 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
- **Extensiones:** uuid-ossp, pg_trgm
---
## Flujo de Trabajo para Desarrollo
```yaml
# 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
Reference in New Issue View Git Blame Copy Permalink