Paso 3/3 — Configuración
Ítem 7 del plan · Responsable: Aplicaciones Colombia Aprende · Duración: 60 min
Toda la configuración administrativa que el Campus Virtual necesita después de instalar los componentes se concentra en una sola rutina de línea de comandos, en lugar de una secuencia de pasos manuales por la interfaz de administración.
Esta página es el contrato de esa rutina: define qué debe dejar aplicado y cómo se verifica.
La rutina —referida aquí como script_setup_campus— está especificada pero no
implementada. Se elaborará en una próxima iteración, y hasta entonces esta página describe el
comportamiento esperado, no un artefacto disponible.
Mientras tanto, las mismas acciones pueden aplicarse manualmente siguiendo las páginas de Operación que se enlazan en cada bloque. Esa vía es más lenta y no es idempotente, pero produce el mismo estado final.
Por qué una rutina y no una lista de pasos manuales
- Reproducible entre ambientes. La misma rutina se ejecuta en Local, Pruebas y Certificación; desaparece la deriva de configuración entre entornos.
- Ejecutable por el MEN. En Certificación el equipo de desarrollo no tiene acceso de ejecución: entregar un comando es entregable, entregar quince pasos de interfaz no lo es.
- Idempotente. Re-ejecutarla no duplica insignias ni bloques: cada acción comprueba el estado actual antes de escribir.
- Auditable. La ejecución en seco imprime exactamente qué cambiaría, y su salida sirve como evidencia adjunta al RFC.
Forma de ejecución
Dos pasadas: primero en seco para revisar el plan de cambios, y una vez validado, en firme.
# 1) Revisar el plan sin aplicar nada
php public/local/pccntr8203403_dashboard/cli/script_setup_campus.php --dry-run
# 2) Aplicar
php public/local/pccntr8203403_dashboard/cli/script_setup_campus.php \
--aitutor-url=<URL_SERVICIO_IA> \
--aitutor-token=<TOKEN_SERVICIO_IA> \
--curso-gamificado=<ID_CURSO>
La ruta y el nombre del script son provisionales y se confirmarán al implementarlo.
Parámetros de ambiente
Tres datos no existen en el código ni pueden fijarse en la documentación: son propios del ambiente de Certificación y debe aportarlos el MEN antes de ejecutar este paso.
| Parámetro | Qué es | Quién lo provee |
|---|---|---|
| URL del servicio de IA | Base HTTPS del servicio externo de tutoría. El plugin le añade /webhook/v1/campus/tutor | Operador del servicio de IA |
| Token del servicio de IA | Credencial Bearer del servicio externo. Se pasa por parámetro: no queda en el repositorio ni en la salida del script | Operador del servicio de IA, por canal seguro |
| Curso destino de la gamificación | Curso donde se instalan los bloques de gamificación en la región lateral | MEN |
En los ambientes de desarrollo la gamificación se aplicó primero sobre un curso piloto antes de replicarla. En Certificación no existe ese curso: los datos no viajan entre ambientes.
El MEN debe decidir expresamente sobre qué curso se instalan los bloques de gamificación, o bien acordar que se configuren solo a nivel sitio y que cada gestor los active en su curso siguiendo la Guía para gestores.
Qué debe dejar aplicado
1. Tema
| Acción | Detalle |
|---|---|
| Activar el tema | cdigital como tema del sitio |
| Componentes de la vista de curso | enablecoursebanner |
| Miga de pan del tema | enablethemebreadcrumb |
Referencia: Ajustes del tema.
2. Tutor IA
| Acción | Detalle |
|---|---|
| Endpoint del servicio | serverurl (HTTPS obligatorio), por parámetro |
| Token del servicio | token, por parámetro — nunca en el repositorio ni en la salida del script |
| Control de frecuencia | ratelimit (2 s por defecto) |
| Tiempo de espera | timeout (60 s por defecto) |
Referencia: Ajustes del tutor IA.
3. Gamificación
| Acción | Detalle |
|---|---|
| Interruptores del sitio | enablebadges, badges_allowcoursebadges, enablecompletion |
| Niveles XP | levelsdata de block_xp a nivel sitio: 8 Gemas, incrementos planos de 500 XP. Los cursos sin niveles personalizados heredan estos valores |
| Imágenes de nivel | Carga de los 8 PNG de Gema en las visuales por defecto de block_xp |
| Insignias | Creación o actualización de las 12 insignias de sitio y de curso con sus criterios e imágenes |
| Campo de perfil | Campo personalizado fechanacimiento (datetime), prerrequisito de la insignia #04 |
Referencias: Gemas — Niveles XP · Insignias.
Tablas que toca este bloque, y que por tanto deben estar dentro del respaldo del ítem 4:
mdl_config_plugins, mdl_block_xp_config, mdl_badge, mdl_badge_criteria y
mdl_badge_criteria_param.
4. Bloques
| Acción | Detalle |
|---|---|
| Área personal | Agregar block_pccntr8203403_atencion a la página por defecto de /my/ |
| Área personal | Retirar los bloques de Línea de tiempo, Calendario y "Cursos a los que se ha accedido recientemente" |
| Curso | Agregar block_xp y block_pccntr8203403_logros a la región lateral (side-pre) del curso destino |
Referencias: Bloque "Cursos que necesitan atención" · Retirar bloques del dashboard.
5. Servicios web del agente IA
| Acción | Detalle |
|---|---|
| Habilitar | Servicios web y protocolo REST |
| Servicio | Crear o actualizar "Componente IA Externo" con sus funciones |
| Usuario de servicio | Usuario dedicado, rol y capacidades mínimas, incluidas local/pccntr8203403_dashboard:viewstudentpanel, local/pccntr8203403_iacontext:viewcontext y moodle/course:view. Las dos primeras se definen sin arquetipos: ningún rol estándar las hereda |
| Token | Generación del token, que se imprime una sola vez en la salida y no se persiste |
Referencia: Web Services IA.
6. Cierre
Purga de cachés final, para que los ajustes del tema y las plantillas queden efectivos sin un paso adicional.
Qué queda fuera
Decisiones o actividades que no corresponden al despliegue de los componentes:
- Credenciales reales del servicio de IA y de los proveedores de IA nativos: entran por parámetro o por la interfaz de administración.
- Matrícula de la cuenta de servicio en los cursos que el agente deba consultar: la rutina no toca matrículas. Es un paso del MEN, posterior a esta rutina y previo al protocolo funcional.
- Autenticación CAS y demás integración con la infraestructura del Ministerio: configuración del ambiente, a cargo del MEN.
- Actividades de infraestructura del ambiente (ventana de mantenimiento, snapshot, monitoreo): figuran como tales en el plan, ítems 1 a 4 y 9.
- Contenido pedagógico: cursos, matrículas y actividades no se tocan.
Verificación de este paso
- La rutina termina con código de salida
0y un resumen de acciones aplicadas y omitidas (por ya estar en el estado esperado). - Ejecutarla una segunda vez debe reportar cero cambios: es la prueba de idempotencia.
- Continuar con la Verificación técnica.