# Đọc kết quả kiểm

> Mười kiểm tra chất lượng của mỗi phiên bản, ý nghĩa từng trạng thái, cách mở bằng chứng, chạy lại, và các ngăn Tham chiếu, So sánh, Tương đồng.

Mỗi phiên bản có một báo cáo chất lượng gồm **10 kiểm tra**. Kết quả nằm ở ngăn **Vấn đề** của tab Tài liệu; kiểm tra chưa chạy vẫn hiện với trạng thái "Chưa chạy" chứ không bị giấu.

![Ngăn Vấn đề: danh sách 10 kiểm tra và trạng thái](../../../assets/shots/van-de.webp)

## Trạng thái

| Trạng thái | Nghĩa |
| --- | --- |
| Đạt (`pass`) | Đạt yêu cầu |
| Cần xem lại (`warn`) | Có vấn đề nên xem, không chặn |
| Không đạt (`fail`) | Sai so với yêu cầu |
| Lỗi (`error`) | Không chạy được (TeX lỗi, PDF không có lớp chữ, mạng lỗi…). **Không** phải "đạt" |
| Chưa cấu hình (`not_configured`) | Chưa đủ điều kiện để kiểm (venue không chấm mù, chưa cấu hình Turnitin…) |
| Chưa chạy | Phiên bản chưa được kiểm mục này |

## Mười kiểm tra

| Kiểm tra | Nội dung |
| --- | --- |
| Toàn vẹn gói source | Zip đọc được, không có đường dẫn thoát thư mục (zip-slip) hay symlink, trong giới hạn kích thước; không có zip thì báo lỗi |
| Biên dịch LaTeX | Chạy `latexmk` trong dịch vụ TeX riêng; TeX lỗi là **Lỗi** kèm khối `! …`; cảnh báo như hộp Overfull là **Cần xem lại** |
| Khớp source ↔ PDF nộp | PDF bạn nộp có đúng là bản biên dịch từ source không: hệ số Dice ≥ 0,98 và độ phủ ≥ 0,99 là đạt; 0,95–0,98 cần xem lại; PDF scan hoặc không trích được chữ là lỗi |
| So sánh với bản trước | PDF latexdiff so với phiên bản trước (số dòng thêm/bớt); chưa có phiên bản trước thì chưa cấu hình |
| Dọn source | Tệp trong zip không được lần biên dịch nào đọc, comment, `TODO`, cảnh báo `chktex`: bằng chứng để dọn, không phải phán quyết |
| Ẩn danh | Chỉ kiểm khi venue edition chấm mù (double-blind): tên, email, đơn vị trong source; metadata tác giả và dấu arXiv trong PDF |
| Template và số trang | `\documentclass` so với template của venue; số trang so với giới hạn trang; lệch là cần xem lại |
| Kiểm tài liệu tham khảo | Đối chiếu từng mục với DOI, Crossref, DataCite, OpenAlex, arXiv (và Semantic Scholar nếu có khoá) |
| Tương đồng | Turnitin; chưa cấu hình thì không gọi mạng và không hiện % giả |
| Đối chiếu reviewer | Đối chiếu comment reviewer với diff; cần phiên bản trước và review đã nhập (xem [Review và đối chiếu reviewer](/huong-dan/doi-chieu-reviewer/)) |

## Xem bằng chứng và chạy lại

Bấm một dòng để mở finding. Ví dụ dưới đây là kiểm Biên dịch LaTeX báo **Cần xem lại** vì "39 hộp Overfull trong bản compile".

![Mở một kiểm tra để xem finding](../../../assets/shots/van-de-chi-tiet.webp)

- **Bằng chứng**: mở artifact của lần kiểm trong cửa sổ làm việc (log biên dịch, PDF diff, TeX flatten).
- **Chạy lại** ở từng dòng, hoặc **Chạy lại tất cả**; **Tải lại** cập nhật bảng khi worker vừa chạy xong.
- Finding trỏ tới dòng mã nguồn thì bấm để nhảy sang chế độ [Mã nguồn](/huong-dan/trang-cong-trinh/#mã-nguồn).

## Tham chiếu

Ngăn **Tham chiếu** có bảng từng mục tài liệu tham khảo, kết luận và liên kết nguồn hoặc DOI gợi ý. Bấm **Chạy lại kiểm ref** để kiểm; bảng tự cập nhật khi worker xong.

![Ngăn Tham chiếu](../../../assets/shots/tham-chieu.webp)

## So sánh latexdiff

Chế độ **So sánh** của tab Tài liệu hiện PDF latexdiff hoặc diff văn bản TeX. Cần artifact từ một lần kiểm có phiên bản trước; chưa có thì trang nói rõ. Xem [Trang công trình](/huong-dan/trang-cong-trinh/#so-sánh).

## Tương đồng

Ngăn **Tương đồng (Turnitin)** hiện điểm trùng lặp Turnitin trả về cho đúng phiên bản; không ước lượng, không tự tính. Chưa cấu hình Turnitin thì ngăn ghi rõ và trỏ tới [Cài đặt → Tương đồng](/huong-dan/cai-dat/#tương-đồng-turnitin). Khi đã cấu hình, bấm chạy và xem %, nguồn trùng và liên kết báo cáo PDF (hiệu lực 600 giây).

![Ngăn Tương đồng khi chưa chạy kiểm](../../../assets/shots/tuong-dong.webp)