Skema Aggrega Catalog (SchemaLibrary)
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Kumpulan definisi JSON Schema 2020-12 yang dapat digunakan ulang, yang dapat dirujuk dengan $ref oleh konten katalog (Components, Features, dll.) melalui referensi identitas nama polos
Lihat referensi penulisan SchemaLibrary untuk panduan prosa tentang penulisan entitas SchemaLibrary; 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 “SchemaLibrary” | ya | Konstanta: "SchemaLibrary" |
metadata | object | ya | |
spec | object | ya | Konten SchemaLibrary. spec.schemas wajib dan harus mendeklarasikan setidaknya satu entri; spec.templates bersifat opsional dan hanya ada jika library menggunakan helper berparameter. |
Properti tambahan tidak diizinkan.
schemalibrary.metadata
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Pengenal PascalCase untuk library. Ini adalah nama ^[A-Z][A-Za-z0-9]*$. |
version | string | ya | Semantic Versioning ketat dari library (misalnya, 1.0.0). Lockfile per Release mem-pin satu versi per library. 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-]+)*))?$. |
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.
schemalibrary.spec
Konten SchemaLibrary. spec.schemas wajib dan harus mendeklarasikan setidaknya satu entri; spec.templates bersifat opsional dan hanya ada jika library menggunakan helper berparameter.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
schemas | map of object | ya | Map bernama berisi definisi skema yang dapat digunakan ulang. Konten setiap entri divalidasi oleh compiler bentuk ringkas saat parsing; validasi tingkat envelope hanya memeriksa pembungkus struktural. Kunci: pengenal PascalCase — ^[A-Z][A-Za-z0-9]*$. Kunci entri muncul dalam referensi identitas nama polos (<Library>#/schemas/<name>); batasan tingkat envelope mencegah kunci non-PascalCase menyebar melalui ekosistem katalog. Minimal 1 entri. |
templates | map of object | tidak | Map bernama opsional berisi helper berparameter. Entri skema merujuk templat berdasarkan nama melalui $instantiate:; hanya substitusi skalar literal — tanpa templat Go tersemat, tanpa kondisional, tanpa perulangan. Lapisan substitusi library sengaja dibuat lebih sempit daripada evaluasi templat penuh agar penulisan tetap berada dalam bahasa skema alih-alih memperkenalkan permukaan templating terpisah. Kunci: pengenal PascalCase — ^[A-Z][A-Za-z0-9]*$. Disiplin tingkat envelope yang sama seperti kunci entri skema; nama templat dirujuk melalui $instantiate: pada saat instansiasi. |
Properti tambahan tidak diizinkan.