• CivicTrack is your neighborhood’s voice. Report civic issues like potholes, garbage, or water leaks with just a few taps. Track progress, stay updated, and join hands in building a cleaner, safer, and smarter community — one report at a time.

Team Members:

• Arman
• Gourav Kumar
• Prateek Sharma
• Mohd Asheer

• 🏷️ Report civic issues like potholes, garbage, water leaks, and more.
• 🖊️ Add a title, description, and up to 3–5 photos.
• 📂 Select a relevant category for better classification.

• 🌐 View issues reported only within a 3–5 km radius (via GPS or manual location).
• 🧭 Keeps user experience hyper-local and focused.

• 🔄 Track each issue through the lifecycle:
  Reported → In Progress → Resolved.
• 🔔 Receive real-time notifications on status changes.
• 🕒 View detailed status change logs with timestamps.

• 📌 See all nearby issues pinned on an interactive map.
• 🔎 Filter issues by:
  • ✅ Status: Reported, In Progress, Resolved
  • 🧹 Category: Roads, Lighting, Water, Cleanliness, etc.

• 🚩 Flag spam or irrelevant reports.
• 🙈 Reports flagged by multiple users are auto-hidden.
• 🛡️ Admins can review flags, approve or reject, and ban abusers.

• 👤 Users (anonymous or verified): Can report issues, track updates, and flag reports.
• 🧑‍💼 Admins: Manage flagged reports, access analytics, and moderate content.

• 🧮 Track total number of reports
• 🔥 Identify most reported issue categories
• 📈 Monitor flagged issues and user activity

📁 CivicTrack---OdooXMohali/
│
├── 📁 backend/
│    └── 📁 src/
│       ├── 📁 db/
│       │   └── index.js
│       ├── 📁 controllers/
│       │   ├── issues.controller.js
│       │   └── user.controller.js
│       ├── 📁 middlewares/
│       │   ├── auth.middleware.js
│       │   └── multer.middleware.js
│       ├── 📁 models/
│       │   ├── issues.models.js
│       │   └── user.models.js
│       ├── 📁 routes/
│       │   ├── issues.routes.js
│       │   ├── doctorRoute.js
│       │   └── user.routes.js'
│       ├── 📁 routes/
│       │   ├── ApiError.js
│       │   ├── ApiResponse.js
│       │   ├── asynHandler.js
│       │   └── cloudinary.js
│       ├── .env
│       ├── app.js
│       ├── constants.js
│       └── index.js
│
├── 📁 frontend/
│   ├── 📁 public/
│   │   └── favicon.svg
│   ├── 📁 src/
│   │   ├── 📁 assets/
│   │   ├── 📁 components/
│   │   │   ├── Auth.jsx
│   │   │   ├── Dashboard.jsx
│   │   │   ├── Handler.jsx
│   │   │   ├── IssueCard.jsx
│   │   │   ├── IssueDetail.jsx
│   │   │   ├── Profile.jsx
│   │   │   └── ReportForm.jsx
│   │   ├── 📁 utils/
│   │   │   └── APIRoutes.jsx
│   │   ├── App.jsx
│   │   ├── index.css
│   │   └── main.jsx
│   ├── .env
│   └── index.html
│   
└── README.md

• Node.js
• Express.js
• Mongo DB
• Cloudinary
• Multer
• JWT Authentication

• React.js
• Tailwind CSS
• React Router DOM
• Axios
• lucide-react
• react-toastify

Follow these steps to set up CivicTrack locally in your editor (VS Code or any IDE).

- Node.js (v16 or higher)  
- MongoDB (local or MongoDB Atlas)  
- Cloudinary account  
- Git  

git clone https://github.com/pratsha2005/CivicTrack---OdooXMohali.git
cd CivicTrack---OdooXMohali

cd backend
npm install

Create a .env file and add:

PORT = ""
MONGODB_URI= ""
CORS_ORIGIN = ""
CLOUDINARY_CLOUD_NAME=''
CLOUDINARY_API_KEY=''
CLOUDINARY_API_SECRET=''

Start the backend server:

npm run dev

cd ../frontend
npm install

Create a .env file and add:

VITE_BACKEND_URL = ""

Start the frontend:

npm run dev

Follow these steps to report and track civic issues in your area:

• 🔐 Sign up or log in to access the full functionality.
• 🙈 Anonymous users can still report issues (with limited tracking).

• 📝 Click on "Report Issue".
• 🏷️ Enter a title and short description.
• 🗂️ Select a category (e.g., Roads, Lighting, Water).
• 📸 Upload up to 3–5 photos for clarity.
• 📍 Use GPS or select your location manually.

• ⏳ View the issue’s current status:
  Reported → In Progress → Resolved.
• 🔔 Receive notifications whenever the status is updated.
• 🕓 Check status history and timestamps on the issue page.

• 🗺️ View nearby reported issues on the map.
• 🔎 Use filters:
  • Status (Reported, In Progress, Resolved)
  • Category
  • Distance (1 km, 3 km, 5 km)

• 🚩 If you see false or irrelevant reports, click "Flag as Spam".
• 🙅 Reports flagged multiple times are auto-hidden for review.

• 🛠️ Review and manage flagged issues.
• 👥 Ban misbehaving users if needed.
• 📊 View analytics dashboard to monitor city issues.

Below is the list of core API routes used in the CivicTrack application for user authentication, issue reporting, and location-based operations.

📌 More endpoints available in API documentation.

We welcome contributions to improve CivicTrack!

Click the Fork button on the top right of this page.

Open terminal and run:

git clone https://github.com/pratsha2005/CivicTrack---OdooXMohali.git
cd CivicTrack---OdooXMohali

Use a clear naming convention:

git checkout -b feature/new-feature

Write clean, documented code and commit:

git add .
git commit -m "✨ Added: your change description"

git push origin feature/your-feature-name