Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Schema của Aggrega Capability-Agnostic Graph (IR)

Tài liệu tham khảo được sinh tự động. Không chỉnh sửa thủ công — hãy sinh lại từ JSON Schema đã xuất bản.

Id của schema: https://aggrega.ai/schemas/ir-v1beta1.schema.json

Đồ thị một chiều đã được làm phẳng và phân giải đầy đủ do Topology Builder tạo ra.

Kiểu cấp cao nhất: object

Thuộc tính

Thuộc tínhLoạiBắt buộcMô tả
apiVersionconst “aggrega.ai/v1beta1”cóHằng số: "aggrega.ai/v1beta1"
kindconst “IR”cóHằng số: "IR"
metadataIRMetadatacóĐịnh danh của đồ thị: Aggregate mà đồ thị được build từ đó.
specIRSpeccóBản thân đồ thị: các nút, các cạnh của nó và các payload được đánh khóa theo nút.

Không cho phép thuộc tính bổ sung.

Định nghĩa

Maintainer

Thuộc tínhLoạiBắt buộcMô tả
namestringcóTên của người bảo trì.
emailstringkhôngĐịa chỉ email của người bảo trì.
urlstringkhôngĐịa chỉ web của người bảo trì.

FieldProvenance

Nguồn gốc của một lá trong payload values hoặc infra của một attachment.

Thuộc tínhLoạiBắt buộcMô tả
originstringcóCho biết lá được tác giả viết tường minh hay được đóng góp bởi lượt mở rộng dựa trên annotation.
sidestringkhôngBề mặt soạn thảo nơi annotation được khai báo; vắng mặt đối với các lá tường minh.
annotation_keystringkhôngTên annotation đã đóng góp lá này; vắng mặt đối với các lá tường minh.
annotation_sourcestringkhôngVị trí nguồn của khai báo annotation dưới dạng :; vắng mặt đối với các lá tường minh.
overridden_annotationFieldProvenancekhôngĐóng góp annotation đã mất lá này vào tay một lá tường minh: khi một lá tường minh ghi đè một lá do annotation đóng góp, đây là provenance bị loại bỏ mà nó đã thay thế. Số ít — chỉ đúng một đóng góp bị loại bỏ được giữ lại.

Không cho phép thuộc tính bổ sung.

AttachmentConnection

Kết nối mà một attachment thuộc về, đối với attachment được viết trên một kết nối do component vẽ ra thay vì trên khối attachment riêng của component: socket mà kết nối được nối qua và alias mà kết nối được viết dưới đó. Cặp này chỉ định một trong các cạnh của đồ thị — cạnh có nguồn là node mang attachment và có socket và alias là những giá trị này — nên bên tiêu thụ nối attachment với cạnh đó, và qua cạnh đó với đích mà attachment được trình bày tới.

Thuộc tínhLoạiBắt buộcMô tả
socketstringcóSocket mà kết nối được nối qua: socket của cạnh mà attachment thuộc về.
aliasstringcóAlias mà kết nối được viết dưới đó: alias của cạnh mà attachment thuộc về.

Không cho phép thuộc tính bổ sung.

IRFeatureEntry

Một attachment đã được phân giải cho một node, được mang trong feature_values_mapping. Mọi họ attachment đều dùng chung hình dạng này — một Feature vận hành, một Feature thông tin xác thực, một Feature danh tính — nên không họ nào nhận một phép chiếu mất mát nhiều hơn họ khác. Nội dung values của một attachment thông tin xác thực là lựa chọn của tác giả: thông tin xác thực theo tham chiếu mang một con trỏ vào kho bí mật, thông tin xác thực theo giá trị mang chính dữ liệu đó, và trình biên dịch mang nguyên văn dạng nào đã được viết mà không phân giải dạng nào.

Thuộc tínhLoạiBắt buộcMô tả
typestringcóURI của Catalog Feature mà attachment này yêu cầu.
resolved_versionstringcóPhiên bản ngữ nghĩa chính xác được phân giải trong quá trình biên dịch.
labelsmap của stringkhôngCác nhãn catalog của Feature được gắn, được mang nguyên văn theo thứ tự mà thực thể catalog của nó khai báo — không bao giờ bị lọc, chuẩn hóa hay bỏ tiền tố, nên bên tiêu thụ đọc đúng những gì tác giả catalog đã viết. Trình biên dịch không đọc nhãn nào trong số đó. Vắng mặt khi Feature không khai báo nhãn nào, và khi type của nó không phân giải tới thực thể catalog nào.
catalog_annotationsmap của stringkhôngCác annotation catalog của Feature được gắn — metadata.annotations của thực thể Feature mà attachment này chỉ định — được mang nguyên văn theo thứ tự mà thực thể đó khai báo, không bao giờ bị lọc, chuẩn hóa hay bỏ tiền tố, nên bên tiêu thụ đọc đúng những gì tác giả catalog đã viết, kể cả các khóa trong namespace riêng của tác giả. Trình biên dịch không đọc annotation nào trong số đó. Khác với annotation_key và annotation_source, vốn đặt tên và định vị annotation đã khiến attachment này tồn tại: hai trường đó cho biết attachment đã hình thành như thế nào, còn trường này cho biết metadata của thực thể mà nó chỉ định, và một attachment được viết trong khối features: mang các annotation này trong khi không mang trường nào trong hai trường kia. Vắng mặt khi Feature không khai báo annotation nào, và khi type của nó không phân giải tới thực thể catalog nào.
bindingstringkhôngChỉ định slot attachment mà attachment này lấp vào, hoặc “free” khi nó không lấp slot đã khai báo nào. Một slot được khai báo ở một trong hai nơi, và nơi attachment được viết quyết định nơi nào: một attachment thuộc khối attachment riêng của node lấp một slot mà Component chủ khai báo trong featuresSchema của nó, còn một attachment được viết trên một kết nối lấp một slot mà socket của kết nối khai báo trong featuresSchema của socket đó trên Component chủ. Ở cả hai trường hợp, việc ghép cặp là theo tên — một attachment lấp một slot khi Feature được gắn dưới tên của slot, trên khối của component hoặc trên kết nối — nên giá trị là một khóa chính xác từ tập slot đã khai báo, không bao giờ là thứ gì đọc ra từ khóa của attachment. Tập slot của một socket là đóng, vì một attachment được viết trên một kết nối dưới một tên mà socket của nó không khai báo sẽ dừng bản build, nên một attachment mang kết nối không bao giờ báo free. Tên slot được mang thay vì một boolean đơn thuần vì việc slot nào được lấp là nửa hữu ích hơn của câu trả lời. Rỗng khi không thể phân giải tập slot đã khai báo của Component chủ, điều này khác với “free”: free là kết luận khẳng định rằng không có slot đã khai báo nào mang tên này.
valuesobjectkhôngPayload cấu hình vận hành cho attachment. Đối với thông tin xác thực, là dạng nào mà tác giả đã khai báo — một con trỏ vào kho bí mật, hoặc chính dữ liệu đó.
infraobjectkhôngKích thước vật lý theo từng instance cho attachment này.
injectobjectkhôngĐịnh tuyến injection không phụ thuộc. Ánh xạ các biến cục bộ tới các khóa provides của Target.
originstring (enum)khôngPhân biệt các attachment được viết trong khối features: (explicit) với các attachment tổng hợp do lượt mở rộng dựa trên annotation tạo ra (annotation), hoặc mixed khi các lá value/infra của attachment mang cả hai loại (khi đó chi tiết theo từng lá nằm trong các map provenance). Giá trị cho phép: "explicit", "annotation", "mixed"
annotation_keystringkhôngTên annotation đã kích hoạt một attachment tổng hợp. Vắng mặt khi origin là explicit.
annotation_sourcestringkhôngVị trí nguồn của khai báo annotation dưới dạng :. Vắng mặt khi origin là explicit.
values_provenancemap của FieldProvenancekhôngNguồn gốc theo từng lá cho payload values, với khóa là đường dẫn lá dạng chấm.
infra_provenancemap của FieldProvenancekhôngNguồn gốc theo từng lá cho payload infra, với khóa là đường dẫn lá dạng chấm.
sensitivebooleankhôngTrue khi attachment này xử lý dữ liệu mà tác giả đã khai báo là nhạy cảm — hoặc Feature được gắn khai báo một lá nhạy cảm trong trụ values, infra hoặc provides của nó, hoặc slot mà attachment lấp khai báo dữ liệu nó mang là nhạy cảm: slot attachment cùng tên của Component chủ, hoặc, đối với attachment được viết trên một kết nối, slot cùng tên mà socket của kết nối khai báo. Được suy ra từ các khai báo đó trên attachment đã hợp nhất, không bao giờ từ nội dung của một giá trị hay một cái tên. Không được đặt khi không có khai báo nào.
sensitive_injectmap của map của stringkhôngCác khóa phân phối của inject mà khóa provides được tham chiếu của chúng được Feature được gắn khai báo là nhạy cảm, theo hình dạng riêng của inject: cơ chế, rồi đến khóa phân phối, với khóa provides được tham chiếu là giá trị. Một tập con của inject. Vắng mặt khi attachment không khai báo cơ chế phân phối nào hoặc không tham chiếu khóa provides nhạy cảm nào.
sensitive_payload_leavesstring[]khôngCác leaf mà payload values và infra của attachment này mang và Feature được gắn khai báo là nhạy cảm, mỗi leaf ở dạng đường dẫn phân cách bằng dấu chấm có tiền tố pillar mà dữ liệu chiếm giữ: values. hoặc infra.. Payload được đọc ở đây là payload mà attachment cuối cùng mang, nên một leaf nằm ở giá trị mà schema của Feature khai báo làm mặc định được nêu tên cùng với leaf do tác giả viết — một giá trị mặc định đã được điền là một dữ liệu mà payload mang, và một đánh dấu chỉ đọc từ khối đã viết sẽ bỏ sót nó. Đây là đơn vị theo từng leaf của đánh dấu nhạy cảm, và nó trả lời một câu hỏi mà hai trường kia không trả lời — sensitive cho một câu trả lời cho toàn bộ attachment, sensitive_inject cho một câu trả lời cho mỗi khóa phân phối của inject, và không trường nào nêu tên một leaf riêng lẻ. Một leaf xuất hiện khi một đường dẫn mà schema của Feature khai báo là nhạy cảm bao phủ nó: khai báo nêu tên leaf đó, hoặc nêu tên một object chứa nó, nên một leaf nằm dưới một object mà một khai báo bao phủ được khai báo đó nêu tên. Việc so khớp chạy theo từng đoạn trên đường dẫn phân cách bằng dấu chấm, không đọc gì từ chính văn bản của đường dẫn và không kiểm tra giá trị nào, nên một khai báo tại db bao phủ db.password và không chạm tới leaf anh em tên dbPassword. Câu trả lời cho mỗi attachment không bao giờ được trải ra các leaf riêng lẻ, vì điều đó sẽ khẳng định sai về một leaf được để ở dạng đọc được. Khóa vắng mặt cho biết attachment này không nêu tên leaf nào mà Feature của nó khai báo là nhạy cảm. Nó không khẳng định rằng payload không nhạy cảm, và nó không phân biệt một attachment không có leaf như vậy để nêu tên với một producer hoàn toàn không báo cáo trục này — một guest đọc khóa vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị ở dạng rõ đã hiểu ngược. Các leaf đến theo thứ tự payload giữ chúng, leaf của pillar values trước leaf của pillar infra — cùng thứ tự mà chính các payload values và infra mang, và là điều làm payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống nhau. Vắng mặt khi attachment không mang leaf nào mà Feature của nó khai báo là nhạy cảm.
connectionAttachmentConnectionkhôngKết nối mà attachment này thuộc về: có mặt trên mọi attachment được viết trên một trong các kết nối của node, và vắng mặt trên mọi attachment của khối attachment riêng của node. Một attachment được viết trên một kết nối là một trong các attachment của node ở mọi khía cạnh khác — được đánh khóa bằng tên đầy đủ của nó, tức alias của kết nối và slot nối bằng dấu chấm, và lấy binding cùng tính nhạy cảm từ slot mà socket của kết nối khai báo — nên trường này là thứ phân biệt hai loại, và nó mang kết nối dưới dạng dữ liệu thay vì để phải đọc ra từ khóa. Consumer nối nó với các edge của đồ thị theo socket và alias: edge có nguồn là node mang attachment này và có socket và alias là các giá trị này chính là kết nối mà attachment được trình bày trên đó, và đích của edge đó là thứ nó được trình bày tới. Một attachment của kết nối do một Feature attachment tạo ra không bao giờ mang trường này, vì kết nối như vậy không mang attachment nào.
realizationstringkhôngFeatureRecipe hiện thực hóa attachment này, ở dạng :: FeatureRecipe mà Manifest gắn với nó — theo tên riêng của attachment khi tầng tên của Manifest ánh xạ tên đó, nếu không thì theo loại Feature của nó — cũng chính là FeatureRecipe mà một lần build cùng các tài liệu dùng để render nó. Với một attachment được viết trên một kết nối, tên mà tầng tên dùng để đọc là tên đầy đủ của nó, tức alias của kết nối và slot nối bằng dấu chấm. Giá trị này là cặp mà aggrega inspect in ra làm realization của attachment và, khi một target đóng dấu provenance lên những gì nó render, là giá trị aggrega.ai/recipe-uri trên các tài liệu mà FeatureRecipe đó render, nên consumer nối một attachment với những gì nó render mà không cần chuyển đổi giữa các dạng. Nó nêu tên FeatureRecipe theo tên và phiên bản chứ không theo capability. Trường này ghi lại FeatureRecipe mà Manifest gắn, được đọc từ Manifest và catalog khi đồ thị được xây dựng: không có gì được tải về để tạo ra nó, và FeatureRecipe chỉ được render khi build thực hiện render. Vắng mặt khi Manifest không gắn attachment với FeatureRecipe nào mà catalog chứa.

Không cho phép thuộc tính bổ sung.

IRFeatureEntry.inject

Định tuyến injection không phụ thuộc. Ánh xạ các biến cục bộ tới các khóa provides của Target.

Thuộc tínhLoạiBắt buộcMô tả
envmap của stringkhôngPhân phối qua biến môi trường: khóa là tên biến cục bộ của bên tiêu thụ, giá trị là khóa provides của đích.
filemap của stringkhôngPhân phối qua gắn kết tệp: khóa là đường dẫn tệp cục bộ của bên tiêu thụ, giá trị là khóa provides của đích.
argmap của stringkhôngPhân phối qua đối số dòng lệnh: khóa là tiền tố cờ của bên tiêu thụ, giá trị là khóa provides của đích.

IRBoundaryFeature

Một Feature attachment cấp boundary được chiếu vào IR: URI loại Feature cùng với infra của boundary mà một FeatureRecipe phạm vi boundary render và dùng để phân giải nguồn của nó. Các attachment cấp boundary không mang payload values.

Thuộc tínhLoạiBắt buộcMô tả
typestringcóURI của Catalog Feature được gắn tại boundary này.
infraobjectkhôngKích thước vật lý cho attachment của boundary; infra mà một FeatureRecipe phạm vi boundary dùng để đánh giá các template và nguồn của nó.
sensitive_payload_leavesstring[]khôngCác leaf mà payload infra của attachment boundary này mang và Feature được gắn khai báo là nhạy cảm, mỗi leaf ở dạng đường dẫn phân cách bằng dấu chấm có tiền tố pillar mà dữ liệu chiếm giữ. Chỉ các tọa độ infra. xuất hiện ở đây, vì attachment cấp boundary không mang payload values. Payload được đọc ở đây là payload mà attachment cuối cùng mang, nên một leaf nằm ở giá trị mà schema của Feature khai báo làm mặc định được nêu tên cùng với leaf do boundary viết — một giá trị mặc định đã được điền là một dữ liệu mà payload mang, và một đánh dấu chỉ đọc từ khối đã viết sẽ bỏ sót nó. Một leaf xuất hiện khi một đường dẫn mà schema của Feature khai báo là nhạy cảm bao phủ nó: khai báo nêu tên leaf đó, hoặc nêu tên một object chứa nó, nên một leaf nằm dưới một object mà một khai báo bao phủ được khai báo đó nêu tên. Việc so khớp chạy theo từng đoạn trên đường dẫn phân cách bằng dấu chấm, không đọc gì từ chính văn bản của đường dẫn và không kiểm tra giá trị nào, nên một khai báo tại db bao phủ db.password và không chạm tới leaf anh em tên dbPassword. Khóa vắng mặt cho biết attachment này không nêu tên leaf nào mà Feature của nó khai báo là nhạy cảm, bao gồm cả trường hợp Feature được gắn phân giải tới không schema nào mà trình đọc này có thể đọc. Nó không khẳng định rằng payload infra không nhạy cảm, và nó không phân biệt một attachment không có leaf như vậy để nêu tên với một producer hoàn toàn không báo cáo trục này. Một consumer đọc khóa vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị ở dạng rõ đã hiểu ngược. Các leaf đến theo thứ tự payload giữ chúng, cũng là thứ tự mà chính payload infra mang và là điều giữ cho đồ thị giống hệt nhau từng byte qua các lần chạy với đầu vào giống nhau. Vắng mặt khi attachment không mang leaf nào mà Feature của nó khai báo là nhạy cảm.
realizationstringkhôngFeatureRecipe hiện thực hóa attachment boundary này, ở dạng :: FeatureRecipe mà Manifest gắn với nó — theo tên riêng của attachment khi tầng tên của Manifest ánh xạ tên đó, nếu không thì theo loại Feature của nó — cũng chính là FeatureRecipe mà một lần build cùng các tài liệu dùng để render nó. Đây là cùng trường, được đọc theo cùng cách, như realization của một mục attachment trong feature_values_mapping. Vắng mặt khi Manifest không gắn attachment với FeatureRecipe nào mà catalog chứa.

Không cho phép thuộc tính bổ sung.

CatalogMetadata

Bộ Enterprise Metadata được trích xuất rõ ràng từ thực thể Catalog, cung cấp dữ liệu vòng đời và quyền sở hữu cho các linter Wasm.

Thuộc tínhLoạiBắt buộcMô tả
maintainersMaintainer[]khôngNhững người bảo trì mà thực thể catalog liệt kê là chủ sở hữu của nó.
licensestringkhôngĐịnh danh giấy phép SPDX mà thực thể catalog khai báo cho phần mềm nó mô tả.
repositorystringkhôngURL của repository Git mà thực thể catalog nêu là nơi chứa các tệp nguồn của nó.
homestringkhôngURL của trang chủ, wiki hoặc tài liệu của thực thể catalog.
keywordsstring[]khôngCác từ khóa mô tả mà thực thể catalog khai báo.

Không cho phép thuộc tính bổ sung.

IRNode

Thuộc tínhLoạiBắt buộcMô tả
descriptionstringkhôngTài liệu tùy chọn do nhà phát triển viết, mô tả vai trò của instance component này trong ứng dụng. Được truyền qua từ Aggregate để phục vụ việc render và các chẩn đoán lint.
labelsmap của stringcóCác nhãn duck-typing và ontology của thực thể.
componentstringcóTên của Component bên dưới.
resolved_versionstringcóPhiên bản Semantic Version chính xác của Component được phân giải trong quá trình biên dịch.
sync_waveintegerkhôngĐợt triển khai được kế thừa từ trường syncWave của boundary chứa nó (mặc định 0; cho phép giá trị âm). Trên K8s và Helm, đợt là thứ sắp xếp thứ tự triển khai: nó trở thành annotation argocd.argoproj.io/sync-wave, và trên một tài nguyên mà chart đã đánh dấu là Helm hook, nó cũng trở thành helm.sh/hook-weight của hook đó. Trên compose, giá trị vừa được ghi lại dưới dạng nhãn của service vừa sắp xếp thứ tự các service của tệp mà nó được render vào, thông qua depends_on giữa chúng. Trên cloudformation, nó sắp xếp thứ tự cung cấp của stack mà một nhóm dispatch được lắp ráp vào, mỗi tài nguyên trong một đợt được khai báo là phụ thuộc vào các tài nguyên của đợt trước đó: thứ tự chúng được tạo và, theo chiều ngược lại, thứ tự chúng bị xóa, không bao giờ là trạng thái sẵn sàng, vì một stack template không thể hiện khái niệm nào về việc một tài nguyên sẵn sàng. Trên terraform, nó sắp xếp thứ tự các khối module của cấu hình gốc mà một boundary được lắp ráp vào, mỗi module trong một đợt được khai báo là phụ thuộc vào các module của đợt trước đó: thứ tự engine thực hiện các hành động của nó, không bao giờ là trạng thái sẵn sàng, vì một cấu hình không thể hiện khái niệm nào về việc một tài nguyên sẵn sàng. Giá trị này cũng đi kèm với nguồn gốc build của node.
boundary_pathstringkhôngĐường dẫn của boundary trong Release mà node này được đặt vào: tên các boundary từ boundary ngoài cùng vào trong, nối bằng / (ví dụ: ‘data/inner’ cho một component được đặt trong boundary inner khai báo bên trong boundary data). Tên boundary không thể chứa /, nên đường dẫn được tách ngược lại thành các boundary mà không mơ hồ. Một node của Aggregate được import mà Release định tuyến vào một boundary sẽ mang đường dẫn của boundary đó. Cho phép các plugin render tạo ra các định danh duy nhất có nhận biết boundary.
subsystem_pathstringkhôngĐường dẫn của subsystem trong Aggregate nơi component của node này được khai báo: tên các subsystem từ subsystem ngoài cùng vào trong, nối bằng . (ví dụ: ‘backend.storage’ cho một component khai báo trong subsystem storage lồng bên trong subsystem backend). Tên subsystem không thể chứa ., nên đường dẫn được tách ngược lại thành các subsystem mà không mơ hồ. Một component của Aggregate khai báo components ở cấp cao nhất mang subsystem tổng hợp default, được đánh dấu bởi synthesized_subsystem. Đường dẫn là tương đối với Aggregate khai báo component: một node do Aggregate được import đóng góp mang đường dẫn của nó bên trong Aggregate đó, không kèm tên mà nó được import dưới đó (ví dụ: ‘tier’ cho một component trong subsystem tier của Aggregate được import), nên các node từ các Aggregates khác nhau có thể chung một đường dẫn. ID của node, bắt đầu bằng tên import, và source_file phân biệt chúng.
synthesized_subsystembooleankhôngTrue khi subsystem của node này được trình biên dịch tổng hợp — subsystem default được tạo cho một Aggregate khai báo components ở cấp cao nhất thay vì các subsystems có tên. Là nguồn gốc suy diễn, không bao giờ do người viết: nó phân biệt default tổng hợp với một subsystem mà người dùng đặt tên tường minh là default. Độc lập với synthesized_boundary (một node có thể được tổng hợp trên một trong hai trục hoặc cả hai). Vắng mặt (false) đối với mọi subsystem do người viết.
synthesized_boundarybooleankhôngTrue khi boundary của node này được trình biên dịch tổng hợp — boundary default được tạo cho một Release khai báo components ở cấp cao nhất thay vì các boundaries có tên. Là nguồn gốc suy diễn, không bao giờ do người viết: nó phân biệt default tổng hợp với một boundary mà người dùng đặt tên tường minh là default, và định tuyến các artifact của node vào dist/ dạng phẳng thay vì dist/boundaries/default/. Vắng mặt (false) đối với mọi boundary do người viết.
catalog_metadataCatalogMetadatakhôngBộ Enterprise Metadata được trích xuất rõ ràng từ thực thể Catalog, cung cấp dữ liệu vòng đời và quyền sở hữu cho các linter Wasm.
catalog_annotationsmap của stringkhôngCác đặc tính nội tại, bất biến của component do Platform Architect viết trong Domain 2.
release_annotationsmap của stringkhôngCác chuỗi topology vật lý và thực tế vận hành được truyền xuống từ các boundary trong Release.
aggregate_annotationsmap của stringkhôngMetadata nhận thức, ý định của nhà phát triển và FinOps được truyền xuống từ các subsystem trong Aggregate.
self_injectobjectkhôngKhối self-inject ở cấp Component được mang theo từ Aggregate; định tuyến injection không phụ thuộc vào ngữ nghĩa mà node tự khai báo cho chính nó. Không minh bạch ở tầng schema này; một plugin chính sách đọc nó sẽ tự phân tích các byte.
source_filestringkhôngĐường dẫn tương đối với workspace của tệp Aggregate nơi node này được viết. Các node tầng gốc mang đường dẫn của Aggregate gốc; các node sub-aggregate mang đường dẫn tệp của Aggregate được import. Đường dẫn là tương đối với gốc workspace (thư mục chứa .aggrega-config.yaml), nên đồ thị giống hệt nhau từng byte trên các máy có workspace nằm ở các đường dẫn tuyệt đối khác nhau. Các consumer lọc chẩn đoán theo tệp phân giải trường này theo cùng gốc workspace trước khi so sánh. Vắng mặt khi đồ thị được build mà không có gốc workspace.
usesobjectkhôngKhối uses của node đúng như được viết: mỗi tên socket ánh xạ tới hoặc một danh sách tên instance đích, hoặc một map các mục kết nối có khóa là alias, theo thứ tự tác giả khai báo. Đây là khối như được viết, một sự thật khác với các kết nối đã phân giải trong edges: một socket mà tác giả đã điền xuất hiện ở đây ngay cả khi nó không tạo ra kết nối nào, nên người đọc có thể phân biệt một socket tác giả đã điền với một socket thực sự tới được một đích. Vắng mặt khi node không viết khối uses nào. Không trong suốt ở tầng schema này; một plugin chính sách đọc nó sẽ tự phân tích các byte.
sensitive_payload_leavesstring[]khôngCác lá mà payload values và infra của node này mang và Component của nó khai báo là nhạy cảm, mỗi lá dưới dạng đường dẫn có dấu chấm, có tiền tố trụ cột, mà dữ liệu chiếm: values. hoặc infra.. Nó nêu tên dữ liệu RIÊNG của node — những gì values_mapping và infra_mapping mang cho node này — và là một chủ thể khác với đánh dấu trên một mục attachment, vốn nêu tên dữ liệu mà một attachment mang theo khai báo của Feature của nó. Không cái nào khôi phục được từ cái kia: Component của một node và Feature của một attachment khai báo các schema khác nhau, và một node không gắn gì vẫn mang values. Payload được đọc ở đây là payload mà hai mapping đó mang, nên một lá nằm ở một giá trị mà schema của Component khai báo là mặc định được nêu tên cùng với lá do tác giả viết — một mặc định được điền là một dữ liệu mà đồ thị mang, và một đánh dấu chỉ đọc từ các khối được viết sẽ bỏ sót nó. Một lá xuất hiện khi một đường dẫn mà schema của Component khai báo là nhạy cảm bao phủ nó: khai báo nêu tên lá đó, hoặc nêu tên một object chứa nó, nên một lá nằm dưới một object mà khai báo bao phủ được nêu tên bởi khai báo đó. Việc so khớp chạy theo từng đoạn trên đường dẫn có dấu chấm, không đọc gì từ chính văn bản của đường dẫn và không kiểm tra giá trị nào, nên một khai báo tại db bao phủ db.password và không chạm tới một lá anh em tên dbPassword. Một khóa vắng mặt cho biết node này không nêu tên lá nào mà Component của nó khai báo là nhạy cảm, bao gồm cả trường hợp Component của node phân giải tới không schema nào mà trình đọc này đọc được. Nó không khẳng định payload của node là không nhạy cảm, và không phân biệt một node không có lá nào như vậy để nêu tên với một producer hoàn toàn không báo cáo trục này. Một consumer đọc khóa vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị dưới dạng rõ đã hiểu ngược nó. Các lá đến theo thứ tự payload giữ chúng, của trụ cột values trước của trụ cột infra, cũng là thứ tự mà chính các payload đó mang và là điều giữ cho đồ thị giống hệt từng byte qua các lần chạy với đầu vào giống nhau. Vắng mặt khi node không mang lá nào mà Component của nó khai báo là nhạy cảm.

Không cho phép thuộc tính bổ sung.

IREdge

Thuộc tínhLoạiBắt buộcMô tả
sourcestringcóID của node tiêu thụ, nơi kết nối bắt đầu.
targetstringcóID của node mà kết nối đi tới.
socketstringkhôngDanh mục usesSchema mà cạnh này thuộc về (ví dụ: ‘databases’, ‘tools’).
aliasstringkhôngBí danh do nhà phát triển định nghĩa cho kết nối này (ví dụ: ‘primary_db’).
socket_declarationstring (enum)cóNguồn gốc của socket: declared khi thực thể catalog sở hữu socket liệt kê nó trong usesSchema (Component tiêu thụ, hoặc Feature khởi tạo đối với cạnh do Feature tạo ra), ad-hoc khi tác giả Aggregate đặt tên một socket mà catalog không khai báo. Đây là trục thứ ba, độc lập với quyền tác giả của cạnh: nó cho biết socket đến từ đâu, không phải ai đã vẽ cạnh, nên một cạnh do Release tạo vào một socket đã khai báo và một cạnh do Aggregate tạo vào một socket ad-hoc khác nhau trên hai trục một cách độc lập. Một socket đã khai báo mang mục usesSchema của nó, bao gồm selector ràng buộc những đích mà cạnh có thể đến; một socket ad-hoc không có mục catalog và do đó không có selector, nên những gì cạnh có thể mang chỉ bị giới hạn bởi provides đã khai báo của đích. Luôn có mặt, nên bên tiêu thụ không bao giờ phải đọc một giá trị vắng mặt là declared, và một chính sách có thể yêu cầu mọi cạnh đều phải được khai báo. Khác với dấu đánh binding của một attachment, vốn trả lời cùng dạng câu hỏi về một chủ thể khác. Giá trị cho phép: "declared", "ad-hoc"
origin_featurestringkhôngNếu cạnh này được một Feature tự động khai báo (bao gồm các Features thông tin xác thực được gắn nhãn feature.aggrega.ai/kind: secret), trường này xác định URI kiểu Feature. Cho phép các Plugins Wasm cô lập topology của riêng chúng.
origin_feature_instancestringkhôngTên instance theo từng attachment của Feature đã khai báo cạnh này. Xác định provides đã phân giải của một FeatureRecipe phạm vi boundary theo instance, phân biệt hai attachment của cùng một kiểu Feature trên một boundary.
origin_releasebooleankhôngTrue khi cạnh này được tạo bởi một Release nối một socket đã khai báo nhưng chưa ràng buộc tới một component hiện có. Đánh dấu QUYỀN TÁC GIẢ của cạnh, không phải cấu hình: một cạnh do nhà phát triển khai báo mà một Release chỉ cung cấp infra vẫn có nguồn gốc Aggregate (origin_release không được đặt; infra của Release nằm trong map infra của cạnh). origin_feature được đặt => nguồn gốc Feature; origin_release true => nguồn gốc Release; không có cả hai => nguồn gốc Aggregate.
valuesobjectkhôngCác giá trị của nhà phát triển theo từng kết nối đã được phân giải cho cạnh này (từ cạnh Aggregate), được xác thực khi phân giải theo valueSchema do socket nguồn khai báo (socket trên component tiêu thụ, vốn là nguồn của cạnh) và được chiếu vào ngữ cảnh render của node tiêu thụ tại .context.uses..values. Các khóa mà tác giả bỏ qua được điền từ các giá trị mặc định đã khai báo của socket; giá trị do tác giả viết được ưu tiên.
infraobjectkhôngInfra theo từng kết nối đã được phân giải cho cạnh này, do một mục cạnh của Release cung cấp, được xác thực khi phân giải theo infraSchema do socket nguồn khai báo (socket trên component tiêu thụ, vốn là nguồn của cạnh) và được chiếu tại .context.uses..infra. Các khóa mà tác giả bỏ qua được điền từ các giá trị mặc định đã khai báo của socket; giá trị do tác giả viết được ưu tiên.
injectobjectkhôngĐịnh tuyến injection không phụ thuộc. Ánh xạ các biến cục bộ tới các khóa provides của Target.
sensitive_payload_leavesstring[]khôngCác leaf mà values và infra của edge này mang và socket mà chúng được viết theo khai báo là nhạy cảm, mỗi leaf ở dạng đường dẫn phân cách bằng dấu chấm có tiền tố pillar mà dữ liệu chiếm giữ: values. hoặc infra.. Khai báo được đọc là hợp đồng theo từng kết nối trên component TIÊU THỤ — nguồn của edge — dưới socket mà edge này được nối vào: valueSchema của nó chi phối values và infraSchema của nó chi phối infra, cũng chính là hợp đồng mà cả hai payload được xác thực theo. Các khai báo của target không đóng vai trò gì: thứ target công bố là một dữ liệu khác với cấu hình mà bên tiêu thụ viết cho kết nối. Đây là cùng một trường, được đọc theo cùng cách, như đánh dấu trên một node, nhưng với một đối tượng khác: đánh dấu của node nêu tên dữ liệu riêng của node theo schema của Component của nó, còn đánh dấu này nêu tên cấu hình của kết nối theo hợp đồng của socket, nên không cái nào có thể khôi phục từ cái kia. Các payload được đọc ở đây là những payload mà edge này mang, nên một leaf nằm ở giá trị mà hợp đồng của socket khai báo làm mặc định được nêu tên cùng với leaf do tác giả viết. Một leaf xuất hiện khi một đường dẫn mà hợp đồng khai báo là nhạy cảm bao phủ nó: khai báo nêu tên leaf đó, hoặc nêu tên một object chứa nó. Việc so khớp chạy theo từng đoạn trên đường dẫn phân cách bằng dấu chấm, không đọc gì từ chính văn bản của đường dẫn và không kiểm tra giá trị nào, nên một khai báo tại db bao phủ db.password và không chạm tới leaf anh em tên db_password. Một bề mặt che giấu các giá trị được khai báo là nhạy cảm khỏi graph sẽ che giấu các leaf này trong values và infra của edge này, và trong mục uses của node tiêu thụ cho cùng kết nối đó, vốn mang các giá trị như tác giả đã viết. Khóa vắng mặt cho biết edge này không nêu tên leaf nào mà hợp đồng socket của nó khai báo là nhạy cảm, bao gồm cả trường hợp socket không khai báo hợp đồng nào có thể đọc được ở đây. Nó không khẳng định rằng cấu hình không nhạy cảm, và một bên tiêu thụ đọc khóa vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị ở dạng rõ đã hiểu ngược. Các leaf đến theo thứ tự các payload giữ chúng, leaf của pillar values trước leaf của pillar infra, và đó là điều giữ cho graph giống hệt nhau từng byte qua các lần chạy với đầu vào giống nhau. Vắng mặt khi edge không mang leaf nào mà hợp đồng socket của nó khai báo là nhạy cảm.

Không cho phép thuộc tính bổ sung.

IREdge.inject

Định tuyến injection không phụ thuộc. Ánh xạ các biến cục bộ tới các khóa provides của Target.

Thuộc tínhLoạiBắt buộcMô tả
envmap của stringkhôngPhân phối qua biến môi trường: khóa là tên biến cục bộ của bên tiêu thụ, giá trị là khóa provides của đích.
filemap của stringkhôngPhân phối qua gắn kết tệp: khóa là đường dẫn tệp cục bộ của bên tiêu thụ, giá trị là khóa provides của đích.
argmap của stringkhôngPhân phối qua đối số dòng lệnh: khóa là tiền tố cờ của bên tiêu thụ, giá trị là khóa provides của đích.

IRMetadata

Định danh của đồ thị: Aggregate mà đồ thị được build từ đó.

Thuộc tínhLoạiBắt buộcMô tả
aggregate_namestringcómetadata.name của Aggregate.

Không cho phép thuộc tính bổ sung.

IRProvenance

Siêu dữ liệu truy vết phục vụ chẩn đoán và kiểm toán.

Thuộc tínhLoạiBắt buộcMô tả
schema_versionstringcóPhiên bản của schema IR mà đồ thị tuân theo — aggrega.ai/v1beta1, cùng giá trị mà apiVersion của đồ thị mang.
compiler_versionstringcóDấu tuân thủ bắt buộc. Xác định, theo phiên bản của nó, binary aggrega đã build đồ thị này.
aggregate_versionstringcóPhiên bản ngữ nghĩa chính xác của intent Aggregate gốc được dùng trong quá trình biên dịch.
manifest_versionstringcóPhiên bản ngữ nghĩa chính xác của lockfile Manifest được dùng trong quá trình biên dịch.
release_versionstringcóPhiên bản ngữ nghĩa chính xác của tệp định tuyến Release được dùng trong quá trình biên dịch.

Cho phép thuộc tính bổ sung.

IRSpec

Bản thân đồ thị: các nút, các cạnh của nó và các payload được đánh khóa theo nút.

Thuộc tínhLoạiBắt buộcMô tả
nodesmap của IRNodecóTừ điển của mọi node trong đồ thị, với khóa là ID tuyệt đối của chúng. Thuần túy về topology. Khóa: một hoặc nhiều chữ cái, chữ số, dấu gạch dưới, dấu chấm hoặc dấu gạch nối. Mẫu: ^[a-zA-Z0-9_.-]+$.
edgesIREdge[]cóCác đường mạng logic và phụ thuộc tường minh giữa các node.
values_mappingobjectcóNguồn sự thật duy nhất cho các payload nhận thức chuyển tiếp không tường minh, ánh xạ theo ID node.
infra_mappingobjectcóPayload định cỡ vật lý được tiêm từ Release, ánh xạ theo ID node.
feature_values_mappingmap của map của IRFeatureEntrycóMap đã chuẩn hóa từ ID node tới các cấu hình Feature được gắn vào chúng. Một bucket mang mọi attachment trên một node bất kể nó tạo ra gì — Features vận hành, Features thông tin xác thực, Features danh tính — với khóa là tên instance mà tác giả đặt cho từng attachment. Một attachment được viết trên một trong các kết nối của node có khóa là tên đầy đủ của nó, tức bí danh của kết nối và slot nối với nhau bằng dấu chấm, và ghi tên kết nối của nó trong trường connection của chính nó. Khóa: một hoặc nhiều chữ cái, chữ số, dấu gạch dưới, dấu chấm hoặc dấu gạch nối. Mẫu: ^[a-zA-Z0-9_.-]+$.
boundary_featuresmap của map của IRBoundaryFeaturekhôngCác attachment Feature của từng boundary, với khóa là đường dẫn boundary rồi đến tên instance. Chỉ có mặt khi đồ thị có các attachment Feature cấp boundary. Khóa: một hoặc nhiều chữ cái, chữ số, dấu gạch dưới, dấu chấm, dấu gạch chéo hoặc dấu gạch nối. Mẫu: ^[a-zA-Z0-9_./-]+$.
provenanceIRProvenancecóSiêu dữ liệu truy vết phục vụ chẩn đoán và kiểm toán.

Không cho phép thuộc tính bổ sung.

IRGraph

Thuộc tínhLoạiBắt buộcMô tả
apiVersionconst “aggrega.ai/v1beta1”cóHằng số: "aggrega.ai/v1beta1"
kindconst “IR”cóHằng số: "IR"
metadataIRMetadatacóĐịnh danh của đồ thị: Aggregate mà đồ thị được build từ đó.
specIRSpeccóBản thân đồ thị: các nút, các cạnh của nó và các payload được đánh khóa theo nút.

Không cho phép thuộc tính bổ sung.