DECA Quiz Taker

This application allows you to take practice DECA exams from PDF files. You can upload an exam, take the quiz, and see a report of your results.

Before You Start

This application requires Node.js to run. If you don't have it installed, please follow these steps:

1. Check for Node.js: Open your computer's command line or terminal.
   • On macOS, you can find the "Terminal" app in your Utilities folder.
   • On Windows, you can open the "Command Prompt" or "PowerShell".
2. Type node -v and press Enter.
3. If you see a version number (e.g., v18.18.0), you have Node.js and can proceed to the next section.
4. Install Node.js: If you don't have Node.js, visit the official Node.js website and download the "LTS" (Long-Term Support) version. Run the installer and follow the on-screen instructions.

Getting Started

To run the application, you need to start both the server and the web interface. You will need two separate terminal/command prompt windows for this.

1. Start the Server

The server is the backbone of the application that processes the PDF exams.

1. Open a new terminal window.
2. Navigate to the server folder by typing cd server and pressing Enter.
3. Install the necessary files by typing npm install and pressing Enter. This might take a few minutes.
4. Start the server by typing npm run dev and pressing Enter. You should see a message indicating that the server is running.

Leave this terminal window open.

2. Start the Web App

The web app is the user interface where you will interact with the quiz.

1. Open a second, new terminal window.
2. Navigate to the web/deca-quiz-web folder by typing cd web/deca-quiz-web and pressing Enter.
3. Install the necessary files by typing npm install and pressing Enter. This might also take a few minutes.
4. Start the web app by typing npm run dev and pressing Enter.
5. Your web browser should automatically open to the application. If not, the terminal will show a "Local" address like http://localhost:5173. You can copy and paste this into your browser.

How to Use the Application

Now that the application is running, you can use it to take a quiz.

1. Upload an Exam:

   • On the main page, you will see an option to upload a file.
   • Click the "Upload" or "Choose File" button and select a DECA exam PDF from your computer.
   • The application will parse the PDF to create a quiz.

2. Take the Quiz:

   • Once the PDF is processed, you can start the quiz.
   • Read each question and select the best answer.
   • Navigate through the questions using the "Next" and "Previous" buttons.

3. View Your Report:

   • After you finish the quiz, the application will generate a report.
   • This report will show you which questions you got right and wrong, along with your overall score.
   • You can review your answers and see the correct solutions.