docs: simplify WIP interaction model
This commit is contained in:
+2
-9
@@ -12,7 +12,6 @@ Operationは少なくとも次の情報を持つ。
|
||||
- `description` — 何を行う操作かを説明する短い自然言語。
|
||||
- `input` — 呼び出し時に受け取る入力の型。
|
||||
- `output` — 呼び出し結果の型。
|
||||
- `guard` — 必要に応じて公開される実行条件・precondition。
|
||||
|
||||
Operation名や型だけに意味を担わせず、`description`をinterface metadataの一部として扱う。長文documentationを埋め込むことは想定しない。
|
||||
|
||||
@@ -36,15 +35,9 @@ Operationの可視性は、頻繁に変化する実行可否やdomain stateを
|
||||
|
||||
例えばread-only主体には読み取り系Operationのみを公開し、maintainerやadminには追加の更新・管理Operationを公開できる。
|
||||
|
||||
WIPはOperationの`available` / `disabled`のような揮発的状態をinterface metadataとして同期することを前提としない。現在の実行可否やpreconditionは、必要に応じてdomain固有のOperationで観測し、最終的なauthorizationや実行条件は`call_operation`時にHostが検証する。
|
||||
WIPはOperationの`available` / `disabled`のような揮発的状態をinterface metadataとして同期することを前提としない。現在状態を判断する必要がある場合は、必要に応じてdomain固有のOperationで観測する。最終的なauthorizationと実行条件の判定は`call_operation`時にHostが行う。
|
||||
|
||||
## 2.2.5 Guard
|
||||
|
||||
Guardを設ける場合は、現在時点のavailabilityを同期する仕組みではなく、Operationに一般的に課されるpreconditionやconstraintを説明するsemantic metadataとして扱う。
|
||||
|
||||
Guardの具体的schemaは未解決事項として管理する。
|
||||
|
||||
## 2.2.6 Operation Result
|
||||
## 2.2.5 Operation Result
|
||||
|
||||
Operationの結果には、通常のdomain valueに加えて、WIP IDLの`entry`型として新しいエントリのpathが含まれ得る。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user