# Phân Hệ Quản Lý Chấm Thủ Công (Web Exam Grading)
## 06. Hướng Dẫn Vận Hành & Xử Lý Sự Cố (SOP & Troubleshooting)

> **Mục tiêu**: Cẩm nang quy trình thao tác chuẩn (SOP) dành cho Giáo viên chấm thi và Cán bộ Quản trị Khảo thí trên giao diện Quản lý chấm thủ công (`exam-grading.index`), kèm hướng dẫn xử lý các vướng mắc nghiệp vụ thực tế.

---

## 📌 1. Quy Định Nghiệp Vụ Chấm Thi Lần 1 (`assign_type = 1`)

Chấm thủ công là giai đoạn then chốt trong chuỗi cung ứng dịch vụ đào tạo:
- **Nguyên tắc chấm**: Khách quan, bám sát bộ tiêu chí Rubric tiêu chuẩn quốc tế (IELTS Writing & Speaking Band Descriptors).
- **Hạn chót cam kết (SLA Deadline)**: Mỗi bài thi được phân công có thời hạn hoàn tất cụ thể (thường là trong vòng **24h đến 48h** kể từ thời điểm phân công).
- **Phân định quyền xem**:
  - Giáo viên chỉ nhìn thấy danh sách các bài thi được gán riêng cho tài khoản của mình.
  - Cán bộ Vận hành/Admin có quyền `viewAllGrading` có thể xem toàn bộ tiến độ của tất cả giáo viên trên hệ thống.

---

## 📖 2. Quy Trình Thao Tác Chuẩn (Standard Operating Procedures - SOP)

### 🔹 SOP-EG-01: Quy Trình Tiếp Nhận & Lên Kế Hoạch Chấm Của Giáo Viên
```mermaid
flowchart TD
    Login["Giáo viên đăng nhập LMS"] --> Menu["Vào 'Quản lý lịch sử làm bài' ➔ 'Quản lý chấm thủ công'"]
    Menu --> Filter["Lọc Trạng thái: 'Chờ chấm' & Sắp xếp theo Deadline tăng dần"]
    Filter --> Prioritize["Ưu tiên chấm các bài: Quá hạn / Sắp hết hạn trước"]
    Prioritize --> Action["Nhấp nút 'Chấm bài' để mở Modal"]
```

1. **Đăng nhập**: Giáo viên dùng tài khoản được cấp đăng nhập vào hệ thống LMS.
2. **Truy cập menu**: Chọn **Quản lý lịch sử làm bài** ➔ Nhấp **Quản lý chấm thủ công**.
3. **Sắp xếp thứ tự ưu tiên**:
   - Chọn bộ lọc **Trạng thái** = `Chờ chấm`.
   - Nhấp vào tiêu đề cột **Hạn chót chấm** để sắp xếp các bài sắp hết hạn lên đầu.
   - Nhận diện các bài có badge màu đỏ `Quá hạn` hoặc màu cam `Sắp hết hạn` để tiến hành chấm trước.

---

### 🔹 SOP-EG-02: Quy Trình Thực Hiện Chấm Bài Viết (Writing)
1. Tại dòng bài thi cần chấm, nhấp nút **Chấm bài** (biểu tượng Cây bút).
2. Giao diện chấm Writing mở ra với 2 phần:
   - **Khung bên trái**: Hiển thị đề bài, hình ảnh biểu đồ (Task 1) và nội dung bài viết của học sinh kèm số từ thực tế.
   - **Khung bên phải**: Bảng chấm Rubric gồm 4 tiêu chí cốt lõi:
     - `Task Achievement / Task Response (TR)`: Mức độ hoàn thành yêu cầu đề bài.
     - `Coherence and Cohesion (CC)`: Tính mạch lạc, liên kết câu và đoạn.
     - `Lexical Resource (LR)`: Vốn từ vựng, độ chính xác và đa dạng ngữ nghĩa.
     - `Grammatical Range and Accuracy (GRA)`: Cấu trúc ngữ pháp và độ chuẩn xác.
3. Giáo viên chọn mức điểm từ `0.0` đến `9.0` (bước nhảy `0.5`) cho từng tiêu chí.
4. Hệ thống sẽ tự động hiển thị điểm trung bình kỹ năng Writing theo thời gian thực.

---

### 🔹 SOP-EG-03: Quy Trình Thực Hiện Chấm Bài Nói (Speaking)
1. Nhấp nút **Chấm bài** tại bài thi Speaking.
2. Khung bên trái hiển thị danh sách câu hỏi từng phần (Part 1, Part 2, Part 3) kèm thanh phát âm thanh.
3. **Thao tác nghe audio**:
   - Nhấn nút Play ▶ để nghe câu trả lời của học viên.
   - Có thể tua lại các đoạn cần nghe kỹ để thẩm định phát âm và độ trôi chảy.
4. **Chấm 4 tiêu chí Rubric Speaking**:
   - `Fluency and Coherence (FC)`: Độ trôi chảy và mạch lạc.
   - `Lexical Resource (LR)`: Sử dụng từ ngữ và thành ngữ.
   - `Grammatical Range and Accuracy (GRA)`: Đa dạng và chuẩn xác ngữ pháp.
   - `Pronunciation (PR)`: Phát âm, ngữ điệu, trọng âm từ và trọng âm câu.
5. Chọn mức điểm tương ứng cho từng tiêu chí.

---

### 🔹 SOP-EG-04: Quy Chuẩn Viết Nhận Xét (Feedback Guideline)
> [!IMPORTANT]
> Nhận xét là giá trị cốt lõi mang lại sự tiến bộ cho học viên. Tuyệt đối không viết nhận xét sơ sài (như "Bài làm tốt", "Cần cố gắng thêm").

Một bản nhận xét đạt chuẩn bắt buộc phải có tối thiểu 3 phần:
1. **Điểm mạnh (Strengths)**: Khen ngợi những điểm học viên đã làm tốt (ví dụ: chia đoạn rõ ràng, dùng tốt các liên từ, phát âm âm cuối chuẩn).
2. **Điểm cần khắc phục (Weaknesses)**: Chỉ rõ lỗi sai cụ thể (trích dẫn trực tiếp câu/từ sai trong bài của học viên, giải thích tại sao sai).
3. **Đề xuất cải thiện (Actionable Advice)**: Hướng dẫn cách viết lại câu đúng, gợi ý các cấu trúc ngữ pháp và từ vựng nâng band điểm.

---

### 🔹 SOP-EG-05: Lưu Nháp & Nộp Bài Chấm Chính Thức
* **Lưu nháp (Save Draft)**: Nếu chưa chấm xong hoặc cần tra cứu thêm, giáo viên nhấp nút **Lưu nháp**. Dữ liệu điểm và nhận xét sẽ được bảo lưu an toàn.
* **Nộp bài hoàn tất**:
  1. Kiểm tra lại toàn bộ 4 tiêu chí và nội dung nhận xét.
  2. Nhấn nút **Nộp bài & Hoàn tất**.
  3. Hộp thoại xác nhận xuất hiện: *"Bạn có chắc chắn muốn nộp điểm bài thi này không?"*.
  4. Nhấn **Xác nhận nộp**.
  5. Trạng thái chuyển sang `Đã hoàn thành`. Điểm số được gửi sang hệ thống tính toán Overall.

---

### 🔹 SOP-EG-06: Quy Trình Theo Dõi & Thu Hồi Bài Quá Hạn Của Quản Lý
1. Cán bộ Quản lý đăng nhập và chọn bộ lọc **Trạng thái** = `Quá hạn`.
2. Kiểm tra tên các giáo viên có bài thi bị chậm tiến độ quá 24h.
3. Liên hệ nhắc nhở giáo viên qua kênh nội bộ (Slack/Zalo/Điện thoại).
4. Nếu giáo viên có sự cố bất khả kháng không thể chấm tiếp:
   - Nhấp nút **Thu hồi & Điều chuyển**.
   - Chọn giáo viên dự phòng nhận thay.
   - Đặt lại hạn chót mới để giáo viên mới tiếp nhận chấm.

---

## 🛠️ 3. Cẩm Nang Xử Lý Sự Cố Thường Gặp (Troubleshooting & FAQ)

### ❓ Sự cố 1: Giáo viên đã được thông báo có bài nhưng vào màn hình không thấy
* **Nguyên nhân**:
  1. Giáo viên đang để bộ lọc trạng thái ở mục `Đã chấm` nên không thấy bài mới.
  2. Cán bộ vận hành mới gán bài nhưng chưa nhấn nút "Lưu phân công" trên màn hình quản lý.
  3. Bài thi bị thu hồi hoặc đã hết hạn thu hồi tự động.
* **Cách xử lý**:
  - Hướng dẫn giáo viên bấm nút **Đặt lại bộ lọc** (Reset Filter) để tải lại toàn bộ danh sách.
  - Nếu vẫn không thấy, liên hệ Vận hành kiểm tra lại cột Giáo viên phụ trách trên trang Quản lý bài làm.

---

### ❓ Sự cố 2: Nhấn "Nộp bài & Hoàn tất" nhưng hệ thống báo lỗi không cho lưu
* **Nguyên nhân**:
  - Chưa chọn đủ 4 tiêu chí của Rubric (bỏ sót 1 tiêu chí).
  - Ô nhận xét để trống hoặc số lượng ký tự quá ngắn so với quy định tối thiểu (dưới 30 ký tự).
  - Kết nối Internet bị mất đúng lúc bấm nộp.
* **Cách xử lý**:
  - Cuộn màn hình kiểm tra xem có tiêu chí nào bị viền đỏ không.
  - Điền nhận xét chi tiết hơn vào ô phản hồi.
  - Kiểm tra biểu tượng kết nối mạng ở góc màn hình.

---

### ❓ Sự cố 3: Phát hiện bài viết của học viên có dấu hiệu đạo văn hoặc dùng AI (ChatGPT)
* **Quy trình xử lý**:
  1. **KHÔNG** tự ý cho 0 điểm ngay lập tức.
  2. Copy một đoạn bài viết kiểm tra qua công cụ đối soát đạo văn nội bộ.
  3. Nhấp nút **Gắn cờ bất thường (Abnormal)** trên giao diện chấm bài.
  4. Chọn lý do: *"Nghi vấn sử dụng AI / Đạo văn"*, đính kèm bằng chứng vào ô ghi chú.
  5. Nhấn **Gửi báo cáo nghi vấn**. Bài thi sẽ được chuyển lên cho Hội đồng Chuyên môn và Cán bộ Vận hành thẩm định.

---

## 📋 4. Tiêu Chí Đánh Giá Chất Lượng Chấm Thi (Grading QA Criteria)

| Tiêu Chí | Yêu Cầu Đạt Chuẩn | Trừ Điểm / Nhắc Nhở Nếu |
| :--- | :--- | :--- |
| **Tiến độ thời gian** | Hoàn thành trước deadline quy định (100% đúng hạn) | Nộp trễ hạn quá 6 giờ mà không báo trước |
| **Độ chính xác điểm số** | Chênh lệch điểm so với QA phúc khảo không quá **0.5 band** | Chênh lệch từ 1.0 band trở lên |
| **Chất lượng nhận xét** | Nhận xét chi tiết, chỉ ra lỗi sai cụ thể, có gợi ý sửa lỗi | Nhận xét chung chung, dưới 50 từ, copy-paste |
| **Tác phong sư phạm** | Ngôn từ chuẩn mực, tôn trọng học viên, mang tính động viên | Sử dụng từ ngữ tiêu cực hoặc gay gắt |
