docs: add comprehensive testing and Discord bot setup guide

Co-authored-by: aider (openai/unsloth/Qwen3-Coder-Next) <aider@aider.chat>
This commit is contained in:
Your Name
2026-02-06 18:02:34 +01:00
parent 7016c3b3ec
commit 28f8676621
5 changed files with 130 additions and 0 deletions

53
TESTING_GUIDE.md Normal file
View File

@@ -0,0 +1,53 @@
# Testing Guide: Grocery Receipt Tracker
This guide will help you set up and test the Grocery Receipt Tracker with Discord integration.
## Prerequisites
- Python 3.8 or higher
- Discord account
- Basic understanding of command line operations
## Step 1: Create a Discord Bot
1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)
2. Click "New Application" and give it a name (e.g., "Grocery Receipt Tracker")
3. Navigate to the "Bot" section in the left sidebar
4. Click "Add Bot"
5. Under "Privileged Gateway Intents", enable:
- MESSAGE CONTENT INTENT
- SERVER MEMBERS INTENT
6. Click "Reset Token" and copy your bot token
7. Save the token securely (you'll need it for the application)
## Step 2: Add the Bot to Your Server
1. In the Developer Portal, go to "OAuth2" > "URL Generator"
2. Select these scopes:
- `bot`
- `applications.commands`
3. Under "Bot Permissions", select:
- `Send Messages`
- `Attach Files`
- `Read Message History`
4. Copy the generated URL and open it in your browser
5. Select the server where you want to add the bot
6. Click "Authorize"
## Step 3: Set Up the Project
1. Clone or download the project files
2. Create a virtual environment (recommended):
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
## Step 4: Configure Environment Variables
Create a `.env` file in the project root with your Discord bot token: