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

3.3 KiB

Plan Técnico — Spec 001: Autenticación y Workstation en Tablets

1. Archivos y Responsabilidades

Backend (FastAPI / Python)

  • backend/app/schemas/auth_schema.py: Modelos Pydantic para LoginRequest, LoginResponse, UserSessionDTO.
  • backend/app/schemas/workstation_schema.py: Modelos Pydantic para WorkstationDTO, WorkstationStatusResponse.
  • backend/app/core/security.py: Verificación de contraseñas (MD5/bcrypt compatible) y generación de tokens JWT.
  • backend/app/repositories/auth_repository.py: Consultas SQL Server a tablas usr y usrcatval.
  • backend/app/repositories/workstation_repository.py: Consultas a es_puesto_de_control(name) y listar_modulos_por_workstation(name).
  • backend/app/api/v1/auth.py: Endpoints /api/v1/auth/login, /logout, /me.
  • backend/app/api/v1/control_posts.py: Endpoint /api/v1/control-posts/workstation/{name}/status.
  • backend/tests/test_auth.py: Tests unitarios y de integración para endpoints de login y validación de estación.

Frontend (React + TypeScript + Vite)

  • frontend/src/api/authApi.ts: Funciones cliente para /api/v1/auth/login, /logout y /me.
  • frontend/src/api/workstationApi.ts: Cliente para /api/v1/control-posts/workstation/{name}/status.
  • frontend/src/context/AuthContext.tsx: Proveedor de estado global de autenticación del guardia.
  • frontend/src/context/WorkstationContext.tsx: Proveedor que resuelve y almacena la Workstation en localStorage.
  • frontend/src/views/LoginView.tsx: Vista táctil de inicio de sesión optimizada para tablets.
  • frontend/src/components/common/TouchInput.tsx: Campo de entrada numérico/alfanumérico de alto contraste (>= 48px).
  • frontend/src/styles/base.css: Viewport dinámico 100dvh para teclados virtuales en pantalla.

2. Decisiones Técnicas Justificadas

  1. Tokens JWT en Cookies HttpOnly con SameSite=Strict:
    • Alternativa descartada: Guardar el token en localStorage.
    • Motivo: Las cookies HttpOnly son inaccesibles por scripts JavaScript en el cliente, protegiendo las tablets ante ataques de XSS en la red local.
  2. Persistencia de Workstation en localStorage del Navegador:
    • Alternativa descartada: Consultar la IP fija de la tablet.
    • Motivo: En redes Wi-Fi de garita, las tablets pueden usar DHCP o cambiar de punto de acceso (Access Point). Vincular el workstation_name en el almacenamiento local garantiza estabilidad operativa sin depender de IPs estáticas.
  3. Layout Táctil con 100dvh:
    • Alternativa descartada: Altura fija con 100vh.
    • Motivo: En iPadOS Safari y Android Chrome, 100vh no descuenta la barra de herramientas ni el teclado en pantalla, provocando que los botones queden ocultos o desfasados. 100dvh se ajusta en tiempo real al espacio visible disponible.

3. Estrategia de Pruebas

  • Backend (Pytest):
    • Test de login con credenciales válidas -> 200 OK y cookie emitida.
    • Test de login con credenciales erróneas -> 401 Unauthorized.
    • Test de estación registrada válida -> devuelve es_puesto_de_control: True y módulos asignados.
    • Test de estación no registrada -> devuelve es_puesto_de_control: False y lista vacía.
  • Frontend:
    • Validación de campos requeridos antes de enviar.
    • Comprobación táctil de elementos >= 48px y despliegue correcto en emulador de tablet (iPad/Android).