> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flamey.lol/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggestion System

> A comprehensive guide to Flamey's professional feedback and suggestion module.

Flamey's Suggestion System is a powerful tool for gathering, moderating, and implementing community feedback. This guide covers the setup, use cases, and advanced configuration for your server.

## Overview

The suggestion system allows users to submit ideas through Discord or a dedicated web panel. Staff can then review, approve, or deny these suggestions with integrated voting and economy rewards.

### Core Features

* **Interactive Voting**: Use modern buttons or classic reactions for community feedback.
* **Staff Queue**: Hold submissions in a private channel for moderator approval.
* **Auto-Moderation**: Automatically finalize suggestions based on vote counts or percentages.
* **Economy Integration**: Reward contributors with currency, items, or roles upon approval.

***

## Submission Methods

Users have two main ways to share their ideas:

### 1. Slash Commands

The most direct method. Users can use `/suggestion submit` to open a modal where they can input their idea, select a category, and choose to remain anonymous.

### 2. Suggestion Panels

Staff can create a permanent panel in any channel. This panel features a "Submit Suggestion" button that opens a professional modal for user input.

***

## Configuration Settings

You can manage all aspects of the suggestion system via the **[Dashboard](https://dashboard.flamey.lol)**.

### General Settings

* **Submission Channel**: Where approved or public suggestions are posted.
* **Log Channel**: Tracks all moderation actions (approvals, denials, deletions).
* **Voting Mode**: Choose between **Buttons** (recommended) or **Reactions**.
* **Auto-Thread**: Automatically create a thread for each suggestion to encourage discussion.

### Advanced Moderation

* **Manager Roles**: Roles authorized to review and moderate suggestions.
* **Access Control**: Set the system to `Public`, `Restricted` (block specific roles), or `Required` (only allow specific roles).
* **Auto-Mod Thresholds**: Set upvote/downvote targets to automatically approve or deny suggestions without manual staff intervention.

***

## Bot Logic & Lifecycle

Every suggestion follows a structured lifecycle managed by Flamey's core:

1. **Submission**: User inputs are validated for cooldowns, permissions, and media limits.
2. **Queueing**: If enabled, the suggestion is sent to a private staff channel.
3. **Moderation**: Staff or Auto-Mod transitions the suggestion to `Approved` or `Denied`.
4. **Finalization**: Flamey updates the original embed, notifies the user via DM, logs the event, and dispatches any configured economy rewards.