From b9e775de13fb52d761535165c08e9e4786f5e9f4 Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Sun, 8 Nov 2026 02:40:55 +0900 Subject: [PATCH] docs: reconcile implementation backlog and priorities [skip ci] --- docs/design/implementation-roadmap.md | 56 ++++++---- docs/design/implementation-status.md | 4 + docs/design/ja/calendar-contacts.md | 6 +- docs/design/ja/implementation-backlog.md | 135 +++++++++++++++++++++++ docs/design/ja/index.md | 8 +- docs/design/ja/priority-ux-20261031.md | 5 +- docs/design/ja/publication.md | 6 +- docs/design/ja/remote-cli.md | 5 + docs/design/ja/roadmap.md | 7 +- docs/design/ja/tasks-tickets.md | 6 +- 10 files changed, 204 insertions(+), 34 deletions(-) create mode 100644 docs/design/ja/implementation-backlog.md diff --git a/docs/design/implementation-roadmap.md b/docs/design/implementation-roadmap.md index c99f3ab..6ec98f5 100644 --- a/docs/design/implementation-roadmap.md +++ b/docs/design/implementation-roadmap.md @@ -1,5 +1,13 @@ # Architecture Implementation Roadmap +## Current backlog reconciliation (2026-11-08) + +Use the [Japanese implementation backlog](ja/implementation-backlog.md) for the current +execution order, stable task IDs, acceptance criteria and explicit holds. Baseline: `e65ca56`. +Broad historical checkboxes below may contain implemented slices; they are not a count of +unimplemented features. Source completion, physical-client acceptance and production rollout +remain separate gates. The 2026-10-31 UX priorities below are historical context. + ## Daily email history and controlled retries (2026-11-08) - [x] Private, paginated delivery history and explicit same-day retry from personal settings. @@ -100,9 +108,11 @@ See [component names, boundaries and acceptance criteria](ja/component-names.md) All eight initial component extractions are implemented; unchecked items describe remaining capabilities. Released and deployed as [v0.2.0](../operations/deployments/2026-11-01-v0.2.0.md) on 2026-11-01. -- [ ] Priority follow-up: eliminate AddEventLog deferred read-to-write transaction contention; - preserve atomic raw-log/bucket writes and test independent concurrent writers. Production - start-log failures are now observable; job execution succeeded, but log completeness is not guaranteed. +- [x] Eliminate AddEventLog deferred read-to-write transaction contention with writer-first + acquisition, atomic raw-log/bucket writes and independent concurrent-writer tests. + Completion-log failure does not replay successful business work; see [Dregarnuhr](ja/dregarnuhr.md). +- [ ] Recover missing logs, improve event-only fallback/retention and define completion/log + atomicity. Writer-first acquisition does not guarantee all logs survive prolonged contention. ### Storage portability and operations (2026-09-27) @@ -163,7 +173,10 @@ See [active notification contract](ja/active-notifications.md) and - [x] Private local calendar time-block links, durable retry intents, current event time/ETag lookup, unlink tombstones; imported/shared/public calendars excluded. - [x] Persistent Pomodoro: start/pause/resume/finish/cancel, one active session per principal, conditional transitions, bounded scheduler completion and Inbox notification. - [x] Today bounded estimates/current local time blocks/recorded focus intervals, overlap and incomplete-total indicators. Calendar event summaries include an explicitly approved task-title snapshot, never notes. -- [ ] Personal capacity, carry-over and period/project reports; historical focus-span backfill; calendar reminders, notification defaults/quiet hours/digests; Pomodoro personal defaults/cycles and routines. +- [x] Daily carry-over, work-period/current-project reports, personal notification defaults and + opt-in daily task digest with delivery history and manual retry (source through 2026-11-08). +- [ ] Personal capacity, historical focus-span backfill, general calendar reminders, quiet hours, + Pomodoro personal defaults/cycles and routines; see TASK-01 / ORG-01 in the current backlog. See [time-block and Pomodoro contracts](ja/task-planning-focus.md) for API, privacy, two-store recovery, polling limits and remaining work. Canonical calendars and task @@ -212,14 +225,16 @@ System-service plugins are distinct from document adapters. See - [x] Separate system-extension catalog and settings area for trusted built-ins. - [x] Unified execution/resource monitor (running jobs only), paginated job history with lazy logs. - [x] Protect group owners from ordinary member downgrades and atomically retain an owner during concurrent removal. -- [ ] Transactional activity outbox and Domain/principal recent-edit projections. +- [x] Transactional Domain-sequenced activity outbox and independent typed consumer checkpoints; + task/project source mutations append atomically. See [delivery contract](ja/outbox-delivery.md). +- [ ] General Domain/principal recent-edit projections, consumer operations and safe outbox retention. - [x] Diary/blog initial built-ins: Page UUID metadata, calendar/recent entries, categories, read-filtered indices, per-Domain enable/disable and registration UI. See [initial scope](diary-blog-plugins.md); this is authenticated, existing-Page registration only. - [x] Diary/blog atomic Markdown new-post composition, transactional metadata/Revision, embedded-asset freezing, idempotent retry and create/write enforcement. -- [ ] Diary/blog: anonymous metadata approval/feeds, - recent comments and safe resumable tDiary import; declarative time/OS/sunset theme rules. +- [x] Diary/blog approved anonymous metadata and full-body RSS feeds; see [current scope](ja/blog-diary.md). +- [ ] Recent comments and safe resumable tDiary import; declarative time/OS/sunset theme rules. - [x] Diary/blog per-Domain prefixes, optional keyword URL planner, multiple articles per day, and authenticated Domain-root diary/blog entry view (2026-09-17). Legacy Page registration remains available. @@ -233,8 +248,8 @@ System-service plugins are distinct from document adapters. See filter, legacy-query redirects, and canonical calendar/filter/pagination navigation. - [x] Local same-Campus diary/blog index/calendar projection without copying articles; source and destination read-policy filtering, source body/edit links, target write guard. -- [ ] Project article bodies on destination host, approved anonymous projection, - cross-instance source transport/revocation and source-setting federation. +- [x] Same-instance destination-host article bodies, approved anonymous projection and RSS. +- [ ] Cross-instance source transport/revocation and source-setting federation. - [ ] Rankings, reactions and moderated Page/inline comment services. - [ ] Linkding-compatible bookmark-source injection with scoped credentials. - [ ] Explicit external-search fallback and PagesWiki/GROWI/PukiWiki connectors. @@ -478,7 +493,8 @@ See [Home layouts and sidebar design](navigation-home-sidebar.md). manifests, inert HTML, mutation invalidation and denial/revocation tests. - [ ] Extend those gates to anonymous discovery/dependencies and delegated shares with full impact-aware mutation/alias handling. -- [ ] Add Domain groups, group Role bindings, and `/g/` management surfaces. +- [x] Add Domain groups, group Role bindings, and `/g/` management surfaces. + Full authorization auditing and external group mapping remain separate gates. - [ ] Add explicit OIDC/LDAP group mappings and policy-version invalidation; LDAP authentication must remain usable without enabling group synchronization. - [ ] Add auditable policy decisions. @@ -495,11 +511,12 @@ These items must land before the later feature that depends on them. They are listed separately because they replace concrete single-feature assumptions without changing user-visible Page identity. -- [ ] Put filesystem `DocumentRoot` access behind the seekable, content-addressed - Document Store interface before adding S3 or multi-node payload placement. -- [ ] Generalize topology/event-job records into a versioned transactional - Domain event outbox before notifications, feeds, metrics, comments, or DR - consume mutation events. +- [x] Introduce the seekable, content-addressed Document Store interface and Geduldh + local payload/materialization adapter. External backends, legacy context propagation + and placement contracts remain open; see [Geduldh](ja/geduldh.md). +- [x] Introduce a transactional Domain event outbox with typed subscriptions and checkpoints. +- [ ] Extend producer coverage and replay/retention contracts before new consumers depend on it; + see [remaining delivery work](ja/outbox-delivery.md). - [ ] Add a typed extension manifest and provider registry before adding third- party transpilers, widgets, scanners, storage backends, or themes. - [ ] Inventory process-local sessions, caches, preview slots, scheduler state, @@ -572,10 +589,11 @@ without changing user-visible Page identity. - [ ] Formalize a Domain-sequenced event outbox for Page, Revision, Path, topology, policy, share, comment, reaction, quality, and federation events. - [ ] Add Page/Spot/Street/Quartier subscription and change-notification rules. -- [ ] Add a per-Principal notification inbox with unread state, grouping, - filtering, retention, cursor pagination, and authorization-safe deep links. -- [ ] Add delivery channels for Web inbox, email digest, webhook, and future - push adapters, with retry/dead-letter state in the event scheduler. +- [x] Per-Principal Inbox, unread state, cursor pagination, topbar/modal/detail UI, + task/broadcast producers and current-authorization checks for supported types. +- [ ] General notification grouping/filtering/retention and new-producer authorization coverage. +- [x] Web Inbox, opt-in Web Push and daily task email; their delivery contracts are distinct. +- [ ] General channel subscriptions, webhook delivery, quiet hours and retry/dead-letter operations. - [ ] Add recently edited and recently viewed Page projections; keep private activity private and provide retention/opt-out controls. - [ ] Add privacy-aware Page view counters with bot filtering, idempotent event diff --git a/docs/design/implementation-status.md b/docs/design/implementation-status.md index a45518c..274e7d1 100644 --- a/docs/design/implementation-status.md +++ b/docs/design/implementation-status.md @@ -1,5 +1,9 @@ # Implementation status and hardening backlog +2026-11-08 reconciliation: use the [current Japanese implementation backlog](ja/implementation-backlog.md) +for actionable IDs, priorities, dependencies and acceptance gates, based on `e65ca56`. +This is a source/document audit, not a production audit or a new deployment. + For the consolidated current reading order, use the [Japanese handbook](ja/index.md) and [decision register](ja/decisions.md). Dated entries below preserve history; older statements about missing anonymous navigation, blog publication or RSS are diff --git a/docs/design/ja/calendar-contacts.md b/docs/design/ja/calendar-contacts.md index bb55f37..cfa76f1 100644 --- a/docs/design/ja/calendar-contacts.md +++ b/docs/design/ja/calendar-contacts.md @@ -8,8 +8,8 @@ | --- | --- | --- | | Wiki URL | 人が開く説明・知識への入口 | rename可能なPage Path | | iCalendar | 予定・タスク等の交換形式 | export/import、UIDと元データを保持 | -| CalDAV | カレンダー資源を扱うWebDAV拡張 | remote connector、将来の提供面 | -| CardDAV / vCard | 連絡先の通信 / データ形式 | 個人・共有address book | +| CalDAV | カレンダー資源を扱うWebDAV拡張 | 読取remote connectorと限定VEVENT/VTODO提供面は実装済み | +| CardDAV / vCard | 連絡先の通信 / データ形式 | 個人address book提供は実装済み、共有・外部connectorは後続 | iCalendarとCalDAVは同義ではなく、`.ics`を配信するだけでCalDAVサーバーにはなりません。vCardとCardDAVも区別します。[RFC 5545](https://www.rfc-editor.org/rfc/rfc5545)、[RFC 4791](https://www.rfc-editor.org/rfc/rfc4791)、[RFC 6350](https://www.rfc-editor.org/rfc/rfc6350)、[RFC 6352](https://www.rfc-editor.org/rfc/rfc6352)。 @@ -29,7 +29,7 @@ local item UUID、calendar UID、remote href、Wiki Page UUIDを対応表に持 connectorはremote ETagとlocal versionを別々に持ち、更新前の値で条件付き操作します。ETagをDocument SHA-256と仮定しません。対応サーバーではcollection sync-tokenを利用する案ですが、無効なtokenからの再同期と未対応時のboundedな全量照合も必要です。[WebDAV同期仕様](https://www.rfc-editor.org/rfc/rfc6578)。 -通信失敗では外部削除と見なさず、tombstoneは確認できた削除だけです。両側で変更された場合はbase/local/remoteを比較し、内容を保存した競合状態へ移します。勝手な最新版上書きはしません。 +外部connectorの設計では、通信失敗を外部削除と見なさず、tombstoneは確認できた削除だけにします。双方向書込を追加する際はbase/local/remoteを保存して競合選択へ進めます。これを現在の全DAV入口の挙動とは扱いません。タスク提供面では利用者指定により無条件PUT/DELETEを上書き受理し履歴を保持します。競合候補・通知・採否選択は[所属統一の後続](task-dav-project-unification.md)で、読取外部カレンダーconnectorとは別契約です。 ## 連絡先 diff --git a/docs/design/ja/implementation-backlog.md b/docs/design/ja/implementation-backlog.md new file mode 100644 index 0000000..9894946 --- /dev/null +++ b/docs/design/ja/implementation-backlog.md @@ -0,0 +1,135 @@ +# 実装残件台帳 + +更新日:2026-11-08。照合基準は `e65ca56`(作業履歴・日次メールの後続実装まで)。 +設計書の大項目をそのまま未実装機能と数えず、既存機能の続きとして着手できる単位に整理する。 +実装順は本書、個別契約はリンク先、過去の経緯は[原ロードマップ](../implementation-roadmap.md)と +[実装記録](../implementation-status.md)を参照する。将来の更新でも以下のIDを再利用する。 + +## 調査範囲と状態の読み方 + +日本語設計書、原ロードマップ、実装記録と、対応するstore/HTTP handler/テストを静的照合した。 +全エンドポイントの再監査や本番の再試験ではない。実データ、外部カレンダー、メールボックスには +アクセスしていない。独立した `anya/pages-cli` の現行HEAD・配布バイナリも今回の照合対象外。 + +- **実装済み**:記載した範囲のコードと試験がある。全機能完成・本番適用を意味しない。 +- **一部実装**:基盤や初期機能はあるが、記載した後続が必要。 +- **未実装**:設計・TODOの段階。API例や予約URIだけでは利用可能としない。 +- **確認待ち**:実装の追加ではなく、指定端末・環境・運用での受入が必要。 +- **保留**:利用者の保留指定、外部環境の選定、保存契約の合意が必要。 + +P0は認可・整合性・復旧の安全条件、P1は日常利用の回復性と負荷、P2は機能拡張、P3は +別サブプロジェクト。P0の記載は全項目で現に障害や脆弱性を再現したという意味ではない。 +本番反映は別作業とし、今はソースと隔離fixtureを進められる。 + +## 未実装として数え直さないもの + +| 範囲 | 確認できる実装 | 残す境界・根拠 | +| --- | --- | --- | +| 8つの命名部品 | GrammaraturからSeheweitまでの初期分離 | 分離はHA・全provider対応の完成ではない。[部品一覧](component-names.md) | +| イベントログ競合 | writer lockを先に取得、raw/bucket原子保存、完了ログ失敗で業務を再実行しない | `event_log_write.go`、`event_log_write_test.go`、`event_log_reporting_test.go`。[Dregarnuhr](dregarnuhr.md)。ログ欠落の自動回収は別件 | +| 共通outbox | Domain sequence、型別購読、checkpoint、タスクと正本の同時保存 | `activity_outbox.go`。[配送契約](outbox-delivery.md)。全producer・保持・分散配送は未完成 | +| タスク | 日別計画・持ち越し、親子、Wikiメモ、時間枠、Pomodoro、既定値、達成度・プロジェクト集計 | [生産性と連絡先](task-productivity-contacts.md)、[日別計画](task-daily-notes.md)。共有・日課・競合採否は別件 | +| 作業記録・日次メール | 作業訂正/取消/監査、配信履歴、同日手動再送、世代fence | `task_work_history*.go`、`task_digest_history*.go`。managed schema v3/v4。本番未反映 | +| オーガナイザー | 共通ナビ、個人設定、配置/サイズを保存するダッシュボード | [ダッシュボード](organizer-dashboard.md)。共有・任意widget runtimeとは別 | +| 連絡先 | 個人帳、vCard、履歴復元、trash、個人CardDAVとsync-token | [運用契約](../../operations/carddav-contacts.md)。外部CardDAV connector・共有帳・全端末互換ではない | +| DAV | 共通principal/資格情報、限定VEVENT/VTODO、プロジェクト対応、既定リスト名変更 | [所属統一](task-dav-project-unification.md)。CardDAVのsync-tokenを全CalDAV対応と読み替えない | +| グループ・公開 | `/g/` 管理、built-in管理グループ、匿名children/tree/City、明示/自動公開 | `groups_handler.go`、`groups_inheritance.go`、[公開契約](publication.md)。委譲shareと完全な権限配信は別 | +| 承認・通知 | 要求/決裁APIの限定slice、共通Inbox、アナウンス、タスク通知、Web Push | `publication_approval_api.go`。[Schutzaria](schutzaria.md)。継承reviewer・定足数・現行Revision再検査・決裁UIは残件 | +| ブログ・日記 | 作成、公開、同一Campus・同一instanceの射影、本文RSS、記事ナビ | [ブログ・日記](blog-diary.md)。遠隔射影、コメント、tDiary importは別 | +| エディタ | E1–E5、下書き、条件付き保存、競合確認、復元、言語分岐、保護HTML | [編集契約](editor-resilience.md)。全入口の同一契約・E6共同編集は未完成 | +| ストレージ・DR | Geduldhローカル不変payload、migration台帳、offline snapshot/verify/restore/手動promote | `internal/dr/snapshot.go`、`node.go`。[DR計画](dr-delivery-plan.md)。オンライン同期・自動切替ではない | + +## 次の実施順 + +1. **REC-01**:失効Domainに残る作業タイマーの回復。日常の記録開始を妨げる状態を、権限を復活させず解消する。 +2. **REC-02**:取消済み作業の復元と監査保持契約。監査記録を消して取消を取り消す方式にはしない。 +3. **AUTH-01 → SEARCH-01**:読み取りポリシーの有界な事前読込と検索snapshotの整合性。接続待ちと認可の競合を同時に扱う。 +4. **PUSH-01**:Push claim世代と購読versionのfence。メールの世代管理ができたことをPush側の完了と扱わない。 +5. **QUEUE-01**:まず終了context/drain、次に汎用leaseの設計・移行。lease導入だけでHA有効化しない。 +6. **DAV-01**:Tasks.org等との上書き同期の競合候補・Inbox・採否選択。現在の上書き互換は維持する。 + +上記は次回実装の推奨順。今回行ったのは台帳整理であり、これらのコード変更・本番反映ではない。 +別セッションとの保存層の競合がある場合は、該当ファイルの作業境界を合意してから進める。 + +## A. 整合性・回復・認可 + +| ID / 優先 | 状態・次の作業 | 依存・完了条件 | 詳細 | +| --- | --- | --- | --- | +| REC-01 / P1 | 一部実装:失効Domainの取り残された作業記録を終了・回復 | 現在の文書閲覧権限を再付与せず、本人の停止に必要な最小情報だけ扱う。他Domainタイトル非露出、同時停止・新規開始・失効競合を検証 | [作業記録](task-productivity-contacts.md) | +| REC-02 / P1 | 一部実装:取消からの復元、監査保持/export | REC-01と既存CAS。復元も新監査版、重複時間再検査、履歴の削除と正本の保持を分離。保持期間を決めるまで削除しない | 同上 | +| AUTH-01 / P0 | 一部実装:policy snapshot・ユーザー領域事前読込、更新時の認可fence | 入口一覧を作り、revokeと更新、alias、owner移管、公開境界移動をfixture化。接続1本でも認可callbackが別接続待ちにならない | [Schutzaria](schutzaria.md)、[認証](auth-permissions.md) | +| AUTH-02 / P0 | 一部実装:identity連結解除・メール所有・最後の管理者保護、外部group mapping | OIDC/LDAP認証自体は維持。由来付きgrant、解除・同期失効・最後の管理者の並行操作を検証 | [認証](auth-permissions.md) | +| PUB-01 / P0 | 一部実装:承認者継承/定足数/対象再検証/決裁UI、広域公開影響のページング | AUTH-01。現行source/policy/generation一致、権限失効後の決裁拒否、alias・依存Asset・移動で公開を広げない | [公開](publication.md) | +| PUSH-01 / P0 | 一部実装:claim世代をattemptから分離、購読version付き削除、Retry-After | 古いworker結果と新購読の競合、送信成功後DB失敗、lease超過を注入。配送はexactly-onceと表現しない | [Ordoschnellic](ordoschnellic.md) | +| QUEUE-01 / P0 | 一部実装:終了context/drain、汎用lease・heartbeat・fencing | 所有世代を比較して完了、旧worker遅延完了を拒否。全worker/CLIを含むwriter契約が揃うまで多重運転しない | [Dregarnuhr](dregarnuhr.md) | +| OUT-01 / P1 | 一部実装:未接続producer、consumer別再生/backoff/公平性、保持 | consumer変更時のbootstrap、一意キーtombstone、最遅必須consumerを含む安全な清掃。heads/checkpointだけ残して履歴を安易に削除しない | [outbox](outbox-delivery.md) | +| MAIL-01 / P1 | 一部実装:キュー中再送の取消、Inbox結果、保持設定/receipt整理 | attempt世代、同意、設定versionを再検査。詳細90日整理と重複防止記録の寿命を区別。SMTP結果不明を自動再送しない | [日次メール](task-digest-delivery.md) | +| STORE-01 / P0 | 一部実装:legacy schema/context整理、整合snapshot・restore契約、GC pin | migrationの再実行・途中失敗・旧データ保持・参照整合性。DB、CAS、可変正本、暗号鍵、外部副作用を一体で復旧判断 | [保存移植性](../storage-portability-and-operations.md)、[Geduldh](geduldh.md) | + +## B. スケーリングと日常UX + +| ID / 優先 | 状態・次の作業 | 依存・完了条件 | 詳細 | +| --- | --- | --- | --- | +| SEARCH-01 / P1 | 一部実装:現行head/Domain/言語別索引、H1 metadata、再開可能backfill | AUTH-01。候補上限を網羅性と混同せず、watermark・continuation・日本語検索・起動時間を測定。失効した結果をcacheから戻さない | [Mestionora](mestionora.md) | +| CITY-01 / P1 | 一部実装:生成由来/手動上書き/除外tombstone、局所reconcile | OUT-01の既存基盤を再利用。同入力で無変更、rename/merge後も手動名を保持、URL更新と所属の整合性 | [City](knowledge-city.md)、原ロードマップCITY-A〜D | +| NAV-01 / P1 | 一部実装:directory索引、有界children/Cityページング、共通sidebar | AUTH-01、CITY-01。隠れた件数・ラベルを出さず、Domain全件読込に依存しない。巨大階層の時間・行数・heapを測定 | [ナビ](navigation-search.md) | +| RENDER-01 / P1 | 一部実装:provider版付きcache、同一描画の集約/同時数/清掃、隔離 | 描画をforegroundより低優先にする。停止・更新・認可失効・cache破損・容量不足・外部参照を検証 | [Kunstzeal](kunstzeal.md) | +| OBS-01 / P1 | 一部実装:情報源別availability、収集共有、rollup/清掃予算、component metrics | 欠測を0としない。返却点数だけでなく走査量を制限。CPU/RAMを根拠なくproviderへ按分しない。SNMPは別選定 | [Seheweit](seheweit.md) | +| EDIT-01 / P1 | 一部実装:新規GET時のPage作成を保存まで延期、全入口CAS、block単位保護HTML/挿入palette | 既存E1–E5を回帰。Page+Path+初回Revisionを原子的に作り、閉じるだけでは空Pageを残さない。PlainText変換は欠落を明示 | [編集](editor-resilience.md)、[日常UX](priority-ux-20261031.md) | +| UX-01 / P1 | 一部実装:idle session timeout/個人短縮設定、独立CLIとの契約整理 | 絶対期限とは区別。読み取りpollだけで無期限延長しない。CLI本体の検索・転送等は独立repoを確認して別issue化 | [日常UX](priority-ux-20261031.md)、[CLI契約](remote-cli.md) | + +## C. オーガナイザーと利用機能 + +| ID / 優先 | 状態・次の作業 | 依存・完了条件 | 詳細 | +| --- | --- | --- | --- | +| DAV-01 / P1 | 一部実装:上書き競合の候補保存、Inbox、比較/採否 | task履歴と通知を原子的に対応付け、再同期で候補を重複させない。別人・別Domainへ候補本文を漏らさない | [所属統一](task-dav-project-unification.md) | +| DAV-02 / P2 | 一部実装:VTODO時刻期限/繰返し/alarm、VEVENT temporal拡張、差分同期 | 対応profileを分離。未知propertyの保持・拒否、削除tombstone、期限切れtokenからの復旧。選定clientで認定するまで完全準拠としない | [共通DAV](caldav-common.md)、[calendar](calendar-implementation.md) | +| TASK-01 / P2 | 一部実装:日別capacity、一括計画、focus backfill、Pomodoro周期/日課 | 見積・実績・予定を混同せず、次回生成を冪等化。親子2階層と一般依存DAGを別に扱う | [時間枠](task-planning-focus.md)、[タスク](tasks-tickets.md) | +| ORG-01 / P2 | 一部実装:一般予定通知、共有タスク/アドレス帳、owner回復 | AUTH-01、OUT-01。共有相手失効、担当だけでは本文権限を増やさない、通知の重複抑止。外部CardDAV書込は別ゲート | [予定・連絡先](calendar-contacts.md) | +| DASH-01 / P2 | 一部実装:同種widget複数、共有layout、plugin widget | 個人layoutとの分離、配置版競合、widgetごとの認可/取得上限。第三者実行はEXT-01後 | [dashboard](organizer-dashboard.md) | +| SHARE-01 / P2 | 未実装:委譲share URL、期限/失効/監査、説明可能な権限総覧 | AUTH-01、PUB-01。login/adapter/federation資格情報と別目的、単一Page投影、caveat・依存物の失効を検証 | [公開](publication.md)、[Schutzaria](schutzaria.md) | +| COLLAB-01 / P2 | 一部実装:Page等の変更購読、最近閲覧/編集、集約通知。コメント/反応/評価は未実装 | OUT-01。現在権限で再投影、private履歴のopt-in/保持。inline commentはRevision変更時の孤立・再接続を扱う | [拡張](extensions.md) | +| BLOG-01 / P2 | 一部実装:安全なtDiary import、最近コメント、遠隔ブログ射影 | COLLAB-01、遠隔はFED-01。importは再開/重複抑止/dry-run。同一instance射影を再実装しない | [ブログ・日記](blog-diary.md) | +| CSV-01 / P2 | viewerのみ実装:別Documentを投影するCSV macro/editor、ODS境界 | 行列・セル・総量上限、Revision固定、権限、CSV引用/改行fixture。表示HTMLをCSV正本へ逆流させない | [表設計](extensions.md) | +| DIAGRAM-01 / P2 | 一部実装:nwdiag/Draw.io provider、slide preview/editor | RENDER-01。安全なSVG・include拒否・renderer版固定、ticket/CAS保存、print。既存Excalidraw/Krokiとは分ける | [Kunstzeal](kunstzeal.md) | +| RECIPE-01 / P2 | 未実装:構造化レシピmetadataとPage投影の初期slice | 材料・数量・未知単位を保持、人数変更は派生値、Asset認可、版競合、出典・公開確認 | [料理レシピ](recipe-management.md) | + +## D. 選定・別サブプロジェクト + +| ID / 優先 | 状態・次の作業 | 着手ゲート・最初の検証 | 詳細 | +| --- | --- | --- | --- | +| RSS-01 / P2 | 未実装・選定待ち:FreshRSS読取connector/newsboat橋渡し | 正本・対象版・接続先を選定。合成fixture→明示Wiki保存。表示だけで既読を書かない。ブログRSS配信とは別 | [RSS](feeds.md) | +| IMAP-01 / P3 | 未実装・選定待ち:IMAP読取同期 | provider/認証/保持を決める。UIDVALIDITY/UID、添付量、外部画像、失効をfixture化。neomutt captureは実装済みで別 | [メール](mail.md) | +| TICKET-01 / P3 | 未実装:queue/番号/workflow/外部依頼者 | 共有範囲と状態遷移を定義、同時採番・失効・監査。既存個人タスクをticketと呼び替えない | [タスクとticket](tasks-tickets.md) | +| EXT-01 / P3 | built-inのみ:第三者manifest/署名/隔離runtime、停止・rollback・観測 | capability・secret・host・予算・export契約。任意コードをGoプロセス内へ直接ロードしない | [拡張](extensions.md) | +| FED-01 / P3 | 一部実装:管理設定ACK/鮮度、選択権限情報の署名付きDomain配信 | 既存group継承を保持。origin/sequence/競合/revoke/再参加を定義し、独立ローカルgrantを消さない | [Campus](campus-federation.md) | +| BACKEND-01 / P3 | 未実装:S3/SFTP、読取WebDAV/SSH、外部SQL、設定/復旧UI | STORE-01。conditional create、Range、破損・切断・遅延・mount喪失の共通試験。単なるmountを正式対応としない | [Geduldh](geduldh.md)、[運用](operations.md) | +| DR-01 / P3 | D1未実装:DR01〜13、LB/HA、controller/data authority分離 | 最初は型・pure state machine・mock probe。writer境界合意、fence設備、RPO/RTO、復旧訓練なしで自動昇格しない | [DR実施計画](dr-delivery-plan.md) | +| NETWORK-01 / P3 | 未実装:IPAM/DNS/資産管理、検疫scanner | 型付き正本、権限、dry-run→承認→apply、冪等性。スキャン/外部DNS更新を閲覧リクエスト内で行わない | [拡張](extensions.md)、[原ロードマップ](../implementation-roadmap.md) | +| CONTENT-01 / P3 | 未実装部分:他Wiki記法、widget、外部検索/Linkding、時刻・日没theme | provider単位の送信同意・上限・失効・変換欠落試験。既存壁紙色themeと時刻条件themeを区別 | [拡張](extensions.md)、[viewer/editor](viewer-editor.md) | + +### 明示的に保留するもの + +- **HOLD-01**:`/tasks/` 配下のメールWikiルーティング調査。利用者の棚上げ指定を維持。関連未コミットファイルを今回の実装・文書コミットへ混ぜない。 +- **HOLD-02**:vim.wasm runtime改善とnativeアプリ起動。既存設定UIは残すが、自動的に再開しない。 +- **HOLD-03**:全面WYSIWYG、E6 CRDT/OT共同編集。まずEDIT-01と認可/presence契約、保存量・オフライン・競合モデルを確定する。 +- **HOLD-04**:本番への反映。作業履歴/日次メールのv3/v4移行を含む同世代保全と隔離復元試験、容量確認、SMTP副作用照合が必要。古いbinaryを新schemaへ向ける切戻しは禁止。 + +## 実装と分けて管理する受入 + +| ID | 確認待ち | 今回確認していない範囲 | +| --- | --- | --- | +| ACCEPT-01 | iPhone SE/Safariのカレンダー、IME、電話handoff | Chromiumの狭幅fixtureだけでは実機受入としない | +| ACCEPT-02 | Pushの背景受信・再訪・logout・VAPID rotation | 同意済みテスト端末を使う。実通知先へ勝手に送信しない | +| ACCEPT-03 | CardDAV/CalDAV clientごとの操作matrix | 過去のTasks.org動作確認は保持するが、全版・全操作の保証に広げない | +| ACCEPT-04 | 独立pages-cliの現行契約・配布物 | このrepoの旧Python版でWindows/TLS設定/配布状態を判定しない | + +## 完了・コミット・文書更新の規則 + +変更単位ごとに契約、実装、拒否/競合/再送/上限試験を揃えてコミットする。DB変更では +旧schema fixture、migration再実行、途中失敗rollback、参照整合性、復旧方式を必要条件にする。 +破壊的変更・GC・外部副作用は、単に全Goテストが通ることだけで実施可能と判定しない。 + +完了時は本書の該当IDと詳細書の状態を同時更新し、ソースcommit、試験、release、本番適用を +別々に記録する。旧Phaseの大項目は後続が残る限り丸ごとチェックせず、完了sliceを分ける。 +残件の総数を完了率には使わない。各行は規模が異なり、着手時に実装・受入単位へ分割する。 diff --git a/docs/design/ja/index.md b/docs/design/ja/index.md index d71b163..c8eda5b 100644 --- a/docs/design/ja/index.md +++ b/docs/design/ja/index.md @@ -1,9 +1,11 @@ # PagesWiki 開発設計書 -更新日:2026-09-19。日本語の統合設計版。実装の変更履歴ではなく、現在の境界と次の設計判断を確認するための入口です。 +更新日:2026-11-08(統合版の初版は2026-09-19)。実装の変更履歴ではなく、現在の境界と次の設計判断を確認するための入口です。 ## この設計書の読み方 +**次に実装する作業は[実装残件台帳](implementation-backlog.md)を入口にする。** `e65ca56`を基準に、実装済みsliceと後続、優先順、依存・完了条件、実機確認待ちと保留を整理した。古い大項目の未チェックを、そのまま全機能未実装と解釈しない。 + 2026-11-08追加:[日次タスクメールの配信履歴と手動再送](task-digest-delivery.md)。予約・要求receipt・詳細履歴の保持境界と、DB移行・復旧時の二重送信防止。 2026-11-02追加:[オーガナイザーの共通ナビゲーションと個人ダッシュボード](organizer-dashboard.md)。配置可能なウィジェット、個人設定への統合、保存・認可・読込負荷の契約。 @@ -54,6 +56,6 @@ 21. [決定事項・矛盾の整理・未決事項](/lab/pageswiki-dev/decisions) 22. [原資料との対応と外部仕様](/lab/pageswiki-dev/sources) -## 今回の範囲 +## 初版の範囲とその後の更新 -今回行うのは設計の再整理と日本語設計書の配置です。オーガナイザー、外部サービス、DAVサーバー、メールアカウント、公開権限の新設は行いません。設計書の配置も匿名公開の許可とは別です。 +2026-09-19の初版は設計整理と日本語設計書の配置を対象にした。その後の実装は各章の日付付き記録と残件台帳に反映する。2026-11-08の再照合は文書とソースの静的確認であり、本番データの監査・外部サービスへの接続・本番適用は行っていない。設計書の配置も匿名公開の許可とは別です。 diff --git a/docs/design/ja/priority-ux-20261031.md b/docs/design/ja/priority-ux-20261031.md index 23a829a..221a5ee 100644 --- a/docs/design/ja/priority-ux-20261031.md +++ b/docs/design/ja/priority-ux-20261031.md @@ -38,7 +38,8 @@ - [x] HTTPクライアント初期版 `pages-cli`/コマンド `pages`(2026-11-01ホストのユーザーPATHへ配置済み。実ユーザログインは未実施):configureによる接続先・既定プロファイル・言語管理、パスワード/TOTP、Bearer保持・失効、ls/cd/cat/view/get、既存Page edit/put、Path補完、メモリ内履歴、検索候補、ブラウザ引き継ぎ。詳細と原設計整合は [遠隔CLI](remote-cli.md)。既存DB直アクセスCLIは変更しない。 - [x] 専用起動コマンドとセッション保持は独立HTTPクライアント `pages` として実装。既存 `data/pageswiki-cli` のDB直接操作とは分離し、資格情報に0600の保護と失効/ログアウトを設ける。 -- [ ] `Ctrl+P` のfuzzy検索と、ローカル `$EDITOR` 編集。現在版/ETagを保持してアップロード時の競合を検出し、上書き・差分・キャンセルを選べるようにする。 +- [x] ローカル `$EDITOR` 編集、現在Revisionを指定した保存、409時の原稿保全(分離前のHTTPクライアント)。 +- [ ] `Ctrl+P` のfuzzy検索と競合の対話選択。独立CLI側の現状を確認して追跡する。サーバーの新規作成契約とは分ける。 - [x] ターミナルにURLを表示するブラウザ認証(OIDC)。`pages login --oidc [--no-browser]`、S256、5分の単回grant、確認コード/CSRF/TOTP、失効再確認、poll・発行上限を実装。2026-11-01 v0.3.0でサーバー・ホストCLIへ本番反映済み。実providerでの本人承認は利用者確認が残る。契約は[遠隔CLI](remote-cli.md)を参照。 - [ ] ターミナル表示が難しい内容はブラウザに引き継ぐ。short linkは認証を迂回しない内部リンクとし、公開share link発行とは分離する。自動公開しない。 @@ -123,7 +124,7 @@ 現行 `data/pageswiki-cli` はSQLite/Document Storeへ直接アクセスする運用CLI。shell、補完、履歴、`$PAGER`/`$EDITOR` は既にあるが、Web認証を受けるリモートクライアントではない。Webユーザの認可をSQLite直アクセスへ継ぎ足さず、HTTP transportを持つ別コマンド(仮称 `pageswiki remote`)として段階導入する。 -2026-11-01:試作名 `data/pageswiki-remote` から、ユーザ指定によりサブプロジェクト `pages-cli`/実行名 `pages` へ整理。`pages configure` と既定値により通常操作のprofile/lang引数を不要とした。OIDCハンドオフはv0.3.0で本番反映済み。実providerでの本人承認、Ctrl+P、新規作成、強制上書きの対話選択、short linkは残件。[範囲・制限・検証](remote-cli.md)を参照。 +2026-11-01:試作名 `data/pageswiki-remote` から、ユーザ指定によりサブプロジェクト `pages-cli`/実行名 `pages` へ整理。`pages configure` と既定値により通常操作のprofile/lang引数を不要とした。OIDCハンドオフはv0.3.0で本番反映・利用者確認済み。既存Pageの言語分岐と編集はv0.4.0で対応済み。新規Pageの原子的な作成は別件。2026-11-06以降のCLI本体は独立repoを正とし、Ctrl+P・転送・配布対応等の現状を旧同梱版だけで判定しない。[範囲・制限・検証](remote-cli.md)を参照。以下の番号付き項目は初期実装時の契約で、すべて未着手という意味ではない。 1. パスワード+TOTPの既存JSONログイン、失効/logout、接続先・Principal・Domain別セッション保存。秘密情報はコマンド引数/履歴/ログへ出さず、保存先0700・資格情報0600相当、TLS検証必須。 2. `ls/cd/view/get/edit` と現在Pathの保持。検索は認可付き・件数制限・キャンセル可能なAPIを使用し、`Ctrl+P` のfuzzy選択へ接続。端末の制御シーケンスは本文/タイトルから除去する。 diff --git a/docs/design/ja/publication.md b/docs/design/ja/publication.md index c23e1bc..164f29b 100644 --- a/docs/design/ja/publication.md +++ b/docs/design/ja/publication.md @@ -1,6 +1,6 @@ # 6. 公開・承認・共有・匿名ナビゲーション -状態:明示的なRevision公開、Street/Spotの自動公開、匿名ナビゲーションは実装済み。承認者Inboxは受信者単位の保存・既読APIまで実装済みで、承認要求の生成・決裁UI・配送ワーカーはTODO。共有URL管理もTODO。 +状態:明示的なRevision公開、Street/Spotの自動公開、匿名ナビゲーションは実装済み。承認要求の登録・限定決裁APIと受信者別Inboxは実装済み。上位方針・reviewer継承、定足数、現行Revisionの再検証、決裁UIを含む公開運用フローは未完成。共有URL管理もTODO。2026-11-08、`publication_approval_api.go`と照合。 ## 三つの異なるもの @@ -42,9 +42,9 @@ Domain・Quartierもrequiredの上限制約を設定できます。automaticは 状態はdraft → requested → approved / rejected / expired / supersededを案とします。取り消し・公開撤回は別監査イベントです。上位の承認必須設定を下位が解除できないこと、自動公開との優先順位、本人承認の可否を実装前に確定します。 -共通通知Inboxの第一段階として、`notification_inbox`にDomain・受信者・イベント・種別を保存し、同じ組合せを重複排除します。`GET /_/api/v1/notifications` は現在のPrincipalに限定して `unread`、`limit`、`before` のkeyset取得を行い、`POST/PATCH /_/api/v1/notifications/read` は同じDomain・受信者の通知だけを既読化します。通知は権限や承認を付与せず、本文や秘密を保存しません。承認要求からの生成と再表示時の権限再検査は次段階です。 +共通通知Inboxの第一段階として、`notification_inbox`にDomain・受信者・イベント・種別を保存し、同じ組合せを重複排除します。`GET /_/api/v1/notifications` は現在のPrincipalに限定して `unread`、`limit`、`before` のkeyset取得を行い、`POST/PATCH /_/api/v1/notifications/read` は同じDomain・受信者の通知だけを既読化します。通知は権限や承認を付与せず、承認対象の本文や秘密を保存しません。要求登録からの限定的なInbox生成は下記のAPIに接続済み。現行対象の再検査を含む完全な決裁フローは次段階です。 -承認要求の対象(Path/Object/RevisionのハッシュとJSON)、policy version、generation、期限、要求者を`publication_requests`に固定保存し、決裁履歴を`publication_decisions`へ追記します。期限付きpending要求はスケジューラが小さなbatchでexpiredへ遷移させます。レビュアーの現在権限を再検査する決裁APIとInbox UIは、まだ公開していません。 +承認要求の対象(Path/Object/RevisionのハッシュとJSON)、policy version、generation、期限、要求者を`publication_requests`に固定保存し、決裁履歴を`publication_decisions`へ追記します。期限付きpending要求はスケジューラが小さなbatchでexpiredへ遷移させます。Domain管理者向けの限定決裁APIは存在しますが、委譲レビュアーの決裁UI・完全な公開承認フローを提供した状態ではありません。 認証済みのDomain管理者向けに、`POST /_/api/v1/publication/requests`でboundedな対象manifestを登録できます。idempotency keyで再送をまとめ、指定されたレビュアーがDomain管理権限を持つ場合だけInbox通知を作成します。`POST /_/api/v1/publication/requests/{uuid}/decisions`はDomainとgenerationを再検査し、承認・拒否をCASで一度だけ適用します。上位方針の継承、定足数、対象Revisionの現在性検査は、公開運用へ進む前の残タスクです。 diff --git a/docs/design/ja/remote-cli.md b/docs/design/ja/remote-cli.md index 72cf9b5..d082818 100644 --- a/docs/design/ja/remote-cli.md +++ b/docs/design/ja/remote-cli.md @@ -2,6 +2,11 @@ 2026-11-06:利用者向けの[クライアント契約](https://git.anya.jp/anya/pages-cli/src/branch/main/docs/client-contract.md)と[NeoMutt連携](https://git.anya.jp/anya/pages-cli/src/branch/main/docs/neomutt.md)は独立した公開pages-cliリポジトリへ移転した。本書はサーバー側のHTTP・OIDC認証契約、結合テストと導入履歴を保持する。下記のv0.3.0/v0.4.0は分離前のサーバー同梱版の番号であり、独立CLIはv0.1.0から採番する。 +2026-11-08整理:以下のPython実装・Windows未対応・TLSバイパスなし等の記述と末尾の +「次段階」は分離前の同梱版の記録であり、独立CLIの現行制約ではない。独立版の実装・配布・ +残件は上記repoを正とする。今回の文書照合では独立版HEADを取得していない。 +サーバー側の新規作成/CAS等の後続は[残件台帳 EDIT-01 / UX-01](implementation-backlog.md)で追跡する。 + 2026-11-01。合成データで検証済み。同日、本番サーバのCity更新と合わせてクライアントをホストの `/home/anya/.local/bin/pages` に配置した。実ユーザの資格情報取得・ログイン・本番Page編集は未実施。接続設定とログインは利用者が行う。[反映記録](../../operations/deployments/2026-11-01-city-pages-cli.md)。 v0.3.0のOIDCログインは利用者の動作確認済み。v0.4.0ではOIDC承認時の追加ローカルTOTPを廃止し、CLIの `auto` 言語選択と既存Pageの新規言語版編集を実装した。2026-11-01 21:48 JSTに本番サーバー/PATH上のCLIへ反映済み。[v0.4.0反映記録](../../operations/deployments/2026-11-01-v0.4.0.md)。 diff --git a/docs/design/ja/roadmap.md b/docs/design/ja/roadmap.md index 0907b0d..5a844ad 100644 --- a/docs/design/ja/roadmap.md +++ b/docs/design/ja/roadmap.md @@ -1,6 +1,11 @@ # 20. 実装順序と受け入れ条件 -状態:2026-09-19再整理。旧Phase番号は原ロードマップとの対応用に残し、実装は依存関係とリスク順に進めます。 +状態:2026-11-08再照合。旧Phase番号は原ロードマップとの対応用に残し、実装は依存関係とリスク順に進めます。 + +現在の作業単位・優先順・受入条件は[実装残件台帳](implementation-backlog.md)に集約しました。 +以下の日付付き追記と旧優先表は経緯を残すものです。共通outbox、限定DAV、個人連絡先、 +HTML保護、Inboxなどの初期sliceは実装済みで、旧表の項目全体が新規開発という意味ではありません。 +次はREC-01/REC-02、AUTH-01→SEARCH-01、PUSH-01、QUEUE-01、DAV-01の順を推奨します。 ## 優先順 diff --git a/docs/design/ja/tasks-tickets.md b/docs/design/ja/tasks-tickets.md index 5667e57..58a879d 100644 --- a/docs/design/ja/tasks-tickets.md +++ b/docs/design/ja/tasks-tickets.md @@ -33,14 +33,14 @@ create/read/update/assign/transition/comment/manageは概念上分離します iCalendarにはVTODOがあり、CalDAVはカレンダー資源を扱います。ただしクライアントごとのタスク・繰り返し対応を試験する必要があります。これは「CalDAVだけでチケット管理が完成する」という意味ではありません。[iCalendar](https://www.rfc-editor.org/rfc/rfc5545)、[CalDAV](https://www.rfc-editor.org/rfc/rfc4791)。 -最初はlocal task一覧と期限表示、次にVTODOの明示export/import、最後に選定クライアントとの同期を検討します。workflow、コメント、細かな権限をVTODOへ無理に押し込みません。失われる情報を変換警告に残します。 +local task一覧と期限表示、限定VTODO/CalDAV同期は実装済みです。次は上書き競合の候補保存と採否、時刻期限・繰り返し・アラーム・差分同期を個別に扱います。workflow、コメント、細かな権限をVTODOへ無理に押し込みません。失われる情報を変換警告に残します。 ## 実装TODO - TASK-1:個人local作成/取得/更新、version競合、Page参照、所有者限定一覧は実装済み。削除は復元可能なアーカイブ、物理削除は未提供。 - TASK-2:日付の期限/計画/見直し、タイトルフィルタ、archive、個別ONのInbox通知は実装済み。担当共有、通知集約、exportは未実装。 -- TASK-3:checklist/依存とboundedな一覧・calendar射影。 +- TASK-3:2階層サブタスク、boundedな一覧、日割り工程表・個人時間枠は実装済み。一般依存グラフ、共有、一括計画・日別capacityは後続。 - TICKET-1:queue・番号予約・workflow版・権限付き遷移。 -- TASK-4:VTODO fixture、未対応property保持、繰り返し・同期の判断。 +- TASK-4:限定VTODO fixtureと同期、プロジェクト対応・既定リスト名変更は実装済み。繰り返し・時刻期限・差分同期と競合候補の通知/採否は後続。[所属統一](task-dav-project-unification.md)と[残件台帳](implementation-backlog.md)を参照。 同時採番、二重POST、完了取消、夏時間・終日、assignee失効、本文削除を受け入れ試験にします。