Aggrega-Schema für den Katalog (MappingLibrary)
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/mappinglibrary-v1beta1.schema.json
Eine wiederverwendbare Sammlung von Go-Template-Fragmenten, die Recipes und FeatureRecipes zur Renderzeit über valuesMapping: { $import: ... } konsumieren. Stufe 3 — optional für Kataloge, die Zuordnungen Recipe-übergreifend wiederverwenden müssen. Einziger Authoring-Modus: nur Go-Templates.
Siehe die Authoring-Referenz zur MappingLibrary für Anleitungen in Prosaform zum Verfassen von MappingLibrary-Entitäten; diese Seite dokumentiert das strukturelle Schema, das diese Referenz beschreibt.
Typ der obersten Ebene: object
Eigenschaften
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ja | Konstante: "aggrega.ai/v1beta1" |
kind | const “MappingLibrary” | ja | Konstante: "MappingLibrary" |
metadata | object | ja | |
spec | object | ja | Der Inhalt der MappingLibrary. spec.mappings ist erforderlich und muss mindestens einen Eintrag deklarieren. spec trägt additionalProperties: false — auf Ebene der Hülle werden keine parallelen Authoring-Modi akzeptiert. Die Festlegung auf einen einzigen Authoring-Modus hält das Recipe-Rendering einheitlich (durchgehend Go-Templates) und erspart es Autoren, beim Konsumieren importierter Fragmente mitten im Rendering das Auswertungsmodell zu wechseln. |
Zusätzliche Eigenschaften sind nicht zulässig.
mappinglibrary.metadata
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | ja | PascalCase-Bezeichner der Bibliothek. Er ist der Name ^[A-Z][A-Za-z0-9]*$. |
version | string | ja | Strikte semantische Versionierung der Bibliothek (z. B. 1.0.0). Ein Konsument kann sie als optionale Mindestversion :<version> in einer Referenz per bloßem Namen angeben (^(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 | nein | Eine knappe Zusammenfassung dessen, was die Bibliothek abdeckt. |
labels | Map von string | nein | Vom Autor deklarierte Labels. Der Compiler ist inhaltsneutral und interpretiert Label-Werte nicht: Sie sind opake Metadaten, mitgeführt für alles, was die Bibliothek liest und darauf abgleichen will. |
annotations | Map von string | nein | Vom Autor deklarierte Annotationen. Dieselbe Haltung opaker Metadaten wie bei Labels. |
Zusätzliche Eigenschaften sind nicht zulässig.
mappinglibrary.spec
Der Inhalt der MappingLibrary. spec.mappings ist erforderlich und muss mindestens einen Eintrag deklarieren. spec trägt additionalProperties: false — auf Ebene der Hülle werden keine parallelen Authoring-Modi akzeptiert. Die Festlegung auf einen einzigen Authoring-Modus hält das Recipe-Rendering einheitlich (durchgehend Go-Templates) und erspart es Autoren, beim Konsumieren importierter Fragmente mitten im Rendering das Auswertungsmodell zu wechseln.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
mappings | Map von string | ja | Benannte Map wiederverwendbarer Go-Template-Fragmente. Der Inhalt jedes Eintrags ist für die Validierung der Hülle opak — die Inhaltssemantik übernimmt der Go-Template-Parser zum Zeitpunkt des Konsums. Schlüssel: PascalCase-Bezeichner. Eintragsschlüssel erscheinen in kanonischen Referenz-URLs (#/mappings/<name>); die Einschränkung auf Ebene der Hülle verhindert, dass Schlüssel, die nicht PascalCase sind, sich durch das Katalog-Ökosystem verbreiten. Muster: ^[A-Z][A-Za-z0-9]*$. Mindestens 1 Eintrag. |
Zusätzliche Eigenschaften sind nicht zulässig.