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

Skema Aggrega Developer Intent (Aggregate)

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

Id skema: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json

Arsitektur AI yang rekursif dan terparameterisasi. Berfungsi sebagai akar sebuah build sekaligus modul yang dapat digunakan ulang.

Lihat referensi penulisan Aggregate untuk panduan prosa tentang penulisan entitas Aggregate; 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 “Aggregate”yaKonstanta: "Aggregate"
metadataobjectya
defsstring[]tidakBlok opsional untuk anchor YAML standar (& dan *) agar Aggregate tetap DRY sambil mempertahankan kamus datar O(1) bagi compiler. Mencerminkan blok yang setara pada Manifest.
specobjectyaPermukaan Developer Intent: kontrak parameter global, impor aggregate bersarang, API publik komponen yang diekspor, pengelompokan subsistem, dan instans komponen yang membentuk modul.

Properti tambahan tidak diizinkan.

aggregate.metadata

PropertiJenisWajibDeskripsi
namestringyaPanjang minimal 1 karakter.
versionstringyaSemantic Versioning ketat dari modul aggregate. 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-]+)*))?$.
descriptionstringtidak
maintainersobject[]tidakDaftar pemelihara yang memiliki entitas ini.
licensestringtidakPengidentifikasi SPDX untuk lisensi perangkat lunak yang dideskripsikan entitas ini, seperti MIT atau AGPL-3.0. Pengidentifikasi ini mencatat ketentuan perangkat lunak tersebut, bukan ketentuan berkas ini.
repositorystringtidakURL ke repositori Git tempat berkas sumber berada.
homestringtidakURL halaman beranda, wiki, atau dokumentasi entitas ini.
keywordsstring[]tidakDaftar kata kunci deskriptif untuk kemudahan penemuan di UI.
labelsmap of stringtidakLabel duck-typing tingkat modul untuk penemuan katalog, evaluasi kebijakan, dan pemfilteran Studio/IDE. Label ini mendeskripsikan identitas Aggregate sebagai modul yang dapat digunakan ulang (misalnya, aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). Label ini TIDAK diturunkan ke node komponen anak — label komponen hanya berasal dari entitas katalog Component di Domain 2.

Properti tambahan tidak diizinkan.

aggregate.metadata.maintainers[]
PropertiJenisWajibDeskripsi
namestringya
emailstringtidak
urlstringtidak

Properti tambahan tidak diizinkan.

aggregate.spec

Permukaan Developer Intent: kontrak parameter global, impor aggregate bersarang, API publik komponen yang diekspor, pengelompokan subsistem, dan instans komponen yang membentuk modul.

PropertiJenisWajibDeskripsi
parametersmap of objecttidakKontrak lingkungan global. Setiap entri adalah objek kontrak bertipe yang menulis subset kosakata bentuk ringkas (type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties). Struktur bersarang dinyatakan melalui sub-bidang properties: dalam bentuk bertipe. Pemenuhan Release dapat ditulis secara inline (parameters: {…}) atau melalui impor file dari satu sumber (parameters: {$import: }); lapisan kontrak parameter memvalidasi map gabungan terhadap kontrak ini sebelum interpolasi parameter. Halaman Aggregate dalam referensi bahasa menjelaskan kosakata lengkapnya.
aggregatesmap of objecttidakAggregate bersarang yang berperan sebagai modul yang diimpor. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
exportedComponentsmap of stringtidakAntarmuka API publik. Memetakan nama publik yang diekspos ke ID komponen internal. Aggregates induk yang mengimpor modul ini mereferensikan komponen melalui nama publik tersebut.
subsystemsmap of subsystemtidakPengelompokan logis bernama atas komponen-komponen sebuah Aggregate ke dalam subsistem. Saling eksklusif dengan components tingkat atas — mendeklarasikan keduanya akan ditolak. Subsistem yang dinamai default oleh penulis adalah subsistem biasa yang dideklarasikan, berbeda dari default sintetis yang dibuat compiler untuk Aggregate yang hanya berisi components. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
componentsmap of component_instancetidakMap komponen atomik logis yang membentuk Aggregate ini, ditulis langsung di tingkat atas. Components tingkat atas dan subsystems saling eksklusif — mendeklarasikan keduanya akan ditolak. Ketika komponen ditulis di sini (tanpa subsystems), compiler melipatnya ke dalam subsistem default sintetis saat pemuatan, dan IR menandai subsistem tersebut sebagai sintetis. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.

Properti tambahan tidak diizinkan.

Definisi

inject_delivery

Satu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features..inject sebuah lampiran, atau terhadap provides milik komponen itu sendiri dalam konteks component.inject. Dalam features..inject sebuah lampiran, ‘from’ yang menyebut kunci yang tidak dipublikasikan FeatureRecipe akan menghentikan build, kecuali FeatureRecipe tersebut membaca sendiri entri lampiran di .inject dalam template yang dievaluasinya terhadap konteks render lampiran (valuesMapping, workload, artifacts, omits miliknya, atau with atau when dari sebuah langkah pipeline — bukan injectMapping miliknya), dan dalam hal itu kunci tersebut adalah kunci yang dikonsumsinya, bukan kunci yang dikirim melalui .context.inject milik komponen. ‘value’ hanya dikirim dalam component.inject: entri yang memuatnya dalam uses[].inject atau dalam features..inject sebuah lampiran akan menghentikan build, karena blok-blok tersebut hanya mengirim kunci yang dipublikasikan entitas lain.

Jenis: object[]

inject_block

Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides target (uses[].inject), ke kunci provides yang dipublikasikan FeatureRecipe milik sebuah lampiran (features..inject), atau ke string literal / ekspresi template dan kunci provides milik komponen itu sendiri (component.inject). Setiap mekanisme pengiriman (env, file, arg, atau kustom) ditulis sebagai array entri {in, from?, value?} — ‘from’ eksplisit untuk referensi provides dan ‘value’ untuk literal. Mekanisme kustom boleh memakai nama apa pun kecuali all: template membaca setiap mekanisme yang digabungkan menjadi satu tampilan di .context.inject.all, sehingga mekanisme dengan nama itu akan tertutupi olehnya, dan memberi nama itu pada sebuah mekanisme menghentikan build.

PropertiJenisWajibDeskripsi
envinject_deliverytidakSatu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features..inject sebuah lampiran, atau terhadap provides milik komponen itu sendiri dalam konteks component.inject. Dalam features..inject sebuah lampiran, ‘from’ yang menyebut kunci yang tidak dipublikasikan FeatureRecipe akan menghentikan build, kecuali FeatureRecipe tersebut membaca sendiri entri lampiran di .inject dalam template yang dievaluasinya terhadap konteks render lampiran (valuesMapping, workload, artifacts, omits miliknya, atau with atau when dari sebuah langkah pipeline — bukan injectMapping miliknya), dan dalam hal itu kunci tersebut adalah kunci yang dikonsumsinya, bukan kunci yang dikirim melalui .context.inject milik komponen. ‘value’ hanya dikirim dalam component.inject: entri yang memuatnya dalam uses[].inject atau dalam features..inject sebuah lampiran akan menghentikan build, karena blok-blok tersebut hanya mengirim kunci yang dipublikasikan entitas lain.
fileinject_deliverytidakSatu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features..inject sebuah lampiran, atau terhadap provides milik komponen itu sendiri dalam konteks component.inject. Dalam features..inject sebuah lampiran, ‘from’ yang menyebut kunci yang tidak dipublikasikan FeatureRecipe akan menghentikan build, kecuali FeatureRecipe tersebut membaca sendiri entri lampiran di .inject dalam template yang dievaluasinya terhadap konteks render lampiran (valuesMapping, workload, artifacts, omits miliknya, atau with atau when dari sebuah langkah pipeline — bukan injectMapping miliknya), dan dalam hal itu kunci tersebut adalah kunci yang dikonsumsinya, bukan kunci yang dikirim melalui .context.inject milik komponen. ‘value’ hanya dikirim dalam component.inject: entri yang memuatnya dalam uses[].inject atau dalam features..inject sebuah lampiran akan menghentikan build, karena blok-blok tersebut hanya mengirim kunci yang dipublikasikan entitas lain.
arginject_deliverytidakSatu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features..inject sebuah lampiran, atau terhadap provides milik komponen itu sendiri dalam konteks component.inject. Dalam features..inject sebuah lampiran, ‘from’ yang menyebut kunci yang tidak dipublikasikan FeatureRecipe akan menghentikan build, kecuali FeatureRecipe tersebut membaca sendiri entri lampiran di .inject dalam template yang dievaluasinya terhadap konteks render lampiran (valuesMapping, workload, artifacts, omits miliknya, atau with atau when dari sebuah langkah pipeline — bukan injectMapping miliknya), dan dalam hal itu kunci tersebut adalah kunci yang dikonsumsinya, bukan kunci yang dikirim melalui .context.inject milik komponen. ‘value’ hanya dikirim dalam component.inject: entri yang memuatnya dalam uses[].inject atau dalam features..inject sebuah lampiran akan menghentikan build, karena blok-blok tersebut hanya mengirim kunci yang dipublikasikan entitas lain.

component_uses_block

Koneksi yang ditarik sebuah komponen ke komponen-komponen yang menjadi dependensinya, dengan socket sebagai kunci. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang dinamai dengan alias dapat memuat nilai per koneksi dari pengembang dan lampiran yang mengisi slot yang dideklarasikan socket tersebut.

Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.

Nilainya adalah string[] or map of object.

Kunci lain tidak diizinkan.

feature_uses_block

Koneksi yang ditarik oleh Feature yang dilampirkan, dengan kunci berupa socket yang dideklarasikan Feature dalam usesSchema-nya. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang ditarik sebuah Feature tidak memuat lampirannya sendiri: kredensial yang dibutuhkannya mengisi slot yang dideklarasikan Feature dalam featuresSchema miliknya sendiri dan dilampirkan di samping Feature tersebut.

Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.

Nilainya adalah string[] or map of object.

Kunci lain tidak diizinkan.

connection_attachment

Satu lampiran yang dimuat sebuah koneksi: Feature yang mengisi slot yang dideklarasikan socket koneksi tersebut, beserta konfigurasi dari pengembang untuknya.

PropertiJenisWajibDeskripsi
typestringyaURI antarmuka Feature yang diminta lampiran ini (mis. core/referenced-secret:1.0.0).
descriptionstringtidakDokumentasi opsional yang menjelaskan mengapa koneksi ini memuat lampiran tersebut.
valuesobjecttidakKonfigurasi yang diberikan pengembang untuk Feature, divalidasi oleh deklarasi skemanya.

Properti tambahan tidak diizinkan.

subsystem

PropertiJenisWajibDeskripsi
descriptionstringtidakDokumentasi opsional yang menjelaskan tujuan subsistem ini dan pengelompokan logis yang diwakilinya.
annotationsmap dari string atau object atau nulltidakAnotasi yang ditulis pengembang pada subsistem ini. Nilainya berupa string, objek terstruktur (map dari subkunci ke nilai, digabungkan per subkunci dengan nilai terstruktur yang diwarisi), atau null; null eksplisit pada kunci yang diwarisi dari subsistem induk menghapus binding yang diwarisi dari subsistem ini (opt-out Feature berbasis anotasi). Anotasi yang dideklarasikan di sini diwarisi oleh subsistem bersarang dan oleh komponen yang dimuatnya; tingkat yang lebih dekat menang per kunci. Diteruskan ke bawah ke bucket .context.annotations.aggregate pada setiap node IR turunan.
featuresmap of objecttidakFitur lintas bagian yang dilampirkan ke semua komponen dalam subsistem ini. Skemanya sama dengan fitur tingkat komponen (type, values, uses, inject). Diratakan ke dalam setiap komponen saat finalisasi graf, ditempatkan setelah fitur tingkat komponen dalam urutan eksekusi. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
subsystemsmap of subsystemtidakKunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
componentsmap of component_instancetidakKunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.

Properti tambahan tidak diizinkan.

component_instance

PropertiJenisWajibDeskripsi
typestringyaComponent abstrak yang diminta, sebagai referensi: metadata.name-nya ditambah :version opsional (misalnya core/api-server:1.0.0), tidak pernah berupa path file. Di-resolve melalui Model Resolusi Entitas Tiga Tingkat (direktori katalog workspace → cache → registry): Component yang ditulis secara lokal ditempatkan di bawah catalog/ di akar workspace atau di direktori yang tercantum di workspace.catalog_dirs, dan type yang ditulis sebagai path file relatif menghentikan build sebagai entitas yang tidak dimiliki katalog mana pun.
activeboolean atau stringtidakApakah komponen ini ada dalam topologi hasil kompilasi. Berupa boolean, atau template string atas .parameters yang harus di-resolve menjadi boolean. Jika di-resolve menjadi false, komponen dipangkas dari topologi, berlanjut ke edge uses dan attachment-nya. Dengan menurunkan nilai dari sebuah parameter, sebuah Release dapat mengaktifkan atau menonaktifkan keberadaan komponen dengan memenuhi parameter tersebut. Bernilai default true jika dihilangkan. Default: true
descriptionstringtidakDokumentasi opsional yang menjelaskan peran instans komponen ini dalam aplikasi. Dibawa hingga ke graf IR.
annotationsmap dari string atau object atau nulltidakAnotasi yang ditulis pengembang pada komponen ini. Nilainya berupa string, objek terstruktur (map dari subkunci ke nilai, digabungkan per subkunci dengan nilai terstruktur yang diwarisi), atau null; null eksplisit pada kunci yang diwarisi dari subsistem induk menghapus binding yang diwarisi dari komponen ini (opt-out Feature berbasis anotasi). Anotasi tingkat Component menimpa anotasi tingkat subsistem yang diwarisi per kunci; komponen saudara dalam subsistem yang sama mempertahankan peta anotasinya masing-masing secara independen.
valuesobjecttidakProperti kognitif opak yang diteruskan ke Component, divalidasi oleh skemanya.
usescomponent_uses_blocktidakKoneksi yang ditarik sebuah komponen ke komponen-komponen yang menjadi dependensinya, dengan socket sebagai kunci. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang dinamai dengan alias dapat memuat nilai per koneksi dari pengembang dan lampiran yang mengisi slot yang dideklarasikan socket tersebut.
injectinject_blocktidakSelf-inject tingkat komponen. Menyuntikkan nilai milik komponen itu sendiri (melalui ‘value:’) atau kunci provides miliknya sendiri (melalui ‘from:’) langsung ke pipa pengiriman (.context.inject). Hanya diizinkan jika entitas katalog Component mendeklarasikan ‘spec.inject’ dengan mekanisme yang sesuai. Kunci inject yang bertabrakan dengan kunci yang dideklarasikan di uses[].inject menghentikan build sebagai kunci pengiriman duplikat lintas sumber inject.
featuresmap of objecttidakFeatures yang dilampirkan ke komponen ini, dengan kunci berupa nama instans yang diberikan penulis untuk setiap attachment. Inilah satu-satunya permukaan attachment: Feature operasional, Feature kredensial (yang berlabel feature.aggrega.ai/kind: secret) dan Feature identitas semuanya dilampirkan di sini, dengan kata kunci dan bentuk yang sama. Yang membedakannya adalah apa yang dihasilkan attachment tersebut, bukan cara mendeklarasikannya. Attachment yang nama instansnya cocok dengan slot yang dideklarasikan Component di featuresSchema mengisi slot tersebut; nama instans lainnya merupakan attachment bebas. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.

Properti tambahan tidak diizinkan.