Skema Aggrega Catalog (MappingLibrary)
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/mappinglibrary-v1beta1.schema.json
Kumpulan fragmen templat Go yang dapat digunakan ulang, yang dikonsumsi oleh Recipes dan FeatureRecipes pada saat render melalui valuesMapping: { $import: ... }. Tingkat 3 — opsional bagi katalog yang memerlukan penggunaan ulang pemetaan lintas Recipe. Mode penulisan tunggal: hanya templat Go.
Lihat referensi penulisan MappingLibrary untuk panduan prosa tentang penulisan entitas MappingLibrary; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ya | Konstanta: "aggrega.ai/v1beta1" |
kind | const “MappingLibrary” | ya | Konstanta: "MappingLibrary" |
metadata | object | ya | |
spec | object | ya | Konten MappingLibrary. spec.mappings wajib ada dan harus mendeklarasikan setidaknya satu entri. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima di tingkat envelope. Sikap mode penulisan tunggal ini menjaga rendering Recipe tetap seragam (templat Go di seluruhnya) dan menghindari pemaksaan penulis untuk berganti model evaluasi di tengah render saat mengonsumsi fragmen yang diimpor. |
Properti tambahan tidak diizinkan.
mappinglibrary.metadata
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Pengenal PascalCase untuk pustaka. Ini adalah nama ^[A-Z][A-Za-z0-9]*$. |
version | string | ya | Semantic Versioning ketat dari pustaka (misalnya, 1.0.0). Konsumen dapat menegaskannya sebagai batas versi minimum opsional :<version> dalam referensi nama polos (^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | tidak | Ringkasan singkat tentang cakupan pustaka. |
labels | map of string | tidak | Label yang dideklarasikan penulis. Compiler netral terhadap konten dan tidak menafsirkan nilai label: label adalah metadata buram, yang dibawa agar apa pun yang membaca library dapat mencocokkan berdasarkan label tersebut. |
annotations | map of string | tidak | Anotasi yang dideklarasikan oleh penulis. Pendekatan metadata buram yang sama seperti label. |
Properti tambahan tidak diizinkan.
mappinglibrary.spec
Konten MappingLibrary. spec.mappings wajib ada dan harus mendeklarasikan setidaknya satu entri. spec memiliki additionalProperties: false — tidak ada mode penulisan paralel yang diterima di tingkat envelope. Sikap mode penulisan tunggal ini menjaga rendering Recipe tetap seragam (templat Go di seluruhnya) dan menghindari pemaksaan penulis untuk berganti model evaluasi di tengah render saat mengonsumsi fragmen yang diimpor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
mappings | map of string | ya | Map bernama berisi fragmen templat Go yang dapat digunakan ulang. Isi setiap entri bersifat opak bagi validasi envelope — semantik konten ditangani oleh parser templat Go pada saat konsumsi. Kunci: pengenal PascalCase. Kunci entri muncul dalam URL referensi kanonis (#/mappings/<name>); batasan di tingkat envelope mencegah kunci non-PascalCase menyebar ke seluruh ekosistem katalog. Pola: ^[A-Z][A-Za-z0-9]*$. Setidaknya 1 entri. |
Properti tambahan tidak diizinkan.