Training Zone (skilllab)
Web học và luyện ngoại ngữ có chấm điểm, nhận xét, gợi ý và phân tích tiến độ.
Ngữ cảnh và quyết định dự án: CLAUDE.md. Lộ trình: ROADMAP.md. Quy trình pull/gộp/Supabase/Vercel: docs/quy-trinh-lam-viec.md.
Chạy trên máy
npm install
cp .env.example .env.local # điền khóa Supabase/Gemini (chưa cần cho bản demo bài tập)
npm run dev # http://localhost:4000
Kiểm tra trước khi đẩy code: npm run check:content, npm test (kiểm thử hàm thuần: lịch ôn, chuỗi ngày, tổng hợp tiến độ), npm run lint và npm run build.
Thêm bài tập
Mỗi chuyên đề một tệp src/content/exercises/en/<id-chuyên-đề>.json, là mảng câu (xem src/content/exercises/en/subjunctive.json làm mẫu, có đủ choiceExplanations). Quy tắc soạn: docs/chuan-noi-dung.md. Mỗi câu cần: id duy nhất, usageId trùng một mục usages[].id của chuyên đề (để có link "Xem lại lý thuyết"), choices, correctIndex, explanation và nên có choiceExplanations (giải thích riêng từng đáp án). Chạy npm run check:content để bắt lỗi trước khi đẩy.
Cấu trúc
src/app/ trang: / trang chủ, /hoc danh sách chuyên đề, /hoc/[topic] lý thuyết, /hoc/[topic]/luyen-tap luyện tập (10 câu mỗi lượt, dễ → khó; ?tag=<mã mục> luyện lại một mục), /hoc/[topic]/nhuc-dau chế độ Nhức đầu (10 câu khó nhất), /tien-do tiến độ và các mục cần ôn lại, /on-tap ôn tập bằng thẻ lật 3Dsrc/content/grammar/<ngôn ngữ>/ lý thuyết từng chuyên đề (JSON) + index.json; src/content/exercises/<ngôn ngữ>/<chuyên đề>.json bài tậpscripts/validate-content.mjs kiểm tra nội dung (npm run check:content)src/components/exercise/ bài tập: ExerciseRunner, ChoiceButton, ProgressBarsrc/lib/content/ mô hình nội dung (types.ts) và nơi nạp nội dung (grammar.ts)src/components/srs/ thẻ lật 3D (Flashcard) và phiên ôn tập; src/lib/srs/ lịch ôn kiểu SM-2 rút gọn và dựng thẻ từ câu saitests/ kiểm thử bằng bộ chạy sẵn của Node (npm test)src/lib/analytics/ tổng hợp tiến độ, chuỗi ngày học và bản đồ nhiệt từ lịch sử trả lời (hàm thuần); src/lib/content/rounds.ts cách bốc câu cho mỗi lượtsrc/lib/db/ lớp truy cập dữ liệu (đăng nhập ẩn danh, hồ sơ, ghi câu trả lời); supabase/migrations/ schema SQLsrc/lib/supabase/ client Supabase (chỉ lớp truy cập dữ liệu được gọi), src/app/api/health kiểm tra kết nốisrc/lib/settings.ts giao diện (3 skin) và âm thanh, lưu trong trình duyệtlegacy/ bản JS thuần cũ, giữ để tham khảo (đặc biệt grammar_theory_bank.js), không build
