v1.9 — Bảy trang cùng một giao diện, tải về ở mọi trang

v1.9 — Bảy trang cùng một giao diện, tải về ở mọi trang

Bản này không sửa nội dung: 36 chương, 785 mục giữ nguyên từng chữ so với v1.8. Toàn bộ thay đổi nằm ở giao diện web và ở bộ sinh trang.

Một nav cho cả bảy trang

Năm trang tra cứu và trang tự kiểm tra trước đây có nav, cỡ chữ và bảng màu riêng; trang chủ thì không có nút tải sách. Nay cả bảy trang dùng chung nav của trang chủ:

• Nav có đủ Đọc sách · Theo tình huống · Pháp luật · Tải về · GitHub, tô đậm đúng trang đang mở.
• Màn hình nhỏ: Menu dạng details/summary, mở bằng Enter, đóng bằng Esc (trả tiêu điểm về Menu) hoặc bấm ra ngoài; mỗi dòng cao 44 px.
• Nav là HTML sinh sẵn, không cần JavaScript để hiện.

Chữ và lề khớp trang chủ

Đo trong trình duyệt trên cả bảy trang: chữ nội dung 15 px/1,65, đoạn dẫn 16 px/1,9, H1 38 px Georgia, H2 30 px Georgia, lề 48/28/18 px theo bề rộng màn hình. Trước đây các trang phụ dùng H1 44 px, H2 27 px, chữ 16/28, lề 24 hoặc 37 px. Bố cục 7 trang × 3 bề rộng (320/375/768 px) = 21 trường hợp, không trường hợp nào tràn ngang.

Nền tối vẫn theo cài đặt hệ điều hành, giữ nguyên khi chuyển trang; chữ trong menu nền tối 8,02:1, nút đổi nền 13,09:1.

Bộ sinh và cổng kiểm

• Nav do tools/lib/site-nav.mjs sinh, tools/site-pages.mjs ghi vào index.html, selfcheck.html giữa hai mốc <!-- site-nav:start --> / <!-- site-nav:end -->. Sửa nav tay sẽ bị ghi đè và site-pages --check báo đỏ.
• Bản HTML một tệp nay bắt buộc nhúng hết stylesheet và script: tools/offline/build.mjs dừng nếu không tìm thấy thẻ cần thay, tools/test-offline.mjs chặn mọi link[rel=stylesheet] còn sót. Đã thử phá cả hai (đổi thứ tự thuộc tính trong index.html, chèn stylesheet vào bản dựng) — cả hai đều đỏ đúng như mong đợi.
• CLAUDE.md ghi lại các mốc sinh nav và ba tệp dùng chung, để lần sau không sửa tay đoạn được sinh.

Bản tải về

Tệp	Dung lượng	Kiểm
EPUB	1,97 MB	epubcheck 5.4.0 trong CI: 0 lỗi
PDF	12,97 MB	dựng bằng typst 0.15.1, bookmark theo chương
HTML	5,29 MB	một tệp, không stylesheet/script ngoài — mở bằng file:// vẫn dùng được
Anki	0,32 MB	785 thẻ, GUID giữ nguyên nên không sinh thẻ trùng

Còn tồn, không chặn bản này

• Giao diện mới đo bằng Chromium; chưa chạy Safari và Firefox thật (marker của summary, hành vi details), chưa chạy axe/Lighthouse đầy đủ.
• Chữ phụ 11–12 px màu #6c7267 trên nền giấy đạt 4,38:1, dưới ngưỡng AA 4,5:1 — có từ trước.
• Menu điện thoại là <div> trong nav chính, không phải landmark riêng (đổi để hết hai landmark lồng nhau).
• Ba câu ở bìa và trang giới thiệu PDF bị dính chữ do thẻ <br> trong README (từ v1.7); bìa PDF vẫn dùng ảnh chia sẻ 1200×630; updates.json còn dồn mục về nhóm "mới trong 7 ngày".

Ghi công

Nội dung dựa trên HowToLiveLonger của eternity4719, giấy phép CC BY 4.0. Bản Việt hoá và mở rộng do quangpao biên soạn.

Sách (EPUB / PDF / HTML offline / Anki, tự cập nhật)

Bản nội dung e25fd89, dựng lúc 2026-11-07 14:11 (giờ Việt Nam). Gồm EPUB, PDF, HTML một file và bộ thẻ Anki; nội dung đổi là tự dựng lại, link tải giữ nguyên.

v1.8 — ID mục cố định, tra nhanh chương, trích dẫn luật có nguồn

v1.8 — ID mục cố định, tra nhanh chương, trích dẫn luật có nguồn

Bản này không sửa nội dung: 36 chương, 785 mục, 464 trường pháp luật giữ nguyên từng chữ so với v1.7. Toàn bộ thay đổi nằm ở cách trỏ tới mục và cách trình bày phần luật.

Mỗi mục có một địa chỉ cố định

Trước đây liên kết chéo ghi #e-2-2 (chương 2, mục 2) — thêm hay bớt một mục là mọi liên kết phía sau lệch hết. Nay mỗi mục có mã theo nội dung, ví dụ #entry-khong-hut-trong-nha-va-tren-xe-cung-dung-de-khach-hut:

• 785 mã mục, không trùng; 785 đường dẫn cũ dạng #e-N-N vẫn dùng được, tự chuyển sang mã mới.
• 635 liên kết trong sách đã chuyển sang mã mới; bộ quét đích tăng từ 741 lên 927 chỗ, đều trỏ đúng và có neo.

Tra nhanh chương

Mỗi chương có bảng gấp gọn "Tra nhanh chương này": số thứ tự, nội dung, mức bằng chứng. Bấm một dòng là nhảy tới đúng mục. Có trên cả ba bản: web, PDF (36/36 chương), EPUB.

Trích dẫn luật có nguồn để đối chiếu

Hai đoạn luật ở chương 2 mục 2 nay hiện đúng nguyên văn, kèm phiên bản, ngày đối chiếu, vị trí (trang/khoản/điều) và đường dẫn tới văn bản gốc:

• Điều 11 Luật Phòng, chống tác hại của thuốc lá 09/2012/QH13 — bản gốc 18/6/2012, vanban.chinhphu.vn.
• Khoản 1 Điều 24 Nghị định 90/2026/NĐ-CP — trang 32 bản ký, datafiles.chinhphu.vn. Mức phạt 200.000–500.000 đồng với hành vi hút thuốc tại địa điểm có quy định cấm.

Bấm vào cụm dẫn luật để mở hộp nguyên văn; trỏ vào để xem trước. 462 trường pháp luật còn lại vẫn là diễn giải của cẩm nang kèm nguồn, không phải trích nguyên văn.

Bản tải về

Tệp	Dung lượng	Kiểm
EPUB	1,50 MB	epubcheck 5.4.0: 0 lỗi, 0 cảnh báo; 785 neo mục
PDF	11,81 MB	831 trang, 835 bookmark, bảng tra nhanh 36 chương, phụ lục trích dẫn có link quay lại
HTML	5,19 MB	một tệp, nhúng sẵn bảng trích dẫn — mở bằng file:// vẫn xem được nguyên văn, không cần mạng
Anki	0,32 MB	785 thẻ, GUID trùng khít bản v1.7 nên không sinh thẻ trùng

Còn tồn, không chặn bản này

• Ba câu ở bìa và trang giới thiệu PDF bị dính chữ do thẻ <br> trong README (có từ v1.7).
• Bìa PDF vẫn dùng ảnh chia sẻ 1200×630, chưa dùng ảnh bìa minh hoạ mới của bản web.
• tools/epub/package-lock.json trỏ registry gương Trung Quốc, npm ci trên máy cá nhân bị chặn (CI không ảnh hưởng).
• Chữ phụ 11–12px màu #6c7267 trên nền giấy đạt 4,38:1, dưới ngưỡng AA 4,5:1.
• updates.json còn dồn 785 mục về nhóm "mới trong 7 ngày".

Ghi công

Nội dung dựa trên HowToLiveLonger của eternity4719, giấy phép CC BY 4.0. Bản Việt hoá và mở rộng do quangpao biên soạn.

v1.7 — Chế độ Đọc sách: một chương một cột chữ, nhớ vị trí đọc

Thêm chế độ Đọc sách bên cạnh Bảng tra cứu và Theo chương. Nội dung sách không đổi: 785 mục, 36 chương.

Đọc sách

• Mở trọn một chương trên một cột chữ serif, khổ chữ 19px, dòng giãn 1,9 — dễ đọc hơn bảng tra cứu và hộp chi tiết.
• Mục lục 36 chương bên trái, đánh dấu chương đang đọc và tự cuộn tới đúng chỗ; trên điện thoại mục lục thu thành drawer.
• Thanh dưới có chương trước, chương sau và tiến độ đọc trong chương.
• Chỉnh cỡ chữ bằng A− / A+, đổi nền sáng/tối riêng cho chế độ đọc.
• Khối Nói dễ hiểu được tách thành ô riêng, nền xanh nhạt, viền trái, chữ to hơn thân bài 6% để dễ nhận ra.

Đọc liền mạch

• Vị trí đọc và cỡ chữ lưu trên thiết bị: tải lại trang hoặc quay về chế độ đọc thì tiếp tục đúng chỗ cũ.
• Liên kết từng mục và tham chiếu chéo (mục N) giữ người đọc trong trang sách, hỗ trợ Back/Forward của trình duyệt.
• Bộ lọc tra cứu được giữ trong phiên khi chuyển qua lại giữa các chế độ.
• Chỉ dựng chương đang mở, không thêm thư viện ngoài.

Bản offline và CI

• Bản HTML một file nhận cùng chế độ đọc, mở bằng file:// vẫn chạy.
• Thêm tools/test-reader.mjs vào CI: kiểm liên kết của 785 mục trong 36 chương, khôi phục vị trí đọc khi số mục đổi, và biên trên/dưới của cỡ chữ.

Đã kiểm

Chín job CI xanh trên commit phát hành. Cổng local sau khi ghép với vi: linter văn phong 0 ERROR / 392 WARN, "Nói dễ hiểu" 785 mục 0 chỗ chưa đạt, cấu trúc pháp luật 464 mục, tách câu 2.819 trường, tham chiếu chéo 741 chỗ, số liệu thống kê và updates.json khớp, test-reader và test-repo-links đạt.

Đã thử trên trình duyệt

Desktop và khung 390px: mở chế độ đọc, chuyển chương, mục lục, A−/A+, nền tối, bấm tham chiếu chéo rồi Back, tải lại để kiểm khôi phục vị trí, cuộn tới đáy chương để kiểm tiến độ 100% và khoảng trống dưới dòng cuối, bản offline bằng file://.

Còn treo

• Cột chữ 740px tương đương 81 ký tự một dòng: trong ngưỡng đọc được nhưng vẫn rộng hơn mức thoải mái 65–75; có thể siết max-width khoảng 10% nếu thấy mỏi mắt.
• Tham chiếu (mục N) đôi khi ngắt dòng giữa cụm; thêm white-space: nowrap là gọn.
• Chữ phụ 11–12px ở trang tra cứu vẫn dùng màu --t3 đạt tương phản 4,38:1, dưới ngưỡng AA 4,5:1.
• updates.json vẫn dồn toàn bộ 785 mục về "mới trong 7 ngày" do đợt viết lại lịch sử ở PR #9; cần một lượt sửa dữ liệu.

v1.6 — Giao diện mới: nền giấy, bảng tra cứu, ảnh bìa và biểu tượng

Làm mới giao diện trang tra cứu, thêm ảnh bìa và biểu tượng riêng. Nội dung sách không đổi: 785 mục, 36 chương.

Trang tra cứu

• Nền giấy kem, điểm nhấn xanh lá, tiêu đề serif. Bỏ thanh bên cố định và các thẻ dài.
• Bảng tra cứu có tìm kiếm, bộ lọc thu gọn, sắp xếp theo việc nên làm / chương / bằng chứng, phân trang 40 mục một trang.
• Mở một mục để xem Chi phí, Lợi ích, Pháp luật Việt Nam, Ghi chú và Nguồn, kèm nút nhảy tới vị trí trong chương.
• Giữ cách đọc theo chương và các liên kết mục cũ, nên đường dẫn đã chia sẻ vẫn dùng được.

Ảnh bìa và biểu tượng

• Ảnh bìa mới: cuốn sách mở thành lối đi qua khu vườn và ngôi nhà Việt, có cây xanh, đồng hồ cát và tiền tiết kiệm. JPEG 1536 × 1024, khoảng 661 KB.
• Biểu tượng sách–chồi lá dùng chung cho đầu trang và favicon của cả hai trang, nhúng trực tiếp vào bản offline.
• Ghi công, nguồn gốc tài nguyên và prompt tạo ảnh nằm trong assets/README.md.

Trang tự kiểm tra và bản offline

• Trang tự kiểm tra đồng bộ màu và kiểu chữ với trang tra cứu.
• Bản offline một file nhúng ảnh bìa và biểu tượng, dùng font hệ thống.

Đã kiểm

Tám job CI xanh trên commit phát hành. Cổng local sau khi ghép với vi: linter văn phong 0 ERROR / 392 WARN, "Nói dễ hiểu" 785 mục 0 chỗ chưa đạt, cấu trúc pháp luật 464 mục, tách câu 2.819 trường, tham chiếu chéo 741 chỗ, số liệu thống kê và updates.json khớp.

Đã thử trên trình duyệt

Desktop và khung 390px: tìm kiếm, kết quả rỗng, bộ lọc, sắp xếp, phân trang, mở chi tiết, Escape, chuyển chương, nền tối, bản offline. Ở khung 390px bảng chuyển thành thẻ một cột, không tràn ngang.

Còn treo

• Đọc liền mạch kiểu sách (một cột hẹp, điều hướng chương, lưu vị trí đọc) chưa làm; để thành hạng mục riêng.
• Cột chữ trong hộp chi tiết rộng khoảng 115 ký tự một dòng, rộng hơn mức đọc thoải mái; sẽ chỉnh khi làm chế độ đọc sách.
• Chữ phụ 11–12px dùng màu --t3 đạt tương phản 4,38:1, dưới ngưỡng AA 4,5:1; đổi sang #5a6157 là 5,67:1.
• Dòng "Cập nhật 7 ngày qua" đang báo toàn bộ 780 mục là mới, do updates.json bị dồn ngày sau đợt viết lại lịch sử ở PR #9; cần một lượt sửa dữ liệu.

v1.5 — Thêm 5 mục mới, 785 mục (lao, phân đen, hợp đồng lao động, sở thích, bệnh thận)

Thêm 5 mục chuyển từ bản gốc tiếng Trung, nhưng viết lại theo bối cảnh Việt Nam: 785 mục, 36 chương.

Năm mục mới

• Chương 1 · mục 49 — Ho kéo dài từ hai tuần, khạc đờm hoặc đờm có máu thì đi khám lao. Đã chẩn đoán thì uống đủ phác đồ, đừng thấy đỡ mà dừng. Việt Nam đứng thứ 12 trong 30 nước có gánh nặng lao cao nhất; mỗi năm khoảng 182.000 ca mới và 11.000 người chết.
• Chương 13 · mục 49 — Phân đen, dẻo, dính như hắc ín thì đi cấp cứu trong ngày. Chóng mặt, vã mồ hôi hoặc nôn ra máu thì gọi 113 hoặc 115. Người chỉ có phân đen là nhóm hay chần chừ nhất, mà trong nghiên cứu dưới đây họ đến viện muộn hơn hẳn và phải truyền máu nhiều hơn.
• Chương 19 · mục 25 — Ký hợp đồng lao động thì cầm về một bản. Lỡ ký trên tờ còn trắng thì ngay hôm đó nhắn tin yêu cầu điền đủ và giao bản cho mình. Luật buộc hợp đồng làm hai bản, mỗi bên giữ một.
• Chương 22 · mục 13 — Từ 65 tuổi, nuôi một sở thích và duy trì đều. Đừng lấy nó thay cho điều trị trầm cảm. Gộp 5 nghiên cứu theo dõi ở 16 nước, 93.263 người; hiệu quả nhỏ nhưng rẻ.
• Chương 34 · mục 14 — Bệnh thận mạn thì đừng tự mua ibuprofen dùng dài ngày, và đừng ăn quả khế hay uống nước khế. Khế độc với người thận kém: trong 32 ca đã báo, hơn hai phần mười bị co giật, ca nặng không chạy thận thì chết.

Không bê số liệu của bản gốc

Toàn bộ số của Trung Quốc được thay bằng nguồn khác: ước tính của WHO cho Việt Nam, số phát hiện của Chương trình Chống lao quốc gia, nghiên cứu quốc tế, và pháp luật Việt Nam. Phần luật của mục hợp đồng viết theo Điều 14 và Điều 190 Bộ luật Lao động 45/2019/QH14, Điều 9 Nghị định 12/2022/NĐ-CP.

Kiểm lại trước khi phát hành

Đợt rà nguồn tìm ra hai chỗ phải sửa: số cấp cứu (từ 1/11/2026 tổng đài 113 tiếp nhận cấp cứu ngoài bệnh viện, vẫn gọi được 115 trong thời gian chuyển tiếp) và mốc ho hai tuần (nay có căn cứ trong hướng dẫn của Bộ Y tế). Bỏ hai câu không kiểm được, sửa danh sách nhóm nguy cơ lao về đúng nguyên văn WHO, đổi một link trả lỗi 403.

Đã kiểm

Tám job CI xanh trên commit phát hành. Cổng local: linter văn phong 0 ERROR, "Nói dễ hiểu" 785 mục 0 chỗ chưa đạt, cấu trúc pháp luật 464 mục, tách câu 2.819 trường, tham chiếu chéo 741 chỗ đều trỏ đúng và có neo, số liệu thống kê, updates.json khớp. Mọi DOI tra lại trên Crossref, mọi con số đối chiếu với phần tóm tắt bài gốc.

Còn treo

• Sách còn vài chục chỗ gọi 115 ở các chương khác. Trong thời gian chuyển tiếp vẫn gọi được nên chưa sai, nhưng cần một lượt rà riêng đổi sang "113 hoặc 115".
• Mục 19#25: Nghị định 12/2022 không có mức phạt riêng cho việc không giao bản hợp đồng; bài nói rõ chỗ này để không ai hiểu sai.
• Mục 22#13 chỉ có dữ liệu theo dõi ở người từ 65 tuổi, không có thử nghiệm chia nhóm.
• 392 cảnh báo của linter văn phong vẫn còn, chưa chặn CI.

v1.4 — Bỏ bản gốc tiếng Trung, thêm chương 35-36 (780 mục)

Bản này bỏ hẳn bản gốc tiếng Trung khỏi repo và chỉnh nội dung cho đúng bối cảnh Việt Nam. Số mục: 767 thành 780, số chương: 34 thành 36.

Bỏ bản gốc tiếng Trung

• Xoá 289 file: README.cn.md, 衍生项目.md, 34 chương Trung trong book/, 6 bài dài Trung, 引用对照.md, toàn bộ docs/核实记录/, ảnh QR WeChat, .github/FUNDING.yml, hai mẫu issue tiếng Trung.
• Công cụ, trang web, README thôi trỏ vào file Trung. sitemap.xml và robots.txt về quangpao.github.io (trước vẫn là eternity4719.github.io).
• Mẫu issue viết lại bằng tiếng Việt.
• Ghi công eternity4719 giữ nguyên: giấy phép CC BY 4.0 bắt buộc.

Nội dung hợp Việt Nam

• Xoá 2 mục: chương 05 mục 34 (đá quý, dấu CMA) và chương 17 mục 6 (thế chấp nhà lấy lương hưu).
• Viết lại 20 mục: bỏ câu so sánh với luật Trung Quốc, thay số liệu Trung Quốc bằng số Việt Nam khi có. Ví dụ mục 1.5 bỏ thống kê ngộ độc nấm của Trung Quốc, thay bằng số của Bộ Y tế cho 11 tháng năm 2024: 131 vụ, 4.796 người mắc, 21 người chết.
• Thêm chương 35 — bão, lũ, muỗi (10 mục) và chương 36 — xe máy và đường phố (5 mục), theo Luật 36/2024/QH15 và Nghị định 168/2024/NĐ-CP.

Sách điện tử

• Ngôn ngữ trong EPUB và PDF đổi từ zh-CN sang vi. Trước đây sách tiếng Việt bị gắn nhãn tiếng Trung, ảnh hưởng ngắt từ và phông chữ.
• "目录" thành "Mục lục", tác giả quangpao, eternity4719 ghi là người đóng góp.

Tài liệu

• CLAUDE.md dịch sang tiếng Việt.
• Bỏ hai chỗ trong CLAUDE.md còn dẫn tới file đã xoá.

Đã kiểm

Tám job CI xanh trên commit phát hành: tham chiếu chéo, văn phong tiếng Việt, "Nói dễ hiểu", cấu trúc pháp luật, tách câu, số liệu thống kê, trang tự kiểm tra, build. Cổng local: linter 0 ERROR / 392 WARN, 780 mục, 463 mục có trường pháp luật, 737 chỗ tham chiếu đều trỏ đúng và có neo. Không URL nguồn nào bị mất.

Còn treo

• Số liệu Trung Quốc đã thay bằng số Việt Nam ở 20 mục; mới kiểm được là không mất nguồn, chưa đối chiếu từng câu với văn bản gốc.
• Xoá 2 mục làm các mục sau trong chương 05 và 17 dời số. Neo trong repo vẫn đúng, nhưng link bên ngoài trỏ theo số cũ sẽ lệch.
• docs/kiem-chung/ còn các mục "Đối chiếu bản gốc tiếng Trung" — nhật ký lịch sử, không phải nội dung sách. docs/pipeline/ đã lỗi thời.
• CLAUDE.md còn 30 dòng có chữ Hán, chủ yếu là trích dẫn và tên gốc giữ làm mốc đối chiếu.
• 392 WARN của linter văn phong vẫn còn, chưa chặn CI.

v1.3 — Thống nhất chính tả, thuật ngữ và gọn ô Ghi chú

Bản này chỉ sửa chữ, không thêm bớt mục nào. Số liệu, điều luật, nguồn giữ nguyên.

Thống nhất chính tả và thuật ngữ

• Khoảng 1.200 dòng ở 34 chương, README, trang tự kiểm tra và hai bản SKILL.md chuyển sang kiểu "hòa, khỏe, tòa, thủy, ủy". Không đụng "quý", "hoàn", URL, bản Trung, sổ kiểm chứng.
• "vắc-xin" và "vaccine" thành vắc xin; "thử nghiệm chia nhóm ngẫu nhiên" thành thử nghiệm ngẫu nhiên. Tên bài báo tiếng Anh trong Nguồn giữ nguyên.
• Ô tìm kiếm gõ "hoà" hay "hòa", "khoẻ" hay "khỏe", "uỷ" hay "ủy" đều ra cùng kết quả: trang tra cứu thêm một bước chuẩn hoá dấu thanh, độ dài chuỗi không đổi nên tô sáng từ khoá vẫn đúng chỗ.

Ô Ghi chú

• Bỏ tiền tố "Vì sao mức A/B/C:" ở 475 ô. Dòng "Mức bằng chứng" ngay trên đã nói mức, nên ô Ghi chú vào thẳng lý do. Bốn ô có dạng riêng thì sửa tay.

Sửa lỗi

• Lỗi gõ và dấu câu: "khi khi", "và và", ,,, .:, .,, .;, hai dấu cách sau dấu chấm.
• README: "đậu phộ", mục lục chương 13 bị cụt, 22 dòng mục lục thiếu dấu chấm.
• Vài cụm khuôn sáo: "bản này", "Điều đáng nói là" ở 4 chỗ.

Câu trích văn bản luật giữ chính tả gốc

Văn bản pháp luật vẫn viết "huỷ", "xoá", "thoả thuận", "hàng hoá". Tám câu trích nguyên văn ở bảy mục được giữ đúng chữ trong luật (05 mục 41 và 43, 07 mục 23, 08 mục 27, 17 mục 5, 26 mục 3, 31 mục 12), để người đọc search được nguyên cụm trên vbpl.vn. Ngoài phần trích, sách dùng kiểu thống nhất.

Đổi văn phong

• Bốn mục ở chương 1 và 19 được viết lại: tách câu dài, bỏ câu dẫn thừa. Không đổi số.

Đã kiểm

Tám job CI xanh trên commit phát hành: tham chiếu chéo, văn phong tiếng Việt, "Nói dễ hiểu", cấu trúc pháp luật, tách câu, số liệu thống kê, trang tự kiểm tra, build. 767 mục trước và sau, không mục nào thêm hay mất; không số liệu, URL hay điều luật nào bị mất.

Còn treo

• 81 tiêu đề mục đổi chữ (chỉ dấu thanh). Neo trong repo vẫn đúng, nhưng link bên ngoài trỏ theo tiêu đề cũ sẽ chết.
• Linter văn phong báo 379 WARN (câu mở đầu quá 25 từ, câu quá 40 từ, từ viết tắt chưa giải nghĩa). Chưa chặn CI, là danh sách việc cho lượt biên tập sau.
• Chưa đối chiếu lại điều luật với văn bản gốc. Chương 1 mục 13 còn câu "như đứng một chân, xoay người, bước lùi" ghép từ đoạn bị cụt, cần so lại bản gốc.

v1.2 — Chuẩn hoá hành văn và linter tiếng Việt

Bản này chỉ sửa hành văn và thêm công cụ kiểm. Không thêm, không bớt mục nào; số liệu và kết luận pháp luật giữ nguyên.

Đổi tiêu đề ba chương cho đúng giọng

• Chương 02: "Đừng chết dần" → Đừng để bản thân chết mòn
• Chương 11: "Những vạch đỏ mà người làm kỹ thuật hay vấp" → Những lằn ranh đỏ mà người làm kỹ thuật hay vấp
• Chương 34: "Thuốc trong nhà đừng để ăn hại" → Thuốc trong nhà: đừng để phản tác dụng

Slug file và số chương không đổi, nên mọi link cũ vẫn vào đúng chỗ. Mục lục README và bảng câu hỏi đã sửa theo.

Sửa ngôi xưng

• README: "Việc nào mình đã làm rồi" → "Việc nào bạn đã làm?"
• Trang tự kiểm tra: hai câu đổi từ "mình" sang "bạn" cho khớp phần còn lại của trang.
• Bài dài pháp luật: "việc mình đang gặp" → "tình huống bạn đang gặp".
• Chương 31: "bệnh mãn tính" → "bệnh mạn tính" ở hai chỗ.

Công cụ mới

• tools/lint-vi.mjs: quét 34 chương, README, bài dài pháp luật và trang tự kiểm tra. Chặn ở mức ERROR khi gặp thuật ngữ đã cấm, chỉ số nghiên cứu lọt vào "Nói dễ hiểu", sai số thứ tự mục, sai số chương hoặc số mục. Cảnh báo WARN khi câu mở đầu quá 25 từ, câu quá 40 từ, từ viết tắt chưa giải nghĩa, cấu trúc dịch sát. Có --all để xem hết và --strict nếu muốn không còn cảnh báo nào.
• tools/test-lint-vi.mjs: ba ca kiểm thử cho chính linter.
• Job CI mới "Kiểm văn phong tiếng Việt", chạy cùng bảy job cũ.
• STYLEGUIDE.vi.md thêm checklist trước khi mở PR; docs/vi-find-replace-map.md ghi lại từng chỗ định thay và ngoại lệ.

Trạng thái linter trên toàn sách

37 file, 767 mục: 0 ERROR, 379 WARN. WARN chưa chặn CI vì phần lớn nằm ở nội dung cũ viết từ trước. Đây là danh sách việc cho các lượt biên tập sau, không phải lỗi của bản này.

Đã kiểm

Tám job CI xanh trên commit phát hành: tham chiếu chéo, văn phong, "Nói dễ hiểu", cấu trúc pháp luật, tách câu, số liệu thống kê, trang tự kiểm tra, build. Số mục từng chương không đổi: 47 / 21 / 17 / 13. updates.json khớp.

Còn treo

• Ba sổ kiểm chứng trong docs/kiem-chung/ (chương 02, 11, 34) vẫn ghi tiêu đề cũ.
• Chương 31 mục 2: câu nhắc Điều 14 Luật Nghĩa vụ quân sự đã đổi sang "mạn tính", trong khi văn bản luật viết "mãn tính"; ai tra theo chữ trong luật sẽ không khớp.
• 379 WARN chưa xử lý.

v1.1 — 460 mục có pháp luật Việt Nam

Bản này thêm một lớp tra cứu pháp luật Việt Nam. Nội dung y khoa không đổi.

Pháp luật Việt Nam, tách theo từng mục

• 460 trong 767 mục có thêm trường Pháp luật Việt Nam: điều khoản, thời hạn, mức phạt, ngoại lệ, để riêng khỏi phần lợi ích và bằng chứng nghiên cứu.
• 307 mục còn lại giữ nguyên cách viết cũ, quy định vẫn nằm trong "Lợi ích" hoặc "Ghi chú".
• Chương 04 không có đoạn nào đủ rõ để tách, lý do ghi trong docs/kiem-chung/tach-phap-luat-tien-do.md.

Trên trang tra cứu

• Bộ lọc mới: mở https://quangpao.github.io/HowToLiveBetter/?legal=1 để xem 490 mục có dẫn quy định (460 mục có khối chi tiết, 30 mục chỉ dẫn văn bản ở "Nguồn").
• Mỗi thẻ mục có khối "Pháp luật Việt Nam" mở tại chỗ; mục chưa tách có một dòng nói rõ là chưa có phần chi tiết.
• Bài dài mới: docs/phap-luat-viet-nam.md — tra theo vấn đề, mở ngay trong popup của trang, không phải sang GitHub.

Sửa lỗi

• Link bài dài trước đây trỏ nhánh main (bản tiếng Trung), bấm vào là rời trang và với bài mới thì 404. Nay trỏ nhánh vi và mở bằng popup, cả bản offline một file.
• README hàng "Bài dài" trước ghi "Chưa có" dù bài dài đã có; nay đã liệt kê ở nav, ở dòng mục lục và ở "Bài dài xem thêm".

Đã kiểm

• 767 mục trước và sau: không thêm, không xoá, không đổi số; không đổi tiêu đề, nhãn chi phí, mức bằng chứng; không mục nào mất "Nói dễ hiểu", "Lợi ích" hay "Nguồn".
• Bảy cổng CI xanh trên commit phát hành: tham chiếu chéo, "Nói dễ hiểu", cấu trúc pháp luật, tách câu, số liệu thống kê, trang tự kiểm tra, build. Thêm ba test hồi quy cho check-draft, check-legal, test-repo-links.

Còn treo

• Hiệu lực và số điều của 460 trường pháp luật chưa được thẩm định độc lập. Việc tách là lượt biên tập, không phải chứng nhận pháp lý. Đối chiếu văn bản đang có hiệu lực trước khi dùng, nhất là mức phạt, thời hạn và quyền lợi.
• 30 mục chỉ dẫn văn bản ở "Nguồn" mà chưa tách (ví dụ chương 05 mục 39 Nghị định 67/2023, chương 13 mục 15 Thông tư 51/2017, chương 06 mục 33 Thông tư 22/2023).
• Chương 01 mục 10 viết "Luật chỉ áp dụng khi trẻ thoả mãn đồng thời dưới 10 tuổi và cao dưới 1,35 m"; luật dùng chữ "và", cách đọc "đồng thời" cần người có chuyên môn xác nhận.