Unified Citizen Grievance Prediction System Final Year Project with Source Code

• Admin login and logout in this final year project
• Admin dashboard with total complaints, pending complaints, in-progress complaints, resolved complaints, rejected complaints, citizens, and high-risk areas
• Recent complaints table with citizen names
• Category distribution progress bars
• Quick actions for pending queue, add complaint, ML predictions, reports, and model training
• Department CRUD management
• Add department with name, description, head name, contact email, phone, and active status
• Edit department details
• Delete department records
• Category CRUD management
• Add complaint category
• Edit category details
• Manage category icon and active status
• Delete category records
• Area CRUD management
• Add area
• Edit area details
• Delete area records
• Ward CRUD management
• Add ward with ward number and linked area
• Edit ward details
• Delete ward records
• Complaint type CRUD management
• Add complaint type linked to category
• Edit complaint type
• Delete complaint type
• Citizen management
• Add citizen account
• Edit citizen profile
• Delete citizen account
• Manage citizen active status
• Complaint management
• View all complaints
• View pending complaints
• View in-progress complaints
• View resolved complaints
• View rejected complaints
• View repeated complaints
• Add complaint manually for any citizen
• Edit complaint details
• View full complaint details
• Delete invalid complaints
• Verify complaint authenticity
• Assign complaint to department
• Update complaint status
• Add admin remarks
• View complaint history and audit trail
• Manage category-wise complaint views
• Manage complaint priority: Low, Medium, High, Emergency
• Manage complaint image and document uploads
• ML prediction management
• View prediction results
• View high-risk areas
• View confidence scores
• Train Random Forest model
• Generate ward-wise area forecast
• Training data management
• Add historical issue records
• View training data records
• Clean duplicate training records
• Reports management
• Generate area-wise reports
• Generate ward-wise reports
• Generate department-wise reports
• Generate category-wise reports
• Generate monthly reports
• Generate resolved complaint reports
• Generate pending complaint reports
• View reports in browser
• Print reports
• Download PDF reports
• Notification management
• View notification logs
• Send notification to individual citizen
• Broadcast notification to all citizens
• Feedback management
• View citizen ratings and comments
• FAQ CRUD management
• Site content management
• Edit landing banner
• Edit About page content
• Edit Contact page content
• Backup and restore SQLite database
• Admin profile update
• Admin password change

• Citizen registration in this final year project
• Citizen login and logout
• Forgot password demo recovery
• Citizen dashboard with complaint statistics
• View total complaints
• View pending complaints
• View in-progress complaints
• View resolved complaints
• View rejected complaints
• View recent complaints
• Quick complaint shortcuts by category
• View unread notifications
• View area risk alerts from ML prediction
• Submit general complaint
• Submit category-specific complaint
• Submit water leakage complaint
• Submit electricity fault complaint
• Submit road damage complaint
• Submit drainage complaint
• Submit garbage complaint
• Submit street light complaint
• Add complaint title and description
• Select category and complaint type
• Select priority
• Select area and ward
• Add location and coordinates
• Upload complaint image
• View all submitted complaints
• Search complaints by reference number or title
• Filter complaints by status
• Filter complaints by category
• View complaint status and verification badge
• View complaint details
• View assigned department
• View admin remarks
• View complaint activity timeline
• View evidence photo
• Edit complaint before verification
• Cancel complaint before verification
• Download or print complaint receipt
• View notifications
• Auto-mark notifications as read
• Open related complaint from notification
• View AI-predicted civic issues by area
• View high-risk zones and confidence scores
• Use area selector for detailed forecasts
• Update full name, email, phone, and address
• Change password
• Submit feedback for resolved complaints
• Rate service from 1 to 5 stars
• Submit improvement suggestions
• View searchable FAQ
• Access helpline and help links

• Complete citizen grievance prediction system source code
• Suitable for final year project, major project, and minor project
• Project report content can be prepared from included modules
• Public Website, Citizen Portal, and Admin Console included
• Complaint lifecycle management
• Complaint status flow: Submitted → Verified → Assigned → Resolved / Rejected
• Category-specific complaint submission
• Civic categories: water, electricity, road, drainage, garbage, street light, public safety
• Complaint image and document upload support
• Notification system
• Feedback and rating system
• Backup and restore system
• SQLite database
• Flask-SQLAlchemy ORM
• Flask-Login authentication
• Flask-WTF form validation
• Werkzeug password hashing
• PDF generation using ReportLab
• Bootstrap 5 frontend
• Font Awesome icons
• Seed data included
• API endpoints for dynamic wards and complaint types
• Useful for viva, source code review, project report writing, and project demonstration

How to run this code?

1. Open project folder:

   cd "Unified Citizen Grievance Prediction System"

2. Create virtual environment:

   python -m venv venv

3. Activate virtual environment on Windows:

   venv\Scripts\activate

4. Activate virtual environment on Linux/macOS:

   source venv/bin/activate

5. Install dependencies:

   pip install -r requirements.txt

6. Seed database with demo data:

   python seed.py

7. Start application:

   python app.py

8. Alternative run command:

   python run.py

9. Open public landing page:

   http://localhost:5000

10. Open citizen login:

http://localhost:5000/login

11. Open citizen portal:

http://localhost:5000/user/dashboard

12. Open admin console:

http://localhost:5000/admin/dashboard

Admin Account

• Username: admin
• Password: admin123
• Email: [email protected]
• Access: Full admin console

Demo Citizen Accounts
All demo citizens use password:

password123

Demo users:

• Username: john_doe