feat: login de emergencia admin en /adm/login y despliegue por defecto de auth unico (v3.8.5)

This commit is contained in:
2026-10-21 12:36:15 -03:00
parent 85fa1b389f
commit 836e605697
15 changed files with 540 additions and 49 deletions
+45
View File
@@ -0,0 +1,45 @@
# Espec: 006-login-emergencia-adm - Aislamiento de Login de Emergencia Admin y Despliegue Automático por Proveedor Único
## 1. Visión General y Propósito
El acceso de emergencia para administradores se encontraba expuesto visualmente en la pantalla principal `/auth/login` cuando la autenticación local estaba deshabilitada para usuarios generales, mostrando alertas explícitas ("El acceso con contraseña local está deshabilitado para usuarios generales") y un modal directo ("Acceso de Emergencia ADMIN").
Esta visibilidad pública no deseada atrae intentos de fuerza bruta y expone innecesariamente rutas administrativas a usuarios finales.
Asimismo, la pantalla general de autenticación requería clics redundantes cuando solo un proveedor de identidad estaba activo (ej. Moodle colapsado por defecto requiriendo apertura manual).
El propósito de esta especificación es:
1. **Aislar el Login de Emergencia**: Mudar el acceso administrativo local a una ruta no enlazada públicamente (`/adm/login`), reservada para el personal de administración.
2. **Eliminar Indicadores Administrativos en `/auth/login`**: Quitar todo texto informativo de bloqueo local y modales de emergencia de la vista pública de usuarios generales.
3. **Despliegue Automático Predeterminado**: Si solo existe un método de autenticación activo (ej. Moodle), debe presentarse desplegado y listo para su uso inmediato sin requerir clics adicionales.
---
## 2. Requisitos en Sintaxis EARS (Español Estricto)
### 2.1. Aislamiento de Login de Emergencia
- **RF-01 (Ubicuo)**: EL SISTEMA dispondrá de la ruta dedicada `/adm/login` (GET y POST) en el Frontend BFF para el inicio de sesión exclusivo de Administradores con credenciales locales de contingencia.
- **RF-02 (Basado en Eventos)**: CUANDO un usuario ingrese credenciales válidas con rol `ADMIN` en `/adm/login`, EL SISTEMA emitirá la cookie segura `auth_token` y redirigirá al usuario hacia `/dashboard`.
- **RF-03 (No Deseado / Excepciones)**: SI un usuario sin rol `ADMIN` o con credenciales incorrectas intenta iniciar sesión en `/adm/login`, ENTONCES EL SISTEMA denegará el acceso, registrará el evento de auditoría y redirigirá a `/adm/login?error=...` con el mensaje de error correspondiente.
- **RF-04 (Ubicuo)**: EL SISTEMA aplicará protección estricta contra ataques de fuerza bruta (`authLimiter`) en las solicitudes POST dirigidas a `/adm/login`.
### 2.2. Limpieza de Interfaz en `/auth/login` Público
- **RF-05 (Ubicuo)**: EL SISTEMA omitirá en `/auth/login` cualquier mención, texto ("El acceso con contraseña local está deshabilitado para usuarios generales"), enlace o modal referente al "Acceso de Emergencia ADMIN" cuando el acceso local esté deshabilitado para usuarios generales.
- **RF-06 (Estado)**: MIENTRAS la autenticación local esté deshabilitada (`providers.local == false`), EL SISTEMA presentará en `/auth/login` exclusivamente los proveedores institucionales federados (Google Workspace y/o Moodle).
### 2.3. Despliegue Automático de Modo de Autenticación Único
- **RF-07 (Estado)**: MIENTRAS exista exactamente un (1) solo modo de autenticación habilitado entre Google, Moodle y Local:
1. Si el único modo es Moodle, EL SISTEMA mostrará el formulario de Moodle desplegado (`show`) de forma predeterminada, con los campos de usuario y contraseña inmediatamente accesibles.
2. Si el único modo es Local, EL SISTEMA mostrará el formulario local sin divisores redundantes ("o con credenciales locales").
3. Si el único modo es Google, EL SISTEMA mostrará el botón institucional sin divisores.
- **RF-08 (Estado)**: MIENTRAS existan dos (2) o más modos de autenticación habilitados, EL SISTEMA mostrará los selectores con sus divisores correspondientes y acordeón interactivo.
---
## 3. Criterios de Aceptación y Finalización (DoD)
1. Ruta `/adm/login` operativa en Frontend BFF con vista dedicada sobria (`frontend/views/auth/admin_login.html`).
2. Endpoint `/api/v1/auth/adm-login` o validación en backend asegurando que solo usuarios con rol `ADMIN` puedan autenticarse por dicha vía.
3. Vista `/auth/login` limpia: cero textos de "Acceso de Emergencia ADMIN" ni avisos de deshabilitación local.
4. Si Moodle es el único habilitado, el formulario de Moodle aparece desplegado automáticamente sin requerir clic para abrirlo.
5. Cobertura de pruebas automatizadas con pytest en backend (`pytest tests -v`).
6. Pyright con 0 errores y 0 advertencias (`npx pyright`).
7. Bump semántico de versión a `v3.8.5`, registro en `CHANGELOG.md` y `MEMORY.md`.
8. `git push origin dev` y despliegue verificado en producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`).