Files
pages/docs/design/ja/calendar-contacts.md
T
Anya Tokugawa 19e12f96a8
Build and publish container images / images (push) Successful in 13m39s
Release container images / release (push) Successful in 18s
Add private CardDAV synchronization and contact revision recovery
2026-11-02 08:41:15 +09:00

4.5 KiB
Raw Blame History

14. 予定・iCalendar・CalDAV・連絡先

状態:カレンダー部分は2026-09-22にローカル正本・Plan UI・限定CalDAVを実装開始。最新の契約・実装範囲・残作業は カレンダー詳細設計 を参照。2026-11-01に個人アドレス帳のCRUD・vCard入出力・neomutt検索、2026-11-02に個人CardDAV提供・履歴復元・一括exportを実装した。個人アドレス帳の実装契約とCardDAV運用を以下の旧URI案より優先する。共有アドレス帳と外部CardDAV connectorは引き続き設計案。

四つのレイヤー

レイヤー 役割 PagesWikiでの扱い案
Wiki URL 人が開く説明・知識への入口 rename可能なPage Path
iCalendar 予定・タスク等の交換形式 export/import、UIDと元データを保持
CalDAV カレンダー資源を扱うWebDAV拡張 remote connector、将来の提供面
CardDAV / vCard 連絡先の通信 / データ形式 個人・共有address book

iCalendarとCalDAVは同義ではなく、.icsを配信するだけでCalDAVサーバーにはなりません。vCardとCardDAVも区別します。RFC 5545、RFC 4791、RFC 6350、RFC 6352。

identity対応案

local item UUID、calendar UID、remote href、Wiki Page UUIDを対応表に持ちます。Wiki renameでUIDを変更しません。remote href変更は移動・再取得として確認し、同じ題名だけで統合しません。ローカル生成UIDはDomain名変更でも維持します。

予定はevent、タスクはtodo、連絡先はcontactの型付き状態です。説明用Pageは任意の参照であり、毎回ICS/vCardをHTMLへ変換して正本を置換しません。原形式のDocument snapshotを保持し、未対応propertyの欠落を検出します。

予定のモデル案

開始・終了、終日フラグ、timezone/TZID、繰り返しrule、例外、参加者、状態、source versionを分離します。終日をUTCの時刻に変換せず、時間帯なしの時刻も区別します。無限recurrenceは画面の対象期間内だけ展開し、件数上限を持ちます。

例外instanceのキーは元seriesとrecurrence identityです。単発の変更・series全体の変更をUIで分けます。参加依頼、回答、メール送信などのschedulingは単純な予定保存とは別の後続機能です。

同期と競合

connectorはremote ETagとlocal versionを別々に持ち、更新前の値で条件付き操作します。ETagをDocument SHA-256と仮定しません。対応サーバーではcollection sync-tokenを利用する案ですが、無効なtokenからの再同期と未対応時のboundedな全量照合も必要です。WebDAV同期仕様。

通信失敗では外部削除と見なさず、tombstoneは確認できた削除だけです。両側で変更された場合はbase/local/remoteを比較し、内容を保存した競合状態へ移します。勝手な最新版上書きはしません。

連絡先

address bookの所有者・共有範囲、contact UUID、remote UID、複数メール/電話、名称、所属、写真の固定参照を持ちます。人物Principalとcontactは別です。メール一致だけでユーザーへ自動連結しません。重複候補を示し、mergeは変更前をexportできる確認操作にします。

URL/API案と実装順

旧案の /v/organizer ではなく、連絡先の実装は /v/plan/contacts、APIは /_/api/v1/extension/organizer.contacts/、CardDAV提供面は /_/api/v1/carddav/ を使います。Wiki PathをそのままDAV collectionにしません。以下の順序案のうち、個人アドレス帳と限定DAV提供は実装済み、共有と外部connectorは後続です。

  1. ICS/vCard fixture、入出力preview、警告、重複防止。
  2. local calendar/agenda・連絡先一覧、権限・version試験。
  3. 選定サーバーに対するread-only connector。
  4. 限定された双方向同期、最後に必要性が確認できたDAV提供。

CAL-1:終日・夏時間・例外。CAL-2:UID/href/Path変更。CAL-3:412競合・token失効。CARD-1:複数propertyと未知項目。DAV-1:権限失効・大量collection・app token失効。これらを完了条件にします。