# gvayoy-web/logoskquiz architecture

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

- Interactive diagram: https://gitdiagram.com/gvayoy-web/logoskquiz
- Repository: https://github.com/gvayoy-web/logoskquiz

## Overview

LogosKQuiz is a web platform for running live Bible trivia: a moderator operates the game through a private control panel, while a public display presents questions, scores, and game effects. The Flask application handles game APIs and state; the display receives live updates using SSE, and the README documents question editing/import-export, scoring, timers, a roulette mode, Bible verse games, and audio sampling. Source excerpts are partial, so some feature links rely on README statements rather than inspected implementation.

Main entry points: [`app.py`](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py) (Flask game API), [`display.html`](https://github.com/gvayoy-web/logoskquiz/blob/main/display.html) (Live display), [`control.html`](https://github.com/gvayoy-web/logoskquiz/blob/main/control.html) (Control panel), [`quiz-renderer.js`](https://github.com/gvayoy-web/logoskquiz/blob/main/quiz-renderer.js) (Question renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Game interfaces"]
  node_control["Control panel<br/>[control.html]"]
  node_display["Live display<br/>[display.html]"]
  node_renderer["Question renderer<br/>[quiz-renderer.js]"]
  node_soundboard["Audio sampler<br/>[control.html]"]
end

subgraph group_runtime["Game runtime"]
  node_api["Flask game API<br/>[app.py]"]
  node_game_state["Game state<br/>[app.py]"]
  node_questions["Question bank<br/>[app.py]"]
  node_scores["Scoring<br/>[app.py]"]
  node_timers["Game timers<br/>[app.py]"]
  node_activity["Activity log<br/>[app.py]"]
  node_roulette["Roulette mode<br/>[display.html]"]
end

subgraph group_content["Bible content"]
  node_verses["Verse game<br/>[app.py]"]
  node_bible_data["Bible parser and data<br/>[biblia.py]"]
end

subgraph group_persistence["Persistence"]
  node_json_store[("Competition data<br/>[pym.json]")]
  node_backups[("Rotating backups")]
end

node_moderator(("Moderator"))
node_audience(("Audience"))

node_moderator -->|"operates"| node_control
node_control -->|"controls game"| node_api
node_api -->|"updates state"| node_game_state
node_api -->|"manages questions"| node_questions
node_api -->|"adjusts scores"| node_scores
node_api -->|"controls timers"| node_timers
node_api -->|"records events"| node_activity
node_api -->|"serves verse game"| node_verses
node_api -->|"uses parser"| node_bible_data
node_audience -->|"views"| node_display
node_api -->|"streams state"| node_display
node_display -->|"renders questions"| node_renderer
node_display -->|"shows roulette"| node_roulette
node_moderator -->|"launches audio"| node_soundboard
node_game_state -->|"persists atomically"| node_json_store
node_api -->|"rotates backups"| node_backups

click node_control "https://github.com/gvayoy-web/logoskquiz/blob/main/control.html"
click node_display "https://github.com/gvayoy-web/logoskquiz/blob/main/display.html"
click node_renderer "https://github.com/gvayoy-web/logoskquiz/blob/main/quiz-renderer.js"
click node_api "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_game_state "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_questions "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_scores "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_timers "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_activity "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_roulette "https://github.com/gvayoy-web/logoskquiz/blob/main/display.html"
click node_soundboard "https://github.com/gvayoy-web/logoskquiz/blob/main/control.html"
click node_verses "https://github.com/gvayoy-web/logoskquiz/blob/main/app.py"
click node_bible_data "https://github.com/gvayoy-web/logoskquiz/blob/main/biblia.py"
click node_json_store "https://github.com/gvayoy-web/logoskquiz/blob/main/pym.json"
click node_backups "https://github.com/gvayoy-web/logoskquiz/tree/main/backups"

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_control,node_display,node_renderer,node_soundboard toneBlue
class node_api,node_game_state,node_questions,node_scores,node_timers,node_activity,node_roulette toneAmber
class node_verses,node_bible_data toneMint
class node_json_store,node_backups toneRose
class node_moderator,node_audience toneIndigo
```

## Components

### Game interfaces

- [Control panel](https://github.com/gvayoy-web/logoskquiz/blob/main/control.html): `control.html`
- [Live display](https://github.com/gvayoy-web/logoskquiz/blob/main/display.html): `display.html`
- [Question renderer](https://github.com/gvayoy-web/logoskquiz/blob/main/quiz-renderer.js): `quiz-renderer.js`
- [Audio sampler](https://github.com/gvayoy-web/logoskquiz/blob/main/control.html): `control.html`

### Game runtime

- [Flask game API](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Game state](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Question bank](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Scoring](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Game timers](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Activity log](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Roulette mode](https://github.com/gvayoy-web/logoskquiz/blob/main/display.html): `display.html`

### Bible content

- [Verse game](https://github.com/gvayoy-web/logoskquiz/blob/main/app.py): `app.py`
- [Bible parser and data](https://github.com/gvayoy-web/logoskquiz/blob/main/biblia.py): `biblia.py`

### Persistence

- [Competition data](https://github.com/gvayoy-web/logoskquiz/blob/main/pym.json): `pym.json`
- [Rotating backups](https://github.com/gvayoy-web/logoskquiz/tree/main/backups): `backups`

### Other components

- **Moderator**
- **Audience**

## Connections

- Moderator → Control panel: operates (evidence: `README.md`)
- Control panel → Flask game API: controls game (evidence: `README.md`)
- Flask game API → Game state: updates state (evidence: `app.py`)
- Flask game API → Question bank: manages questions (evidence: `README.md`)
- Flask game API → Scoring: adjusts scores (evidence: `README.md`)
- Flask game API → Game timers: controls timers (evidence: `README.md`)
- Flask game API → Activity log: records events (evidence: `README.md`)
- Flask game API → Verse game: serves verse game (evidence: `app.py`)
- Flask game API → Bible parser and data: uses parser (evidence: `app.py`)
- Audience → Live display: views (evidence: `README.md`)
- Flask game API → Live display: streams state (evidence: `README.md`)
- Live display → Question renderer: renders questions (evidence: `quiz-renderer.js`)
- Live display → Roulette mode: shows roulette (evidence: `README.md`)
- Moderator → Audio sampler: launches audio (evidence: `README.md`)
- Game state → Competition data: persists atomically (evidence: `README.md`)
- Flask game API → Rotating backups: rotates backups (evidence: `README.md`)
