How shmiklak/nomination works
NomiNation is a Laravel and React/Inertia platform for community beatmap-modding queues. Mappers browse queues, submit beatmaps, and track requests; nominators manage queues and members, review requests, and record responses. Queue and beatmap state lives in Eloquent models, while osu! data and community notifications integrate with external services. The README documents the broader product capabilities; some frontend pages and controllers are unsampled, so only evidenced relationships are shown.
Main entry points: BeatmapsController.php Beatmap requests · NominatorController.php Nominator responses · web.php Web routes · Queue.php Queue state
Components 23
Web experience
- Web routes
routes/web.php - Mapper pages
resources/js/pages - Queue pages
resources/js/pages/queues
Queue operations
- Queue management
app/Http/Controllers/QueuesController.php - Queue state
app/Models/Queue.php - Application database
config/database.php
Request review
- Beatmap requests
app/Http/Controllers/BeatmapsController.php - Nominator responses
app/Http/Controllers/NominatorController.php - Beatmap state
app/Models/Beatmap.php - Nominator response
app/Models/NominatorResponse.php
External integrations
- osu! API client
app/Services/OsuApi.php - Discord notifications
app/Services/Discord.php - IRC notification command
app/Console/Commands/SendIRCMessage.php - IRC client
app/Services/IRCService.php - Discord service
app/Services/Discord.php
Identity
- User accounts
app/Models/User.php - osu! OAuth provider
app/oAuth/OsuProvider.php - OAuth sign-in
app/Http/Controllers/oAuth/OsuAuthController.php
Other components
- Mapper
- Nominator
- osu! services
- Discord
- IRC network
Connections 28
- Mapper → Web routes: browses and submits
- Nominator → Web routes: manages and reviews
- Web routes → Beatmap requests: routes requests
routes/web.php - Web routes → Queue management: routes queues
routes/web.php - Web routes → Nominator responses: routes responses
routes/web.php - Beatmap requests → Mapper pages: renders request views
app/Http/Controllers/BeatmapsController.php - Queue management → Queue pages: renders queue views
app/Http/Controllers/QueuesController.php - Beatmap requests → Queue state: loads queue
app/Http/Controllers/BeatmapsController.php - Beatmap requests → Beatmap state: creates requests
app/Http/Controllers/BeatmapsController.php - Beatmap requests → osu! API client: fetches beatmap data
app/Http/Controllers/BeatmapsController.php - Beatmap requests → Discord service: notifies new request
app/Http/Controllers/BeatmapsController.php - Nominator responses → Queue state: loads queue
app/Http/Controllers/NominatorController.php - Nominator responses → Beatmap state: updates request status
app/Http/Controllers/NominatorController.php - Nominator responses → Nominator response: saves responses
app/Http/Controllers/NominatorController.php - Nominator responses → Discord service: sends response alerts
app/Http/Controllers/NominatorController.php - Nominator responses → IRC notification command: dispatches accepted notice
app/Http/Controllers/NominatorController.php - Queue management → Queue state: creates and updates
app/Http/Controllers/QueuesController.php - OAuth sign-in → User accounts: finds or creates account
app/Http/Controllers/oAuth/OsuAuthController.php - OAuth sign-in → osu! OAuth provider: authenticates with
- OAuth sign-in → osu! API client: revokes token
app/Http/Controllers/oAuth/OsuAuthController.php - osu! API client → osu! services: requests osu! data
- Discord service → Discord: sends webhooks
app/Services/Discord.php - IRC notification command → IRC client: sends message
app/Console/Commands/SendIRCMessage.php - IRC client → IRC network: writes IRC protocol
app/Services/IRCService.php - Queue state → Application database: persists queue data
- Beatmap state → Application database: persists beatmap data
- Nominator response → Application database: persists response data
- User accounts → Application database: persists user data