# idikuterke/gokturkce_kursu architecture

> Architecture diagram of the GitHub repository idikuterke/gokturkce_kursu, 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/idikuterke/gokturkce_kursu
- Repository: https://github.com/idikuterke/gokturkce_kursu

## Overview

This repository produces a Göktürkçe reading-and-writing course from structured JSON content, validates it, and renders print and presentation materials. The main workflow is content authoring → validation → target-specific rendering → optional course packaging and learner-result reporting. The README documents additional course materials, corpus-backed text references, an offline result queue, and the results service. Some subsystem links are based on README statements because their implementations were not excerpted; legacy Python authoring modules are identified as retired rather than treated as the active pipeline.

Main entry points: [`engine/kapi.mjs`](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/kapi.mjs) (Content safety gate), [`engine/build.mjs`](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/build.mjs) (Build coordinator), [`engine/render-slayt.mjs`](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs) (GKTracker), [`content`](https://github.com/idikuterke/gokturkce_kursu/tree/master/content) (Course documents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Course content"]
  node_content_json["Course documents"]
  node_tamgas["Tamga inventory<br/>[tamgalar.json]"]
  node_dictionary["Gold dictionary<br/>[sozluk.json]"]
  node_corpora[("Text corpora")]
  node_orhun_corpus[("Orhun corpus<br/>[orhun-db-v1.json]")]
  node_schema["Content schema"]
  node_legacy["Retired Python content"]
end

subgraph group_engine["Validation and rendering"]
  node_gate["Content safety gate<br/>[kapi.mjs]"]
  node_build["Build coordinator<br/>[build.mjs]"]
  node_print["Print renderer<br/>[render-baski.mjs]"]
  node_slides["Slide renderer<br/>[render-slayt.mjs]"]
end

subgraph group_delivery["Course delivery"]
  node_pdfs["Print PDFs"]
  node_slide_files["Slide materials"]
  node_package["Course package<br/>[paket.mjs]"]
  node_pwa["PWA generator<br/>[pwa-uret.mjs]"]
  node_learner_course["Packaged course"]
end

subgraph group_results["Learner results"]
  node_tracker["GKTracker<br/>[render-slayt.mjs]"]
  node_offline_queue["Offline result queue<br/>[render-slayt.mjs]"]
  node_result_server["Result server<br/>[sonuc-sunucu.mjs]"]
  node_result_store[("Results log")]
  node_result_exports["Instructor results<br/>[sonuc-sunucu.mjs]"]
end

node_learner(("Learner"))
node_instructor(("Instructor"))

node_instructor -->|"edits"| node_content_json
node_legacy -->|"migrated into"| node_content_json
node_content_json -->|"validates"| node_gate
node_schema -->|"validates against"| node_gate
node_tamgas -->|"checks glyphs"| node_gate
node_dictionary -->|"checks spellings"| node_gate
node_corpora -->|"checks references"| node_gate
node_orhun_corpus -->|"checks references"| node_gate
node_build -->|"runs validation"| node_gate
node_build -->|"renders print"| node_print
node_build -->|"renders slides"| node_slides
node_print -->|"produces"| node_pdfs
node_slides -->|"produces"| node_slide_files
node_slide_files -->|"packages"| node_package
node_package -->|"assembles"| node_learner_course
node_pwa -.->|"generates"| node_learner_course
node_learner -->|"uses"| node_learner_course
node_learner -->|"answers quiz"| node_tracker
node_tracker -->|"queues offline"| node_offline_queue
node_offline_queue -->|"retries POST"| node_result_server
node_tracker -->|"submits results"| node_result_server
node_result_server -->|"appends results"| node_result_store
node_instructor -->|"views or exports"| node_result_exports
node_result_exports -.->|"reads results"| node_result_store

click node_content_json "https://github.com/idikuterke/gokturkce_kursu/tree/master/content"
click node_tamgas "https://github.com/idikuterke/gokturkce_kursu/blob/master/content/tamgalar.json"
click node_dictionary "https://github.com/idikuterke/gokturkce_kursu/blob/master/content/sozluk.json"
click node_corpora "https://github.com/idikuterke/gokturkce_kursu/blob/master/00_Kaynaklar/irk-bitig-db-v3.json"
click node_orhun_corpus "https://github.com/idikuterke/gokturkce_kursu/blob/master/05_Kaynak_DB/orhun-db-v1.json"
click node_schema "https://github.com/idikuterke/gokturkce_kursu/blob/master/schema/content.schema.json"
click node_legacy "https://github.com/idikuterke/gokturkce_kursu/tree/master/03_Tasarim"
click node_gate "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/kapi.mjs"
click node_build "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/build.mjs"
click node_print "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-baski.mjs"
click node_slides "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs"
click node_pdfs "https://github.com/idikuterke/gokturkce_kursu/tree/master/04_PDF"
click node_slide_files "https://github.com/idikuterke/gokturkce_kursu/tree/master/build/slayt"
click node_package "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/paket.mjs"
click node_pwa "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/pwa-uret.mjs"
click node_learner_course "https://github.com/idikuterke/gokturkce_kursu/tree/master/build/paket"
click node_tracker "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs"
click node_offline_queue "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs"
click node_result_server "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/sonuc-sunucu.mjs"
click node_result_exports "https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/sonuc-sunucu.mjs"

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_content_json,node_tamgas,node_dictionary,node_corpora,node_orhun_corpus,node_schema,node_legacy toneBlue
class node_gate,node_build,node_print,node_slides toneAmber
class node_pdfs,node_slide_files,node_package,node_pwa,node_learner_course toneMint
class node_tracker,node_offline_queue,node_result_server,node_result_store,node_result_exports toneRose
class node_learner,node_instructor toneIndigo
```

## Components

### Course content

- [Course documents](https://github.com/idikuterke/gokturkce_kursu/tree/master/content): `content`
- [Tamga inventory](https://github.com/idikuterke/gokturkce_kursu/blob/master/content/tamgalar.json): `content/tamgalar.json`
- [Gold dictionary](https://github.com/idikuterke/gokturkce_kursu/blob/master/content/sozluk.json): `content/sozluk.json`
- [Text corpora](https://github.com/idikuterke/gokturkce_kursu/blob/master/00_Kaynaklar/irk-bitig-db-v3.json): `00_Kaynaklar/irk-bitig-db-v3.json`
- [Orhun corpus](https://github.com/idikuterke/gokturkce_kursu/blob/master/05_Kaynak_DB/orhun-db-v1.json): `05_Kaynak_DB/orhun-db-v1.json`
- [Content schema](https://github.com/idikuterke/gokturkce_kursu/blob/master/schema/content.schema.json): `schema/content.schema.json`
- [Retired Python content](https://github.com/idikuterke/gokturkce_kursu/tree/master/03_Tasarim): `03_Tasarim`

### Validation and rendering

- [Content safety gate](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/kapi.mjs): `engine/kapi.mjs`
- [Build coordinator](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/build.mjs): `engine/build.mjs`
- [Print renderer](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-baski.mjs): `engine/render-baski.mjs`
- [Slide renderer](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs): `engine/render-slayt.mjs`

### Course delivery

- [Print PDFs](https://github.com/idikuterke/gokturkce_kursu/tree/master/04_PDF): `04_PDF`
- [Slide materials](https://github.com/idikuterke/gokturkce_kursu/tree/master/build/slayt): `build/slayt`
- [Course package](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/paket.mjs): `engine/paket.mjs`
- [PWA generator](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/pwa-uret.mjs): `engine/pwa-uret.mjs`
- [Packaged course](https://github.com/idikuterke/gokturkce_kursu/tree/master/build/paket): `build/paket`

### Learner results

- [GKTracker](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs): `engine/render-slayt.mjs`
- [Offline result queue](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/render-slayt.mjs): `engine/render-slayt.mjs`
- [Result server](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/sonuc-sunucu.mjs): `engine/sonuc-sunucu.mjs`
- **Results log**
- [Instructor results](https://github.com/idikuterke/gokturkce_kursu/blob/master/engine/sonuc-sunucu.mjs): `engine/sonuc-sunucu.mjs`

### Other components

- **Learner**
- **Instructor**

## Connections

- Instructor → Course documents: edits (evidence: `README.md`)
- Retired Python content → Course documents: migrated into (evidence: `README.md`)
- Course documents → Content safety gate: validates
- Content schema → Content safety gate: validates against (evidence: `engine/kapi.mjs`)
- Tamga inventory → Content safety gate: checks glyphs (evidence: `README.md`)
- Gold dictionary → Content safety gate: checks spellings (evidence: `README.md`)
- Text corpora → Content safety gate: checks references (evidence: `engine/kapi.mjs`)
- Orhun corpus → Content safety gate: checks references (evidence: `engine/kapi.mjs`)
- Build coordinator → Content safety gate: runs validation (evidence: `engine/build.mjs`)
- Build coordinator → Print renderer: renders print (evidence: `engine/build.mjs`)
- Build coordinator → Slide renderer: renders slides (evidence: `engine/build.mjs`)
- Print renderer → Print PDFs: produces (evidence: `README.md`)
- Slide renderer → Slide materials: produces (evidence: `README.md`)
- Slide materials → Course package: packages (evidence: `README.md`)
- Course package → Packaged course: assembles (evidence: `README.md`)
- PWA generator → Packaged course: generates
- Learner → Packaged course: uses (evidence: `README.md`)
- Learner → GKTracker: answers quiz (evidence: `README.md`)
- GKTracker → Offline result queue: queues offline (evidence: `README.md`)
- Offline result queue → Result server: retries POST (evidence: `README.md`)
- GKTracker → Result server: submits results (evidence: `README.md`)
- Result server → Results log: appends results (evidence: `README.md`)
- Instructor → Instructor results: views or exports (evidence: `README.md`)
- Instructor results → Results log: reads results
