リソースガバナンス

このページでわかること: Takos のリソース管理・アクセス制御・課金連携の仕組み。

リソースガバナンスは、リソースの CRUD、アクセス制御、ランタイム設定、usage 計測の組み合わせで構成されています。

管理対象

Takos は次の面を別々に管理します。

• リソース自体の CRUD
• space / service / worker への access grant
• 接続情報の参照
• common env / binding link
• ランタイム設定 / リミット
• app-local の usage 計測と Accounts billing 連携

コントロールポイント

リソース

リソース操作の基点となる公開 API はまだありません。設計上の責務は次のとおりです。

• リソースの CRUD
• access grant (/access)
• 接続情報 (/connection)
• SQL の introspection / query / export (例: D1 バックエンド)
• オブジェクトストアの一覧 / stats / 削除 (例: R2 バックエンド)
• bind / unbind

common env と bindings

状態は次のように分かれています。

• space レベルの common env
• service の common env link
• worker の common env link
• service の bindings
• worker の bindings

「リソースを持つこと」と「どこへ注入するか」を分離するための構造です。

ランタイム設定

service / worker ごとにランタイム設定・リミット・フラグを持てます。 operator が調整する主な対象は次のとおりです。

• ホスト名 / ルート
• common env link
• リソース binding
• ランタイムフラグ / 設定 / リミット

billing とレート制限

Takos app の router には billing / plan ゲートを載せていません。商用の billing ポリシーは Takosumi Accounts / Cloud 側が適用します。Takos app 側が持つのは次の 2 つです。

• usage の計測: app_usage_events に記録し、app_usage_rollups に 集約します (agent の入力トークン数を含む)
• リクエストのレート制限: sliding window / token bucket の Durable Object (RateLimiterDO)

Usage / billing データモデル

Takos app は app-local の usage を記録し、課金主体は Takosumi Accounts (takosumi.billing.usage) に置きます。Takos app 側の主なテーブルは次のとおりです。

• app_usage_events
• app_usage_rollups

billing の所有者は Takosumi Accounts の takosumi.billing.usage BillingPort です。 Takos app は usage イベントを記録し、billing API は Accounts 側が提供します。

operator が確認すべき状態

• リソースインベントリ
• access grant / binding material の credential
• common env のドリフト
• service / worker のランタイム設定
• usage rollup
• billing ステータス

公開 API パスの詳細は API リファレンス を、billing の詳細は Billing を参照してください。