Mô tả

Hệ thống chấm thi

Nền tảng chấm bài thi cho giáo viên tiếng Anh: chụp ảnh bài làm của học sinh bằng điện thoại, AI đọc và chấm điểm tự động, giáo viên xác nhận/chỉnh sửa, rồi xem thống kê tiến bộ theo lớp và xuất báo cáo Excel — không cần nhập điểm thủ công vào bảng tính.

Gồm 3 phần:backend Laravel(API + trang quản trị Filament),app di động Fluttercho giáo viên (chụp bài bằng camera), và một pipelineAI Vision đa nhà cung cấpđể OCR/chấm điểm bài thi viết tay.

Vì sao dự án này tồn tại

Giáo viên trung tâm tiếng Anh chấm bài giấy xong phải nhập tay từng điểm vào Excel để theo dõi tiến bộ học sinh — tốn thời gian và dễ sai sót khi lớp đông. Hệ thống này thay thế bước nhập tay: giáo viên chỉ cầnchụp ảnh bài làm bằng điện thoại, hệ thống tự đọc chữ viết tay, so khớp đáp án, tính điểm, và lưu thẳng vào cơ sở dữ liệu — sẵn sàng cho dashboard và export Excel.

Hai luồng chấm thi song song

Backend hỗ trợ đồng thời hai mô hình chấm bài, phục vụ hai nhu cầu khác nhau của trung tâm:

Tính năng nổi bật

Chấm điểm bằng AI Vision, có fallback đa nhà cung cấpẢnh chụp bài thi được gửi qua chuỗi AI vision theo thứ tự ưu tiên — nếu nhà cung cấp đầu tiên lỗi hoặc hết quota, hệ thống tự chuyển sang nhà cung cấp kế tiếp mà không làm gián đoạn giáo viên:

Gemini → Groq → Mistral → OpenRouter   (VisionExtractorChain / AnswerSheetExtractorChain)

Với đề Cambridge YLE, nếu AI trả lời thiếu câu hỏi bắt buộc, hệ thốngtự động gọi lại tối đa 3 lầntrước khi đánh dấu bài cần giáo viên xem lại (needs_review) — không bao giờ âm thầm bỏ sót câu.

Chuẩn hoá đáp án thông minh, không chỉ so khớp chuỗi cứng nhắc

• Bỏ dấu gạch nối giữa các chữ cái viết tay:W-A-L-L→wall
• Quy đổi số ↔ chữ:"fifteen"↔"15"
• Nhận diện tick/cross bằng cả ký hiệu (✓ ✗) lẫn chữ viết (yes/no,true/false,v/x)
• Bỏ dấu tiếng Việt khi so khớp tên học sinh để chịu được lỗi chính tả của OCR

Đề thi Cambridge YLE đúng chuẩn, định nghĩa sẵn theo cấu trúc thật của Cambridge Assessment English — số phần, loại câu hỏi, thang điểm tăng dần theo cấp độ:

Dashboard theo lớp, không chỉ theo bài thi đơn lẻ

• Xu hướng điểm trung bình qua từng kỳ kiểm tra (line chart)
• Điểm trung bình theo 6 kỹ năng: Từ vựng, Ngữ pháp, Nghe, Đọc, Viết, Nói — cột đổi màu đỏ/xanh theo ngưỡng đạt/chưa đạt cấu hình được
• Bảng "Học sinh cần hỗ trợ" — tự động liệt kê học sinh có kỹ năng dưới ngưỡng, sắp xếp theo số kỹ năng yếu nhiều nhất
• Bảng xếp hạng % tiến bộ giữa các lớp trên dashboard tổng

Xuất Excel đúng mẫu giáo viên đang dùng thủ côngMột nút bấm tạo file.xlsxvới đúng 13 cột giáo viên từng tự tổng hợp bằng tay (điểm 6 kỹ năng, tổng điểm, cột "kỹ năng cần cải thiện" tự động điền bằng công thức tương đươngTEXTJOIN, cột nhận xét để trống cho giáo viên viết tay).

Phân quyền theo lớp phụ tráchGiáo viên chỉ xem/sửa được lớp mình dạy; admin thấy toàn hệ thống. Model lớp học: giáo viên tạo lớp với một mã lớp (code) duy nhất, dùng mã đó để tự gắn tài khoản khác vào lớp khi cần — không có bước "duyệt học sinh xin vào lớp".

Audit log tự độngcho các thao tác nhạy cảm (đổi điểm, khoá/mở đề, đổi trạng thái bài chấm) — ghi lại ai đổi gì, khi nào, từ giá trị nào sang giá trị nào.

App di động (Flutter) — công cụ chấm bài cho giáo viên

App chỉ dành cho giáo viên (không có tài khoản học sinh). Luồng chính:

1. Đăng nhập / đăng ký (có thể nhập mã lớp để join lớp ngay lúc đăng ký)
2. Chọn lớp → chọn kiểu chấm (đếm câu đúng / Unit Test đã chấm tay / Cambridge YLE)
3. Camera tự động chụp khi phát hiện khung hình đứng yên và có chữ — dùng Google ML Kit để nhận diện độ ổn định của khung hình (Jaccard similarity giữa 2 frame liên tiếp), không cần bấm nút chụp thủ công
4. Backend OCR + chấm điểm, trả kết quả trong vài giây
5. Giáo viên xác nhận/sửa tên học sinh, điểm, rồi lưu
6. Xem lại danh sách điểm, thống kê lớp, xuất Excel ngay trên điện thoại

ML Kit trên máy chỉ đóng vai trò gợi ý (phát hiện lúc nào ảnh đủ nét để chụp) — việc đọc chữ chính xác và chấm điểm luôn do AI Vision ở backend đảm nhiệm.

Kiến trúc kỹ thuật

backend/   Laravel 11 (PHP 8.2)├── Filament v3        → trang quản trị (/admin): quản lý lớp, học sinh, đề thi,│                         điểm, dashboard, cài đặt bật/tắt tính năng├── Sanctum            → xác thực API cho app di động (token)├── Spatie Permission  → phân quyền theo role (admin / teacher), 15 permissions├── Cloudinary         → lưu trữ ảnh bài thi đã chụp├── PhpSpreadsheet     → xuất báo cáo điểm ra Excel└── Vision chain        → OCR/chấm điểm qua Gemini/Groq/Mistral/OpenRouter,                          tự chuyển nhà cung cấp khi một API lỗimobile/    Flutter (Dart) — app Android/iOS cho giáo viên├── camera + google_mlkit_text_recognition → chụp tự động, gợi ý OCR sơ bộ├── dio + flutter_secure_storage          → gọi API, lưu token an toàn└── provider                              → quản lý trạng thái đăng nhập