How rithik-dev31/civicpulse_ai works
CivicPulse AI is a Django civic-complaint portal. Citizens submit location-tagged reports with optional photos; the application checks photos, classifies the issue, and looks for nearby text-similar reports before creating or linking a report. Department staff manage complaint status and history, while staff-facing administration supports account and complaint management. The excerpts substantiate the intake and department workflow; README is empty, and unsampled admin and analytics behavior is represented only where the tree supports it. The configured database and deployment details were not inspected.
Main entry points: complaints/views.py Portal workflows · department/views.py Staff workflow · models.py Complaint records · forms.py Report form
Components 16
Citizen intake
- Portal workflows
complaints/views.py - Report form
complaints/forms.py
Report analysis
- Issue classifier
complaints/classifier.py - Photo verification
complaints/image_verification.py - Duplicate matching
complaints/duplicate_detection.py - Priority scoring
complaints/priority.py
Complaint records
- Complaint records
complaints/models.py - Citizen reports
complaints/models.py - Department staff
department/models.py
Department operations
- Staff workflow
department/views.py - Status history
department/models.py
Administration
- Staff administration
complaints/views.py - Complaint oversight
templates/admin/complaints.html - Analytics dashboard
templates/admin/analytics.html
Other components
- Citizen
- Department staff
Connections 17
- Citizen → Portal workflows: submits reports
complaints/views.py - Portal workflows → Report form: validates with
complaints/views.py - Portal workflows → Photo verification: verifies photos
complaints/views.py - Portal workflows → Duplicate matching: checks duplicates
complaints/views.py - Portal workflows → Issue classifier: classifies issue
complaints/views.py - Portal workflows → Priority scoring: sets priority
complaints/views.py - Portal workflows → Complaint records: creates or updates
complaints/views.py - Portal workflows → Citizen reports: links reporter
complaints/views.py - Duplicate matching → Photo verification: uses text similarity
complaints/duplicate_detection.py - Issue classifier → Complaint records: uses categories
complaints/classifier.py - Report form → Department staff: uses department choices
complaints/forms.py - Department staff → Staff workflow: updates complaints
department/views.py - Staff workflow → Complaint records: reads and updates
department/views.py - Staff workflow → Priority scoring: uses priority logic
department/views.py - Staff workflow → Status history: records status changes
department/views.py - Status history → Complaint records: references complaint
department/models.py - Staff administration → Department staff: creates staff accounts