How abishagj/careconnect works
CareConnect connects the public and NGO teams through a React client and Express API: people discover organizations, contribute or request support, and follow their activity; NGO admins manage programs and incoming requests, while platform admins oversee NGOs. MongoDB-backed feature controllers handle the domain workflows, with shared authentication, uploads, email, and real-time notifications. The README documents several capabilities whose implementation was not sampled; those branches are represented at their listed page or controller paths, with documented relationships cited to the README.
Main entry points: helpRequestController.js Helpify requests · celebrationController.js Celebrations · NGOPortal.jsx NGO admin portal · server.js API routing
Components 27
User experience
- Web application
frontend/src/App.jsx - NGO discovery
frontend/src/hooks/useNGOs.js - NGO profile
frontend/src/pages/NGOProfile.jsx - My Activity
frontend/src/pages/ImpactDashboard.jsx
Community participation
- Helpify requests
backend/controllers/helpRequestController.js - Category matching
backend/utils/nlpMatch.js - Celebrations
backend/controllers/celebrationController.js - Donations
backend/controllers/donationController.js - Volunteering
backend/controllers/volunteerController.js - Events
backend/controllers/eventController.js - Internships
backend/controllers/internshipController.js - Community posts
backend/controllers/postController.js
NGO operations
- NGO admin portal
frontend/src/pages/NGOPortal.jsx - Program management
frontend/src/pages/EventsInternshipsManagement.jsx - Platform administration
backend/controllers/adminController.js
Platform services
- Authentication and roles
backend/middleware/auth.js - File storage
backend/utils/fileStorage.js - Notifications
backend/utils/notifications.js - API routing
backend/server.js - Socket.IO delivery
backend/utils/socket.js
Persistence and delivery
- MongoDB
backend/config/db.js - NGO records
backend/models/NGO.js - Help request records
backend/models/HelpRequest.js - Celebration records
backend/models/Celebration.js - User records
backend/models/User.js
Other components
- Users and admins
- Cloudinary
Connections 34
- Users and admins → Web application: use
- Web application → NGO discovery: offers search
- Users and admins → NGO discovery: find NGOs
- NGO discovery → NGO profile: explore
- NGO profile → Donations: donate
- NGO profile → Volunteering: volunteer
- Users and admins → Helpify requests: submit request
- Helpify requests → Category matching: classifies text
backend/controllers/helpRequestController.js - Helpify requests → Help request records: creates and updates
backend/controllers/helpRequestController.js - Users and admins → Celebrations: request celebration
- Celebrations → Celebration records: creates and updates
backend/controllers/celebrationController.js - Users and admins → Events: register
- Users and admins → Internships: apply
- Users and admins → Community posts: view updates
- Users and admins → Donations: donate
- NGO admin portal → Helpify requests: reviews requests
- NGO admin portal → Celebrations: reviews requests
- NGO admin portal → Program management: manage programs
- Program management → Events: manages
- Program management → Internships: manages
- NGO admin portal → Community posts: publishes updates
- Users and admins → Platform administration: administers platform
- API routing → NGO records: routes NGO requests
backend/server.js - API routing → Socket.IO delivery: initializes
backend/server.js - Authentication and roles → User records: loads user
backend/middleware/auth.js - Helpify requests → File storage: stores attachments
backend/controllers/helpRequestController.js - Celebrations → File storage: stores attachment
backend/controllers/celebrationController.js - File storage → Cloudinary: uploads when enabled
backend/utils/fileStorage.js - Helpify requests → Notifications: notifies participants
backend/controllers/helpRequestController.js - Celebrations → Notifications: notifies participants
backend/controllers/celebrationController.js - Notifications → Socket.IO delivery: pushes events
backend/utils/notifications.js - Celebrations → NGO records: reads NGO
backend/controllers/celebrationController.js - Helpify requests → NGO records: matches NGOs
backend/controllers/helpRequestController.js - API routing → MongoDB: connects
backend/server.js