Files
OnEverControl/specs/001-login-workstation/spec.md
T

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 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.