How codewizard-26/athlete-management works
ATHLETIX is a multi-role sports and athlete management platform. Users register and authenticate, then enter athlete, team-manager, or organization workflows for profiles, recruitment, team administration, performance, tournaments, and matches. The React client routes role-protected portal pages through a shared API client to an Express API; API routes enforce authentication and roles and use MongoDB-backed domain models. README capabilities include bulk performance entry and analytics. Several subsystem links below are documented in the README because their implementation files were not sampled.
Main entry points: app.js Express API · AppRoutes.jsx Role-based routes · team.model.js Teams and memberships · axios.js Authenticated API client
Components 24
Web client
- Role-based routes
Frontend/src/routes/AppRoutes.jsx - Login and registration
Frontend/src/features/auth/pages - Athlete portal
Frontend/src/features/athlete/pages - Team portal
Frontend/src/features/team/pages - Organization portal
Frontend/src/features/organization/pages - Match and tournament views
Frontend/src/features - Authenticated API client
Frontend/src/api/axios.js
Identity and access
- Authentication API
Backend/src/modules/auth/auth.routes.js - JWT authentication
Backend/src/middleware/auth.middleware.js - Role authorization
Backend/src/middleware/role.middleware.js - User accounts
Backend/src/modules/user/user.model.js
Athletes and recruitment
- Athlete profiles
Backend/src/modules/athlete/athlete.model.js - Recruitment and applications
Backend/src/modules/recruiter - Teams and memberships
Backend/src/modules/team/team.model.js
Sports operations
- Organizations
Backend/src/modules/organization/organization.routes.js - Tournament management
Backend/src/modules/tournament/tournament.routes.js - Match scheduling and reports
Backend/src/modules/match/match.routes.js - Performance records
Backend/src/modules/performance/performance.routes.js - Role dashboards and analytics
Backend/src/modules/dashboard/dashboard.routes.js
API and services
- Express API
Backend/src/app.js - Uploads and media
Backend/src/modules/upload/upload.routes.js
Other components
- Platform user
- Cloudinary storage
- MongoDB
Connections 42
- Platform user → Role-based routes: uses portal
README.md - Role-based routes → Login and registration: routes to
Frontend/src/routes/AppRoutes.jsx - Role-based routes → Athlete portal: routes by role
Frontend/src/routes/AppRoutes.jsx - Role-based routes → Team portal: routes by role
Frontend/src/routes/AppRoutes.jsx - Role-based routes → Organization portal: routes by role
Frontend/src/routes/AppRoutes.jsx - Role-based routes → Match and tournament views: routes to
Frontend/src/routes/AppRoutes.jsx - Login and registration → Authenticated API client: calls API
Frontend/src/features/auth/pages/Register.jsx - Athlete portal → Authenticated API client: calls API
Frontend/src/features/athlete/pages/CreateProfile.jsx - Team portal → Authenticated API client: calls API
Frontend/src/features/team/pages/TeamDashboard.jsx - Organization portal → Authenticated API client: calls API
Frontend/src/features/organization/pages/PerformanceEntry.jsx - Match and tournament views → Authenticated API client: calls API
Frontend/src/features/match/pages/MatchDetails.jsx - Authenticated API client → Express API: sends requests
Frontend/src/api/axios.js - Express API → Authentication API: mounts routes
Backend/src/app.js - Express API → Organizations: mounts routes
Backend/src/app.js - Express API → Teams and memberships: mounts routes
Backend/src/app.js - Express API → Recruitment and applications: mounts routes
Backend/src/app.js - Express API → Tournament management: mounts routes
Backend/src/app.js - Express API → Match scheduling and reports: mounts routes
Backend/src/app.js - Express API → Performance records: mounts routes
Backend/src/app.js - Express API → Role dashboards and analytics: mounts routes
Backend/src/app.js - Express API → Uploads and media: mounts routes
Backend/src/app.js - Authentication API → User accounts: reads accounts
Backend/src/modules/auth/auth.routes.js - Express API → JWT authentication: uses middleware
Backend/src/app.js - Teams and memberships → Role authorization: guards endpoints
Backend/src/modules/team/team.routes.js - Recruitment and applications → Role authorization: guards endpoints
Backend/src/modules/recruiter/recruitment.routes.js - Teams and memberships → Athlete profiles: reads profiles
Backend/src/modules/team/team.routes.js - Recruitment and applications → Athlete profiles: reads profiles
Backend/src/modules/recruiter/recruitment.routes.js - Recruitment and applications → Teams and memberships: reads teams
Backend/src/modules/recruiter/recruitment.routes.js - Organizations → User accounts: updates account
Backend/src/modules/organization/organization.routes.js - Tournament management → Match scheduling and reports: creates fixtures
Backend/src/modules/tournament/tournament.routes.js - Match scheduling and reports → Performance records: records statistics
Backend/src/modules/match/match.routes.js - Role dashboards and analytics → Teams and memberships: reads team data
Backend/src/modules/dashboard/dashboard.routes.js - Role dashboards and analytics → Athlete profiles: reads athlete data
Backend/src/modules/dashboard/dashboard.routes.js - Role dashboards and analytics → Performance records: reads metrics
Backend/src/modules/dashboard/dashboard.routes.js - Uploads and media → Cloudinary storage: uploads media
Backend/src/modules/upload/upload.routes.js - User accounts → MongoDB: persists records
- Athlete profiles → MongoDB: persists records
- Teams and memberships → MongoDB: persists records
- Organizations → MongoDB: persists records
- Tournament management → MongoDB: persists records
- Match scheduling and reports → MongoDB: persists records
- Performance records → MongoDB: persists records