Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming. Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
44 lines
3.0 KiB
Markdown
44 lines
3.0 KiB
Markdown
# 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認可を迂回する点を明示する。
|