Màn hình Đánh giá nhanh (Quick Walk)

Tab: Đánh giá (screen-danhgia)
File: app.js lines 1623-2498, index.html lines 304-347

1. Tổng quan

Màn hình cho phép đánh giá 6S theo 3 loại với form chấm điểm 0-5.

📝 Đánh giá nhanh (Quick Walk)

Loại đánh giá:
[🔍 Tự DG] [🔄 DG chéo] [👨‍🏫 BLD + Chuyên gia]

📍 Khu vực của bạn:
[🏘️ Xưởng May 2] [🔧 C1 - Chuyền 1]

→ Chọn lịch → Form chấm điểm → Gửi kết quả

2. Chọn loại đánh giá

Cách chọn: Click vào card. Card được chọn có border #1a237e, background #e8eaf6.

Hàm: onAssessEvalTypeChange(type)

3. Chọn khu vực (Location)

Tự DG (Self)

• Hiển thị danh sách các location của user (lấy từ user.location_id sau login)
• Giao diện: Cards grid với tên + path
• Click card → chọn location đó
• Hàm: renderSelfLocCards(), selectSelfLoc(locId)

DG chéo / Chuyên gia (Cross/Expert)

• Tải danh sách nhiệm vụ được phân công từ API /my-assignments
• Hiển thị dạng card assignment:

  📍 Xưởng May 2 (XM2-7)
  🟢 Hàng tuần · Bộ tiêu chí 6S
  📋 Lịch đánh giá tuần 26
  🚀 Bắt đầu →
  

• Hàm: loadCrossAssignments(), renderCrossAssignments(assignments)

4. Chọn lịch đánh giá

Khi chọn location, gọi API GET /schedules/by-location?location_id=X.

Lịch được nhóm theo tần suất:

Click vào schedule → gọi startAssessSession(locId, templateId, scheduleId)

5. Form chấm điểm

Hiển thị sau khi chọn schedule.

Header phiên

📋 ASM-2026-00001          Đạt từ: 90%

Nhóm tiêu chí (Grouped by S)

Mỗi nhóm (S1, S2, ..., S6) hiển thị:

[🏘️ S1 - Sàng lọc                               25/30 (83%)]
[████████████████████░░░░░░░░░░░]  ← progress bar

S1.01 · Tiêu chí 1
💡 Gợi ý từ tags: 3/5              ← nếu có gợi ý từ thẻ 6S
❌0  ⚠️1  ✅2  ⭐3  ⭐4  ⭐5       ← radio chấm điểm
[Ghi chú..._________________________]

⚠️ Treo thẻ     ← nếu điểm ≤ 1

Thang điểm

Progress bar tổng thể

📊 Tiến độ: 18/24                   73%
[████████████████░░░░░░░░░]  73% (màu vàng nếu < ngưỡng)

Ngưỡng đạt (threshold):

• Tự DG: 90%
• DG chéo: 85%
• Chuyên gia: 80%

Các hàm xử lý

6. Gửi kết quả

Nút: 📤 GỬI KẾT QUẢ

Hàm: submitAudit()

Quy trình:

Kiểm tra đã chấm hết item chưa?
    → Nếu chưa: confirm "Chỉ chấm X/Y tiêu chí. Gửi?"
    → Gọi API POST /sessions/{id}/submit
    → Tính điểm % 
    → Hiển thị kết quả

Màn hình kết quả

              ✅ (hoặc ❌)
             ĐẠT (hoặc KHÔNG ĐẠT)
                 85%
           34/40 điểm

📋 Phiên: ASM-2026-00001
📍 Khu vực: Xưởng May 2
📋 Bộ tiêu chí: 6S Checklist
🏷️ Loại: Tự DG
📊 Đạt từ: 90%

⚠️ Tạo Observation     ← nếu không đạt
✅ Hoàn tất
Đóng

7. Treo thẻ nhanh từ Assessment (quickCreateTagFromItem)

Khi chấm điểm ≤ 1 cho một item, hiển thị nút ⚠️ Treo thẻ.

Quy trình:

1. Click → mở modal
2. Tự động điền: mô tả = "[Từ đánh giá] item_name - comment"
3. Phân loại S = group_code
4. Loại thẻ = Đỏ nếu S6, Vàng nếu S1-S5
5. User có thể chụp ảnh + chỉnh sửa mô tả
6. Submit → POST /tags → tạo thẻ 6S

Hàm: quickCreateTagFromItem(itemId, itemName, groupCode), submitQuickTag(groupCode)

8. Tạo Observation (assessCreateObservation)

Khi kết quả không đạt, nút ⚠️ Tạo Observation xuất hiện.

1. Click → mở form tạo observation
2. Nhập mô tả + chọn loại S
3. Submit → tạo thẻ 6S với prefix "[Observation từ đánh giá]"

Hàm: assessCreateObservation(), assessSubmitObservation()

9. "🔍 Tự DG" từ Location Drawer

Trong tab Danh sách, mỗi location drawer có nút 🔍 Tự DG.

Click → tự động:

1. Chuyển sang tab Đánh giá
2. Chọn loại self
3. Chọn location đó

Hàm: startSelfAssessForLocation(locId)

Audio thuyết minh

Click play để nghe hướng dẫn bằng giọng đọc.

Screenshots

Chú thích: 3 lựa chọn loại đánh giá: Tự DG, Đánh giá chéo, BLĐ+Chuyên gia

Chú thích: Danh sách khu vực được phân quyền cho tự đánh giá

Chú thích: Danh sách nhiệm vụ đánh giá chéo từ API /my-assignments

Chú thích: Danh sách lịch đánh giá theo tần suất (Hàng ngày/Tuần/Tháng)

Chú thích: Form chấm điểm nhóm S1 với thang điểm 0-5

Chú thích: Một item đã được chấm điểm với gợi ý từ tags

Chú thích: Nút "Treo thẻ" xuất hiện khi điểm item ≤ 1

Chú thích: Tiến độ chấm điểm tổng thể 18/24 (73%)

Chú thích: Màn hình kết quả ĐẠT với điểm 85%

Chú thích: Màn hình kết quả KHÔNG ĐẠT, hiển thị nút Tạo Observation