LAUNCH_APP.md

🚀 Launch Fullstack App - Quick Guide

✅ Servers Launched!

Both servers have been started in separate PowerShell windows.

---

📡 Server URLs

Backend API

• URL: http://localhost:8000
• API Docs: http://localhost:8000/docs
• Towers Endpoint: http://localhost:8000/api/v1/towers
• Stats Endpoint: http://localhost:8000/api/v1/towers/stats/summary

Frontend App

• URL: http://localhost:3003
• Towers Page: http://localhost:3003/features/towers

---

🧪 Quick Testing

1. Test Backend API

Open browser and visit:

http://localhost:8000/api/v1/towers?limit=5

Should return JSON with tower data.

2. Test Frontend

Open browser and visit:

http://localhost:3003/features/towers

Should show:

• Map with markers
• Sidebar with filters
• Stats cards
• No console errors

3. Run Automated Tests

python scripts/test_towers_api.py

---

🐛 Troubleshooting

If Backend Won't Start:

1. Check backend PowerShell window for errors
2. Verify Python dependencies: pip install fastapi uvicorn pandas
3. Check if port 8000 is available
4. Try manual start:

   cd backend
   uvicorn app.main:app --reload --port 8000

If Frontend Won't Start:

1. Check frontend PowerShell window for errors
2. Verify dependencies: cd frontend && npm install
3. Check if port 3003 is available
4. Try manual start:

   cd frontend
   npm run dev

---

✅ What to Test

1. Page Loads - No errors in console
2. Map Displays - Markers appear on map
3. Filters Work - Status, priority, zone filters
4. Search Works - Search by ID, zone, state
5. Export Works - CSV, JSON, PDF buttons
6. Sorting Works - Sort dropdown functions
7. Mobile Works - Responsive layout
8. Clustering Works - Markers cluster when zoomed out

---

Servers are running! Open the URLs above to test.