# 2. アドレス・保存・アセット 状態:基本モデルとローカル保存は実装済み。外部保存・保持管理の一部はTODO。 ## アドレス表 | 内部指定 | 意味 | HTTP上の主な入口 | | --- | --- | --- | | `path:/manual/start` | ドメイン内の可変な住所 | `/manual/start` | | `uuid:…` | Page/Objectの安定ID | `/o/uuid:…` | | `rev:…` | 特定の不変Revision | `/r/view/…`、`/v/raw/rev:…` | | `sha256:…` | 不変Document | `/_/obj/sha256:…` | | `asset:image:logo` | ドメイン内の編集用HEAD | 管理者向け `/v/raw/asset:image:logo` | 通常エディタの正規入口は `/e/-/{path}`。従来の `/e/{path}` は互換入口です。生データは `/v/raw/path:/…` 等を使い、通常Pathと紛らわしい `/raw/` を増設しません。別ドメインへのリンクは宛先FQDNを含む絶対URLです。 ## 保存トランザクション 1. 言語・MIME・保存対象と現在の書き込み権限を検証する。 2. 内容のSHA-256を計算し、`documents/sha256/` に不変Documentを永続化する。 3. Page、Revision、必要なPathと依存参照を確定する。 4. 派生処理へ通知する。共通outboxの全書き込み接続は後続課題。 Documentを先に書くため、DBのrollbackで未参照blobが残る可能性はあります。逆に、DBだけ確定して正本バイト列が存在しない状態は許しません。SQLiteのbody列は移行互換用で、Document Storeと二つの正本を作りません。 ## アセットの可変HEADと固定参照 Asset名は `(domain_uuid, asset address)` で一意です。HEAD変更は旧Documentを上書きしません。HTML保存時に `asset:` を解決し、表示用参照をSHA-256へ固定します。編集用の由来は別属性で残し、次回保存時にHEADを再解決します。 `revision_document_refs` が依存Documentを記録します。過去Revisionの閲覧で最新HEADへ追従しないことが再現性の条件です。CLIと管理画面ではHEADを扱えますが、公開ページの依存物を自動公開する根拠にはなりません。 ## 認可・条件付き操作 ハッシュURLは現在のDomainで読めるPageや許可された管理操作との関係を検証します。ETagと `X-PagesWiki-Object-UUID`、`X-PagesWiki-Revision-UUID`、`X-PagesWiki-Document-SHA256` は識別情報であり資格情報ではありません。 Asset更新は条件付き更新を使います。ただし同じ内容でMIME等だけ変わる競合には、HEADハッシュとは別の状態versionを導入する設計が必要です。 ## TODO - 保持期限・削除プレビュー・export中の保護を統合したDocument GC。 - Assetの状態version、共通監査outbox、依存関係込みの公開レビュー。 - 大容量復元のストリーミング、外部Document backend、破損検出とread-repair。 - CLIの全書き込みとWebの正本保存契約の統一。CLIは現在も信頼されたローカル管理経路で、HTTP認可を迂回する点を明示する。