# ansbeno/ng-quiz architecture

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

- Interactive diagram: https://gitdiagram.com/ansbeno/ng-quiz
- Repository: https://github.com/ansbeno/ng-quiz

## Overview

NgQuiz is an Angular quiz-practice application. Users choose a built-in or imported quiz, configure practice settings, answer questions, and view results or review answers. The graph preserves the import/validation path, quiz catalog and bundled content, session state, scoring, and shared answer-option UI. Some feature components are named in the SOURCE INDEX but their implementations were not excerpted, so links involving their runtime behavior are shown as unverified rather than asserted as confirmed calls.

Main entry points: [`src/app/core/models/quiz.models.ts`](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/models/quiz.models.ts) (Quiz models), [`src/app/app.routes.ts`](https://github.com/ansbeno/ng-quiz/blob/master/src/app/app.routes.ts) (App routes), [`src/app/core/services/quiz.service.ts`](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz.service.ts) (Quiz catalog service), [`src/app/core/services/quiz-session.service.ts`](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-session.service.ts) (Session state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Quiz experience"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_catalog["Quiz list"]
  node_import_ui["Quiz import"]
  node_player["Quiz player"]
  node_results["Quiz results"]
  node_review["Answer review"]
end

subgraph group_domain["Quiz domain"]
  node_quiz_service["Quiz catalog service<br/>[quiz.service.ts]"]
  node_session["Session state"]
  node_scoring["Scoring service"]
  node_parser["Quiz parser"]
  node_validator["Quiz validator"]
  node_models["Quiz models<br/>[quiz.models.ts]"]
end

subgraph group_content["Quiz content"]
  node_built_quiz["CSA practice quiz"]
  node_practice_exam["CSA practice exam"]
end

subgraph group_presentation["Shared presentation"]
  node_options["Option list"]
end

node_user(("Quiz taker"))

node_user -.->|"opens app"| node_routes
node_routes -->|"loads route"| node_catalog
node_routes -->|"loads route"| node_player
node_routes -->|"loads route"| node_results
node_routes -->|"loads route"| node_review
node_catalog -->|"reads quizzes"| node_quiz_service
node_catalog -->|"starts session"| node_session
node_catalog -->|"renders import"| node_import_ui
node_import_ui -->|"parses input"| node_parser
node_import_ui -->|"adds quiz"| node_quiz_service
node_parser -->|"validates quiz"| node_validator
node_quiz_service -->|"loads definition"| node_built_quiz
node_quiz_service -->|"loads definition"| node_practice_exam
node_player -.->|"uses session"| node_session
node_player -.->|"uses scoring"| node_scoring
node_player -.->|"renders options"| node_options
node_results -.->|"reads session"| node_session
node_results -.->|"summarizes session"| node_scoring
node_review -.->|"reads session"| node_session
node_review -.->|"uses scoring"| node_scoring
node_review -.->|"renders options"| node_options
node_options -->|"gets option state"| node_scoring
node_parser -->|"creates quiz"| node_models
node_session -->|"stores session"| node_models
node_scoring -->|"scores answers"| node_models
node_quiz_service -->|"holds quiz data"| node_models
node_built_quiz -->|"defines quiz"| node_models
node_practice_exam -->|"defines quiz"| node_models

click node_routes "https://github.com/ansbeno/ng-quiz/blob/master/src/app/app.routes.ts"
click node_catalog "https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-list/quiz-list.component.ts"
click node_import_ui "https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-import/quiz-import.component.ts"
click node_player "https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-player/quiz-player.component.ts"
click node_results "https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-results/quiz-results.component.ts"
click node_review "https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-review/quiz-review.component.ts"
click node_quiz_service "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz.service.ts"
click node_session "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-session.service.ts"
click node_scoring "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-scoring.service.ts"
click node_parser "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-parser.service.ts"
click node_validator "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-validator.service.ts"
click node_models "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/models/quiz.models.ts"
click node_built_quiz "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/data/servicenow-csa-quiz.ts"
click node_practice_exam "https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/data/servicenow-csa-practice-exam.ts"
click node_options "https://github.com/ansbeno/ng-quiz/blob/master/src/app/shared/components/option-list.component.ts"

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_routes,node_catalog,node_import_ui,node_player,node_results,node_review toneBlue
class node_quiz_service,node_session,node_scoring,node_parser,node_validator,node_models toneAmber
class node_built_quiz,node_practice_exam toneMint
class node_options toneRose
class node_user toneIndigo
```

## Components

### Quiz experience

- [App routes](https://github.com/ansbeno/ng-quiz/blob/master/src/app/app.routes.ts): `src/app/app.routes.ts`
- [Quiz list](https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-list/quiz-list.component.ts): `src/app/features/quiz-list/quiz-list.component.ts`
- [Quiz import](https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-import/quiz-import.component.ts): `src/app/features/quiz-import/quiz-import.component.ts`
- [Quiz player](https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-player/quiz-player.component.ts): `src/app/features/quiz-player/quiz-player.component.ts`
- [Quiz results](https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-results/quiz-results.component.ts): `src/app/features/quiz-results/quiz-results.component.ts`
- [Answer review](https://github.com/ansbeno/ng-quiz/blob/master/src/app/features/quiz-review/quiz-review.component.ts): `src/app/features/quiz-review/quiz-review.component.ts`

### Quiz domain

- [Quiz catalog service](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz.service.ts): `src/app/core/services/quiz.service.ts`
- [Session state](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-session.service.ts): `src/app/core/services/quiz-session.service.ts`
- [Scoring service](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-scoring.service.ts): `src/app/core/services/quiz-scoring.service.ts`
- [Quiz parser](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-parser.service.ts): `src/app/core/services/quiz-parser.service.ts`
- [Quiz validator](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/services/quiz-validator.service.ts): `src/app/core/services/quiz-validator.service.ts`
- [Quiz models](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/models/quiz.models.ts): `src/app/core/models/quiz.models.ts`

### Quiz content

- [CSA practice quiz](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/data/servicenow-csa-quiz.ts): `src/app/core/data/servicenow-csa-quiz.ts`
- [CSA practice exam](https://github.com/ansbeno/ng-quiz/blob/master/src/app/core/data/servicenow-csa-practice-exam.ts): `src/app/core/data/servicenow-csa-practice-exam.ts`

### Shared presentation

- [Option list](https://github.com/ansbeno/ng-quiz/blob/master/src/app/shared/components/option-list.component.ts): `src/app/shared/components/option-list.component.ts`

### Other components

- **Quiz taker**

## Connections

- Quiz taker → App routes: opens app
- App routes → Quiz list: loads route (evidence: `src/app/app.routes.ts`)
- App routes → Quiz player: loads route (evidence: `src/app/app.routes.ts`)
- App routes → Quiz results: loads route (evidence: `src/app/app.routes.ts`)
- App routes → Answer review: loads route (evidence: `src/app/app.routes.ts`)
- Quiz list → Quiz catalog service: reads quizzes (evidence: `src/app/features/quiz-list/quiz-list.component.ts`)
- Quiz list → Session state: starts session (evidence: `src/app/features/quiz-list/quiz-list.component.ts`)
- Quiz list → Quiz import: renders import (evidence: `src/app/features/quiz-list/quiz-list.component.ts`)
- Quiz import → Quiz parser: parses input (evidence: `src/app/features/quiz-import/quiz-import.component.ts`)
- Quiz import → Quiz catalog service: adds quiz (evidence: `src/app/features/quiz-import/quiz-import.component.ts`)
- Quiz parser → Quiz validator: validates quiz (evidence: `src/app/core/services/quiz-parser.service.ts`)
- Quiz catalog service → CSA practice quiz: loads definition (evidence: `src/app/core/services/quiz.service.ts`)
- Quiz catalog service → CSA practice exam: loads definition (evidence: `src/app/core/services/quiz.service.ts`)
- Quiz player → Session state: uses session (evidence: `src/app/features/quiz-player/quiz-player.component.ts`)
- Quiz player → Scoring service: uses scoring (evidence: `src/app/features/quiz-player/quiz-player.component.ts`)
- Quiz player → Option list: renders options (evidence: `src/app/features/quiz-player/quiz-player.component.ts`)
- Quiz results → Session state: reads session (evidence: `src/app/features/quiz-results/quiz-results.component.ts`)
- Quiz results → Scoring service: summarizes session (evidence: `src/app/features/quiz-results/quiz-results.component.ts`)
- Answer review → Session state: reads session (evidence: `src/app/features/quiz-review/quiz-review.component.ts`)
- Answer review → Scoring service: uses scoring (evidence: `src/app/features/quiz-review/quiz-review.component.ts`)
- Answer review → Option list: renders options (evidence: `src/app/features/quiz-review/quiz-review.component.ts`)
- Option list → Scoring service: gets option state (evidence: `src/app/shared/components/option-list.component.ts`)
- Quiz parser → Quiz models: creates quiz (evidence: `src/app/core/services/quiz-parser.service.ts`)
- Session state → Quiz models: stores session (evidence: `src/app/core/services/quiz-session.service.ts`)
- Scoring service → Quiz models: scores answers (evidence: `src/app/core/services/quiz-scoring.service.ts`)
- Quiz catalog service → Quiz models: holds quiz data (evidence: `src/app/core/services/quiz.service.ts`)
- CSA practice quiz → Quiz models: defines quiz (evidence: `src/app/core/data/servicenow-csa-quiz.ts`)
- CSA practice exam → Quiz models: defines quiz (evidence: `src/app/core/data/servicenow-csa-practice-exam.ts`)
