suivi-courses/TESTING_GUIDE.md

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
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):

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

Step 4: Configure Environment Variables

Create a .env file in the project root with your Discord bot token: