Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Esquema del catálogo de Aggrega (SchemaLibrary)

Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.

ID del esquema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json

Una colección reutilizable de definiciones JSON Schema 2020-12 a las que el contenido del catálogo (Components, Features, etc.) puede hacer $ref mediante la referencia de identidad por nombre simple #/schemas/ (la versión la suministra el archivo de bloqueo de cada Release; ningún host de registro aparece en la referencia). Nivel 3 — opcional, para catálogos que necesitan reutilizar esquemas entre un Component y otro.

Consulta la referencia de autoría de la SchemaLibrary para obtener orientación en prosa sobre cómo escribir entidades SchemaLibrary; esta página documenta el esquema estructural que describe esa referencia.

Tipo de nivel superior: object

Propiedades

PropiedadTipoObligatoriaDescripción
apiVersionconst “aggrega.ai/v1beta1”síConstante: "aggrega.ai/v1beta1"
kindconst “SchemaLibrary”síConstante: "SchemaLibrary"
metadataobjectsí
specobjectsíEl contenido de la SchemaLibrary. spec.schemas es obligatorio y debe declarar al menos una entrada; spec.templates es opcional y solo está presente cuando la biblioteca usa helpers parametrizados.

No se permiten propiedades adicionales.

schemalibrary.metadata

PropiedadTipoObligatoriaDescripción
namestringsíIdentificador PascalCase de la biblioteca. Es el nombre en la referencia de identidad por nombre simple #/schemas/; la versión la proporciona el archivo de bloqueo de cada Release y ningún host de registro entra en la referencia ni en ningún identificador derivado. Patrón: ^[A-Z][A-Za-z0-9]*$.
versionstringsíVersionado semántico estricto de la biblioteca (p. ej., 1.0.0). El archivo de bloqueo de cada Release fija una versión por biblioteca. Patrón: ^(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-]+)*))?$.
descriptionstringnoUn resumen conciso de lo que cubre la biblioteca.
labelsmapa de stringnoEtiquetas declaradas por el autor. El compilador es neutral respecto al contenido y no interpreta los valores de las etiquetas: son metadatos opacos, transmitidos para que lo que lea la biblioteca pueda usarlos para hacer coincidencias.
annotationsmapa de stringnoAnotaciones declaradas por el autor. La misma postura de metadatos opacos que las etiquetas.

No se permiten propiedades adicionales.

schemalibrary.spec

El contenido de la SchemaLibrary. spec.schemas es obligatorio y debe declarar al menos una entrada; spec.templates es opcional y solo está presente cuando la biblioteca usa helpers parametrizados.

PropiedadTipoObligatoriaDescripción
schemasmapa de objectsíMapa con nombre de definiciones de esquema reutilizables. El contenido de cada entrada lo valida el compilador de la forma compacta en el momento del análisis; la validación a nivel del envoltorio solo comprueba la estructura que lo envuelve. Claves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. Las claves de las entradas aparecen en las referencias de identidad por nombre simple (<Library>#/schemas/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. Al menos 1 entrada.
templatesmapa de objectnoMapa con nombre opcional de helpers parametrizados. Las entradas de esquema hacen referencia a plantillas por nombre mediante $instantiate:; solo sustitución literal de escalares — sin plantillas Go incrustadas, sin condicionales, sin bucles. La capa de sustitución de la biblioteca es intencionadamente más estrecha que una evaluación completa de plantillas, para que la autoría permanezca en el lenguaje de esquemas en lugar de introducir una superficie de plantillas aparte. Claves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. La misma disciplina a nivel del envoltorio que las claves de las entradas de esquema; los nombres de plantilla se referencian mediante $instantiate: en el momento de la instanciación.

No se permiten propiedades adicionales.