Cómo está hecho¶
Una mirada general, para quien tenga curiosidad técnica. No hace falta leer esta página para usar Relevo.
Las piezas¶
Relevo tiene tres partes que trabajan juntas:
| Pieza | Qué hace |
|---|---|
| Interfaz | Las pantallas que ves en el navegador: calendario, formularios y panel de coordinación |
| Servicio de reglas | Recibe cada solicitud, aplica las reglas y responde si procede o no |
| Base de datos | Guarda empleados, grupos y solicitudes |
Cuando envías una solicitud, la interfaz se la pasa al servicio de reglas. Este revisa, en orden: el compañero de respaldo, que no haya cruce con otra solicitud tuya, tu saldo y el cupo de tus grupos. Solo si todo se cumple, la guarda.
Las reglas viven en un único lugar del sistema. Así, lo que valida el formulario y lo que muestra el calendario nunca se contradicen.
Tecnologías¶
| Capa | Tecnología |
|---|---|
| Interfaz | Streamlit (Python) |
| Servicio de reglas | FastAPI (Python) |
| Datos | SQLite con SQLAlchemy |
| Festivos | Cálculo propio del calendario colombiano |
| Empaquetado | Contenedores Docker |
Seguridad¶
- Las contraseñas no se guardan en texto legible: se almacenan cifradas con un algoritmo de un solo sentido (bcrypt). Ni la coordinación ni quien administra el sistema pueden leerlas.
- La sesión se mantiene con un identificador firmado, que no puede alterarse desde el navegador.
- La privacidad se aplica en el servicio de reglas, no solo en la pantalla: a quien no ha iniciado sesión el sistema sencillamente no le entrega nombres.
- La comunicación viaja cifrada (HTTPS).
Calidad¶
Relevo se construye por etapas cortas. Cada etapa tiene un plan, una implementación y una auditoría que debe aprobarse antes de continuar.
| Indicador | Valor |
|---|---|
| Pruebas automáticas | Más de 80, que se ejecutan con cada cambio |
| Cobertura de las pruebas | 88 % del código verificable |
| Auditorías de calidad | 12, todas aprobadas |
Las pruebas cubren tanto los casos en que una solicitud debe aceptarse como aquellos en que debe rechazarse.
Evolución¶
| Versión | Qué aportó |
|---|---|
| 1 | Cálculo de festivos, motor de reglas y seguridad |
| 2 | Interfaz web |
| 3 | Grupos de trabajo y cupos por grupo; aprobación automática |
| 4 | Mejoras para celular; control de solicitudes duplicadas y topes |
| 5 | Calendario mejorado y cambio de contraseña |
| 6 | Puesta en producción |
| 7 | Calendario alineado con los cupos por grupo |
| 8 | Alta de empleados desde el panel; nombres visibles solo con sesión |
| 9 | Limpieza interna y medición de cobertura |
Alcance¶
Relevo está pensado para equipos pequeños, de alrededor de diez personas. Es un apoyo para coordinar ausencias dentro de la oficina; no reemplaza los trámites formales de vacaciones y permisos ante la entidad.