Unify organizer navigation and add personal widget dashboard
This commit is contained in:
1 parent
a9249009f0
commit
6ba30bc9f4
44 files changed
+843
-54
No files matched your search
@@ -9,6 +9,8 @@ language-neutral; existing English source documents remain here for traceability
|
||||
and future aligned translations, not as automatically current English editions.
|
||||
|
||||
- Concepts and boundaries: chapters 1–6.
|
||||
- [Organizer navigation and personal dashboard](ja/organizer-dashboard.md): shared navigation,
|
||||
personal settings, resizable widgets, owner-scoped layout storage and extension boundaries.
|
||||
- [Task capture, work reporting and private address book](ja/task-productivity-contacts.md):
|
||||
shared Web/CLI API, neomutt, defaults, daily digest and home search commands.
|
||||
- Existing product and runtime: chapters 7–11.
|
||||
|
||||
@@ -1,5 +1,14 @@
|
||||
# Architecture Implementation Roadmap
|
||||
|
||||
## Organizer dashboard (2026-11-02)
|
||||
|
||||
- [x] Common navigation for tasks, calendars, contacts and dashboard; home/navbar contacts entry.
|
||||
- [x] Owner-only personal settings at `/-/sys/config?panel=organizer`, without expanding admin permissions.
|
||||
- [x] Task tabs, today/tomorrow tasks, daily completion, calendar and activity widgets; reorder/resize and versioned layout persistence.
|
||||
- [ ] Shared dashboards, multiple widget instances and sandboxed third-party widgets.
|
||||
|
||||
See [dashboard contracts](ja/organizer-dashboard.md). Production rollout is a separate gate.
|
||||
|
||||
## Task productivity and private contacts (2026-11-01)
|
||||
|
||||
- [x] Add idempotent task capture API and neomutt configuration reference.
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
## この設計書の読み方
|
||||
|
||||
2026-11-02追加:[オーガナイザーの共通ナビゲーションと個人ダッシュボード](organizer-dashboard.md)。配置可能なウィジェット、個人設定への統合、保存・認可・読込負荷の契約。
|
||||
|
||||
2026-11-01追加:[タスク作成・作業記録・達成度レポート・日次メール・個人アドレス帳](task-productivity-contacts.md)。[neomuttとCLIの操作リファレンス](../../operations/neomutt-tasks.md)も参照。
|
||||
|
||||
- **実装済み**:利用できる機能の範囲。関連する制約や未監査部分も併記します。
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
# オーガナイザーのナビゲーションと個人ダッシュボード
|
||||
|
||||
タスク・カレンダー・連絡先の入口を共通化し、個人設定と日々の振り返りを分離する。ダッシュボードは本人の作業を見る画面であり、サーバーの実行状態・リソース監視画面とは別に扱う。以下は2026-11-02のソース実装範囲。本番への反映は別途行う。
|
||||
|
||||
## 入口と設定の配置
|
||||
|
||||
各オーガナイザー画面に、ダッシュボード・タスク・カレンダー・連絡先・個人設定の共通ナビゲーションを置く。有効な拡張機能だけを表示し、現在の画面を強調する。トップ画面とログイン中のナビバーに、ダッシュボードと連絡先を直接開くアイコンを追加する。
|
||||
|
||||
| 入口 | 役割 |
|
||||
| --- | --- |
|
||||
| `/v/plan/dashboard` | ウィジェット形式の個人ダッシュボード |
|
||||
| `/v/plan/tasks` | 既存のインライン編集可能なタスク一覧 |
|
||||
| `/v/plan` | 既存のカレンダー表示。保存されたビューを尊重 |
|
||||
| `/v/plan/contacts` | 個人アドレス帳・履歴・CardDAV接続 |
|
||||
| `/-/sys/config?panel=organizer` | タスクの既定値、日次メール、既定のカレンダー |
|
||||
|
||||
旧 `/v/plan/tasks/report` はダッシュボードの達成度ウィジェットへ、旧 `/v/plan/tasks/settings` は個人設定へ303リダイレクトする。カレンダーの表示選択ダイアログはその場の表示変更に使い、既定値の永続化は個人設定へ移す。
|
||||
|
||||
個人設定は通常の設定画面と同じURI体系・テーマを使うが、専用の軽量な画面として返す。GET/HEADかつ正確な `panel=organizer` の場合だけ個人向けハンドラーに振り分け、管理用設定やアカウント一覧は取得・描画しない。POSTの管理者チェックは緩和しない。保存先は既存の本人用APIであり、一般利用者に管理権限を付与しない。
|
||||
|
||||
## ウィジェット
|
||||
|
||||
初期構成は次の6種類。任意のHTML・iframe・外部URL・スクリプトを登録する機能ではなく、サーバーが許可する組み込みIDを使う。
|
||||
|
||||
| ID | 内容 |
|
||||
| --- | --- |
|
||||
| `progress` | 今日に計画したタスクの完了数と達成率 |
|
||||
| `today` | 今日の計画と今日までの期限超過を含む未完了タスク |
|
||||
| `tomorrow` | 明日の計画または期限の未完了タスク |
|
||||
| `tasks` | Inbox / Backlog / Someday / Review / Incomplete / Done タブ付き一覧 |
|
||||
| `schedule` | 既定カレンダーにある今日の予定 |
|
||||
| `activity` | 完了数・ポイント・作業時間・集中時間、日別ヒートマップ |
|
||||
|
||||
タブはウィジェットの枠内で内容を切り替える。iframeを使わず、ページやブラウザ履歴を移動しない。タスク件名や右上の矢印は既存の詳細・一覧へ移動する。タスクの編集操作は従来の一覧・詳細画面を利用する。
|
||||
|
||||
達成率の分母は `planned_on=今日`、分子はそのうち `status=done` の件数。取りやめ・アーカイブ・プロジェクトを除く。日付はドメインのタイムゾーンで判定する。対象0件は100%でなく「—」を表示する。期限超過を含む「本日のタスク」の件数とは意図的に異なり、画面に定義を明記する。ヒートマップのポイント計算は[タスクの集計契約](task-productivity-contacts.md)に従う。
|
||||
|
||||
## 配置と保存
|
||||
|
||||
デスクトップは12列グリッド。幅は3〜12列、高さは2〜10単位、1単位の表示基準は72pxと12pxの間隔。順序に従ってグリッドへ配置するため、幅の組み合わせによって空白が生じる。任意の絶対座標を保持するレイアウトではない。
|
||||
|
||||
歯車で配置モードを開き、ハンドルのドラッグで並べ替え、右下のハンドルでサイズを変える。矢印ボタンと幅・高さの選択欄でも同じ操作が可能。追加・除去・初期配置への復帰に対応し、「配置を保存」で確定する。タブの選択も配置の一部として保存できる。未保存の離脱を警告し、保存失敗・競合時には編集中の配置を残す。ブラウザ再起動をまたぐ未保存レイアウトの下書きは持たない。
|
||||
|
||||
スマホは1列とタッチ向け操作へ切り替え、デスクトップ用の幅を上書きしない。カード内の長い一覧はスクロールする。並べ替えは矢印でも行える。幅指定とドラッグリサイズはスマホでは非表示。
|
||||
|
||||
保存は `organizer_dashboard_layouts` のDomain・本人を複合キーにし、JSONにウィジェットID・幅・高さ・選択タブだけを持つ。`task-productivity` managed migration v2でテーブルを追加する。既存v1の定義を変更しない。タスク既定値・メール同意とは別のversionを使い、配置保存が配信時刻や送信直前の同意チェックに影響しないようにする。
|
||||
|
||||
APIは `/_/api/v1/extension/organizer.tasks/` 配下。
|
||||
|
||||
| 操作 | 契約 |
|
||||
| --- | --- |
|
||||
| GET `dashboard` | `{version, widgets}`。未保存なら初期配置 |
|
||||
| PUT `dashboard` | GETしたversionとwidgetsを送る。競合412、不正422、読み取り専用403 |
|
||||
| GET `progress` | `{date, total, done}`。一覧の表示上限とは無関係にSQL集計 |
|
||||
|
||||
空配列は空のダッシュボードとして保持する。同じウィジェットの重複、未知ID、不正なタブやサイズは拒否する。新規APIは通常のセッション認証を使い、CalDAV資格情報を受け付けない。匿名には返さず、レスポンスは `private, no-store`。ダッシュボードは `organizer.tasks` の有効化に従い、カレンダー無効時は予定を取得しない。
|
||||
|
||||
## 読み込み負荷
|
||||
|
||||
ウィジェットの初期読込・全更新は最大2ジョブを並行実行し、定期ポーリングしない。タブ切替では旧リクエストを中断し、後から到着した古い応答を採用しない。タスクは1回20件のカーソルページング。予定は既存upcoming APIに `period=day` を追加し、ドメインの当日0時から翌日0時までだけを問い合わせ、最大20件を表示する。続きはカレンダー本体へ移動する。達成度は既存report APIの期間・件数上限を引き継ぐ。
|
||||
|
||||
## 検証と後続範囲
|
||||
|
||||
合成データで、所有者分離、CAS、読み取り専用、匿名拒否、管理設定への権限拡大がないこと、空配置、禁止ウィジェット、メール設定の不変、今日の集計・予定範囲を検証する。ブラウザではデスクトップとスマホの導線、タブ、設定保存、配置保存、横はみ出しを確認し、デスクトップのドラッグ・リサイズには実ポインター入力を使う。本番の外部取り込みカレンダーは検証に使わない。
|
||||
|
||||
次段階は以下を別途設計する。
|
||||
|
||||
- ウィジェットの複数インスタンス、プロジェクト等の個別フィルターと保存スキーマversion。
|
||||
- 共有ダッシュボード。個人の配置やタスク権限を暗黙に共有しない。
|
||||
- 外部プラグインウィジェットの権限宣言・実行制限・障害隔離・リソース観測。
|
||||
- 画面外ウィジェットの遅延読込と、必要時だけの変更通知による更新。
|
||||
- データ移行後の切戻し手順。旧イメージのschema checkに新しいversionを無視させず、バックアップ保全と移行検証を伴ってリリースする。
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
## 優先順
|
||||
|
||||
2026-11-02:[共通ナビゲーション・個人設定・ウィジェットダッシュボード](organizer-dashboard.md)を実装。タスク/カレンダー/連絡先の導線統一、トップ・ナビバーの連絡先、個人別の配置・サイズ保存。ソース実装と本番反映は区別し、共有・外部ウィジェットは後続。
|
||||
|
||||
2026-11-02:[個人CardDAV提供と履歴復元・一括export](../../operations/carddav-contacts.md)を実装。専用資格情報、条件付き更新、変更tokenと削除tombstone、bounded REPORTを追加。09:04:17 JSTに[v0.6.0として本番2系統へ反映](../../operations/deployments/2026-11-02-v0.6.0.md)。共有アドレス帳・外部CardDAV connector・実機互換確認は同資料の後続範囲。
|
||||
|
||||
2026-11-01:[タスク作成・作業記録・達成度・日次メール・個人アドレス帳](task-productivity-contacts.md)を追加。Web/CLI/neomuttの共通capture、時間記録、既定値、検索コマンドを接続。作業記録の事後訂正、日次メールの再送・保持期間は同設計の後続範囲へ集約する。
|
||||
|
||||
@@ -28,13 +28,13 @@ calendar-captureも同じUIDを再利用し、再送で既存予定を上書き
|
||||
|
||||
Webのタスク行の▶から開始し、上部の作業記録欄で終了する。CLIは `task start UUID` / `task stop`。タイマーはサーバーで継続するので、ブラウザや端末を閉じても止まらない。停止はタスク完了とは別操作。忘れずに終了すること。同一人物で同時に開始できる記録は1件。
|
||||
|
||||
`/v/plan/tasks/report` は完了数、ポイント、作業時間、Pomodoro集中時間を表示する。ポイントは `1 + ceil(見積分数 / 30) × 複雑度`。複雑度は1〜5、未設定の旧タスクは1。見積なしは1ポイント。完了の取消は集計から除外し、再完了するとその日の実績になる。完了済みタスクの見積変更も現在のポイントへ反映される。これは個人の振り返り指標であり、人事評価や客観的生産性の尺度ではない。
|
||||
`/v/plan/dashboard` の達成度ウィジェットは完了数、ポイント、作業時間、Pomodoro集中時間を表示する。旧 `/v/plan/tasks/report` はここへ移動する。[配置・保存の契約](organizer-dashboard.md)を参照。ポイントは `1 + ceil(見積分数 / 30) × 複雑度`。複雑度は1〜5、未設定の旧タスクは1。見積なしは1ポイント。完了の取消は集計から除外し、再完了するとその日の実績になる。完了済みタスクの見積変更も現在のポイントへ反映される。これは個人の振り返り指標であり、人事評価や客観的生産性の尺度ではない。
|
||||
|
||||
深夜をまたぐ作業はローカル日付境界で分割し、夏時間の日も24時間固定にしない。Pomodoroと手動記録は別集計で、両者を合算しない。各系列は最大10,000件で、上限到達時はpartialを返して期間の絞り込みを促す。
|
||||
|
||||
## 毎日のメール
|
||||
|
||||
`/v/plan/tasks/settings` で本人が有効化する。送信先は現在の本人のアカウントメールアドレスのみ。管理者のSMTP設定が必要。時刻はHH:mmとIANA timezoneを保存する。`task.digest.deliver` イベントが60秒周期で期限到来設定を最大20件ずつ処理する。キュー停止・負荷・SMTP遅延で配信時刻が遅れる場合がある。
|
||||
`/-/sys/config?panel=organizer` の個人設定で本人が有効化する。旧 `/v/plan/tasks/settings` もここへ移動する。送信先は現在の本人のアカウントメールアドレスのみ。管理者のSMTP設定が必要。時刻はHH:mmとIANA timezoneを保存する。`task.digest.deliver` イベントが60秒周期で期限到来設定を最大20件ずつ処理する。キュー停止・負荷・SMTP遅延で配信時刻が遅れる場合がある。
|
||||
|
||||
当日の計画・期限到来タスクを最大100件送る。件名、期限、取り組む日、見積、タスクURLを含め、メモは送らない。送信直前にアカウント状態・同意のversion・送信先を再確認する。メールによる保存・転送の可能性があるため、既定は無効。
|
||||
|
||||
|
||||
Reference in new issue
Block a user