How suyogshelke/civic-pulse works
Civic-Pulse is a civic-issue reporting and resolution platform with citizen, officer, and administrator portals. The main workflow runs from citizen complaint submission and department routing through officer assignment, status updates, resolution evidence, and citizen feedback; administrators also manage users and departments and review analytics. The frontend can use either the browser mock service or the Node API with MySQL. README capabilities supplement incomplete source excerpts, so links for unsampled frontend pages and API modules are shown only at the documented feature level.
Main entry points: App.jsx Route application · client.js HTTP client · service.js Mock API service · complaints.js Complaint API
Components 18
Frontend portals
- Route application
frontend/src/App.jsx - Session and access
frontend/src/auth/AuthContext.jsx
Complaint workflow
- Citizen portal
frontend/src/pages/citizen - Officer portal
frontend/src/pages/officer
Administration
- Admin oversight
frontend/src/pages/admin
API services
- Complaint API
frontend/src/api/complaints.js - Feedback API
frontend/src/api/feedback.js - Analytics API
frontend/src/api/analytics.js - User and department APIs
frontend/src/api/users.js - Authentication API
frontend/src/api/auth.js - HTTP client
frontend/src/api/client.js - Mock API service
frontend/src/api/mock/service.js - Node REST API
backend/server.js
Persistence
- Browser mock store
frontend/src/api/mock/db.js - MySQL database
Other components
- Citizen
- Officer
- Administrator
Connections 27
- Citizen → Route application: uses
- Officer → Route application: uses
- Administrator → Route application: uses
- Route application → Session and access: provides session
- Route application → Citizen portal: routes citizen
- Route application → Officer portal: routes officer
- Route application → Admin oversight: routes admin
- Session and access → Authentication API: authenticates
- Citizen portal → Complaint API: submits and tracks
- Citizen portal → Feedback API: rates resolution
- Officer portal → Complaint API: updates complaints
- Admin oversight → Complaint API: assigns complaints
- Admin oversight → Analytics API: requests reports
- Admin oversight → User and department APIs: manages directory
- Authentication API → HTTP client: sends requests
- Complaint API → HTTP client: sends requests
- Feedback API → HTTP client: sends requests
- Analytics API → HTTP client: sends requests
- User and department APIs → HTTP client: sends requests
- Authentication API → Mock API service: dispatches when enabled
- Complaint API → Mock API service: dispatches when enabled
- Feedback API → Mock API service: dispatches when enabled
- Analytics API → Mock API service: dispatches when enabled
- User and department APIs → Mock API service: dispatches when enabled
- HTTP client → Node REST API: HTTP requests
- Mock API service → Browser mock store: reads and writes
- Node REST API → MySQL database: queries and updates