Schema del catalogo di Aggrega (SchemaLibrary)
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Una raccolta riutilizzabile di definizioni JSON Schema 2020-12 a cui il contenuto del catalogo (Components, Features, ecc.) può fare $ref tramite il riferimento di identità per nome semplice
Consulta il riferimento per l’authoring della SchemaLibrary per una guida in prosa sulla scrittura delle entità SchemaLibrary; questa pagina documenta lo schema strutturale descritto da quel riferimento.
Tipo di primo livello: object
Proprietà
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sì | Costante: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | sì | Costante: "SchemaLibrary" |
metadata | object | sì | |
spec | object | sì | Il contenuto della SchemaLibrary. spec.schemas è obbligatorio e deve dichiarare almeno una voce; spec.templates è opzionale ed è presente solo quando la libreria usa helper parametrizzati. |
Non sono consentite proprietà aggiuntive.
schemalibrary.metadata
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Identificatore PascalCase della libreria. È il nome ^[A-Z][A-Za-z0-9]*$. |
version | string | sì | Versionamento semantico rigoroso della libreria (ad es. 1.0.0). Il file di lock per Release fissa una versione per libreria. Pattern: ^(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 | no | Un riepilogo conciso di ciò che la libreria copre. |
labels | mappa di string | no | Etichette dichiarate dall’autore. Il compilatore è neutrale rispetto ai contenuti e non interpreta i valori delle etichette: sono metadati opachi, portati perché chiunque legga la libreria possa usarli per la corrispondenza. |
annotations | mappa di string | no | Annotazioni dichiarate dall’autore. Stessa impostazione di metadati opachi delle etichette. |
Non sono consentite proprietà aggiuntive.
schemalibrary.spec
Il contenuto della SchemaLibrary. spec.schemas è obbligatorio e deve dichiarare almeno una voce; spec.templates è opzionale ed è presente solo quando la libreria usa helper parametrizzati.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
schemas | mappa di object | sì | Mappa con nome di definizioni di schema riutilizzabili. Il contenuto di ciascuna voce viene validato dal compilatore della forma compatta in fase di analisi; la validazione a livello di involucro verifica solo l’incapsulamento strutturale. Chiavi: identificatore PascalCase — ^[A-Z][A-Za-z0-9]*$. Le chiavi delle voci compaiono nei riferimenti di identità per nome semplice (<Library>#/schemas/<name>); il vincolo a livello di involucro impedisce che chiavi non PascalCase si propaghino nell’ecosistema del catalogo. Almeno 1 voce. |
templates | mappa di object | no | Mappa con nome opzionale di helper parametrizzati. Le voci di schema fanno riferimento ai template per nome tramite $instantiate:; solo sostituzione letterale di scalari — nessun template Go incorporato, nessun condizionale, nessun ciclo. Il livello di sostituzione della libreria è intenzionalmente più ristretto di una valutazione completa dei template, così che l’authoring resti nel linguaggio degli schemi anziché introdurre una superficie di templating separata. Chiavi: identificatore PascalCase — ^[A-Z][A-Za-z0-9]*$. Stessa disciplina a livello di involucro delle chiavi delle voci di schema; i nomi dei template vengono referenziati tramite $instantiate: al momento dell’istanziazione. |
Non sono consentite proprietà aggiuntive.