# northstar-vdwrx/quizproject architecture

> Architecture diagram of the GitHub repository northstar-vdwrx/quizproject, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/northstar-vdwrx/quizproject
- Repository: https://github.com/northstar-vdwrx/quizproject

## Overview

NORTHSTAR Eval is a role-based assessment frontend: users register or log in, complete a learning profile when needed, then use student, teacher, or administrator workspaces. Teachers manage quizzes and groups; students take sessions, save answers, submit attempts, and review results. The API client centralizes requests for most product pages, while authentication and the shared header make direct API calls. The README documents capabilities beyond the sampled excerpts; edges below are limited to documented or visible relationships.

Main entry points: [`src/lib/api.js`](https://github.com/northstar-vdwrx/quizproject/blob/main/src/lib/api.js) (API request client), [`src/components/SiteHeader.svelte`](https://github.com/northstar-vdwrx/quizproject/blob/main/src/components/SiteHeader.svelte) (Site navigation), [`src/pages/quiz/QuizPage.svelte`](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/quiz/QuizPage.svelte) (Take assessment), [`src/pages/onboarding/OnboardingPage.svelte`](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/onboarding/OnboardingPage.svelte) (Profile onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_landing["Landing page<br/>[LandingPage.svelte]"]
  node_auth["Sign in and register<br/>[AuthPage.svelte]"]
end

subgraph group_profile["Profile setup"]
  node_onboarding["Profile onboarding"]
end

subgraph group_workspace["Role workspaces"]
  node_home["Role dashboard<br/>[Home.svelte]"]
  node_teacher["Teacher workspace"]
end

subgraph group_assessment["Assessment lifecycle"]
  node_quizeditor["Quiz authoring<br/>[QuizEditor.svelte]"]
  node_studentquiz["Take assessment<br/>[QuizPage.svelte]"]
  node_results["Attempt results<br/>[ResultsPage.svelte]"]
end

subgraph group_integration["Shared integration"]
  node_header["Site navigation<br/>[SiteHeader.svelte]"]
  node_api["API request client<br/>[api.js]"]
end

node_visitor(("User"))
node_service{{"Backend API"}}

node_visitor -->|"opens"| node_landing
node_visitor -->|"registers or logs in"| node_auth
node_auth -->|"authenticates directly"| node_service
node_auth -->|"first login redirects"| node_onboarding
node_visitor -->|"completes profile"| node_onboarding
node_onboarding -->|"requests profile data"| node_api
node_onboarding -->|"loads account directly"| node_service
node_visitor -->|"opens workspace"| node_home
node_home -->|"loads role and admin data"| node_api
node_home -->|"renders teacher role"| node_teacher
node_teacher -->|"manages sessions and groups"| node_api
node_teacher -->|"opens quiz editor"| node_quizeditor
node_quizeditor -->|"edits questions and sections"| node_api
node_visitor -->|"opens session"| node_studentquiz
node_studentquiz -->|"loads session and saves answers"| node_api
node_studentquiz -->|"submits attempt directly"| node_service
node_studentquiz -->|"redirects after submission"| node_results
node_visitor -->|"views attempts"| node_results
node_results -->|"loads attempt results"| node_api
node_landing -->|"renders navigation"| node_header
node_onboarding -->|"renders navigation"| node_header
node_home -->|"renders navigation"| node_header
node_studentquiz -->|"renders navigation"| node_header
node_results -->|"renders navigation"| node_header
node_header -->|"checks session and logs out"| node_service
node_api -->|"sends API requests"| node_service

click node_landing "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/landing/LandingPage.svelte"
click node_auth "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/auth/AuthPage.svelte"
click node_header "https://github.com/northstar-vdwrx/quizproject/blob/main/src/components/SiteHeader.svelte"
click node_onboarding "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/onboarding/OnboardingPage.svelte"
click node_home "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/Home.svelte"
click node_teacher "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/TeacherWorkspace.svelte"
click node_quizeditor "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/QuizEditor.svelte"
click node_studentquiz "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/quiz/QuizPage.svelte"
click node_results "https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/results/ResultsPage.svelte"
click node_api "https://github.com/northstar-vdwrx/quizproject/blob/main/src/lib/api.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_landing,node_auth,node_visitor toneBlue
class node_onboarding toneAmber
class node_home,node_teacher,node_service toneMint
class node_quizeditor,node_studentquiz,node_results toneRose
class node_header,node_api toneIndigo
```

## Components

### Entry and identity

- [Landing page](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/landing/LandingPage.svelte): `src/pages/landing/LandingPage.svelte`
- [Sign in and register](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/auth/AuthPage.svelte): `src/pages/auth/AuthPage.svelte`

### Profile setup

- [Profile onboarding](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/onboarding/OnboardingPage.svelte): `src/pages/onboarding/OnboardingPage.svelte`

### Role workspaces

- [Role dashboard](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/Home.svelte): `src/pages/home/Home.svelte`
- [Teacher workspace](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/TeacherWorkspace.svelte): `src/pages/home/TeacherWorkspace.svelte`

### Assessment lifecycle

- [Quiz authoring](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/home/QuizEditor.svelte): `src/pages/home/QuizEditor.svelte`
- [Take assessment](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/quiz/QuizPage.svelte): `src/pages/quiz/QuizPage.svelte`
- [Attempt results](https://github.com/northstar-vdwrx/quizproject/blob/main/src/pages/results/ResultsPage.svelte): `src/pages/results/ResultsPage.svelte`

### Shared integration

- [Site navigation](https://github.com/northstar-vdwrx/quizproject/blob/main/src/components/SiteHeader.svelte): `src/components/SiteHeader.svelte`
- [API request client](https://github.com/northstar-vdwrx/quizproject/blob/main/src/lib/api.js): `src/lib/api.js`

### Other components

- **User**
- **Backend API**

## Connections

- User → Landing page: opens (evidence: `README.md`)
- User → Sign in and register: registers or logs in (evidence: `README.md`)
- Sign in and register → Backend API: authenticates directly (evidence: `src/pages/auth/AuthPage.svelte`)
- Sign in and register → Profile onboarding: first login redirects (evidence: `README.md`)
- User → Profile onboarding: completes profile (evidence: `README.md`)
- Profile onboarding → API request client: requests profile data (evidence: `src/pages/onboarding/OnboardingPage.svelte`)
- Profile onboarding → Backend API: loads account directly (evidence: `src/pages/onboarding/OnboardingPage.svelte`)
- User → Role dashboard: opens workspace (evidence: `README.md`)
- Role dashboard → API request client: loads role and admin data (evidence: `src/pages/home/Home.svelte`)
- Role dashboard → Teacher workspace: renders teacher role (evidence: `src/pages/home/Home.svelte`)
- Teacher workspace → API request client: manages sessions and groups (evidence: `src/pages/home/TeacherWorkspace.svelte`)
- Teacher workspace → Quiz authoring: opens quiz editor (evidence: `src/pages/home/TeacherWorkspace.svelte`)
- Quiz authoring → API request client: edits questions and sections (evidence: `src/pages/home/QuizEditor.svelte`)
- User → Take assessment: opens session (evidence: `README.md`)
- Take assessment → API request client: loads session and saves answers (evidence: `src/pages/quiz/QuizPage.svelte`)
- Take assessment → Backend API: submits attempt directly (evidence: `src/pages/quiz/QuizPage.svelte`)
- Take assessment → Attempt results: redirects after submission (evidence: `src/pages/quiz/QuizPage.svelte`)
- User → Attempt results: views attempts (evidence: `README.md`)
- Attempt results → API request client: loads attempt results (evidence: `src/pages/results/ResultsPage.svelte`)
- Landing page → Site navigation: renders navigation (evidence: `src/pages/landing/LandingPage.svelte`)
- Profile onboarding → Site navigation: renders navigation (evidence: `src/pages/onboarding/OnboardingPage.svelte`)
- Role dashboard → Site navigation: renders navigation (evidence: `src/pages/home/Home.svelte`)
- Take assessment → Site navigation: renders navigation (evidence: `src/pages/quiz/QuizPage.svelte`)
- Attempt results → Site navigation: renders navigation (evidence: `src/pages/results/ResultsPage.svelte`)
- Site navigation → Backend API: checks session and logs out (evidence: `src/components/SiteHeader.svelte`)
- API request client → Backend API: sends API requests (evidence: `README.md`)
