Historial de documentos
Los documentos de planificación y referencia del repositorio, en qué orden se escribieron, qué reemplaza a qué y para qué sirve cada uno hoy.
El repositorio conserva los documentos de planificación que guiaron el proyecto. Varios están reemplazados por versiones posteriores; se mantienen como registro del razonamiento. Esta página indica cuál consultar para cada tema.
Regla práctica: para la operación actual manda esta documentación y docs/drp.md; para el razonamiento de diseño, docs/roadmap_v4.md (con roadmap_v4_gaps.md) y, para el RAG con Dify, docs/roadmap.md. Los documentos de planificación son de junio de 2026 y algunas de sus suposiciones cambiaron después (por ejemplo, el chat usa hoy Groq directamente, sin Dify).
Línea de tiempo
| Fecha | Documento | Estado |
|---|---|---|
| Mayo 2026 | docs/PROYECTO_LMS_DELTA_MONTERO_contexto.md | Histórico (contexto inicial) |
| Junio 2026 | docs/roadmap.md (v1, roadmap consolidado) | Vigente solo en su detalle del RAG con Dify |
| Junio 2026 | docs/roadmap_v2.md | Reemplazado |
| Junio 2026 | docs/roadmap_v3.md | Reemplazado por v4 (algunas secciones siguen como detalle) |
| Junio 2026 | docs/roadmap_v4.md | Línea base de la planificación |
| Junio 2026 | docs/roadmap_v4_gaps.md | Lista de verificación de cierre de v4 |
| Octubre 2026 | docs/drp.md | Vigente (manual de respaldo y recuperación) |
Documentos de docs/
Fecha: mayo de 2026. Para qué sirve: punto de partida del proyecto. Reúne la visión (capacitación interna de empleados y externa de clientes), la infraestructura existente del servidor de la empresa y sus restricciones, el stack elegido (Moodle 4.5 LTS, MariaDB, Traefik, Cloudflare), los plugins confirmados, el plan de seis fases, las integraciones (PowerBuilder, YouTube, Cloudflare), las consideraciones de seguridad y cumplimiento (CIS v8, LOPDP, MFA) y una lista de puntos abiertos.
Vigencia: histórico. Su arquitectura de RAG (servicio propio en Python con ChromaDB) fue descartada en favor de Dify.
Fecha: junio de 2026. Para qué sirve: explica por qué el RAG pasó de un servicio propio a Dify (mantenimiento sin desarrollo continuo, cambio de modelo por interfaz, ingesta automática de cursos nuevos) y define el principio de portabilidad de proveedor en tres capas: Moodle habla siempre con un único endpoint compatible con OpenAI; la fuente de verdad del RAG es texto con metadatos sin vectores (chunks.jsonl); y la conexión con los proveedores es compatible con OpenAI. Describe la arquitectura objetivo, los tres roles de modelo en Dify (LLM, embedding bge-m3, reranker), la decisión abierta de recuperación (base de conocimiento nativa o External Knowledge API), el plugin local_dify_sync y los riesgos (memoria del servidor, refragmentación).
Vigencia: referencia vigente para el diseño del RAG con Dify (v4 lo remite a sus secciones 2, 4 y 5). Ver Pipeline de contenido.
Fecha: junio de 2026. Para qué sirve: primer plan completo por fases: restricciones vinculantes, arquitectura de servicios, flujo de datos, los dos sistemas de IA (asistente para estudiantes y agente de gestión) y fases 0 a 7 (servidor y seguridad base, capacitación del desarrollador, Moodle en producción, respaldo externo y DRP, plugins de Recursos Humanos, contenido, IA, salida a producción).
Vigencia: reemplazado por v3 y v4.
Fecha: junio de 2026. Para qué sirve: responde a un documento de requisitos (temp/3.md) con una matriz de trazabilidad de requisitos, arquitectura final con inventario de componentes y presupuesto de memoria, correcciones técnicas respecto a v2, fases F0 a F7, pruebas de validación (spikes) para las incógnitas, el contrato de operación "sin TI", cronograma, riesgos y costos. Introduce las tres entregas: R1 plataforma operativa, R2 asistentes de IA y R3 catálogo completo, y el diseño de respaldo que asume que el servidor puede volver a ser comprometido.
Vigencia: reemplazado por v4. Siguen como detalle: el respaldo (sección 5, F2), los spikes (sección 6) y el presupuesto de memoria (sección 3.3).
Fecha: junio de 2026. Para qué sirve: responde a una segunda ronda de preguntas (temp/4.md) y convierte el plan en tareas pequeñas con definición de terminado, pruebas y KPI. Novedades: el servidor se decide al final y todo se construye primero en Docker; política de actualizaciones (automáticas solo de seguridad); auditoría de la configuración de Moodle; principio configuración como código y datos como respaldo; visibilidad del último respaldo; incorporación masiva de personal y autorregistro de clientes; Groq como proveedor del chat; reformulación del flujo de postulantes como proceso de reclutamiento; contratos de datos del contenido (inventario, chunks.jsonl, GIFT, checkpoints, código PowerBuilder); y el roadmap del repositorio hermano lms-course-scrap (apéndice A).
Vigencia: línea base de la planificación. La implementación avanzó más allá de varias tareas y difiere en algunos puntos (por ejemplo, el chat usa Groq directamente; Dify sigue pendiente).
Fecha: junio de 2026. Para qué sirve: revisión crítica de v4. Lista diez brechas (G-1 a G-10), entre ellas la compatibilidad con Moodle 4.5 de los plugins incluidos en la imagen (G-1), el tratamiento transfronterizo de datos al usar Groq frente a la LOPDP (G-2), la integración no probada de local_ai_manager con Dify (G-3), que la operación "sin TI" es una promesa de R2 y no de R1 (G-4) y la falta de contingencia en el cronograma de un solo desarrollador (G-5). Incluye una lista de verificación de cierre.
Vigencia: sus brechas se integraron en v4; se conserva como lista de verificación viva.
Fecha: octubre de 2026. Para qué sirve: manual para TI con qué se protege (base de datos y moodledata; el código se reconstruye desde el repositorio; las variables de entorno se guardan aparte), el plan de respaldo (respaldo diario a las 2:00 hora de Ecuador con 14 días de retención, copia externa de 90 días, aviso en Moodle y por correo si falla), cómo activarlo, cómo recuperar (incluido el correo SMTP) y el registro de pruebas. Objetivos: RPO 24 horas y RTO de unas 2 horas.
Vigencia: vigente. Pendientes que declara: destino de la copia externa, snapshot de Proxmox, guardar las variables de entorno en un gestor de contraseñas y sincronizar el reloj del servidor. Ver Operación.
Material de contenido (docs/modules-info/)
| Archivo | Para qué sirve |
|---|---|
academia_dm_contenido.json | Inventario maestro de módulos y temas de la Academia DM (código PowerBuilder, tema, objetivo, enlace). Lo usa create-courses.php. Ver Catálogo de módulos. |
video_links_with_topics.json | Extracción en bruto de los enlaces por página de los PDF (199 enlaces, con el texto de tema truncado). Material de trabajo para construir el inventario. |
Academia DM_Módulo 7.pdf | Currículo de la Academia DM en PDF, fuente del inventario. |
Academia DM_Módulo 7 (4).pdf | Otra versión del mismo currículo; sus diferencias con la anterior: Por confirmar. |
Módulo Liderazgo.pdf | Currículo del módulo de Formación Líderes. |
Otros documentos de referencia del repositorio
| Archivo | Para qué sirve |
|---|---|
README.md | Guía del entorno local con Docker: comandos, variables de entorno, despliegue en Coolify, generación de cursos y la lista de videos no disponibles en origen. |
DESIGN.md | Sistema de diseño de Deltamontero (colores, tipografía, componentes) de referencia para la interfaz. |
infrastructure/scripts/README-backup.md | Detalle técnico de backup.sh, restore.sh, backup-daily.sh y setup-backup.sh. |
infrastructure/moodle/manual-academia.json | Versión estructurada del manual de la Academia. Ver Manual de la Academia. |
plugins/local_deltamodules/classes/manual.php | Contenido del manual de uso de la plataforma (curso de Introducción). |
Los documentos de preguntas a los que responden v3 y v4 (temp/3.md y temp/4.md) son material de trabajo y no forman parte de la documentación.