How eltrueno/truenoproclubservices works
TPCS manages Pro Clubs across club websites and a shared account portal. A visitor browses club members, matches, statistics, achievements and Team of the Week (TOTW); the web client fetches club data from the REST API. In the background, the worker imports and normalizes EA match data, updates club and player records, computes achievements and aggregates, and publishes events for Discord announcements. Authentication, linked player identities and account settings are shared across clubs. The README documents these capabilities; some subsystem links below rely on that documentation because their source was not sampled.
Main entry points: src Sync worker · app.ts REST API · sharedDb.ts Shared MongoDB models · admin.ts Admin routes
Components 21
Club and account frontends
- Club website
apps/web/src - Account portal
apps/accounts-front/src
Club REST API
- REST API
apps/api/src/app.ts - Club routes
apps/api/src/routes/club.ts - Member routes
apps/api/src/routes/members.ts - Admin routes
apps/api/src/routes/admin.ts - Member services
apps/api/src/services/clubMember.service.ts - Position averages
apps/api/src/services/averageStats.service.ts - Shared MongoDB models
packages/shared/src/models/sharedDb.ts
Authentication and identity
- Auth service
apps/auth/src - Twitch sync
apps/auth/src/services/twitchService.ts
Sync and analytics
- Sync worker
apps/worker/src - Match normalization
apps/worker/src/dtos/match.dto.ts - Achievement calculation
apps/worker/src/services/achievement.service.ts - TOTW job
apps/worker/src/services/totw.service.ts
Events and media
- RabbitMQ events
- Discord bot
apps/discordbot/src/handlers/rabbitmqHandler.js - Image renderer
apps/imagerenderer/src/services/imageCapture.ts
Other components
- Club visitor
- EA Pro Clubs API
- Cloudflare R2
Connections 24
- Club visitor → Club website: browses
- Club website → REST API: fetches club data
- Club website → Account portal: redirects for login
- Account portal → Auth service: authenticates
- REST API → Club routes: mounts routes
apps/api/src/app.ts - REST API → Member routes: mounts routes
apps/api/src/app.ts - REST API → Admin routes: mounts routes
apps/api/src/app.ts - Club routes → Shared MongoDB models: reads club data
apps/api/src/routes/club.ts - Member routes → Shared MongoDB models: serves member data
apps/api/src/routes/members.ts - Admin routes → Shared MongoDB models: administers records
apps/api/src/routes/admin.ts - Admin routes → Member services: delegates member edits
- Admin routes → Cloudflare R2: uploads player images
- Sync worker → EA Pro Clubs API: fetches new matches
- Sync worker → Match normalization: normalizes matches
apps/worker/src/controllers/match.controller.ts - Sync worker → Shared MongoDB models: updates club records
- Sync worker → Achievement calculation: evaluates achievements
apps/worker/src/services/totw.service.ts - Sync worker → TOTW job: runs weekly selection
apps/worker/src/services/totw.service.ts - Sync worker → RabbitMQ events: publishes events
- RabbitMQ events → Discord bot: dispatches notifications
apps/discordbot/src/handlers/rabbitmqHandler.js - Sync worker → Auth service: looks up linked accounts
- Twitch sync → Auth service: syncs Twitch profile
apps/auth/src/services/twitchService.ts - REST API → Position averages: serves averages
- Sync worker → Shared MongoDB models: stores computed averages
apps/worker/src/services/averageStats.service.ts - Image renderer → RabbitMQ events: consumes render jobs