ReservaYa
ActivoPlataforma de reservas de canchas deportivas con backend híbrido SQL/NoSQL
Rol: Desarrollador full-stack
En solitario · Desde ago 2026 · Repo público
Una plataforma de reservas de canchas (fútbol, baloncesto, tenis) construida para demostrar una arquitectura híbrida de bases de datos deliberada: PostgreSQL para los datos que necesitan integridad estricta, MongoDB para datos flexibles y de alta escritura, con reservas realmente a prueba de solapamiento y una API REST probada, no solo un CRUD de ejemplo.
Problema
Los sistemas de reservas necesitan integridad estricta en horarios y reservas (dos personas nunca deben poder reservar la misma cancha a la misma hora), pero también generan datos flexibles y de alto volumen, como reseñas y notificaciones por evento, que no calzan en un schema relacional rígido.
Solución
PostgreSQL (vía Sequelize) modela usuarios, canchas, horarios semanales y reservas, con bloqueo a nivel de fila dentro de una transacción para que dos reservas que se solapen nunca puedan completarse ambas. MongoDB (vía Mongoose) almacena reseñas y notificaciones por evento, cuya forma realmente varía según el tipo de evento.
Puntos clave de arquitectura
- La creación de una reserva corre dentro de una transacción de Postgres con bloqueo a nivel de fila que re-verifica el solapamiento de horario justo antes de confirmar, cerrando la ventana de carrera entre leer y escribir en vez de depender solo de una restricción única
- El endpoint de disponibilidad calcula los bloques libres/ocupados de cada día directamente desde el horario semanal de la cancha menos sus reservas activas, sin caché aparte que mantener sincronizado
- Un pipeline de agregación de MongoDB calcula la calificación promedio y el conteo de reseñas de cada cancha al leer, combinado en la app con el registro de la cancha en Postgres
- Los eventos de dominio (reserva creada/confirmada/cancelada, reseña recibida) escriben notificaciones estructuradas en MongoDB, cada una con un campo de metadata libre que cambia según el tipo de evento
- 76 tests de backend (Vitest + Supertest) contra una base de datos de prueba real en Postgres/MongoDB, con peso hacia los caminos negativos: 401/403/404/409/400 en cada ruta, no solo el camino feliz
- 24 tests de frontend (Vitest + React Testing Library) que cubren casos de borde del contexto de autenticación (token inválido, login fallido) y redirecciones de rutas protegidas por rol