Files
admin-edu-space/specs/006-login-emergencia-adm/tasks.md
T

3.7 KiB

Tareas: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único

Tareas

  • T01: Endpoint Backend /api/v1/auth/adm-login y Auditoría

    • Descripción: Crear el endpoint POST /api/v1/auth/adm-login en backend/routers/auth.py. Autenticar credenciales locales y validar estrictamente que el usuario tenga rol ADMIN (is_admin == True). Emitir eventos de auditoría específicos (ADMIN_EMERGENCY_LOGIN_FAILED, ADMIN_EMERGENCY_LOGIN_DENIED, ADMIN_EMERGENCY_LOGIN_SUCCESS).
    • Hecho cuando: El endpoint responda 200 con tokens a usuarios admin válidos, 401 a credenciales inválidas y 403 a usuarios no admin.
    • Estimación: 20 min.
  • T02: Pruebas Automatizadas Backend para Adm Login

    • Descripción: Crear archivo de test backend/tests/test_adm_login.py cubriendo: autenticación de admin exitosa, rechazo a credenciales erróneas, y rechazo con 403 a usuarios comunes que intenten entrar por la consola de emergencia.
    • Hecho cuando: pytest backend/tests/test_adm_login.py pase al 100%.
    • Estimación: 15 min.
  • T03: Rutas BFF y Rate Limiting para /adm/login

    • Descripción: En frontend/src/app.js y frontend/src/routes/auth.js, configurar authLimiter para las solicitudes POST hacia /adm/login. Manejar GET /adm/login para mostrar la plantilla administrativa y POST /adm/login comunicándose con /api/v1/auth/adm-login o /auth/login. Agregar redirección de GET /adm a /adm/login.
    • Hecho cuando: Acceder a /adm o /adm/login cargue la pantalla correspondiente y las peticiones POST estén protegidas por el limitador.
    • Estimación: 20 min.
  • T04: Plantilla Nunjucks admin_login.html

    • Descripción: Crear la vista frontend/views/auth/admin_login.html con estética institucional sobria, soporte de modo oscuro/claro, formulario de usuario/contraseña, manejo de errores y sin enlaces visibles hacia la vista pública.
    • Hecho cuando: La vista renderice correctamente los campos y mensajes de error sin fallos de estilo.
    • Estimación: 15 min.
  • T05: Limpieza de /auth/login y Despliegue por Proveedor Único

    • Descripción: En frontend/src/routes/auth.js calcular si solo hay 1 proveedor activo (is_single_provider). En frontend/views/auth/login.html:
      1. Eliminar el alert "El acceso con contraseña local está deshabilitado para usuarios generales".
      2. Eliminar el modal adminEmergencyModal.
      3. Si is_single_provider y providers.moodle es el único activo, agregar la clase show a #moodleLoginForm para que aparezca abierto de inmediato.
      4. Ocultar divisores ("o con credenciales locales") cuando solo haya un único proveedor activo.
    • Hecho cuando: /auth/login no muestre ningún rastro de acceso admin de emergencia y Moodle se despliegue abierto directamente si es el único proveedor.
    • Estimación: 20 min.
  • T06: Verificación de Código, Pyright y Suite de Pruebas

    • Descripción: Ejecutar npx pyright verificando 0 errores y correr la suite completa de pruebas pytest tests -v en backend.
    • Hecho cuando: Pyright tenga 0 errores y todos los tests aprueben.
    • Estimación: 15 min.
  • T07: Bump Semántico a v3.8.5, Git Push y Despliegue en Producción

    • Descripción: Incrementar versión a 3.8.5 en package.json, frontend/src/app.js, backend/__init__.py, backend/setup.py, CHANGELOG.md y MEMORY.md. Hacer commit y git push origin dev. Desplegar en LXC 10.0.0.217 y verificar HTTP 200 en /version.
    • Hecho cuando: Servidor en producción responda versión 3.8.5 tanto en backend como frontend.
    • Estimación: 15 min.