Skip to content

Latest commit

 

History

History
118 lines (82 loc) · 4.43 KB

README.md

File metadata and controls

118 lines (82 loc) · 4.43 KB

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:

Image 1

Snapshot of the Class Selection Screen

Image 2

Snapshot of the Course Selection Screen

Image 3

Snapshot of QCM Generation in Progress

Image 4

Snapshot of Answering Questions with Explanations

Image 5

Snapshot Final Score

Technologies Used 🛠️

  • Node.js
  • Angular
  • MongoDB

🌟Star this repository🌟

Please ⭐️ this repo and share it with others

HITS Flutter Angular ExpressJS MongoDB

View-Only License

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

(back to top)