yassindaboussi / qcmbuilder

🚀 A dynamic quiz generator 🧠. Create quizzes for different student classes, courses, and chapters 📚.Track progress 📈, view detailed explanations, and calculate the final score! 🎯

QCM Builder 🚀

QCM Builder is an exciting web application 🌐 crafted with Node.js and Angular, tailored for generating multiple-choice questions (QCM). Ideal for various student classes and courses 📚, it simplifies the process of selecting chapters, generating QCMs 🔍, providing detailed explanations for correct and incorrect answers, and even tracking progress 📊.

Project Structure 🏗️

The project is neatly organized into two primary folders:

Node 🖥️

This folder houses the backend logic implemented in Node.js. It takes charge of generating QCMs and furnishing the necessary APIs for the Angular frontend.

Angular 🌐

The Angular folder encompasses the frontend code, offering an intuitive user interface. Users can seamlessly navigate through classes, courses, and chapters, answer questions, access explanations, and monitor progress.

Getting Started 🚀

To run the project locally, follow these straightforward steps:

Node (Backend) 🚀

1. Navigate to the Node folder.
2. Install dependencies using npm install.
3. Run the server using npm run dev.
4. The Node.js server will be up and running on a specified port (default is http://localhost:3000).

Angular (Frontend) 🌐

1. Move to the Angular folder.
2. Install dependencies using npm install.
3. Initiate the Angular development server with ng serve.
4. Open your browser and head to http://localhost:4200.

Usage 🎯

1. 🌐 Access the Angular application in your browser.
2. 🎓 Choose the relevant student class, course, and chapters.
3. 🚀 Generate the QCM effortlessly.
4. 🤔 Answer the questions, and detailed explanations await for both correct and incorrect answers.
5. 📊 Keep an eye on your progress through the intuitive progress bar.
6. 🏆 Get a glimpse of your final score based on correct answers.

Screenshots 📷

Explore the visual journey with these snapshots:

Snapshot of the Class Selection Screen	Snapshot of the Course Selection Screen
Snapshot of QCM Generation in Progress	Snapshot of Answering Questions with Explanations
Snapshot Final Score

Technologies Used 🛠️

• Node.js
• Angular
• MongoDB

---

🌟Star this repository🌟

Please ⭐️ this repo and share it with others

This project is licensed under the View-Only License. See the LICENSE file for details.

(back to top)