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
| Phase | Scope | Status & Key Outputs |
|---|---|---|
| Phase 1 | Backend Core & Engines | ✅ Complete — app/core, app/models (16 tables), app/schemas, 11-type grader.py, placement_engine.py, score_estimator.py, CLI scripts |
| Phase 2 | Services, 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 3 | Bright 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 4 | Cloudflare 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
| Version | Date | Summary of Changes |
|---|---|---|
| v1.2.0 | 2026-11-22 | Added 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.0 | 2026-11-15 | Updated 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.0 | 2026-11-15 | Initial visual HTML documentation portal with Mermaid v10 diagrams. |