Gestor Deportivo is an open-source backend API built with Node.js, Express, and MongoDB that covers the complete lifecycle of a sports tournament. From registering players and assembling teams, to scheduling matches, tracking live match events, and publishing final standings — everything is managed through a single, consistent REST API with JWT-based authentication and cloud-ready infrastructure.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/fredy-rizo/gestor-backend/llms.txt
Use this file to discover all available pages before exploring further.
Architecture Overview
The system is composed of four core layers that work together to serve tournament data reliably and securely.| Layer | Technology |
|---|---|
| Runtime & Framework | Node.js 18+ · Express 4 · Babel (ES6+) |
| Database | MongoDB 6 via Mongoose 8 |
| Authentication | JSON Web Tokens (JWT) — passed via access-token header |
| File Storage | Google Cloud Storage (team logos, player photos) |
| Nodemailer + Gmail App Password (verification & recovery) | |
| Real-time | Socket.io 4 |
| Caching | Redis 4 |
/api/ prefix and exclusively accept POST requests, keeping the interface uniform and easy to firewall or proxy.
Key Features
JWT Auth & Email Verification
Register users, verify accounts via a one-time email code, and recover passwords — all secured with signed JSON Web Tokens.
Team & Player Management
Create and update teams, roster players, track individual stats, and bulk-import players from Excel (.xlsx) files.
ClubHub Multi-Team Grouping
Group multiple teams under a single Club entity. Ideal for academies and organisations that run several squads simultaneously.
Tournament & Event Creation
Configure events with knockout brackets or group-stage formats. Control team quotas, dates, and division settings from one endpoint.
Live Match Data
Record goals, yellow and red cards, fouls, and substitutions in real time as matches progress, with Socket.io push support.
Auto Standings & Top Scorers
Standings tables and top-scorer leaderboards are recalculated automatically every time a match result is submitted.
Player Transfers
Move players between teams within the platform while preserving complete historical statistics and transfer records.
Event Reservation System
Teams can request participation slots in an event; organisers approve or reject reservations through a dedicated endpoint.
News & Notices per Event
Publish news articles and official notices scoped to a specific event, keeping participants informed without cluttering other tournaments.
Image Uploads via Google Cloud
Team logos and player photos are uploaded directly to a Google Cloud Storage bucket, served via public bucket URLs.
Pagination on All List Endpoints
Every listing endpoint supports cursor- or page-based pagination so responses remain fast even as your data grows.
Excel Player Import
Seed an entire squad at once by uploading a standard .xlsx file, dramatically cutting onboarding time for large rosters.
Membership Plans
Gestor Deportivo ships with a built-in plan system that limits how many teams a user account may own at any given time.| Plan | Teams Allowed | Ideal For |
|---|---|---|
| Free | 1 team | Individual coaches & hobbyists |
| Basic | 3 teams | Small clubs and local leagues |
| Premium | 10 teams | Academies and regional federations |
Next Steps
Quickstart
Clone the repo, set your environment variables, and make your first authenticated API request in under five minutes.
API Reference
Explore every endpoint — request bodies, response shapes, and authentication requirements — in the full API reference.