Skip to content

thang1834/Mindx-Teaching-Report-Assistant

Repository files navigation

🎓 MindX Report - AI Teaching Support

MindX Report là một công cụ hỗ trợ giảng viên và trợ giảng (TA) tại MindX tự động hóa quy trình viết báo cáo nhận xét học viên sau mỗi buổi học. Sử dụng sức mạnh của Google Gemini AI, ứng dụng giúp tạo ra các báo cáo chuyên nghiệp, đầy đủ tiêu chí và được tối ưu hóa riêng biệt cho nền tảng Zalo hoặc Web/Markdown.


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

🤖 Trí tuệ nhân tạo (Gemini 3 Flash)

  • Tự động biên soạn nhận xét cá nhân từ những ghi chú ngắn gọn của giảng viên.
  • Lồng ghép khéo léo 7 tiêu chí đánh giá: Thái độ, Giao tiếp, Giải quyết vấn đề, Kỹ năng máy tính, Tư duy thuật toán, Kiến thức bài học, Sáng tạo.
  • Văn phong chuyên nghiệp, khích lệ và đúng định hướng giáo dục của MindX.

📱 Tối ưu hóa cho Zalo

  • Chế độ "Tối ưu Zalo" loại bỏ hoàn toàn các ký tự Markdown (**, __, ###) vốn bị hiển thị lỗi trên Zalo.
  • Sử dụng emoji, chữ IN HOA và đường kẻ phân cách (━━━━━━━━━━━━━━━━━━) để báo cáo trông đẹp mắt và dễ đọc trên điện thoại.

📚 Kho học liệu MindX (Curriculum)

  • Tích hợp sẵn lộ trình của các khóa học: Lập trình Web (JSB/JSA/JSI), Python, Computer Science (CS), GameMaker, Scratch.
  • Tự động hiển thị nội dung bài học theo buổi số đã chọn.

⚡ Quản lý lớp học thông minh

  • Nhận diện tự động: Tự động chọn môn học khi nhập tên lớp (VD: Nhập "NCT-JSA52" hệ thống tự nhận diện khóa Web Nâng cao).
  • Nhập nhanh (Quick Import): Cho phép dán danh sách học sinh từ Excel/Zalo để tạo nhanh danh sách nhận xét.
  • Lưu trữ cục bộ: Lưu cấu trúc danh sách lớp vào bộ nhớ trình duyệt để sử dụng cho các buổi sau.
  • Trạng thái linh hoạt: Hỗ trợ đánh dấu học sinh vắng mặt và điền điểm bài tập về nhà (BTVN) từ 0-10.

🚀 Hướng dẫn sử dụng

  1. Thiết lập lớp học:
    • Nhập tên lớp (hệ thống sẽ cố gắng nhận diện môn học).
    • Chọn Trình độ và Buổi số tương ứng.
  2. Danh sách học viên:
    • Sử dụng nút "Dán danh sách" để nhập nhanh tên học sinh.
    • Với mỗi học sinh, điền điểm BTVN và một vài ghi chú nhanh (VD: "hăng hái", "quên làm bài"). Nếu bé vắng, nhấn nút "Có mặt" để chuyển sang "Vắng mặt".
  3. Tạo báo cáo:
    • Chọn định dạng đầu ra (Zalo hoặc Web).
    • Nhấn "Tạo báo cáo" và đợi AI trong vài giây.
  4. Gửi báo cáo:
    • Nhấn "Sao chép" và dán trực tiếp vào nhóm lớp trên Zalo.

🛠 Công nghệ sử dụng

  • Frontend: React 19 (với ES6 Modules via esm.sh).
  • Styling: Tailwind CSS.
  • Icons: Lucide React.
  • AI Engine: Google Generative AI SDK (@google/genai).
  • Model: gemini-3-flash-preview.

📋 Yêu cầu hệ thống

Dự án yêu cầu một API Key từ Google Gemini để hoạt động. API Key này được cung cấp thông qua biến môi trường process.env.API_KEY.


📄 Lưu ý định dạng báo cáo

  • Lời chào: Tự động điều chỉnh theo tên lớp và buổi học.
  • Nhận xét cá nhân: Viết dưới dạng đoạn văn mượt mà, không gạch đầu dòng.
  • Dặn dò: Hướng trực tiếp đến các con để tăng tính gắn kết.
  • Lời kết: Theo quy chuẩn tin tưởng và đồng hành của MindX.

Phát triển với ❤️ bởi thang1834.

About

Công cụ hỗ trợ Giảng viên và Mentor tại MindX tự động hóa quy trình viết báo cáo, nhận xét học viên một cách chuyên nghiệp và tiết kiệm thời gian.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors