LucaChess Admin - Cổng Quản Trị Hệ Thống

Lựa Chọn AI Chess Engine Mặc Định

Quyết định động cơ phân tích và phản hồi nước đi của Luca AI trên toàn bộ hệ thống webapp học viên

Đang áp dụng: STOCKFISH

SF WASM

Khuyên dùng - Siêu tốc

Engine cờ vua số 1 thế giới SF biên dịch sang WebAssembly. Xử lý đa luồng nền Web Worker, phản ứng tức thì không bao giờ đơ trình duyệt.

Tốc độ phản hồi0.2s - 0.5s

Độ chuẩn xácChuẩn FIDE Kiện Tướng

Tốc độ phản ứng cực nhanh (200ms - 500ms)

Định chuẩn ELO chuẩn xác theo 10 cấp độ Luca

Chạy nền Web Worker độc lập, giải phóng 100% Main Thread

Custom Minimax JS

Thuật toán nội bộ

Thuật toán Minimax + Alpha-Beta Pruning viết hoàn toàn bằng TypeScript nội bộ. Nhẹ, độc lập, không phụ thuộc file WASM bên ngoài.

Tốc độ phản hồi0.2s - 0.8s (đã tối ưu)

Độ chuẩn xácCơ bản đến Khá

Mã nguồn mở nội bộ của LucaChess

Có chốt chặn thời gian an toàn (max 500ms)

Tương thích tốt trên các thiết bị cũ không hỗ trợ WebAssembly

Tự động (Hybrid / Fallback)

Thông minh

Hệ thống tự động phát hiện năng lực thiết bị: Ưu tiên SF WASM nếu trình duyệt hỗ trợ, tự động fallback sang Minimax JS nếu có lỗi.

Tốc độ phản hồiTự động tối ưu

Độ chuẩn xácThích ứng thiết bị

Độ ổn định tối đa 100% cho mọi học viên

Tự động chuyển đổi mượt mà khi mất kết nối worker

Trải nghiệm đồng đều trên cả Mobile Web và Desktop

Thời Gian Suy Nghĩ Nhân Tạo Của Máy (UX Delay)

Điều chỉnh khoảng thời gian mô phỏng suy nghĩ tự nhiên để người học không bị ngợp hoặc chờ đợi quá lâu

Tức thì (0.5s)

Phản hồi chớp nhoáng, lý tưởng cho cờ chớp / bullet

Mặc định (0.8s - 1.2s)

Cân bằng hoàn hảo, tự nhiên như người thật

Trầm tư (1.5s - 2.0s)

Mô phỏng máy suy nghĩ sâu, phù hợp cờ chậm

Khóa Tích Hợp Google Gemini AI (Tạo Bài Học & Puzzles Tự Động)

API Key dùng cho các tác vụ sinh bài tập, nhận diện FEN và phân tích thế cờ bằng AI Gemini

Hướng dẫn từng bước lấy Google Gemini API Key miễn phí (Google AI Studio)

Mở Google AI Studio

Truy cập Google AI Studio & Đăng nhập Gmail

Bấm vào nút "Mở Google AI Studio" ở trên hoặc truy cập https://aistudio.google.com/app/apikey, sau đó đăng nhập bằng bất kỳ tài khoản Google / Gmail cá nhân nào (hoàn toàn miễn phí, không cần thẻ visa).

Tạo khóa API mới (Create API key)

Tại trang quản lý API keys, nhấn vào nút màu xanh "Create API key".

Chọn dự án & Nhận mã khóa

Chọn "Create API key in new project" (hoặc chọn một dự án Google Cloud có sẵn), Google sẽ tạo ra một chuỗi mã API Key bắt đầu bằng AIzaSy.... Bấm Copy để sao chép chuỗi mã này.

Dán vào ô bên dưới & Bấm Lưu Cài Đặt

Dán chuỗi khóa vừa sao chép vào ô Google Gemini API Key bên dưới, sau đó bấm nút "Lưu Cài Đặt" ở góc trên bên phải màn hình. Toàn bộ tính năng Quét FEN bằng Gemini AI trong màn hình Import Bài Học sẽ tự động kích hoạt ngay lập tức!

Google Gemini API Key

API Key được mã hóa lưu trữ an toàn trong cơ sở dữ liệu và chỉ dùng cho các lệnh sinh nội dung phía Admin.

Cấu Hình Đăng Nhập Bằng Google (Google Sign-In / OAuth 2.0)

Cấu hình tập trung tại đây cho toàn bộ hệ thống (EU Webapp, Teacher Webapp). Người dùng cuối chỉ cần bấm đăng nhập 1-click mà không cần bất kỳ thao tác kỹ thuật nào.

Hướng dẫn từng bước tạo Google Client ID từ bước đầu tiên (Google Cloud Console)

Mở Google Cloud Console

Truy cập Google Cloud Console & Tạo Dự án mới:

Vào Google Cloud Console, đăng nhập tài khoản Google. Bấm chọn danh sách Project ở góc trên bên trái thanh tìm kiếm -> Nhấn nút New Project (Dự án mới) -> Đặt tên Project là LucaChess rồi bấm Create.

Cấu hình Màn hình đồng ý OAuth (OAuth consent screen):

Tại trang OAuth Overview, nhấn nút xanh [ Get started ] ở giữa màn hình:

App Information: Điền App name là LucaChess, chọn User support email của bạn -> Bấm Next.
Audience: Chọn mục External (để mọi người dùng Google đều đăng nhập được) -> Bấm Next.
Contact Information: Nhập lại email liên hệ kỹ thuật -> Bấm Create / Finish.

Bắt đầu tạo Client ID (Clients):

Ở thanh menu bên trái, bấm vào mục Clients (ngay dưới Audience) -> Bấm nút `+ Create client` ở thanh trên cùng.

- Ô Application type: Chọn Web application (Ứng dụng web).
- Ô Name: Nhập LucaChess Web Client (hoặc để mặc định).

Thêm Nguồn JavaScript được ủy quyền (Authorized JavaScript origins) - QUAN TRỌNG NHẤT:

Cuộn xuống mục Authorized JavaScript origins, bấm nút + ADD URI và thêm lần lượt các địa chỉ sau:

Webapp EU học viên (Local):http://localhost:3002

Webapp Giáo viên (Local):http://localhost:3001

Webapp EU học viên (VPS Cloud):https://emilichess-eu.116.118.6.236.nip.io

Webapp Giáo viên (VPS Cloud):https://emilichess-teacher.116.118.6.236.nip.io

⚠️ Lưu ý tránh lỗi đỏ Google: Khi dán URI, tuyệt đối không để khoảng trắng (dấu cách/space) ở đầu hoặc cuối chuỗi URL, nếu dính dấu cách Google sẽ báo lỗi Invalid Origin: cannot contain whitespace. Hãy bấm xóa lùi (Backspace) ở cuối số cổng để đảm bảo sạch sẽ.

Bấm Create & Dán Client ID vào ô bên dưới:

Bấm nút Create ở dưới cùng trang Google. Một hộp thoại popup sẽ xuất hiện kèm chuỗi Client ID có dạng:

xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com

Sao chép toàn bộ chuỗi mã này, dán vào ô Google OAuth 2.0 Client ID ngay bên dưới và nhấn nút "💾 Lưu Thay Đổi Cài Đặt" ở chân trang là hoàn tất!

Google OAuth 2.0 Client IDMở Google Cloud Console

💡 Sau khi lưu, toàn bộ các ứng dụng (Webapp EU học viên, Webapp Giáo viên) sẽ tự động nạp Client ID này từ CSDL để mở cửa sổ chọn tài khoản Google thật.