How sd-ct7/ctgp-7_time_trials_bot works
This is a Discord bot for submitting and approving Mario Kart time-trial records, managing leaderboard roles, and logging approvals. Discord interactions enter through the worker handler, which dispatches commands; submissions extract and validate proof details before sending records to the GAS backend, while staff approval reads submission messages and updates records. A separate role-setup route applies ranks from a ranking snapshot. The README is empty, so capabilities and relationships here are based on the supplied source excerpts and SOURCE INDEX; the registration command implementation is present in the tree but its wiring is not shown.
Main entry points: index.js Request router · rsubmit.js Record submission · discord.js Discord helpers · gas.js GAS client
Components 20
Worker entry
- Request router
src/index.js
Record commands
- Record submission
src/commands/rsubmit.js - Record approval
src/commands/approve.js - Remove error message
src/commands/removeerror.js - Role setup
src/commands/setupRoles.js - Command registration
src/commands/register.js
Domain services
- Discord helpers
src/lib/discord.js - Submission parsing
src/lib/parser.js - Track catalog
src/lib/tracks.js - YouTube title lookup
src/lib/youtube.js - GAS client
src/lib/gas.js - Approval logging
src/lib/log.js - Paris date helper
src/lib/date.js - Ranking role logic
src/lib/roles.js
External systems
- Discord API
- GAS backend
- Ranking snapshot
- Supabase tracks
- YouTube oEmbed
Other components
- Discord user
Connections 31
- Discord user → Request router: sends interactions
src/index.js - Request router → Discord helpers: verifies requests
src/index.js - Request router → Record submission: dispatches command
src/index.js - Request router → Record approval: dispatches command
src/index.js - Request router → Remove error message: dispatches command
src/index.js - Request router → Role setup: routes setup
src/index.js - Request router → GAS client: checks milestones
src/index.js - Request router → Discord helpers: sends followup
src/index.js - Record submission → Track catalog: loads tracks
src/commands/rsubmit.js - Record submission → Discord helpers: finds proof message
src/commands/rsubmit.js - Record submission → Submission parsing: extracts details
src/commands/rsubmit.js - Record submission → YouTube title lookup: looks up title
src/commands/rsubmit.js - Record submission → GAS client: checks and submits
src/commands/rsubmit.js - Record submission → Approval logging: logs auto-approval
src/commands/rsubmit.js - Record approval → Discord helpers: fetches submission
src/commands/approve.js - Record approval → Submission parsing: parses embed
src/commands/approve.js - Record approval → GAS client: approves record
src/commands/approve.js - Record approval → Approval logging: logs approval
src/commands/approve.js - Remove error message → GAS client: checks staff
src/commands/removeerror.js - Remove error message → Discord helpers: fetches message
src/commands/removeerror.js - Role setup → Ranking snapshot: fetches snapshot
src/commands/setupRoles.js - Role setup → GAS client: gets player mapping
src/commands/setupRoles.js - Role setup → Ranking role logic: updates ranking roles
src/commands/setupRoles.js - Role setup → Discord helpers: sends announcements
src/commands/setupRoles.js - Discord helpers → Discord API: calls endpoints
src/lib/discord.js - Ranking role logic → Discord API: updates member roles
src/lib/roles.js - GAS client → GAS backend: sends actions
src/lib/gas.js - Track catalog → Supabase tracks: loads tracks
src/lib/tracks.js - YouTube title lookup → YouTube oEmbed: fetches oEmbed title
src/lib/youtube.js - Approval logging → Paris date helper: formats date
src/lib/log.js - Approval logging → Discord API: posts log
src/lib/log.js