Enhance README and backend functionality for dashboard access and image upload validation
- Added a new section in README detailing the dashboard access method, features, and troubleshooting tips. - Updated backend server startup message to allow access from mobile/emulator. - Refactored image upload handling in the report route to validate file types and extensions, ensuring only supported image formats are accepted. - Adjusted upload directory path for consistency.
This commit is contained in:
32
README.md
32
README.md
@@ -96,6 +96,37 @@ uvicorn main:app --reload
|
||||
flutter run
|
||||
```
|
||||
|
||||
### Method E: Dashboard Access (Web Interface)
|
||||
```bash
|
||||
# Terminal 1 - Start Backend Server
|
||||
cd backend
|
||||
python main.py
|
||||
# OR (if port conflicts occur):
|
||||
uvicorn main:app --host 127.0.0.1 --port 8000 --reload
|
||||
|
||||
# Terminal 2 - Start Dashboard Server
|
||||
cd dashboard
|
||||
python -m http.server 3000
|
||||
|
||||
# Open browser and navigate to:
|
||||
# http://localhost:3000
|
||||
```
|
||||
|
||||
**Dashboard Features:**
|
||||
- 🗺️ Interactive map with report visualization
|
||||
- 🔍 Advanced filtering by category, severity, status, and date
|
||||
- 📊 Real-time statistics and analytics
|
||||
- 🌡️ Heatmap toggle for density visualization
|
||||
- 🔄 Status management (submitted → in_progress → fixed)
|
||||
- 📱 Responsive design for desktop and mobile
|
||||
- 🌍 Bilingual support (English/Bahasa Malaysia)
|
||||
|
||||
**Troubleshooting Dashboard:**
|
||||
- **Port 8000 in use?** Try: `uvicorn main:app --host 127.0.0.1 --port 8080 --reload` (then update dashboard to use port 8080)
|
||||
- **Port 3000 in use?** Try: `python -m http.server 3001`
|
||||
- **Backend connection fails?** Dashboard will automatically use demo data
|
||||
- **CORS issues?** Ensure backend allows requests from `http://localhost:3000`
|
||||
|
||||
## 📱 API Endpoints
|
||||
|
||||
The Flutter app communicates with these backend endpoints:
|
||||
@@ -249,6 +280,7 @@ flutter config --enable-web
|
||||
- Ensure backend server is running on port 8000
|
||||
- Check firewall settings
|
||||
- Verify API base URL in `lib/services/api_service.dart`
|
||||
- For dashboard: Check browser console for CORS errors
|
||||
|
||||
**Camera/Geolocation not working:**
|
||||
- Grant permissions in device settings
|
||||
|
||||
Reference in New Issue
Block a user