# draco437/acm-quiz-portal architecture

> Architecture diagram of the GitHub repository draco437/acm-quiz-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/draco437/acm-quiz-portal
- Repository: https://github.com/draco437/acm-quiz-portal

## Overview

Buzz Round is a student quiz portal. Students register, pass webcam and fullscreen checks, choose a topic, answer timed questions, and—when a user ID is present—submit results to Supabase. The sampled quiz runner shows its own completion screen; the separate ScoreBoard component is not shown connected to that flow. Edges reflect sampled imports, rendered components, browser API use, and explicit database calls; unsampled behavior is not inferred.

Main entry points: [`components/RegistrationForm.jsx`](https://github.com/draco437/acm-quiz-portal/blob/main/components/RegistrationForm.jsx) (Registration Form), [`lib/supabaseClient.js`](https://github.com/draco437/acm-quiz-portal/blob/main/lib/supabaseClient.js) (Supabase Client), [`app/page.js`](https://github.com/draco437/acm-quiz-portal/blob/main/app/page.js) (Home Flow), [`app/quiz/[category]/page.js`](https://github.com/draco437/acm-quiz-portal/blob/main/app/quiz/%5Bcategory%5D/page.js) (Category Quiz Route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Registration"]
  node_home["Home Flow<br/>[page.js]"]
  node_registration["Registration Form"]
end

subgraph group_proctor["Proctoring"]
  node_proctor_check["Proctoring Check"]
end

subgraph group_quiz["Quiz Experience"]
  node_quiz_route["Category Quiz Route<br/>[page.js]"]
  node_quiz_runner["Timed Quiz Runner<br/>[QuizRunner.jsx]"]
  node_scoreboard["Score Board<br/>[ScoreBoard.jsx]"]
end

subgraph group_persistence["Questions and Persistence"]
  node_questions["Category Questions<br/>[questions.js]"]
  node_supabase_client["Supabase Client<br/>[supabaseClient.js]"]
end

node_student(("Student"))
node_browser_camera["Browser Camera"]
node_supabase[("Supabase")]

node_student -->|"starts"| node_home
node_home -->|"renders"| node_registration
node_registration -->|"returns user"| node_student
node_registration -->|"queries users"| node_supabase_client
node_registration -->|"checks submissions"| node_supabase_client
node_registration -->|"upserts user"| node_supabase_client
node_home -->|"renders"| node_proctor_check
node_proctor_check -->|"requests webcam"| node_browser_camera
node_home -->|"links category"| node_quiz_route
node_quiz_route -->|"gets category"| node_questions
node_quiz_route -->|"renders"| node_quiz_runner
node_quiz_runner -->|"inserts result"| node_supabase_client
node_supabase_client -->|"connects"| node_supabase

click node_home "https://github.com/draco437/acm-quiz-portal/blob/main/app/page.js"
click node_registration "https://github.com/draco437/acm-quiz-portal/blob/main/components/RegistrationForm.jsx"
click node_proctor_check "https://github.com/draco437/acm-quiz-portal/blob/main/components/ProctoringCheck.jsx"
click node_quiz_route "https://github.com/draco437/acm-quiz-portal/blob/main/app/quiz/%5Bcategory%5D/page.js"
click node_quiz_runner "https://github.com/draco437/acm-quiz-portal/blob/main/components/QuizRunner.jsx"
click node_scoreboard "https://github.com/draco437/acm-quiz-portal/blob/main/components/ScoreBoard.jsx"
click node_questions "https://github.com/draco437/acm-quiz-portal/blob/main/data/questions.js"
click node_supabase_client "https://github.com/draco437/acm-quiz-portal/blob/main/lib/supabaseClient.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_registration,node_browser_camera toneBlue
class node_proctor_check,node_supabase toneAmber
class node_quiz_route,node_quiz_runner,node_scoreboard toneMint
class node_questions,node_supabase_client toneRose
class node_student toneIndigo
```

## Components

### Entry and Registration

- [Home Flow](https://github.com/draco437/acm-quiz-portal/blob/main/app/page.js): `app/page.js`
- [Registration Form](https://github.com/draco437/acm-quiz-portal/blob/main/components/RegistrationForm.jsx): `components/RegistrationForm.jsx`

### Proctoring

- [Proctoring Check](https://github.com/draco437/acm-quiz-portal/blob/main/components/ProctoringCheck.jsx): `components/ProctoringCheck.jsx`

### Quiz Experience

- [Category Quiz Route](https://github.com/draco437/acm-quiz-portal/blob/main/app/quiz/%5Bcategory%5D/page.js): `app/quiz/[category]/page.js`
- [Timed Quiz Runner](https://github.com/draco437/acm-quiz-portal/blob/main/components/QuizRunner.jsx): `components/QuizRunner.jsx`
- [Score Board](https://github.com/draco437/acm-quiz-portal/blob/main/components/ScoreBoard.jsx): `components/ScoreBoard.jsx`

### Questions and Persistence

- [Category Questions](https://github.com/draco437/acm-quiz-portal/blob/main/data/questions.js): `data/questions.js`
- [Supabase Client](https://github.com/draco437/acm-quiz-portal/blob/main/lib/supabaseClient.js): `lib/supabaseClient.js`

### Other components

- **Student**
- **Browser Camera**
- **Supabase**

## Connections

- Student → Home Flow: starts (evidence: `app/page.js`)
- Home Flow → Registration Form: renders (evidence: `app/page.js`)
- Registration Form → Student: returns user
- Registration Form → Supabase Client: queries users (evidence: `components/RegistrationForm.jsx`)
- Registration Form → Supabase Client: checks submissions (evidence: `components/RegistrationForm.jsx`)
- Registration Form → Supabase Client: upserts user (evidence: `components/RegistrationForm.jsx`)
- Home Flow → Proctoring Check: renders (evidence: `app/page.js`)
- Proctoring Check → Browser Camera: requests webcam (evidence: `components/ProctoringCheck.jsx`)
- Home Flow → Category Quiz Route: links category (evidence: `app/page.js`)
- Category Quiz Route → Category Questions: gets category (evidence: `app/quiz/[category]/page.js`)
- Category Quiz Route → Timed Quiz Runner: renders (evidence: `app/quiz/[category]/page.js`)
- Timed Quiz Runner → Supabase Client: inserts result (evidence: `components/QuizRunner.jsx`)
- Supabase Client → Supabase: connects (evidence: `lib/supabaseClient.js`)
