Group6-SOEN341_Project_F24
For sprint 1, 2, 3 and 4 documentation, see the wiki.
Project Description
University team projects often struggle with unequal contributions and lack accountability. This peer assessment platform enables students to evaluate their teammates across four key dimensions, promoting accountability and offering valuable feedback for both students and instructors.
Core Features
-
Comprehensive Four-Dimension Assessments:
- Cooperation: Evaluates a student’s ability to take initiative, communicate, assist peers, and contribute to meetings and project planning.
- Conceptual Contribution: Assesses a student’s involvement in research, design, and contributing ideas.
- Practical Contribution: Measures a student’s engagement and initiative in producing deliverables and providing constructive feedback.
- Work Ethic: Examines a student’s attitude toward the project and peers and their ability to meet deadlines and project milestones.
-
Anonymous Peer Evaluations: Encourages fair and honest feedback.
-
Peer Feedback Summaries for Instructors: Helps instructors assess team dynamics and evaluate each student’s performance and contributions.
-
Personal Feedback Report for Students: Offers students constructive feedback on their contributions, encouraging personal growth.
Proposed Features
- Editable Calendar for Students
- Simple calendar designed to help students manage their schedules effectively.
- Tasks can be added to selected dates
- Chill Tab For Students
- Chill Minigames:
- Bubble Pop: Pop bubbles floating across the screen for points, providing a light distraction to relieve stress.
- Emoji Match: Match pairs of emojis in a soothing memory game, designed to relax the mind.
- Chill Guy Jokes:
- A collection of lighthearted, relatable "chill guy" moments that offer students a quick laugh and an escape from serious tasks.
- The humor aims to foster positivity and lighten the mood, promoting better mental well-being.
- Background Music:
- Relaxing soundtrack to reduce stress, stay focused, or simply unwind during study breaks.
- Password Recovery
- Email-Based Recovery:
- Allow users to recover their password using their emails.
Installation Instructions
Prerequisites
-
Node.js and npm: Install Node.js, which includes npm, the Node package manager. You can download it from the official Node.js website.
-
MongoDB: This project uses MongoDB Atlas, a cloud-based database service. You can set up a free cluster on MongoDB Atlas and use the connection string it provides to connect your application. For more details, visit the MongoDB Atlas website.
Steps
-
Clone the Repository:git clone https://github.com/benjaminsunliu/Group6-SOEN341_Project_F24.git
-
Navigate to the Project Directory: cd Group6-SOEN341_Project_F24
-
Backend Setup:
cd backend
npm install
node server
The backend server will run on http://localhost:5050.
-
Frontend Setup:
cd ../client
npm install
npm start
The frontend will run on http://localhost:3000.
-
For Unit testing
cd client or cd backend
npm test
Technology Stack
- Node.js
- React.js
- Express
- MongoDB
User Roles
- Students: Can evaluate their teammates across the four assessment dimensions and access personal feedback reports.
- Instructors: Can create and manage teams from their course roster (with the option to import team lists as a CSV file). After students have submitted their peer evaluations, instructors may view and export individualised reports. The Instructor can also export existing teams to a local device.
Team Members
Backend Development
Database Development
Frontend Development
Conclusion
This peer assessment platform aims to foster a collaborative and accountable environment for students working on team projects, ultimately leading to a more equitable and productive learning experience.