[Tmphi]

GĐ3 (luyện nhớ lại), phần cuối. Phần 1 và 2 (khối ✅ sau mỗi mục 🎯) là PR #33 và #35.

Có gì

• tools/docs/build-deck.mjs sinh bộ thẻ ôn docs/training/deck/CadCoreFramework-flashcards.txt, tổng cộng 437 thẻ:
  • 268 câu hỏi từ 79 khối ✅: câu số N ghép với đáp án số N trong <details> ngay sau;
  • 144 thuật ngữ GLOSSARY: thuật ngữ → nghĩa, kèm "Xem: …";
  • 25 câu ngân hàng T10 §5.
• Định dạng là định dạng nhập văn bản của Anki: tab, HTML (code, chữ đậm, khối <pre>).
  • Tag theo module và nguồn: CadCore::T02, CadCore::tu-kiem-tra, CadCore::thuat-ngu::B, CadCore::ngan-hang.
  • GUID cố định theo vị trí câu hỏi trong tài liệu, để khi nhập lại thì cập nhật thẻ cũ thay vì nhân đôi.
  • Đầu file có các dòng #separator, #html, #deck, #columns, #tags column, #guid column.
• CI: job docs thêm bước "Review deck" (npm run deck, cũng nằm trong npm run check). Bước này đỏ khi:
  • file thẻ đã commit không khớp tài liệu (thông báo kèm lệnh cần chạy: node tools/docs/build-deck.mjs --write);
  • một khối ✅ có câu hỏi số N mà không có đúng một đáp án số N.
• training/README §3, "Lịch ôn": cách nhập và học theo tag trong Anki, và lịch không cần phần mềm (hôm sau, 1 tuần, 1 tháng). §5 trỏ tới mục này. §7 ghi quy tắc "đừng sửa tay file thẻ". Bảng trạng thái kiểm chứng có thêm một dòng.
• T06 §4: bảng các bước của job docs có thêm npm run deck.

Lỗi bước kiểm mới bắt được (đã sửa trong PR)

• U01 §8: câu 4 viết thành đoạn văn "Và 4: …", nên không ghép được với đáp án 4. Do tôi viết ở PR docs(training): ✅ tự kiểm tra sau mỗi mục 🎯 của U01–U03 (GĐ3 phần 2) #35.
• T09, khối ✅ cuối module: câu 1 (viết một ADR) không có đáp án. Đã thêm một đáp án nói cách chấm.
• T01, khối ✅ §7: `"DOOR,`*U*"` dùng code span một backtick, nên GitHub hiển thị sai (chữ U nghiêng, mất dấu *). Kiểm bằng gh api markdown: bản sửa dùng code span hai backtick hiển thị đúng "DOOR,U"`.

Đã kiểm

• npm run check: 0 lỗi. Mọi dòng thẻ đủ 4 cột, không trùng GUID.
• Đối chứng âm: sửa một đáp án trong T07 mà không sinh lại file thẻ → script thoát 1, chỉ ra lệnh cần chạy.
• Dự án sinh từ template (--IncludeDemos false, hive tạm): file thẻ được đổi tên thành TestDeck-flashcards.txt, bước kiểm vẫn 0 lỗi.
• dependabot.yml và workflow qua schema SchemaStore.

Chưa kiểm

• Chưa thử nhập vào Anki, vì máy kiểm chứng không có Anki. Định dạng theo tài liệu nhập văn bản của Anki 2.1.55 trở lên. training/README ghi rõ điều này.

🤖 Generated with Claude Code