money_without_currency
Đang phát triểnGiá không ký hiệu. Bản thiết kế v0.1 để review trước khi triển khai, chưa phải API phát hành.
Chưa khả dụngVí dụ minh họa thiết kế, không phải cú pháp đã hoạt động. Chỉ lập trình sau khi chốt kiểu dữ liệu, lỗi và kiểm thử.
Hợp đồng sử dụng
| Đầu vào | Money DTO {amount_minor:int64,currency:string} |
|---|---|
| Tham số | locale: string, mặc định locale store |
| Đầu ra | string |
Bổ sung mới; cú pháp và hành vi bên dưới là đề xuất, chưa khả dụng.
CÚ PHÁP ĐỀ XUẤT · CHƯA CHẠY TRÊN RUNTIME
{# price = {"amount_minor":250000,"currency":"VND"} #}
{{ price|money_without_currency:"vi-VN" }}KẾT QUẢ MONG MUỐN · ĐẶC TẢ
250.000Trường hợp biên và an toàn
Không mặc định /100 cho VND. USD minor=1234 → 12.34 USD theo en-US. Thiếu currency → lỗi; không quy đổi tiền; số âm chỉ dùng refund/credit được backend cấp.
Tiêu chí nghiệm thu
- Kiểm thử ví dụ ở trên cùng đầu vào rỗng, Unicode, sai kiểu và giới hạn đầu ra.
- Sai tham số phải trả lỗi có tên filter/tag; preview hiển thị vị trí lỗi, production không lộ nội bộ.
- Không I/O, truy vấn hoặc thay đổi dữ liệu từ template; dữ liệu commerce chỉ qua resolver có quyền.
- Kiểm thử escaping và profile runtime trước khi công bố cho theme.
Nguồn & quyết định chuyển đổi
Tên tham khảo: money_without_currency. Hợp đồng và ví dụ là đề xuất riêng cho Skai, không sao chép contract Liquid.
Nguồn tham khảo Haravan · Quy ước đặc tả Skai
Đối chiếu mã nguồn local: skaiplatform/lingo/filters_builtin.go, tags_*.go, security.go và skaiweb/services/theme_engine/functions.go. Badge “Đang phát triển” biểu thị tài liệu dự kiến, không xác nhận engine đã được triển khai.