🦉 LingoBright Docs

02 · Functional Requirements Specification (FRS)

Complete Basic (A0/N5) to Super-Advanced (C2/N1) ladders, IELTS, TOEIC, TESOL & 11 interactive drag-and-drop exercise archetypes.

Basic → Super Advanced Ladder & Exam Mapping

Open tracks-and-modes.md
flowchart LR
    A0["A0 Starter / Phonics"] --> A1["A1 / JLPT N5 / HSK 1"]
    A1 --> A2["A2 / JLPT N4 / HSK 2"]
    A2 --> B1["B1 / JLPT N3 / IELTS 4.5-5.5 / TOEIC 300-550"]
    B1 --> B2["B2 / JLPT N2 / IELTS 6.0-7.0 / TOEIC 550-780"]
    B2 --> C1["C1 / JLPT N1 / IELTS 7.5-8.5 / TOEIC 785-945"]
    C1 --> C2["C2 / Mastery / IELTS 9.0 / TOEIC 990 / TESOL Master"]
        
LanguageCodeDirectionStarter Tiers & Exam Ladders
EnglishenLTR + IPAGeneral A0–C2 · IELTS (4.5–9.0) · TOEIC (300–990) · TESOL
JapanesejaLTR + RubyJLPT N5 → N4 → N3 → N2 → N1 (Kana, Kanji radicals, Keigo, Literary)
Mandarin Chinesezh-HansLTR + PinyinHSK 1 → HSK 6+ (Tones, Measure words, Chengyu idioms)
KoreankoLTRTOPIK I (1–2) → TOPIK II (3–6) (Hangul, Honorifics, Formal)
French / Spanish / Germanfr / es / deLTRDELF/DALF · DELE · Goethe A1–C2
ArabicarRTL (<bdi>)MSA A1–C2 (Voweled starter → Unvoweled media/academic)
VietnameseviLTR + 6 TonesComplete A1–C2 (Tonal minimal pairs → Formal/Literary)
PolishplLTR + DiacriticsComplete A1–C1 (Nasals/Gender sort → Cases & Formal discourse)

All 11 Tactile Drag-and-Drop Exercise Types

Open exercises-matrix.md
flowchart LR
    Load["Prompt + Multi-Accent Audio"] --> Input["Drag Tile / Tap-to-Place / Keyboard"]
    Input --> Sound["Tile Pronunciation + Pop SFX"]
    Input --> Submit["Submit Payload"]
    Submit --> Grade{"Valid?"}
    Grade -->|"Yes"| Good["Mint Sparkle + Band/Nx Breakdown Drawer"]
    Grade -->|"No"| Retry["Soft Boop + Hint / Dim Distractors"]
    Retry --> Input
        
IDTypeBasic / Kid UsageIELTS · TOEIC · TESOL · JLPT N2–N1 Usage
FR-301picture_matchDrag words onto animal/food cardsTOEIC Part 1 photo descriptions · IELTS Task 1 map/diagram labels
FR-302sentence_builder3–5 word tiles (LTR/RTL/CJK)JLPT N2/N1 ★ ordering · IELTS Band 8 inversion/cleft clauses
FR-303category_sortSort Animals vs FruitsIELTS True/False/Not Given · Casual vs Keigo · TESOL PPP vs ESA
FR-304match_pairsSnap word ↔ meaning/emojiAcademic collocations · C2/Band 9 synonyms · Kanji ↔ readings
FR-305fill_blank_drag1-line story gap-fillTOEIC Parts 5–6 traps · JLPT N3–N1 connectors · IELTS summary cloze
FR-306listen_and_arrangePhonics / Kana / Hangul blocksIELTS/TOEIC fast-speech phrase reconstruction
FR-307tap_hear_exploreTap & flip picture flashcardsKanji radical/etymology cards · Band 9 frames · TESOL IPA cards
FR-308reading_passage_drag3-line story comprehensionSplit-pane IELTS Academic / TOEIC memo / JLPT N1 reading + proof highlight
FR-309essay_architectFirst / Next / Last story flowIELTS Task 2 essay · TOEIC email · TESOL PPP/ESA lesson plan sequencing
FR-310error_spotterTap & fix simple wrong wordSentence surgery: tap TOEIC/N1 trap & drag Band 8 fix tile on top
FR-311listening_labMatch speaker to pictureMulti-accent audio (US/GB/AU) + drag-drop form completion + transcript

Gamification, Estimator & NFRs

Open gamification-studio-nfr.md
flowchart LR
    Attempt["Exercise Attempt"] --> SRS["SM-2 SRS Update"]
    Attempt --> XP["XP + Combo + Streak"]
    Done["Lesson Complete"] --> Stars["1-3 Stars and Stickers"]
    Done --> Est["Exam Readiness Estimator"]
    Est --> Out["IELTS Band | TOEIC 300-990 | JLPT N5-N1 | TESOL"]
        

Changelog

VersionDateSummary of Changes
v1.2.02026-11-22Added Polish (pl) Complete A1–C1 track (10 languages / 17 packs) and Cloudflare Worker/D1 serverless NFR parity.
v1.1.02026-11-15Synced FRS markdowns & HTML tables with built 9-language starter packs (de, ar RTL, vi), content/stickers.yaml titles, and open_access toggle behavior.
v1.0.02026-11-15Initial FRS visual specification portal.