Primer push Fase 0 de planificacion
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user