Esquema do catálogo do Aggrega (SchemaLibrary)
Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json
Uma coleção reutilizável de definições JSON Schema 2020-12 que o conteúdo do catálogo (Components, Features etc.) pode referenciar via $ref por meio da referência de identidade por nome simples
Consulte a referência de autoria da SchemaLibrary para orientações em prosa sobre como escrever entidades SchemaLibrary; esta página documenta o esquema estrutural que essa referência descreve.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “SchemaLibrary” | sim | Constante: "SchemaLibrary" |
metadata | object | sim | |
spec | object | sim | O conteúdo da SchemaLibrary. spec.schemas é obrigatório e deve declarar pelo menos uma entrada; spec.templates é opcional e só está presente quando a biblioteca usa helpers parametrizados. |
Não são permitidas propriedades adicionais.
schemalibrary.metadata
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | Identificador PascalCase da biblioteca. É o nome ^[A-Z][A-Za-z0-9]*$. |
version | string | sim | Versionamento semântico estrito da biblioteca (por exemplo, 1.0.0). O arquivo de bloqueio de cada Release fixa uma versão por biblioteca. Padrão: ^(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-]+)*))?$. |
description | string | não | Um resumo conciso do que a biblioteca abrange. |
labels | mapa de string | não | Rótulos declarados pelo autor. O compilador é neutro quanto ao conteúdo e não interpreta os valores dos rótulos: são metadados opacos, carregados para que aquilo que ler a biblioteca possa usá-los na correspondência. |
annotations | mapa de string | não | Anotações declaradas pelo autor. A mesma postura de metadados opacos dos rótulos. |
Não são permitidas propriedades adicionais.
schemalibrary.spec
O conteúdo da SchemaLibrary. spec.schemas é obrigatório e deve declarar pelo menos uma entrada; spec.templates é opcional e só está presente quando a biblioteca usa helpers parametrizados.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
schemas | mapa de object | sim | Mapa nomeado de definições de esquema reutilizáveis. O conteúdo de cada entrada é validado pelo compilador da forma compacta no momento da análise; a validação no nível do envelope verifica apenas o encapsulamento estrutural. Chaves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. As chaves das entradas aparecem nas referências de identidade por nome simples (<Library>#/schemas/<name>); a restrição no nível do envelope impede que chaves que não sejam PascalCase se propaguem pelo ecossistema do catálogo. Pelo menos 1 entrada. |
templates | mapa de object | não | Mapa nomeado opcional de helpers parametrizados. As entradas de esquema referenciam templates pelo nome via $instantiate:; apenas substituição literal de escalares — sem templates Go embutidos, sem condicionais, sem laços. A camada de substituição da biblioteca é intencionalmente mais restrita que uma avaliação completa de templates, para que a autoria permaneça na linguagem de esquemas em vez de introduzir uma superfície de templating separada. Chaves: identificador PascalCase — ^[A-Z][A-Za-z0-9]*$. A mesma disciplina no nível do envelope que as chaves das entradas de esquema; os nomes de template são referenciados via $instantiate: no momento da instanciação. |
Não são permitidas propriedades adicionais.