3.3 KiB
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 paraLoginRequest,LoginResponse,UserSessionDTO.backend/app/schemas/workstation_schema.py: Modelos Pydantic paraWorkstationDTO,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 tablasusryusrcatval.backend/app/repositories/workstation_repository.py: Consultas aes_puesto_de_control(name)ylistar_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,/logouty/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 enlocalStorage.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ámico100dvhpara teclados virtuales en pantalla.
2. Decisiones Técnicas Justificadas
- 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.
- Alternativa descartada: Guardar el token en
- Persistencia de Workstation en
localStoragedel 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_nameen el almacenamiento local garantiza estabilidad operativa sin depender de IPs estáticas.
- Layout Táctil con
100dvh:- Alternativa descartada: Altura fija con
100vh. - Motivo: En iPadOS Safari y Android Chrome,
100vhno descuenta la barra de herramientas ni el teclado en pantalla, provocando que los botones queden ocultos o desfasados.100dvhse ajusta en tiempo real al espacio visible disponible.
- Alternativa descartada: Altura fija con
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: Truey módulos asignados. - Test de estación no registrada -> devuelve
es_puesto_de_control: Falsey 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).