4.5 KiB
4.5 KiB
Spec 001 — Autenticación de Operador y Vinculación de Workstation en Tablets
Estado: borrador
Contexto y objetivo
Permitir que los operadores y supervisores de seguridad inicien sesión en el cliente web OnEverControl desde tablets táctiles (Android, Windows, iPad) o PCs de garita en la red local, validando sus credenciales existentes contra la base de datos videoman de OnEverAccess y reconociendo la tablet como una Workstation autorizada con sus carriles asignados.
Usuarios / Actores
- Operador de Garita (Guardia): Inicia sesión para operar los carriles asignados a su puesto.
- Supervisor de Seguridad: Configura o reasigna el identificador de estación (
workstation_name) en la tablet.
Historias de usuario
- HU-1: Como operador de garita, quiero iniciar sesión con mi usuario y contraseña en la tablet para acceder al puesto de control sin tener que recordar credenciales nuevas.
- HU-2: Como supervisor de seguridad, quiero vincular la tablet a un nombre de workstation registrado (ej:
TABLET_01) para que el sistema cargue automáticamente los carriles correspondientes a ese puesto físico. - HU-3: Como guardia en tablet táctil, quiero pulsar botones amplios y ver un teclado numérico automático para poder autenticarme de forma cómoda y rápida sin errores táctiles.
Requisitos funcionales (Criterios de aceptación en sintaxis EARS)
- RF-1 (Login Exitoso): CUANDO el operador ingresa su usuario y contraseña válidos y pulsa "Ingresar", EL SISTEMA valida las credenciales contra la tabla
usrde SQL Servervideoman, genera una sesión segura mediante Cookie HttpOnly y carga el Puesto de Control con la estación activa. - RF-2 (Credenciales Inválidas): SI el usuario o la contraseña ingresados no coinciden o no existen en la base de datos, ENTONCES EL SISTEMA muestra un mensaje de error táctil destacado indicando "Usuario o contraseña incorrectos" y mantiene el foco en el formulario sin cerrar la pantalla.
- RF-3 (Resolución de Workstation): CUANDO se carga la aplicación en la tablet, EL SISTEMA consulta si existe un
workstation_namepersistido en el dispositivo y valida mediantees_puesto_de_control(workstation_name)que sea una estación habilitada en OnEverAccess. - RF-4 (Estación No Autorizada): SI el
workstation_nameconfigurado en la tablet no está registrado como puesto de control en OnEverAccess o no tiene módulos asignados, ENTONCES EL SISTEMA muestra una tarjeta informativa de advertencia ("Estación no autorizada") y bloquea la operación hasta que un supervisor configure una estación válida. - RF-5 (Configuración de Estación): CUANDO un supervisor ingresa con credenciales de supervisión, EL SISTEMA permite seleccionar o cambiar el
workstation_namede la tablet desde un selector de estaciones disponibles en la red local. - RF-6 (Cierre de Sesión): CUANDO el operador pulsa el botón "Cerrar Sesión", EL SISTEMA invalida el token JWT, limpia los datos sensibles de la memoria y regresa a la pantalla de Login.
Requisitos no funcionales
- Touch-First: Campos de texto y botón de ingreso con altura mínima de 48px, espaciado ergonómico para uso con dedos en tablets de 10" a 13".
- Teclado Virtual Amigable: Layout adaptativo con
100dvhque garantiza que el botón "Ingresar" no quede oculto detrás del teclado en pantalla en iPadOS o Android. - Latencia de Autenticación: La validación de credenciales y carga de carriles debe responder en menos de 250 ms dentro de la red local.
Casos límite
- Desconexión temporal de la red local durante el login: mensaje claro de "Servidor OnEverAccess no disponible en la red local".
- Intento de iniciar sesión sin haber seleccionado o configurado una workstation en la tablet.
- Tablet operando en orientación vertical (Portrait) u horizontal (Landscape).
Fuera de alcance
- Creación o edición de nuevos usuarios en la base de datos (se realiza en la suite central OnEverAccess).
- Asignación de roles o privilegios desde la web (se gestionan en OnEverAccess desktop).
Criterios de finalización
- Endpoint
/api/v1/auth/loginy/api/v1/control-posts/workstationprobados con tests automatizados enpytesten verde. - Pantalla de Login en frontend probada en resolución tablet táctil con simulación de teclado virtual y verificación en iPad y Android.
- Sesión persistida y cierre de sesión seguro comprobado.
Dudas abiertas
- Ninguna. Flujo alineado con la base de datos
videomany requerimientos de Workstation.