https://github.com/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! 🎯
https://github.com/yassindaboussi/qcmbuilder

angular education full-stack javascript mongodb nodejs progress-tracking quiz-generator web-development

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/yassindaboussi/qcmbuilder
• Owner: yassindaboussi
• License: other
• Created: 2023-12-06T22:04:58.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-10T12:18:45.000Z (over 2 years ago)
• Last Synced: 2025-01-03T15:24:23.776Z (over 1 year ago)
• Topics: angular, education, full-stack, javascript, mongodb, nodejs, progress-tracking, quiz-generator, web-development
• Language: TypeScript
• Homepage:
• Size: 526 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# 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









![HITS](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https://github.com/yassindaboussi/QCMBuilder&count_bg=#79C83D&title_bg=#555555&icon=&icon_color=#E7E7E7&title=PAGE+VIEWS&edge_flat=false)

[![Flutter](https://img.shields.io/badge/NodeJs-brightgreen.svg)](https://nodejs.org)

[![Angular](https://img.shields.io/badge/Angular-brightgreen.svg)](https://angular.io)

[![ExpressJS](https://img.shields.io/badge/ExpressJs-orange.svg)](https://expressjs.com)

[![MongoDB](https://img.shields.io/badge/MongoDB-brightgreen.svg)](https://mongodb.com)

    



  

     

  

    

[![View-Only License](https://img.shields.io/badge/License-View--Only-red.svg?style=flat-square)](LICENSE.md)

This project is licensed under the **View-Only License**. See the [LICENSE](LICENSE) file for details.





(back to top)