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.
32 lines
3.4 KiB
Markdown
32 lines
3.4 KiB
Markdown
# 既定タスクリストの表示名変更
|
||
|
||
2026-09-27、`organizer.tasks 0.11.1`。**12:51 JSTに本番app/app2へ反映済み。** [反映記録](../../operations/deployments/2026-09-27-default-task-list-name.md)。Tasks.org実機の再試行は利用者確認待ち。
|
||
|
||
## 原因
|
||
|
||
利用者が既定リスト名を変更するとエラーになると報告。本番の秘匿済みログでは03:39:59 UTCに`PROPPATCH target=task_collection status=405`、認証結果は`basic_accepted`。0.11.0ではリストのPROPPATCHが未実装で、既定名`PagesWiki Tasks`も固定値だった。認証不良や名前の衝突ではない。
|
||
|
||
## 変更契約
|
||
|
||
- `PROPPATCH /_/api/v1/caldav/tasks/default/`のDAV:displaynameのsetを受理。末尾slashなしも同じリスト。
|
||
- 表示名は`organizer_dav_default_lists`にdomain/owner単位で保存する個人設定。未設定なら従来の`PagesWiki Tasks`。トークンを交換しても同じ利用者の設定を使用する。
|
||
- URLやプロジェクトなしという所属の意味は変更しない。架空のプロジェクトは作らない。タスク本文、UID、revision、ETagは変わらない。
|
||
- 共通CalDAV home、旧task home、既定リスト自身のPROPFINDで同じ保存名を返す。索引再構築でも設定を失わない。
|
||
- UTF-8で1〜300 bytes、空白だけや制御文字は拒否。XMLテキストとしてescapeして返す。名前をアクセスログへ追加しない。
|
||
|
||
## PROPPATCHと認可
|
||
|
||
[RFC 4918 §9.2](https://www.rfc-editor.org/rfc/rfc4918.html#section-9.2)の原子的更新・Multi-Statusに従う。全命令を検証後に保存し、正常時は207/property status 200。未対応propertyやremoveは403、無効な名前は409、同じ要求のその他の正常propertyは424で、部分更新しない。複数setは順序どおり解釈する。不正XML・DTD・過大なXMLの制限には共通DAV parserを用いる。
|
||
|
||
認証、tasks/all scope、write権限を必要とする。保存transaction内でwriterを取得してから現在のmembership/principal/トークンの失効・期限・scope/拡張の有効状態を再確認する。別domain/ownerへの設定変更はできない。
|
||
|
||
## 範囲と残件
|
||
|
||
今回の対象は既定タスクリストの名前のみ。通常プロジェクト/MKCALENDARリストのPROPPATCH、色・アイコン・任意dead property、リストDELETEは引き続き未実装。プロジェクトの名称はWebのプロジェクト編集で変更可能。Tasks.orgのupdateCollectionはdisplaynameを個別要求し、その後必要に応じて色・アイコンの別要求を送るため、それらの未対応応答は名前変更の成功とは分けて扱う。
|
||
|
||
## 検証
|
||
|
||
隔離HTTPテストで、日本語・XML特殊文字の名前、3箇所の探索結果、ETag/本文の不変、プロジェクトが増えないこと、schema再実行後の永続性、OPTIONSのPROPPATCH広告、malformed XML/不正名/未対応property混在の原子性を確認。他owner、別domain、readonly、calendar-only、匿名、失効トークン、拡張無効化も検証する。本番の既定名は変更しておらず、実機の再試行は反映後に必要。
|
||
|
||
実施結果:全Goテスト成功。chroncalの既定・共通・名前付き・通常Webプロジェクトの同期試験、vdirsyncer/Todoman試験も成功。追加の名前変更・認可・原子性テストは5回反復成功。
|