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

47 lines
2.9 KiB
Markdown

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