How arivazhagan7b/groupmanagementportal works
Group Management Portal is a full-stack student-operations product. Users enter through cookie-based authentication, then use role-specific admin or student screens; those screens call the Express API, whose domain services manage group, membership, eligibility, phase, event, team, hub, and request workflows backed by MySQL. Audit records and Socket.IO updates support operations across those workflows. The graph preserves documented product areas, but several are represented at their exact module-directory level because their implementation excerpts were not supplied; those links are documented or marked unverified rather than inferred from names.
Main entry points: app.js Express API · membership.service.js Groups and memberships · App.jsx Role-based app · eligibility.service.js Eligibility scoring
Components 25
Web client
- Role-based app
client/src/App.jsx - Session context
client/src/utils/AuthContext.jsx - Admin workspace
client/src/admin/adminRoutes.jsx - Student workspace
client/src/students/studentRoutes.jsx - Support center
client/src/shared/pages/SupportPage.jsx
Identity and access
- Express API
server/app.js - Auth routes
server/routes/auth.routes.js - Login and session
server/controllers/auth.controller.js - Cookie authentication
server/middlewares/auth.middleware.js - JWT utilities
server/utils/jwt.js
Group operations
- Groups and memberships
server/modules/membership/membership.service.js - Join requests
server/modules/joinRequest/joinRequest.service.js - Teams and hubs
server/modules/team - Events and groups
server/modules/event - Support API
server/modules/support
Activities and policy
- Eligibility scoring
server/modules/eligibility/eligibility.service.js - Phase lifecycle
server/modules/phase/phase.service.js - System policy
server/modules/systemConfig/systemConfig.service.js - Activity points
server/modules/activityPointsWrite/activityPointsWrite.service.js - Audit logging
server/modules/audit/audit.service.js
Persistence and updates
- MySQL pool
server/config/db.js - Realtime events
server/realtime/events.js - Runtime configuration
server/config/runtime.js - Socket.IO server
server/realtime/socket.js
Other components
- Portal user
Connections 33
- Portal user → Role-based app: opens portal
README.md - Role-based app → Session context: checks session
client/src/App.jsx - Role-based app → Admin workspace: routes admins
client/src/App.jsx - Role-based app → Student workspace: routes students
client/src/App.jsx - Student workspace → Support center: routes to
client/src/students/studentRoutes.jsx - Session context → Express API: calls API
- Admin workspace → Express API: calls API
- Student workspace → Express API: calls API
- Support center → Support API: uses support API
client/src/shared/pages/SupportPage.jsx - Express API → Auth routes: mounts routes
server/app.js - Auth routes → Login and session: dispatches
server/routes/auth.routes.js - Auth routes → Cookie authentication: protects routes
server/routes/auth.routes.js - Cookie authentication → JWT utilities: validates session
server/middlewares/auth.middleware.js - Cookie authentication → Runtime configuration: reads secret
server/middlewares/auth.middleware.js - Express API → Groups and memberships: mounts domain routes
server/app.js - Express API → Join requests: mounts domain routes
server/app.js - Express API → Eligibility scoring: mounts domain routes
server/app.js - Groups and memberships → Join requests: uses request service
server/modules/joinRequest/joinRequest.service.js - Join requests → Groups and memberships: uses membership service
server/modules/joinRequest/joinRequest.service.js - Groups and memberships → Phase lifecycle: reads phase data
server/modules/membership/membership.service.js - Groups and memberships → System policy: reads policy
server/modules/membership/membership.service.js - Groups and memberships → Activity points: writes activity points
server/modules/membership/membership.service.js - Eligibility scoring → Groups and memberships: reads membership
server/modules/eligibility/eligibility.service.js - Eligibility scoring → Activity points: writes activity points
server/modules/eligibility/eligibility.service.js - Express API → Teams and hubs: mounts domain routes
server/app.js - Express API → Events and groups: mounts domain routes
server/app.js - Express API → Support API: mounts support routes
server/app.js - Groups and memberships → MySQL pool: queries database
README.md - Eligibility scoring → MySQL pool: queries database
server/modules/eligibility/eligibility.service.js - Audit logging → Realtime events: broadcasts changes
server/modules/audit/audit.service.js - Realtime events → Socket.IO server: emits events
server/realtime/events.js - Express API → MySQL pool: uses MySQL
README.md - Express API → Realtime events: provides live updates
README.md