Saltar a contenido

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.