changes made

Author: Pawan-git05

MAP_SETUP.md

@@ -0,0 +1,103 @@
+# ResQTrack - Map Integration Setup
+
+## OpenStreetMap + Leaflet.js Integration
+
+The ResQTrack application now uses OpenStreetMap with Leaflet.js for enhanced map functionality. This implementation is completely free and requires no API keys.
+
+### 1. Features Added
+
+#### Map Improvements
+- **OpenStreetMap Integration**: Uses free OpenStreetMap tiles with Leaflet.js
+- **No API Key Required**: Completely free to use with no billing concerns
+- **Enhanced Geocoding**: Uses Nominatim API for accurate location resolution
+- **Custom Markers**: Hospital and police station markers with custom icons
+- **Interactive Popups**: Click on markers to see detailed information
+- **Location Picker**: Interactive map for selecting precise locations
+
+#### Data Management Features
+- **CSV File Management**: View and delete uploaded CSV files
+- **Bulk Data Clearing**: Clear all data for specific service types (hospitals, police stations, etc.)
+- **Individual Entry Deletion**: Delete specific entries from emergency services
+- **File Upload Tracking**: Monitor uploaded files with size and modification date
+
+### 2. New API Endpoints
+
+The following new endpoints have been added to the backend:
+
+- `GET /data/uploaded-files` - List uploaded CSV files
+- `DELETE /data/delete-file` - Delete a specific CSV file
+- `DELETE /data/clear-data/<service_type>` - Clear all data for a service type
+- `DELETE /data/delete-entry/<service_type>/<entry_id>` - Delete a specific entry
+
+### 3. Usage
+
+#### Location Picker (`location-picker.html`)
+- Search for locations using Nominatim geocoding
+- Use device location with geolocation API
+- Click on map to select precise coordinates
+- Copy coordinates or send to backend
+- Mobile-friendly responsive design
+
+#### Hospitals Page
+- Switch between List View and Map View
+- Click on map markers to see hospital details
+- Hospitals are geocoded automatically from their location field
+
+#### Admin Dashboard
+- View all emergency services on interactive maps
+- Add new locations using the location picker map
+- Manage uploaded CSV files
+- Clear data or delete individual entries
+
+#### Data Dashboard
+- Import CSV files for different service types
+- View uploaded files and delete them
+- Clear all data for specific service types
+- Delete individual emergency service entries
+
+### 4. Technical Implementation
+
+#### Libraries Used
+- **Leaflet.js**: Open-source JavaScript library for interactive maps
+- **OpenStreetMap**: Free, open-source map data
+- **Nominatim**: Free geocoding service for OpenStreetMap
+
+#### Configuration
+The map settings are configured in `frontend/config.js`:
+```javascript
+const CONFIG = {
+    MAP_DEFAULT_CENTER: { lat: 20.5937, lng: 78.9629 }, // India center
+    MAP_DEFAULT_ZOOM: 5,
+    MAP_MAX_ZOOM: 19,
+    MAP_TILE_LAYER: 'https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
+    NOMINATIM_BASE_URL: 'https://nominatim.openstreetmap.org',
+    NOMINATIM_SEARCH_LIMIT: 5,
+    NOMINATIM_COUNTRY_CODES: 'in'
+};
+```
+
+### 5. Mobile-Friendly Features
+
+- Responsive design that works on all screen sizes
+- Touch-friendly map interactions
+- Optimized marker sizes for mobile devices
+- Geolocation support for mobile browsers
+- Search functionality with autocomplete
+
+### 6. Advantages Over Google Maps
+
+- **No API Key Required**: No need to register or manage API keys
+- **No Billing**: Completely free with no usage limits
+- **Open Source**: Full control over the implementation
+- **Privacy**: No data sent to Google
+- **Customizable**: Easy to customize markers, popups, and styling
+
+### 7. Troubleshooting
+
+If maps don't load:
+1. Check browser console for error messages
+2. Ensure internet connection is available
+3. Verify that Leaflet.js is loading correctly
+4. Check that OpenStreetMap tiles are accessible
+
+For more information, visit the [Leaflet.js documentation](https://leafletjs.com/) and [OpenStreetMap](https://www.openstreetmap.org/).

README.md

@@ -10,6 +10,8 @@ The project is intentionally simple to run locally (no heavy frontend tooling) b
 - Hospital directory helps route animals to the right care.
 - Donors can record donations with automatic email receipts (if SMTP configured).
 - Admin/NGO actions use JWT for protected routes.
+- **NEW**: Comprehensive data integration system for emergency services (police, fire, blood banks, etc.)
+- **NEW**: Interactive data dashboard for importing, visualizing, and managing multiple datasets.
 
 ## Tech Stack
 - **Backend**: Flask, SQLAlchemy, Alembic (Flask‑Migrate), JWT, Flask‑Mail, Flask‑CORS, SQLite (default) or any SQL via `DATABASE_URL`.
@@ -49,6 +51,11 @@ python -m flask db upgrade
 
 Optional: load sample data (inspect `docs/sql/sample_data.sql`).
 
+**NEW**: Import comprehensive emergency services data:
+```bash
+python import_sample_data.py
+```
+
 ### 4) Run the backend (API)
 ```bash
 python backend/wsgi.py
@@ -63,6 +70,12 @@ python -m http.server 8000
 ```
 Visit `http://localhost:8000/index.html`.
 
+**NEW**: Access the Data Dashboard at `http://localhost:8000/data-dashboard.html` for:
+- Import/export CSV datasets
+- Visualize emergency services distribution
+- Manage NGOs, volunteers, hospitals, police stations, blood banks, fire stations
+- View real-time statistics and analytics
+
 Front‑to‑back integration is configured via `frontend/assets/js/api.js`:
 ```js
 const API_BASE = 'http://localhost:5000';
@@ -113,6 +126,14 @@ Base URL: `http://localhost:5000`
 - `POST /uploads` (multipart, field `file`) → `201 { filename, url }`
 - `GET /uploads/<filename>` → serves the uploaded file
 
+### Data Integration (NEW)
+- `POST /data/import/<type>` (JWT required) → `201 { message, stats }`
+  - types: `ngos`, `volunteers`, `hospitals`, `police-stations`, `blood-banks`, `fire-stations`
+- `GET /data/export/<type>` (JWT required) → `200 { message, download_url }`
+- `GET /data/statistics` (JWT required) → `200 { statistics, location_distribution }`
+- `GET /data/emergency-contacts` → `200 { contacts: [...] }`
+- `GET /data/nearby-services?location=<city>&service_type=<type>` → `200 { services: [...] }`
+
 ### Common Errors
 - `400` Missing/invalid fields
 - `401` Invalid credentials or missing token
@@ -121,6 +142,7 @@ Base URL: `http://localhost:5000`
 ## Data model (high‑level)
 - `AnimalCase` with `case_code`, contact/location, type, urgency, notes, optional `media_url`, and `status`.
 - `NGO`, `Volunteer`, `Hospital`, `Donation` entities with essential fields.
+- **NEW**: `PoliceStation`, `BloodBank`, `FireStation`, `EmergencyContact` for comprehensive emergency services.
 - See `docs/architecture/ERD.md` and `backend/app/models.py` for complete definitions.
 
 ## Configuration & Operations
@@ -138,16 +160,22 @@ backend/
     extensions.py
     utils.py
     mailer.py
+    data_integration.py  # NEW: Data import/export system
   config.py
   wsgi.py
 frontend/
-  index.html report.html register.html donate.html hospitals.html
+  index.html report.html register.html donate.html hospitals.html data-dashboard.html  # NEW
   assets/css/styles.css
-  assets/js/api.js app.js
+  assets/js/api.js app.js data-dashboard.js  # NEW
 docs/
   PRD.md
   architecture/ERD.md, DFD.md
   sql/schema.sql, sample_data.sql
+  DATA_INTEGRATION.md  # NEW: Comprehensive data integration guide
+  DATA_INTEGRATION_QUICK_REFERENCE.md  # NEW: Quick reference
+sample_data/  # NEW: Sample CSV files
+  ngos.csv volunteers.csv hospitals.csv police_stations.csv blood_banks.csv fire_stations.csv
+import_sample_data.py  # NEW: Data import script
 ```
 
 ## Contributing

backend/app/__init__.py

@@ -10,6 +10,7 @@
 from .routes.donations import donations_bp
 from .routes.uploads import uploads_bp
 from .routes.admin import admin_bp
+from .routes.data import data_bp
 
 
 def create_app(config_class: type = Config) -> Flask:
@@ -38,5 +39,6 @@ def create_app(config_class: type = Config) -> Flask:
 	app.register_blueprint(donations_bp)
 	app.register_blueprint(uploads_bp)
 	app.register_blueprint(admin_bp)
+	app.register_blueprint(data_bp)
 
 	return app