How gsg-g13/balanty works
Balanty is a football community app for organizing matches around players and stadiums. Members and stadium owners use the React client to find matches, manage profiles, create or join games, and coordinate in match chat; stadium reviews support the venue side of the workflow. The Express API exposes corresponding domain routes and services, with Sequelize models for persisted users, matches, messages, stadiums, and reviews. The shown source establishes app routing and some server wiring; several domain-page and service connections are documented by the README but not visible in sampled implementation excerpts.
Main entry points: App.tsx Client router · index.ts Domain models · router.ts API routing · auth.ts Account services
Components 25
Web client
- Client router
client/src/App.tsx - Login and signup
client/src/components/auth/LoginWrapper.tsx - Match browsing
client/src/pages/Match.tsx - Match creation
client/src/pages/CreateMatch.tsx - Player discovery
client/src/pages/PlayersPage.tsx - Stadium browsing
client/src/pages/Stadiums.tsx - Stadium profile
client/src/pages/StadiumProfile.tsx - Player profile
client/src/pages/PlayerProfile.tsx - Match room
client/src/pages/MatchRoomPage.tsx
API and domain logic
- Express API
server/app.ts - API routing
server/routes/router.ts - Account routes
server/routes/auth.ts - Auth controller
server/controllers/auth.ts - Account services
server/services/auth.ts - Match services
server/services/matches.ts - Player services
server/services/player.ts - Stadium services
server/services/stadiums.ts - Review routes
server/routes/reviewRouter.ts - Review services
server/services/reviews.ts - Match chat service
server/services/matchChat.ts
Persistence
- Domain models
server/models/index.ts - PostgreSQL
server/database/config/connection.ts
External services
- Email delivery
- Socket.IO
Other components
- Member / owner
Connections 26
- Member / owner → Client router: uses
- Client router → Login and signup: routes to
client/src/App.tsx - Client router → Match browsing: routes to
client/src/App.tsx - Client router → Stadium browsing: routes to
client/src/App.tsx - Client router → Player discovery: routes to
client/src/App.tsx - Client router → Stadium profile: routes to
client/src/App.tsx - Client router → Player profile: routes to
client/src/App.tsx - Client router → Match room: routes to
client/src/App.tsx - Member / owner → Match creation: creates matches
- Member / owner → Match room: chats in
- Member / owner → Stadium profile: reviews stadiums
- Express API → API routing: mounts API
server/app.ts - API routing → Account routes: mounts account
server/routes/router.ts - Account routes → Auth controller: dispatches
server/routes/auth.ts - Auth controller → Account services: calls
server/controllers/auth.ts - API routing → Review routes: mounts reviews
server/routes/router.ts - Review routes → Review services: dispatches
- Account services → Domain models: reads and writes
server/services/auth.ts - Review services → Domain models: reads and writes
server/services/reviews.ts - Match services → Domain models: uses
- Player services → Domain models: uses
- Stadium services → Domain models: uses
- Match chat service → Domain models: uses
- Domain models → PostgreSQL: persists through
- Account services → Email delivery: sends email
server/services/auth.ts - Client router → Socket.IO: connects
client/src/App.tsx