Übersicht des Vokabulars
Eine kleine Menge von Schlüsselwörtern kehrt in den Entitäten von Aggrega wieder. Statt sie auf jeder Entitätsseite erneut zu erklären, bündeln die Vokabular-Kapitel die Erläuterung an einer Stelle pro Schlüsselwortfamilie. Jede Entität, die eines dieser Schlüsselwörter akzeptiert, tut dies mit derselben Semantik, die diese Kapitelgruppe festlegt.
Das Vokabular gliedert sich in vier Familien: die Topologie-Triade (provides, inject, uses), die explizite topologische Kanten zwischen Knoten verdrahtet und den Injektionsvertrag trägt, den der Compiler durchleitet; die Datensäulen (values, infra, parameters, locals), die die vier Datenbelange trennen — Absicht des Entwicklers, physische Dimensionierung, umgebungsspezifische Stellschrauben und privater Recipe-Zustand; die Schlüsselwörter für Vererbung und Schnittstelle (extends, implements), die Katalogentitäten zusammensetzen und deklarieren, welche Component eine Recipe implementiert; und das Modifikatorsystem (appliesTo, appliesToAnyOf), das regelt, an welche Knoten sich ein Feature über Label-Selektoren anbindet. Die konzeptionelle Einordnung, wie die Säulen Belange trennen, findet sich in ../architecture/06-data-taxonomy-and-composition.md; die Mechanik der Topologieauflösung in ../architecture/07-dependency-resolution.md.
Referenz nach Thema
- Topologie-Triade:
provides,inject,uses— der Injektionsvertrag und die expliziten Deklarationen topologischer Kanten. Behandelt kompakte gegenüber ausführlicher inject-Syntax, die Pipe-Formen.context.inject/.context.uses, die Templates lesen, und den Kontext mit doppeltem Zustand, der Ops vor Nil-Pointer-Panics schützt. - Datensäulen:
values,infra,parameters,locals— die vier Datensäulen und ihre Zuständigkeit. Vom Entwickler verantwortetevaluesundparameters, von Ops verantwortetesinfra, Recipe-privatelocalsund das Muster des Parameter-Hoistings für umgebungsspezifische Variation. - Vererbung und Schnittstelle:
extends,implements— Vererbung von Katalogentitäten überextends(der Deep-Merge des YAML-Envelopes, der Components und Features gemeinsam ist, die Datensäulen, die eine erweiternde Component vollständig von ihrer Basis erbt, und die JSON-Schema-2020-12-Komposition, der das Schema eines Feature unterzogen wird) und die Deklarationimplementsvon Recipe zu Component (exakte, versionsbereichsbasierte und unversionierte Formen), gegen die das Mapping des Manifest geprüft wird —implementswählt nie eine Recipe aus. - Modifikatorsystem:
appliesTound Selektoren — Selektoren zur Anbindung von Features, die native Go-Engine für den Label-Abgleich, die Grammatik der Selektoren in Zeichenkettenform und die OR-verknüpfende VarianteappliesToAnyOf. - Außerhalb der vier Familien: Verfassen in kompakter Form, dokumentübergreifende Referenzen, Labels und Annotationen, die Veröffentlichungsoberfläche, Gesellschaftsverträge, die Validierungsoberfläche, Ausgabekomposition, die URI-Grammatik und Versionsauflösung.