Saltar al contenido principal

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​

AntesAhora
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)​

ArchivoCambio
domains/passwords/entities/configuracion-password.entity.tsNueva columna recuperacion_habilitada (default true).
domains/passwords/passwords.types.ts · dto/actualizar-politica-password.dto.tsEl campo entra en el contrato y en el DTO (opcional, @IsBoolean).
domains/passwords/politica-password.service.tsLectura/guardado del interruptor, valor de .env y auditoría del cambio.
domains/passwords/passwords.controller.tsNuevo endpoint público GET /api/passwords/recuperacion → { habilitada }.
domains/usuarios/usuarios.service.tsforgotPassword comprueba el interruptor antes de tocar la contraseña y responde 403 si está apagado.
database/migrations/055-add-recuperacion-password-habilitada.tsMigració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)​

ArchivoCambio
src/api/auth.tsNuevo módulo: getRecuperacionHabilitada() y solicitarRecuperacionPassword(email).
src/screens/RecuperarPasswordScreen.tsxPantalla de recuperación, con estados de envío, acuse, error y «mecanismo apagado».
src/components/FontScaleControls.tsxControl compacto A− % A+ sobre useFontScaleStore.
src/components/AccesoPie.tsxPie común de las pantallas de acceso (tamaño de letra + versión).
src/theme/paletaLogin.tsPaleta petróleo/naranja compartida por login y recuperación.
src/screens/LoginScreen.tsxIconos en lugar de chips, enlace de recuperación, pie y API solo en __DEV__.
src/navigation/AppNavigator.tsxRecuperarPassword en la pila pública (sin sesión).

Verificación​

  • ccf-almacen-api: tsc --noEmit limpio y 52 pruebas en verde (usuarios/passwords), incluida la nueva «rechaza la recuperación cuando el administrador apagó el mecanismo».
  • ccf-almacen-web: tsc --noEmit limpio y 9 pruebas en verde (políticas y cambio obligatorio de contraseña).
  • ccf-almacen-mb: tsc --noEmit limpio 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).
reCAPTCHA y el móvil

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.