Discord Integrations

[TptMike]

Discord Integrations

Apparently I started work before a ticket was created. Woops. High level overview of the upcoming discord integration is including the means for players to apply via Discord. This includes using an !!apply command, the bot DMs the application questions and takes replies back as input, asking the player to confirm their application with yes or no answers. If Yes, their application is sent to the forums as a post and an embed copy is posted in #staff-room. If No, the applicant redoes the process of filling out their app.

Progress

• [x] Message applicant questions and accept input
• [x] Confirm with player showing a completed copy of their application
• [x] Accept submission and transmit to forums and post copy embed for staff with a link to the post
• [x] Allow redo of application
• [x] Apply new Applicant role to newly joined users submit their application
• [x] Update Applicant role to pending once requirements have been met
• [x] Update discord syncing to allow auto-citizening from the applicant role in addition to pending role
• [x] Add applications table to EMI database
• [x] Add notifications table to EMI database ( #45 )
• [x] Capture application in database for future reference
• [x] Send notification via DM when a vote is triggered or whitelist application is approved via discord
• [x] Add !!citizen <@User> for manual citizening
• [x] Update Pending player back to applicant if vote is rejected
• [x] If vote is accepted, transmit approval post to website [OPTIONAL]
• [x] If vote is rejected, transmit rejection post to website [OPTIONAL]

  Testing

• [x] User input validation checking for whitelist app
• [x] Post transmission at whitelist app submission
• [x] #staff-room embed posts
• [x] Voting service gets proper majority required to auto-whitelist
• [x] Application properly retakes values if the user says no to confirmation embed
• [x] Verify correct data is stored in applications table
• [x] Test auto-citizening after vote majority reached and discord ID captures
• [x] Test discordsync to allow applicants role to auto-citizen

[TptMike]

This will now require a new bot to be developed. Everneth/Gatekeeper repo has been created for this task

[TptMike]

Gatekeeper (AKA Jasper) has been tested and is currently working when scoring users in the applicant role. The current functionality has hard coded values that need to be offloaded to a config file.

With this file there are some troubleshooting commands that staff will need in order to make tweaks and debug the bot if there are issues that bubble up. One potential issue will be stale or orphaned data in the cached applicants.json file. Staff will need the ability to refresh the cache and keep on trucking.

Some other commands that will be helpful will be a listing of current applicants via embed and possibly fetching the json file and embedding it in discord. With these commands we will need to permission them out accordingly. Once Jasper is feature complete, the rest of this ticket falls onto The Wench's codebase and a new listener for role changes will be required to initiate a vote in #staff-room and properly reject or deny applicants.

[TptMike]

Extensive testing completed. Thus far Jasper has experienced no bugs and has worked as designed. The wench on the other hand still has reaction validation logic required (properly detects official emojis, but not custom), and role changes upon rejection and approval of the application.

Further tests are required for citizening when rejoining our discord guild and a player record exists in the database. Vote requests may be removed from the scope. Getting to the pending rank is simple enough. Manual citizening will still be added.