Files
pages/docs/design/ja/campus-federation.md
Anya Tokugawa d5d21b7841
Build and publish container images / images (push) Successful in 9m34s
Release container images / release (push) Successful in 36s
Refactor architecture into eight components and consolidate reliability work
Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts.

Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation.

Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
2026-11-01 15:23:31 +09:00

3.6 KiB

3. キャンパス・ドメイン・連携

状態:ローカル管理、外部キャンパス参加、署名付き設定配信は実装済み。コンテンツ同期・DRとは別機能。

FQDNと配置

キャンパスの設定値はURLではなくFQDNです。ドメインのホスト指定が短い名前ならキャンパスFQDNのサブドメインとして扱い、FQDNならその値を使います。空のホスト名はキャンパスFQDN自身に対応し、未知Hostの受け皿にはしません。

表示用FQDNと配置先インスタンスは別の情報です。FQDNを指定しただけでは別インスタンスとは限りません。配置先は承認された候補から選び、同じFQDNの鍵フィンガープリント変更は同じ実体として黙認しません。

設定の所有者

  • キャンパス管理:配下ドメイン、配置、参加トークン、キャンパスの共通情報。
  • ドメイン管理:Wiki名、テーマ、記事・拡張設定、メンバー、権限。
  • 外部キャンパス管理:コントローラから受け取った管理項目をローカルで独自に上書きしない。
  • 秘密:実際に認証・接続するインスタンス側に保持し、一般設定manifestへ混ぜない。

ドメインの設定は個別です。同じキャンパスに属するだけで記事、グループ、認証セッションを共有しません。

参加と配信

コントローラ発行トークンで参加要求し、インスタンスidentityを承認します。設定manifestは署名と単調なsequenceを持ち、受信側は適用とcheckpoint更新を同一トランザクションで行います。古いsnapshotへの巻き戻しや同名の別authorityへの置換を拒否します。

入口設定を含むmanifest v2は、全承認済み配置先の対応能力を事前確認します。対応能力の申告は「適用完了」や「オンライン」の証明ではありません。反映ACKと鮮度の明示はTODOです。

--add-external-campus は通常経路、--add-external-campus-http は明示的な開発用HTTP経路です。HTTP許可を一般接続の既定値へ拡張しません。

継承の区別

キャンパス管理者のローカル継承には、付与元ごとの記録と失効処理があります。独立したローカル付与を消さず、継承を切ったときに派生権限だけを除きます。

Domain間PSKによるidentity・group継承は設計段階です。署名付き差分、失効、origin競合、鍵交代を含む同期契約と実装が必要です。キャンパスmanifestの配信やローカル管理者継承が完成したことをもって、任意ドメイン間の安全な権限同期が完成したとは扱いません。

TODOと合格条件

DRの次段階は 管理主系とデータ主系の分離 と 管理manifestの世代・受理契約 を参照する(詳細設計のみ)。 Campusを管理するprimaryと、Domainデータに書き込むprimaryは別authority。 ただし同じDBを正本として共有する役割は物理的なwriter切替を連動させる。 保存済みroleやprobe応答だけで復帰ノードをprimaryにしない。

  • 反映ACK、設定管理の解除、削除ドメインの保持・GC。
  • 同名・異originのグループ衝突、PSK失効、sequence欠落、鍵交換の試験。
  • 秘密の外部管理と明示的なローテーション手順。
  • 別インスタンス記事射影は、取得権限・失効・障害時の閉じ方を設計してから実装する。