GradeAI - Trợ lý chấm bài tự luận viết tay bằng AI
Dự án học thuật

GradeAI - Trợ lý chấm bài tự luận viết tay bằng AI

Tổng quan dự án

Việc chấm bài tự luận viết tay thường tốn nhiều thời gian, khó chuẩn hóa giữa nhiều lớp và khó lưu lại dữ liệu để phân tích sau này. GradeAI giải quyết bài toán này bằng cách cho giáo viên upload ảnh bài làm, OCR chữ viết tay tiếng Việt, chấm theo rubric tùy chỉnh và hiển thị kết quả trên giao diện duyệt nhanh để giáo viên kiểm tra, chỉnh sửa và xác nhận.

Kết quả & Chỉ số

Teacher, School Admin, Super Admin
3 user roles
Mobile scan flow được cải tiến qua 3 phiên bản
v1 → v3
Phân quyền dữ liệu theo school_id và role
RLS + RBAC

Tính năng chính

Upload ảnh bài làm hàng loạt qua Cloudflare R2 presigned URL
OCR chữ viết tay tiếng Việt bằng Google Cloud Vision API
AI chấm bài theo rubric do giáo viên tự định nghĩa
Rubric builder với tiêu chí và thang điểm linh hoạt
Giao diện duyệt nhanh: chấp nhận hoặc chỉnh sửa điểm AI
Realtime update qua Supabase Realtime
Dashboard riêng cho teacher, school_admin và super_admin
Flywheel append-only lưu cặp điểm AI và điểm giáo viên
Bảo mật bằng Supabase Auth, RLS, RBAC và Turnstile
Deploy VPS qua GitHub Actions self-hosted runner và PM2
Vai trò

Frontend / UI-UX / Mobile scan. Tôi phụ trách xây dựng giao diện chính bằng Next.js + Tailwind, thiết kế dashboard đa vai trò, hỗ trợ đa ngôn ngữ Việt-Anh, tối ưu trải nghiệm preload/skeleton và phát triển luồng mobile scan từ v1 đến v3.

Trách nhiệm
Thiết kế và triển khai UI dashboard cho teacher, school_admin và super_admin; xây dựng flow upload/scan bài làm trên mobile; tích hợp giao diện duyệt điểm theo từng tiêu chí rubric; tối ưu trải nghiệm tải dữ liệu bằng preload/skeleton; triển khai i18n Việt-Anh cho landing và auth flow; phối hợp với backend/API để kết nối OCR, grading worker, realtime và storage.

Nội dung chi tiết

GradeAI được xây dựng như một nền tảng hỗ trợ giáo viên chấm bài tự luận viết tay. Giáo viên có thể upload ảnh bài làm hàng loạt lên Cloudflare R2 bằng presigned URL, hệ thống xử lý OCR chữ viết tay tiếng Việt bằng Google Cloud Vision, sau đó gửi nội dung đã nhận diện sang AI Gateway để chấm theo rubric do giáo viên định nghĩa. Điểm nổi bật của hệ thống là giao diện duyệt nhanh, cho phép giáo viên accept-as-is hoặc chỉnh sửa từng tiêu chí trước khi lưu điểm. Dữ liệu chấm được lưu theo hướng append-only để tạo flywheel dữ liệu giữa điểm AI và điểm giáo viên, phục vụ cải thiện chất lượng mô hình trong tương lai. Hệ thống có phân quyền theo 3 vai trò: teacher, school_admin và super_admin, kết hợp Supabase Auth, Row-Level Security theo school_id, RBAC và Cloudflare Turnstile để tăng độ an toàn cho môi trường giáo dục.
Live
Thời gian
6 weeks
Nhóm
3 people
Trạng thái
Live

Công nghệ sử dụng

Next.js 14React 18TypeScriptTailwind CSS v4shadcn/uiFramer MotionSupabase PostgresRLSRealtimeAuthCloudflare R2Google Cloud Vision APIClaude Haiku 4.5ResendTurnstileVitestPlaywrightpgTAPGitHub ActionsPM2pnpmNode 20 LTS