Định nghĩa chỉ số
Tách số đối tượng, byte lưu, tác vụ, lần kiểm chứng, dấu thời gian và xuất gói; đơn vị tính phí do hợp đồng quy định.
Tập hợp dữ liệu vận hành và đơn vị sử dụng theo hợp đồng, có truy vết đến giao dịch nguồn.
Giải thích số liệu vận hành và sử dụng bằng giao dịch nguồn, tránh đếm tiếp nhận, hoàn tất và tính phí như cùng một đơn vị.
| Bạn cần chuẩn bị | Bạn nhận được |
|---|---|
| Báo cáo hồ sơ, tác vụ, lượng lưu trữ, kiểm chứng, gia hạn và xuất gói. | Báo cáo theo tổ chức/kỳ và danh sách chênh lệch cần xử lý trước chốt số. |
Bên thực hiện: Chủ dịch vụ, vận hành, đối soát thương mại và kiểm toán.
Tách số đối tượng, byte lưu, tác vụ, lần kiểm chứng, dấu thời gian và xuất gói; đơn vị tính phí do hợp đồng quy định.
Gắn tenant, kỳ báo cáo, eventId và archiveId/jobId khi phù hợp; giữ thời điểm giao dịch và thời điểm ghi nhận.
Phát lại sự kiện không làm tăng lượng sử dụng; tác vụ thất bại và hoàn tất muộn có quy tắc điều chỉnh riêng.
Hiển thị số chưa đối soát, phạm vi kỳ và phiên bản báo cáo. Bản điều chỉnh phải liên kết bản đã chốt.
| Hiện tại | Điều kiện | Chủ thể | Tiếp theo | Đầu ra / phục hồi |
|---|---|---|---|---|
| Kỳ đang mở [mô hình] | Sự kiện đã khử trùng và có nguồn | Kiểm toán và báo cáo | Projection cập nhật [mô hình] | Tách thời điểm nghiệp vụ/ghi nhận và tenant; không đếm lại khi replay. |
| Chưa đối soát [mô hình] | So với giao dịch nguồn, phiên bản và đơn vị tính | Đối soát sử dụng | Đã đối soát / còn chênh lệch [mô hình] | Không coi lượng sử dụng là phí đã duyệt; giá thuộc hợp đồng. |
| Kỳ đã chốt [mô hình] | Giao dịch muộn được duyệt điều chỉnh | Chủ báo cáo | Phiên bản điều chỉnh [mô hình] | Giữ nguồn điều chỉnh và báo cáo trước; không sửa âm thầm. |
| Tình huống | Cách xử lý | Ranh giới |
|---|---|---|
| Sự kiện trùng | Khử trùng theo eventId trong ngữ cảnh tổ chức. | Không tính phí lần hai. |
| Giao dịch đến muộn | Áp dụng điều chỉnh có dấu vết. | Không âm thầm sửa báo cáo đã duyệt. |
| Dữ liệu nguồn thiếu | Báo số chưa hoàn tất đối soát. | Không xuất số liệu như đã được xác nhận. |
Phân biệt yêu cầu tiếp nhận, job hoàn tất, lượng lưu trữ và sự kiện tính phí. Chỉ billing:read được xem dữ liệu của tenant tương ứng.
Sự kiện phát lại không được đếm hai lần; khử trùng theo eventId và đối soát theo archiveId/jobId trước khi chốt.
Khử trùng sự kiện phát lại theo eventId, đối chiếu archiveId/jobId và tách yêu cầu tiếp nhận với kết quả hoàn tất tính phí.
eventId không đổi tổng; một điều chỉnh hợp lệ tạo phiên bản và nguồn đối soát.| API | Quyền ứng dụng | Tài liệu |
|---|---|---|
| GET /v1/audit-records | audit:read | API nhật ký và báo cáo |
| GET /v1/usage-reports | billing:read | API nhật ký và báo cáo |
| Thành phần | Định nghĩa |
|---|---|
| Đầu vào | Nhật ký giao dịch, đơn vị đo theo gói dịch vụ, quota, kỳ báo cáo và mã tenant. |
| Đầu ra | Báo cáo sử dụng, chênh lệch đối soát và dữ liệu lập hóa đơn; không công bố giá hay hạn mức chưa duyệt. |
| Phần | Cách thực hiện |
|---|---|
| Mã tổng hợp | usage-test-001 |
| Tác vụ | Chốt kỳ đo, đơn vị, nguồn giao dịch và quy tắc loại trừ yêu cầu trùng. |
| Ca nghiệm thu | Đối soát lại cùng kỳ không đếm lại retry; ghi riêng lượng lưu trữ, giao dịch và băng thông. |
Đây là tiêu chí thử theo nghiệp vụ; gói mẫu tổng hợp không tự chứng minh backend đã thực thi hoặc ERS hợp lệ.