| Đọc và kiểm tệp mô hình, báo lỗi theo dòng và cột | check_api.py và check_case.py với bảy tệp sai mẫu ở e2e/fixtures/invalid-models/; check_cli.py CLI-34 đến CLI-36 so dxos lint với plan | python3 e2e/api/check_api.py | Hoàn thiện | |
| Mã hồ sơ đọc được theo khuôn khai báo, duy nhất khi ghi đồng thời | check_codes.py | python3 e2e/api/check_codes.py | Hoàn thiện | Mỗi thực thể một trường mã; hết số thì từ chối hồ sơ mới |
| Mẫu in khai báo: PDF tiếng Việt theo quyền đọc hồ sơ | check_documents.py | python3 e2e/api/check_documents.py | Hoàn thiện | Mẫu chỉ dùng trường của hồ sơ, chưa kéo dữ liệu qua quan hệ |
| Xem trước và áp dụng mô hình, áp dụng lại không đổi gì, sửa phần lệch của bảng và Keycloak | check_api.py, check_recovery.py 19 | python3 e2e/api/check_recovery.py | Hoàn thiện | Việc kiểm lệch chỉ chạy khi xem kế hoạch hoặc áp dụng, không chạy lúc khởi động |
| Đổi mô hình khi đã có dữ liệu: mức rủi ro, đổi tên giữ dữ liệu, dòng vi phạm, xác nhận khi mất dữ liệu, quay về | check_change.py 65, check_guards.py 61 | python3 e2e/api/check_change.py | Hoàn thiện | Đổi người xử lý, hạn xử lý, quyền tự quyết hoặc đặt chỗ chỉ được khi thực thể không còn hồ sơ đang xử lý |
| Tiếp tục hoặc hủy bỏ lần áp dụng dừng giữa chừng | check_recovery.py, check_guards.py; thẻ "Đang dừng dở" kiểm bằng Chrome | python3 e2e/api/check_guards.py | Hoàn thiện | |
API chung với quyền theo vai và theo dòng (all, read, own, unit, assigned, owner_via) | check_api.py, check_case.py | python3 e2e/api/check_case.py | Hoàn thiện | Không có quyền theo từng trường |
Chặn lách quy trình: không ghi được status qua API dữ liệu | check_demo.py tiêu chí 4, check_conformance.py | python3 e2e/api/check_conformance.py | Hoàn thiện | |
| Quy tắc chung của quy trình: lý do khi từ chối hoặc trả lại, rút lại, người tạo không tự quyết, hạn và quá hạn | check_process.py, check_case.py | python3 e2e/api/check_process.py | Hoàn thiện | |
| Đặt chỗ theo khung giờ có sức chứa | check_booking.py 47 | python3 e2e/api/check_booking.py | Hoàn thiện | Kéo thả trên lịch kiểm tay bằng Chrome |
Tự đóng hồ sơ đã xử lý của họ work_item | check_process.py | python3 e2e/api/check_process.py | Hoàn thiện | |
| Hành động hoàn tất qua outbox, thử lại khi lỗi | check_process.py; AdvisoryJobLockIntegrationTest | python3 e2e/api/check_process.py | Hoàn thiện | Chỉ có add_to_group và remove_from_group |
Chống ghi đè khi sửa đồng thời (version, 409) | check_process.py | python3 e2e/api/check_process.py | Hoàn thiện | |
| Mã lý do cho lỗi 403 và 409 | check_case.py, check_process.py, check_booking.py | python3 e2e/api/check_case.py | Dùng được | STILL_REFERENCED và một số mã của 403 chưa có kiểm riêng |
| Lịch sử hồ sơ kèm giá trị cũ và mới của từng trường | check_case.py | python3 e2e/api/check_case.py | Hoàn thiện | |
| Chuỗi hash của lịch sử, điểm neo, lệnh kiểm | check_events.py 24 | python3 e2e/api/check_events.py | Hoàn thiện | Phát hiện sửa chứ không ngăn sửa; người sửa được cả cơ sở dữ liệu lẫn kho thì chỉ bị lộ khi so với hash bên nhận giữ |
| Webhook theo mô hình: chữ ký, thứ tự theo hồ sơ, thử lại, lấy lại phần đã lỡ | check_events.py, WebhookSenderTest | python3 e2e/api/check_events.py | Hoàn thiện | Dạng chat đã thử với Mattermost Team Edition 11.7.15 ngày 13/11/2026, kiểm tay theo docs/TESTING.md mục 6, «Webhook chat với Mattermost thật»; chưa thử với Slack thật |
Bên nhận so hash lịch sử (witness.py) | check_events.py; chạy dòng lệnh kiểm tay | python3 examples/history-witness/witness.py compare | Hoàn thiện | |
| Bộ kiểm chung cho mô hình mới | check_conformance.py 62; check_cli.py CLI-37 và CLI-38 chạy nó qua dxos conformance | python3 e2e/api/check_conformance.py hoặc dxos conformance <mô hình> | Hoàn thiện | |
| Quản trị người dùng: gán vai và đơn vị, tạo, khóa, đặt lại mật khẩu, nhật ký | check_users.py 41, KeycloakAdminClientTest; tab Người dùng kiểm bằng Chrome | python3 e2e/api/check_users.py | Hoàn thiện | Thay đổi làm thẳng ở Keycloak Admin Console không qua đây |
| Thống kê theo thực thể, kể cả thời gian xử lý | check_process.py | python3 e2e/api/check_process.py | Hoàn thiện | Chưa có tỷ lệ hoàn tất trong hạn |
Báo cáo theo trường (GET /api/v1/data/{model}/{entity}/report, trang Thống kê) | ReportQueryTest, ReportServiceTest (Postgres thật); kiểm tay theo docs/TESTING.md mục 6, «Thống kê»; check_docs.py kiểm đường dẫn có trong OpenAPI | Mở trang Thống kê của một thực thể có quy trình, mục Báo cáo theo trường | Dùng được | Một trường nhóm mỗi lần, đếm hoặc tính trên trường số; không có kiểm tự động trên stack; trang chỉ có cho thực thể có quy trình, thực thể khác dùng API |
| Tài liệu khớp với API thật | check_docs.py 3 | python3 e2e/api/check_docs.py | Hoàn thiện | |
| Chịu tải đồng thời và cấu hình nhỏ nhất | e2e/api/load_test.py trên stack tạm giới hạn 12, 8, 4 và 2 nhân; kết quả ở docs/SIZING.md | python3 e2e/api/load_test.py --levels 1,10,25,50,75,100,200 --reset | Dùng được | Chạy tay, không trong CI; số là cận dưới vì bộ tạo tải cùng máy và giới hạn tốc độ tắt khi đo; chưa đo 1 nhân, backend dưới 768 MB RAM và bảng trên 10.000 hồ sơ |
Lõi không trả Swagger UI, Admin Console mặc định đóng và mở được bằng KEYCLOAK_ADMIN_CONSOLE=true | check_surface.py 7; job Gateway surface của workflow Platform, hai chế độ | python3 e2e/api/check_surface.py | Dùng được | Chưa có kết quả của job này trên pull request |
Chạy riêng Tầng 1 (dxos start --core) | Nhóm core mode của job API end-to-end trong workflow Platform | dxos start --core | Dùng được | Chưa có kết quả của job này trên pull request; chế độ lõi không có bảng điều khiển, nên không có kiểm giao diện |
Nạp mô hình lúc khởi động (dxos start <tệp>) | check_bootstrap.py 9; job Install from the release archive của workflow Platform | python3 e2e/api/check_bootstrap.py | Dùng được | Chưa kiểm bằng image phát hành thật của bản 2.0.0 |
| Cài một lệnh, nâng cấp, gói sai SHA-256 bị từ chối | Job Install from the release archive của workflow Platform | curl -fsSL .../dxos-install.sh | bash | Dùng được | Chưa chạy trên máy sạch với image phát hành thật |
| Sao lưu và khôi phục kèm tệp đính kèm | Job Back up and restore của workflow Platform | dxos backup | Hoàn thiện | Một bản backend, một máy |
Số đo vận hành cho Prometheus (/actuator/prometheus) | OperationalMetricsTest (PostgreSQL thật): số khớp dữ liệu, tên số đo và nhãn là một tập cố định; kiểm tay theo docs/TESTING.md mục 6, «Số đo Prometheus» | cd backend && ./mvnw verify | Dùng được | Chưa thử với Prometheus hay Grafana thật; lần áp dụng thất bại và hàng đợi tồn chỉ kiểm bằng dữ liệu giả; một bản backend |
| Màn hình giám sát và cảnh báo | ServiceProbeTest 4, AlertJobTest | cd backend && ./mvnw verify | Dùng được | Không có kiểm đầu-cuối của giao diện giám sát |
| Bảng điều khiển và giao diện react-admin | npx tsc --noEmit trong workflow Frontend; e2e/web/tests/console.spec.ts (quản trị viên đăng nhập, áp dụng một mẫu, thấy mô hình chạy) trong job Browser end-to-end của workflow Platform; còn lại kiểm tay bằng Chrome | cd e2e && npx playwright test trên stack đang chạy | Dùng được | Tự động hóa mới có luồng bảng điều khiển; hộp việc, lịch đặt chỗ và trang hồ sơ kiểm tay |
Ví dụ kết nối thiết bị (itot-simulator) | Kiểm tay: gửi lại cùng quan sát in duplicate, không tạo thêm hồ sơ | python3 examples/itot-simulator/simulator.py run | Minh họa | Thiết bị và dữ liệu giả lập |
Hộp việc thời gian thực (GET /api/v1/inbox/stream) | Kiểm tay theo docs/TESTING.md mục 6, «Hộp việc thời gian thực»; mvnw verify kiểm biên dịch và test của dịch vụ | Mở hộp việc ở hai cửa sổ rồi nộp một hồ sơ | Dùng được | Không có kiểm tự động của kênh; chạy một bản backend nên kênh chỉ báo thay đổi do chính bản đó ghi |
Tài khoản và hồ sơ mẫu để dùng thử (dxos demo) | Kiểm tay theo docs/TESTING.md mục 6, «dxos demo» | dxos demo | Dùng được | Không có kiểm tự động; hồ sơ quá hạn chỉ có sau ba ngày kể từ lần nộp |
Kiểu boolean, date, nhiều lựa chọn, giới hạn min max pattern, bắt buộc có điều kiện | Kiểm tay theo docs/TESTING.md mục 6, «Kiểu và quy tắc trên biểu mẫu»; check_conformance.py và check_booking.py áp mọi mẫu, kể cả Sổ tài sản | Áp dụng mẫu Sổ tài sản rồi ghi giá trị đúng và sai qua API | Dùng được | Không có kiểm tự động riêng cho các kiểu mới; CHECK của cơ sở dữ liệu kiểm tay bằng chèn thẳng vào bảng |
| Tài liệu OpenAPI theo mô hình | Kiểm tay theo docs/TESTING.md mục 6, «OpenAPI của mô hình»; check_docs.py kiểm đường dẫn của tài liệu có trong OpenAPI chung | GET /api/v1/meta/models/{model}/openapi | Dùng được | Chưa thử trong một trình sinh thư viện cụ thể; đã nhập qua bộ kiểm cú pháp OpenAPI |
Ứng dụng ngoài (dxos client, tab Ứng dụng ngoài) | Kiểm tay theo docs/TESTING.md mục 6, «Ứng dụng ngoài» và «dxos client add, list, role, rotate, remove» | dxos client add | Dùng được | Không có kiểm tự động; mỗi ứng dụng giữ đúng một vai của một mô hình, đổi vai bằng dxos client role hoặc nút Đổi vai mà giữ nguyên mã bí mật |
Giao diện ở tên miền khác (dxos client browser, CORS_ALLOWED_ORIGINS) | CorsOriginsTest; check_browser.py BROWSER-01 đến BROWSER-07 (đăng ký client, cấu hình PKCE, preflight CORS, redirect không an toàn bị từ chối, đăng nhập PKCE rồi gọi API, xóa client) ở nhóm model and process và core mode của job API end-to-end | python3 e2e/api/check_browser.py | Dùng được | Script Python thay trình duyệt, chưa thử một giao diện ngoài thật; CORS mặc định chỉ nhận cổng 5173 của localhost và 127.0.0.1 |
Route riêng của bản cài (deploy/apisix/local.yaml) | Job Validate the gateway routes chạy check_routes.py với cấu hình lõi và mẫu local.example.yaml, và từ chối sáu biến thể sai (id trùng, đường dẫn giao với route lõi, upstream hay plugin thiếu, method sai, thiếu kiểm token); job Install from the release archive kiểm local.yaml giữ nguyên khi nâng cấp | python3 e2e/api/check_routes.py --local deploy/apisix/local.example.yaml | Dùng được | Chưa kiểm một dịch vụ riêng thật đứng sau route; local là một tài liệu YAML tối đa 1 MiB và chỉ nhận tập matcher nêu ở docs/EXTENSIONS.md |
GitOps kéo hạ tầng và mô hình (dxos gitops, dxos plan --check) | Kiểm tay theo docs/TESTING.md mục 6, «dxos gitops, nguồn mô hình», «dxos gitops, nguồn hạ tầng» và «dxos gitops, chung hai nguồn»: ba chế độ, chữ ký commit, đổi tag image, nâng cấp hạ tầng trên bản cài thử, thử lại khi update.sh lỗi | dxos gitops sync, dxos gitops status, dxos plan --check <tệp> | Dùng được | Chưa có script trong CI; nâng cấp hạ tầng chưa chạy tự động qua update.sh trong CI; mô hình chỉ đọc một thư mục, không đệ quy |
Leo thang khi quá hạn (escalate) | EscalationSweepTest (Postgres thật): thứ tự các lần báo, chạy bù sau gián đoạn chỉ ghi lần mới nhất, không gửi lại lần đã gửi, kết quả không đổi theo bốn múi giờ | cd backend && ./mvnw verify | Dùng được | Chưa có script trong CI chạy cả đường từ hồ sơ quá hạn đến webhook; chỉ báo qua webhook của mô hình, nhận theo vai |
Danh mục dữ liệu (GET /api/v1/models/{model}/data-catalog, tab Danh mục dữ liệu) | Kiểm tay theo docs/TESTING.md mục 6, «Danh mục dữ liệu»; check_docs.py kiểm đường dẫn có trong OpenAPI | Mở tab Danh mục dữ liệu bằng ADMIN, chọn một mô hình có quy trình | Dùng được | Không có kiểm tự động; chỉ ADMIN xem được |
Phả hệ từng trường (GET /api/v1/models/{model}/data-lineage, tab Danh mục dữ liệu) | LineageServiceTest; kiểm tay theo docs/TESTING.md mục 6, «Danh mục dữ liệu»; check_docs.py kiểm đường dẫn có trong OpenAPI | Mở một thực thể trong tab Danh mục dữ liệu bằng ADMIN, mục Nguồn gốc của từng trường | Dùng được | Dựng từ tệp mô hình nên chỉ nêu cái mô hình khai; không có bước biến đổi vì lõi giữ nguyên giá trị; chỉ ADMIN xem được |
Số đo chất lượng dữ liệu (GET /api/v1/data/{model}/{entity}/quality, tab Danh mục dữ liệu) | QualityMetricsTest (Postgres thật), check_process.py QL-01 đến QL-10; kiểm tay theo docs/TESTING.md mục 6, «Danh mục dữ liệu»; check_docs.py kiểm đường dẫn có trong OpenAPI | Mở một thực thể trong tab Danh mục dữ liệu bằng ADMIN | Dùng được | Đếm trực tiếp trên bảng và bị cắt sau 10 giây; chỉ có bốn số đo, độ hợp lệ của khóa ngoài và của trường user chưa đo |
| Lưu trữ và truy vấn hồ sơ đã đóng trong kho đối tượng | check_cli.py CLI-19 đến CLI-21 và CLI-26 đến CLI-33; kiểm tay theo docs/TESTING.md mục 6, «Lưu trữ theo lịch» | dxos archive <mô hình> --store, dxos archive query <mô hình>/<lần chạy>, dxos archive schedule install | Dùng được | Lần chạy đầu cần mạng để DuckDB tải extension; truy vấn giới hạn trong một lần chạy; timer là systemd user timer, máy không có systemd thì dùng cron |
Khối ui: và hành động hàng loạt | Kiểm tay theo docs/TESTING.md mục 6, «Khối ui:» và «Hành động hàng loạt»; npx tsc --noEmit | Mở danh sách và biểu mẫu của Sổ tài sản; chọn nhiều hồ sơ rồi Duyệt | Dùng được | Không có kiểm tự động của giao diện cho hai phần này |
| Bảng theo trạng thái và xuất CSV | Kiểm tay theo docs/TESTING.md mục 6, «Bảng theo trạng thái» và «Xuất CSV»; npx tsc --noEmit | Mở danh sách của một thực thể có quy trình, bấm Bảng theo trạng thái và Xuất CSV | Dùng được | Không có kiểm tự động của giao diện; bảng chỉ đọc, tối đa 10 thẻ mỗi cột; xuất tối đa 10.000 dòng |
Khóa chống chạy lặp (Idempotency-Key) | Kiểm tay theo docs/TESTING.md mục 6, «Khóa chống chạy lặp» | Gửi hai lần cùng khóa | Dùng được | Không có kiểm tự động; chỉ cho tạo hồ sơ và hành động, khóa giữ 24 giờ |
| Chỉ số mục tiêu: mã tự viết bằng 0 ở mức 1 và 2, dựng dưới 10 phút, đổi trường không mất dữ liệu | Đếm bằng script và đo tay, kết quả ở docs/TARGETS.md | python3 tools/count_own_code.py <thư mục>; dxos start <tệp> | Dùng được | Không chạy trong CI; mục "trong một buổi" mới có bản mô phỏng, chưa có người thật |