80 lines
2.1 KiB
Markdown
80 lines
2.1 KiB
Markdown
|
# Local Testing Guide
|
||
|
|
|
||
|
|
This guide helps you test the Email Alerts Application locally.
|
||
|
|
|
||
|
|
## 🚀 Quick Start
|
||
|
|
|
||
|
|
### Option 1: Use the automated script
|
||
|
|
```bash
|
||
|
|
./run_local.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
### Option 2: Manual setup
|
||
|
|
```bash
|
||
|
|
# Activate virtual environment
|
||
|
|
source venv/bin/activate
|
||
|
|
|
||
|
|
# Install dependencies
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
# Start the server
|
||
|
|
python run_server.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🌐 Access the Application
|
||
|
|
|
||
|
|
Once the server is running, you can access:
|
||
|
|
|
||
|
|
- **Dashboard**: http://localhost:5237/
|
||
|
|
- **Settings**: http://localhost:5237/settings
|
||
|
|
|
||
|
|
## 🧪 Testing the Connection
|
||
|
|
|
||
|
|
### Step 1: Configure Credentials
|
||
|
|
1. Go to http://localhost:5237/settings
|
||
|
|
2. Enter the Zoho credentials:
|
||
|
|
- **Email**: `projects@manaknightdigital.com`
|
||
|
|
- **Password**: `4o%!sbk$(3!>@#567!!`
|
||
|
|
3. Click "Save Settings"
|
||
|
|
|
||
|
|
### Step 2: Test Connection
|
||
|
|
1. Click "Test Connection" button
|
||
|
|
2. You should see: "Connection successful! Found X emails in the last 7 days."
|
||
|
|
|
||
|
|
## 🔧 Troubleshooting
|
||
|
|
|
||
|
|
### If you get "days_back" error:
|
||
|
|
- The server is running old code
|
||
|
|
- Restart the server: `Ctrl+C` then run `./run_local.sh` again
|
||
|
|
|
||
|
|
### If you get "ModuleNotFoundError":
|
||
|
|
- Make sure you're using the virtual environment: `source venv/bin/activate`
|
||
|
|
|
||
|
|
### If port 5237 is in use:
|
||
|
|
- The script will automatically kill existing processes
|
||
|
|
- Or manually: `pkill -f "python.*run_server.py"`
|
||
|
|
|
||
|
|
## 📋 Test Checklist
|
||
|
|
|
||
|
|
- [ ] Server starts without errors
|
||
|
|
- [ ] Web interface loads at http://localhost:5237/
|
||
|
|
- [ ] Settings page loads at http://localhost:5237/settings
|
||
|
|
- [ ] Can enter Zoho credentials
|
||
|
|
- [ ] "Test Connection" works without "days_back" error
|
||
|
|
- [ ] Connection shows "successful" message
|
||
|
|
|
||
|
|
## 🎯 Expected Results
|
||
|
|
|
||
|
|
✅ **Success**: "Connection successful! Found X emails in the last 7 days."
|
||
|
|
❌ **Old Error**: "Connection failed: ZohoClient.fetch_emails() got an unexpected keyword argument 'days_back'"
|
||
|
|
|
||
|
|
## 🛑 Stopping the Server
|
||
|
|
|
||
|
|
Press `Ctrl+C` in the terminal where the server is running.
|
||
|
|
|
||
|
|
## 📁 Files for Testing
|
||
|
|
|
||
|
|
- `run_local.sh` - Automated local startup script
|
||
|
|
- `test_local_connection.py` - Connection test script
|
||
|
|
- `zoho_client.py` - Fixed with days_back parameter
|
||
|
|
- `config.json` - Clean configuration (no hardcoded credentials)
|