Saltar al contenido principal

SREQ-UX-04 · Tour guiado por funcionalidad

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

El requerimiento pedía un tour guiado en cada funcionalidad principal, siguiendo los patrones de SurosV4 en el sistema web y de sean-pets en la app móvil. La foto de partida era curiosa: el medio que parecía «secundario» ya lo tenía todo, y el principal no tenía nada.

MedioAntes
Web (ccf-almacen-web)Ningún tour. Solo un botón de ayuda contextual (UX-006) y marcadores data-tour dormidos en el login
Móvil (ccf-almacen-mb)Tour completo (motor, guion, anclas, store), pero 3 pantallas sin guía

REQ-UX-05 · Estilos de precarga con Skeleton Screen

· 5 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

El requerimiento pide tres cosas: que se muestren esqueletos mientras llegan los datos, que aparezcan antes del contenido final y que los estilos sean consistentes en toda la aplicación.

Lo llamativo es que la primera ya estaba escrita. design.md —el sistema visual de obligado cumplimiento— decía desde REQ-DSG-01:

Carga: skeleton (esqueletos) y overlay loading-container (CSS global).

Pero el código no lo seguía:

PatrónEstado antes
LoadingState (listas y tablas)17 usos en 12 ficheros — y pintaba un spinner
Textos sueltos «Cargando…»19 sitios, cada uno con su tamaño y su color
Skeleton14 usos en solo 5 ficheros, dibujados a mano
Componentes nuevos7 (el juego completo por forma de dato)

Así que REQ-UX-05 es, en buena parte, alinear la aplicación con su propio sistema visual, y dejar por escrito lo que faltaba: cuándo corresponde esqueleto y cuándo indicador.

TEC-019 — Cifrado de datos sensibles (PII) y endurecimiento del JWT

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Primera fase del requerimiento REQ-SEC-14 (Seguridad), que nace de su validación: el cifrado en reposo de TEC-007 cubría importes y proveedor, pero no la PII de personas. La Fase 1 la cifra, añade el secreto de webhook a la rotación y fija el algoritmo del JWT. La Fase 2 (sesión en cookie HttpOnly + CSRF) queda documentada para después.

TEC-019 (Fase 2) — Sesión en cookie HttpOnly + CSRF y móvil con almacén seguro

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Cierra el criterio «las cookies de sesión están protegidas» de REQ-SEC-14. La web deja de guardar el JWT en localStorage: el API lo emite en una cookie HttpOnly; Secure; SameSite con CSRF double-submit, y el usuario se hidrata con GET /api/auths/me. El móvil sigue con cabecera y mueve el token a expo-secure-store.

Landing v3 — Nuevo sistema visual

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Nueva versión de la página pública del módulo de almacén. La landing v3 reutiliza el mismo catálogo de la v2 (49 módulos, 7 dominios) y cambia por completo la capa visual, siguiendo la referencia de estilo «amanecer cálido sobre arquitectura monocroma».

Ruta nueva: /v3. Ni la v1 (/) ni la v2 (/v2) se modifican.

TEC-008 — Auditoría de Accesos

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación de la mejora TEC-008 (Auditoría de Accesos), dentro de 6.2 Seguridad. El sistema pasa de un log de peticiones (que había que interpretar) a un registro de accesos con resultado, usuario del intento e IP, escrito siempre desde el servidor, más una página de consulta con los filtros que exige el requerimiento.