거버넌스와 컴플라이언스
이 장에서는 플랫폼 팀이 정책을 컴파일러에 하드코딩하지 않고, 거버넌스 소켓, 카탈로그의 베이스라인과 스키마, 그리고 카탈로그 작성자가 따르는 관례를 통해 모든 빌드에 걸쳐 기업 컴플라이언스를 적용하는 방법을 정의합니다. Day-2 수명 주기 이벤트는 Day-2 수명 주기에서 다룹니다.
엔터프라이즈 거버넌스 및 컴플라이언스 패턴
플랫폼 엔지니어링의 핵심 과제는 오픈 소스 카탈로그를 오염시키지 않으면서 기업 거버넌스(SOC 2 컴플라이언스, FinOps 비용 센터 추적, 엄격한 소유권 매핑 등)를 시행하는 것입니다.
Aggrega가 공식 컴포넌트에 도메인 특화 로직을 하드코딩한다면 주관이 없는 컴파일러가 아니게 되고 주관이 강한 프레임워크로 전락할 것입니다. 반대로 컴플라이언스를 전적으로 개발자에게 맡기면 중요한 태그가 오타로 잘못 쓰이거나, 누락되거나, 우회됩니다.
이를 해결하기 위해 Aggrega는 컴플라이언스를 위한 Wasm 소켓 메커니즘을 제공하고, 정책은 기업이 정합니다. 기업은 자체 생태계 안에서 두 가지 별개의 사회 계약을 채택하여 제로 트러스트 거버넌스를 달성합니다.
1. “Bring Your Own Baseline”(BYOB) + Wasm 검증 게이트
개발자가 제공하는 정적 데이터(팀 소유권이나 데이터 분류 등)의 경우, 기업은 원본 오픈 소스 카탈로그에 직접 의존해서는 안 됩니다. 대신 플랫폼 아키텍트가 기업 베이스라인, 즉 모든 내부 컴포넌트가 지녀야 하는 필드를 SchemaLibrary 항목 하나에 한 번 선언한 것을 작성하고, 거버넌스 판정(verdict) 역할을 사용하여 그 사용을 강제합니다.
카탈로그 계약: 기업은 특정 태그를 요구하지만 인프라는 프로비저닝하지 않는 베이스라인을 만듭니다.
apiVersion: aggrega.ai/v1beta1kind: SchemaLibrarymetadata: name: CorporateBaseline version: 1.0.0spec: schemas: Ownership: type: object properties: owner: { type: string } cost_center: { type: string } # The developer MUST provide these, or the schema validator halts the build required: [owner, cost_center]모든 내부 컴포넌트(예: acme/datastore/postgres)는 자체 schema:에서 그 항목을 참조하고 자신만의 값을 추가하므로, 공유 필드와 컴포넌트 자체의 필드가 함께 검증됩니다:
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: acme/datastore/postgres version: 1.0.0 labels: component.aggrega.ai/type: stateful-serverspec: schema: values: $ref: "CorporateBaseline#/schemas/Ownership" properties: database: { type: string } required: [database]베이스라인이 기본 Component가 아니라 라이브러리 항목인 이유는 extends:를 작성하는 Component는 기본의 schema:를 통째로 받고 자체 값을 선언하지 않기 때문입니다(상속 및 게시 규율 참조).
Wasm 검증 안전장치:
개발자가 내부 카탈로그를 우회하여 공개 허브에서 베이스라인 없는 core/postgres 컴포넌트를 직접 가져오는 것을 막기 위해, 기업은 토폴로지 검증 플러그인을 등록합니다. 이 플러그인은 정적 분석 중에, 즉 그래프가 조립된 후 아티팩트가 렌더링되기 전에 평가되므로 컴포넌트를 하나씩 보는 대신 전체 토폴로지를 봅니다.
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some id, _ in input.graph.spec.nodes not input.graph.spec.values_mapping[id].owner msg := sprintf("node %v declares no owner; use a component whose schema references 'CorporateBaseline#/schemas/Ownership'.", [id])}정책이 deny 키 아래에 모은 결정은 거부이며, 빌드는 이에 따라 중단됩니다.
자유 형식 연결 금지:
개발자는 카탈로그가 선언하지 않은 소켓, 즉 임시(ad-hoc) 소켓을 통해 엣지를 연결할 수 있습니다(dependency-resolution 참조). 이 개방성은 의도된 것이며, 컴파일러가 이에 대해 아무런 의견을 갖지 않는 것도 의도된 것입니다. 모든 연결이 아키텍트가 선언한 소켓을 거치기를 원하는 조직은 컴파일러에 의존하는 대신 이를 정책으로 표현합니다. 그래프의 모든 엣지는 declared 또는 ad-hoc 값을 갖는 socket_declaration을 지니므로, 규칙은 한 줄입니다.
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some e in input.graph.spec.edges e.socket_declaration == "ad-hoc" msg := sprintf("%v connects to %v through the free-form socket %v; declare the socket in the component type's usesSchema.", [e.source, e.target, e.socket])}이 값은 엣지가 어떤 방식으로 작성되었든 모든 엣지에 항상 존재하므로, 정책은 없는 필드를 “declared”로 해석할 필요가 없습니다. 또한 이것은 독자적인 축입니다. 누가 엣지를 그렸는지가 아니라 소켓이 어디서 왔는지를 나타내므로 origin_feature 및 origin_release와 겹치지 않고 조합됩니다. 정책은 자유 형식 연결을 금지하면서도 Release가 선언된 연결을 구성하는 것은 허용할 수 있습니다.
중앙 집중식 엔터프라이즈 거버넌스(완전한 실체 평가): 대역 외 메커니즘(git 저장소의 CODEOWNERS 등)은 변경되는 파일을 검토할 뿐, 그 파일이 컴파일되어 만들어지는 아키텍처를 검토하지는 않습니다. 거버넌스 판정 역할은 아키텍처 자체를 판단합니다. AOT 컴파일러는 개발자의 Aggregate와 플랫폼 운영자의 Release를 모두 평탄화하여 IR 그래프를 구축하므로, ir-verdict 역할의 정책은 물리적 아티팩트가 생성되기 전에 완전한 실체를 평가하고, render-verdict 역할의 정책은 아티팩트 자체를 평가합니다. 개발자가 승인되지 않은 Component를 요청하거나, 렌더링된 각 객체에 찍힌 aggrega.ai/recipe-uri 출처를 읽어 Manifest가 컴포넌트를 승인되지 않은 Recipe에 매핑한 것이 드러나면, 정책은 빌드를 치명적으로 중단시킬 수 있습니다.
2. Wasm 변형 게이트(동적 컴플라이언스)
환경별 컴플라이언스 태그(예: environment: production 또는 soc2_in_scope: true)는 GitOps 대상에 따라 달라지므로, 개발자가 이를 Aggregate에 직접 입력하도록 강요해서는 안 됩니다.
동적 메타데이터의 경우, 기업은 토폴로지 구성 중에 실행되는 변형 게이트, 즉 거버넌스 소켓의 label-transform 역할을 활용합니다. 그래프가 확장된 후, 정적 분석이 이를 평가하기 전에 컴파일러는 기업이 연결한 Wasm 플러그인을 실행합니다. 이 플러그인은 Release의 환경, 노드가 이미 선언한 레이블, 각 노드의 인스턴스가 선언한 값을 읽고, 빌드의 노드가 가져야 할 레이블을 지정합니다. 따라서 필요한 메타데이터가 개발자의 입력 없이 컴포넌트에 도달합니다(예: Release의 환경으로부터 결정된 레이블 compliance.aggrega.ai/data-class: restricted, 또는 데이터베이스가 선언한 확장으로부터 결정된 datastore.aggrega.ai/engine: vector). 값은 읽기 전용입니다. 플러그인은 레이블만 결정할 뿐 다른 것은 결정하지 않습니다.
이 역할의 정책은 빌드가 적용하는 편집 명령을 작성하는 대신 레이블을 지정합니다. 즉 노드, 키, 그리고 그 값을 지정합니다. 이유는 정책을 작성하는 사람에게 중요합니다. 편집 명령은 경로로 레이블을 지정하는데, Aggrega 레이블 키에는 경로 구분자인 /가 흔히 포함되므로 직접 작성한 경로는 하나의 레이블이 아니라 중첩된 위치를 가리키게 됩니다. 빌드는 결정이 지정한 레이블을 대상으로 하며, 이 역할이 받는 노드의 투영은 전체 그래프에 대한 판정보다 노드를 한 단계 얕은 위치에 둡니다.
# Evaluated by the governance label-transform role, during topology constructionpackage acme.tagging
import rego.v1
labels contains {"node": id, "key": "acme.com/soc2-scope", "value": "true"} if { input.compilation_context.environment == "production" some id, node in input.graph.nodes node.labels["component.aggrega.ai/type"] == "stateful-server"}이러한 태그는 렌더링이 시작되기 전에 메모리 내에서 표준 메타데이터 딕셔너리에 주입되므로, Wasm 렌더링 플러그인은 이를 읽어 아티팩트가 렌더링될 때 특정 물리적 구성(예: 강화된 AWS 또는 Kubernetes 리소스)을 조건부로 생성할 수 있습니다.
규칙은 한 번만 명시합니다: 거버넌스 연결은 워크스페이스 범위입니다.
위의 두 패턴은 컴포넌트별, Feature별로 작성되지만, 이를 시행하는 거버넌스 연결은 그렇지 않습니다. 거버넌스 플러그인은 워크스페이스 구성의 plugins.governance 키에 연결되며, 그 연결은 워크스페이스의 모든 빌드에 적용됩니다. 따라서 기업 규칙은 정확히 한 곳에서 명시됩니다. 플랫폼 팀이 플러그인을 한 번 연결하면, 어떤 컴포넌트, Aggregate, Release도 이를 적용받기 위해 옵트인하거나, 언급하거나, 수정될 필요가 없습니다. 이것이 패턴 1의 검증 안전장치를 프로젝트별 관례가 아닌 완전한 해답으로 만듭니다. 내부 카탈로그를 우회하여 베이스라인 없는 core/postgres를 요청하는 개발자도 다른 모든 사람과 동일하게 연결된 정책으로 평가됩니다. 정책은 그들이 선택한 컴포넌트가 아니라 워크스페이스의 속성이기 때문입니다.
워크스페이스 규칙은 거부할 뿐, 개발자의 계약을 다시 쓰지 않습니다. 범위는 전역적이며, 효과는 의도적으로 판정에 한정됩니다. 모든 곳에 적용되는 규칙은 이를 위반하는 빌드를 수정할 내용을 지정하며 중단시키고, 대신 문제가 되는 컴포넌트를 규정에 맞게 고칠 수는 없습니다. 이 경계가 대규모 환경에서 메커니즘을 디버깅 가능하게 유지합니다. 빌드는 워크스페이스가 선언한 규칙에 부합하거나, 작성된 줄을 가리키는 메시지와 함께 중단되며, 렌더링된 출력에는 어떤 작성된 파일도 요청하지 않은 제약이나 리소스가 결코 포함되지 않습니다. 기업이 그래프를 판정하는 대신 변경하기를 원하는 경우에는 변환 역할(위의 패턴 2)을 연결하며, 그 변경은 운영자가 연결하여 수행하도록 한 범위로 제한됩니다. 그렇기 때문에 이는 보이지 않는 재작성이 아니라 플랫폼 팀의 명시적인 행위입니다.
컴플라이언스를 완성하려는 플랫폼 팀에게 주는 실질적인 결론은 다음과 같습니다. 페이로드가 가져야 할 형태는 기업 베이스라인의 스키마 제약으로 표현하고, 환경 전체가 요구하는 엔티티 간 규칙은 연결된 판정 역할로 표현하며, 개발자가 직접 입력해서는 안 되는 파생 메타데이터는 연결된 변환 역할로 표현합니다. 세 가지 모두 한 번 선언되어 모든 빌드에 적용되며, 어느 것도 개발자가 그 존재를 알 필요가 없습니다.
3. 도메인 지능 보존(구성과 안전성)
Aggrega 컴파일러는 주관이 없는 컴파일러이므로 AI 프레임워크, 토큰 예산, 메모리 분할에 대해 하드코딩된 지식을 전혀 갖고 있지 않습니다. 대신 범용 클라우드 네이티브 스키마가 빈 그릇 역할을 합니다. 고도로 특화된 도메인 지능은 컴파일러 코어에 하드코딩되는 대신 확장 가능한 Aggrega 생태계 전체에 분산됩니다. 이 지능은 특화된 components, features, recipes를 통해 Platform Catalog 안에 캡슐화됩니다. 개발자는 Architect의 schema: 선언(축약형 또는 전체 JSON Schema 2020-12)과 usesSchema 소켓에 엄격히 통제되는 values 및 uses 블록 안에 고유한 애플리케이션 의도를 보존하며, 그 지능의 물리적 변환은 대상별 WebAssembly 플러그인이 실행합니다.
A. 도메인 특화 구현 모델링(분할 스키마로 검증)
Platform Architect는 분할 스키마(Split Schema) 파이프라인을 활용하여 코어 컴파일러와 완전히 독립적으로 어떤 복잡한 아키텍처든 모델링할 수 있습니다.
- 불투명한 실행 로직(
values): 엔터프라이즈가 AI Gateway를 배포하는 경우, 개발자는 게이트웨이 자체의 동작을 구성합니다. 표준 라이브러리의 AI 게이트웨이에서는 호출자가 요청할 수 있는 각 별칭과 각 별칭이 해석되는 업스트림을 게시하는models맵이 이에 해당합니다. 코어 컴파일러는 이러한 개념을 파싱하지 않습니다. 이 개념들은 불투명한values페이로드 안에 안전하게 머물며, 컴포넌트의schema:선언으로 엄격하게 검증됩니다. 컴파일러는 이 페이로드를 Wasm 플러그인에 그대로 전달하여 게이트웨이 구성을 생성하게 할 뿐입니다. 폴백 체인, 재시도 횟수, 같은 별칭을 게시하는 항목 간 선택처럼 여러 게이트웨이 제품이 공유하는 제어는 게이트웨이의 값이 아니라 게이트웨이에 연결되는 Features이며, 각각은 해당 게이트웨이 고유의 방식으로 구현됩니다. - 토폴로지 의존성 매핑(
uses): AI 프레임워크가 에이전트를 도구나 벡터 데이터 저장소에 연결하는 경우, 그 연결은 누가 누구와 통신하는지를 결정하므로uses축에 선언합니다. 표준 라이브러리의tools_allowed처럼values에 보관된 이름 목록은 관례일 뿐 엣지를 그리지 않습니다. 컴파일러는 이러한 명시적 엣지를 IR 그래프에 그대로 그립니다. 이를 통해 다운스트림 Wasm 렌더링 플러그인은 컴파일러가 기반 AI 프레임워크를 이해하지 않아도 연결을 보호하는 데 필요한 네트워크 정책과 물리적 경계를 프로그래밍 방식으로 생성할 수 있습니다. - 복잡한 데이터 구조(예: CoALA): Architect는 하나의 평면 대상 목록에 국한되지 않고, 구조에 필요한 만큼 많은 소켓을
usesSchema에 선언할 수 있으며, 각 소켓은 자체 셀렉터와 자체 엣지별valueSchema를 가집니다. 예를 들어 CoALA 프레임워크를 구현하기 위해 Architect는semantic_memory,episodic_memory,working_memory를 별개의 소켓으로 선언하여 각 메모리 저장소를 별개의 토폴로지 대상으로 만들 수 있습니다. 범용 정책 엔진은 이러한 구조화된 엣지를 평가하여 각각의 인지 영역에 대해 세분화된 접근 제어 가드레일을 의무화합니다.
B. 핵심 보안 및 간접 참조 메커니즘
페이로드는 주관이 없지만, 범용 스키마는 안전한 아티팩트 생성을 뒷받침하는 엄격한 구조적 메커니즘을 강제합니다:
- 값이 아닌 연결 패턴(Attachment-Not-A-Value Pattern): 표준 라이브러리의 관례는 자격 증명을 *연결(attachment)*로 요청하며, 컴파일러가 그대로 전달하는 인라인 리터럴이 되는
values블록에는 절대 쓰지 않는다는 것입니다. 자격 증명 연결은 자격 증명 Featuretype(feature.aggrega.ai/kind: secret레이블이 붙은 것)을 지정하고, 자체values를 사용하여 시크릿 저장소에 대한 쿼리를 기술합니다. 그러면 자격 증명 라우팅은 기능에 구애받지 않는 지연 바인딩이 되며, 코어 컴파일러는 자격 증명 자료를 해석하거나 노출하지 않고 Ops Recipe가 제공한 포인터를 전달할 뿐입니다. 이는 카탈로그와 스키마가 권장하는 관례이지 컴파일러 검사가 아닙니다. 컴파일러는values리프의 의미를 해석하지 않으므로, 작성자가 자료를 인라인으로 넣으면 그대로 인라인으로 들어갑니다. 스키마가 실제로 보장하는 것은 연결 표면이 존재하고 타입이 지정되어 있다는 점입니다. - 추상적 신뢰 검증:
values블록은 폭넓게 확장 가능하므로, Architect는tls_pinning이나required_signatures: 2(Quorum 합의용) 같은 추상적 지시문을 의무화할 수 있습니다. 코어 컴파일러는 이러한 스키마 검증된 객체를 평면 IR 그래프에 그대로 전달합니다. 그러면 사용자 정의 Wasm 렌더링 플러그인이 이 값을 읽어 하드웨어 수준의 Human-in-the-Loop(HITL) 승인 게이트용 아티팩트를 생성할 수 있습니다. 애플리케이션이 합의 규칙을 우회하려고 하면, 물리적으로 배포된 프록시가 웹훅 승인을 받을 때까지 실행을 차단합니다.
C. 고급 운영 안전성(spec.interoperability)
충돌하는 인프라 변경으로부터 취약한 워크로드를 보호하기 위해, 범용 Feature 스키마는 상호 운용성 제어를 정의합니다.
spec.interoperability.conflictsWith— 이 Feature와 같은 컴포넌트에 도달할 수 없는 Features의 목록입니다. 한 컴포넌트가 최종적으로 갖게 되는 연결(컴포넌트 자체, 이를 포함하는 서브시스템 또는 경계, 해당 Release 컴포넌트 항목, 어노테이션 기반 확장 등 그 컴포넌트에 도달하는 모든 범위에서 수집된 것)에 이 Feature와 이 Feature가 지정한 Feature가 함께 있으면, 컴파일러는 렌더링 전에 빌드를 중단합니다. 이는 Feature 작성자가 선언한 이름과 컴포넌트가 지닌 Features를 비교하는 것일 뿐, 어느 쪽에도 의미를 부여하지 않습니다. 비호환성은 작성자의 판단이며, 컴파일러는 빌드가 그 판단을 따르도록 할 뿐입니다. 선언은 한 번이면 충분하고, 이름은 버전과 관계없이 일치 여부를 판단하며, 컴포넌트를 공유하지 않는 형제 경계에 각각 연결된 두 Features는 결코 만나지 않습니다.
4. 네트워크 경계 거버넌스(기본 거부 관례)
개발자는 네트워크 정책을 직접 작성하지 않습니다. 필요한 네트워크 경계는 컴파일러의 중간 표현(IR) 그래프가 매핑하며, 이 그래프는 Aggregate에 선언된 구성 요소 사이의 모든 토폴로지 엣지를 담고 있습니다.
- 내부 경계. 컴파일러는 평탄한 IR 그래프를 그릴 뿐 스스로는 아무것도 제한하지 않습니다. 정책이 없으면 클러스터 네트워크가 허용하는 모든 연결이 계속 도달 가능합니다. 관례는 구성 요소에 대해 작성된 정책이 정책 자체의 첨부가 지정하는 대상 외에는 Aggregate가 엣지를 선언한 연결만 허용하고, 정책이 관할하는 방향의 다른 모든 연결은 거부하는 것입니다.
- 표준 라이브러리의 구현. 표준 라이브러리 카탈로그는 이 관례를 운영자가 Release에서 구성 요소에 첨부하는 두 개의 Features로 구현하며, 연결의 각 방향마다 하나씩입니다.
core/caller-allowlist는 자신을 가리키는uses엣지를 가진 구성 요소로부터의 연결만 허용하고,core/egress-allowlist는 구성 요소가 자신의 엣지가 가리키는 구성 요소와 클러스터의 DNS에만 연결하도록 합니다. helm 타깃에서는 각각이 FeatureRecipe로 구현되며, 이 FeatureRecipe는 컴파일러가 넘겨주는 엣지로부터 Kubernetes NetworkPolicy를 작성하고, 각 구성 요소의 파드를 해당 구성 요소 자체의 렌더링이 출력한 내용, 즉 워크로드가 갖는 셀렉터와 레이블, 출력되는 네임스페이스, 컨테이너가 선언하는 포트로부터 지정하므로 레이블이나 포트를 손으로 다시 적지 않습니다. 또한 각각은 구성 요소 자체의 파드와 Release가 첨부에 지정한 대상도 허용합니다. 인바운드 쪽에서는 Aggregate 외부의 소스를, 아웃바운드 쪽에서는 클러스터가 실행하지 않는 대상의 주소 범위를 허용하는데, 이러한 대상은 선택할 파드를 렌더링하지 않으므로 범위로만, 모든 포트에 대해 허용됩니다. 컴파일러는 클러스터를 검사할 수 없으므로, 각각은 클러스터의 네트워크 플러그인이 네트워크 정책을 적용한다고 Release가 확인할 때까지 빌드를 중단합니다. compose에는 네트워크 정책이 없으므로, 그곳에서 둘 중 하나를 첨부하는 빌드는 중단됩니다. - 공개 인그레스(구애받지 않는 경계 제어). 공개 인그레스는 거버넌스 판정 역할에서 기업의 사용자 정의 규칙으로 관리됩니다. 기업 보안 팀은 노드의 클라우드 네이티브 온톨로지 유형을 평가하여, 개발자가
worker또는task노드에public-ingress기능을 첨부하려 하면 빌드를 거부하는 정책을 작성할 수 있습니다. 컴파일러는 “public”이 무엇을 의미하는지 해석하지 않으며, Wasm 검증 게이트의 Boolean 출력을 집행합니다.
5. 컴파일 시점 출처 스탬핑
컴파일러는 컴파일 중에 컴파일러 버전과 컴파일한 Aggregate, Manifest, Release의 버전을 담은 출처 기록을 생성합니다. 타임스탬프는 담지 않으므로 이 기록이 바이트 단위로 동일한 출력을 깨뜨리는 일은 없습니다. helm 렌더러는 컴파일러 버전을 생성된 Kubernetes 매니페스트에 aggrega.ai/compiler-version 레이블로 내보내고, helm-chart 렌더러는 chart 자체의 템플릿을 변경 없이 복사하므로 Recipe가 chart에 추가하는 템플릿 파일에 내보냅니다. 기업 보안 팀은 이를 사용해 어떤 렌더링된 아티팩트가 어떤 컴파일러 버전으로 빌드되었는지 식별하며, 이는 특정 컴파일러 릴리스에서 취약점이 발견되어 영향받는 아티팩트를 감사해야 할 때 중요합니다.
compose provider는 같은 출처 키를 서비스 레이블로, terraform provider는 자신이 조립하는 각 모듈의 출처 파일로, cloudformation provider는 각 리소스의 Metadata 아래에 찍습니다. 메모리 내 출처 기록은 모든 컴파일에 존재합니다.
6. 확장 표면으로서의 메타데이터와 어노테이션
Go 컴파일러는 AI 프레임워크, 데이터베이스 엔진, Kubernetes 관용 방식 같은 도메인 특화 개념에 구애받지 않으며, IR에 대한 평탄한 그래프 수준 연산만 수행합니다. 도메인 특화 로직을 Go 바이너리에 하드코딩하지 않고 생태계를 구동하기 위해, 플랫폼은 표준 메타데이터 레이블과 어노테이션을 도메인 지식의 확장 표면으로 사용합니다.
컴파일러는 도메인 특화 어노테이션을 읽지 않습니다. 개발자가 제공한 모든 어노테이션과 덕 타이핑 레이블을 평탄한 IR 그래프에 묶어, 이 메타데이터를 거버넌스 및 렌더링 플러그인에 그대로 전달합니다. WebAssembly 생태계는 핵심 컴파일러와 독립적으로 메타데이터를 해석하고 필요한 로직을 실행합니다. 컴플라이언스 정책 평가, 클라우드 네이티브 아티팩트에 태그 주입, 기능 확장 트리거 등이 그것입니다.
이렇게 하면 확장 표면은 넓게 유지되면서(누구나 새 어노테이션 접두사를 읽는 Wasm 플러그인을 작성할 수 있음) 핵심 컴파일러는 안정적으로 유지됩니다. 생태계가 새 도메인 특화 어노테이션을 추가하는 데 핵심 릴리스가 필요하지 않습니다.
정책이 첨부에 대해 읽는 내용
IR 그래프를 평가하는 판정 역할은 그래프 전체를 받습니다. 다만 아래에서 설명하듯 작성자가 민감하다고 선언한 모든 값은 보류됩니다. 여기에는 각 노드가 지닌 모든 첨부가 포함되며, 작성자가 붙인 이름을 키로 합니다. 노드의 연결 중 하나에 작성된 첨부라면 연결의 별칭과 슬롯을 점으로 이은 것을 키로 합니다. 요약 대신 첨부의 세부 정보를 전달하는 이유는 Aggrega에는 요약할 견해가 없기 때문입니다. 컴파일러는 첨부가 담은 내용을 판단하지 않고 첨부를 라우팅하므로, 정책이 첨부를 판단하는 데 필요한 사실이 곧 정책에 주어지는 사실입니다.
첨부마다 그래프는 다음을 전달합니다.
- 첨부가 요청하는 Feature 유형과 그에 대해 확인된 카탈로그 버전. 유형은 작성자가 쓴 문자열 그대로입니다. 버전이 고정된 참조와 버전 없는 참조는 하나의 대상에 대한 서로 다른 문자열이므로, 유형을 비교하는 정책은 두 표기를 모두 예상해야 합니다.
- 첨부된 Feature의 카탈로그 레이블, 원문 그대로. 필터링이나 정규화 없이, 카탈로그 엔터티가 선언한 순서대로 전달됩니다. 정책은 카탈로그 작성자가 쓴 내용을 정확히 읽으며, 여기에는 Aggrega가 알지 못하는 작성자 고유의 레이블도 포함됩니다.
- 첨부된 Feature의 카탈로그 어노테이션, 원문 그대로. Feature 엔터티 자체의
metadata.annotations가 레이블과 정확히 같은 조건으로, 즉 필터링이나 정규화 없이 엔터티가 선언한 순서대로 전달되므로, 작성자 고유 네임스페이스의 어노테이션 키도 작성된 그대로 도착합니다. 이는 어노테이션으로 확장된 첨부를 애초에 생겨나게 한 어노테이션과는 다른 주제입니다. 그래프는 그 출처를 별도로 보고하며,features:블록에 작성된 첨부는 엔터티의 어노테이션을 전달하면서도 확장 출처는 전혀 보고하지 않습니다. - 첨부가 채우는 선언된 첨부 슬롯.
featuresSchema슬롯은 슬롯 이름으로 Feature를 첨부하여 채우므로, Component가 선언한 슬롯을 이름으로 지정하는 첨부는 그 슬롯의 이름을 보고하고, 어떤 슬롯도 채우지 않는 첨부는free를 보고합니다. 연결에 작성된 첨부는 연결의 소켓이 선언한 슬롯을 채우고 그 슬롯의 이름을 보고합니다. 소켓은 다른 이름을 허용하지 않으므로free를 보고하는 일은 없습니다. 값이 플래그가 아니라 슬롯 이름인 이유는, 어느 바인딩 지점이 채워졌는지가 대개 답의 더 유용한 절반이기 때문입니다. - 첨부가 작성된 연결(있는 경우). 컴포넌트의 연결 중 하나에 작성된 첨부는 그 연결의 소켓과 별칭을 지니며, 이는 첨부가 제시되는 그래프 엣지를, 그리고 그 엣지를 통해 첨부가 제시되는 컴포넌트를 가리킵니다. 컴포넌트 자체 블록의 첨부는 아무것도 지니지 않습니다. 연결은 첨부 이름에서 읽어 내도록 남겨 두지 않고 데이터로 전달됩니다. 첨부 이름에는 별칭만 있고 소켓은 없기 때문입니다.
- 작성자가 민감하다고 선언한 자료를 다루는지 여부와 그 자료를 전달하는 전달 키. 둘 다 선언에서 도출됩니다. 즉 Feature 스키마의
sensitive리프, 소비하는 Component의sensitive슬롯(자체 첨부용으로 선언한 것이든 연결이 연결된 소켓의 것이든)에서 도출되며, 값을 검사해서 도출되는 일은 없습니다. - 첨부의
values,infra, 전달 매핑, 그리고 첨부가features:블록에 작성되었는지 어노테이션 기반 확장으로 추가되었는지 여부. 다음 단락에서 설명하듯 작성자가 민감하다고 선언한 모든 값은 보류됩니다.
정책은 민감하다고 선언된 자료의 위치를 알 수 있지만, 자료 자체를 받지는 않습니다. 그래프가 민감하다고 선언된 것으로 표시한 각 리프는, 어떤 첨부의 values나 infra에 있든(어느 범위나 연결에 작성되었든), 경계 첨부의 infra에 있든, 노드 자체의 values와 infra에 있든, 연결 자체의 values와 infra에 있든, 값 대신 단일 키 마커 {"aggrega_withheld": "declared"}로 정책에 도달합니다. 키는 유지되므로 정책은 페이로드가 어떤 리프를 지니는지 여전히 볼 수 있고, 그 리프를 지정하는 표시도 유지되므로 정책은 그중 어느 것이 선언된 자료를 지니는지 여전히 볼 수 있습니다. 위에 나열한 모든 사실과 선언으로 표시되지 않은 모든 값은 이전과 같이 도착합니다. 정책이 추론에 사용하는 사실, 즉 첨부가 무엇인지, 무엇을 채우는지, 누구에게 제시되는지, 카탈로그 엔터티가 그에 대해 무엇이라 하는지, 그 비밀 자료가 어디로 이동하는지는 어느 것도 작성자가 민감하다고 선언할 수 있는 값이 아니며, 자료 자체는 정책이 그 자료의 행방을 판단하는 데 필요하지 않은 유일한 것입니다. 이는 명령줄이 그래프를 출력할 때, 데몬이 편집기의 그래프 요청에 응답할 때 적용하는 것과 같은 보류입니다. 그러한 표면은 명시적으로 요청하는 사람에게 값을 돌려주지만, 정책의 사본에는 그런 요청 수단이 없습니다. 이 보류는 정책의 사본에만 적용됩니다. 빌드가 렌더링하는 그래프는 그대로이므로 렌더링된 바이트는 하나도 바뀌지 않습니다.
첨부의 레이블이 컴파일러를 구속하는 곳은 정확히 한 곳이며, 그것은 정책 결정이 아닙니다. 슬롯은 selector를 선언할 수 있고, 레이블이 이를 충족하지 않는 채움은 빌드를 중단시킵니다. 그 관문을 지나면 레이블은 아무것도 좌우하지 않습니다. 값이 라우팅되고 전달되는 방식은 Feature가 어떤 레이블을 지니든 같습니다. 따라서 레이블을 읽는 정책은 컴파일러 내부의 분기를 추측하는 것이 아니라, 컴파일러가 해석 없이 전달한 메타데이터를 읽는 것입니다.
Feature의 카탈로그 어노테이션은 어디에서도 컴파일러를 구속하지 않습니다. 어떤 컴파일러 동작도 이에 따라 분기하지 않으며, 슬롯은 레이블에 대해 할 수 있는 것처럼 어노테이션에 대한 제약을 선언하지 않습니다. 어노테이션은 전달될 뿐 그 이상은 아닙니다.
이로써 작성할 수 있게 되는 규칙은 다음과 같으며, 컴파일러가 대신 만들어 주는 것은 하나도 없습니다.
- 자유 형식 첨부 금지. 모든 첨부가 선언된 바인딩 지점을 채우도록 요구하는 환경은
free를 보고하는 첨부를 모두 거부합니다. 이는 첨부 표면이 열려 있다는 점의 짝입니다. 구성은 기본적으로 자유로우며, 자유롭기를 원하지 않는 운영자는 그렇게 명시합니다. - 민감한 자료의 값 전달 거부. Aggrega는 민감하다고 선언된 데이터가 리터럴로 전달 키를 통해 이동하면 경고하지만 중단하지는 않습니다. 값 기반 자격 증명 계열은 의도된 것입니다. 그 경고를 거부로 바꾸고자 하는 운영자는 여기에서 이를 표현합니다.
- 무엇을 자격 증명으로 볼지 직접 결정. 표준 라이브러리는 자격 증명 Features에 계열 레이블을 붙이며, 그 레이블을 읽는 것은 이를 판단하는 한 가지 방법입니다. 내부 레이블, 명명 규칙, 승인된 유형 집합처럼 더 넓거나 좁은 조건도 똑같이 사용할 수 있습니다. 레이블에 대한 판정이 아니라 레이블 자체가 도착하기 때문입니다.
- 카탈로그가 자체 메타데이터에 기록하는 무엇이든 기준으로 제한. 검토 상태, 데이터 상주 위치, 소유권을 Feature 엔터티의 어노테이션으로 관리하는 환경은 모든 첨부에 이를 요구할 수 있습니다. Aggrega가 전혀 모르는 어노테이션을 키로 하는 규칙도 Aggrega가 제공하는 키를 기준으로 한 규칙과 똑같이 동작합니다. 어노테이션이 작성된 그대로 도착하기 때문입니다. 이는 또한 Feature와 Component가 각자의 엔터티가 선언한 카탈로그 메타데이터에 따라 같은 기준으로 판단된다는 뜻입니다.
- 컴포넌트가 누구에게 무엇을 제시하는지 관리. 연결에 작성된 자격 증명은 그 연결을 가리키고, 연결의 엣지는 대상을 가리키므로, 환경은 자체 레이블로 표시한 신뢰 영역 밖의 컴포넌트에 제시되는 자격 증명을 거부할 수 있습니다. 이는 연결의 양쪽 끝이 모두 필요한 판단이며, 소비하는 컴포넌트에 관한 사실만으로는 제공되지 않습니다.
판정 역할은 수락하거나 거부할 뿐, 다시 쓰지는 않습니다. 빌드는 변경 없이 진행되거나 판정의 메시지와 함께 중단되므로, 정책이 규정을 준수하지 않는 그래프를 몰래 준수 상태로 만들 수는 없습니다.
첨부 세부 정보는 IR 그래프를 평가하는 정책에 도달합니다. 렌더링된 아티팩트를 평가하는 정책은 그 아티팩트만 받고 그래프는 받지 않습니다. 이는 그 입력에 가해진 제한이 아니라 입력 자체의 속성입니다. 두 단계는 서로 다른 질문에 답하며, 첨부 토폴로지는 렌더링된 출력에 물을 수 있는 질문에 속하지 않습니다.
정책 언어로 조직 전체의 규칙 표현하기
위의 패턴은 거버넌스 연결이 무엇을 하는지 설명합니다. 이 절은 그것을 얻기 위해 기업이 무엇을 작성하는지를 다룹니다. 명시할 규칙이 쉰 개인 플랫폼 팀은 플러그인 쉰 개를 원하지 않습니다. 이 팀이 원하는 것은 규칙을 콘텐츠로 두는 것, 즉 다른 아티팩트처럼 검토하고 버전을 관리하고 배포하는 파일로 두고, 연결된 하나의 엔진이 그것을 평가하는 것입니다.
소켓에 연결된 정책 언어 엔진이 바로 이것을 제공하며, 정확히 이 목적을 위해 두 엔진이 컴파일러 안에 포함되어 배포됩니다. Rego 엔진과 CEL 엔진입니다. 운영자가 엔진 하나를 연결하고 로드할 정책 파일을 선언하면 규칙이 실행됩니다. 외부 도구 체인도, 빌드 시점에 가져오는 것도, 컴파일러 안의 정책 로직도 없습니다. 평가는 모든 도메인 지능이 존재하는 WebAssembly 게스트 안에서 이루어집니다.
같은 엔진이 모든 거버넌스 역할을 담당하므로, 조직은 연결된 플러그인 하나와 그 플러그인의 여러 연결로 전체 영역을 다룹니다.
- 아키텍처 판정. 빌드 그래프 위에 연결된 정책은 컴파일러가 보유한 모든 노드, 에지, 연결과 함께 열거된 라우팅 경로를 읽고, 빌드를 중단해야 하는 사항을 보고합니다. 토폴로지 불변 조건, 경계 간 인가 규칙, 자격 증명 흐름 규칙이 여기에 위치합니다.
- 출력 판정. 렌더링된 아티팩트 위에 연결된 정책은 빌드가 생성한 파일을 텍스트로, 그리고 정책보다 먼저 형식이 파싱된 경우에는 파싱된 문서로 읽고, 구체적인 결과에 대해 보고합니다.
- 파생 메타데이터 제공. 레이블을 구성하도록 연결된 정책은 Release의 환경과 노드가 이미 선언한 내용을 바탕으로 빌드의 노드가 어떤 레이블을 가질지 결정합니다. 이것은 위의 패턴 2가 설명하는 메커니즘이며, 규칙을 전용 플러그인이 아닌 정책 콘텐츠로 표현한 것입니다.
- 개발자가 입력하지 않은 기능 추가. 어노테이션을 주입하도록 연결된 정책은 빌드의 컴포넌트에 어노테이션을 추가합니다. Manifest가 바인딩을 등록한 키 아래의 어노테이션은 Feature 연결로 확장되므로, 기업 규칙은 컴포넌트에 필요한 래핑이 없다고 거부하는 데 그치지 않고 그 래핑을 제공할 수 있습니다. 결정은 운영자가 그 어노테이션에 쓸 수 있는 어떤 값이든 쓸 수 있으며(문자열, 또는 여러 값을 라우팅하는 바인딩의 경우 하위 키 객체), 빌드는 이를 Release에 쓰인 같은 값을 읽는 것과 정확히 같은 방식으로 읽습니다. 결정은 추가만 할 수 있습니다. 어노테이션을 제거하거나 옵트아웃하는 값은 거부되며, 빌드가 라우팅할 수 없거나 바인딩된 Feature가 허용하지 않는 주입 값은 그 값을 주입한 플러그인을 지목하며 거부됩니다.
규칙은 페이로드가 담고 있는 내용을 읽고, 이름이 지정된 키 아래에 결정을 보고합니다.
# Evaluated by a governance verdict role over the assembled graphpackage acme.security
import rego.v1
deny contains msg if { some id, node in input.graph.spec.nodes node.labels["compliance.aggrega.ai/data-class"] == "restricted" not node.labels["acme.com/owner"] msg := sprintf("node %v holds restricted data and declares no owner.", [id])}그래프를 따라 데이터를 추적하는 규칙은 페이로드가 열거하는 경로를 읽습니다. language-reference/examples/policy-data-class-route/가 처음부터 끝까지 그러한 예입니다. 이 규칙은 한 등급의 데이터를 보유한 컴포넌트가 비등급화 Feature가 연결되지 않은 경로를 따라 다른 등급의 컴포넌트에 도달하는 빌드를 중단시키며, Release가 그 트래픽을 core/data-masking을 가진 게이트웨이를 통해 라우팅하면 같은 Aggregate가 완료됩니다. 컴파일러는 등급 레이블을 문자열로 전달할 뿐 어떤 순위도 매기지 않습니다. 등급, 그 순서, 비등급화로 간주되는 Features는 연결의 설정입니다. 규칙은 세 엔진, 즉 CLI에 컴파일된 두 엔진과 참조 어댑터 게스트 뒤의 OPA 각각에 대해 한 번씩, 각 사본이 독립적으로 작성되므로, 두 엔진의 판단이 다른 빌드에서는 그 불일치가 드러납니다.
정책 고유의 어휘는 보존됩니다. 소켓이 처리하는 심각도는 닫힌 집합이지만, 정책이 결정을 모으는 이름은 정책에 속합니다. 기본 이름은 Rego 코퍼스가 이미 사용하는 관례적인 이름이며, 정책이 결정에 다른 이름을 붙이는 운영자는 연결의 설정에서 매핑을 선언합니다. 따라서 이미 정책 라이브러리를 유지하는 조직은 그것을 다시 작성하지 않고 소켓을 도입할 수 있습니다. 매핑은 플러그인이 설정에 대해 선언하는 스키마로 타입이 지정되므로, 잘못된 매핑은 판정을 잘못 라우팅하는 대신 어떤 정책도 실행되기 전에 빌드를 중단시킵니다.
정책 라이브러리 전체가 하나의 연결로 전달됩니다. 정책 세트는 파일 단위로 연결하거나, 정책 파일과 데이터 문서를 함께 담은 단일 아카이브로 연결할 수 있으며, 아카이브는 게스트가 엽니다. 읽을 수 없는 아카이브는 해당 파일 이름과 함께 그대로 보고됩니다. 결정에 도달하지 못한 정책 세트로 보고되는 일은 결코 없습니다. “라이브러리를 읽을 수 없었다”는 것이 “라이브러리가 빌드를 허용했다”는 것과 구별되지 않아서는 절대 안 되기 때문입니다.
평가할 수 없는 정책은 빌드를 중단시킵니다. 정책을 평가할 수 없으면 연결이 실패하고 빌드는 플러그인 이름을 명시한 오류로 중단되며, 이는 빌드를 중단시키는 판정과 의도적으로 구별됩니다. 두 경우는 혼동되어서는 안 되며, 어느 쪽도 허용이 아닙니다.
각 역할이 노출하는 페이로드, 결정 키, 심각도로의 매핑,
아카이브 연결 방법 등 전체 작성 영역은
language-reference/plugins/policy-socket.md에 있습니다.
상속과 게시 규율
extends:를 통한 상속은 Platform Architect가 공유 기준선 위에 특화된 자식 엔터티를 구축할 수 있게 하는 카탈로그 메커니즘입니다. 두 카탈로그 종류는 데이터 기둥에서 서로 갈라집니다. Feature의 부모 스키마와 자식 스키마는 워크스페이스 로드 시점에 합성되어, 리프별 출처 정보를 갖춘 통합 스키마를 만듭니다. 확장하는 Component는 기둥 내용을 작성하지 않습니다. 리터럴 마커 schema: inherited를 작성하고, 체인의 모든 깊이에서 기반이 작성한 그대로의 schema: 블록을 받습니다.
이것이 공유 기준선이 제기하는 거버넌스 질문, 즉 자식이 기반에 비해 어떤 제약을 선언할 수 있는가에 대한 답입니다. Component의 경우 답은 감시가 아니라 구조에 있습니다. 자식이 선언한 계약은 그대로 기반의 계약 그 자체이므로, 기반의 제약은 자식이 완화하거나 제거하거나 타입을 바꿀 수 없으며, 기준선을 온전히 유지하기 위한 게시 시점 검사도 필요하지 않습니다. 기반이 선언한 것보다 더 엄격한 규칙이 정당하게 필요한 자식은 이를 assertions: 블록에 항목을 추가하여 표현하며, 이 항목은 기반의 규칙을 대체하지 않고 그와 나란히 합성됩니다.
자식 Component가 실제로 합성하는 것은 구조입니다. 부착 슬롯(featuresSchema), 토폴로지 소켓(usesSchema), 자체 주입 허용 목록(inject), 이름 있는 assertions는 모두 체인을 따라 병합되며, 다시 선언된 항목은 기반의 항목을 완전히 대체합니다.
규칙 배치: 어떤 규칙이 정책 플러그인에 속하고 어떤 규칙이 Component별 스키마에 속하는가
게시 규율 플러그인은 카탈로그 전반에 적용되는 횡단 규칙이 자리하는 곳입니다. 공급망 규칙(예: “모든 Recipe는 카탈로그에 존재하는 Component를 implements:해야 한다”)과 엔터프라이즈 컴플라이언스 규칙(예: “compliance.aggrega.ai/scope: pci-dss를 가진 모든 Component는 회사의 pci 기준선을 extends:해야 한다”)이 그 예입니다. 이러한 규칙은 여러 엔터티에 걸치거나, 워크스페이스를 하나의 단위로 평가하거나, 빌드 시점이 아닌 게시 시점에 관례를 강제합니다.
Component별 / Feature별 schema: 선언은 엔터티별 제약이 자리하는 곳입니다. 필드별 타입, 범위, 패턴, 열거형, 그리고 전용 assertions: 블록으로 표현되는 필드 간 규칙이 여기에 해당합니다. 이러한 제약은 하나의 엔터티에 국한되며 카탈로그 전체에서 그 엔터티와 함께 이동합니다.
이 구분은 임의적이지 않습니다. “모든 필수 필드는 존재해야 한다” 같은 규칙은 required: 배열에 속하는 엔터티별 제약입니다. “pci-dss 부모를 확장하는 모든 자식 엔터티는 워크스페이스 수준의 거버넌스 레이블을 선언해야 한다” 같은 규칙은 정책 플러그인이 강제하는 엔터티 간 규칙입니다. 두 규칙 부류는 서로 다른 질문에 답하므로 겹치지 않습니다. 스키마는 “이 인스턴스가 자신의 계약과 일치하는가”를 검증하고, 정책 플러그인은 “이 카탈로그가 워크스페이스가 요구하는 횡단 규칙을 충족하는가”를 검증합니다.
새 거버넌스 규칙을 작성할 때 배치에 관한 질문은 이것입니다. 규칙이 단일 엔터티의 내용에만 의존하는가(→ 스키마 또는 assertions 블록), 아니면 여러 엔터티 간의 관계나 워크스페이스 수준 구성에 의존하는가(→ 정책 플러그인). Wasm 린터 패턴은 횡단적인 경우를 위한 표준 메커니즘이며, 엔터프라이즈 카탈로그는 표준 게시 규율 플러그인과 동일한 플러그인 계약 인터페이스를 사용하는 사용자 정의 정책 플러그인을 배포할 수 있습니다.
어노테이션 접두사 규율
어노테이션 네임스페이스는 출처의 의미를 담고 있습니다. 서로 다른 접두사는 서로 다른 대상 독자와 서로 다른 거버넌스 권한을 나타냅니다. 카탈로그 작성자, 엔터프라이즈 플랫폼 팀, 그리고 Aggrega 플랫폼 자체가 모두 같은 평면 딕셔너리에 어노테이션을 작성하며, 대상 독자를 구분하는 것은 접두사입니다.
| 접두사 | 출처 | 대상 | 변경 가능성 |
|---|---|---|---|
aggrega.ai/ (단독) | 예약됨: Aggrega 컴파일러만 내보냄 | 내부 도구, 출처 정보 기록 | 사용자가 작성할 수 없음. 사용자 콘텐츠에 선언된 단독 접두사 어노테이션은 게시 시점에 거부됨 |
<sub-domain>.aggrega.ai/ (예: component.aggrega.ai/, feature.aggrega.ai/, compliance.aggrega.ai/) | 카탈로그 관례 | 카탈로그 엔터티를 작성하는 아키텍트, 레이블을 소비하는 Wasm 정책 플러그인 | 카탈로그 게시자가 작성하고 소비자가 읽음 |
<enterprise-domain>/ (예: acme.com/, my-org.io/) | 엔터프라이즈 오버레이 | 엔터프라이즈 플랫폼 팀, 엔터프라이즈 Wasm 플러그인 | 엔터프라이즈 작성자가 작성하며, 플랫폼 컴파일러는 이를 불투명한 메타데이터로 보고 무시함 |
<community-domain>/ (예: cncf.io/, kubernetes.io/) | 외부 생태계 | 널리 알려진 레이블을 읽는 생태계 간 도구 | 커뮤니티가 관리함 |
단독 aggrega.ai/ 접두사에는 가장 엄격한 규율이 적용됩니다. 이 접두사는 플랫폼이 내보내는 어노테이션 전용으로 예약되어 있습니다. 컴파일러는 렌더링된 출력에 aggrega.ai/compiler-version, aggrega.ai/component-id, aggrega.ai/recipe-uri, aggrega.ai/boundary-path 및 관련 출처 키를 내보내며, aggrega.ai/<key> 어노테이션을 직접 선언하는 사용자 콘텐츠는 게시 시점에 거부됩니다. 이 규율은 사용자가 작성한 어노테이션이 플랫폼이 내보내는 출처 정보와 충돌하는 것을 방지합니다.
<sub-domain>.aggrega.ai/ 아래의 하위 도메인 접두사는 카탈로그 관례를 위한 공간입니다. 표준 라이브러리는 component.aggrega.ai/type(클라우드 네이티브 온톨로지 레이블), feature.aggrega.ai/kind(운영용과 자격 증명용 Feature 구분), compliance.aggrega.ai/*(컴플라이언스 축 레이블) 및 이와 유사한 범위 지정 하위 네임스페이스를 사용합니다. 각 하위 도메인은 특정 카탈로그 대상이 관리합니다. component.aggrega.ai/*는 Component 엔터티 작성자가, feature.aggrega.ai/*는 Feature 엔터티 작성자가, compliance.aggrega.ai/*는 컴플라이언스 정책 대상이 관리합니다. 여러 하위 도메인에 걸친 읽기(여러 하위 네임스페이스에서 읽는 Wasm 플러그인)는 허용되지만 드물며, 각 플러그인은 일반적으로 하나의 하위 네임스페이스로 범위를 한정합니다.
엔터프라이즈 도메인 접두사(acme.com/..., my-org.io/...)는 플랫폼 확장 영역입니다. Aggrega 컴파일러는 이를 불투명한 메타데이터로 취급하며, 엔터프라이즈 Wasm 플러그인이 이를 소비합니다. 엔터프라이즈는 자사 거버넌스에 맞는 어떤 접두사 구조든 작성할 수 있습니다. 평면 구조(acme.com/owner: team-payments), 하위 도메인 구조(security.acme.com/scope: pii), 계층 구조(org.acme.com/billing-center: finance) 모두 가능합니다. 플랫폼은 엔터프라이즈 접두사 레이아웃을 제약하지 않으며, 유일한 규칙은 엔터프라이즈 접두사가 aggrega.ai/ 또는 그 하위 도메인과 충돌하지 않아야 한다는 것입니다.
이 규율이 중요한 이유는 어노테이션이 전파되기 때문입니다. Aggregate의 서브시스템에 작성된 어노테이션은 서브시스템 내 모든 컴포넌트로 전파되고, 컴포넌트 인스턴스 자체의 어노테이션은 해당 서브시스템의 어노테이션을 재정의하며, 모듈의 어노테이션은 그 모듈 자체의 컴포넌트에 도달합니다. Release 경계에 작성된 어노테이션은 경계 내 모든 컴포넌트로 전파됩니다. 프로바이더 어노테이션은 어느 쪽에서든 렌더링된 출력에 도달하며, 양쪽이 같은 키를 작성하면 Release의 값이 적용됩니다. 접두사 규율이 없으면 Aggregate 측 어노테이션이 플랫폼이 내보내는 출처 키를 조용히 덮어쓰거나, 엔터프라이즈 어노테이션이 카탈로그 관례 키와 충돌할 수 있습니다. 접두사 표는 대상 독자를 명시적으로 드러내고, 충돌 방지 규칙을 게시 시점에 적용할 수 있게 합니다.
엔터티별 어노테이션 영역 목록과 세 버킷 전파 의미(.context.annotations.release / .context.annotations.catalog / .context.annotations.aggregate)는 language-reference/vocabulary/labels-and-annotations.md를 참조하십시오.