How prateek-mohanty11/needsense works
NeedSense is a role-based community-issue and volunteer-coordination application. Citizens submit geolocated complaints; the data layer processes complaints into clusters and predictions, while administrators oversee reports, volunteers, assignments, and impact maps. Volunteers manage missions and track impact, with separate NGO collaboration and shared-volunteer-pool features. The sampled source shows browser-side IndexedDB persistence and context-driven workflows; the README is empty, so some feature connections are based only on source-index references.
Main entry points: data-context.tsx Application data · index.ts IndexedDB setup · page.tsx Submit complaint · collaboration.ts Collaboration records
Components 25
Access and reporting
- Sign-in and signup
app/(auth)/signin/page.tsx - Submit complaint
app/(citizen)/citizen/upload/page.tsx - Complaint reports
app/(citizen)/citizen/reports/page.tsx - Citizen dashboard
app/(citizen)/citizen/dashboard/page.tsx
Issue operations
- Complaint processing
lib/api/process.ts - Admin oversight
app/(admin)/admin/dashboard/page.tsx - Complaint management
app/(admin)/admin/complaints/page.tsx - Impact maps
app/(admin)/admin/impact-map/page.tsx
Volunteer response
- Volunteer management
app/(admin)/admin/volunteers/page.tsx - Team assignment
components/admin/MultiVolunteerAssignmentModal.tsx - Volunteer missions
app/(volunteer)/volunteer/missions/page.tsx - Volunteer impact
app/(volunteer)/volunteer/impact-dashboard/page.tsx
NGO collaboration
- Cross-NGO tasks
components/admin/collaboration/CrossNGOTasksTab.tsx - Collaboration records
lib/db/collaboration.ts - Shared volunteer pool
app/(volunteer)/volunteer/volunteer-pool/page.tsx
Application services
- Authentication
contexts/auth-context.tsx - Application data
contexts/data-context.tsx - Complaint records
lib/db/complaints.ts - User records
lib/db/users.ts - Mission records
lib/db/missions.ts - Notifications
lib/db/notifications.ts - Cluster records
lib/db/clusters.ts - IndexedDB setup
lib/db/index.ts - DIGIPIN location codes
lib/digipin/index.ts
Other components
- Citizen
Connections 26
- Citizen → Sign-in and signup: creates account
- Citizen → Submit complaint: reports issue
- Sign-in and signup → Authentication: authenticates
app/(auth)/signin/page.tsx - Authentication → User records: reads and updates
contexts/auth-context.tsx - Submit complaint → Application data: submits report
app/(citizen)/citizen/upload/page.tsx - Submit complaint → DIGIPIN location codes: encodes location
app/(citizen)/citizen/upload/page.tsx - Complaint reports → Application data: loads reports
app/(citizen)/citizen/reports/page.tsx - Citizen dashboard → Application data: loads overview
app/(citizen)/citizen/dashboard/page.tsx - Application data → Complaint records: reads and writes
contexts/data-context.tsx - Application data → Mission records: loads missions
contexts/data-context.tsx - Application data → Cluster records: loads clusters
contexts/data-context.tsx - Application data → Notifications: loads notifications
contexts/data-context.tsx - Application data → Complaint processing: processes reports
contexts/data-context.tsx - Complaint records → IndexedDB setup: uses database
lib/db/index.ts - User records → IndexedDB setup: uses database
lib/db/index.ts - Mission records → IndexedDB setup: uses database
lib/db/index.ts - Admin oversight → Application data: loads overview
app/(admin)/admin/dashboard/page.tsx - Complaint management → Application data: manages complaints
app/(admin)/admin/complaints/page.tsx - Complaint management → Team assignment: opens assignment
app/(admin)/admin/complaints/page.tsx - Impact maps → Application data: loads map data
app/(admin)/admin/impact-map/page.tsx - Volunteer management → Application data: loads volunteers
app/(admin)/admin/volunteers/page.tsx - Volunteer missions → Application data: manages missions
app/(volunteer)/volunteer/missions/page.tsx - Volunteer impact → Application data: loads impact
app/(volunteer)/volunteer/impact-dashboard/page.tsx - Cross-NGO tasks → Collaboration records: reads collaboration
components/admin/collaboration/CrossNGOTasksTab.tsx - Collaboration records → IndexedDB setup: uses database
lib/db/index.ts - Shared volunteer pool → Collaboration records: uses pool data