How sanjayramkumarm-ai/voluntess works
Voluntess is a volunteer-management platform for volunteers, NGOs, and administrators. Its principal workflow is discovering an opportunity, applying, and having an NGO review the application; participation then supports attendance tracking, completion verification, and certificate issuance. The tree and route declarations show additional authentication, messaging, teams, quests, reviews, and NGO administration. The source excerpts establish several controller-to-model relationships, but client API wiring and unsampled controller internals are not shown, so those links are omitted or marked unverified.
Main entry points: index.ts API route dispatch · application.ts Applications and decisions · attendance.ts Attendance and check-in · certificates.ts Completions and certificates
Components 27
Web experience
- Opportunity discovery
client/src/app/explore/page.tsx - Opportunity details
client/src/app/opportunities/[id]/page.tsx - NGO workspace
client/src/app/ngo/page.tsx - Sign-in and registration
client/src/app/login/page.tsx - Attendance and check-in
client/src/app/attendance/page.tsx - Completion review
client/src/components/certificates/CompletionReviewTable.tsx - Community features
client/src/app/teams/page.tsx
Identity and discovery
- Authentication endpoints
server/src/controllers/authOtp.ts - Opportunity management
server/src/controllers/opportunity.ts
Volunteer participation
- Applications and decisions
server/src/controllers/application.ts - Attendance and check-in
server/src/controllers/attendance.ts
Recognition and community
- Completions and certificates
server/src/controllers/certificates.ts - Certificate PDF service
server/src/services/certificatePdf.ts - Reviews
server/src/controllers/review.ts - Messaging
server/src/controllers/messages.ts - Teams
server/src/controllers/team.ts - Quests and rewards
server/src/controllers/quest.ts
API and persistence
- User records
server/src/models/User.ts - Opportunity records
server/src/models/Opportunity.ts - Application records
server/src/models/Application.ts - Completion records
server/src/models/Completion.ts - Certificate records
server/src/models/Certificate.ts - Review records
server/src/models/Review.ts - Notifications
server/src/models/Notification.ts - API route dispatch
server/src/routes/index.ts - HTTP server
server/src/server.ts
Other components
- Platform users
Connections 37
- Platform users → Opportunity discovery: browses
- Platform users → Sign-in and registration: signs in
- HTTP server → API route dispatch: mounts API
server/src/server.ts - API route dispatch → Authentication endpoints: routes auth
server/src/routes/index.ts - API route dispatch → Opportunity management: routes opportunities
server/src/routes/index.ts - API route dispatch → Applications and decisions: routes applications
server/src/routes/index.ts - API route dispatch → Attendance and check-in: routes attendance
server/src/routes/index.ts - API route dispatch → Completions and certificates: routes certificates
server/src/routes/index.ts - API route dispatch → Reviews: routes reviews
server/src/routes/index.ts - API route dispatch → Messaging: routes messages
server/src/routes/index.ts - API route dispatch → Teams: routes teams
server/src/routes/index.ts - API route dispatch → Quests and rewards: routes quests
server/src/routes/index.ts - Authentication endpoints → User records: reads and writes
server/src/controllers/authOtp.ts - Authentication endpoints → Authentication endpoints: uses OTP service
server/src/controllers/authOtp.ts - Opportunity management → Opportunity records: manages
- Applications and decisions → Application records: reads and writes
server/src/controllers/application.ts - Applications and decisions → Opportunity records: checks capacity
server/src/controllers/application.ts - Applications and decisions → Notifications: creates alerts
server/src/controllers/application.ts - Applications and decisions → Quests and rewards: records quest event
server/src/controllers/application.ts - Attendance and check-in → Application records: checks participation
server/src/controllers/attendance.ts - Attendance and check-in → Completion records: records completion
server/src/controllers/attendance.ts - Attendance and check-in → Certificate records: uses certificates
server/src/controllers/attendance.ts - Attendance and check-in → Notifications: creates alerts
server/src/controllers/attendance.ts - Completions and certificates → Completion records: manages completions
server/src/controllers/certificates.ts - Completions and certificates → Certificate records: issues certificates
server/src/controllers/certificates.ts - Completions and certificates → Certificate PDF service: generates PDF
server/src/controllers/certificates.ts - Completions and certificates → Notifications: creates alerts
server/src/controllers/certificates.ts - Reviews → Review records: creates and reads
server/src/controllers/review.ts - Reviews → Application records: checks eligibility
server/src/controllers/review.ts - Reviews → Notifications: creates alerts
server/src/controllers/review.ts - Messaging → Notifications: creates alerts
server/src/controllers/messages.ts - Opportunity discovery → Opportunity management: loads listings
- Opportunity details → Applications and decisions: submits application
- NGO workspace → Applications and decisions: reviews applications
- Attendance and check-in → Attendance and check-in: records attendance
- Completion review → Completions and certificates: reviews completion
client/src/components/certificates/CompletionReviewTable.tsx - Community features → Teams: uses team features