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.
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欠落、鍵交換の試験。
- 秘密の外部管理と明示的なローテーション手順。
- 別インスタンス記事射影は、取得権限・失効・障害時の閉じ方を設計してから実装する。