콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

어휘 개요

Aggrega의 엔터티 전반에는 소수의 키워드가 반복해서 등장합니다. 어휘 장에서는 엔터티 페이지마다 이를 다시 설명하는 대신, 키워드 계열마다 한 곳에 설명을 모아 둡니다. 이러한 키워드 중 하나를 받는 모든 엔터티는 이 장들이 명시하는 것과 동일한 의미로 이를 받습니다.

어휘는 네 계열로 나뉩니다. 노드 사이에 명시적인 토폴로지 간선을 연결하고 컴파일러가 전달하는 주입 계약을 담는 토폴로지 삼원소(provides, inject, uses), 네 가지 데이터 관심사, 즉 개발자 의도, 물리적 규모, 환경별 조정값, Recipe 비공개 상태를 분리하는 데이터 축(values, infra, parameters, locals), 카탈로그 엔터티를 조합하고 Recipe가 어떤 Component를 구현하는지 선언하는 상속 및 인터페이스 키워드(extends, implements), 그리고 레이블 셀렉터를 통해 Feature가 어떤 노드에 연결되는지를 결정하는 수정자 시스템(appliesTo, appliesToAnyOf)입니다. 데이터 축이 관심사를 분리하는 방식에 대한 개념적 설명은 ../architecture/06-data-taxonomy-and-composition.md에, 토폴로지 해석 메커니즘은 ../architecture/07-dependency-resolution.md에 있습니다.

주제별 레퍼런스

  • 토폴로지 삼원소: provides, inject, uses — 주입 계약과 명시적 토폴로지 간선 선언을 다룹니다. 간결한 inject 구문과 상세한 inject 구문의 비교, 템플릿이 읽는 .context.inject / .context.uses 파이프 형태, 그리고 Ops를 nil 포인터 패닉으로부터 보호하는 이중 상태 컨텍스트를 설명합니다.
  • 데이터 축: values, infra, parameters, locals — 네 가지 데이터 축과 그 소유권을 다룹니다. 개발자가 소유하는 values와 parameters, Ops가 소유하는 infra, Recipe 비공개 locals, 그리고 환경별 변형을 위한 파라미터 끌어올리기 패턴을 설명합니다.
  • 상속 및 인터페이스: extends, implements — extends를 통한 카탈로그 엔터티 상속(Components와 Features에 공통인 YAML 엔벌로프 딥 머지, 확장하는 Component가 기반으로부터 통째로 상속하는 데이터 축, 그리고 Feature의 스키마에 적용되는 JSON Schema 2020-12 조합)과 Recipe에서 Component로의 선언인 implements(정확한 형식, 버전 범위 형식, 버전 없는 형식)를 다룹니다. Manifest의 매핑은 이 선언에 대해 검사되며, implements는 결코 Recipe를 선택하지 않습니다.
  • 수정자 시스템: appliesTo와 셀렉터 — Feature 연결 셀렉터, 네이티브 Go 레이블 매칭 엔진, 문자열 형식 셀렉터 문법, 그리고 OR로 조합하는 appliesToAnyOf 변형을 다룹니다.
  • 네 계열 밖의 항목: 축약형 작성, 문서 간 참조, 레이블과 어노테이션, 게시 표면, 사회 계약, 검증 표면, 출력 구성, URI 문법, 버전 해석.