How younesmoukhlij/ft_transcendence_42 works
ft_transcendence is a real-time ping-pong web platform with authentication, social play, tournaments, and player progression. Users sign in, choose local, AI, or remote play, and can join tournaments; results and activity support profiles, leaderboards, and leagues. The backend exposes API routes and WebSocket handling around game sessions and social updates. The README documents broader product capabilities than the sampled code; connections for those areas are shown only where documented, and unsampled implementation details are not inferred.
Main entry points: routes.js API routes · server.js Application server · websocketHandler.js WebSocket handler · app Web application
Components 24
Web client
- Web application
frontend/src/app
Backend runtime
- API routes
backend/routes/routes.js - Application server
backend/server.js - Authentication
backend/modules/userAuth.module.js - User accounts
backend/modules/user.module.js - Profiles
backend/modules/profile.module.js - WebSocket handler
backend/modules/websocketHandler.js
Games and tournaments
- Game modes
frontend/src/app/(protected)/game - Local tournament
frontend/src/app/(protected)/game/local-tournament/page.tsx - Bracket manager
frontend/src/components/LocalTournamentManager.ts - Game context
frontend/src/components/GameContext.tsx - Game service
backend/modules/game.module.js - Game manager
backend/modules/gameManager.js - Game messages
backend/modules/gameWebSocketHandler.js - Tournament results
backend/modules/bracket.js - Blockchain records
backend/config/blockchain.js
Social features
- Friends and notifications
backend/modules/nofitication.moudle.js - Chat and presence
backend/modules/websocketHandler.js - Status sharing
backend/modules/statusHandler.js
Player progression
- Match history
backend/modules/matchHistory.module.js - Leagues
backend/modules/leagues.module.js - Player progress
backend/modules/playerProgress.js - Leaderboard
frontend/src/app/(protected)/leaderboard/page.tsx
Other components
- Player
Connections 25
- Player → Web application: uses
- Web application → API routes: requests
- Player → Game modes: chooses mode
- Game modes → Game service: plays through
- Local tournament → Bracket manager: manages bracket
frontend/src/components/LocalTournamentManager.ts - Bracket manager → Game context: uses types
frontend/src/components/LocalTournamentManager.ts - Application server → API routes: registers
backend/server.js - API routes → Authentication: routes auth
backend/routes/routes.js - API routes → User accounts: routes account
backend/routes/routes.js - API routes → Profiles: routes profiles
backend/routes/routes.js - API routes → Game service: routes games
backend/routes/routes.js - API routes → Tournament results: routes results
backend/routes/routes.js - API routes → Friends and notifications: routes social
backend/routes/routes.js - API routes → Match history: routes history
backend/routes/routes.js - API routes → Leagues: routes leagues
backend/routes/routes.js - API routes → Player progress: routes progress
backend/routes/routes.js - Application server → Game manager: initializes
backend/server.js - Application server → WebSocket handler: configures
backend/server.js - WebSocket handler → Game messages: dispatches game messages
backend/modules/websocketHandler.js - WebSocket handler → Status sharing: updates status
backend/modules/websocketHandler.js - Tournament results → Blockchain records: uses contract config
backend/modules/bracket.js - Player → Authentication: signs in
- Player → Local tournament: enters tournament
- Player → Chat and presence: chats
- Player → Leaderboard: views progress