dla-docs

やることリスト

1. 目的

やることリストモジュールは、定期的なタスクを管理し、完了進捗を追跡するのに役立ちます：

時間ベースの定期的なタスク（日次/週次/月次/年次）
指標ベースの定期的なタスク（マイル/時間/回数…）
期日時のリマインド
完了履歴の追跡
支出の記録（該当する場合）

このモジュールは、車のメンテナンス、フィルター交換、定期点検などの重要なタスクを見逃さないようにします。

2. 使用するタイミング

以下の場合にこのモジュールを使用します：

スケジュールに沿って繰り返すタスク（例：3ヶ月ごとに浄水器フィルターを交換）
指標に基づいて繰り返すタスク（例：3,000マイルごとに車のオイルを交換）
期日時に自動リマインドが必要
完了履歴を追跡したい
関連する支出を記録する必要がある

3. 関連画面

やることリスト画面
タスクタイプを選択（時間ベース / 指標ベース）
新しいやることの追加
やることの編集
指標ベースのタスクを確認
やることの履歴
期日タスクリスト（ベルリスト）

4. 主な使用方法

4.1 時間ベースのやることを追加

機能 → やることリストを選択
右下の + (FAB) ボタンをタップ
時間ベースのやることを選択
情報を入力：
- タスク名: （必須、例：「浄水器フィルターを交換」）
- 繰り返しサイクル: 数値を入力し、単位を選択（日/週/月/年）
- 次の期日: 日付を選択（明日以降のみ選択可能）
- リマインド時間: 時間を選択（必須、例：08:00）
- このタスクには支出が発生: （任意）支出がある場合はチェック
  - チェックした場合: カテゴリを選択（必須）
- メモ: 追加情報（任意）
保存をタップ

4.2 指標ベースのやることを追加

機能 → やることリストを選択
+ (FAB) ボタンをタップ
指標ベースのやることを選択
情報を入力：
- タスク名: （必須、例：「車のオイルを交換」）
- サイクル: 数値を入力（例：3,000）
- 単位: 単位を入力（例：「マイル」）
- 最後に完了した指標値: 現在の値を入力（例：12,500）
- このタスクには支出が発生: （任意）支出がある場合はチェック
  - チェックした場合: カテゴリを選択（必須）
- メモ: 追加情報（任意）
保存をタップ

4.3 指標ベースのタスクを確認

やることリストに移動
確認する指標ベースのタスク（METRICタイプ）を探す
カードの確認ボタンをタップ（isActive = trueの場合のみ表示）
情報を入力：
- 現在の指標値: 現在の値を入力（必須、最後に完了した指標値以上である必要があります）
- メモ: （任意）
デルタが自動計算されるのを確認（現在の値 - 最後に完了した値）
確認済みをタップ
（タスクに支出がある場合）支出を追加またはキャンセルを選択

注意: 時間ベースのタスク（CYCLEタイプ）には、カードに「確認」ボタンがありません。確認は「期日タスク」（ベルリスト）画面でのみ行われます。

4.4 リストと詳細を表示

機能 → やることリストを選択
検索バーを使用してタスク名で検索
フィルタチップを使用してフィルタリング：
- すべて: すべてのタスクを表示
- 時間ベース: CYCLEタイプのタスクのみ表示
- 指標ベース: METRICタイプのタスクのみ表示
タスクカードをタップして詳細を表示し、編集

4.5 やることを編集

やることリストに移動
編集するタスクカードをタップ
情報を更新：
- メモ: 履歴がある場合、サイクル（CYCLE）または単位/サイクル（METRIC）はロックされ、編集できません
保存をタップ

4.6 履歴を表示

やることリストに移動
表示するタスクの履歴を表示 ›リンクをタップ
フィルタチップを使用して時間でフィルタリング：
- すべて: すべての履歴を表示
- 今月: 今月の履歴のみ表示
- 先月: 先月の履歴のみ表示
- 過去3ヶ月: 過去3ヶ月の履歴のみ表示

4.7 タスクを無効化/有効化

やることリストに移動
無効化/有効化するタスクを探す
カードフッターのアクティブスイッチを切り替え
無効化されたタスクは「無効」バッジ（グレー）を表示します

4.8 やることを削除

やることリストに移動
カードヘッダーの削除アイコン（🗑️）をタップ
ダイアログで削除を確認
タスクとすべての関連履歴が削除されます

5. 例とUI図解

TODO-01: 時間ベースのやることを作成（浄水器フィルターを交換）

目標: 時間ベースのやることを作成して、期日時にアプリが自動的にリマインドします。

主な手順:

機能 → やることリスト → “+” (FAB) ボタンをタップ
「時間ベースのやること」を選択
タスク名を入力: 「浄水器フィルターを交換」
サイクルを入力: 「3」ヶ月
次の期日を選択: 2026/03/01
リマインド時間を選択: 08:00
「このタスクには支出が発生」にチェック、カテゴリ「光熱費」を選択
メモを入力: 「フィルター#1と#2を交換」
「保存」をタップ

ワイヤーフレーム - 時間ベースのやること追加画面:

┌──────────────────────────────────────────────┐
│ <  時間ベースのやることを追加                 │
├──────────────────────────────────────────────┤

タスク名
[ 浄水器フィルターを交換            ]

繰り返しサイクル
[ 3 ] ごとに [ 月 ▼ ]
（単位: 日 / 週 / 月 / 年）

次の期日
[ 2026 / 03 / 01    ▼ ]
ヒント: 
初回の期日。
以降の日付は、入力したサイクルに基づいて自動計算されます。

リマインド時間
[ 08 : 00           ▼ ]

──────────────────────────────────────────────
[✓] このタスクには支出が発生

┌─────────────────────────────────────┐
│ カテゴリ *                           │
│ [光熱費 ▼] [+ 新規作成]             │
└─────────────────────────────────────┘

──────────────────────────────────────────────
メモ（任意）
[                                          ]
[                                          ]
[                                          ]

──────────────────────────────────────────────
[ キャンセル ]                         [ 保存 ]
└──────────────────────────────────────────────┘

TODO-02: 指標ベースのやることを作成（車のオイルを交換）

目標: 走行距離に基づいて車のメンテナンスを追跡するために指標ベースのやることを作成します。

主な手順:

機能 → やることリスト → “+” (FAB) ボタンをタップ
「指標ベースのやること」を選択
タスク名を入力: 「車のオイルを交換」
サイクルを入力: 「3,000」、単位: 「マイル」
最後に完了した指標値を入力: 「12,500」
「このタスクには支出が発生」にチェック、カテゴリ「車のメンテナンス」を選択
メモを入力: 「オイル + オイルフィルターを交換」
「保存」をタップ

ワイヤーフレーム - 指標ベースのやること追加画面:

┌──────────────────────────────────────────────┐
│ <  指標ベースのやることを追加                │
├──────────────────────────────────────────────┤

タスク名
[ 車のオイルを交換                        ]

サイクル
[ 3,000 ] ごとに 単位 [ マイル ]
（単位: マイル / 時間 / 回数 / ...）

最後に完了した指標値
[ 12,500 ]

──────────────────────────────────────────────
[✓] このタスクには支出が発生

┌─────────────────────────────────────┐
│ カテゴリ *                           │
│ [車のメンテナンス ▼] [+ 新規作成] │
└─────────────────────────────────────┘

──────────────────────────────────────────────
メモ（任意）
[                                          ]
[                                          ]
[                                          ]

──────────────────────────────────────────────
[ キャンセル ]                         [ 保存 ]
└──────────────────────────────────────────────┘

TODO-03: リストと詳細を表示

目標: やることの概要を表示し、タイプでフィルタリングし、検索し、各タスクの詳細を表示します。

主な手順:

機能 → やることリストに移動
検索バーとフィルタチップ付きのリストを表示
フィルタを使用: 「すべて」、「時間ベース」、「指標ベース」
検索バーを使用してタスク名で検索
タスクカードをタップして詳細を表示

ワイヤーフレーム - やることリスト画面:

┌─────────────────────────────────────────────────────────┐
│  [← 戻る]  やることリスト                        [🔔]        │
└─────────────────────────────────────────────────────────┘
│  🔍 検索...                                             │
│                                                          │
│  [すべて] [時間ベース] [指標ベース]                     │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ カード: 浄水器フィルターを交換                      │    │
│  │ ┌─────────────────────────────────────────────┐ │    │
│  │ │ 浄水器フィルターを交換    [完了] [🗑️]       │ │    │
│  │ │                                              │ │    │
│  │ │ 📅 サイクル: 3ヶ月ごと                       │ │    │
│  │ │ ✅ 最後に完了: 2025/12/01                    │ │    │
│  │ │ 📅 次の期日: 2026/03/01                      │ │    │
│  │ │ ⏳ 残り76日                                   │ │    │
│  │ │ ───────────────────────────────────────────── │ │    │
│  │ │ 履歴を表示 ›                     [⚪ アクティブ]│ │    │
│  │ └─────────────────────────────────────────────┘ │    │
│  └─────────────────────────────────────────────────┘    │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ カード: 車のオイルを交換                          │    │
│  │ ┌─────────────────────────────────────────────┐ │    │
│  │ │ 車のオイルを交換                   [🗑️]      │ │    │
│  │ │                                              │ │    │
│  │ │ 📏 追跡単位: マイル                           │ │    │
│  │ │ ✅ 最後に確認: 2025/12/02                    │ │    │
│  │ │ 🔢 最後の指標値: 12,500マイル                │ │    │
│  │ │ 🎯 次の期日: 14,500マイル                    │ │    │
│  │ │ ⏳ 残り約300マイル                            │ │    │
│  │ │ ───────────────────────────────────────────── │ │    │
│  │ │ [✓ 確認]                                      │ │    │
│  │ │ ───────────────────────────────────────────── │ │    │
│  │ │ 履歴を表示 ›                     [⚪ アクティブ]│ │    │
│  │ └─────────────────────────────────────────────┘ │    │
│  └─────────────────────────────────────────────────┘    │
│                                                          │
│  [+ FAB]                                                 │
└─────────────────────────────────────────────────────────┘

TODO-04: 指標ベースのタスクを確認（車のオイルを交換）

目標: 現在の指標値を入力して指標ベースのタスクの完了を確認します。

主な手順:

やることリストに移動
「車のオイルを交換」タスク（METRICタイプ）を探す
「確認」ボタンをタップ
現在の指標値を入力: 「14,520」
自動計算されたデルタを確認: 「+2,020マイル」
メモを入力: 「オイル + オイルフィルターを交換」
「確認済み」をタップ

ワイヤーフレーム - 指標ベースのタスク確認ダイアログ:

┌──────────────────────────────────────────────┐
│  指標ベースのタスクを確認                      │
├──────────────────────────────────────────────┤

タスク名:
車のオイルを交換   （読み取り専用）

追跡単位:
マイル   （読み取り専用）

最後に完了した指標値:
12,500マイル   （読み取り専用）

──────────────────────────────────────────────
現在の指標値
[ 14,520 ] マイル

デルタ:
+2,020マイル   （自動）

──────────────────────────────────────────────
メモ
[                                          ]
[                                          ]
[                                          ]

──────────────────────────────────────────────
        [ 未確認 ]    [ 確認済み ]
└──────────────────────────────────────────────┘

TODO-05: やることを編集し、履歴を表示

目標: やることの情報を編集し、完了履歴を表示します。

主な手順:

やることリストに移動
「浄水器フィルターを交換」タスクカードをタップ
警告を確認: 「⚠️ 履歴があるためサイクルはロックされています」（履歴が存在する場合）
次の期日、リマインド時間、メモを編集
「保存」をタップ
「履歴を表示 ›」をタップしてフィルタ付きの履歴を表示

ワイヤーフレーム - やること履歴画面:

┌─────────────────────────────────────────────────────────┐
│  [← 戻る]  やること履歴 - 浄水器フィルターを交換          │
└─────────────────────────────────────────────────────────┘
│  [すべて] [今月] [先月] [過去3ヶ月]                      │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ 浄水器フィルターを交換            [完了]          │    │
│  │                                                  │    │
│  │ 📅 サイクル: 3ヶ月ごと                           │    │
│  │ ✅ 完了日: 2025/12/01 – 09:10                 │    │
│  │ 📝 メモ: フィルター#1と#2を交換                  │    │
│  └─────────────────────────────────────────────────┘    │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │ 浄水器フィルターを交換            [完了]          │    │
│  │                                                  │    │
│  │ 📅 サイクル: 3ヶ月ごと                           │    │
│  │ ✅ 完了日: 2025/09/01 – 08:45                 │    │
│  └─────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────┘

TODO-06: やることを無効化および削除

目標: 不要になったやることを無効化または削除します。

主な手順:

やることリストに移動
無効化するタスクを探す
「アクティブ」スイッチをタップしてオフにする
「無効」バッジが表示されるのを確認
スイッチを再度タップして再有効化
削除アイコン（🗑️）をタップしてタスクを削除
ダイアログで削除を確認

TODO-07: 指標ベースのタスクを確認し、支出を追加

目標: 指標ベースのタスクを確認し、関連する支出を自動的に追加します。

主な手順:

やることリストに移動
「車のオイルを交換」タスクを探す（METRICタイプ、hasCost = true）
「確認」ボタンをタップ
現在の指標値を入力: 「14,520」
メモを入力: 「オイル + オイルフィルターを交換」
「確認済み」をタップ
「支出が発生しましたか？」ダイアログが自動的に開くのを確認
「支出を追加」をタップ
メモとカテゴリが事前入力された「支出を追加」画面を確認
金額を入力: ¥5,000
「保存」をタップ

ワイヤーフレーム - 支出発生ダイアログ:

┌──────────────────────────────────────────────┐
│  支出が発生しましたか？                      │
├──────────────────────────────────────────────┤
この完了に対して支出を追加しますか？

        [ キャンセル ]         [ 支出を追加 ]
└──────────────────────────────────────────────┘

6. ロジックとルール

6.1 やることのタイプ

時間ベース（CYCLEタイプ）:
- スケジュールに沿って繰り返す（日/週/月/年）
- 期日時にリマインド通知がある
- 確認は「期日タスク」（ベルリスト）画面でのみ行われます
- カードに「確認」ボタンがない
指標ベース（METRICタイプ）:
- 指標のマイルストーンに基づいて繰り返す（マイル/時間/回数/その他）
- 通知なし（MVP1）
- カードに「確認」ボタンがある（isActive = trueの場合のみ表示）
- 現在の指標値を入力して確認

6.2 やることのステータス

PENDING: 近日中（まだ期日ではない）
- バッジなし: nextDueDate - today > 7日
- 「近日中」バッジ（黄色）を表示: 0 < nextDueDate - today ≤ 7日
OVERDUE: 期限切れ（赤） - nextDueDate < todayで確認されていない
NOT_COMPLETED: 未完了（オレンジ） - 期日だが確認されていない
COMPLETED: 完了（緑） - 確認済み
CANCELLED: キャンセル済み（グレー） - この発生がキャンセルされた
INACTIVE: 無効（グレー） - isActive = false

6.3 サイクル/単位のロック

履歴がある場合（履歴レコード）：
- CYCLEタイプ: サイクルがロックされ、編集できません
- METRICタイプ: 単位とサイクルがロックされ、編集できません
警告を表示: 「⚠️ 履歴があるためサイクルはロックされています」または「⚠️ 履歴があるため単位はロックされています」

6.4 指標ベースのタスクを確認

検証:
- 現在の指標値は最後に完了した指標値以上である必要があります
- 無効な場合: エラー「現在の指標値は最後に完了した指標値以上である必要があります」を表示
自動更新:
- lastMetricValue = 現在の値
- nextMetricValue = 現在の値 + サイクル
- lastCompletedDate = 今日
支出:
- hasCost = trueの場合: 確認成功後に「支出が発生しましたか？」ダイアログを表示
- initialNote、initialCategoryId、todoHistoryIdで「支出を追加」画面に移動

6.5 通知

CYCLEタイプ:
- タスクを作成/編集する際に通知がスケジュールされます
- タスクを無効化または削除する際に通知がキャンセルされます
- 再有効化する際に通知が再スケジュールされます（nextDueDate >= todayの場合）
METRICタイプ: 通知なし（MVP1）

6.6 次の期日を計算

CYCLEタイプ:
- 確認後、サイクルに基づいて次の期日が自動計算されます
- 例: サイクル3ヶ月、期日2026/03/01 → 確認後、次の期日 = 2026/06/01
METRICタイプ:
- 次の期日 = 現在の値 + サイクル
- 例: 現在の値14,520マイル、サイクル3,000マイル → 次の期日 = 17,520マイル

7. 重要な注意事項

確認ボタン:
- 時間ベースのタスク（CYCLE）: カードに「確認」ボタンがありません。確認は「期日タスク」（ベルリスト）画面でのみ行われます。
- 指標ベースのタスク（METRIC）: カードに「確認」ボタンがあります（isActive = trueの場合のみ表示）。
ベルアイコン: ヘッダーのベルアイコンは「期日タスク」（ベルリスト）画面に移動し、ユーザーが期日タスクを確認できます（CYCLEタイプのみ）。
サイクル/単位のロック: 履歴がある場合、サイクル（CYCLE）または単位/サイクル（METRIC）がロックされ、データの一貫性を確保するために編集できません。
指標の検証: 指標ベースのタスクを確認する際、現在の指標値は最後に完了した指標値以上である必要があります。そうでない場合、アプリがエラーを表示し、確認を防ぎます。
発生した支出: タスクに支出がある場合（hasCost = true）、確認成功後、アプリが支出を追加するかどうかを尋ねます。「支出を追加」を選択した場合、アプリが自動的にメモとカテゴリを事前入力します。
タスクの削除: タスクを削除する際、すべての関連履歴も削除されます（カスケード削除）。通知もキャンセルされます。
無効化: CYCLEタイプのタスクを無効化する際、通知がキャンセルされます。再有効化する際、通知が再スケジュールされます（nextDueDate >= todayの場合）。
プレミアムアクセス: このモジュールにはプレミアムアクセスが必要です。プレミアムがない場合、アプリがアップグレードを要求するダイアログを表示します。