# VEO3 Report - Quick Start Guide

## Deploy to Server in 3 Steps

### Step 1: Prepare Files
```bash
# On your local machine, ensure .env is configured
cp .env.example .env
nano .env  # Add your SMTP credentials
```

### Step 2: Upload to Server
```bash
scp veo3_report.py veo3_scheduler.py requirements.txt .env \
    veo3-report.service deploy.sh \
    user@your-server.com:/tmp/veo3-deploy/
```

### Step 3: Deploy
```bash
# SSH into server
ssh user@your-server.com

# Run deployment
cd /tmp/veo3-deploy
chmod +x deploy.sh
sudo ./deploy.sh
```

**Done!** The service is now running and will send reports daily at 7:00 PM EST.

---

## Common Commands

```bash
# Check if service is running
sudo systemctl status veo3-report

# View live logs
sudo journalctl -u veo3-report -f

# Restart service
sudo systemctl restart veo3-report

# Test immediately (without waiting for 7pm)
sudo systemctl stop veo3-report
cd /var/www/veo3-report
sudo -u www-data ./venv/bin/python veo3_report.py
sudo systemctl start veo3-report
```

---

## Configuration Files

| File | Location | Purpose |
|------|----------|---------|
| `.env` | `/var/www/veo3-report/.env` | SMTP credentials & recipients |
| `veo3_scheduler.py` | `/var/www/veo3-report/` | Schedule time & timezone |
| `veo3_report.py` | `/var/www/veo3-report/` | Cost per video setting |

---

## Changing Settings

### Change Email Recipients
```bash
sudo nano /var/www/veo3-report/.env
# Edit REPORT_RECIPIENTS line
sudo systemctl restart veo3-report
```

### Change Schedule Time
```bash
sudo nano /var/www/veo3-report/veo3_scheduler.py
# Find: CronTrigger(hour=19, minute=0, ...)
# Change hour (24-hour format: 19 = 7pm)
sudo systemctl restart veo3-report
```

### Change Cost Per Video
```bash
sudo nano /var/www/veo3-report/veo3_report.py
# Find: COST_PER_VIDEO = 3.20
# Change value
sudo systemctl restart veo3-report
```

---

## Troubleshooting

**Service won't start?**
```bash
sudo journalctl -u veo3-report -n 50
```

**Emails not sending?**
```bash
# Test manually
cd /var/www/veo3-report
sudo -u www-data ./venv/bin/python veo3_report.py
# Check output for SMTP errors
```

**Wrong time?**
```bash
# Service uses EST timezone explicitly in code
# Check: sudo journalctl -u veo3-report | grep "Next scheduled run"
```

---

For detailed information, see [DEPLOYMENT.md](DEPLOYMENT.md)