Academia Deltamontero · Documentación
El proyecto

Funcionalidades

Catálogo completo de lo que hace la Academia Deltamontero, agrupado por público, con una línea por funcionalidad.

Este catálogo resume todo lo que la plataforma hace hoy, según el código del repositorio. Los nombres de pantallas, menús y botones son los que aparecen en la interfaz. El paso a paso de cada pantalla está en las secciones Usuarios y Administración.

Cada pantalla de administración exige su propio permiso. Quien no es super administrador ve en Administración del sitio solo lo que le corresponde a su perfil (lista blanca por rol); el resto no aparece ni se puede abrir escribiendo la dirección.

Público general (sin sesión iniciada)

FuncionalidadDóndeQué hace
Página principal institucionalPágina principalPresenta qué es la Academia y quién es Deltamontero, sus áreas de formación y tres accesos: Colaboradores, Postulantes y Clientes.
Inicio de sesión con usuario o correoPantalla de ingresoSe entra con el nombre de usuario o con el correo; no se permiten dos cuentas con el mismo correo.
Ver la contraseña mientras se mantiene presionadoPantalla de ingresoBotón propio que muestra la clave solo mientras se mantiene presionado y la oculta al soltar.
Bloqueo por intentos fallidosPantalla de ingreso10 contraseñas fallidas seguidas en 30 minutos bloquean la cuenta 30 minutos (se desbloquea sola).
Sin acceso de invitadosTodo el sitioNo existe el botón de entrar como invitado.
Recuperar la contraseña¿Olvidó su contraseña?Con correo configurado, envía un enlace al correo registrado; sin correo, la persona prueba su identidad con usuario (o correo) y cédula y recibe una contraseña temporal que debe cambiar. Con límite de intentos por IP, registro de auditoría y aviso a los administradores.
Crear la contraseña desde el enlace del correoPágina de contraseña (dos paneles)Enlace de un solo uso para activar la cuenta (vence en 7 días) o restablecer la contraseña (vence en 1 hora); muestra los requisitos mientras se escribe y lleva al inicio de sesión.
Contactar con el soporteBotón ? del pieFormulario Contactar con el soporte del sitio que llega al correo de soporte configurado.

Colaboradores

FuncionalidadDóndeQué hace
Ruta de módulos automáticaÁrea personal / Mis cursosCada persona ve los módulos obligatorios de su cargo, más los que se le asignen individualmente.
Curso de IntroducciónIntroducción: Cómo usar la Academia con IAManual de uso de la Academia en partes desplegables (Cómo usar la Academia, Chat de IA, Guía para Talento Humano, Guía para administradores); cada página se marca como hecha al abrirla y al final hay un certificado.
Aceptación del aviso de datos personalesPrimer ingresoAntes de usar la plataforma, cada persona acepta el Aviso de Tratamiento de Datos Personales; queda registrado con versión y fecha.
Completar el correo en el primer ingresoPrimer ingresoSi la cuenta no tiene correo, se pide solo ese dato (no el formulario completo del perfil).
Saludo personalizadoÁrea personalSaluda con el primer nombre y el primer apellido.
Videos interactivosCada tema del móduloVideos de YouTube (o Cloudflare R2) con el mismo reproductor en todos los módulos; el video queda hecho al verlo hasta el final, sin animaciones de felicitación.
Botón Siguiente actividadBarra superior del reproductorLleva a la siguiente actividad disponible del módulo, respetando el orden y las restricciones.
Repasos bloqueados hasta ver el videoCada temaEl repaso de un tema se habilita al terminar su video. El candado es real para todos los perfiles, no solo visual.
Volver a intentar viendo el videoRepasosSi la persona no aprueba en sus intentos, vuelve a ver el video del tema y recibe intentos nuevos (no repite todo el módulo).
Aviso al empezar el repasoRepasosMuestra las reglas vigentes: nota para aprobar, intentos, tiempo y control de cambio de pantalla.
Control de cambio de pantallaDurante el repasoCuenta en el servidor las salidas de la pantalla del examen y, al llegar al límite (3 por defecto), envía el intento solo. Muestra cuántas oportunidades quedan.
Seguridad del examenRepasosPreguntas y respuestas en orden aleatorio, una por página, navegación secuencial y sin revelar las respuestas correctas. Botón Resolver cuestionario.
Certificado bloqueado hasta completarSección CertificadoEl certificado se libera al completar el módulo (o al aprobar todos los repasos, según la regla del módulo). La lista de requisitos muestra solo lo que falta.
Descarga del certificadoSección CertificadoCertificado en PDF con el diseño de Deltamontero y un código de verificación. Es la única descarga prevista para el alumno.
Recorridos guiadosÁrea personal, módulos y otras pantallasTours de bienvenida que se muestran una sola vez por persona; se pueden repetir con Realizar tour de esta página.
Barra de derechos, versión y horaEsquina inferior derechaMuestra derechos reservados de Deltamontero, la versión de Moodle y la fecha y hora en vivo; se oculta en el reproductor de video.
Protección básica del materialImágenes y videosSin clic derecho ni arrastre sobre imágenes y videos (protección básica, no impide capturas de pantalla).
Correos de la AcademiaCorreoBienvenida, módulo asignado, módulo terminado con su certificado y recordatorio semanal de módulos pendientes (los lunes, a quien no entra hace 14 días).
Diseño adaptableTodo el sitioEn pantallas pequeñas las tablas anchas se desplazan en su lugar y el ingreso y los registros caben en el teléfono.

Asistente de IA (todo el personal)

FuncionalidadDóndeQué hace
Chat flotante en todas las páginasBotón del asistente, abajo a la derechaPanel flotante a la derecha disponible en todas las páginas del personal; no aparece en las páginas públicas, en el reproductor de video ni a los postulantes.
Respuestas según el perfilChatLa plataforma informa al modelo el perfil real de la persona en cada consulta, para orientar la respuesta sin concederle accesos que no tiene.
Condiciones de usoPrimera vez que se abre el chatLa persona acepta las condiciones del Asistente de IA (resumen y acuerdo completo); puede retirar su aceptación.
Cuota diaria por perfilChatTres niveles: sin límite (Socios, Administrador de Formación y Administrador Técnico), ampliado de 60 mensajes por día (Gerencia, Jefatura Técnica, Líder Operativo y RRHH Operativo) y básico de 15 mensajes por día (perfiles operativos, auxiliares y pasantes). Muestra el contador y bloquea al llegar al tope hasta el día siguiente.
Conversación nueva en cada ingresoChatCada inicio de sesión abre una conversación nueva; el historial se conserva y puede borrarse por conversación.
Reglas de seguridad del asistenteChatTransparencia, límites de autoridad, escalamiento a Talento Humano, alcance estricto a la Academia y defensa contra instrucciones maliciosas en el texto.

Talento Humano y administradores

Módulos

FuncionalidadDóndeQué hace
Centro de módulosBarra superior → MódulosLista de módulos con su estado (publicado o borrador), temas y a quién van dirigidos, con accesos a editar temas, personas, datos, reglas, ocultar y eliminar. Solo para quien crea capacitaciones (Jefe de Talento Humano y super administrador).
Nuevo módulo desde plantilla o currículoMódulos → Nuevo módulo → Desde plantilla o currículoAsistente que lee la plantilla Excel de la Academia (o PDF, Word, CSV, JSON), muestra cada tema con su estado y crea el módulo con la estructura oficial.
Nuevo módulo desde un documentoMódulos → Nuevo módulo → Desde un documentoArma los temas a partir de los títulos de un Word, PDF o texto; la IA, de forma opcional, propone el objetivo y 3 preguntas de repaso por tema.
Nuevo módulo en blancoMódulos → Nuevo módulo → En blancoCrea el módulo vacío con la estructura oficial y lo abre en modo de edición.
Plantilla ExcelDescargar plantilla ExcelHojas Instrucciones, Temas (N.º, tema, objetivo, enlace del video, código PowerBuilder) y Preguntas.
Estructura oficial automáticaTodo módulo nuevoNombre "Módulo N. …", N.º de ID MNN, temas N.1, N.2…, un video y un repaso por tema, sección Certificado y campos de revisión anual.
Borradores y publicaciónRevisar y publicar / Módulos en borradorEl módulo nace oculto; antes de publicar se ven los pendientes (preguntas, cargos, contenido, certificado, revisión anual) y se resuelven ahí mismo.
Carga de preguntas de todo el móduloRevisar y publicar → Cargar preguntasUn solo archivo (Word o texto escrito a mano, hoja Preguntas del Excel, XML de Moodle, GIFT o Aiken) reparte cada pregunta al repaso de su tema.
Personas del móduloMódulos → PersonasInterruptor por persona para dar o quitar el módulo (el avance se conserva), filtros por área, cargo, empresa, equipo y estado, y asignación masiva.
Datos del móduloMódulos → DatosSolo nombre, objetivo y a quién va dirigido, en lugar de la configuración completa de Moodle.
Reglas del móduloMódulos → ReglasReglas propias de un módulo; lo que no se cambia sigue la regla general.
Revisar los módulosMódulos → Revisar los módulosBusca en todos los módulos lo que impide avanzar o terminar (videos que YouTube ya no deja ver, repasos sin preguntas o sin nota, restricciones imposibles, certificado, avances sin recalcular) y repara lo que se puede.
Nuevo repaso simplificadoAñadir una actividad → Repaso o pruebaPide solo el nombre, la nota para aprobar, los intentos y el tiempo; luego abre el editor de preguntas.
Editor sencillo de preguntasPreguntas del repaso o de la pruebaVer, corregir, agregar y quitar preguntas de opción múltiple y verdadero o falso; los demás tipos usan el formulario de Moodle y vuelven aquí. Corregir crea una versión nueva; agregar o quitar solo mientras nadie haya rendido.
Editor de módulos simplificadoModo de edición del móduloMenú Añadir con los recursos recomendados y nombres claros; las pantallas de cursos y categorías de Moodle redirigen al flujo de Módulos.
Opciones de gestión solo en modo de ediciónPáginas del móduloSin modo de edición, el personal de gestión ve el módulo como alumno; al activarlo aparecen las pestañas de gestión.
Vista de estudiante automáticaMódulos en los que la persona está matriculadaQuien administra y además rinde sus módulos los ve exactamente como un estudiante (candados incluidos) mientras el modo de edición está apagado.
Aviso de borradorPáginas de un módulo ocultoRecuerda que el módulo aún no está publicado.

Reglas, calificaciones y revisión anual

FuncionalidadDóndeQué hace
Reglas de la AcademiaAdministración del sitio → Academia → Reglas de la AcademiaRegla general para todos los módulos: cuándo un video queda hecho, reproductor, cuándo se puede rendir, nota para aprobar (70 % por defecto), intentos (2), tiempo (30 min), cuándo queda hecho un repaso, intentos nuevos al volver a ver el video (2), aviso al empezar, control de cambio de pantalla (3 salidas) y certificado (si se entrega, diseño y requisito).
Valores iniciales respetadosRepasosLas reglas son los valores con los que nace cada repaso; lo configurado después en un repaso se respeta, salvo que se cambie la regla general.
Calificaciones de la AcademiaAdministración del sitio → Calificaciones → Calificaciones de la AcademiaEn un solo lugar: reglas de los repasos, nota, intentos y tiempo de cada prueba técnica, y cómo se muestran las notas (porcentaje, puntos o ambos; decimales).
Revisión anual de módulosAdministración del sitio → Informes → Revisión anual de módulosRegistro de cada revisión (fecha, responsable, resultado, cambios, próxima revisión) con los criterios mínimos del manual (§14.1) e historial como evidencia. Estados: Vigente, Por vencer, VENCIDA o Sin revisión registrada.
Aviso mensual de revisiónTarea programada (día 1 de cada mes, 08:00)Notifica a Talento Humano los módulos vencidos, por vencer (60 días o menos) o sin revisión.
Guía para Talento HumanoAdministración del sitio → Academia → Guía para Talento HumanoEl cómo se hace, por clics, de lo que administra Talento Humano, con enlaces directos a cada pantalla.

Personal y cuentas

FuncionalidadDóndeQué hace
Personal DeltamonteroAdministración del sitio → Usuarios → Personal DeltamonteroTodas las personas separadas por tipo (Colaboradores, Pasantes, Postulantes, Clientes, Sin clasificar, Administración), con búsqueda por nombre, usuario, correo, cédula o cargo, y descarga.
Crear colaboradorUsuarios → Cuentas → Crear colaboradorUn formulario crea la cuenta, asigna el perfil, la cohorte del cargo (y con ella su ruta de módulos), el área y la cédula (obligatoria, 10 dígitos y única). Reemplaza en el menú a la página nativa de Moodle.
Agregar o quitar del personalPersonal DeltamonteroDa o quita el cargo, el perfil y la ruta de módulos; el historial de formación se conserva.
Marcar como clientePersonal DeltamonteroClasifica una cuenta como cliente.
Editar a una personaPersonal Deltamontero → EditarFormulario reducido: nombres, apellidos, usuario, correo, cédula, tipo, cargo, área y contraseña nueva opcional; Enviar el enlace por correo.
Historial de una personaPersonal Deltamontero → HistorialTodo en una página: datos, resumen, avance por módulo, repasos, certificados con su código, prueba técnica (si fue postulante) y correos recibidos.
Módulos de una personaPersonal Deltamontero → MódulosMarca qué módulos ve la persona y por qué (cargo, empresa o individual); desactivar uno del cargo lo apaga solo para ella.
Restablecer contraseñasPersonal Deltamontero → Restablecer contraseñasA varias personas a la vez, con contraseña distinta o igual para todas; se muestran una sola vez con descarga en Excel. Excluye super administradores, cuentas de servicio, postulantes y, si no lo hace un super administrador, las cuentas de gestión.
Eliminar cuentaPersonal DeltamonteroElimina la cuenta y todo su historial (solo Jefe de Talento Humano y super administrador; no permite eliminar a quien lidera un equipo).
Importar personal desde ExcelUsuarios → Cuentas → Importar personal desde ExcelSube el Excel de cargos y grupos de Talento Humano, muestra una vista previa, crea cuentas nuevas, completa cédulas, cargos, áreas y equipos, propone eliminar cuentas que no están en el listado y entrega los usuarios y contraseñas temporales una sola vez.
Completar correos del personalUsuarios → Cuentas → Completar correos del personalDesde un Excel con nombre y correo, completa los correos que faltan con vista previa y confirmación.
Verificar un certificadoUsuarios → Cuentas → Verificar un certificado (también General → Certificados)Con el código impreso, muestra a quién se emitió, de qué módulo y cuándo.
Aceptación de políticasUsuarios → Cuentas → Aceptación de políticasQuién aceptó y quién falta del aviso de datos personales y de las condiciones del Asistente de IA, con descarga; activar, editar o publicar una versión nueva del aviso.
Solicitudes de datos personalesUsuarios → Privacidad y políticas → Solicitudes de datos (herramienta de Moodle)Exportar o eliminar los datos de una persona (LOPDP). Incluye los datos de Moodle y los registros propios de la Academia y de Postulantes, gracias a sus proveedores de privacidad.
Plantillas de certificadoGeneral → Certificados → Plantillas de certificadoAcceso a los diseños de certificado que usan los módulos.
Segundo super administradorAutomáticoCuenta de respaldo admin.respaldo para que un super administrador pueda restablecer la contraseña del otro sin depender del correo.

Equipos

FuncionalidadDóndeQué hace
EquiposBarra superior → Equipos (Talento Humano)Equipos con nombre, líder e integrantes, vistos como tarjetas con avance promedio y certificados; una persona pertenece a un solo equipo.
Mi equipoBarra superior → Mi equipo (líderes)El líder ve, en modo lectura, el avance, evaluaciones y certificados solo de las personas de su equipo. El alcance lo impone Moodle mediante el rol Líder de equipo.
Tarjeta del líderÁrea personalMuestra al líder el equipo que lidera y un acceso a Mi equipo.

Postulantes

FuncionalidadDóndeQué hace
PostulantesBarra superior → PostulantesTres pestañas: Postulantes, Códigos de acceso y Pruebas técnicas.
Códigos de accesoPostulantes → Códigos de accesoGenera, envía por correo y anula códigos; cada código define el cargo, vence y tiene un número de usos (1 por defecto).
ResultadosPostulantes → PostulantesQuién rindió, nota y estado (Aprobó, No aprobó, En curso, Pendiente de calificar), con filtros y descarga en Excel, Word, PDF o CSV; Ver prueba y Calificar.
Incorporar al equipoPostulantesConvierte la cuenta del postulante en la de un colaborador conservando su prueba y su nota.
Eliminar postulantePostulantesElimina su cuenta con todo su historial (Jefe de Talento Humano y super administrador).
Pruebas técnicasPostulantes → Pruebas técnicasPreguntas, puntaje, nota para aprobar, tiempo e intentos (1 intento por prueba); creación guiada de una Nueva prueba técnica y carga de preguntas desde Word, Excel o XML.
Aislamiento del postulanteAutomáticoEl postulante solo puede estar en su prueba; cualquier otra página lo devuelve a ella y no ve el chat de IA.

Clientes

FuncionalidadDóndeQué hace
Empresas clienteBarra superior → ClientesLista de empresas y Nueva empresa cliente, con pestañas en orden de trabajo: 1. Datos de la empresa, 2. Módulos, 3. Código de registro, 4. Usuarios y avance.
Módulos por empresaClientes → MódulosActivar un módulo lo matricula a todos los usuarios de la empresa; desactivarlo lo oculta (el avance se conserva).
Códigos de registroClientes → Código de registroCódigo con vencimiento y número de usos, que se puede anular y enviar por correo.
Registro del empleado del clientePágina principal → Clientes → Crear cuentaPaso 1 código de la empresa; paso 2 nombres, apellidos, cédula, correo y contraseña. Límite de 10 envíos fallidos por equipo cada 30 minutos.
Vencimiento de empresasTarea programada diaria (01:30)Desactiva las empresas con el acceso vencido.
Eliminación de una empresaClientesSuspende de inmediato sus cuentas y las borra en segundo plano (sin tocar a quien pertenezca a otra empresa o tenga un cargo del personal).

Reportes

FuncionalidadDóndeQué hace
Reportes listosBarra superior → ReportesSiete reportes: Personas que aún no terminan; Avance por persona y módulo; Módulos completados y certificados; Resultados de evaluaciones; Personas por cargo; Personas sin ingresar; Personal de la Academia.
Informes personalizadosReportes → Crear informe personalizadoConstructor en pasos: qué es cada fila (persona, persona en un módulo, persona en una evaluación o postulante), columnas, filtros, condiciones sobre cualquier columna, orden y agrupación con cantidad y promedios; se guarda para volver a sacarlo.
Formato institucional de descargaTodos los menús de descargaExcel, Word y PDF (formato Deltamontero) con logo, datos de DELTAMONTERO S.A. y tabla de control del documento, además de CSV.
Reportes por chatAsistente de IAEl asistente ofrece el menú de reportes, pregunta el formato y entrega el archivo.

Asistente de IA con acciones (perfiles de gestión)

FuncionalidadQué hace
ConsultasBuscar a una persona (con usuario, cargo y área), ver su avance y los pendientes de un módulo.
ReportesGenerar reportes de usuarios, avance por módulo y certificados con filtros y agrupación, y los reportes de formación en archivo.
AccionesCrear un colaborador (con guía de los datos necesarios), asignar cargo y área, completar o corregir la cédula, matricular en una cohorte y restablecer una contraseña.
Límite de autoridadCada acción se ejecuta como la persona conectada y vuelve a comprobar sus permisos reales; el chat nunca puede hacer más de lo que esa persona haría a mano. Las acciones de escritura piden confirmación.
Datos ocultos al proveedorLas cédulas, los RUC y los correos se reemplazan por marcadores antes de enviarse al proveedor de IA y se restauran solo dentro de la plataforma (al ejecutar la acción y en la respuesta). Los nombres sí se envían.
Configuración IAAdministración del sitio → Configuración IA: activar o desactivar el Asistente, editar y publicar sus condiciones de uso, ver aceptaciones y los ajustes técnicos (proveedor, modelo, límites, estadísticas).

Correo

FuncionalidadDóndeQué hace
Correos de la AcademiaUsuarios → Cuentas → Correos de la AcademiaEstado del correo (Office 365), pausar o reanudar envíos, correo de prueba, límites por minuto y por día.
Tipos de correoCorreos de la AcademiaDiez tipos (Recuperar contraseña, Bienvenida al personal, Cuenta de cliente creada, Código para una empresa cliente, Código de prueba técnica, Prueba técnica recibida, Módulo asignado, Módulo terminado y certificado, Recordatorio de módulos pendientes, Correo de prueba), cada uno se puede apagar y previsualizar con Enviar ejemplo.
Registro de envíosCorreos de la AcademiaCada correo enviado, en cola o con error (con el motivo) y reintento.
Personal que todavía no entraCorreos de la AcademiaEnvía a quien aún no ingresó su usuario y el enlace para crear su contraseña.
Diagnosticar la conexiónCorreos de la AcademiaRevisa en orden DNS, salida por el puerto 587, cifrado e inicio de sesión, y dice qué falla y quién lo corrige.
Cola con límiteTarea programada cada minutoRespeta el límite del buzón de Office 365 (unos 30 por minuto) y reintenta hasta 3 veces los envíos fallidos. Las notificaciones internas de Moodle no salen por correo.
Enlaces segurosCorreos de bienvenida y recuperaciónEl código del enlace es de un solo uso y se guarda cifrado; el registro nunca contiene un enlace válido.

TI y super administrador

FuncionalidadDóndeQué hace
Imagen Docker completainfrastructure/moodle/DockerfileMoodle 4.5 LTS y todos los complementos fijados a un commit exacto, horneados en la imagen para poder recuperar sin depender de internet.
Verificación de parchesConstrucción de la imagenSi un parche importante sobre un complemento de terceros no se aplicó, la construcción falla.
Instalación y configuración automáticasentrypoint.sh y moodle-config.shEn cada arranque: espera la base, genera config.php, instala si la base está vacía, actualiza y reaplica toda la configuración de forma idempotente.
Pasos críticos y cosméticosmoodle-config.shCada paso de configuración se marca como crítico o cosmético; los errores quedan en el registro y en un aviso al super administrador.
Avisos para el super administradorTodas las páginasAlertas si el cron no corre, si falló un paso del despliegue, si no hay respaldo, si falló o tiene más de un día, si no hay copia externa o si sigue activo el aviso de que la cuenta admin usa la contraseña de ejemplo que estuvo publicada (se quita solo cuando esa cuenta cambia su contraseña).
Servicios y saluddocker-compose.ymlContenedores de base de datos, sitio y cron con límites de memoria y comprobaciones de salud; el cron nunca entra en bucle de reinicios.
Respaldo diarioinfrastructure/scripts/backup-daily.sh y setup-backup.shRespaldo de base de datos y archivos a las 2:00 (hora de Ecuador), 14 días en el servidor, verificación y copia externa opcional cifrada (90 días).
Respaldos de la AcademiaCursos → Copias de seguridad → Respaldos de la AcademiaEstado del último respaldo, tamaño y copia externa, visible desde Moodle (solo lectura).
Restauracióninfrastructure/scripts/restore.shRestaura en el mismo servidor o en uno nuevo, con o sin Coolify, con simulación previa (--dry-run).
Verificación en dos pasosSuper administradoresMFA con aplicación de autenticación solo para super administradores, con 7 días de gracia.
IP real del usuarioConfiguraciónToma la IP real detrás de Cloudflare y Traefik para registros y límites de intentos.
Páginas sin caché del navegadorTodo el sitioEl botón Atrás no muestra páginas de una sesión cerrada.
Servicio MCPsetup-mcp-service.phpCuenta técnica de servicio con un rol acotado (lectura y gestión de usuarios y matrículas, sin borrado permanente) para un cliente de IA de administración externo.
Función externa de creación de móduloslocal_deltamodules_create_moduleCrea un módulo completo desde una definición JSON.
Interruptor de bloqueo de certificadosPlugins locales → Delta CertificadosSi está activo, todo certificado nuevo se bloquea hasta completar el curso.

En esta página