Teagrade

A web application designed to simplify test creation and grading for teachers. Create multiple-choice tests, generate printable bubble sheets, and automatically grade student submissions by scanning completed sheets.

✨ Features

• 👨‍🏫 Teacher Dashboard: Create and manage courses.
• 🧑‍🎓 Student Management: Add students to courses.
• 📝 Test Builder: Create multiple-choice tests with defined correct answers.
• 🖨️ Bubble Sheet: Download printable bubble sheets and print for your student.
• 📷 Scan & Grade: Upload scanned images of completed sheets. Student IDs and answers are auto-detected and graded.
• 📊 Results Viewer: View test results per student within the application.

📷 How It Works

1. Create Course & Test: Teachers define a test with MC questions and answers.
2. Print Bubble Sheet: Download the buble sheet, which includes fields for student ID and answer bubbles.
3. Conduct Test: Students fill out the bubble sheets on paper.
4. Upload Scan: Teachers upload photos or scans of the completed bubble sheets.
5. Auto-Grading: The app reads the image, extracts the student ID and answers, compares with the answer key, and grades the test.
6. View Results: Teachers can view individual and class-wide results within the app.

Built With

• 
• 
• 
• 
• 
• 
• 
• 

Getting Started

Installation

1. Clone the Repository

git clone https://github.com/tunauygun/Teagrade.git
cd coplaner

2. Install Dependencies

Run the following command to install required dependencies:

npm install

3. Set Up Environment Variables

Create a .env file in the root directory and add the necessary environment variables:

dbURL=mongodb://localhost:27017/teagrade
SECRET=your_secret_here

4. Set up MongoDB database

Ensure you have a MongoDB database running at the URL specified in the .env file specified above

5. Start the Server

Run the application in development mode:

npm run dev

6. Open in Browser

Once the server is running, open your browser and go to:

http://localhost:3000