How m-phuc04/internship-graduation-management works
This is a role-based university internship and thesis-management platform. Students register internships or thesis groups and complete reports/evaluations; lecturers supervise and assess work; TBM/admin users manage assignments, councils, grading periods, and academic terms; companies submit internship evaluations. The browser app routes users to role-specific pages, calls the backend API, and the backend dispatches requests through protected routes and domain services to MongoDB-backed models. The source index documents several major capabilities, but many controller/service internals and frontend pages were not sampled, so those branches are represented at subsystem level.
Main entry points: server.js HTTP server · App.jsx Role-based routing · authMiddleware.js Token authentication · thesisRoutes.js Thesis routes
Components 25
Web application
- Role-based routing
frontend/src/App.jsx - Session context
frontend/src/context/AuthContext.jsx - Lecturer thesis workspace
frontend/src/pages/lecturer/LecturerThesesPage.jsx - Thesis API client
frontend/src/api/thesisApi.js
Backend API
- HTTP server
backend/src/server.js - Thesis routes
backend/src/routes/thesisRoutes.js - Thesis controller
backend/src/controllers/thesisController.js - Internship routes
backend/src/routes/internshipRoutes.js - Internship controller
backend/src/controllers/internshipController.js - Evaluation routes
backend/src/routes/evaluationRoutes.js - Evaluation controller
backend/src/controllers/evaluationController.js - Realtime socket handler
backend/src/socket/socketHandler.js
Academic workflows
- Thesis workflow service
backend/src/services/thesisService.js - Internship service
backend/src/services/internshipService.js - Evaluation service
backend/src/services/evaluationService.js - Academic-term service
backend/src/services/academicTermService.js - Report exports
backend/src/services/exportService.js
Identity and access
- Token authentication
backend/src/middlewares/authMiddleware.js - Token utilities
backend/src/utils/token.js
Persistent data
- MongoDB connection
backend/src/config/database.js - Thesis records
backend/src/models/Thesis.js - Internship records
backend/src/models/Internship.js - User accounts
backend/src/models/User.js - Evaluation records
backend/src/models/Evaluation.js
Other components
- Platform users
Connections 29
- Platform users → Role-based routing: uses
- Role-based routing → Session context: provides session
frontend/src/App.jsx - Role-based routing → Lecturer thesis workspace: routes to
frontend/src/App.jsx - Lecturer thesis workspace → Thesis API client: calls
frontend/src/pages/lecturer/LecturerThesesPage.jsx - HTTP server → Thesis routes: mounts
backend/src/server.js - HTTP server → Internship routes: mounts
backend/src/server.js - HTTP server → Evaluation routes: mounts
backend/src/server.js - HTTP server → MongoDB connection: connects
backend/src/server.js - HTTP server → Realtime socket handler: initializes
backend/src/server.js - Thesis routes → Token authentication: guards requests
backend/src/routes/thesisRoutes.js - Thesis routes → Thesis controller: dispatches
backend/src/routes/thesisRoutes.js - Thesis controller → Thesis workflow service: delegates
backend/src/controllers/thesisController.js - Thesis workflow service → Thesis records: reads and writes
backend/src/services/thesisService.js - Internship routes → Token authentication: guards requests
backend/src/routes/internshipRoutes.js - Internship routes → Internship controller: dispatches
backend/src/routes/internshipRoutes.js - Internship controller → Internship service: delegates
backend/src/controllers/internshipController.js - Internship controller → Report exports: requests exports
backend/src/controllers/internshipController.js - Evaluation routes → Token authentication: guards requests
backend/src/routes/evaluationRoutes.js - Evaluation routes → Evaluation controller: dispatches
backend/src/routes/evaluationRoutes.js - Evaluation controller → Evaluation service: delegates
backend/src/controllers/evaluationController.js - Evaluation service → Evaluation records: reads and writes
backend/src/services/evaluationService.js - Token authentication → Token utilities: verifies token
backend/src/middlewares/authMiddleware.js - Token utilities → User accounts: uses account data
- Academic-term service → Thesis records: reads term records
backend/src/services/academicTermService.js - Academic-term service → Internship records: reads term records
backend/src/services/academicTermService.js - Report exports → Internship records: reads records
backend/src/services/exportService.js - Report exports → Thesis records: reads records
backend/src/services/exportService.js - Evaluation service → Internship records: uses internship data
backend/src/services/evaluationService.js - Session context → Role-based routing: supplies identity
frontend/src/App.jsx