50 lines
3.3 KiB
Markdown
50 lines
3.3 KiB
Markdown
# 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).
|