# 12. オーガナイザーの共通モデル 状態:設計案。今回は設計のみで、外部アカウント登録や同期を有効にしません。 ## 目的と最初の範囲 Wikiの知識と、予定・タスク・連絡先・受信情報を相互に参照できる入口を作ります。メール、RSS、カレンダーの既存サービスを全て置き換えることは初期目標ではありません。 初期の画面は「今日」「タスク」「予定」「受信情報」「連絡先」を切り替える、薄い集約画面とします。各コレクションの権限で絞り、未読件数すら他者へ漏らさない設計です。共有の通知Inboxと、メール受信箱・RSS未読一覧は別物です。 ## identityの案 | 概念 | 安定したキー | 別途持つ可変情報 | | --- | --- | --- | | collection | ローカルUUID、Domain、所有Principal/共有scope | 表示名・接続先 | | item | ローカルUUID、kind、collection | status、title、version | | Page参照 | Page UUID、参照Domain | 現在のPath・表示URL | | remote binding | connector UUID、remote collection、remote ID | remote href、ETag、checkpoint | | connector | ローカルUUID、provider、owner、許可scope | secret_ref、health、最終成功 | イベント、タスク、メール等を無型の一つのJSON表へ押し込む案は採りません。共通identity・監査を持ち、kind固有の表または厳格schemaを持ちます。Wiki本文が必要なitemだけPage UUIDへ関連付けます。全メールを自動でPageにする必要はありません。 ## 正本を一つ選ぶ コレクションごとに `local_authoritative`、`remote_readonly`、将来の `remote_sync` を区別します。最初はlocalまたは読取専用mirrorです。remoteを正本とする項目の編集は、無断でlocal版を作るのではなく、未対応または明示的なcopyとして扱います。 同期を導入した場合もremote IDとWiki Pathを同一identityにしません。renameはbookmark/DAVのresource identityを再生成する理由になりません。 ## 変更と同期の契約案 変更には期待versionとrequest_idを要求し、item更新・監査・outboxを同一transactionにします。connectorsは小さなbatchで取得し、保存成功後にcheckpointを進めます。再試行は重複排除し、失敗した一件のせいで全件再取り込みしません。 削除はtombstoneとして配送可能な期間を持たせます。画面から消したこと、mirror cacheを削除したこと、外部原本を削除したことを区別します。時計だけのlast-write-winsで予定やタスクを無言で上書きしません。 ## 接続安全性 Domain、Principal、provider、許可host、credential purposeを固定します。リダイレクトとDNS再解決も検証し、無制限の内部ネットワーク取得を防ぎます。秘密はsecret_refだけを設定・ログへ載せます。接続解除はtoken失効、job停止、cache保持・削除の選択を伴います。 ## UI案 一覧はcompact table、詳細はdrawerまたはdialog、設定は歯車。外部由来・最終同期・未送信変更・競合を区別して表示します。オフラインを「空の予定」と扱いません。Wiki保存時は保存先、出典、添付、公開予定の確認を一つの画面で行います。 ## 受け入れ条件と未決事項 rename後もitem identity維持、権限失効で次要求から不可視、二重配送で重複なし、同期停止時の未送信保護、個人設定のDomain越境拒否を必須にします。共通itemを独立Object kindにするか拡張表に留めるかはprototypeで決め、DB migrationはその後です。