#TODO:

This is a Laravel blueprint for backend development, for creating a multi-tenant application (single database) to manage quizzes

• fork this repository
• clone this repository git clone git@github.com:username/assignment-blueprint-backend.git quiz
• cd into the project directory cd quiz
• run composer install
• run cp .env.example .env
• run migration php artisan migrate
• serve the application php artisan serve or use laravel valet, or any other server
• visit the application in your browser http://quiz.test if you are using valet

This application is multi-tenant, meaning that it can serve multiple clients with a single codebase. To achieve this, we use the tenancyforlaravel package. The package is already installed and configured.

• Tenant
• User
• Quiz
• Question
• Choice

Note: you should create missing models, and migrations if needed, or any needed changes to the existing models.

• Ability to register a new tenant.
• Ability to create a new quiz with two types for (in-time quiz, and out-of-time quiz).

  Note: in-time quiz is a quiz that has a start time, and end time, and the user can take the quiz only between these times. out-of-time quiz is a quiz that has no start time, and end time, and the user can take the quiz anytime.

• Ability to manage questions.
• Ability to manage choices.
• Ability to register new accounts for a tenant members

  Note: members should be in separated table from the tenant owner(users).

• Ability to login/logout for a tenant member.
• Ability to subscribe to a quiz for a member.
• Ability to integrate with Google calendar, and add a quiz (starts/ends time) to the calendar for a member.
• Ability to remind a member to take a quiz before the quiz starts time.
• Ability to add attempts for a quiz for a member.
• Ability to take a quiz using a unique link for every member by only email, and send the link to email.
• Ability to view the result of a quiz after taking it.
• Ability to email the member after taking the quiz with the result of the quiz, and the correct answers.
• Ability to email the owner of the tenant after a client takes a quiz.
• Ability to view quiz results for all members by tenant owner, you can use filament for this [bonus point].
• Ability to export quiz results for all members by tenant owner to csv with filters by using queues.

  Note: use seeders to create dummy data for exporting. minimum 20000 records.

• Ability to view dashboards for:
  • Number of members
  • Attempts
  • Pass rate
  • Fail rate
  • Average score
  • Average time (for in-time quiz)
• Create a REST API for the application, and document it using Postman.
• Write tests for the application using pest, already installed.
• write stress testing for the application using pest [bonus point].
• Write a README.md file for the application, explaining how to setup and run the application, and how to use the REST API with example for every endpoint.
• Write a CHANGELOG.md file for the application, explaining the changes you made to the application, and the new features you added.

• Dockerize the application
• Setup a CI/CD pipeline for the application using GitHub actions
• Deploy the application to a server of your choice [bonus point]

• Use queues for sending emails, and other heavy tasks you may have [show your knowledge/skills of queues].
• Use queues priority for organizing queues jobs/tasks [bonus point].
• Make sure to use the correct relationships between models, and use the correct database structure.
• Write a clean code, and follow the best practices.
• Write a clean commit messages.

• You can use tailwindcss for the frontend, with its free UI kit tailwindui.