Aggrega 개발자 의도(Aggregate) 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 id: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json
재귀적이고 매개변수화된 AI 아키텍처입니다. 빌드의 루트이자 재사용 가능한 모듈로 동작합니다.
Aggregate 엔터티 작성에 관한 설명은 Aggregate 작성 레퍼런스를 참조하십시오. 이 페이지는 해당 레퍼런스가 설명하는 구조적 스키마를 문서화합니다.
최상위 타입: object
속성
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 예 | 상수: "aggrega.ai/v1beta1" |
kind | const “Aggregate” | 예 | 상수: "Aggregate" |
metadata | object | 예 | |
defs | string[] | 아니요 | 표준 YAML 앵커(& 및 *)를 위한 선택적 블록으로, 컴파일러를 위해 평탄한 O(1) 딕셔너리를 유지하면서 Aggregate를 DRY하게 유지합니다. Manifest의 동일한 블록을 그대로 따릅니다. |
spec | object | 예 | Developer Intent 표면: 전역 파라미터 계약, 중첩된 aggregate 임포트, 내보낸 컴포넌트 공개 API, 서브시스템 그룹, 그리고 모듈을 구성하는 컴포넌트 인스턴스입니다. |
추가 속성은 허용되지 않습니다.
aggregate.metadata
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 최소 1자 이상이어야 합니다. |
version | string | 예 | aggregate 모듈의 엄격한 Semantic Versioning입니다. 패턴: ^(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 | 아니요 | |
maintainers | object[] | 아니요 | 이 엔티티를 소유하는 메인테이너 목록입니다. |
license | string | 아니요 | 이 엔티티가 기술하는 소프트웨어의 라이선스를 나타내는 SPDX 식별자로, MIT 또는 AGPL-3.0 등이 있습니다. 이 파일의 조건이 아니라 해당 소프트웨어의 조건을 기록합니다. |
repository | string | 아니요 | 소스 파일이 있는 Git 저장소의 URL입니다. |
home | string | 아니요 | 이 엔티티의 홈페이지, 위키 또는 문서의 URL입니다. |
keywords | string[] | 아니요 | UI에서 쉽게 찾을 수 있도록 하는 설명 키워드 목록입니다. |
labels | string 맵 | 아니요 | 카탈로그 탐색, 정책 평가, Studio/IDE 필터링을 위한 모듈 수준의 덕 타이핑 레이블입니다. 이 레이블은 재사용 가능한 모듈로서 Aggregate의 정체성을 기술합니다(예: aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). 하위 컴포넌트 노드로 전파되지 않습니다. 컴포넌트 레이블은 오직 Domain 2의 Component 카탈로그 엔티티에서만 옵니다. |
추가 속성은 허용되지 않습니다.
aggregate.metadata.maintainers[]
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | |
email | string | 아니요 | |
url | string | 아니요 |
추가 속성은 허용되지 않습니다.
aggregate.spec
Developer Intent 표면: 전역 파라미터 계약, 중첩된 aggregate 임포트, 내보낸 컴포넌트 공개 API, 서브시스템 그룹, 그리고 모듈을 구성하는 컴포넌트 인스턴스입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
parameters | object 맵 | 아니요 | 전역 환경 계약입니다. 각 항목은 간결형 어휘의 부분 집합(type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties)을 작성하는 타입 지정 계약 객체입니다. 중첩 구조는 타입 지정형의 properties: 하위 필드로 표현합니다. Release의 충족은 인라인(parameters: {…})이나 단일 소스 파일 임포트(parameters: {$import: |
aggregates | object 맵 | 아니요 | 임포트된 모듈 역할을 하는 중첩 aggregate입니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
exportedComponents | string 맵 | 아니요 | 공개 API 인터페이스입니다. 노출된 공개 이름을 내부 컴포넌트 ID에 매핑합니다. 이 모듈을 임포트하는 상위 Aggregates는 이 공개 이름으로 컴포넌트를 참조합니다. |
subsystems | subsystem 맵 | 아니요 | Aggregate의 컴포넌트를 서브시스템으로 묶은 이름 있는 논리적 그룹입니다. 최상위 components와 상호 배타적이며, 둘 다 선언하면 거부됩니다. 작성자가 default라고 이름 붙인 서브시스템은 평범한 선언된 서브시스템이며, 컴파일러가 components만 있는 Aggregate를 위해 합성하는 default와는 다릅니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
components | component_instance 맵 | 아니요 | 이 Aggregate를 구성하는 논리적 원자 컴포넌트의 맵으로, 최상위에서 직접 작성합니다. 최상위 components와 subsystems는 상호 배타적이며, 둘 다 선언하면 거부됩니다. 컴포넌트를 여기에(subsystems 없이) 작성하면 컴파일러가 로드 시 이를 합성된 default 서브시스템으로 접어 넣으며, IR은 그 서브시스템을 합성된 것으로 표시합니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
추가 속성은 허용되지 않습니다.
정의
inject_delivery
항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features.
타입: object[]
inject_block
구애받지 않는 주입 라우팅입니다. 로컬 변수를 대상의 provides 키(uses[].inject), 첨부의 FeatureRecipe가 게시하는 provides 키(features.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
env | inject_delivery | 아니요 | 항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features. |
file | inject_delivery | 아니요 | 항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features. |
arg | inject_delivery | 아니요 | 항목의 배열로 작성되는 단일 전달 메커니즘입니다. 각 항목은 ‘in’(로컬 식별자 — 환경 변수 이름, 파일 경로, 인수 플래그 또는 사용자 정의 메커니즘별 키)과 함께 ‘from’(해석할 provides 키) 또는 ‘value’(리터럴 문자열로, self-inject 해석 시 평가되는 Go 템플릿 표현식을 선택적으로 포함할 수 있음) 중 정확히 하나를 가집니다. ‘from’은 uses[].inject 컨텍스트에서는 대상의 provides에 대해, 첨부의 features. |
component_uses_block
컴포넌트가 의존하는 컴포넌트로 연결하는 연결들로, 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. 별칭으로 이름이 지정된 연결은 개발자의 연결별 값과 소켓이 선언한 슬롯을 채우는 첨부를 가질 수 있습니다.
키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
값은 string[] or map of object입니다.
그 밖의 키는 허용되지 않습니다.
feature_uses_block
첨부된 Feature가 맺는 연결들로, Feature가 usesSchema에 선언한 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. Feature가 맺는 연결은 자체 첨부를 갖지 않습니다. 연결에 필요한 자격 증명은 Feature가 자신의 featuresSchema에 선언한 슬롯을 채우며 Feature 옆에 첨부됩니다.
키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$.
값은 string[] or map of object입니다.
그 밖의 키는 허용되지 않습니다.
connection_attachment
연결이 가지는 하나의 첨부입니다. 연결의 소켓이 선언한 슬롯을 채우는 Feature와 그에 대한 개발자의 구성으로 이루어집니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | 예 | 이 첨부가 요청하는 Feature 인터페이스의 URI입니다(예: core/referenced-secret:1.0.0). |
description | string | 아니요 | 이 연결이 해당 첨부를 가지는 이유를 설명하는 선택적 문서입니다. |
values | object | 아니요 | Feature에 대해 개발자가 제공하는 구성으로, 해당 스키마 선언에 따라 검증됩니다. |
추가 속성은 허용되지 않습니다.
subsystem
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
description | string | 아니요 | 이 서브시스템의 목적과 서브시스템이 나타내는 논리적 그룹을 설명하는 선택적 문서입니다. |
annotations | string 또는 object 또는 null의 맵 | 아니요 | 이 서브시스템에 대해 개발자가 작성한 어노테이션입니다. 값은 문자열, 구조화된 객체(하위 키에서 값으로의 맵으로, 상속된 구조화된 값과 하위 키별로 병합됨) 또는 null입니다. 상위 서브시스템에서 상속된 키에 명시적으로 null을 지정하면 상속된 바인딩이 이 서브시스템에서 제거됩니다(어노테이션 기반 Feature 옵트아웃). 여기에 선언된 어노테이션은 중첩된 서브시스템과 포함된 컴포넌트에 상속되며, 키별로 더 가까운 수준이 우선합니다. 파생된 각 IR 노드의 .context.annotations.aggregate 버킷으로 하위 전파됩니다. |
features | object 맵 | 아니요 | 이 서브시스템의 모든 컴포넌트에 첨부되는 횡단 기능입니다. 컴포넌트 수준 기능과 동일한 스키마(type, values, uses, inject)를 가집니다. 그래프 확정 시 각 컴포넌트로 평탄화되며, 실행 순서에서 컴포넌트 수준 기능 뒤에 배치됩니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
subsystems | subsystem 맵 | 아니요 | 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
components | component_instance 맵 | 아니요 | 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
추가 속성은 허용되지 않습니다.
component_instance
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
type | string | 예 | 요청하는 추상 Component를 참조로 지정합니다. metadata.name에 선택적인 :version을 붙인 것(예: core/api-server:1.0.0)이며, 파일 경로가 아닙니다. 3계층 엔터티 해석 모델(워크스페이스 카탈로그 디렉터리 → 캐시 → 레지스트리)로 해석됩니다. 로컬에서 작성한 Component는 워크스페이스 루트의 catalog/ 아래나 workspace.catalog_dirs에 나열된 디렉터리에 둡니다. 상대 파일 경로로 작성된 type은 어떤 카탈로그에도 없는 엔터티로서 빌드를 중단시킵니다. |
active | boolean 또는 string | 아니요 | 이 컴포넌트가 컴파일된 토폴로지에 존재하는지 여부입니다. boolean이거나, boolean으로 해석되어야 하는 .parameters 기반 string 템플릿입니다. false로 해석되면 컴포넌트는 토폴로지에서 제거되며, 이는 해당 uses 에지와 첨부에도 연쇄 적용됩니다. 값을 파라미터로 구동하면 Release가 해당 파라미터를 채워 컴포넌트의 존재 여부를 전환할 수 있습니다. 생략하면 기본값은 true입니다. 기본값: true |
description | string | 아니요 | 애플리케이션에서 이 컴포넌트 인스턴스의 역할을 설명하는 선택적 문서입니다. IR 그래프까지 전달됩니다. |
annotations | string 또는 object 또는 null의 맵 | 아니요 | 이 컴포넌트에 개발자가 작성한 어노테이션입니다. 값은 문자열, 구조화된 객체(하위 키에서 값으로의 맵으로, 상속된 구조화된 값과 하위 키별로 병합됨) 또는 null이며, 상위 서브시스템에서 상속된 키에 명시적으로 null을 지정하면 상속된 바인딩이 이 컴포넌트에서 제거됩니다(어노테이션 기반 Feature 옵트아웃). Component 수준 어노테이션은 상속된 서브시스템 수준 어노테이션을 키별로 재정의하며, 같은 서브시스템의 형제 컴포넌트는 각자의 어노테이션 맵을 독립적으로 유지합니다. |
values | object | 아니요 | Component에 전달되는 불투명한 인지적 속성으로, 해당 스키마로 검증됩니다. |
uses | component_uses_block | 아니요 | 컴포넌트가 의존하는 컴포넌트로 연결하는 연결들로, 소켓별로 키가 지정됩니다. 각 소켓은 대상을 나열하거나 각 연결에 별칭을 붙여 이름을 지정합니다. 별칭으로 이름이 지정된 연결은 개발자의 연결별 값과 소켓이 선언한 슬롯을 채우는 첨부를 가질 수 있습니다. |
inject | inject_block | 아니요 | 컴포넌트 수준 self-inject입니다. 컴포넌트 자신의 값(‘value:‘를 통해) 또는 자신의 provides 키(‘from:‘을 통해)를 전달 파이프(.context.inject)에 직접 주입합니다. Component 카탈로그 엔터티가 해당 메커니즘과 함께 ‘spec.inject’를 선언한 경우에만 허용됩니다. uses[].inject에 선언된 키와 충돌하는 inject 키는 inject 소스 간에 중복된 전달 키로서 빌드를 중단시킵니다. |
features | object 맵 | 아니요 | 이 컴포넌트에 첨부된 Features로, 작성자가 각 첨부에 부여한 인스턴스 이름을 키로 사용합니다. 이것이 유일한 첨부 지점입니다. 운영 Feature, 자격 증명 Feature(feature.aggrega.ai/kind: secret 레이블이 지정된 것), 아이덴티티 Feature 모두 같은 키워드와 같은 형태로 여기에 첨부됩니다. 이들 사이의 차이는 첨부가 무엇을 생성하는지이지, 어떻게 선언되는지가 아닙니다. 인스턴스 이름이 Component가 featuresSchema에 선언한 슬롯과 일치하는 첨부는 그 슬롯을 채우며, 그 밖의 인스턴스 이름은 자유 첨부입니다. 키: 하나 이상의 문자, 숫자, 밑줄 또는 하이픈입니다. 점은 허용되지 않습니다. 패턴: ^[a-zA-Z0-9_-]+$. |
추가 속성은 허용되지 않습니다.