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

@@ -0,0 +1,54 @@
# 本番反映:アクティブ通知・タスク一覧・スマホカレンダー
実施日:2026-09-25 JST。最終確認:06:00:52 JST。
## 対象と結果
- Compose `app` / `app2`(`pageswiki` / `pageswiki-ext`)を更新済み。
- アクティブ通知/Web Push、タスクのインライン編集・サブタスク・日割り工程表、スマートフォン向けカレンダーUIを反映。
- アダプタゲートウェイ、code-server、Excalidraw、Kroki関連は更新・再起動していない。
- 新イメージ:`sha256:5e70e0d6789cfa2f558e9d8e3855095709068a023ef939b9bf54fe36846f79dc`
- 旧イメージ:`sha256:2bfab91fe4f8712a25b8e5a6cdb1494b68ccdd9433609b35ce25ae391b98bfe6`
- 旧イメージ保全タグ:`pageswiki-app:rollback-before-active-notifications-20260925`
- app起動:05:59:21 JST。app2起動:05:59:49 JST。両方running・再起動回数0、appのDocker healthはhealthy。
## バックアップと反映手順
全Goテスト成功後、旧イメージに保全タグを付与。稼働中に `docker compose build app` を完了した。
その後2アプリを停止し、DB・WAL・Document Storeを含むdata/data2の停止時点スナップショットをtarへ保存した。外部取り込みカレンダーの本文は調査していない。
- 保存先:`.deployment-backups/20260925-active-notifications-calendar-mobile/`
- `data-and-data2.tar`:12,067,358,720 bytes、2,414 entries。
- ディレクトリ700、アーカイブ600。Compose設定・Dockerfile・.dockerignoreも保全。秘密情報を本記録に転記しない。
- tar作成終了コード0、アーカイブ一覧の読み取り成功を確認。完全なリストア訓練は未実施。
- Git/Docker buildからバックアップが除外されていることを確認。
バックアップ完了後、`docker compose up -d --no-deps --wait --wait-timeout 180 app app2` で再作成。停止を伴う更新であり、無停止デプロイではない。
## 確認結果
- ローカル3000/3001の `/health`:両方200。
- `https://pages.anya.jp/health`、`/`、`/v/plan`:200。
- 匿名の `/v/plan/tasks/schedule`:303、通知Push API:401。認証を迂回していない。
- HTTPS配信した `notifications.js`、`notifications-worker.js`、`calendar.js`、`calendar-mobile.css`、`task-inline.js` のSHA-256が作業ツリーと一致。
- 両DBにnotification_push関連3テーブル、organizer_itemsのparent_uuid/start_on/end_onを確認。
- 両側の `builtin.notification.push` が有効、30秒間隔。`notification.push.deliver` が各3回成功。
- 起動以降の確認区間で、fatal/初期化失敗/scheduler claim失敗/DB lock/失敗ジョブのログ該当件数は両方0。
- Push購読件数は両側0。ジョブの正常実行は確認したが、実端末への配送成功を意味しない。
- バックアップ後の作業ディスク空きは約72GB。今回バックアップの自動削除・期限設定は行っていない。
ユーザの代理ログイン、本番の予定・タスク作成、通知許可の代理操作、外部カレンダーの手動同期は実施していない。認証済みUIの操作検証は合成fixtureで実施済み。
## 利用開始・残確認
通知ベル →「⚙ 通知設定」でブラウザ通知を有効化し、利用者本人が通知許可を与える。選択した音はページ内通知用、背景/閉タブ時の音はOS設定に従う。タスク期限/計画日のリマインダーは個別タスク側でもONにする。
- [ ] Safari/iPhone SE実機:縦横切り替え、キーボード開閉、スクロール、編集操作切り替え。
- [ ] 明示的に購読した実端末:Web Push受信、閉タブ/背景/前面、ログアウト後停止。
## 切り戻し
旧イメージと停止時点のデータを保全している。ただし旧バイナリで新しいサブタスク/工程日を編集すると、新フィールドを失う可能性がある。また旧バイナリは新Pushイベントを処理できない。単純なイメージ差し替えを自動実行せず、原則forward-fixを優先する。
データ復元は反映後の更新を失うため別途確認を得る。復元が必要なら現状態も保存し、全writer停止下でDBとDocument Storeを同じ時点にそろえる。
@@ -0,0 +1,46 @@
# 本番反映:タスク一覧のコンパクトUI
実施日:2026-09-25 06:17 JST。
## 対象
- Compose `app` / `app2`(`pageswiki` / `pageswiki-ext`)を更新。
- PCの1タスク1行表示、共通列見出し、インライン編集、サブタスクの列揃え、スマホのラベル付き入力・44px以上のタッチ領域を反映。
- CSSは `tasks.css?v=7`、JavaScriptは `task-inline.js?v=2`。
- 他のサービスは再作成していない。
## 差分と事前検証
稼働イメージ内と作業ツリーのファイルハッシュを比較。非テストのGoソース、go.mod、go.sum、Dockerfileは一致。static/templatesの差分は次の4ファイルのみ。
- `static/css/tasks.css`
- `static/js/task-inline.js`
- `templates/pages/tasks.gohtml`
- `templates/pages/task_schedule.gohtml`
前段で全Goテスト成功。隔離した合成fixtureを用いたChromiumの1440px、1024px、390px、320px幅検証も成功。列揃え・行高・タッチ領域・子追加・保存競合時のエラー表示と入力保持を確認済み。実機Safariでの検証は別途必要。
## 反映手順と切り戻し
- 旧イメージ:`sha256:5e70e0d6789cfa2f558e9d8e3855095709068a023ef939b9bf54fe36846f79dc`
- 保全タグ:`pageswiki-app:rollback-before-compact-task-ui-20260925`
- 新イメージ:`sha256:e5a7b7877f7c8f8701d0152468b4ee818f9fcb181509f7d223d2c00678c80925`
旧イメージに保全タグを付け、稼働中に `docker compose build app`。その後 `docker compose up -d --no-deps --wait --wait-timeout 180 app app2` で更新した。
UIのみの更新であり、新たなDB migrationはない。data/data2は既存のマウントを保持し、削除・復元・手動編集はしていない。今回、新しいデータ全体バックアップは作成していない。直前の06:00前のデプロイ時バックアップは保全されているが、今回更新時点のスナップショットではない。
切り戻し時は上記の旧イメージを利用して2アプリを再作成する。バックエンドとDBモデルは同一のため、このUI変更の取り消しにデータ復元は不要。データ復元を自動実施しない。
## 稼働確認
- app起動:06:16:47 JST、app2起動:06:17:13 JST。両方running、再起動回数0。
- appのDocker healthはhealthy。app2はDocker healthcheck未設定のため、HTTPで確認。
- ローカル3000/3001と `https://pages.anya.jp/health`:すべて200。
- HTTPSトップページ:200。
- 未認証の `/v/plan/today`、`/v/plan/tasks`、`/v/plan/tasks/schedule`:303。認証制限を維持。
- HTTPS配信のtasks.css / task-inline.jsのSHA-256がローカルと一致。両コンテナの対象4ファイルも一致。
- 06:18:32 JST時点の起動後ログ集計:両方ともpanic/初期化失敗、DBロック/scheduler claim失敗、失敗ジョブの該当件数は0。
- 再作成中の起動待ちで一時的にHTTPS 502を確認したが、起動完了後は200へ回復。無停止更新ではない。
本番ユーザへの代理ログインやタスク作成、外部取り込みカレンダーへのアクセスは行っていない。認証済み操作は合成fixtureで検証し、本番では起動・配信・未認証アクセス制限を確認した。
@@ -0,0 +1,66 @@
# 本番反映:日別計画・親子タスク・Wikiメモ
実施日:2026-09-25 07:07 JST。organizer.tasks 0.7.0。
## 対象と反映内容
Compose `app` / `app2`(`pageswiki` / `pageswiki-ext`)へ反映。
- 持ち越し・明日・任意の日付の計画、期限を変えない再割当て。
- 親子順のcursorページング、フィルタ対象外の親の補足、別日付の子の展開。
- 行内のWikiメモ閲覧・編集、プロジェクト配下への原子的な新規作成とUUID紐づけ。
- 日別画面から作成するカレンダー時間枠の初期日付。
- CSS v8、task-inline v3、tasks v6、task-planning v3。
アダプタゲートウェイ・code-server等の他サービスは再作成していない。
## 事前確認・テスト
稼働イメージとコードをハッシュ比較し、今回の差分がタスク関連バックエンド・UI・拡張バージョンであることを確認。go.mod、go.sum、Dockerfile、migrationは変更なし。
- 全Goテスト成功。
- Chromium fixture(1440/1024/390/320px)の実操作テスト成功。
- 外部取り込みカレンダーへのアクセス、本番ユーザへの代理ログイン、本番タスク/メモのテスト作成は行っていない。
## バックアップと反映
- 旧イメージ:`sha256:e5a7b7877f7c8f8701d0152468b4ee818f9fcb181509f7d223d2c00678c80925`
- 保全タグ:`pageswiki-app:rollback-before-task-daily-notes-20260925`
- 新イメージ:`sha256:911c5d4c425dd759bbdcb15b4a559e4160af09e1d92c7f604bbb057520c94acd`
稼働中に新イメージをビルド。2アプリを停止後、data/data2を同一停止時点でtarへ保存した。
- 保存先:`.deployment-backups/20260925-task-daily-notes/`
- `data-and-data2.tar`:12,068,106,240 bytes、2,426 entries。
- ディレクトリ700、アーカイブと保存したCompose設定等は600。
- tar作成終了コード0、一覧読み取り終了コード0を確認。復元訓練は未実施。
- 07:06:50 JSTバックアップ完了。バックアップ後のディスク空きは約60GB、使用率92%。既存バックアップの削除はしていない。
`docker compose up -d --no-deps --wait --wait-timeout 180 app app2` により更新。appは07:07:02、app2は07:07:30 JST起動。停止を伴うデプロイであり無停止ではない。
## 反映後確認
- 両アプリrunning、再起動回数0。appのDocker healthはhealthy、app2はhealthcheck未設定につきHTTPで確認。
- ローカル3000/3001と本番HTTPSの `/health` は200、HTTPSトップページも200。
- 未認証の今日・明日・持ち越し・日別画面は303、日別一覧APIとWikiメモAPIは401。
- HTTPS配信のCSS・3つのJavaScriptが作業ツリーのSHA-256と一致。
- 両コンテナの変更対象バックエンド・テンプレートのSHA-256も作業ツリーと一致。
- 認証済みの編集・新規作成操作は合成fixtureで確認。本番では疎通・配信・アクセス制限を確認し、利用者データの変更を伴う試験はしていない。
### スケジューラの要フォロー事項
app側で07:07:29および07:09:29 JSTに `event scheduler claim failed: database is locked (SQLITE_BUSY)` を確認。app2では同時区間の該当なし。07:09:55 JST時点では両側の通知配信ジョブが複数回succeededとなり、キュー処理の継続を確認。重大な初期化エラー・panic・renderエラー・失敗ジョブのログは確認区間で0。
今回 `ClaimDueEvent` 自体は変更していない。この処理はdeferred transactionでSELECT後にUPDATEする既存実装であり、並行writerとのロック競合対策を次の品質改善候補として残す。デプロイ作業に含めて未検証のスケジューラ改修や設定変更は行っていない。単発の起動時だけとは断定しない。
- [ ] claim処理の競合を隔離fixtureで再現し、原子的claim/writer予約/限定retryを比較する。本文・外部カレンダーを参照せず、二重実行防止とforeground応答を検証する。
最終確認07:10:47 JST:2度目のロック以降もappで2件(最終07:10:29)、app2で3件(最終07:10:31)の通知配信ジョブが成功。HTTPS healthは200。ロックの再発対策は残件だが、スケジューラが停止した状態ではない。
## 切り戻しの注意
DBスキーマ変更はないが、プロジェクト正本へ `notes_subpath` が追加される。旧バイナリでプロジェクト設定を保存するとこの項目を落とすため、利用開始後はforward-fixを優先する。作成済みメモは通常のWiki Pageで、タスクのpage_uuid紐づけを利用する。
旧イメージは保全済み。データ復元は反映後の更新を失うため自動では実施しない。必要時は現状も保存し、全writer停止下でDBとDocument Storeを同じバックアップ時点へ戻すことについて確認を得る。
残確認:実機Safari/iPhoneでの入力・操作。バックアップ保持期間と空き容量の管理は別途検討する。
@@ -0,0 +1,51 @@
# 本番反映記録:タスク・時間枠・Pomodoro・Today
実施日:2026-09-25 JST(コンテナ起動時刻は2026-09-24 UTC)。
## 対象と結果
- Composeサービス `app` / `app2`(`pageswiki` / `pageswiki-ext`)を更新。
- アダプタゲートウェイ、code-server、Excalidraw、Kroki関連は再起動していない。
- 旧イメージ:`sha256:69d66a1501f88b57f8b570dad488fef2bae3e3a3183b1e5ef9b5faa69c0b54b7`
- 新イメージ:`sha256:2bfab91fe4f8712a25b8e5a6cdb1494b68ccdd9433609b35ce25ae391b98bfe6`
- 旧イメージ保全タグ:`pageswiki-app:rollback-before-task-today-20260925`
- app起動:04:36:10 JST、app2起動:04:36:37 JST。両コンテナの再起動回数0。
## 保全と手順
切り替え前に `go test ./...` が成功。旧イメージをタグで保全し、稼働中に `docker compose build app` を完了。
切り替え時に両アプリを停止してから、dataとdata2を一緒に非圧縮tarへ保存した。DB・WAL・Document Store・その他のファイルを停止中の状態で保全し、予定の内容を調査したり外部カレンダーへ手動接続したりしていない。
- 保存先:プロジェクト直下 `.deployment-backups/20260925-task-today/`
- データ:`data-and-data2.tar`(12,066,856,960 bytes)
- ディレクトリ権限700、アーカイブ権限600。
- Compose設定、Dockerfile、.dockerignoreも同じ保護ディレクトリに保存。設定の秘密を本書へ転記しない。
- バックアップをGitとDockerビルドの対象から除外した。
- tar終了コード正常、アーカイブ一覧を読み取れることを確認(2408 entries)。完全なリストア訓練やDB全件の整合性検査は今回実施していない。
保存後、`docker compose up -d --no-deps --wait --wait-timeout 180 app app2` で更新。停止を伴う反映であり、無停止デプロイではない。
## 本番で確認した項目
- ローカル3000/3001両方の `/health`:200。
- `https://pages.anya.jp/health` と `/`:200。
- 匿名の `/v/plan/today`:303。匿名のToday API:401。認証を迂回しない。
- HTTPSで取得した `task-today.js?v=1` のSHA-256が作業ツリーのファイルと一致。
- 両DBで `organizer_time_blocks` / `organizer_focus` / `organizer_focus_spans`、時間枠のtitle列を確認。
- タスク通知・focus終了イベントの登録を確認(既定60秒)。
- 両インスタンスで `task.activity.publish` / `task.focus.complete` / `task.reminders.deliver` が反映後に各3回成功していることを、ジョブ状態だけで確認。
本番で新規のタスク・予定・集中セッションを作成する書き込み試験や、利用者へのなりすましログインは実施していない。認証済みの操作・PC/モバイル表示は、反映前の隔離Chromiumテストで確認済み。
## 観測した注意事項
メインのイベント取得処理で、04:36:36 JSTにSQLite 517、04:37:36 JSTにSQLITE_BUSYが記録された。スケジューラは次回処理で継続し、04:38台に上記タスクジョブが成功。04:38以降の確認区間ではclaimエラー再発・起動失敗・panicはなし。恒久的に再発しないことを保証する確認ではない。
- [ ] 後続品質改善:`ClaimDueEvent`のread→write昇格時の競合、busy時の限定リトライ、claim待ち時間と失敗率を検証する。今回のデプロイ中にスケジューラの実装や運用設定は変更していない。
## 切り戻しの判断材料
旧イメージと停止時点のデータを保持している。必要時はまず新しい書き込みの有無と旧版のスキーマ/イベント互換性を確認し、切り戻し手順を選ぶ。旧タグを `pageswiki-app` に戻して対象2サービスだけを再作成する方法があるが、今回リハーサルしたものではない。
データの復元は切り替え以降の更新を失うため、自動実施しない。必要な場合は現状態も保全し、利用者の確認を得て、全writer停止下でDBとDocument Storeを一緒に扱う。バックアップの削除・自動期限設定も今回行っていない。
@@ -0,0 +1,42 @@
# 本番修正:chroncalのタスクCalDAV互換性
2026-09-26 JST。organizer.tasks 0.8.1。01:00 JSTにapp/app2へ反映済み、事後確認完了。
## 原因
chroncal 0.10.0はaccount endpointの末尾slashを除去してprincipal探索する。
タスクhomeのslashなし経路はServeMuxの301に入り、Go HTTPクライアントがPROPFINDをGETへ変えて再送し、home GETが405になった。
前回の修正はslash付き経路の正規化循環のみを防ぎ、逆方向の301を防げていなかった。
## 修正
- slashなしhomeも明示登録し、home/collectionをslash有無どちらでも直接処理する。返却hrefは従来canonical URIを維持。
- chroncal/go-webdavの`calendar-data/comp(name=VCALENDAR)/allprop+allcomp`を全件取得として受理。部分選択・expand・time-range制約は従来通り拒否。
- getlastmodifiedを返す。
- chroncalは新規PUTでIf-None-Matchを送らないため、完全な新規identityへの無条件作成のみ許可。既存上書きとアーカイブ復活は無条件では不可。transaction内のhref/UID一意性、ETag/CAS、認可は維持。
- sync-collectionは引き続き未対応。chroncalの405→calendar-queryフォールバックで同期する。差分対応の偽装はしない。
## 検証
- chroncal 0.10.0実行ファイルで、探索・初回取得・作成・完了・Web側変更取得・削除→アーカイブ・無変更再同期を確認。
- CLI試験は一時HOME/XDGディレクトリ・DB・fixture資格情報に限定し、ユーザーの既存chroncal設定やOS keyringを参照しない。
- vdirsyncer/Todoman回帰、slash有無のPROPFIND、部分投影拒否、同時新規作成・無条件上書き拒否を検証。
- 全Goテスト成功。`git diff --check`成功。
- 本番ユーザーのタスクや外部カレンダー本文は取得しない。原因確認時の本番ログは探索メソッドとPathのみを参照。
## 反映
- 対象:app / app2のみ。他のサービスは再作成しない。
- 旧:`sha256:02bb3d66973501804c6cbe3cd5b4ce7f644b148403eae98f88e5d9c837c667e3`
- 保全:`pageswiki-app:rollback-before-chroncal-fix-20260926`
- 新:`sha256:261e24eb1834454a9a47f70ee135269d465b3a4696048890afc492a332e32809`
- コードのみの修正。DBスキーマ・データ形式は0.8.0と同じ。直前の[0.8.0反映時バックアップ](2026-09-26-task-caldav.md)を保持し、追加フルバックアップやデータ復元は行わない。
- 旧イメージへ切り戻すとchroncalの互換不具合は再発するが、0.8.0とのデータ互換性は変わらない。
## 事後確認
- appは01:00:32 JST、app2は01:00:57 JSTに新イメージで起動。両方running、再起動回数0。appのDocker healthはhealthy、独立healthcheckのないapp2は正しいHostで`/health`の200を確認。
- 公開HTTPSでtask home/default collectionそれぞれslash有無のPROPFINDが、リダイレクトなしの401を返すことを確認。認証前の応答として正常であり、実アカウントの内容は取得していない。
- app2も`Host: wiki.extpages.anya.jp`でslashなしhomeのPROPFINDが401、リダイレクトなし。
- 起動後の確認時点では、両コンテナともfatal/DB locked/event job failed/render errorのログ件数は0。過去の障害全般の解消を意味するものではない。
- 認証付きの探索と変更操作は前述の隔離fixtureで検証。本番資格情報の再発行やクライアント設定の削除は不要。
@@ -0,0 +1,50 @@
# 本番反映:予定・タスク共通CalDAV
2026-09-26 JST。`organizer.tasks 0.9.0`/`organizer.calendar 0.2.0`。01:33 JSTにapp/app2へ反映完了、事後確認済み。
## 変更
[共通CalDAV設計](../../design/ja/caldav-common.md)を参照。
- `/_/api/v1/caldav/`で共通principalと許可されたVEVENT/VTODO collectionを探索。
- 予定/タスク/両方のscope付き専用認証情報、共通管理API、両画面の⇄設定UI。
- 旧タスクURL/資格情報を維持。旧資格情報に予定の権限を追加しない。
- CLI filenameとUIDの分離、manifestへの永続化、上限付き完全snapshot、Webビューアのfilename解決。
- DBは`organizer_dav_scopes`と資格情報削除時のscope削除triggerを追加。既存テーブルの破壊的変更なし。
- 既存カレンダー正本の一括書換え・外部ソースの手動同期は行わない。
## 検証
- 全Goテスト成功。
- 実chroncal 0.10.0:共通探索、予定作成/CLI更新/Web更新取得/削除、タスク双方向同期。
- vdirsyncer/Todomanの既存タスク回帰。
- 認証scope、read-only、失効、停止、拡張無効化、ACL取消、同時作成、索引再構築、取得上限。
- Chromium:カレンダー既存操作とCLI filenameの表示、共通設定UI、タスク4画面サイズ(1440/1024/390/320)、資格情報発行/失効/閉じた後の秘密値消去。
- JS構文チェック、git diff --check成功。
- 試験は隔離fixtureと一時HOME/XDG/ブラウザprofileのみ。本番の予定・タスク本文を利用しない。
## 反映とバックアップ
- 対象サービスはapp/app2のみ。
- 旧image:`sha256:261e24eb1834454a9a47f70ee135269d465b3a4696048890afc492a332e32809`
- 保全tag:`pageswiki-app:rollback-before-common-caldav-20260926`
- 直前の停止時DB・カレンダー正本コピーを`.deployment-backups/20260926-common-caldav/`へ保存する。内容を出力・解析せず、復元は行わない。
- 他の正本を含む[0.8.0時点の全体バックアップ](2026-09-26-task-caldav.md)も保持。今回の部分コピーを全体バックアップと取り違えない。
- 新image:`sha256:701a97f47a8cfc8989777f06a168257116bb5b057bb574db490802e3889ae988`
- 01:32:38 JSTに停止時コピー完了。約5.8 GiB。保存先dir700、DB600、カレンダー正本はgroup/other権限を除去。復元訓練は未実施。
## 事後確認
- appは01:32:42 JST、app2は01:33:11 JSTに新imageで起動。両方running、再起動0。appはDocker health healthy。
- 公開HTTPS `/health`とapp2の正しいHost `wiki.extpages.anya.jp`でのhealthは200。
- 共通homeと旧task homeのslash有無、およびtask default collectionはPROPFINDにリダイレクトなしの401を返す。app2の共通homeも同様。これは資格情報なしの正常な認証要求。
- 公開配信の`task-dav-settings.js`、`calendar.js`、`dav-settings.css`のSHA-256が検証したローカルファイルと一致。
- 両DBのsqlite_masterで新scope表と削除triggerの存在のみ確認。資格情報や本文の値は取得しない。
- 起動後の確認範囲で両インスタンスともfatal、DB locked、event job failed、render errorは0件。
- 認証付きの探索・更新は隔離fixtureでの検証。本番データを試験作成/変更したり、外部取り込みカレンダー本文を取得したりしていない。
## 切り戻し注意
予定/共通用秘密値のprefixは旧バイナリでは認証不可。旧タスク専用資格情報は継続利用可能。
CLIで作った予定のfilename対応は新manifest項目`dav_names`にある。旧バイナリはこれを保持できないため、**反映後にCLIで予定を作成した場合、旧版へ戻してカレンダーを編集しない**。緊急時はカレンダー拡張を無効化して修正版へ進むことを優先する。過去データへの復元は更新喪失を伴う別操作であり、自動実行しない。
@@ -0,0 +1,56 @@
# 本番反映:タスクCalDAV/CLI連携
実施日:2026-09-26 JST。organizer.tasks 0.8.0。
状態:2026-09-26 00:24 JST、本番反映完了。
## 対象
Compose `app` / `app2`(`pageswiki` / `pageswiki-ext`)。
タスク専用VTODOコレクション、専用資格情報UI/API、条件付き更新・アーカイブ同期。
アダプタなど他サービスの再作成は行わない。
## 事前確認
- 稼働中イメージのソース・静的ファイル・テンプレートとローカルをSHA-256比較。差分は今回のタスクCalDAV関連15ファイルのみ。go.mod、go.sum、Dockerfile変更なし。
- 全Goテスト成功。最初の実行はサンドボックスのlisten制限で中断し、権限を切り替えた再実行で成功。
- vdirsyncer/Todomanの実CLI同期試験、Chromiumの1440/1024/390/320px試験を隔離fixtureで再実行し成功。
- 本番ユーザーの代理ログイン、タスク作成、外部取り込みカレンダーの内容参照は実施しない。
## イメージとバックアップ
- 旧イメージ:`sha256:911c5d4c425dd759bbdcb15b4a559e4160af09e1d92c7f604bbb057520c94acd`
- 旧イメージ保全タグ:`pageswiki-app:rollback-before-task-caldav-20260926`
- 最終イメージ:`sha256:02bb3d66973501804c6cbe3cd5b4ce7f644b148403eae98f88e5d9c837c667e3`
- 初回反映イメージ(下記修正前):`sha256:0e838cfcf410b1d5dcdff9b8985b301be3e6478ba0c434c18d4b7cb6a9c5cc39`
- 停止時バックアップ:`.deployment-backups/20260926-task-caldav/data-and-data2.tar`
- 保存ディレクトリ700、tarと設定コピー600。バックアップ失敗時は旧コンテナを再起動する手順。
- 00:20:29 JSTバックアップ完了。12,081,100,800 bytes、2,426 entries。tar作成と一覧読み取りの終了コード0。復元訓練は未実施。
- バックアップ後の空き約49GB、使用率93%。既存バックアップは削除していない。保持期間・容量管理は残課題。
## 本番確認で発見・修正した問題
初回起動後、共通`NormalizePath`がCalDAV collectionの末尾スラッシュを除去し、ServeMuxが付け直す301循環を確認した。初回CLI fixtureは認証とmuxのみを通っており、この共通middlewareを検証できていなかった。
`/_/api/v1/caldav/`配下では末尾スラッシュを保持するよう修正。通常Wiki Pathの正規化は変更しない。GET/OPTIONS/PROPFIND/REPORTの回帰テストを追加し、実CLI試験も本番と同じ`Server.handler()`全体を通す方式へ変更した。これにより既存予定CalDAVのcollectionも循環しなくなる。
修正後、全Goテストと実CLI試験を再実行して成功。再ビルド・再反映し、appは00:23:42、app2は00:24:09 JSTに起動。コードのみの再反映でデータ復元は行っていない。
## 切り戻しの注意
起動時に`organizer_dav_resources`と`organizer_dav_credentials`を追加し、既存タスクのDAV索引を登録する。
CLI由来の同期ID・リソース名・ICSメタデータは正本TaskRecordの`caldav`に保存する。
旧バイナリで新形式のタスクを更新するとこのフィールドが失われうるため、利用開始後はforward-fixを優先する。
緊急時はまず`organizer.tasks`無効化で当該機能を停止する。旧イメージへの切り戻し時はこの互換性制約を考慮する。
DBとCASを復元する場合は反映後の更新が失われるため、自動復元せず、現状の追加バックアップと確認を経て全writer停止下で行う。
## 事後確認
- 両インスタンスが最終イメージでrunning、再起動回数0。appはDocker healthがhealthy。app2には独立healthcheckがないためHTTPで確認。
- ローカル3000/3001と`https://pages.anya.jp/health`は200。
- 本番HTTPSのタスクDAV home/collectionは未認証401。PROPFINDも401、`WWW-Authenticate: Basic realm="PagesWiki task CalDAV", charset="UTF-8"`。循環リダイレクト解消。
- 資格情報管理APIは未認証401、タスク画面はログインへの303。
- 新JSとCSSのHTTPS配信SHA-256はローカルと一致。両コンテナのDAVコード・テンプレート・正規化修正も一致。
- 両DBはread-onlyでsqlite_masterのみを調べ、追加する2テーブルの存在を確認。外部カレンダー内容は参照していない。
- app2に`Host: pages.anya.jp`を渡した際の404は配置外ホストのため。実際の配置先`wiki.extpages.anya.jp`ではhealth 200、DAVと資格情報API 401、タスク画面303を確認。
- 00:25:10 JST時点の再起動後ログ集計では、両側ともfatal/panic、DB locked、失敗ジョブ、renderエラーは0件。これは当該観測区間の結果で、過去に記録したスケジューラの競合課題を解決したという意味ではない。
- 本番のユーザー代理ログインや資格情報発行、タスク変更は行わない。認証後の操作は隔離した本番同等handlerの実CLI fixtureで確認。
@@ -0,0 +1,35 @@
# 本番反映:既定タスクリストの名前変更
2026-09-27、`organizer.tasks 0.11.1`。[仕様・検証](../../design/ja/task-dav-default-list-name.md)。利用者の本番反映依頼に基づき、app/app2のみ更新した。
## 変更
既定リスト`/_/api/v1/caldav/tasks/default/`のDAV:displaynameをPROPPATCHで変更できる。個人・domain別の設定として保存し、共通home/task home/リスト自身の探索結果へ反映する。タスクの所属、UID、本文、revisionは変えない。実際の表示名は利用者がクライアントから設定するため、本作業では変更しなかった。
## イメージと保全
- 旧image:`sha256:2f0400639d6a6263292431bba160d2ede457743db6361c8b4ad677395eb5eaf1`
- 旧image保全tag:`pageswiki-app:rollback-before-default-list-name-20260927`
- 新image:`sha256:3ee1b6b5ff24154c05990f02f112db7052b5a9bfb9894e5e9020a55fbb539d8c`
- `docker compose build app app2`成功。直前の名前変更・認可・原子性テスト成功。全Go/実CLI同期試験は実装時に成功済み。
- 両app停止後、DBと存在するWAL/SHMを`.deployment-backups/20260927-default-task-list-name/`へコピーし、cmpで一致を確認。ディレクトリ700、ファイル600、合計5.8 GiB。
- 正本全体のバックアップではなく停止時DBの保全。今回の新規表は個人設定用の`organizer_dav_default_lists`。
- `docker compose up -d --no-deps app app2`で反映。他のサービス・過去backup/imageは変更・削除していない。
## 反映確認
- appは**12:51:13 JST**、app2は**12:51:41 JST**に新imageで起動。両方running/再起動0。appのDocker healthはhealthy。
- 公開HTTPS health、app2の正しいHostでのhealthは200。
- 両方で未認証PROPPATCHは401。認証情報やタスク本文は取得せず、認証済みの名前変更要求も本番には送っていない。
- 両DBに設定表が存在し、保存名は確認時点で0件。既存タスクや設定名を勝手に変更していない。
- appはプロジェクト3件、タスク5件、revision25件、リスト対応3件で更新前後一致。app2は全て0件で一致。
- 両コンテナ内の名前変更handler/設定store/DAV handler/共通home/schema/拡張registryの6ファイルのSHA-256がローカルと一致。
- 起動後の確認範囲で、event job failed/fatal・panic/database locked/render errorは両方0。以前記録したscheduler claimの競合TODOを解決したという意味ではない。
## 利用者確認・運用上の残件
Tasks.org側で既定リストの名前変更を再試行する。名前変更・別端末への反映の実機確認は利用者待ち。色・アイコン・通常プロジェクトのPROPPATCHは今回の対象外。
作業後のディスクは空き約18 GiB、使用率98%。過去のbackup/imageは削除しておらず、今後の大きな更新前に容量整理が必要。
切戻し用imageは保全済み。旧0.11.0では保存名を利用せず既定表示名へ戻るが、追加表は残る。新しい編集を消すDBの無断復元は行わない。
@@ -0,0 +1,52 @@
# 本番反映:OneTask向けCalDAV接続判定互換
2026-09-27 10:01 JST。app/app2へ反映済み、事後確認完了。
## 追記:10:16〜10:17 JST 接続診断ログ
- 利用者からOneCalendarで追加成功、その後OneTaskでも追加成功との報告。OneTaskでの同期・更新の実機確認は別途必要。成功に至った順序の因果関係は未確定。
- CalDAVのアクセスログに応答ステータス、認証方式・結果の固定分類、マスクされた対象種別、request IDを追加。秘密値・本文・実リソース名は記録しない。認証条件・ACL・DBスキーマは変更していない。
- 旧image:`sha256:62006f4e7d720b7e0aeeb40cbfb10aab8dc6022d58836cc886404bab4fb4f0e5`、保全tag:`pageswiki-app:rollback-before-dav-diagnostics-20260927`。
- 新image:`sha256:71999001d598732a6e4fa05b8cc4b8d3dc3158679cbaa43895d81bc0390c63f8`。
- 全Goテスト、秘匿性を含む診断ログ単体テスト、隔離chroncalのタスク/共通CalDAV実機CLI回帰試験成功。
- app起動10:16:49、app2起動10:17:16 JST。両方running、再起動0、app healthy。両方のhealth200、未認証OPTIONS401を確認。
- 10:17:27に認証済み共通入口PROPFIND207を観測。MKCALENDARは404で未対応(既存タスクの追加・更新とは別)。アプリ種別はログに含めないため、要求元アプリは断定しない。
- DB・正本への追加変更がないため新規の大容量DBコピーは作らず、同日10:01のバックアップを保持。旧imageへの切戻しで診断ログ追加のみ撤回可能。
## 背景
利用者が再試行しても同じcalendar-accessエラーとなった原因を確認したところ、本番両インスタンスは共通CalDAV初版imageのままだった。前回は実装・隔離試験までで本番反映を行っていなかった。今回は依頼済みの本番展開まで完了させる。
## 変更・互換性
[設計と制限](../../design/ja/caldav-onetask-compatibility.md)を参照。資格情報発行時にOneTask互換モードを明示ONにした場合のみ、`DAV: 1, calendar-access`を返す。既存資格情報を勝手に変更しない。完全なRFC準拠を意味する実装ではなく、OPTIONS接続判定の互換設定。未対応データは引き続き拒否する。
本番反映だけでは既存の資格情報の応答は変わらない。利用者は⇄から互換ONの新規資格情報を発行し、OneTaskの接続情報を更新する。掲載されてしまった旧秘密値は失効・再発行を推奨し、作業者はその値を使用しない。
## 検証
- 前回実装時:OPTIONS gateと後続DAV CRUD・認可試験、chroncal/vdirsyncer回帰、カレンダーとタスク4画面幅のChromium試験成功。
- 反映直前に全Goテスト、git diff --check、JS構文チェックを再実行して成功。
- OneTask実機でのアカウント追加・同期完了は未確認。未観測の後続要求には追加対応が必要な可能性がある。
- 本番の認証情報・予定・タスク・外部カレンダー本文を動作試験に使用しない。
## イメージとバックアップ
- 旧:`sha256:701a97f47a8cfc8989777f06a168257116bb5b057bb574db490802e3889ae988`
- 旧image保全:`pageswiki-app:rollback-before-onetask-20260927`
- 新:`sha256:62006f4e7d720b7e0aeeb40cbfb10aab8dc6022d58836cc886404bab4fb4f0e5`
- app/app2だけを停止・更新。他のサービスは変更しない。
- 停止時DBコピー:`.deployment-backups/20260927-onetask/`。directory700、DB600。DB表`organizer_dav_compat`と削除triggerの追加のみで、既存カレンダー正本の書換えは行わない。
- 10:01:12 JSTに約5.8 GiBのコピー完了。
- このコピーはDBのみであり、全体バックアップではない。復元は未実施。
- 旧imageへ戻す場合は互換設定が無視され、今回のエラーは再発する。DBの破壊的な巻戻しは不要。
## 事後確認
- appは10:01:14 JST、app2は10:01:42 JSTに新imageで起動。両方running、再起動0。appはDocker health healthy。
- 公開HTTPSのhealthと、app2の正しいHost `wiki.extpages.anya.jp`でのhealthが200。
- 公開JS/CSSのSHA-256がローカルの互換モード実装と一致。両コンテナ内の`dav_capabilities.go`もローカルと一致。
- 両DBのsqlite_masterから追加表・triggerの存在のみ確認。資格情報の値は取得していない。
- 共通入口のslash有無で未認証OPTIONSは401、リダイレクトなし。認証付きの互換宣言は隔離試験で検証済みだが、本番の既存資格情報での試験はしていない。
- 起動後の確認範囲ではfatal・DB locked・event job failed・render errorはいずれも0。
- 利用者による互換ONの新規資格情報発行とOneTask実機確認が必要。
@@ -0,0 +1,35 @@
# 本番反映:OneTaskのVTODOリスト作成
2026-09-27、`organizer.tasks 0.10.0`。[詳細設計](../../design/ja/caldav-task-lists.md)。
## 対象と変更
OneTaskの`SyncTaskListsSend`が発行するMKCALENDARに201を返し、そのURIを独立したタスクリストとして保存・探索・同期する。固定リストへの単純aliasにはしない。リストは既存の版付きプロジェクトに対応付ける。認証・scope・ETag・所有者分離・拡張無効化を維持する。
app/app2のみ反映。外部カレンダー本文や本番資格情報を試験に使わない。新規作成後のOneTask実機同期成功は利用者確認待ち。
## 検証
- 全Goテスト成功。
- OneTaskの提示XML形状で201→PROPFIND→PUT→REPORT/GET→更新→DELETEの隔離試験成功。
- 不正XML、未対応property/component、並行再作成、権限、既存VEVENT URIとの衝突、リスト分離、索引再構築、Webでの所属変更を検証。
- chroncalの固定・共通・名前付きリストの同期、vdirsyncer/Todoman回帰成功。
- タスク/カレンダーのChromium回帰成功。
## 保全と切戻し
- 反映前image:`sha256:71999001d598732a6e4fa05b8cc4b8d3dc3158679cbaa43895d81bc0390c63f8`
- 保全tag:`pageswiki-app:rollback-before-task-lists-20260927`
- 反映image:`sha256:86dfde6d962227cf1e653e3ad5b955847a124f570079fb04a06ae0e5a8373ce5`
- 両appを停止した上でDB/WAL/SHMを`.deployment-backups/20260927-task-lists/`へコピー。ディレクトリ700、ファイル600。これはDBの保全であり正本全体のバックアップではない。移行自体は表追加・索引登録のみで正本文書を書き換えない。
- 名前付きリスト作成後の切戻しでは先にタスク拡張を停止する。旧バイナリで該当プロジェクトを編集すると未知のdav_collectionが失われ得る。新規タスクを消すようなDB復元は別途承認なしで行わない。
## 反映後確認
- 2026-09-27 10:44:50 JSTにapp、10:45:17 JSTにapp2が新imageで起動。両方running、再起動0。appのDocker healthはhealthy。
- 公開HTTPSのhealthとapp2の正しいHostでのhealthは200。未認証共通DAV OPTIONSは401で認証制限を維持。
- 両DBのsqlite_masterからorganizer_dav_collections表の存在を確認(タスク・予定データは取得しない)。
- 両コンテナ内のtask_dav_collections.goのSHA-256がローカルと一致。
- 反映後の確認範囲でfatal、DB locked、event job failed、render errorは0。
- 停止時DBコピーは5.8 GiB。復元は実施していない。
- 利用者へ、アカウント再作成なしでOneTaskの再同期を依頼。OneTask実機の最終成功は未確認。
@@ -0,0 +1,53 @@
# 本番反映:タスク所属統一と上書き同期
2026-09-27、`organizer.tasks 0.11.0`。[設計と次段階TODO](../../design/ja/task-dav-project-unification.md)。利用者が端末側の未送信変更を保全したことを確認し、本番反映の依頼を受けて実施。
## 反映対象
- app/app2のみ更新。他の連携アダプタ等は更新していない。
- 既定リストはプロジェクトなしに限定し、通常Webプロジェクトも個別のCalDAVリストとして公開。既存MKCALENDARリストのURLは維持。
- 条件なしPUT/DELETEはトークン別設定なしで受理。版履歴とDB transactionは維持。明示ETagの不一致は412。
- 競合通知・採否選択は未実装で、次段階TODO。
## ビルド・保全
- 旧image:`sha256:86dfde6d962227cf1e653e3ad5b955847a124f570079fb04a06ae0e5a8373ce5`
- 旧image保全tag:`pageswiki-app:rollback-before-task-unification-20260927`
- 新image:`sha256:2f0400639d6a6263292431bba160d2ede457743db6361c8b4ad677395eb5eaf1`
- 稼働中に`docker compose build app app2`を完了後、両appを停止。DBと存在するWAL/SHMを`.deployment-backups/20260927-task-unification/`のdata/data2へコピーし、`cmp`で一致を確認。ディレクトリ700、ファイル600。
- コピーサイズ5.8 GiB。正本全体のバックアップではなく、停止時DBの保全。今回の移行は索引・移行メタデータの変更であり、タスク本文・版を変更しない。
- `docker compose up -d --no-deps app app2`で反映。
- 作業後ディスク空き約24 GiB、使用率97%。旧image/過去backupは削除していない。容量整理は別途必要。
## 起動・確認
- app:2026-09-27 **12:18:23 JST**に新imageで起動。running、healthy、再起動0。
- app2:同日 **12:18:48 JST**に新imageで起動。running、再起動0(個別Docker healthcheckなし)。
- 公開`https://pages.anya.jp/health`、app2の正しいHostでのhealthは200。
- 未認証の共通CalDAV OPTIONS、新しいプロジェクトリストURI、app2のCalDAVは401。認証を迂回しない。
- 両コンテナの`internal/store/task_dav.go`、`internal/server/task_dav.go`、`internal/extensions/registry.go`のSHA-256はローカルと一致。
- 移行後のルーティング対応漏れ・不一致はいずれのDBも0。
本文を取得しない集計結果:
| 項目 | app 更新前 → 更新後 | app2 更新前 → 更新後 |
| --- | --- | --- |
| プロジェクト数 | 3 → 3 | 0 → 0 |
| CalDAVリスト対応数 | 1 → 3 | 0 → 0 |
| タスク数 | 5 → 5 | 0 → 0 |
| リビジョン数 | 25 → 25 | 0 → 0 |
| 旧hrefの移行記録数(更新後) | 4 | 0 |
外部取り込みカレンダー・本番タスクの本文や資格情報は取得せず、認証済みDAVを実データへ発行していない。書き込み動作は前段の隔離テストで検証済み。Tasks.org Desktop実機の再探索・同期は利用者確認待ち。
## 観測した警告・後続作業
主インスタンスで`event scheduler claim failed: database is locked`が確認時点で5件(03:18:47、03:19:47、03:20:47 UTCの観測)発生。副インスタンスでは未検出。ジョブ実行失敗・fatal・render errorは確認範囲で0。更新後に開始されたジョブの状態集計は主24件・副21件がsucceededで、処理停止は確認していない。**警告を解消したとは扱わない。**
TODO:`Store.ClaimDueEvent`のdeferred transactionでSELECT後にUPDATEする箇所の書き込み競合を調査する。writer取得・原子的claim・上限付きretryを比較し、二重claimしない隔離並行試験とともに別変更で是正する。今回の移行と因果関係があるとは断定しない。
## 再同期と切戻しの注意
端末でリストを再探索し、通常Webプロジェクトの新しいリストを同期対象へ追加する。既定リストPagesWiki Tasksは「プロジェクトなし」のみ。古いURLへの未送信書き込みで409 `task_collection_relocated`になった場合は、新しい所属リストを確認して保全済みの変更を反映する。アカウント削除やローカルデータ消去は行っていない。
旧版へ戻すと通常プロジェクトが既定リストへ再混在するため、緊急切戻しはまずタスク拡張を停止して判断する。旧DBコピーを無断で戻して反映後の新しい編集を消さない。