# 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 `usr` de SQL Server `videoman`, 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_name` persistido en el dispositivo y valida mediante `es_puesto_de_control(workstation_name)` que sea una estación habilitada en OnEverAccess. - **RF-4 (Estación No Autorizada):** SI el `workstation_name` configurado 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_name` de 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 `100dvh` que 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/login` y `/api/v1/control-posts/workstation` probados con tests automatizados en `pytest` en 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 `videoman` y requerimientos de Workstation.