Tải dữ liệu lên
Chuẩn bị JSON đúng nhà máy, kỳ dữ liệu và registry metric.
Định dạng file hiện được nhận
Endpoint ingest hiện nhận file .json tối đa 1.000.000 byte. Chọn plantId và recordType trên dashboard; không tự thêm header hoặc salts vào file upload.
Ví dụ dưới dùng nhà máy minh họa. Thay plantCode bằng mã nhà máy thực và chỉ sử dụng metric thuộc registry của loại tài sản đó.
{
"schemaVersion": "2.0.0",
"plantCode": "SOLAR-DEMO-01",
"periods": [
{
"period": "2026-08",
"metrics": {
"inverter_yield_kwh": "24000",
"ongrid_export_kwh": "22000"
}
}
]
}Những quy tắc cần kiểm tra
- period ở dạng YYYY-MM, 1–12 kỳ mỗi bản ghi, không trùng kỳ trong cùng file.
- Giá trị metric nên là chuỗi decimal, dùng dấu chấm; không số mũ hay dấu phân cách hàng nghìn.
- Key metric phải thuộc registry, đúng số chữ số thập phân và khoảng giá trị.
- Không có key JSON trùng nhau; không tự thêm trường ngoài schema.
Tháng hiện tại và Tạm tính
Ở chế độ ledger v3, một bản ghi chứa tháng hiện tại tại thời điểm ingest là Tạm tính. Bản ghi đó có thể lưu và xác minh off-chain nhưng không được neo.
Tính chất Tạm tính được khóa bởi ingestedAt và timezone. Khi tháng đóng, ingest lại để tạo bản ghi mới; chờ sang tháng không tự biến bản ghi cũ thành số cuối kỳ.
Nguồn đối chiếu trong monorepo
Nội dung dựa trên mã nguồn; trạng thái live được ghi riêng.
apps/api/src/modules/shadow-ledger/api/shadow-ledger.controller.tspackages/hashing/src/schema-v2.tsdocs/specs/ucy-hash-v2.md
