• Overview
  
• How to get started with MathQuest
  
• Features
  
• High-Level System Architecture
  
• Technology Stack
  
• API Endpoints
  
• Development Setup
  
• Test Results
  
• Contributors/ Team Members
  
• Frequently Asked Questions
  

MathQuest is an online learning management system designed specifically to deliver math courses and curriculum in an asynchronous format, allowing students to learn at their own pace. It provides capabilities for instructors to create course offerings, design quizzes and assignments, grade student work automatically, facilitate text discussions, and continually update course content, while students can browse courses, register, take assessments, participate in discussions with classmates, and track their progress. The system architecture employs a combination of MVC, client-server, and microservices patterns to enable a scalable, extensible, and modular platform that can handle multiple concurrent users.

Key features of MathQuest LMS include:

• Course offerings and registration: Instructors can create course offerings that students can browse and register for. This includes publishing detailed course information like syllabus, modules, assessments, etc.
  
• Course content and curriculum: Instructors can create and manage course content including modules, quizzes, assignments, and syllabus.
  
• Assessments and grading: Quizzes can be created, automatically graded, and feedback provided to students. Overall course grades are calculated.
  
• Discussions: Students and instructors can engage in threaded discussions within a course.
  
• User roles and permissions: The system supports student, instructor, and administrator roles with appropriate access controls.
  
• Administrative capabilities: Admins can approve/reject course requests, manage instructors, and moderate content.
  

Anything within <angular brackets> is a parameter.

You need to clone (download) the repository to your local machine using the below command in the terminal

   $ git clone https://github.com/ris-tlp/mathquest.git

This makes a local copy of the repository in your machine

Once you have cloned the mathquest repository in Github, move to that folder first using the change directory cd command on Linux/ Mac/ Windows

   $ cd mathquest

Then open the terminal inside mathquest folder and run the following command

   $ code .

The above command opens the project folder in Visual Studio Code which will be the IDE for Mathquest Development (Feel free to use the IDE of your choice)

Once you have downloaded the source code of MathQuest in your local, make sure npm and node are installed on your machine, then follow the below part 1 and part 2 to start the MathQuest application in your development environment.

First, navigate to the mathquest-client folder

   cd mathquest-client

Then, let us install the dependencies required on the client side of the Mathquest application.

   npm install

The above command installs the dependencies mentioned in the package-lock.json file of mathquest-client

Now, we can start the application using the below command:

   npm run start

First, navigate to the server folder

   cd server

Then, let us install the dependencies required on the server side of the Mathquest application.

   npm install

The above command installs the dependencies mentioned in the package-lock.json file of server

Run the below command to start the mathquest server

   npm run dev

If everything is up and running, you should see the home page of MathQuest application running on localhost

Team Member Name	Linkedin
Anand Verma	Anand
Tharun Kumar Reddy Polu	Tharun
Omar Khan	Omar
Ashwini Gour	Ashwini
Cydni Turner	Cydni

1. What types of math courses does MathQuest offer?
Ans: MathQuest offers a wide variety of math courses including Algebra, Geometry, Trigonometry, Calculus, Statistics, and more. Courses are available for middle school, high school, college prep, and college levels.

2. Do I need any special software or hardware to use MathQuest?
Ans: No, MathQuest is a web-based platform that works on any modern web browser. The only requirement is an internet connection.

3. How do I register for courses on MathQuest? Is there an enrollment period?
Ans: You can register for courses at any time by creating a student account on our platform. There is no enrollment period - you can sign up and start courses immediately.

4. Can I access MathQuest on my phone or tablet?
Ans: Yes, MathQuest is mobile-friendly and can be accessed from any device with a web browser including phones and tablets. This allows for on-the-go learning.

5. Are there options for getting help if I have questions on course material or assessments?
Ans: Yes, students can access discussion forums for each course to ask questions and interact with instructors or peers for help. Additionally, students can utilize 1-on-1 video chat options with instructors to ask questions.

6. Does MathQuest provide accommodations for students with disabilities?
Ans: Yes, we provide closed-captioning for videos, screen reader compatibility, enhanced fonts/contrast options, alternative input options for quizzes/exams, and the ability to make other necessary accommodations.

7. Is MathQuest accredited? Will course credits transfer to my university?
Ans: MathQuest itself is not an accredited program. However, most courses are designed to align with curriculum standards and prepare students for accredited exams that can earn future college credits at many institutions.

8. Can I interact with the instructor and other students taking the same course? Is there a community component?
Ans: MathQuest courses include community discussion forums where you can interact with peers and instructors taking the course.

Please discuss your concerns with Math Quest Team members before creating a new issue.

Please STAR the repository if you like the content and code
Also enable the WATCH button to keep watching the updates on the repository