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 (MappingLibrary)

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

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

Una colección reutilizable de fragmentos de plantillas Go que las Recipes y FeatureRecipes consumen en el momento del renderizado mediante valuesMapping: { $import: ... }. Nivel 3 — opcional, para catálogos que necesitan reutilizar mapeos entre una Recipe y otra. Un único modo de autoría: solo plantillas Go.

Consulta la referencia de autoría de la MappingLibrary para obtener orientación en prosa sobre cómo escribir entidades MappingLibrary; 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 “MappingLibrary”síConstante: "MappingLibrary"
metadataobjectsí
specobjectsíEl contenido de la MappingLibrary. spec.mappings es obligatorio y debe declarar al menos una entrada. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado de la Recipe (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados.

No se permiten propiedades adicionales.

mappinglibrary.metadata

PropiedadTipoObligatoriaDescripción
namestringsíIdentificador PascalCase de la biblioteca. Es el nombre en la referencia de identidad por nombre simple #/mappings/; 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). Un consumidor puede exigirla como versión mínima :<version> opcional en una referencia por nombre simple (:#/mappings/); el archivo de bloqueo de cada Release determina la versión resuelta. 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.

mappinglibrary.spec

El contenido de la MappingLibrary. spec.mappings es obligatorio y debe declarar al menos una entrada. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado de la Recipe (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados.

PropiedadTipoObligatoriaDescripción
mappingsmapa de stringsíMapa con nombre de fragmentos de plantillas Go reutilizables. El cuerpo de cada entrada es opaco para la validación del envoltorio — la semántica del contenido la gestiona el parser de plantillas Go en el momento del consumo. Claves: identificador PascalCase. Las claves de las entradas aparecen en las URL de referencia canónicas (#/mappings/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. Patrón: ^[A-Z][A-Za-z0-9]*$. Al menos 1 entrada.

No se permiten propiedades adicionales.