How idikuterke/gokturkce_kursu works
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: kapi.mjs Content safety gate · build.mjs Build coordinator · render-slayt.mjs GKTracker · content Course documents
Components 23
Course content
- Course documents
content - Tamga inventory
content/tamgalar.json - Gold dictionary
content/sozluk.json - Text corpora
00_Kaynaklar/irk-bitig-db-v3.json - Orhun corpus
05_Kaynak_DB/orhun-db-v1.json - Content schema
schema/content.schema.json - Retired Python content
03_Tasarim
Validation and rendering
- Content safety gate
engine/kapi.mjs - Build coordinator
engine/build.mjs - Print renderer
engine/render-baski.mjs - Slide renderer
engine/render-slayt.mjs
Course delivery
- Print PDFs
04_PDF - Slide materials
build/slayt - Course package
engine/paket.mjs - PWA generator
engine/pwa-uret.mjs - Packaged course
build/paket
Learner results
- GKTracker
engine/render-slayt.mjs - Offline result queue
engine/render-slayt.mjs - Result server
engine/sonuc-sunucu.mjs - Results log
- Instructor results
engine/sonuc-sunucu.mjs
Other components
- Learner
- Instructor
Connections 24
- Instructor → Course documents: edits
README.md - Retired Python content → Course documents: migrated into
README.md - Course documents → Content safety gate: validates
- Content schema → Content safety gate: validates against
engine/kapi.mjs - Tamga inventory → Content safety gate: checks glyphs
README.md - Gold dictionary → Content safety gate: checks spellings
README.md - Text corpora → Content safety gate: checks references
engine/kapi.mjs - Orhun corpus → Content safety gate: checks references
engine/kapi.mjs - Build coordinator → Content safety gate: runs validation
engine/build.mjs - Build coordinator → Print renderer: renders print
engine/build.mjs - Build coordinator → Slide renderer: renders slides
engine/build.mjs - Print renderer → Print PDFs: produces
README.md - Slide renderer → Slide materials: produces
README.md - Slide materials → Course package: packages
README.md - Course package → Packaged course: assembles
README.md - PWA generator → Packaged course: generates
- Learner → Packaged course: uses
README.md - Learner → GKTracker: answers quiz
README.md - GKTracker → Offline result queue: queues offline
README.md - Offline result queue → Result server: retries POST
README.md - GKTracker → Result server: submits results
README.md - Result server → Results log: appends results
README.md - Instructor → Instructor results: views or exports
README.md - Instructor results → Results log: reads results