# CivicPulse
**A Crowdsourced Civic Issue Reporting and Resolution Tracking Platform**
> Bridging citizens and government �� report local problems, track resolution, make your city better.
---
## What is CivicPulse?
CivicPulse is a web platform where citizens can report local infrastructure problems like broken roads, water logging, overflowing garbage, and non-functional streetlights — using just their phone. Every issue is tracked publicly on an interactive map with full transparency from report to resolution.
---
## Key Features
- Issue Reporting — Take a photo, auto-detect GPS location, select category, submit in 30 seconds
- Interactive Map — Leaflet.js map with color-coded markers showing all issues by status
- Status Tracking — Track issues through 4 stages: Reported, Acknowledged, In Progress, Resolved
- Community Upvoting — Citizens upvote issues they face, pushing critical problems to the top
- Analytics Dashboard — Charts showing issue categories, monthly trends, and resolution rates
- Admin Panel — Government officials manage all issues, update statuses, view analytics
- Authentication — Secure user registration and login system
- Responsive Design — Works seamlessly on mobile, tablet, and desktop
- AI Auto-Categorization — AI automatically categorizes reported issues based on description
- Trending Algorithm — AI detects trending issues based on upvote velocity
---
## Tech Stack
| Layer | Technology |
|---|---|
| Frontend | HTML5, CSS3, JavaScript (ES6+), Tailwind CSS |
| Backend | Django 6.0 (Python 3.14) |
| Database | PostgreSQL (Production) / SQLite (Development) |
| Maps | Leaflet.js with OpenStreetMap |
| Charts | Chart.js |
| Icons | Font Awesome 6.5 |
| Cloud Storage | Cloudinary (Image Uploads) |
| Version Control | Git and GitHub |
---
## Project Structure
```
CivicPulse/
├── civicpulse/ # Django project settings
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── issues/ # Main app
│ ├── model …