🦉 LingoBright Docs

LingoBright — Interactive Language & Exam Platform Docs

Live at https://language.outxet.dev (Cloudflare Worker + D1) & local FastAPI — teaching Basic (A0 / JLPT N5) → Super Advanced (C2 / N1) across 10 languages & 17 packs (incl. IELTS, TOEIC, TESOL, JLPT, Polish).

11 Drag-Drop Engines FastAPI + Cloudflare Worker / D1 IELTS · TOEIC · TESOL · JLPT · Polish Zero-Build ES6+ UI Markdown Hub (README.md)

Documentation Navigation Flow

Open README.md
flowchart LR
    Portal["docs/index.html + README.md"] --> HLD["01-hld/ - Context, Architecture, Flows"]
    Portal --> FRS["02-frs/ - Tracks, 11 Exercises, Estimator"]
    Portal --> Tech["03-tech/ - Stack, Repo Tree, Python/JS"]
    Portal --> Data["04-data/ - ERD, 11 Schemas, Functions and API"]
        

01 · High-Level Design (HLD)

System context, component architecture, Playful vs. Exam Focus modes, Pointer-Event drag FSM, sequence flows.

overview.md architecture.md flows.md

02 · Functional Specs (FRS)

Basic → C2 & JLPT N5–N1 ladders, IELTS/TOEIC/TESOL tracks, 11 exercise matrix, readiness estimator & NFRs.

tracks-and-modes.md exercises-matrix.md gamification-studio-nfr.md

03 · Tech Stack & Code Plan

FastAPI + SQLAlchemy + Zero-Node ES6+ rationale, repository tree, Python scripts & 11 JS renderers.

tech-stack.md repo-tree.md python-and-frontend.md

04 · Data Model & Functions

Mermaid ERD, 16 tables, 11 polymorphic exercise JSON schemas, Python function specs & REST /api/v1 endpoints.

erd-and-tables.md exercise-schemas.md functions-and-api.md

4-Phase Implementation Status

PhaseScopeStatus & Key Outputs
Phase 1Backend Core & Engines✅ Complete — app/core, app/models (16 tables), app/schemas, 11-type grader.py, placement_engine.py, score_estimator.py, CLI scripts
Phase 2Services, API & Packs✅ Complete — app/services, /api/v1 (21 API + 8 UI routes), 17 starter YAML packs across 10 languages (en/ja/zh-Hans/ko/fr/es/de/ar/vi/pl)
Phase 3Bright Interactive UI✅ Complete — 8 UI views, CSS3 tokens, drag_engine.js, sfx_synth.js, audio_engine.js, 11 renderers/*.js + _board_helpers.js, /studio, /parent
Phase 4Cloudflare Edge & QA✅ Complete — export_d1_sql.py, sync_worker_assets.py, Hono Worker + D1 live at https://language.outxet.dev, pytest, vitest, ruff & Chrome verified

Changelog

VersionDateSummary of Changes
v1.2.02026-11-22Added live Cloudflare Worker + Hono + D1 deployment (https://language.outxet.dev), Polish pack (pl-complete-ladder), D1 migration/asset sync scripts, and live /docs-portal/ hosting.
v1.1.02026-11-15Updated build status to Implemented & Verified across all 4 phases; synced helper JS modules (_board_helpers.js, renderers/index.js) and live route counts.
v1.0.02026-11-15Initial visual HTML documentation portal with Mermaid v10 diagrams.