Implement Knowledge City platform, organizer and DAV integration

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.
This commit is contained in:
Anya Tokugawa committed 2026-09-27 14:44:43 +09:00
1 parent 288e6e94ac
commit c1175d389f
699 files changed
+110197 -4117

No files matched your search

+36
View File
@@ -0,0 +1,36 @@
# 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へ接続されているわけではありません。「イベント化すべき」という設計契約を実装済みと読み替えてはいけません。
## 変更の受け入れ基準
機能ごとに、名前変更、権限失効、再試行、停止・再起動、大きな入力、外部障害を試験します。上限超過時に無制限処理や無認可表示へ切り替えません。通常の閲覧・保存を重いバックグラウンド処理より優先します。