# 1. 設計思想と責務の分離 状態:基盤は実装済み。拡張への適用は継続中。 ## 知識の住所と実体を分ける PagesWikiは、人には階層と街の案内図を提供し、内部では同じ知識を複数の場所から参照できるシステムです。ファイルシステムのコピーをWikiの基本単位にはしません。 | 層 | 責務 | 他の層と混同しないもの | | --- | --- | --- | | Campus | ドメイン群の管理・配置・管理方針 | 記事本文の自動複製 | | Domain | FQDN、Path名前空間、設定、権限評価 | インスタンスそのもの | | Quartier / Street / Spot | 知識の整理・案内・管理範囲 | Pageの永続ID | | Page | 言語や表示形式に依存しない知識の実体 | Path、ファイル名 | | Revision | Pageの不変な版、言語、内容参照 | 最新版を指す可変名 | | Document | SHA-256で識別する不変バイト列 | 認可情報 | | Projection | 表示・編集・印刷・検索等の表現 | 別のPage正本 | ## 守る不変条件 - `(domain_uuid, path)` が意味上の住所。名前変更してもPage UUIDを変えない。 - Page UUID、Revision UUID、Document SHA-256は別物。ハッシュを知っていても読めるとは限らない。 - 同じPageを複数箇所で紹介しても、Revision履歴を複製しない。 - 言語はRevisionの属性。通常のPathに `/ja/` と `/en/` を強制しない。 - 閲覧・編集・公開・管理・委譲は別の許可。ログイン成功だけで本文権限を与えない。 - コメント、既読、評価、タスク状態はHTMLへ隠しフィールドとして埋め込まず、型付きメタデータとして持つ。 ## 正本・派生データ・外部コピー 正本の更新と重要なメタデータはトランザクションで確定させます。検索索引、サムネイル、ランキング、通知は派生データとして再構築可能にします。外部メールやRSSの取り込みでは、外部の原本とWikiへの明示的なコピーを区別します。 現在、全書き込みが共通outboxへ接続されているわけではありません。「イベント化すべき」という設計契約を実装済みと読み替えてはいけません。 ## 変更の受け入れ基準 機能ごとに、名前変更、権限失効、再試行、停止・再起動、大きな入力、外部障害を試験します。上限超過時に無制限処理や無認可表示へ切り替えません。通常の閲覧・保存を重いバックグラウンド処理より優先します。