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.