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