UML Comparator là công cụ mạnh mẽ được phát triển bằng Golang, thiết kế để tự động hóa việc chấm điểm và so khớp các biểu đồ UML được vẽ từ draw.io (dưới dạng tệp .drawio hoặc XML) (có thể mở rộng về sau)
Dự án cung cấp khả năng so sánh chi tiết giữa bản vẽ Đáp án (Solution) và bài làm của Sinh viên (Student), giúp phát hiện nhanh các sai sót về cấu trúc, thành phần và mối quan hệ.
- Embedded Solutions: Cho phép giảng viên "nén" sẵn các tệp đáp án vào trong file
.exe. - Dropdown Selection: Sinh viên chỉ cần chọn tên câu hỏi (Q1, Q2...) từ danh sách thả xuống, không cần tự chọn file đáp án.
- Security: Bảo mật nội dung đáp án, chỉ hiển thị tên định danh cho sinh viên.
Biểu tượng trạng thái sử dụng chuẩn Vector (SVG) để đảm bảo độ sắc nét:
- 🟢 Correct (Checkmark): Khớp hoàn toàn.
- 🔴 Wrong (Alert): Tồn tại nhưng sai thông tin.
- 🔴 Missing (X-Mark): Thiếu so với đáp án.
- 🔵 Extra (Plus): Thừa so với đáp án.
Dự án tuân thủ nghiêm ngặt nguyên tắc SOLID, chia thành các module độc lập:
| Module | Chức năng |
|---|---|
| Parser | Đọc và giải mã XML từ tệp .drawio (Base64/Inflate). |
| Builder | Chuyển đổi dữ liệu XML thô thành đồ thị UMLGraph (String-Based). |
| Pre-Matcher | Tiền xử lý dữ liệu, phân loại và chuẩn hóa các thực thể (Struct-Based). |
| Matcher | So khớp các node giữa hai bản vẽ dựa trên độ tương đồng văn bản (Mapping). |
| Comparator | So sánh chi tiết thuộc tính, phương thức và các liên kết mũi tên. |
| Grader | Tính điểm dựa trên DiffReport: attribute/method/edge/node scoring. |
| Visualizer | Xuất báo cáo HTML "Dawn's Berry" với icon SVG và mã màu đồng bộ. |
| GUI Layer | Lớp giao diện người dùng (Lorca) giúp thao tác chọn file và xem kết quả trực quan. |
| AppBuilder | Module quản lý build theo chuẩn ISP, hỗ trợ build nén solutions và các công cụ khác. |
| Orchestrator | Trình điều khiển tập trung giúp giảng viên lựa chọn pipeline build phù hợp. |
| UML Generator | AI Agent tích hợp LLM sinh tự động mã Mermaid từ đề bài text (tích hợp OpenAI/Ollama/Groq). |
cmd/: Chứa các tệpmain.gocho từng công cụ (compare,visualize,exam_gui,builder_exe).AppBuilder/: Module quản lý build chuyên sâu (tuân thủ nguyên tắc SOLID/ISP).domain/: Định nghĩa các cấu trúc dữ liệu cốt lõi (UMLGraph,DiffReport,GradeResult).grader/: Module chấm điểm dựa trên DiffReport.visualizer/: Module xuất báo cáo HTML self-contained.scheme/: Tài liệu đặc tả dữ liệu giữa các module (Single Source of Truth).skills/: Hệ thống Skill OS dành cho AI Agent hỗ trợ phát triển dự án.parser/,builder/,prematch/,match/,comparator/: Các module chính của dự án.
- Hướng dẫn sử dụng chi tiết (GUI & CLI)
- Tài liệu cho AI Agent (Dành cho Dev)
- Quy trình xử lý (Flow)
- Chiến lược thiết kế (Morning Dawn)
- Sơ đồ kiến trúc (Mermaid)
Note: Các file cmd/*/main.go là entry point gọi các module và in output. cmd/visualize là công cụ chính xuất báo cáo HTML. Các cmd khác (compare, match, prematch...) chủ yếu dùng để debug và verify từng module riêng lẻ.
Ảnh review CLI
Dự án được xây dựng với mục tiêu nâng cao tính minh bạch và hiệu quả trong việc giảng dạy & chấm bài môn Thiết kế Hệ thống OOP.