README.md

Quizzer

Quizzer is a single-page application - a system for creating, managing, and filling out quizzes.

Getting started

You can access the deployed application by clicking here: Quizzer

If you wish to run Quizzer locally:

• No need to install any dependencies! All libraries are imported from CDN.
• Simply open the root of the project and start index.html using a server of your choice.

Functionality

• User registration
• Ability to view and solve quizzes created by other users
• Various topics related to quizzes
• Keeping statistics for each user/quiz/question/solution
• Interactive quiz editor
• Pleasant UX

Technologies

• HTML, CSS, Javascript
• lit-html, page.js - (libraries)
• Netlify (deployment platform), Back4app (BaaS platform)

Views

• Welcome/Home page - initial screen, info about total quizzes and topics, the most recent quiz is shown
• Login/Register page - register with email, username and password
• Browse quizzes page - list of all created quizzes, each one can be accessed
• Quiz Details page - additional description, quiz statistics, author information and start the quiz button
• Quiz Contest mode - answering questions, each question is in a separate view, the ability to move freely from question to question, answers are kept throughout, can restart the quiz, submit answers button appears either on the last question or when the quiz is filled out entirely (checks and warns about unfilled questions)
• Quiz Results page - results summary, ability to review wrong questions and see correct answers
• Profile page - information about user's created quizzes and his solutions (date, quiz title, score)
• Create page - the ability to create a new quiz prior to the editor, top 3 most popular quizzes are shown (sorted by solutions count)
• Quiz Editor - integrated editor for quizzes, questions, and answers with proper validation

Access control

• Guests can register, view the catalog, and quiz details
• Registered users can solve quizzes, view their results, and create/edit quizzes
• Only the creator of a given quiz can edit or delete it
• Any registered user can solve someone else's quiz

Implementation

Data structure & Back4app collections

• Roles (private)

{
     name: String,
     users: Relation<User>,
     roles: Relation<Role>
}

• Sessions (private)

{
     user: Pointer<User>
}

• Users (private)

{
     email: String,
     username: String,
     password: String(hidden)
}

• Questions

{
     text: String,
     answers: Array<String>,
     correctIndex: Number,
     quiz: Pointer<Quiz>,
     owner: Pointer<User>
}

• Quizzes

{
     title: String,
     topic: String,
     description: String,
     questionCount: Number,
     owner: Pointer<User>
}

• Solutions

{
     title: String,
     correct: Number,
     total: Number,
     quiz: Pointer<Quiz>,
     owner: Pointer<User>
}

Basic app flowchart

Access the app here