Panoramica del vocabolario
Un piccolo insieme di parole chiave ricorre tra le entità di Aggrega. Invece di rispiegarle in ogni pagina di entità, i capitoli del vocabolario concentrano la spiegazione in un unico punto per ogni famiglia di parole chiave. Ogni entità che accetta una di queste parole chiave lo fa con la stessa semantica che questo insieme di capitoli specifica.
Il vocabolario si divide in quattro famiglie: la triade topologica (provides, inject, uses), che collega archi topologici espliciti tra i nodi e porta il contratto di iniezione che il compilatore fa transitare; i pilastri dei dati (values, infra, parameters, locals), che separano le quattro responsabilità sui dati — intento dello sviluppatore, dimensionamento fisico, parametri per ambiente e stato privato della Recipe; le parole chiave di ereditarietà e interfaccia (extends, implements), che compongono le entità di catalogo e dichiarano quale Component implementa una Recipe; e il sistema dei modificatori (appliesTo, appliesToAnyOf), che stabilisce a quali nodi si collega una Feature tramite selettori di etichette. L’inquadramento concettuale di come i pilastri separano le responsabilità è in ../architecture/06-data-taxonomy-and-composition.md; la meccanica di risoluzione della topologia è in ../architecture/07-dependency-resolution.md.
Riferimento per argomento
- Triade topologica:
provides,inject,uses— il contratto di iniezione e le dichiarazioni esplicite degli archi topologici. Tratta la sintassi inject compatta e quella estesa, le forme delle pipe.context.inject/.context.usesche i template leggono e il contesto a doppio stato che protegge Ops dai panic da puntatore nil. - Pilastri dei dati:
values,infra,parameters,locals— i quattro pilastri dei dati e la loro proprietà.valueseparametersdi proprietà dello sviluppatore,infradi proprietà di Ops,localsprivati della Recipe e il pattern di hoisting dei parametri per la variazione per ambiente. - Ereditarietà e interfaccia:
extends,implements— l’ereditarietà delle entità di catalogo tramiteextends(il deep-merge dell’envelope YAML comune a Components e Features, i pilastri dei dati che un Component che estende eredita per intero dalla propria base, e la composizione JSON Schema 2020-12 a cui è sottoposto lo schema di una Feature) e la dichiarazione tra Recipe e Componentimplements(forme esatta, con intervallo di versioni e senza versione), rispetto alla quale viene verificato il mapping del Manifest —implementsnon seleziona mai una Recipe. - Sistema dei modificatori:
appliesToe selettori — i selettori di attachment delle Feature, il motore nativo Go di corrispondenza delle etichette, la grammatica dei selettori in forma di stringa e la varianteappliesToAnyOfche compone in OR. - Al di fuori delle quattro famiglie: scrittura in forma compatta, riferimenti tra documenti, label e annotazioni, la superficie di pubblicazione, contratti sociali, la superficie di validazione, la composizione dell’output, la grammatica URI e la risoluzione delle versioni.