diff --git a/docs/design/ja/feeds.md b/docs/design/ja/feeds.md index 624ef46..bafbcb6 100644 --- a/docs/design/ja/feeds.md +++ b/docs/design/ja/feeds.md @@ -2,6 +2,9 @@ 状態:設計案。既存のブログRSS「配信」と、本章の外部RSS「購読」は別機能。 +2026-11-08:利用者指定のサブプロジェクト順で最初に実施する。FreshRSS/内蔵readerの +正本選定と実環境への接続は別の判断であり、RSSを優先することだけでは確定しない。 + ## 選択肢と推奨する試作順 | 案 | 正本 | 利点 | 追加する責任 | @@ -39,3 +42,21 @@ OPMLは購読の入出力として扱い、既読・star・全本文のバック ## TODOと受け入れ RSS-1:read-only FreshRSS fixture。RSS-2:安全な一覧と出典付きWiki保存。RSS-3:必要なら既読/star送信。RSS-4:内蔵reader採用判断とOPML。オフライン、欠落ID、巨大feed、未知HTML、同期再送、他user情報、feed削除後の保存Page維持を試験します。 + +## 実施段階 + +1. **共通契約とfixture**:Domain/本人のsource所有、provider ID、remote ID、cursor、取得予算、 + 最終成功/失敗と無効化を定義する。合成記事を返すfixtureから開始し、FreshRSSを必須の + 稼働依存として固定しない。sourceの資格情報をブラウザ・ログへ出さない。 +2. **読取UIと背景取得**:購読/フォルダ、記事の一行一覧、本文表示、出典リンクを用意する。 + デスクトップでは一覧を見渡せる配置、スマホでは一覧と本文を切り替える。画面表示で外部fetchを + 待たず、schedulerで有界に更新し、取得済みcacheと鮮度を表示する。source停止・失効も検証する。 +3. **Wiki保存とタスク化**:タイトル・URL・出典・短いメモをpreviewし、保存先Pathを選ぶ。 + 既存captureと権限確認を再利用し、二重送信・保存先競合・自動公開範囲を検査する。全文保存は + 独立した明示操作。タスク作成が失敗しても保存済みWikiを消さず、部分成功と再試行方法を示す。 +4. **ダッシュボードと実環境受入**:読める記事だけのwidgetを追加。providerと正本を選定後、 + 同意した接続先でread-only受入を行う。既読/star書込、OPML、内蔵fetcherはそれぞれ後続の + 明示範囲とし、read-only連携を有効化しただけで外部状態を変更しない。 + +各段階で無効化、件数・時間・容量上限、移行の再実行、ユーザー/Domain間の分離を試験する。 +source解除時のcache清掃と、利用者が明示保存したWiki/タスクの保持は別操作とする。 diff --git a/docs/design/ja/implementation-backlog.md b/docs/design/ja/implementation-backlog.md index 9894946..b0aa4a4 100644 --- a/docs/design/ja/implementation-backlog.md +++ b/docs/design/ja/implementation-backlog.md @@ -41,14 +41,25 @@ P0は認可・整合性・復旧の安全条件、P1は日常利用の回復性 ## 次の実施順 -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・採否選択。現在の上書き互換は維持する。 +2026-11-08、利用者指定により、大きな機能を提供するサブプロジェクトを以下の順で進める。 +前案の小規模な回復・基盤改善を先に一巡する順序は、この順序へ置き換える。 -上記は次回実装の推奨順。今回行ったのは台帳整理であり、これらのコード変更・本番反映ではない。 +| 順番 | サブプロジェクト | 主な残件ID | 利用できる機能のまとまり | +| --- | --- | --- | --- | +| 1 | RSS・情報収集オーガナイザー | RSS-01 | 購読・フォルダ・記事一覧、出典付きWiki保存、タスク化、ダッシュボード連携 | +| 2 | 構造化ドキュメントと編集部品 | CSV-01、DIAGRAM-01、EDIT-01の関連部分 | CSV埋め込み/編集、図表部品挿入、nwdiag/Draw.io等のpreviewと安全な保存 | +| 3 | 料理レシピ管理 | RECIPE-01 | 材料・手順・分量変更・材料検索・買い物リスト | +| 4 | タスク・プロジェクト管理の第2段階 | TASK-01、DAV-01、REC-01/02、ORG-01の関連部分 | 日課・週次計画・capacity・依存関係・進捗・同期競合の採否 | +| 5 | 共同作業・公開承認・共有 | PUB-01、SHARE-01、COLLAB-01の関連部分 | 承認者Inbox/決裁、公開影響確認、期限付き共有、権限総覧 | + +各表のP0〜P3は安全性・負荷等の性質を示す分類として残し、このサブプロジェクト順を覆す +一律の実行順にはしない。AUTH-01、OUT-01、QUEUE-01、STORE-01等は、対象機能に必要な +範囲を各段階へ組み込む。必須の認可・DB整合性・再送防止は省略せず、無関係な基盤改修を +すべて完了させるまで機能開発を止める構成にも戻さない。 + +最初のRSSは[着手単位](feeds.md#実施段階)に従う。FreshRSS採用や外部環境の新設は未決定のまま、 +まずprovider契約と合成fixtureで一覧・保存フローを検証する。各サブプロジェクトはUI・API・ +保存・試験が揃った単位でコミットし、本番反映は別ゲートとする。 別セッションとの保存層の競合がある場合は、該当ファイルの作業境界を合意してから進める。 ## A. 整合性・回復・認可 diff --git a/docs/design/ja/roadmap.md b/docs/design/ja/roadmap.md index 5a844ad..39262f2 100644 --- a/docs/design/ja/roadmap.md +++ b/docs/design/ja/roadmap.md @@ -5,7 +5,10 @@ 現在の作業単位・優先順・受入条件は[実装残件台帳](implementation-backlog.md)に集約しました。 以下の日付付き追記と旧優先表は経緯を残すものです。共通outbox、限定DAV、個人連絡先、 HTML保護、Inboxなどの初期sliceは実装済みで、旧表の項目全体が新規開発という意味ではありません。 -次はREC-01/REC-02、AUTH-01→SEARCH-01、PUSH-01、QUEUE-01、DAV-01の順を推奨します。 +2026-11-08の利用者指定により、**RSS・情報収集 → 構造化ドキュメント/編集部品 → +料理レシピ → タスク・プロジェクト管理の第2段階 → 共同作業・公開承認・共有**の順で進めます。 +必要な認可・整合性・性能対策は各機能の受入条件へ組み込みます。以前の回復・基盤改善を +先に一巡する推奨順は置き換え、下記の日付付き「次は」は当時の記録として扱います。 ## 優先順