Rà soát sách và khoá học, 28.09.2026

Rà soát theo yêu cầu của người soạn: cộng đồng nào thiếu sách hay khoá thì bổ sung, rồi chấm chất lượng theo tiêu chuẩn và nâng cấp tuần tự. Mọi con số dưới đây đo bằng script đọc D1 (chỉ SELECT), chạy lại được:

cd api.conan.school
python3 scripts/audit_books.py               # sách: 7 tiêu chí mức 3 của skill book-pack
python3 scripts/audit_course_pack_level.py   # khoá: mức 0-3 của skill course-pack
python3 scripts/audit_course_std.py --table  # khoá: thước SRC-609 (bản đọc gộp)

1. Số lượng

Chuẩn: 12 quyển mỗi cộng đồng (skill book-pack), khoảng 10 khoá mỗi cộng đồng (như các cộng đồng đã soạn). Không tính chua-phan-loai và ceo-executive (cả hai đang ẩn).

Cộng đồng	Sách	Khoá đang mở	Thiếu
retail	0	0	12 sách, 10 khoá
ai-technology	0	11	12 sách
customer-success	0	18	12 sách
people-hr	0	10	12 sách
product	0	10	12 sách
13 cộng đồng còn lại	12	10-15	đủ

2. Chất lượng sách: 156/156 đạt

Bảy tiêu chí: khung, thân bài đủ section_target, có con số, quiz không dồn đáp án, bìa, mức 1, bản EN. Trung vị 618 chữ mỗi section, mọi quyển có từ 20 câu quiz. Không quyển nào trượt tiêu chí máy đo được. Thước này là điều kiện cần: nó không chấm được câu chữ có đúng giọng nghề hay không.

cộng đồng              quyển  pub  đạt(>=90)  điểm TB  B1 B2 B3 B4 B5 B6 B7
beauty                    12   12         12      100   0  0  0  0  0  0  0
commerce                  12   12         12      100   0  0  0  0  0  0  0
drink                     12   12         12      100   0  0  0  0  0  0  0
education                 12   12         12      100   0  0  0  0  0  0  0
finance                   12   12         12      100   0  0  0  0  0  0  0
food                      12   12         12      100   0  0  0  0  0  0  0
founder                   12   12         12      100   0  0  0  0  0  0  0
health-fitness            12   12         12      100   0  0  0  0  0  0  0
home                      12   12         12      100   0  0  0  0  0  0  0
hospitality-travel        12   12         12      100   0  0  0  0  0  0  0
marketing                 12   12         12      100   0  0  0  0  0  0  0
operations                12   12         12      100   0  0  0  0  0  0  0
sales                     12   12         12      100   0  0  0  0  0  0  0

Tổng 156 quyển, đạt 156. Cột Bx = số quyển TRƯỢT tiêu chí đó.

3. Chất lượng khoá học

Thước dùng để kết luận là mức 3 của skill course-pack, vì đó là chuẩn hiện hành cho khoá soạn tay. Thước SRC-609 (audit_course_std.py) cho 5/212 đạt, nhưng nó còn chấm hành trình 5 chặng đã gỡ 28.08.2026 và câu kiểm course_concept_checks mà bộ biên dịch pack không sinh, nên con số đó đo sai thứ.

cộng đồng              khoá  M3  M2  M1  M0  unit6-9  lesson
ai-technology            11   1   9   0   1        1     108
beauty                   11  11   0   0   0        0      99
ceo-executive            11   1   9   0   1        1     108
commerce                 10   3   7   0   0        0      90
customer-success         18   2  16   0   0        0     162
drink                    10  10   0   0   0        0      90
education                11  10   1   0   0        0      99
finance                  10  10   0   0   0        0      90
food                     10   9   0   0   1        0      90
founder                  15   1   9   1   4        5     183
health-fitness           10   2   8   0   0        0      90
home                     10   2   8   0   0        0      90
hospitality-travel       10   2   8   0   0        0      90
marketing                12  10   0   0   2        2     138
operations               10   9   1   0   0        0      90
people-hr                10  10   0   0   0        0      90
product                  10   2   8   0   0        0      90
sales                    12  10   1   0   1        2     126

(Bảng trên chụp SAU khi migration cân đáp án ở mục 4 còn chưa áp.)

Ba nhóm việc:

1. 86 khoá mức 2, chỉ thiếu học liệu cấp unit (course_unit_elements kind material, CD-2 đòi ít nhất 2 mỗi unit). Mọi thứ khác của mức 3 đã đủ. Việc: thêm 2 học liệu cho mỗi unit trong pack rồi biên dịch lại.
2. Sót lẻ: food-course-02 có 5 outcome (chuẩn 2-4), course-offer/course-essay có lesson dưới 20 câu quiz.
3. 9 khoá đời cũ ở mức 0-1 (sinh bằng engine, không có pack): course-story, course-message, course-argument, course-problem-framing, course-learning, course-ai-builder, course-strategy, course-essay, và hai khoá mã c0c0c0c0-… (sales, marketing). Thiếu seed/spec/outcome và phần lớn lớp mức 2-3.

Một chỗ hai chuẩn lệch nhau

CD-1 của SRC-609 đòi 6-9 unit mỗi khoá; skill course-pack không đặt số unit, và gần như mọi khoá pack có 3 unit. Rà soát này không coi đó là lỗi của khoá mà là câu hỏi cho người soạn: nâng mọi khoá lên 6 unit là gấp đôi toàn bộ nội dung khoá học. Chưa làm cho tới khi có quyết định.

4. Đã làm ở lượt này

• Đáp án dồn vị trí: phần lớn lỗi "quiz" của khoá không phải thiếu câu mà là 91 lesson (10 khoá) có một vị trí chiếm hơn 40% đáp án đúng. Migration 20261002b01..14 đổi thứ tự phương án của 1.602 câu (không đổi chữ; bỏ qua câu có phương án kiểu "cả A và B"); pack edu-assessment sửa theo đúng phép hoán vị đó. Còn 1 lesson lệch vì các câu còn lại đều là loại tham chiếu, giữ nguyên có chủ ý.

5. Thứ tự nâng cấp tiếp

1. Retail: 10 khoá mức 3 + 12 sách mức 3 (cộng đồng trống hoàn toàn).
2. Sách cho ai-technology, customer-success, people-hr, product (48 quyển).
3. Nhóm 1: học liệu cấp unit cho 86 khoá.
4. Nhóm 2 và nhóm 3.

Mỗi bước là một PR, merge khi CI xanh, chấm lại bằng đúng các script trên sau khi CI áp migration.

6. Nhật ký nâng cấp

• 28.09, quyết định: giữ 3 unit mỗi khoá (không theo CD-1 6-9 unit).

• Retail xong: 10 khoá mức 3 (90 lesson, 1.800 câu quiz) và 12 sách mức 3 (240 section, bản EN, quiz, bìa vector), ảnh khoá 30 SVG. Migration 20261003a..20261003z. Khoá viết song song theo unit rồi soát khớp từng khoá (xem skill course-pack). Seed và các con số minh hoạ do agent viết theo ngoại lệ có hạn, người soạn cần đọc lại trước khi mở rộng.

• Sách cho 4 cộng đồng Occupation xong: ai-technology, customer-success, people-hr, product, mỗi kệ 12 quyển mức 3 (48 quyển, 960 section, bản EN, 960 câu quiz, 48 bìa vector). Migration 20261004a00..20261004d12d. Người soạn cần đọc lại các đoạn chạm pháp lý/lao động (people-hr) và sức khoẻ tinh thần (cs-book-10, ch05-s4).

• Học liệu cấp unit: 246 unit (82 khoá pack) có thêm 2 học liệu mỗi unit (mẫu làm Performance Task + bộ tư liệu dẫn đúng nguồn trong seed). Migration 20261005a_unit_materials.sql chỉ ghi phần học liệu, cùng câu lệnh bộ biên dịch pack.

• Sót lẻ xong: food-course-02 gộp outcome 4 và 5 (20261010a); course-offer và course-essay đủ 20 câu quiz mỗi lesson, thêm ví dụ, sửa 15 câu kiểm sau ví dụ bị sai đáp án (20261010b, nguồn content/courses/engine-fixes/).

• Thư viện: 18 cộng đồng x 20 báo cáo quốc tế dạng link (20261010c01..18), xem docs platform/communities.

• 9 khoá đời cũ lên mức 3: course-story, course-message, course-argument, course-problem-framing, course-learning, course-ai-builder, course-strategy và hai khoá c0c0c0c0-… (sales, marketing) viết lại thành CoursePack 3 unit × 3 lesson, giữ id/slug cũ (20261011a01..09); unit và lesson cũ chuyển archived (20261011b).

Rà soát biên tập Retail (03.10.2026)

Đọc lại 10 khoá và 12 quyển Retail: sửa số học, mâu thuẫn giữa bài và quiz, ranh giới (không tư vấn pháp lý/thuế), đổi mọi khẳng định "tư liệu lớp Conan" thành tình huống mẫu, cân lại đáp án bằng phép xáo mới. Migration 20261014a..f. Hai lỗi hệ thống ghi ở known-risks: chu kỳ đáp án, nguồn không có thật.

Cân đáp án và rà nguồn toàn kho (04.10.2026)

200 pack còn lại: cân lại đáp án bằng phép xáo có hạt giống (597 tệp unit), và đổi mọi khẳng định "tư liệu lớp Conan / buổi dạy thử / đã ẩn danh" thành tình huống mẫu; rationale "phát hiện thứ N trong chất liệu nền" đổi theo seed thành "điều thường gặp thứ N". Migration 20261016a001..200.