Hệ Thống Chấm Bài Cá Nhân v3.3

Mô tả chi tiết

📋 Mô tả sản phẩm

Hệ Thống Chấm Bài Cá Nhân là ứng dụng web giáo dục chạy trên Google Apps Script, cho phép giáo viên giao bài tập và chấm điểm tự động bằng AI cho từng học sinh theo thời gian thực.

Giáo viên tạo bài tập, đính kèm đề bài và đáp án mẫu, hệ thống sẽ tự động phân phát đến đúng lớp học. Khi học sinh nộp bài — dưới dạng ảnh chụp bài làm hoặc file PDF — AI (Google Gemini) sẽ đọc và so sánh với đáp án của giáo viên, sau đó chấm điểm và trả về nhận xét chi tiết cho từng em. Toàn bộ quy trình từ giao bài đến có kết quả diễn ra trên cùng một nền tảng, không cần thêm phần mềm nào khác.

Hệ thống phù hợp với các trường phổ thông muốn số hóa việc giao và chấm bài tập về nhà, đặc biệt hiệu quả với các môn có bài làm viết tay như Toán, Lý, Hóa, hoặc các môn có bài luận ngắn.

---

✨ Tính năng chính

Dành cho Giáo viên

• Tạo và quản lý bài tập — Soạn đề bài, đặt hạn nộp, chỉ định lớp cụ thể hoặc toàn trường
• Đính kèm tài liệu — Upload file PDF hoặc hình ảnh đề bài, đáp án mẫu lên Google Drive trực tiếp từ giao diện
• Chấm bài AI hàng loạt — Một nút nhấn để AI chấm toàn bộ bài nộp chưa được chấm của một bài tập
• Xem và quản lý bài nộp — Theo dõi ai đã nộp, ai chưa nộp, điểm số và nhận xét từng học sinh
• Quản lý học sinh và lớp — Xem danh sách học sinh theo từng lớp, lịch sử nộp bài
• Mã bài tập — Mỗi bài tập có mã 6 ký tự để học sinh tìm bài nhanh

Dành cho Học sinh

• Xem danh sách bài tập — Hiển thị bài tập được giao theo lớp, có phân biệt bài đã nộp và chưa nộp
• Nộp bài trực tuyến — Chụp ảnh bài làm hoặc upload file PDF, nộp trực tiếp trên web
• Nhận kết quả ngay — Xem điểm số và nhận xét chi tiết từ AI sau khi giáo viên chấm
• Theo dõi lịch sử — Xem lại tất cả bài đã nộp và kết quả qua các kỳ
• Cảnh báo nộp muộn — Hệ thống tự động ghi nhận và trừ điểm nếu nộp quá hạn

Hệ thống

• Xác thực phân quyền — Đăng nhập riêng biệt cho giáo viên và học sinh, phiên đăng nhập bảo mật bằng token (1 giờ)
• Dữ liệu lưu trên Google Sheets — Không cần server riêng, toàn bộ dữ liệu lưu trong Google Spreadsheet của bạn
• Lưu trữ file trên Google Drive — File bài nộp và đề bài được lưu tự động vào Drive

---

❓ FAQ

Hệ thống hỗ trợ những định dạng file nào khi nộp bài? Học sinh có thể nộp ảnh (JPG, PNG, GIF, WebP) hoặc file PDF. Dung lượng tối đa mỗi file là 50MB. File sẽ được lưu tự động vào Google Drive của tài khoản đã deploy ứng dụng.

AI chấm bài dựa trên cơ sở nào? AI (Google Gemini 2.0 Flash) sẽ đọc bài làm của học sinh và so sánh với đáp án mẫu do giáo viên cung cấp. AI phân tích từng bước giải, đưa ra điểm số từ 0–10 và nhận xét chi tiết về chỗ đúng, chỗ sai. Nếu không có đáp án mẫu, AI sẽ chấm dựa trên nội dung đề bài.

Nộp bài muộn có bị trừ điểm không? Có. Hệ thống tự động phát hiện bài nộp sau hạn và áp dụng hệ số phạt 0.5 điểm. Trạng thái nộp muộn cũng được ghi nhận và hiển thị trong bảng kết quả.

Một giáo viên có thể quản lý nhiều lớp không? Có. Khi tạo bài tập, giáo viên có thể chỉ định giao cho một lớp cụ thể hoặc chọn "Tất cả lớp". Hệ thống tự động lọc và hiển thị bài tập phù hợp với từng học sinh theo lớp của họ.

Dữ liệu học sinh được lưu ở đâu? Toàn bộ dữ liệu (tài khoản, bài tập, bài nộp) được lưu trong Google Spreadsheet do bạn tạo và sở hữu. File bài nộp lưu trong Google Drive. Không có dữ liệu nào gửi đến máy chủ bên thứ ba, ngoại trừ nội dung bài làm được gửi đến Gemini API để chấm điểm.

Phiên đăng nhập kéo dài bao lâu? Phiên đăng nhập được bảo mật bằng token và tự động hết hạn sau 1 giờ không hoạt động. Người dùng cần đăng nhập lại sau khi hết phiên.

Có thể thêm nhiều giáo viên vào hệ thống không? Có. Chỉ cần thêm tài khoản mới vào sheet Users trong Google Spreadsheet với Role = teacher. Hệ thống không giới hạn số lượng giáo viên hay học sinh.

Tôi gặp lỗi "Database chưa được thiết lập" phải làm gì? Mở Apps Script Editor → Chạy thủ công hàm setupDatabase() để tạo các sheet cần thiết. Đảm bảo SHEET_ID trong Code.gs đã được cấu hình đúng ID Google Spreadsheet của bạn.

---

🔧 Thông tin kỹ thuật

Thành phần	Công nghệ
Nền tảng	Google Apps Script
AI Chấm bài	Google Gemini 2.0 Flash
Cơ sở dữ liệu	Google Sheets
Lưu trữ file	Google Drive
Xác thực	Token-based session (UUID, TTL 1 giờ)
Frontend	HTML + Bootstrap 5 + Font Awesome
File tối đa	50 MB
Phiên bản	v3.3

---

https://docs.google.com/spreadsheets/d/[ĐÂY_LÀ_ID]/edit

const SHEET_ID = "ID_GOOGLE_SHEET_CỦA_BẠN"; // ← Thay ID vào đây

const CONFIG = {
  GEMINI: {
    API_KEYS: [
      "AIza...API_KEY_CỦA_BẠN...",
    ],
    ...
  }
}