🔥 GIỚI THIỆU DỰ ÁN
Website Học Tiếng Trung Qua Game & Tích Hợp Trợ Lý AI là đồ án tốt nghiệp / dự án full-stack hoàn chỉnh được xây dựng nhằm đổi mới phương pháp học tiếng Trung theo hướng Gamification (Trò chơi hóa) kết hợp công nghệ Trí tuệ nhân tạo (AI) và Thời gian thực (Realtime). Giúp người học hứng thú, nhớ lâu mặt chữ Hán, phát âm và từ vựng thông qua các trải nghiệm thi đấu và luyện tập thông minh.
🎯 CÁC TÍNH NĂNG NỔI BẬT DÀNH CHO HỌC VIÊN
-
Lộ trình học & Tập viết chữ Hán thông minh:
-
Bài học phân chia bài bản theo chuẩn cấp độ HSK.
-
Tập viết chữ Hán trực tiếp trên Canvas cảm ứng / chuột.
-
AI chấm nét viết: Nhận diện và đánh giá độ chính xác từng nét vẽ, đưa ra nhận xét tức thì.
-
AI giải thích chuyên sâu ngữ cảnh sử dụng, ngữ pháp và cấu trúc câu ví dụ.
-
Chuỗi Mini-game rèn luyện đa dạng:
-
Trắc nghiệm phản xạ nhanh, ghép thẻ từ vựng Hán - Việt, nhận diện Pinyin, điền chữ vào chỗ trống.
-
Trợ lý AI gợi ý thông minh: Tự động phân tích lỗi sai và đưa ra mẹo ghi nhớ tối ưu.
-
Đấu trường Đối kháng thời gian thực (PvP Realtime):
-
Thi đấu trực tiếp giữa 2 người chơi qua Socket.IO.
-
Phòng chờ, ghép trận tự động, đồng hồ đếm ngược và bảng xếp hạng điểm số kịch tính.
-
Flashcard 3D & Chatbot AI Gia sư:
-
Thẻ lật 2 mặt kèm phiên âm chuẩn, audio phát âm và nghĩa chi tiết.
-
Chatbot AI luyện phản xạ giao tiếp tiếng Trung và giải đáp ngữ pháp 24/7.
-
Dashboard theo dõi tiến độ: Thống kê chuỗi ngày học (streak), level, điểm thưởng và tỷ lệ ghi nhớ từ vựng.
⚙️ HỆ THỐNG QUẢN TRỊ ADMIN (CMS)
-
Quản lý người dùng: Xem danh sách, phân quyền Admin/User, khóa (ban) hoặc kích hoạt tài khoản.
-
Quản lý nội dung học tập: CRUD bài học và ngân hàng từ vựng (Pinyin, Hán tự, tải lên ảnh minh họa).
-
Cấu hình Game: Tùy chỉnh luật chơi, thời lượng và gán danh sách từ vựng riêng cho từng mini-game.
-
Báo cáo & Giám sát AI: Thống kê học tập trực quan, xuất file báo cáo (Excel/CSV) và theo dõi lịch sử chat với AI.
-
Đa ngôn ngữ: Giao diện hỗ trợ linh hoạt 3 ngôn ngữ: Tiếng Việt, Tiếng Trung, Tiếng Anh.
💻 CÔNG NGHỆ ÁP DỤNG
-
Frontend: React.js, Vite, Tailwind CSS, Lucide Icons, Axios, i18next.
-
Backend: Node.js, Express.js, RESTful API, JWT Auth.
-
Realtime: Socket.IO.
-
Cơ sở dữ liệu: MongoDB, Mongoose ODM.
-
AI Service: Tích hợp Google Gemini / OpenAI-compatible API.
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
📌 YÊU CẦU MÔI TRƯỜNG
-
Node.js: Khuyên dùng phiên bản 18.x hoặc 20.x trở lên.
-
MongoDB: Cài đặt MongoDB Community Server trên máy hoặc dùng MongoDB Atlas (Cloud).
-
Trình quản lý gói: npm hoặc yarn.
🚀 BƯỚC 1: CÀI ĐẶT & CHẠY BACKEND (BE)
1. Mở cửa sổ dòng lệnh (Terminal/CMD), di chuyển vào thư mục be:
cd be
npm install
2. Tạo file .env trong thư mục be với nội dung cấu hình:
PORT=8000
MONGODB_URI=mongodb://127.0.0.1:27017/GameTiengTrung
JWT_SECRET=your_secret_jwt_key
JWT_EXPIRES_IN=7d
AI_BASE_URL=https://api.vilao.ai/v1
AI_API_KEY=your_ai_api_key_here
AI_MODEL=ts/gemini-3.1-flash-lite
(Lưu ý: Nếu sử dụng MongoDB Atlas, thay MONGODB_URI bằng chuỗi kết nối cloud của bạn).
3. Khởi tạo dữ liệu mẫu (bắt buộc cho lần đầu chạy):
npm run seed
Lệnh này sẽ tự động tạo danh sách bài học, ngân hàng từ vựng, tài khoản Admin và User demo.
4. Chạy Backend:
npm run dev
Backend khởi chạy thành công tại: http://localhost:8000
🌐 BƯỚC 2: CÀI ĐẶT & CHẠY FRONTEND (FE)
1. Mở một cửa sổ Terminal mới, chuyển vào thư mục fe:
cd fe
npm install
2. Chạy giao diện:
npm run dev
3. Mở trình duyệt web truy cập địa chỉ:
http://localhost:3000
🔑 TÀI KHOẢN ĐĂNG NHẬP MẪU