Filosofia do ecossistema
A filosofia do ecossistema
A arquitetura do Aggrega orienta-se por princípios de design centrais que equilibram flexibilidade e previsibilidade. Ao manter fronteiras claras e contratos normalizados, um compilador fundamentalmente genérico consegue orquestrar sem esforço tudo, desde a infraestrutura cloud-native comum até à inteligência de IA altamente especializada.
1. Mecânica central: a física da arquitetura
- Separação de responsabilidades (lei de Conway): os programadores não escrevem código de infraestrutura física, e as Ops não fixam no código lógica de aplicação. A orientação da arquitetura divide a escrita em fronteiras orientadas ao domínio (Domain-Driven), uma separação que o compilador não impõe (ver Invariante 7).
- Ligação tardia (inversão de dependências): os programadores pedem interfaces abstratas (por exemplo,
type: enterprise-agent), não implementações específicas (por exemplo,helm-chart-v2). O Manifest resolve a interface para a implementação correta em tempo de compilação, permitindo verdadeiras implantações multialvo a partir de um único ficheiro de origem. - Pureza AOT (sem consultas à cloud em funcionamento): o compilador é agnóstico em relação à cloud em funcionamento. Nunca se autentica junto de APIs de infraestrutura nem obtém endereços IP em tempo real durante a compilação. Opera inteiramente por inversão de controlo, mapeando ponteiros determinísticos e passando antecipadamente contratos de injeção abstratos para que o ambiente de runtime possa resolver com segurança as ligações físicas finais.
2. A experiência do programador: intenção e abstração
- Experiência semântica do programador (a norma do mapa de 5 palavras-chave): para evitar atrito cognitivo, os programadores usam exatamente cinco palavras-chave universalmente compreendidas numa topologia YAML baseada em mapas:
parameters: o contrato global do ambiente (por exemplo, passar tamanhos de disco dinâmicos).values: o payload central da lógica cognitiva/de negócio (pertence ao programador).uses: as arestas de rede e as dependências declaradas explicitamente (pertencem ao programador).infra: a pegada física e o dimensionamento mecânico (pertence às Ops, proibido no Aggregate).inject: o contrato de entrega estrito que mapeia variáveis locais para o destino, chaves de provides (env,file,arg). Este mecanismo é extensível.
- Terminologia agnóstica em relação às capacidades: para evitar que as realidades da infraestrutura subjacente (como o termo
namespacedo Kubernetes) se infiltrem na experiência do programador, a plataforma utiliza conceitos universais comoboundaries. - Intenção explícita e o «guardrail ruidoso» (sem infraestrutura fantasma): o compilador nunca deve inventar computação ou funcionalidades que o programador não tenha declarado explicitamente. Usar um motor de políticas para injetar silenciosamente um proxy de segurança cria «infraestrutura fantasma» — quando falha, o programador acaba por depurar um proxy que não existe no seu YAML. Em vez de alterar silenciosamente a arquitetura, os plugins de políticas Wasm atuam estritamente como guardrails ruidosos. Se uma topologia violar a segurança, o compilador interrompe a build e devolve um erro altamente específico (por exemplo, “Error: PII data flowing to a model provider through the AI gateway
router. You must explicitly attach thecore/data-maskingfeature to it” (Erro: dados PII a fluir para um fornecedor de modelos através do gateway de IA router. É necessário anexar-lhe explicitamente a funcionalidade core/data-masking)), obrigando o programador a corrigir a sua própria fonte única de verdade.
3. O compilador sem opiniões próprias: processamento e orquestração
- Políticas programáveis (o compilador sem opiniões próprias): o compilador central em Go é um mecanismo de cálculo neutro quanto ao conteúdo. Analisa YAML, percorre grafos e avalia interseções de etiquetas. A verdadeira «inteligência» (por exemplo, impor que o tráfego de modelos que transporta dados restritos passe por um gateway de IA que mascara texto sensível) é programada dinamicamente pela empresa com sockets WebAssembly (Wasm) conectáveis para mutações da árvore de sintaxe abstrata (AST) — alterando a representação em memória, já analisada, da configuração — e para a validação de políticas.
- Agnosticismo de esquema (dicionário de origem aberto): o compilador central é agnóstico em relação às camadas de execução física. Não possui esquemas fixos para Helm, Terraform ou Docker Compose. Em vez disso, o bloco
sourcede uma Recipe das Ops é um dicionário aberto cujas chaves são definidas pelo fornecedor e chegam aos templates da Recipe como.source.*. O núcleo resolve uma origem obtida através de uma forma integrada{ kind, url, version }(tipos:helm-oci-chart,helm-https-chart,compose-https-fragment,git-repository), o que já desacopla o compilador das linguagens de cloud que manipula. Consulte a referência desourceda Recipe para o modelo de obtenção. - Orquestração explícita de Plugin: O compilador Go central atua estritamente como um construtor de grafos neutro e nunca adivinha como processar um nó. Em vez disso, toda a inteligência de domínio é orquestrada explicitamente através de sockets WebAssembly (Wasm) dedicados, em dois níveis distintos. 1. Sockets globais: As políticas e a formatação da empresa são avaliadas por sockets do compilador registados explicitamente (por exemplo, o papel de governação
label-transformpara a etiquetagem automática de metadados, um papel de veredicto de governação para a segurança topológica e o socket de renderização para a geração final de artefactos). 2. Pipelines de implementação: A lógica de mutação específica de cada Component é orquestrada peloManifest; quando este resolve uma interface abstrata para umaRecipeconcreta, essa implementação declara explicitamente um array sequencialpipelinede plugins Wasm a executar. O compilador limita-se a alimentar estes sockets definidos com o grafo da Representação Intermédia (IR) agnóstico em relação às capacidades, garantindo que toda a lógica específica do domínio permanece estritamente versionada no ecossistema, em vez de codificada no núcleo do compilador. - Compilação plana e atomicidade da Feature: o Aggrega não gere estado, não faz ping a endpoints nem espera que um rollout termine. O compilador avalia módulos aninhados e resolve-os num grafo de representação intermédia (IR) plano e unidimensional antes de passar os dados aos plugins de renderização Wasm. Crucialmente, embora o grafo seja achatado, o compilador preserva a atomicidade da Feature. Se uma funcionalidade de proxy declarar autonomamente uma aresta de rede para um cofre seguro, o compilador regista a origem semântica dessa aresta, garantindo que os motores de políticas Wasm podem executar consultas $O(1)$ sem atribuir falsamente a ligação ao componente pai. Por fim, para suportar a sequenciação temporal, cada fronteira na Release transporta um valor
syncWave: <integer>; cada plugin de renderização traduz a vaga de cada fronteira naquilo com que o seu próprio alvo exprime a ordem — uma anotação de ordem de execução que o controlador GitOps a jusante lê, ou uma dependência entre os serviços do ficheiro que renderiza —, enquanto um alvo sem qualquer superfície de ordenação regista a vaga sem sequenciar com base nela.
4. A ontologia semântica: identificação e taxonomia
- A ontologia operacional cloud-native: para garantir que plugins Wasm de código aberto e políticas empresariais interoperam universalmente, a etiqueta
component.aggrega.ai/typecorresponde exclusivamente a um conjunto fechado de primitivas universais da cloud (server,worker,task,function,stateful-server,resource). Esta é a chave do próprio Aggrega: o esquema publicado de Component enumera os valores que aceita, e um documento que contenha qualquer outro valor é recusado ao ser carregado. Fixar esse vocabulário de forma central é o que garante que os motores de políticas autónomos e os plugins de renderização Wasm criados pela comunidade leem a mesma palavra para a mesma forma quando encontram um Component que nenhum dos seus autores escreveu. O compilador continua a não inferir nada da cadeia — compara o valor com um seletor e não aprovisiona nada por iniciativa própria; o que o conjunto fechado garante é que o seletor de todos compara com o mesmo vocabulário. - Classificar segundo um eixo que o Aggrega não define: o conjunto fechado abrange esta única chave reservada. Um catálogo que precise da sua própria classificação — um nível, uma zona de dados, uma classe de serviço, uma divisão mais fina das primitivas — escreve a sua própria chave de etiqueta ao lado da reservada, uma vez que o esquema de Component aceita qualquer outra chave de etiqueta com um valor de cadeia e todas as superfícies de seletores a leem da mesma forma. A extensão acontece na sua chave, não dentro da do Aggrega, e é isso que permite que um vocabulário empresarial cresça sem que o partilhado se desvie.
- Duck typing (traços semânticos através de etiquetas): se os tipos de base são puramente cloud-native, toda a inteligência cognitiva, operacional e de conformidade é sobreposta inteiramente através de duck typing semântico. As etiquetas escritas pelo arquiteto de plataforma (por exemplo,
model.aggrega.ai/capability: generative,compliance.aggrega.ai/data-class: restricted) funcionam como a verdadeira identidade do nó. As Features ligam-se dinamicamente aos componentes com base nestes seletores de etiquetas.
5. Governação empresarial: esquemas e herança
-
Particionamento estrito da API e descoberta empresarial: seguindo as normas do Kubernetes, todas as definições de payload residem uniformemente num bloco
spec:. A identidade do recurso, as etiquetas de características e as instruções explícitas ao compilador residem estritamente no blocometadata:. Para garantir uma resolução estrita, todo o artefacto YAML partilhável exige obrigatoriamente uma cadeia SemVerversionvalidada por regex. Além disso, para suportar a descoberta em registos OCI e a governação do ciclo de vida, o blocometadatasuporta um conjunto de metadados empresariais opcional. Este conjunto incluidescription, um array estruturado de objetosmaintainers(name, email, url),license,repository,home(URL da documentação) ekeywords(para indexação de pesquisa). O fim de vida é gerido fora do documento:aggrega deprecateanexa um marcador de descontinuação assinado — uma gravidade, um motivo e uma substituição opcional — a um artefacto já publicado sem alterar os seus bytes publicados. -
Extensibilidade dos esquemas (o padrão CRD do Kubernetes): para evitar atualizar o esquema central do compilador a cada nova funcionalidade de IA ou de infraestrutura, a plataforma usa JSON Schema 2020-12 para validar as configurações. Os arquitetos de plataforma escrevem tipos estritos, lógica de validação e valores predefinidos diretamente no bloco
schema:dos componentes do catálogo — tipicamente na forma compacta, uma forma abreviada com o aspeto de YAML que acomoda numa linha as restrições de cada campo (port: { type: integer, min: 1, max: 65535, default: 8080 }) e é compilada para JSON Schema 2020-12 antes de a validação correr. O YAML de JSON Schema completo continua a ser uma opção de escrita equivalente para os esquemas que precisam do seu vocabulário completo. Os catálogos que crescem o suficiente para beneficiar da reutilização de esquemas de um Component para outro movem formas comuns (blocos de sondas, limites de recursos, formas de portas com nome) para uma entidade SchemaLibrary dedicada e referenciam-nas através da palavra-chave$ref:do JSON Schema. -
Herança de esquemas (linhas de base do payload): para que uma linha de base seja escrita uma só vez, a plataforma divide a herança em dois níveis distintos. Os metadados YAML comuns (incluindo as etiquetas semânticas), os mapeamentos do
Manifeste as configurações daReleaseutilizam estratégias de fusão tradicionais para permitir as substituições de ambiente necessárias. Os esquemas de payload (schema:) não se fundem dessa forma, e os dois tipos de catálogo separam-se: oschema:de uma Feature compõe-se com o da sua base segundo a semântica de composição do JSON Schema 2020-12, percorrida ao carregar o espaço de trabalho por um mecanismo de fusão com etiquetagem da proveniência da posição na origem, de modo que cada folha do esquema fundido indica o ficheiro de onde provém; um Component que estende outro não escreve qualquer conteúdo de payload — escreve o marcador literalschema: inheritede recebe o bloco da sua base exatamente como a base o escreveu, a qualquer profundidade de uma cadeia. A linha de base de um Component é, portanto, garantida por construção e não por política: o contrato do filho é simplesmente o da base, pelo que não há nada que o filho possa relaxar. O que esse Component compõe, em vez disso, é a estrutura — os seus slots de anexação, sockets de topologia, lista de permissões de autoinjeção eassertionscom nome — e um filho que precise de uma regra mais apertada do que a que a sua base declara exprime-a como uma entradaassertions:adicional, que as regras da base mantêm a seu lado em vez de a substituírem. A segurança topológica mais ampla e a governação de etiquetas continuam devidamente delegadas no socket de governação Wasm. -
Paridade de interface e implementação automática: para evitar que as Ops dupliquem YAML de Recipe quando um Architect cria uma variante ligeiramente alterada de um Component base, uma Recipe escrita para uma base serve todos os Components que a estendem, em qualquer profundidade da cadeia. O Component que estende escreve
schema: inherited, pelo que não acrescenta avalues/infra/providesnenhuma chave de raiz que a Recipe da base seja incapaz de consumir. O Manifest continua a mapear o tipo que estende com uma entrada própria, e a verificação do mapeamento aceita essa entrada quando oimplementsda Recipe mapeada nomeia o tipo ou qualquer base que este estenda (ver Uma Recipe escrita para uma base serve tudo o que a estende). O rastreador de infraestrutura fantasma (que emite avisos quando nenhum template declarado pela Recipe associada lê uma chave escrita, para evitar a «infraestrutura fantasma») é o guardrail correspondente da fase de renderização. -
Correspondência de versões de
implements: o campoimplementsem Recipes e FeatureRecipes suporta três formas para equilibrar o rigor com a flexibilidade do ecossistema:- Versão exata:
implements: "core/api-server:1.0.0"— corresponde apenas a1.0.0. Para Recipes fortemente acopladas a uma versão específica do esquema. - Compatível com a versão major (intervalo SemVer):
implements: "core/api-server:^1.0.0"— corresponde a>=1.0.0, <2.0.0. Concebida para Recipes que se apoiam nas garantias de compatibilidade SemVer do Component: as subidas minor e patch presumem-se retrocompatíveis segundo o SemVer, e o compilador verifica que a versão do Component satisfaz o intervalo. - Sem versão:
implements: "core/api-server"— corresponde a qualquer versão. Para Recipes que são genuinamente agnósticas em relação à versão (por exemplo, uma Recipe genérica de worker que só usa.context.inject.enve nenhum campo devaluesespecífico de uma versão).
implementsnunca seleciona uma Recipe: o Manifest nomeia a Recipe para cada tipo de componente, e o compilador verifica que oimplementsda Recipe mapeada aceita esse tipo numa das três formas, parando em caso de discrepância. É através da mesma declaração que o compilador sugere Recipes candidatas quando um tipo de componente não tem mapeamento.O padrão das três formas permite que as Recipes declarem o contrato de versão adequado ao seu acoplamento real ao esquema do Component. As Recipes fortemente ligadas a uma versão específica do esquema fixam-na exatamente; as Recipes que se apoiam nas garantias de compatibilidade SemVer do Component usam um intervalo compatível com a versão major; as Recipes cujo comportamento não depende de todo da versão do Component ficam sem versão. O resultado é que as subidas de versão minor de um Component não obrigam as Ops a fixar versões de Component nem a manter Recipes paralelas por versão.
- Versão exata: