Visión general del vocabulario
Un pequeño conjunto de palabras clave se repite en las entidades de Aggrega. En lugar de volver a explicarlas en cada página de entidad, los capítulos del vocabulario concentran la explicación en un único lugar por familia de palabras clave. Toda entidad que acepta una de estas palabras clave lo hace con la misma semántica que especifica este conjunto de capítulos.
El vocabulario se divide en cuatro familias: la tríada topológica (provides, inject, uses), que conecta aristas topológicas explícitas entre nodos y lleva el contrato de inyección que el compilador canaliza; los pilares de datos (values, infra, parameters, locals), que separan las cuatro responsabilidades sobre los datos — intención del desarrollador, dimensionamiento físico, ajustes por entorno y estado privado de la Recipe; las palabras clave de herencia e interfaz (extends, implements), que componen entidades de catálogo y declaran qué Component implementa una Recipe; y el sistema de modificadores (appliesTo, appliesToAnyOf), que determina a qué nodos se adjunta una Feature mediante selectores de etiquetas. El marco conceptual de cómo los pilares separan las responsabilidades se encuentra en ../architecture/06-data-taxonomy-and-composition.md; la mecánica de resolución de la topología, en ../architecture/07-dependency-resolution.md.
Referencia por tema
- Tríada topológica:
provides,inject,uses— el contrato de inyección y las declaraciones explícitas de aristas topológicas. Cubre la sintaxis de inject compacta frente a la detallada, las formas de pipe.context.inject/.context.usesque leen las plantillas y el contexto de doble estado que protege a Ops de los panics por puntero nil. - Pilares de datos:
values,infra,parameters,locals— los cuatro pilares de datos y a quién pertenecen.valuesyparametersdel desarrollador,infrade Ops,localsprivados de la Recipe y el patrón de elevación de parámetros para la variación por entorno. - Herencia e interfaz:
extends,implements— herencia de entidades de catálogo medianteextends(la fusión profunda del envelope YAML común a Components y Features, los pilares de datos que un Component que extiende hereda íntegros de su base y la composición JSON Schema 2020-12 a la que se somete el esquema de una Feature) y la declaración de Recipe a Componentimplements(formas exacta, con rango de versiones y sin versión), contra la que se comprueba el mapeo del Manifest —implementsnunca selecciona una Recipe. - Sistema de modificadores:
appliesToy selectores — los selectores de attachment de Feature, el motor nativo de Go para la coincidencia de etiquetas, la gramática de selectores en forma de cadena y la varianteappliesToAnyOfque compone con OR. - Fuera de las cuatro familias: la escritura en forma compacta, las referencias entre documentos, las etiquetas y anotaciones, la superficie de publicación, los contratos sociales, la superficie de validación, la composición de la salida, la gramática de URI y la resolución de versiones.