# ✅ HVAC Blueprint Analyzer - Setup Checklist

**Your demo is ready!** Follow these steps to get it running.

---

## 🚀 STEP 1: Run the Server (Pick One)

### Option A: Double-Click (Easiest) ⭐
- [ ] Find `RUN.bat` in project folder
- [ ] Double-click it
- [ ] Wait for browser to open
- [ ] **DONE!**

### Option B: PowerShell
- [ ] Find `RUN.ps1` in project folder
- [ ] Right-click → "Run with PowerShell"
- [ ] Wait for browser to open
- [ ] **DONE!**

### Option C: Manual
```bash
cd C:\Users\ruchy\OneDrive\Documents\hvac_project
venv\Scripts\activate
pip install -r requirements.txt
python server.py
```
Then open: http://127.0.0.1:8000

---

## ✨ STEP 2: Test the Demo

Once server is running, you should see:

- [ ] Browser opened to http://127.0.0.1:8000
- [ ] Upload area visible (drag & drop box)
- [ ] "Analyze Blueprint" button
- [ ] Model selection (Gemini/OpenAI)
- [ ] Schedule mode toggle

### Try It:
- [ ] Drag any PDF into upload area (or click to browse)
- [ ] Click "Analyze Blueprint"
- [ ] Wait for results (~2 seconds)
- [ ] See 4 tabs appear: Summary, Floors & Units, Floor Plan, Downloads

---

## 📊 STEP 3: Check Results

### Summary Tab
- [ ] Shows: Total Floors (3), Total Units (8), Total Capacity, Time
- [ ] Shows: Model Used, Filename, Cost

### Floors & Units Tab
- [ ] Shows table with Floor, Unit ID, Type, Quantity, Capacity
- [ ] Data looks like:
  ```
  Floor | Unit_ID | Unit_Type | Qty | Capacity_BTU
  1     | AC-A    | Ceiling   | 1   | 36000
  ```

### Floor Plan Tab
- [ ] Shows canvas drawing with floors and units

### Downloads Tab
- [ ] Can download: Floors & Units CSV
- [ ] Can download: Equipment Schedule CSV
- [ ] Can download: Reconciliation CSV
- [ ] Can download: All as ZIP

---

## 📝 STEP 4: Verify CSV Files

After downloading, check files contain:

### hvac_floors_units.csv
```
Floor,Unit_ID,Unit_Type,Quantity,Capacity_BTU,Capacity_kW,Status,Location,Notes
1,AC-A,Ceiling Concealed Ducted,1,36000,10.5,Detected,Living area,
```

### hvac_equipment_schedule.csv
```
id,manufacturer,model,type,capacity_btu,voltage,phase,frequency_hz,quantity,floor,unit_tag
1,Carrier,25HNE024A03,Ceiling Cassette,24000,208-230V,1,60,1,1,AC-A
```

### hvac_reconciliation.csv
```
Issue_Type,Severity,Floor,Unit_ID,Details,Recommendation
(Empty or shows issues if any)
```

✅ All files populated correctly? **Demo is working!**

---

## 🔄 STEP 5: Next Phase (Optional)

### Connect Your Real Code
- [ ] Open `server.py`
- [ ] Find: `async def analyze_blueprint_async(...)`
- [ ] Replace mock return with your real analysis
- [ ] Restart server (`Ctrl+C` then `python server.py`)

### Test With Real PDF
- [ ] Upload actual blueprint PDF
- [ ] Verify results are correct
- [ ] Check CSV output

### Deploy to Cloud (5 minutes)
- [ ] See `RAILWAY_DEPLOYMENT_GUIDE.md`
- [ ] Get live URL
- [ ] Share with team

---

## 🛑 STEP 6: Stop the Server

When done testing:
- [ ] Press `Ctrl+C` in the terminal/PowerShell window
- [ ] Wait for "Shutdown complete" message
- [ ] Terminal closes (or you can close it)

---

## ❓ Troubleshooting

### Issue: Port 8000 already in use
**Fix**: 
```bash
# Find process
netstat -ano | findstr :8000

# Kill it
taskkill /PID <number> /F

# Or change port in .env
PORT=8001
```

### Issue: "Module not found"
**Fix**:
```bash
pip install -r requirements.txt --upgrade
```

### Issue: Virtual environment not activated
**Fix**:
```bash
venv\Scripts\activate
```

### Issue: Browser doesn't open automatically
**Fix**: Manually go to http://127.0.0.1:8000

### Issue: RUN.bat doesn't work
**Fix**: Use RUN.ps1 instead or follow manual steps

---

## 📋 File Guide

| File | Purpose |
|------|---------|
| `RUN.bat` | Double-click to run (Windows) |
| `RUN.ps1` | Right-click → Run with PowerShell |
| `server.py` | Main app (edit to add your code) |
| `HOW_TO_RUN.md` | Detailed setup instructions |
| `QUICK_START.md` | 5-minute quick guide |
| `START_HERE.md` | Quick reference guide |

---

## ✅ Final Checklist

- [ ] Server running (no errors)
- [ ] Browser opened to http://127.0.0.1:8000
- [ ] Upload form visible
- [ ] Can upload PDF
- [ ] Results display
- [ ] CSVs download
- [ ] All 3 CSV files contain data

**ALL CHECKED? YOUR DEMO IS LIVE!** 🎉

---

## 🎯 Success = All 3 Tabs Work

1. ✅ **Summary Tab** - Shows stats
2. ✅ **Floors & Units Tab** - Shows table
3. ✅ **Download Tab** - Can save CSVs

If all 3 work → You're ready for production!

---

## 📞 Need Help?

1. Check `HOW_TO_RUN.md` (Troubleshooting section)
2. Check `QUICK_START.md` (More details)
3. Check `START_HERE.md` (Complete guide)
4. Check `FASTAPI_HTML_CANVAS_1DAY_GUIDE.md` (Deep dive)

---

**You've got this! 🚀**

*Once working locally, you can deploy to Railway in 5 minutes.*
*See `RAILWAY_DEPLOYMENT_GUIDE.md` when ready.*