Quy trình xuất bản HTML CXK
Phiên bản 0.2 · 26/09/2026 · Có nguyên mẫu kiểm tổng hợp; chưa tích hợp cơ chế cưỡng chế trong bộ sinh trang.
Không sinh website tài liệu vàohtml/, không sửa đầu ra cũ và không đăng website.
1. Quy tắc dừng hiện tại
Mọi lần sinh trang đều bị chặn khi chưa có danh sách cho phép rõ ràng. Quy tắc áp dụng cả bản nội bộ và công khai.
Danh sách phải xác định file, phiên bản, đối tượng đọc, quyền sử dụng và tài nguyên được kéo theo.
Chỉ có nhãn “nội bộ” không đủ để bỏ qua kiểm quyền hoặc dữ liệu nhạy cảm.
Không chạy bộ sinh trang quét toàn kho để xem thử rồi mới xóa tài liệu cấm.
Đây là quy tắc vận hành bằng hồ sơ. Chưa có bằng chứng các builder hiện có tự cưỡng chế quy tắc này.
Nếu công cụ chưa giới hạn được đầu vào và tài nguyên kéo theo, tiếp tục chặn sinh trang.
Cho phép sửa công cụ hoặc soạn quy trình không đồng nghĩa cho phép chạy sinh trang hay phát hành.
Đợt 2 đã có nguyên mẫu kiểm trước xuất bản.
Đây không phải bộ sinh trang hoặc công cụ xác minh phê duyệt.
Việc dựng frontend mô phỏng tại TEMP và xem loopback không phải xuất bản website tài liệu vào html/.
2. Phân luồng nội bộ và công khai
| Loại nội dung | Bản nội bộ | Bản công khai | Điều kiện |
|---|---|---|---|
| Tài liệu quản trị kỹ thuật | Có thể xét từng file; chưa tự cho phép | Không mặc định công khai | Q08, chủ nội dung, danh sách cho phép và quyền truy cập |
| Nhật ký, prompt, hồ sơ AI, biên bản có danh tính | Giới hạn người cần biết; kiểm dữ liệu trước | Chặn nguyên bản | Chỉ xét bản đã loại dữ liệu sau quyết định riêng |
| Nguồn sách, tài liệu gốc, bản OCR | Chặn khi chưa rõ quyền tương ứng | Chặn tải lại/công bố khi chưa có quyền | Đọc được nguồn không đồng nghĩa được xuất HTML hoặc tải xuống |
| KC/FAQ DRAFT, nội dung xung đột | Không xuất làm tài liệu hướng dẫn sử dụng | Chặn | Review đúng phiên bản và quyền trước khi xét phát hành |
| Nội dung y khoa được duyệt | Vẫn cần kiểm quyền, phiên bản và đối tượng đọc | Chỉ xét phần được phép riêng | Danh mục nguồn, chứng cứ review và phạm vi công bố |
| Consent có chữ ký, chat, khảo sát, video, khóa dịch vụ | Không đưa vào bộ trang tĩnh | Chặn | Giữ tại vùng dữ liệu hạn chế; không sinh vào output trung gian |
| Hướng dẫn kỹ thuật không nhạy cảm | Có thể xét từng file | Có thể xét từng file | Kiểm độ đúng, bí mật, tài nguyên phụ và người chịu trách nhiệm |
| Báo cáo, poster hoặc sản phẩm học thuật | Kiểm nguồn gốc bản đầu NCS và quyền dữ liệu | Chờ GD và thẩm quyền công bố | Không công bố bản AI như sản phẩm độc lập của NCS |
“Có thể xét” không phải quyền đã cấp. Q08 hiện chưa có câu trả lời.
Không dùng robots.txt, noindex hoặc URL khó đoán làm kiểm soát truy cập nội bộ.
Website nội bộ cần cơ chế xác thực/phân quyền thật và phép thử truy cập không đăng nhập.
3. Điểm vào công cụ cần kiểm trước khi chọn
📄 tools/build_docs_site.py.📄 tools/build_html_site.py.📄 tools/build_hub_pages.py.📄 tools/link_audit.py.- Quy trình Obsidian nếu chọn công cụ của nhánh này.
T15/K03 phải chọn một đường sinh trang đã kiểm. Không chạy nhiều builder liên tiếp mà không biết chúng bổ sung gì.
Kiểm cả đường quét thư mục, include, copy tài nguyên, hub, danh mục A–Z, tìm kiếm, sitemap và nút tải xuống.
Không kết luận an toàn từ tên file hoặc chỉ đọc phần cấu hình đầu vào.
Kiểm link thực tế đã có kiểm thử kỹ thuật. Việc sửa kiểm link không tự thêm bộ lọc quyền cho builder.
Nguyên mẫu đợt 2 — giới hạn đã triển khai
📄 KIEM_TRA_TRUOC_XUAT_BAN.py chỉ đọc gói tổng hợp được chỉ định.
Công cụ kiểm cấu trúc bản kê, mã băm, đường dẫn và phụ thuộc trong tập con cú pháp hạn chế.
Nó không phân tích đầy đủ Markdown, không xác minh nội dung ảnh hoặc sự tồn tại của anchor.
Không quét toàn kho, gọi mạng, sinh trang, ghi báo cáo hoặc sửa đầu ra.
Ba cờ luôn false: build_executed, publication_authorized, human_approval_verified.
Mã thoát 0 chỉ là nhất quán kỹ thuật trong phạm vi hỗ trợ; không cho phép tự gọi builder.
Chưa tích hợp bộ sinh trang, thư mục dựng riêng, kiểm đầu ra cũ, search, sitemap, xác thực hoặc thu hồi.
Kiểm thử tổng hợp không chứng minh H01–H12 đã đạt trên đường xuất bản thật.
Biên bản đợt 2 ghi bằng chứng tích hợp do nhánh chính quản lý.
4. Hồ sơ cho phép trước lần sinh đầu tiên
Người phụ trách cần lập danh sách theo từng file, không dùng mẫu **/* hoặc toàn thư mục làm mặc định.
| Trường bắt buộc | Nội dung phải ghi | Khi thiếu |
|---|---|---|
| Định danh lần xuất và mục đích | Bản nội bộ hay công khai; người đọc; lý do | Dừng |
| Nguồn và phiên bản | Đường dẫn tương đối; phiên bản hoặc mã băm | Dừng nếu thay nguồn sau review |
| Quyền và trạng thái nội dung | Dẫn sổ quyền, nguồn review; phạm vi thao tác được phép | Không sao chép giá trị phê duyệt sang bảng thứ hai |
| Đích dự kiến | Trang, ảnh, CSS/JS, file tải xuống, dữ liệu tìm kiếm | Dừng khi chưa biết tài nguyên đi kèm |
| Quyết định thực tế | Người có thẩm quyền; ngày; phạm vi; điều kiện | Không điền sẵn tên người ký |
| Loại trừ | File cấm, thư mục riêng tư, nguồn không rõ quyền, bản cũ cần thu hồi | Dừng nếu chỉ dựa vào “không có link” |
| Công cụ và môi trường | Builder được chọn, phiên bản, cấu hình, thư mục staging riêng | Dừng nếu ghi thẳng vào bản đang phục vụ |
| Phục hồi | Bản kê đầu ra cũ, bản sao hạn chế, cách quay lại và thu hồi | Không xóa đầu ra cũ khi chưa có kế hoạch được phép |
Chưa có danh sách được xác nhận trong phiên này. Bảng trên là yêu cầu hồ sơ, không phải danh sách cho phép rỗng đã được duyệt.
5. Trình tự thực hiện sau khi đủ điều kiện
- Chốt Q08, phạm vi quyền và danh sách cho phép. Kiểm riêng bản nội bộ và bản công khai.
- Chụp bản kê nguồn và đầu ra cũ, gồm file ẩn, bản tải xuống và dữ liệu chỉ mục.
- Kiểm hoặc sửa builder để chỉ nhận nguồn được phép. Liên kết tới nguồn cấm phải bị chặn hoặc loại có báo cáo.
- Đặt đầu ra thử trong vùng riêng, không đồng bộ lên website. Không dùng thư mục đang phục vụ để thử.
- Khi được cho phép sinh, tạo từ thư mục đầu ra sạch. Không trộn với HTML cũ.
- So bản kê đầu ra với danh sách cho phép. File không giải thích được làm chặn lần xuất.
- Chạy kiểm link và các phép thử bên dưới. Lưu lỗi, số lượng và phạm vi đã quét.
- Chủ nội dung kiểm quyền, trạng thái và nội dung hiển thị. Người phù hợp kiểm riêng phần chuyên môn.
- Nhận quyết định phát hành thực tế. Nội bộ không được tự chuyển sang công khai.
- Sau phát hành được phép, kiểm URL cũ, bộ nhớ đệm và quyền truy cập. Thu hồi nếu phát hiện rò dữ liệu.
Các bước này là quy trình tương lai. Không bước sinh hoặc phát hành nào được thực hiện bởi tài liệu này.
6. Bộ kiểm tra bắt buộc trước phát hành
Dùng dữ liệu giả có chuỗi nhận biết. Không cài tài liệu cấm thật vào bản công khai để thử.
Kiểm thử phải ở vùng riêng và sau khi có danh sách cho phép cho chính bộ dữ liệu thử.
| Mã | Cách thử | Kết quả phải có | Bằng chứng cần lưu |
|---|---|---|---|
| H01 | Chạy kiểm tra trước sinh với danh sách thiếu/rỗng hoặc nguồn ngoài danh sách | Dừng, không tạo trang hay tài nguyên | Mã thoát, log, so bản kê trước/sau |
| H02 | Cho một file hợp lệ và một file giả bị cấm ở thư mục con | Chỉ nguồn được phép được xuất; không lọt qua quét đệ quy | Danh sách nguồn, output và chuỗi nhận biết |
| H03 | File hợp lệ liên kết/nhúng ảnh hoặc tải xuống từ file cấm | Không tự kéo theo tài nguyên cấm; có lỗi hoặc loại được giải thích | Log phụ thuộc và bản kê tài nguyên |
| H04 | Đặt HTML cũ giả có chuỗi nhận biết trong đầu ra thử | Bản mới không còn trang cũ ngoài danh sách; có cách phục hồi | So bản kê, đường dẫn đã loại và lý do |
| H05 | Tìm chuỗi cấm trong search_index.json và các chỉ mục tìm kiếm khác |
Không có tiêu đề, tóm tắt, nội dung hoặc URL bị cấm | Kết quả tìm trên file thực, không chỉ thử ô tìm kiếm |
| H06 | Kiểm sitemap.xml, hub, trang A–Z và liên kết điều hướng |
Không lộ URL/nhãn nguồn cấm hoặc trang đã thu hồi | Bản kê URL và kết quả kiểm |
| H07 | Kiểm PDF, ZIP, CSV, JSON, ảnh, file nguồn và nút tải xuống | Không chứa tài nguyên ngoài danh sách hoặc dữ liệu nhạy cảm | Danh sách toàn bộ file, kiểm cả nội dung gói tải xuống |
| H08 | Kiểm link nội bộ, anchor, URL mã hóa, chữ hoa/thường, trang không tồn tại | Báo đúng lỗi; không nhận thành công khi quét nhầm thư mục hoặc không có trang | Lệnh thực, phiên bản, số trang/link và lỗi |
| H09 | Thử font, tương phản, bàn phím, zoom và đọc màn hình ở phạm vi đã chọn | Từng tiêu chí có kết quả; lỗi quan trọng chưa đóng thì dừng | Thiết bị/trình duyệt, cách thử, kết quả và giới hạn |
| H10 | Mở bản nội bộ bằng phiên chưa đăng nhập hoặc tài khoản không có quyền | Không đọc được trang, chỉ mục, tài nguyên và tải xuống hạn chế | Kết quả từng đường truy cập, không chỉ trang đầu |
| H11 | Thu hồi một trang đã từng được phép trong môi trường thử | Trang/search/sitemap/tải xuống và bản lưu đệm liên quan không còn phục vụ nội dung | Danh sách nơi đã thu hồi; phần bên ngoài chưa xóa được phải ghi rõ |
| H12 | Đổi nguồn hoặc phiên bản công cụ sau review | Đòi kiểm lại phần bị tác động; không tái dùng quyết định cũ ngầm | Bản so sánh phiên bản và quyết định mở lại |
Không dùng kiểm link thay kiểm nội dung cấm. Không dùng việc xóa link thay xóa file đầu ra và kiểm URL truy cập trực tiếp.
7. Dùng công cụ kiểm liên kết hiện có
📄 link_audit.py có thể kiểm đầu ra HTML hiện có mà không sinh website mới.
Trước chạy, đọc giao diện lệnh và đường mặc định của phiên bản thực. Không đoán tham số khi công cụ đang thay đổi.
Chỉ chạy kiểm tra đọc khi được giao; ghi thư mục kiểm thực, số trang, số link và mã thoát.
Không chấp nhận kết quả quét nhầm tools/html thay thư mục html ở gốc.
Nếu không có trang, ghi không đánh giá được hoặc lỗi theo hợp đồng công cụ; không kết luận website hợp lệ.
Kết quả không xác minh giấy phép, danh tính, y khoa, quyền công bố hoặc trạng thái duyệt.
Nhánh chính kiểm liên kết các tài liệu tích hợp. Nhánh tài liệu này không chạy kiểm website hoặc xác nhận kết quả HTML.
8. Xử lý lỗi và thu hồi
Khi thấy nội dung ngoài danh sách, dừng lần xuất và không đăng output thử.
Giữ chứng cứ lỗi ở vùng hạn chế. Không sao chép dữ liệu rò vào báo cáo công khai.
Nếu bản cũ đang được phục vụ, báo người phụ trách; xin phép gỡ hoặc khóa truy cập trước khi sửa.
Kiểm bản triển khai, chỉ mục tìm kiếm, file tải xuống, bộ nhớ đệm và bản sao lưu có quyền truy cập.
Không hứa xóa được bản đã bị bên thứ ba tải. Ghi giới hạn và xử lý theo quy trình sự cố được xác định.
Quay lại bản cũ chỉ khi bản đó vẫn có quyền và không chứa nội dung cần thu hồi.
9. DoD và điểm bàn giao
- Danh sách nguồn, quyền và đối tượng đọc được quyết định rõ; không xuất mặc định toàn kho.
- Builder thực thi phạm vi đã kiểm; H01–H12 có kết quả theo mức áp dụng và lý do ngoại lệ.
- Đầu ra khớp bản kê, không còn trang cũ hoặc tài nguyên bị cấm.
- Có quyết định phát hành, đầu mối xử lý và phương án thu hồi thực tế.
- Nhật ký ghi việc đã làm, không ghi quy trình tương lai như kết quả đã đạt.
T15 hiện có nguyên mẫu kiểm trước xuất bản tổng hợp, chưa có bản dựng tài liệu thật hoặc tích hợp builder.
Q08/K03 còn mở; chưa có danh sách được duyệt hoặc quyết định phát hành. Không nhận T15 hoàn thành.
Theo dõi tại sổ tiến độ và danh mục D19.