Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “MappingLibrary”yaKonstanta: "MappingLibrary"
metadataobjectya
specobjectyaKonten 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

PropertiJenisWajibDeskripsi
namestringyaPengenal PascalCase untuk pustaka. Ini adalah nama dalam referensi identitas nama polos #/mappings/; versinya disediakan oleh lockfile per Release dan tidak ada host registri yang masuk ke dalam referensi atau pengenal turunan apa pun. Pola: ^[A-Z][A-Za-z0-9]*$.
versionstringyaSemantic Versioning ketat dari pustaka (misalnya, 1.0.0). Konsumen dapat menegaskannya sebagai batas versi minimum opsional :<version> dalam referensi nama polos (:#/mappings/); lockfile per Release memiliki versi yang diresolusi. Pola: ^(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-]+)*))?$.
descriptionstringtidakRingkasan singkat tentang cakupan pustaka.
labelsmap of stringtidakLabel 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.
annotationsmap of stringtidakAnotasi 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.

PropertiJenisWajibDeskripsi
mappingsmap of stringyaMap 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.