Manifiesto de entrega — qué recibe el cliente
Inventario de lo que se entrega para el Campus Virtual de Colombia Aprende sobre Moodle 5.1+ (branch 501). El detalle funcional de cada pieza está en el Catálogo de features; el procedimiento para instalarlo, en Integración y despliegue.
La entrega son cinco componentes de codigo propio que se instalan en el arbol de Moodle, mas configuracion sobre plugins de comunidad y Moodle nativo. No se modifica ningun archivo del core de Moodle.
Componentes de codigo propio
| Componente | Tipo | Ruta en Moodle | Version (version.php) | Release | Madurez | Requiere |
|---|---|---|---|---|---|---|
theme_cdigital | Tema (hijo de Boost) | public/theme/cdigital/ | 2026072702 | 0.1.0 | ALPHA | Moodle >= 4.5 |
local_pccntr8203403_dashboard | Plugin local (capa de datos + Web Services) | public/local/pccntr8203403_dashboard/ | 2026072700 | 1.2.0 | STABLE | Moodle >= 5.0 |
local_pccntr8203403_aitutor | Plugin local (proxy del tutor IA) | public/local/pccntr8203403_aitutor/ | 2026072100 | 0.1.0 | ALPHA | Moodle >= 5.0 |
block_pccntr8203403_logros | Bloque (coleccion de insignias del curso) | public/blocks/pccntr8203403_logros/ | 2026071400 | 0.1.0 | ALPHA | Moodle >= 5.1 |
block_pccntr8203403_atencion | Bloque (cursos que necesitan atencion, Area personal) | public/blocks/pccntr8203403_atencion/ | 2026072700 | 0.1.0 | ALPHA | Moodle >= 5.1 |
theme_cdigital-- reimplementa la apariencia del campus (frontpage, Area personal, vista de curso, card de curso) siguiendo el diseno de Figma, renderiza el Dashboard de aprendizaje (banner, modal "Ver mi avance", Stats Row) y el Drawer IA. Ficha tecnica: theme_cdigital.local_pccntr8203403_dashboard-- capa de datos del Dashboard (progreso, calificaciones, racha, alertas academicas) mas la funcion externa que alimenta la card de curso. Ficha tecnica: local_pccntr8203403_dashboard.local_pccntr8203403_aitutor-- proxy del lado del servidor para el tutor IA externo. Recibe mensajes del estudiante via AJAX, enriquece el contexto academico y reenvia al servicio externo. Ficha tecnica: local_pccntr8203403_aitutor.block_pccntr8203403_logros-- bloque de solo lectura sobre las insignias de curso (contador, grid de ganadas/bloqueadas y CTA), parte del Gamification Sidebar.block_pccntr8203403_atencion-- bloque del Area personal que lista los cursos con alertas academicas de riesgo, sobre la capa de datos del dashboard. Ficha: Cursos que necesitan atencion.
theme/cdigital/version.php declara $plugin->requires = 2024051300 (Moodle 4.5), con el
comentario "example requirement, adjust to site". El sitio objetivo es Moodle 5.1, igual que el
plugin (requires = 2025092600, Moodle 5.0). Antes de la entrega formal conviene alinear el
requires del tema a 5.0/5.1 para que el upgrade.php valide la compatibilidad real.
Configuración entregada (sin código)
| Ítem | Mecanismo | Dónde se documenta |
|---|---|---|
| 8 niveles XP "Gemas" | UPDATE mdl_block_xp_config (levelsdata JSON) | Gemas — Niveles XP |
| 10 insignias de logro | Moodle Badges (Admin UI) | Insignias |
| Ajustes del tema (hero, banner, feature cards) | theme_cdigital → Apariencia | Ajustes del tema |
| Servicio "Componente IA Externo" + token (Pruebas) | Admin UI → Servicios web | Web Services IA |
El procedimiento operativo completo de la gamificación (fases, SQL, checkpoints) está en el Plan operativo de Gamificación v1.4.
Plugins de comunidad (dependencias de configuración)
No se entregan como código —ya están instalados en el campus— pero la solución depende de ellos. Detalle en Componentes de comunidad.
| Plugin | Rol |
|---|---|
block_xp (Level Up XP Community v19.0) | Niveles "Gemas" (XP) |
block_stash | Objetos coleccionables (sin cambios) |
| Moodle Badges (núcleo) | Insignias |
Qué NO incluye la entrega
- Datos (cursos, usuarios, calificaciones) ni dumps de base de datos.
- Secretos: tokens de Web Services, API keys de proveedores de IA, contraseñas de
.env. Se entregan por canal seguro, nunca en el repositorio. - Modificaciones al core de Moodle: la solución no parchea
public/fuera de los cinco componentes propios. - Imágenes finales de gamificación: las 8 PNG de Gemas y 10 de insignias se generan a partir de los prompts de la propuesta v2; ver el plan operativo.
Entre ambientes viaja código, nunca datos. Ningún dato de usuario de Local o
de Pruebas —cuentas, matrículas, calificaciones, intentos, archivos subidos—
puede considerarse para despliegue ni migración hacia Certificación o
Producción, por ninguna vía: dump de base de datos, restauración parcial de
tablas, copia de seguridad de curso (.mbz), carga masiva por CSV ni
sincronización de moodledata.
En Local y en Pruebas los datos de usuario existen con un único propósito: validar features. No son fuente de verdad de nada ni un estado que deba replicarse; son insumo desechable de desarrollo y prueba.
En Certificación y Producción la identidad la provee el CAS del Ministerio y las cuentas se pueblan por los medios del MEN, no desde nuestros ambientes. Ver Autenticación CAS.
El dump del Paso 1 del procedimiento es un artefacto del ambiente donde se tomó: solo sirve para el rollback de ese mismo ambiente.
Para reproducir en otro ambiente un caso observado en Local o Pruebas se describe el caso —rol, configuración, pasos— y se recrea con datos propios del ambiente destino. No se exporta el registro original.
Requisitos del entorno
Versión de Moodle, PHP, base de datos y herramientas de build: ver Requisitos.