README.md

Application of Web Programming in Infrastructure Systems

The goal of this project is to develop a modern web application that allows users to take quizzes in various subjects, receive real-time results, and compare their knowledge with others through a global leaderboard. The application should be modular, extensible, and implemented according to contemporary frontend and backend development standards.

---

Built using

•   ASP.NET 8 + Entity Framework 8
•   React 19 + Vite
•   Node.js (for package management & tooling)

Installation:

1. Install .NET SDK:
   Download and install the .NET SDK 8.0 for your operating system from here.

2. Verify installation:
   Run the following command in your terminal to confirm:

   dotnet --list-sdks

3. Install Node.js and npm

   Download and install the Node.js LTS version — it comes with npm (Node Package Manager) preinstalled.

   Verify the installation by running the following commands in your terminal:

   node -v
   npm -v

4. Install Entity Framework Core CLI tools

   Make sure you have the EF Core CLI tools installed globally so you can run database migrations:

   dotnet tool install --global dotnet-ef

   Verify the installation by running the following commands in your terminal:

   dotnet ef

How to run:

1. Clone the project:

   git clone https://github.com/Acile067/Project_PUGS_Quiz_Hub.git
   cd Project_PUGS_Quiz_Hub

2. Dotnet CLI API:

   cd QuizHub-api/QuizHub.Infrastructure
   dotnet ef database update

   This applies all pending Entity Framework Core migrations to the database. Then, start the API:

   cd ../QuizHub.API
   dotnet run

   The application will run on port 7108.

3. Run UI:

   cd quizhub-ui

   add .env exapmle: VITE_BACKEND_API_URL=https://localhost:7108

   npm i
   npm run dev

   The application will run on port 3000.

Use Case Diagram: