Quizzard of Oz

Project Documentation

Build a multiplayer quiz platform with confidence.

Quizzard of Oz combines casual play, ranked competition, and a clear system architecture. This documentation gives the team one place for product intent, technical direction, and architecture decisions.

Explore architecture Get started
Installation

Get the app running

Clone the repository, copy the environment file, and start all four services with a single Docker Compose command.

 Usage

App features and flows

Register, enter ranked matchmaking, play practice quizzes, and read the leaderboard — explained step by step.

 Architecture

arc42-style system overview

Understand the core building blocks, constraints, runtime expectations, and deployment shape.

 ADRs

Key technology decisions

Track the current decisions behind the frontend, backend, and package management stack.

 Testing

Documented test concept

Review the test levels, tools, CI quality gates, coverage reports, and known test gaps.

Quick Start

  • Follow Installation to get the application running locally with Docker.

  • Read Usage for a walkthrough of practice mode, ranked battles, and the leaderboard.

  • Start with Architecture if you need the big-picture system design.

  • Review Architecture Decisions when you need the reasoning behind the chosen stack.

  • Read Test Concept when you need the test strategy, quality gates, and execution commands.