How gautham2117/jnn-campus-connect works
CampusConnect is a college community portal delivered through web and Android clients, backed by an Express/MongoDB API. The main user journey is to sign in, discover campus information and people, then participate in clubs, events, discussions, and other campus services; staff administer and analyze activity. The README documents additional attendance, gate-pass, safety, study-assistant, and alumni capabilities. Some backend feature wiring is unsampled, so the graph retains documented subsystems while limiting implementation-level links to relationships supported by excerpts or the README.
Main entry points: App.jsx Web application · models MongoDB records · notify.js Notifications · chatController.js Chat
Components 27
User clients
- Web application
client/src/App.jsx - Android application
mobile/src/app - Web API client
client/src/services/api.js - Mobile API client
mobile/src/services/api.js
Campus community
- Profiles and directory
server/src/controllers/userController.js - Announcements
server/src/controllers/announcementController.js - Clubs
server/src/controllers/clubController.js - Events
server/src/controllers/eventController.js - Discussions
server/src/controllers/discussionController.js - Global search
server/src/controllers/searchController.js - Alumni and mentorship
server/src/controllers/alumniController.js
Campus services
- Chat
server/src/controllers/chatController.js - Attendance
server/src/controllers/attendanceController.js - Gate passes
server/src/controllers/gatePassController.js - Complaints and grievances
server/src/controllers/complaintController.js - SOS alerts
server/src/controllers/sosController.js - Study assistant
server/src/services/ai/studyAssistantService.js - Study materials
server/src/controllers/studyMaterialController.js
Administration
- Analytics and activity
server/src/controllers/analyticsController.js - Administration and moderation
server/src/controllers/adminController.js
API and data
- Authentication
server/src/controllers/authController.js - Notifications
server/src/utils/notify.js - Realtime transport
server/src/config/socket.js - File uploads
server/src/utils/storage.js - Express API
server/src/app.js - MongoDB records
server/src/models
Other components
- Campus users
Connections 34
- Campus users → Web application: uses
README.md - Campus users → Android application: uses
README.md - Web application → Web API client: requests data
client/src/App.jsx - Web application → Authentication: signs in
README.md - Web application → Announcements: browses
README.md - Web application → Clubs: joins
README.md - Web application → Events: discovers
README.md - Web application → Discussions: participates
README.md - Web application → Profiles and directory: views
README.md - Web application → Global search: searches
README.md - Web application → Chat: chats
README.md - Web application → Attendance: records attendance
README.md - Web application → Gate passes: requests passes
README.md - Web application → Complaints and grievances: submits complaints
README.md - Web application → SOS alerts: raises alerts
README.md - Web application → Study assistant: gets study help
README.md - Web application → Study materials: accesses materials
README.md - Web application → Alumni and mentorship: connects alumni
README.md - Web application → Analytics and activity: views analytics
README.md - Web application → Administration and moderation: manages portal
README.md - Android application → Mobile API client: requests data
mobile/src/app/(app)/search.js - Express API → MongoDB records: serves API data
README.md - Express API → File uploads: serves uploads
server/src/app.js - Chat → Realtime transport: emits events
server/src/controllers/chatController.js - Realtime transport → MongoDB records: reads records
server/src/config/socket.js - Chat → Notifications: notifies users
server/src/controllers/chatController.js - Complaints and grievances → Notifications: notifies users
server/src/controllers/complaintController.js - Gate passes → Notifications: notifies users
server/src/controllers/gatePassController.js - Notifications → Realtime transport: emits updates
server/src/utils/notify.js - Study assistant → MongoDB records: stores conversations
server/src/services/ai/studyAssistantService.js - Study assistant → Study materials: retrieves sources
server/src/services/ai/studyAssistantService.js - Attendance → MongoDB records: reads and writes
server/src/controllers/attendanceController.js - Gate passes → MongoDB records: reads and writes
server/src/controllers/gatePassController.js - Administration and moderation → Analytics and activity: reviews activity
README.md