How dayastant/student-project-showcase-portal works
The Student Project Showcase Portal is a full-stack platform for publishing, discovering, and moderating student projects. Its main workflow is Google sign-in, project submission with metadata and images, administrator review, then discovery and social interaction. Staff and administrators also have review, analytics, user-management, and reporting capabilities. The graph combines documented product behavior with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled controller, route, and listener internals limit some connections.
Main entry points: eventBus.js Event publisher · project.controller.js Project management · ProjectDetailPage.jsx Project pages · admin.controller.js Moderation and roles
Components 30
Web experience
- Route application
frontend/src/App.jsx - Project pages
frontend/src/pages/projects/ProjectDetailPage.jsx - Project submission
frontend/src/pages/projects/CreateProjectPage.jsx - Lecturer dashboard
frontend/src/pages/home/LecturerDashboard.jsx - Reviews and reactions
frontend/src/components/AcademicReviewsView.jsx - Admin dashboard
frontend/src/pages/home/AdminDashboard.jsx
Identity and profiles
- Auth context
frontend/src/contexts/AuthContext.jsx - Google sign-in
frontend/src/pages/login/LoginPage.jsx - Profile management
frontend/src/pages/profile/ProfilePage.jsx - User API client
frontend/src/api/users.js - User management
backend/src/users/user.controller.js - Users
backend/src/users/user.model.js
Project lifecycle
- Project management
backend/src/project/project.controller.js - Project records
backend/src/project/project.model.js - Project images
backend/src/projectImages/projectImage.model.js - Review and approval
backend/src/lecturer/lecturer.controller.js - Departments
backend/src/departments/department.model.js
Community interaction
- Likes
backend/src/likes/like.controller.js - Comments
backend/src/comments/comment.controller.js - Follows
backend/src/followers/follower.controller.js - Project reports
backend/src/reports/report.controller.js
Administration and events
- Moderation and roles
backend/src/admin/admin.controller.js - Event publisher
backend/src/events/eventBus.js - Event listeners
backend/src/events/listeners.js - Notifications
backend/src/notification/notification.controller.js
Other components
- Students
- Staff and lecturers
- Administrators
- MongoDB
- REST API server
backend/index.js
Connections 33
- Students → Google sign-in: sign in
README.md - Google sign-in → Auth context: establishes session
- Auth context → User API client: loads profile
frontend/src/contexts/AuthContext.jsx - User API client → REST API server: requests users
frontend/src/api/users.js - Route application → Auth context: provides auth
frontend/src/App.jsx - Students → Project submission: submits project
README.md - Project submission → Project management: sends submission
- Project management → Project records: creates and updates
backend/src/project/project.controller.js - Project management → Project images: adds images
backend/src/project/project.controller.js - Project management → Departments: validates department
backend/src/project/project.controller.js - Staff and lecturers → Lecturer dashboard: reviews submissions
README.md - Administrators → Admin dashboard: moderates projects
README.md - Lecturer dashboard → Review and approval: approves or rejects
frontend/src/pages/home/LecturerDashboard.jsx - Review and approval → Project records: updates status
backend/src/lecturer/lecturer.controller.js - Admin dashboard → Moderation and roles: manages users
- Moderation and roles → Project records: moderates projects
backend/src/admin/admin.controller.js - Moderation and roles → Users: updates users
backend/src/admin/admin.controller.js - Project pages → REST API server: browses projects
- Students → Reviews and reactions: interacts with projects
README.md - Reviews and reactions → Comments: posts reviews
- Project pages → Likes: likes projects
- Profile management → Follows: follows students
- Project pages → Project reports: reports content
- Project management → Event publisher: publishes deletion
backend/src/project/project.controller.js - Likes → Event publisher: publishes like
backend/src/likes/like.controller.js - Comments → Event publisher: publishes comment
backend/src/comments/comment.controller.js - Follows → Event publisher: publishes follow
backend/src/followers/follower.controller.js - Project reports → Event publisher: publishes report
backend/src/reports/report.controller.js - Moderation and roles → Event publisher: publishes moderation
backend/src/admin/admin.controller.js - Event publisher → Event listeners: dispatches events
- Event listeners → Notifications: creates notifications
- REST API server → MongoDB: persists application data
README.md - Project pages → Project records: discovers approved projects
README.md