Lab Finanzas Itaú UdeC — Sistema de Reservas

Aplicación web (Node.js + Express) para reservar bloques horarios del laboratorio de finanzas y visualizar la ocupación a lo largo de todo el año. Diseño oscuro tipo terminal financiera.

Características

• Vista Semana: grilla horaria tipo agenda; clic en un bloque libre para reservar.
• Vista Mes: calendario con las reservas de cada día y lista de próximas reservas.
• Vista Año: mapa de calor (estilo GitHub) con la ocupación diaria de los 12 meses.
• Reserva con validación: sin choques de horario, dentro del horario del laboratorio, máximo de horas por reserva y, opcionalmente, anticipación mínima (minAdvanceDays; 0 = sin restricción, que es el valor actual). Las reglas se muestran en la barra superior y en el formulario de reserva.
• Aprobación por administrador: cada reserva entra como pendiente y no ocupa el horario en firme hasta que un administrador la aprueba. Panel en /admin (o el ícono ⚿) con pestañas Pendientes / Aprobadas / Todas y acciones aprobar · rechazar · eliminar. Un bloque pendiente aparece rayado en el calendario hasta que se resuelve.
• Horas escritas a mano: inicio y término se escriben en formato 24 h (por ejemplo 11:15 a 12:45); duración mínima de 15 minutos y máximo maxHoursPerReservation.
• Reservas recurrentes: el formulario pregunta ¿por cuántas semanas? (1 a maxRecurringWeeks, 20 por defecto) y crea el mismo día y horario cada semana de una vez. Si alguna semana choca no se crea ninguna y se listan las fechas en conflicto. Toda la serie comparte un código (se puede cancelar una semana o todas) y el administrador la aprueba o rechaza con un solo clic.
• Panel de administración como calendario: pestaña Calendario mensual; al hacer clic en un día se ven sus reservas y se pueden eliminar eligiendo entre solo esta reserva o todas las del semestre en ese horario (mismo día de la semana, horario, curso y responsable). Si se activa minAdvanceDays, el administrador puede reservar sin esa anticipación.
• Recomendación de escritorio: en celulares se muestra un aviso (que se puede cerrar) y un recordatorio dentro del formulario de reserva.
• Código de cancelación: cada reserva entrega un código de 6 caracteres necesario para cancelarla o consultar su estado.
• Filtro por curso, nombre o motivo, y panel de estadísticas del periodo (reservas, horas, % de ocupación, horas por curso).

Requisitos

• Node.js 20 o superior

Puesta en marcha

npm install
npm run schedule   # carga el horario académico del semestre (ver más abajo)
npm start

Luego abre http://localhost:3000. El panel de administración está en http://localhost:3000/admin.

Contraseña de administrador

npm start lee el archivo .env (ignorado por git). Define ahí la clave:

ADMIN_PASSWORD="tu-clave-secreta"

Si no hay .env ni variable ADMIN_PASSWORD, se usa bloomberg-admin (solo para pruebas locales). Para cambiar la clave, edita .env y reinicia.

Para desarrollo con recarga automática:

npm run dev

Horario académico fijo

schedule.js borra todas las reservas y carga el horario recurrente del semestre (lun 10-ago-2026 → vie 11-dic-2026). Edita la constante WEEKLY para cambiar bloques, responsables o correos, y vuelve a ejecutar:

npm run schedule

Configuración

Edita LAB_CONFIG en server.js para ajustar horario, días de apertura, número de terminales, duración máxima por reserva y el listado de cursos.

Almacenamiento

Dos backends, elegidos automáticamente:

• Archivo JSON (data/reservations.json, escritura atómica) — por defecto en local, Render, Railway, etc. La ruta se cambia con DATA_DIR.
• Redis (Upstash) — si están definidas UPSTASH_REDIS_REST_URL y UPSTASH_REDIS_REST_TOKEN. Necesario en hostings serverless como Vercel.

En ambos casos, si la base arranca vacía se carga solo el horario del semestre.

Despliegue en la nube

GitHub guarda el código pero no ejecuta el servidor. Hay que conectar el repo a un hosting que corra Node.

Opción recomendada (gratis): Vercel + Upstash Redis

Ambos tienen plan gratuito permanente y no piden tarjeta.

1. Sube el repo a GitHub: git push -u origin main (el remoto origin ya está configurado).
2. Base de datos — en https://console.upstash.com crea una base Redis (gratis). Copia UPSTASH_REDIS_REST_URL y UPSTASH_REDIS_REST_TOKEN. (O desde Vercel: Storage → Marketplace → Upstash, y las variables se inyectan solas.)
3. Vercel — en https://vercel.com/new importa el repo. Vercel detecta vercel.json (funciones + api/index.js).
4. En Settings → Environment Variables define:
   • ADMIN_PASSWORD = tu clave
   • UPSTASH_REDIS_REST_URL y UPSTASH_REDIS_REST_TOKEN (del paso 2)
5. Deploy. La primera visita carga el horario del semestre automáticamente.

Alternativa: Render / Railway (con render.yaml)

Usa el backend de archivo + disco persistente. En Render: New → Blueprint, define ADMIN_PASSWORD. El disco persistente requiere plan starter (~US$7/mes); en plan free los datos se reinician en cada despliegue y el servicio se suspende tras 15 min de inactividad.

API

Método	Ruta	Descripción
GET	/api/config	Configuración del laboratorio
GET	/api/reservations?from=YYYY-MM-DD&to=YYYY-MM-DD	Reservas en el rango
GET	/api/stats?from=&to=	Métricas de ocupación del rango
POST	/api/reservations	Crear reserva (queda pending)
GET	/api/reservations/:id?code=	Consultar estado de una reserva por código
POST	/api/reservations/:id/cancel	Cancelar reserva (requiere { code })
POST	/api/admin/login	Inicia sesión de administrador → { token }
GET	/api/admin/reservations?status=	Listado completo (Bearer token)
POST	/api/admin/reservations/:id/approve	Aprobar
POST	/api/admin/reservations/:id/reject	Rechazar ({ note } opcional)
DELETE	/api/admin/reservations/:id[?scope=series]	Eliminar una reserva; con scope=series, todas las del mismo bloque semanal

Para operar sin aprobación (reservas confirmadas al instante), pon requireApproval: false en LAB_CONFIG.

Variables de entorno

Variable	Descripción
ADMIN_PASSWORD	Clave del panel de administración (obligatoria en producción).
PORT	Puerto del servidor (por defecto 3000; el hosting suele fijarlo).
DATA_DIR	Carpeta donde se guarda reservations.json (backend de archivo).
UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN	Activan el backend Redis (serverless).
BOOTSTRAP_SCHEDULE	0 desactiva la carga automática del horario en una base vacía.