Samuel-Njoroge/kijani-kinga

A Django Webapp # 🌳 Kijani Kinga Kijani Kinga is a **mobile-friendly Django web application** that empowers local residents, rangers, and administrators to report, track, and analyze incidents of illegal logging. The system supports geotagged reports with photos or audio evidence, sends alerts to authorities, and provides an interactive map and analytics dashboard for better decision making. **Web App Link** - Kijani Kinga API ## 🚀 Features - **Role-based access** - Residents, Rangers, and Admins have tailored permissions. - **Report submission** - Users can submit incidents with images, audio, and GPS coordinates. - **Report moderation** - Rangers/Admins can verify, approve, or close reports. - **Geolocation capture** - Location auto-captured via GPS or manual map input. - **Interactive map** - Incidents visualized on OpenStreetMap. - **Media handling** - Secure storage of images and audio with Cloudinary. - **Notifications** - SMS (Twilio) and Email (SendGrid) alerts for urgent reports. - **Analytics dashboard** - Track trends by location, time, and status. ## 🛠 Tech Stack - **Backend Framework:** Django + Django REST Framework - **Database:** PostgreSQL (+ PostGIS for spatial queries) - **Maps & Geocoding:** OpenStreetMap + Nominatim - **Media Storage:** Cloudinary - **Notifications:** Twilio (SMS), SendGrid (Email) - **Task Queue:** Celery + Redis - **Frontend Integration:** Leaflet.js for maps (future React/Next.js support) ## 📡 API Endpoints | Endpoint | Method | Description | |---------------------------------------|--------|-----------------------------------| | `/api/reports/` | GET, POST | Submit or list reports | | `/api/reports/ /verify/` | POST | Verify a report | | `/api/reports/ /close/` | POST | Close a report | | `/api/media/upload/` | POST | Upload media to Cloudinary | | `/api/geocoding …