# 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`.