Suggestions System

1. Feature Brief

The Suggestions plugin gives your community a structured, category-driven way to submit feedback. Members submit proposals through a guided modal; suggestions post into a public channel with real-time vote buttons and auto-created discussion threads. Staff can review, approve, reject, or mark suggestions as implemented from a private review channel.

1. Category selection - members pick an active category before submitting to keep ideas organized
2. Modal intake - modal collects a title (up to 100 characters) and a detailed description (up to 1,000 characters)
3. Interactive voting - upvote and downvote buttons update counts live with automatic single-vote switching
4. Discussion threads - automatically creates an attached thread on each suggestion for focused member discussion
5. Staff review workflow - optional review channel mirrors proposals with Approve, Reject, and Implemented actions
6. Live status synchronization - actioning a suggestion in staff review immediately updates the embed status in the public channel
7. Database recovery - administrators can run /suggestions repairdb to re-sync message IDs and vote counters

Who can use this?

Any member can run /suggest. All /suggestions management and repair subcommands require Manage Server permission.

---

2. Sub-Systems

Submission Flow

Running /suggest opens an ephemeral two-step flow:

1. A dropdown displays all currently active categories with their name and emoji
2. Selecting a category presents a modal with Title and Description fields
3. On submission, the suggestion is posted to the public channel with sequential server numbering (e.g. #1, #2)

Voting

Every suggestion features live vote buttons:

Button	Action
✅ Upvote	Adds an upvote; removes an existing downvote if present
❌ Downvote	Adds a downvote; removes an existing upvote if present

Clicking the same vote button a second time toggles the vote off. Members can hold at most one active vote at a time.

Staff Review Workflow

When a review channel is configured, suggestions are mirrored to staff with action buttons:

Action	Next State	Public Embed Colour
Approve	Exposes “Mark as Implemented” button	🟢 Green
Reject	Closes proposal	🔴 Red
Mark as Implemented	Completes proposal	🟡 Yellow

Embed footers update automatically with the name of the moderator who actioned the proposal.

Maintenance & Repair

• Database Repair (/suggestions repairdb):
  • If Discord channel messages were temporarily desynchronized or bot database indices need refreshing, /suggestions repairdb validates suggestion records and updates active vote caches
  • Scoped to the current server by default

---

3. Setup Guide

1. Run setup - execute /suggestions setup channel:#suggestions-channel with an optional review:#staff-review channel.

2. Customize categories - use /suggestions addcategory or /suggestions togglecategory to customize suggestion topics:

   /suggestions addcategory name:Events emoji:🎉
   /suggestions addcategory name:Features emoji:💡

3. Check status - run /suggestions status to confirm active channels and category counts.

Suggestions Commands

Command	Permission	Description
/suggest	Everyone	Submit a new suggestion via modal
/suggestions setup	Manage Server	Set public suggestions channel and optional review channel
/suggestions addcategory	Manage Server	Add a new category with name and emoji
/suggestions removecategory	Manage Server	Delete an existing category
/suggestions togglecategory	Manage Server	Enable or disable a category
/suggestions list	Manage Server	List all configured categories and states
/suggestions status	Manage Server	View system status, counts, and breakdown
/suggestions repairdb	Manage Server	Repair and re-index suggestion records and vote counters