Settings カタログ

解決ロジック

getSetting(key, ctx) の探索順:
  User(user_id, key)
    └ なければ Project(project_id, key)
         └ なければ Tenant(tenant_id, key)
              └ なければ System(*, key)
                   └ なければ DefaultRegistry[key].default

各項目に表示するメタデータ

• Key (例: bq.cost_cap_usd.ui_preview)
• 型 (string / int / float / bool / enum / json / secret)
• 既定値
• 現在のソース (User / Project / Tenant / System / Default)
• 影響範囲 (例: 「Studio Step4 dry-run」)
• 再起動要否 (Hot / Restart-required)
• 機密フラグ (secret はマスク表示 + 編集時のみ平文入力)

操作

• 編集: インライン or モーダル (schema に応じて自動 UI)
• テスト: Connection 系は "Test connection" ボタン (BQ ping / LLM ping / S3 list)
• エクスポート / インポート: スコープ単位で JSON エクスポート (機密は除外)
• 差分: 編集前後の diff プレビュー
• 履歴: 直近 50 件の変更を表示、ロールバック可能

-- 非機密値
CREATE TABLE settings (
  id              uuid PK,
  scope           text CHECK (scope IN ('system','tenant','project','user')),
  scope_id        text,
  key             text NOT NULL,
  value_json      jsonb,
  value_secret_id uuid,            -- 機密値は KMS 経由で別表
  schema_version  int NOT NULL,
  updated_by      uuid NOT NULL,
  updated_at      timestamptz NOT NULL,
  UNIQUE(scope, scope_id, key)
);

-- 機密値 (KMS 暗号化 blob)
CREATE TABLE settings_secrets (
  id          uuid PK,
  ciphertext  bytea NOT NULL,       -- KMS encrypted
  kms_key_uri text NOT NULL,
  created_at  timestamptz NOT NULL
);

-- 変更履歴 (監査)
CREATE TABLE settings_audit (
  id          bigserial PK,
  scope       text, scope_id text, key text,
  old_hash    text, new_hash text,  -- 機密は old/new ハッシュのみ
  old_value   jsonb, new_value jsonb,  -- 非機密は raw
  changed_by  text, changed_at timestamptz
);

Service A (FastAPI)            Redis pub/sub              Service B (Worker)
    │ PUT /v1/settings/...         │                            │
    │─────────────────────────────►│                            │
    │ settings_service.update()    │                            │
    │ → DB write                   │                            │
    │ → publish "settings:changed" │                            │
    │─────────────────────────────►│                            │
    │                              │── subscribe ──────────────►│
    │                              │                            │ cache invalidate
    │                              │                            │ → 次の getSetting で DB から再取得

OV (overridable_at)

どこまで下位スコープで上書きできるか。S = System / T = Tenant / P = Project / U = User

HR (Hot reload)

● = Hot reload 対応 (5 秒以内に各サービスに反映) / ◯ = Restart required

Sec (機密)

● = 機密値 (KMS 暗号化、UI マスク表示)

{
  key: "bq.cost_cap_usd.ui_preview",
  type: "float",
  min: 0,
  max: 100,
  default: 0.05,
  scope_max: "tenant",      // T までしか下りない
  overridable_at: ["tenant"],
  hot_reload: true,
  secret: false,
  description: "UI プレビュー dry-run 1 回あたりの USD 上限",
  affects: ["Studio Step4", "BigQueryAccessService.dry_run"],
  ui: { component: "money", currency: "USD" }
}