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

2.9 KiB

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

1. Arquitectura y Enfoque de Solución

El objetivo es separar el acceso de emergencia para administradores de la pantalla de login general /auth/login, eliminar textos informativos y modales que revelen la existencia del acceso de emergencia o del bloqueo local a usuarios generales, y desplegar automáticamente el formulario de autenticación si existe un único proveedor activo (ej. Moodle).

Componentes Involucrados:

  1. Backend Core (backend/routers/auth.py):
    • Nuevo endpoint REST POST /api/v1/auth/adm-login exclusivo para administradores (is_admin == True).
    • Auditoría estricta (ADMIN_EMERGENCY_LOGIN_FAILED, ADMIN_EMERGENCY_LOGIN_DENIED, ADMIN_EMERGENCY_LOGIN_SUCCESS).
    • Retorno de tokens JWT estándar y cookies seguras.
  2. Frontend BFF (frontend/src/routes/auth.js y frontend/src/app.js):
    • Rutas GET /adm/login y POST /adm/login protegidas con authLimiter.
    • Redirección GET /adm -> /adm/login.
    • Inyección de is_single_provider y active_providers_count en GET /login.
  3. Frontend Vistas (frontend/views/auth/):
    • Nueva plantilla admin_login.html sobria, segura y desacoplada de enlaces públicos.
    • Limpieza en login.html: eliminación del alert "El acceso con contraseña local está deshabilitado..." y del modal adminEmergencyModal.
    • Soporte para proveedor único: Moodle desplegado por defecto con la clase .show si es el único habilitado.

2. Fases de Implementación

Fase 1: Backend Core (API FastAPI)

  • Agregar endpoint POST /api/v1/auth/adm-login en backend/routers/auth.py.
  • Incorporar auditoría específica y validación de rol ADMIN.
  • Escribir tests automatizados en backend/tests/test_adm_login.py.

Fase 2: Frontend BFF & Rate Limiter

  • Configurar authLimiter para /adm/login en frontend/src/app.js.
  • Configurar rutas GET /adm/login, POST /adm/login y alias /adm en frontend/src/routes/auth.js o app.js.
  • Pasar metadatos de proveedores en GET /login para identificar si hay un único proveedor habilitado.

Fase 3: Vistas Nunjucks

  • Crear frontend/views/auth/admin_login.html.
  • Modificar frontend/views/auth/login.html:
    • Retirar texto y modal de emergencia admin.
    • Aplicar apertura automática de Moodle (collapse show) si is_single_provider and providers.moodle.
    • Ocultar divisores redundantes si hay un solo proveedor.

Fase 4: Pruebas, Verificación y Despliegue

  • Ejecutar suite pytest tests -v en backend.
  • Ejecutar npx pyright para verificar 0 errores de tipado.
  • Bump de versión a v3.8.5 (package.json, app.js, __init__.py, setup.py, CHANGELOG.md, MEMORY.md).
  • git add ., commit y git push origin dev.
  • Despliegue continuo en LXC Producción 10.0.0.217 (https://eduspace.oemspot.com.ar) y verificación HTTP 200 en /version.