[Tmphi]

GĐ6, giai đoạn cuối của kế hoạch cải tiến tài liệu. Các con số của lộ trình (dòng ⏱, cột Thời lượng của T10 §2) đều là ước lượng. PR này cho cách đo chúng trên học viên thật và hiệu chỉnh khi có dữ liệu.

Có gì

• Hai mẫu issue (.github/ISSUE_TEMPLATE/, New issue → chọn mẫu):

  • Báo cáo lab: lab (L01–L19), giờ làm thật, phút đọc từng module (T01 🎯: 80), kết quả run-lab.ps1, báo cáo, link PR.
  • Đo đầu/cuối giai đoạn: cấp, lần đo (trước khi học / lúc lên cấp), điểm 0–2 từng câu, mã học viên. Bộ câu dùng lại đúng bộ vấn đáp sẵn có ở T10 §4 (Fresher dùng 10 câu của C05 §6), nên không có đề mới.

• tools/docs/learning-report.mjs: đọc mọi issue bằng gh issue list, rồi in:

  • giờ làm lab: trung vị, so với khoảng ước lượng của T10 §2 (1 ngày = 8 giờ), kèm ghi chú "chưa đủ 5 báo cáo";
  • phút đọc: trung vị, so với dòng ⏱ của module (cả trang hay phần 🎯);
  • mức tăng điểm % theo giai đoạn, chỉ tính học viên có đủ hai lần đo;
  • "Cần xem lại": giờ không phải số, lab không có, dòng ghi sai dạng, bộ câu thiếu hay thừa, học viên mới đo một lần.

  Tên trường đọc từ chính hai mẫu issue; ước lượng và bộ câu đọc từ chính T10. Không có số liệu nào phải chép tay.

• CI: job docs thêm bước "Learning report (sample data)". Bước này chạy script trên 16 issue giả lập (tools/docs/fixtures/learning-issues.json, có 5 trường hợp sai cài sẵn) và so với báo cáo mẫu đã commit.

• training/README §8 "Đo hiệu quả học": hai số đo, cách tổng hợp, và khi nào sửa con số của tài liệu:

  • một lab có ≥ 5 báo cáo mà trung vị nằm ngoài ước lượng;
  • thời gian đọc lệch cùng chiều > 30% ở nhiều module;
  • câu vẫn 0 điểm ở lần đo sau.

• Thay đổi kèm theo:

  • §6 mentor: hỏi bộ vấn đáp hai lần.
  • T10 quy tắc 3: báo cáo lab bằng mẫu issue, kèm giờ làm thật.
  • T06 §4: thêm bước CI mới.
  • Sửa bảng "Bắt đầu từ đâu?" còn ghi lộ trình nhanh ≈ 3,5 giờ (đã là ≈ 4 giờ từ GĐ3).

Đã kiểm

• Hai mẫu issue qua schema github-issue-forms của SchemaStore. Một bản sai cài sẵn (dropdown thiếu options) bị bắt.
• Số liệu báo cáo trên dữ liệu mẫu, tính tay khớp:
  • L02: trung vị 3,5 giờ so với 3 giờ, lệch 17%;
  • L07: 29 giờ so với 16–24 giờ, lệch 21%;
  • Junior: (3/16 + 4/16)/2 = 21,9% → (14/16 + 13/16)/2 = 84,4%;
  • ⏱ T01 50/80 phút đọc đúng từ thẻ.
• Cả 5 trường hợp sai đều vào mục "Cần xem lại".
• Đối chứng âm của bước CI: đổi thời lượng L02 ở T10 §2 → đỏ; đổi tên một trường của mẫu issue → đỏ.
• Dự án sinh từ template (--IncludeDemos false): có hai mẫu issue, bước kiểm 0 lỗi.
• npm run check: 0 lỗi; workflow qua schema.

Chưa có

• Số liệu từ học viên thật. Bảng trạng thái kiểm chứng ghi rõ điều này.
• Mẫu issue chỉ hiện trên GitHub sau khi PR được merge vào nhánh mặc định.

🤖 Generated with Claude Code