Kartuli Docs

Appearance

Roadmap ​

Status: planned specification. This page describes the target product; some elements already exist. See the current implementation inventory for shipped routes, architecture and known gaps. Do not treat this specification as evidence that all described behavior is implemented.

This document owns the current MVP scope for the game client.

It should answer one question clearly: what is the target MVP scope?

This document defines scope only. The detailed behavior of included screens belongs in the screen docs. Current sequencing and PR strategy live in the Delivery plan.

Current target: MVP ​

Product loop ​

The MVP learning loop is:

Explore -> Study (optional) -> Play -> repeat

Localization and routing ​

  • English (en) is the default locale.
  • Russian (ru) is also supported.
  • The root route / redirects to the localized Explore entry using preferred locale resolution.
  • Included routes are localized.
  • Included routes have localized metadata.

Recovery ​

  • The MVP includes a global not-found page for invalid URLs.
  • The MVP includes a Study resource unavailable state for valid Study routes that cannot load their lesson or module review.
  • The MVP includes a Play resource unavailable state for valid Play routes that cannot load their lesson or module review.

Learning content ​

  • 1 alphabet module with multiple lessons
  • 1 vocabulary module with multiple lessons
  • lesson sets
  • module review sets

Explore ​

  • Explore is the top-level learning entry.
  • Explore lets the student choose between Alphabet and Vocabulary.
  • Explore in MVP is curated, not personalized.

Browse ​

  • The MVP includes Browse routes for alphabet and vocabulary.
  • Each Browse route lists authored lessons for its module.
  • Each Browse route also includes one Full review entry for the whole module.
  • Selecting a lesson or Full review exposes the next available actions: Study and Play.

Study ​

  • Study is available for lessons and module review sets.
  • Study is optional. It is a preview step before Play, not a requirement.
  • Study includes:
    • a summary of all items in the selected set
    • an item detail view
    • navigation between summary and detail
    • a persistent way to start Play

Play ​

  • Play is available for lessons and module review sets.
  • Play includes:
    • lobby
    • round loop
    • results
    • mistakes review for failed items
  • MVP gameplay uses one minigame type: single-choice.
  • Included alphabet round variants:
    • question: Georgian letter, answers: transliteration
    • question: transliteration, answers: Georgian letter
  • Included vocabulary round variants:
    • question: Georgian word, answers: student-language translation
    • question: student-language translation, answers: Georgian word
  • Results focus on reviewing failed items and choosing the next step.

Translit ​

  • The MVP includes the Translit utility.
  • Translit supports:
    • editable source text
    • live transliteration output
    • direction switch between Georgian and Latin
    • output copy
    • token-level inspection

Settings ​

  • The MVP includes the Settings utility.
  • Settings supports language selection.

Post-MVP candidates ​

  • grammar content family
  • more single-choice variants
  • more minigame types
  • mastery tracking derived from activity
  • recommendation mode based on activity
  • search
  • favorites
  • custom lessons
  • account experience
  • seasonal lessons
  • offline mode
  • additional supported languages