Club FAMA Valle
Sistema de gestión para un club de baloncesto
Mensualidades, calendario de entrenamientos y pizarra táctica de jugadas,
en una aplicación instalable desde el celular.
Qué resuelve
Un club deportivo de barrio maneja tres cosas que casi siempre viven en
WhatsApp: quién pagó la mensualidad, cuándo y dónde entrena cada categoría, y
qué jugadas se van a practicar. Esta aplicación las reúne, con una vista para
el administrador y otra para el jugador.
Funcionalidades
Pagos y mensualidades
- El jugador sube la foto o el PDF del comprobante desde el celular.
- El administrador los revisa y los aprueba o rechaza.
- Cada pago queda asociado al mes que cubre, y el jugador ve su estado de
cuenta y si queda en mora.
- Los comprobantes se guardan en Cloudinary, no en el disco del servidor.
Pizarra táctica
- Jugadas guardadas como una secuencia de pasos.
- Cada paso define la posición de los jugadores en la cancha, quién tiene el
balón y qué hace: pasar, lanzar, cortar, driblar, poner bloqueo o esperar.
- Permite reproducir la jugada paso a paso para explicarla al equipo.
Calendario
- Entrenamientos y partidos con fecha, hora, lugar y categoría.
- Eventos recurrentes, para no cargar un entrenamiento semana por semana.
Usuarios
- Dos roles: administrador y jugador, cada uno con su propia vista.
- Jugadores organizados por categoría y posición.
Arquitectura
backend/ Node.js + Express + MongoDB (Mongoose)
models/ User, Payment, Event, Formation
controllers/ Autenticación, pagos, eventos y jugadas
config/ Conexión a MongoDB y Cloudinary
frontend/ HTML + CSS + JavaScript (sin framework), PWA instalable
public/pages/ Vistas de administrador y de jugador
Seguridad: autenticación JWT, contraseñas con bcrypt, rutas protegidas por
rol y CORS restringido al dominio del frontend.
Despliegue: backend en Render, frontend en Vercel.
Ejecución local
Requisitos: Node 18+ y una instancia de MongoDB (local o Atlas).
cd backend
npm install
cp .env.example .env # configura MONGODB_URI y JWT_SECRET
npm start # http://localhost:5000
El frontend son archivos estáticos: sírvelos con cualquier servidor local y
apunta la configuración a la URL de tu API.
Variables de entorno
| Variable | Obligatoria | Para qué sirve |
|---|
MONGODB_URI | Sí | Conexión a la base de datos |
JWT_SECRET | Sí | Firma de los tokens de sesión |
CLOUDINARY_* | Recomendada | Almacenamiento de los comprobantes de pago |
FRONTEND_URL | Sí en producción | Origen permitido por CORS |
Licencia
Proyecto privado desarrollado para el Club FAMA Valle.
