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