Login móvil — recuperación de contraseña por correo y bandera en administración
El terminal móvil (ccf-almacen-mb) ya permite recuperar la contraseña por correo, con el
mismo mecanismo que el login web, y el Administrador puede encender o apagar ese mecanismo
desde el panel. De paso se corrigió el desbordamiento de los tres distintivos del login, se
añadió el control de tamaño de letra al acceso y los datos de diagnóstico del API quedaron
solo para desarrollo.
Qué cambió para el usuario
| Antes | Ahora |
|---|---|
| El móvil solo permitía iniciar sesión; si olvidabas la contraseña, había que pedirla a un administrador. | El login móvil muestra ¿Olvidaste tu contraseña?: se indica el correo registrado y llega una contraseña temporal por correo. |
| Los tres distintivos del login (Inventario, Movimientos, Aprobaciones) se salían del ancho de la pantalla. | Se muestran solo como iconos en círculos, dentro del ancho, sin texto y sin acción (son decorativos). |
| El tamaño de letra solo se podía cambiar con la sesión iniciada (Configuración). | El login y la recuperación incluyen A− 130% A+, así que el texto se agranda antes de autenticarse. |
| La URL del API y «Buscar la API en la red de nuevo» se veían siempre. | Solo se muestran en desarrollo (__DEV__); en producción desaparecen. |
| No había pie en el acceso. | Pie v1.0.0 — CCF Módulo de Almacén (la versión sale de app.json). |
La bandera de administración
En Configuración → Políticas de contraseñas hay un nuevo interruptor, «Permitir la recuperación de contraseña por correo»:
- Encendido (por defecto): web y móvil ofrecen el enlace, y el API genera y envía la contraseña temporal.
- Apagado: el enlace desaparece de los dos clientes, el API responde 403 y no se genera ni se envía nada; el restablecimiento queda en manos de un administrador.
El valor vive en configuracion_password.recuperacion_habilitada (fila única, migración 055),
así que el cambio se aplica al instante, sin reiniciar el API, y queda auditado con el
resto de la política. Mientras nadie guarde la política, el valor inicial sale de
PASSWORD_RECUPERACION_HABILITADA (.env).
Cambios técnicos
API (ccf-almacen-api)
| Archivo | Cambio |
|---|---|
domains/passwords/entities/configuracion-password.entity.ts | Nueva columna recuperacion_habilitada (default true). |
domains/passwords/passwords.types.ts · dto/actualizar-politica-password.dto.ts | El campo entra en el contrato y en el DTO (opcional, @IsBoolean). |
domains/passwords/politica-password.service.ts | Lectura/guardado del interruptor, valor de .env y auditoría del cambio. |
domains/passwords/passwords.controller.ts | Nuevo endpoint público GET /api/passwords/recuperacion → { habilitada }. |
domains/usuarios/usuarios.service.ts | forgotPassword comprueba el interruptor antes de tocar la contraseña y responde 403 si está apagado. |
database/migrations/055-add-recuperacion-password-habilitada.ts | Migración idempotente y reversible. |
Web (ccf-almacen-web)
components/security/politicas-password.tsx: interruptor con explicación de ambos estados.pages/forms/login/login-form.tsx: ¿Forzar contraseña? solo se pinta si está habilitado.services/forgot-password.tsx: muestra el mensaje real del API (por ejemplo el 403).api/passwords.ts:getRecuperacionPasswordHabilitada()(endpoint público).
Móvil (ccf-almacen-mb)
| Archivo | Cambio |
|---|---|
src/api/auth.ts | Nuevo módulo: getRecuperacionHabilitada() y solicitarRecuperacionPassword(email). |
src/screens/RecuperarPasswordScreen.tsx | Pantalla de recuperación, con estados de envío, acuse, error y «mecanismo apagado». |
src/components/FontScaleControls.tsx | Control compacto A− % A+ sobre useFontScaleStore. |
src/components/AccesoPie.tsx | Pie común de las pantallas de acceso (tamaño de letra + versión). |
src/theme/paletaLogin.ts | Paleta petróleo/naranja compartida por login y recuperación. |
src/screens/LoginScreen.tsx | Iconos en lugar de chips, enlace de recuperación, pie y API solo en __DEV__. |
src/navigation/AppNavigator.tsx | RecuperarPassword en la pila pública (sin sesión). |
Verificación
ccf-almacen-api:tsc --noEmitlimpio y 52 pruebas en verde (usuarios/passwords), incluida la nueva «rechaza la recuperación cuando el administrador apagó el mecanismo».ccf-almacen-web:tsc --noEmitlimpio y 9 pruebas en verde (políticas y cambio obligatorio de contraseña).ccf-almacen-mb:tsc --noEmitlimpio y 118 pruebas en verde, con la nueva suite__tests__/acceso.render.test.tsx(enlace visible/oculto, envío del correo y aviso de mecanismo apagado).
El endpoint de recuperación está marcado con @RequiereCaptcha, igual que el login. El
terminal móvil no ejecuta reCAPTCHA v3: mientras el despliegue no tenga claves configuradas el
guard deja pasar la petición, exactamente como ya ocurre con el inicio de sesión móvil.
