Skip to content
Back to search

WordQuest9

WordQuest 9 - Gamified Tiếng Anh 9 (Global Success) Vocabulary RPG with Microservices, MCP Server & 12 Units

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/danielnguyen0705--wordquest9/badge.svg)](/listings/danielnguyen0705--wordquest9)

HTML

<a href="/listings/danielnguyen0705--wordquest9"><img src="/api/listings/danielnguyen0705--wordquest9/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 38 lines
  1. # ⚔️ Word Quest 9 — Vượt Ải Từ Vựng Tiếng Anh 9 (Global Success)
  2. Ứng dụng web học từ vựng **Tiếng Anh 9 hiện hành (Global Success, Units 1 – 12)** theo phong cách **Gamified Vocabulary RPG / Dungeon Run**, xây dựng trên kiến trúc **Microservices (FastAPI) + Official MCP Server + Next.js 15 + PostgreSQL**.
  3. ## ✨ Tính năng nổi bật
  4. - **Bản Đồ 12 Vùng Đất (Units 1 – 12):** Hơn **540 từ vựng** kèm IPA, nghĩa tiếng Việt, ví dụ ngữ cảnh, **Word Family** và hơn **520+ câu hỏi** được trích xuất trực tiếp từ bộ tài liệu Tiếng Anh 9 Global Success.
  5. - **Phiên chơi 2 Giai đoạn (~20 câu hỏi):**
  6. 1. **Nạp thẻ Flashcard 3D:** Lật thẻ mượt với Framer Motion, phát âm chuẩn US/UK (có tốc độ chậm) qua Web Speech API, hiển thị Word Family & tự đánh giá.
  7. 2. **Đấu trường 20 câu hỏi biến thiên (5 dạng bài):** Nghe chọn từ (`listening`), Dịch Anh–Việt (`translation_en_vi`), Dịch Việt–Anh (`translation_vi_en`), Trắc nghiệm ngữ cảnh (`contextual_mcq`) và Biến đổi từ loại (`word_form` — hỗ trợ cả chọn A/B/C/D lẫn chế độ tự gõ đáp án).
  8. - **Chế độ Sinh Tử 1 Mạng (Hardcore Sudden-Death — Mặc định):** Sai bất kỳ 1 câu nào → lập tức hồi sinh từ câu 1 với **toàn bộ 20 câu và đáp án A/B/C/D được xáo trộn lại** chống học vẹt. Vượt trọn vẹn 20/20 mới nhận huy hiệu & mở khóa Unit kế tiếp. (Có kèm chế độ **Luyện Tập Tự Do** không reset).
  9. - **Kho Lỗi Sai & Chế độ Phục Thù (Mistake Vault):** Mọi câu làm sai tự động ghi vào sổ tay cá nhân. Vào chế độ **Phục Thù** trả lời đúng liên tiếp đạt ngưỡng thành thạo mới được đánh dấu *"Đã khắc phục"*.
  10. - **Tài khoản & Lưu trữ Bền vững:** Đăng ký / Đăng nhập JWT + bcrypt, lưu trọn đời XP, Level, Streak, Combo, tiến độ Unit & Kho Lỗi Sai trên PostgreSQL.
  11. - **Tách biệt Dữ liệu & Chuẩn MCP:** Không hardcode từ vựng. Hỗ trợ nạp dữ liệu JSON (`unit_X_vocab.json`, `unit_X_questions.json`) qua CLI, REST API hoặc MCP Tool `import_notebook_data`.
  12. ## 🚀 Khởi chạy nhanh
  13. ### 1. Bằng Docker Compose (Full Microservices + PostgreSQL + MCP + Frontend)
  14. ```bash
  15. cp .env.example .env
  16. docker compose up --build -d
  17. ```
  18. ### 2. Chạy Local Development (Windows PowerShell)
  19. ```powershell
  20. .\scripts\dev-local.ps1
  21. ```
  22. ### 3. Nạp / Cập nhật học liệu JSON từ Notebook "TIẾNG ANH 9"
  23. Xem hướng dẫn bộ Prompt chuẩn tại [docs/NOTEBOOK_EXTRACTION_GUIDE.md](./docs/NOTEBOOK_EXTRACTION_GUIDE.md), sau đó chạy:
  24. ```bash
  25. python backend/scripts/import_notebook_data.py --data-dir data
  26. ```
  27. ## 📚 Tài liệu đi kèm
  28. - [Kiến trúc Microservices & MCP](./docs/ARCHITECTURE.md)
  29. - [Bộ Prompt trích xuất Notebook "TIẾNG ANH 9"](./docs/NOTEBOOK_EXTRACTION_GUIDE.md)
  30. - [Hướng dẫn Deploy lên Web](./docs/DEPLOYMENT.md)
  31. - [Tài liệu MCP Server](./backend/mcp_server/README.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.