# avgerinos8/zone01guides architecture

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

- Interactive diagram: https://gitdiagram.com/avgerinos8/zone01guides
- Repository: https://github.com/avgerinos8/zone01guides

## Overview

Guides01 is a static-hosted collection of Greek interactive lessons, powered by a browser slide-deck engine. Learners enter through the landing page, open a standalone lesson, navigate its slides, complete interactive exercises, and retain progress locally. Authors start from the lesson template and can generate a table of contents with the Go CLI. The README documents the engine’s features and the optional progress-notification add-on; sampled source confirms engine rendering and highlighting behavior. Other visualizers and the standalone Sudoku lesson are represented as documented product capabilities, though their page wiring was not inspected.

Main entry points: [`01-go-01.html`](https://github.com/avgerinos8/zone01guides/blob/main/01-go-01.html) (Standalone lessons), [`static/script.js`](https://github.com/avgerinos8/zone01guides/blob/main/static/script.js) (Slide deck engine), [`lessontemplate/sample.html`](https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/sample.html) (Lesson template), [`static/sudoku/sudoku-piscine9.js`](https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/sudoku-piscine9.js) (Sudoku lesson app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Lesson site"]
  node_landing["Lesson index<br/>[index.html]"]
  node_lesson["Standalone lessons<br/>[01-go-01.html]"]
end

subgraph group_engine["Deck engine"]
  node_deck["Slide deck engine<br/>[script.js]"]
  node_exercise["Quiz exercises<br/>[script.js]"]
  node_progress[("Progress state<br/>[script.js]")]
  node_highlighter["Code highlighter<br/>[highlighter.js]"]
  node_notifier["Progress notifier<br/>[notify-progress.js]"]
end

subgraph group_authoring["Lesson authoring"]
  node_template["Lesson template<br/>[sample.html]"]
  node_templateengine["Template engine<br/>[script.js]"]
  node_templatehighlight["Template highlighter<br/>[highlighter.js]"]
  node_toc["TOC generator<br/>[main.go]"]
end

subgraph group_interactive["Interactive extras"]
  node_visualizations["Code visualizations"]
  node_sudokuviz["Sudoku visualizer<br/>[viz-sudoku.js]"]
  node_sudokuapp["Sudoku lesson app<br/>[sudoku-piscine9.js]"]
  node_sudokureviews["Solver reviews<br/>[reviews.js]"]
  node_solver["Go solver examples<br/>[solve.go]"]
end

node_learner(("Learner"))
node_browser(("Browser"))
node_email(("Email service"))

node_learner -->|"opens"| node_landing
node_landing -->|"links to"| node_lesson
node_learner -->|"opens"| node_lesson
node_lesson -->|"uses engine"| node_deck
node_deck -->|"renders"| node_exercise
node_deck -->|"stores progress"| node_progress
node_deck -->|"highlights code"| node_highlighter
node_deck -.->|"hooks into"| node_notifier
node_notifier -->|"sends notices"| node_email
node_template -->|"uses engine"| node_templateengine
node_template -->|"uses highlighter"| node_templatehighlight
node_template -->|"starts lesson"| node_lesson
node_toc -->|"scans headings"| node_lesson
node_lesson -.->|"embeds"| node_visualizations
node_lesson -.->|"embeds"| node_sudokuviz
node_learner -.->|"uses"| node_sudokuapp
node_sudokuapp -.->|"shows examples"| node_solver
node_sudokuapp -.->|"shows reviews"| node_sudokureviews

click node_landing "https://github.com/avgerinos8/zone01guides/blob/main/index.html"
click node_lesson "https://github.com/avgerinos8/zone01guides/blob/main/01-go-01.html"
click node_deck "https://github.com/avgerinos8/zone01guides/blob/main/static/script.js"
click node_exercise "https://github.com/avgerinos8/zone01guides/blob/main/static/script.js"
click node_progress "https://github.com/avgerinos8/zone01guides/blob/main/static/script.js"
click node_highlighter "https://github.com/avgerinos8/zone01guides/blob/main/static/highlighter.js"
click node_notifier "https://github.com/avgerinos8/zone01guides/blob/main/static/notify-progress.js"
click node_template "https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/sample.html"
click node_templateengine "https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/script.js"
click node_templatehighlight "https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/highlighter.js"
click node_visualizations "https://github.com/avgerinos8/zone01guides/tree/main/static/vizJS"
click node_sudokuviz "https://github.com/avgerinos8/zone01guides/blob/main/static/vizJS/viz-sudoku.js"
click node_sudokuapp "https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/sudoku-piscine9.js"
click node_sudokureviews "https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/reviews.js"
click node_solver "https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/nicgkx/solve.go"
click node_toc "https://github.com/avgerinos8/zone01guides/blob/main/content-toc-go/main.go"

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_lesson,node_browser toneBlue
class node_deck,node_exercise,node_progress,node_highlighter,node_notifier toneAmber
class node_template,node_templateengine,node_templatehighlight,node_toc toneMint
class node_visualizations,node_sudokuviz,node_sudokuapp,node_sudokureviews,node_solver toneRose
class node_learner,node_email toneIndigo
```

## Components

### Lesson site

- [Lesson index](https://github.com/avgerinos8/zone01guides/blob/main/index.html): `index.html`
- [Standalone lessons](https://github.com/avgerinos8/zone01guides/blob/main/01-go-01.html): `01-go-01.html`

### Deck engine

- [Slide deck engine](https://github.com/avgerinos8/zone01guides/blob/main/static/script.js): `static/script.js`
- [Quiz exercises](https://github.com/avgerinos8/zone01guides/blob/main/static/script.js): `static/script.js`
- [Progress state](https://github.com/avgerinos8/zone01guides/blob/main/static/script.js): `static/script.js`
- [Code highlighter](https://github.com/avgerinos8/zone01guides/blob/main/static/highlighter.js): `static/highlighter.js`
- [Progress notifier](https://github.com/avgerinos8/zone01guides/blob/main/static/notify-progress.js): `static/notify-progress.js`

### Lesson authoring

- [Lesson template](https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/sample.html): `lessontemplate/sample.html`
- [Template engine](https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/script.js): `lessontemplate/script.js`
- [Template highlighter](https://github.com/avgerinos8/zone01guides/blob/main/lessontemplate/highlighter.js): `lessontemplate/highlighter.js`
- [TOC generator](https://github.com/avgerinos8/zone01guides/blob/main/content-toc-go/main.go): `content-toc-go/main.go`

### Interactive extras

- [Code visualizations](https://github.com/avgerinos8/zone01guides/tree/main/static/vizJS): `static/vizJS`
- [Sudoku visualizer](https://github.com/avgerinos8/zone01guides/blob/main/static/vizJS/viz-sudoku.js): `static/vizJS/viz-sudoku.js`
- [Sudoku lesson app](https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/sudoku-piscine9.js): `static/sudoku/sudoku-piscine9.js`
- [Solver reviews](https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/reviews.js): `static/sudoku/reviews.js`
- [Go solver examples](https://github.com/avgerinos8/zone01guides/blob/main/static/sudoku/nicgkx/solve.go): `static/sudoku/nicgkx/solve.go`

### Other components

- **Learner**
- **Browser**
- **Email service**

## Connections

- Learner → Lesson index: opens (evidence: `README.md`)
- Lesson index → Standalone lessons: links to (evidence: `README.md`)
- Learner → Standalone lessons: opens (evidence: `README.md`)
- Standalone lessons → Slide deck engine: uses engine (evidence: `README.md`)
- Slide deck engine → Quiz exercises: renders (evidence: `README.md`)
- Slide deck engine → Progress state: stores progress (evidence: `README.md`)
- Slide deck engine → Code highlighter: highlights code (evidence: `static/script.js`)
- Slide deck engine → Progress notifier: hooks into (evidence: `README.md`)
- Progress notifier → Email service: sends notices (evidence: `README.md`)
- Lesson template → Template engine: uses engine (evidence: `README.md`)
- Lesson template → Template highlighter: uses highlighter (evidence: `README.md`)
- Lesson template → Standalone lessons: starts lesson (evidence: `README.md`)
- TOC generator → Standalone lessons: scans headings (evidence: `README.md`)
- Standalone lessons → Code visualizations: embeds (evidence: `README.md`)
- Standalone lessons → Sudoku visualizer: embeds (evidence: `README.md`)
- Learner → Sudoku lesson app: uses (evidence: `README.md`)
- Sudoku lesson app → Go solver examples: shows examples (evidence: `static/sudoku/sudoku-piscine9.js`)
- Sudoku lesson app → Solver reviews: shows reviews (evidence: `README.md`)
