custom-report

カスタムレポート

概要

日付範囲、カテゴリフィルター、取引タイプ、出力形式を指定して、ニーズに合わせた財務レポートを生成します。支出の概要と取引ごとの詳細を、1つのレポートにまとめられます。

使用する Wilson ツール

• spending_summary — 指定期間のカテゴリ別支出を集計します
• transaction_search — フィルターに一致する取引の詳細を取得します
• export_transactions — レポートデータを CSV または Markdown にエクスポートします

ワークフロー

1. レポートの対象についてユーザーに確認します。
   • 日付範囲：具体的な日付、「過去3か月」、「2025年第1四半期」、「年初から現在まで」
   • カテゴリ：すべて、特定のカテゴリ、または特定のカテゴリを除外
   • 取引タイプ：支出のみ、収入のみ、または両方
   • 最低金額：任意のしきい値（例：「50ドルを超える取引のみ」）
2. spending_summary を使用して、日付範囲内のカテゴリ別集計を生成します。
3. transaction_search を使用して、フィルターに一致する個々の取引を取得します。
4. 次の内容を含むレポートを作成します。
   • 概要テーブル（カテゴリ別合計、割合）
   • 金額の大きい取引
   • カテゴリ別の取引件数と平均額
   • 冒頭に記載した日付範囲とフィルターパラメーター
5. 出力形式をユーザーに確認します。ターミナル表示、Markdown ファイル、CSV エクスポートから選べます。
6. Markdown または CSV の場合は、export_transactions を使用してファイルを書き出します。

Wilson を使用しない場合

スプレッドシートでカスタムレポートを作成できます。

Google Sheets / Excel の設定

1. Date、Description、Amount、Category の列を含むシートに取引データをインポートまたは貼り付けます。
2. 日付によるフィルタリング：フィルターを追加するか、2025年第1四半期の場合は =FILTER(A:D, A:A >= DATE(2025,1,1), A:A <= DATE(2025,3,31)) を使用します。
3. カテゴリ別の集計ピボットテーブル：
   • データを選択 > 挿入 > ピボット テーブル
   • 行：Category
   • 値：Amount の SUM、Amount の COUNT
   • フィルター：日付範囲
4. 手動での集計数式：

   Total Expenses:  =SUMIFS(C:C, C:C, "<0", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
   Total Income:    =SUMIFS(C:C, C:C, ">0", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
   Category Total:  =SUMIFS(C:C, D:D, "Groceries", A:A, ">="&DATE(2025,1,1), A:A, "<="&DATE(2025,3,31))
   

5. 金額の大きい取引：Amount の順に並べ替え（金額の大きい支出を確認する場合は昇順）し、上位10件を取り出します。

CLI の代替方法（csvkit）

# Filter by date range
csvgrep -c Date -r "2025-0[1-3]" transactions.csv | csvsort -c Amount | head -20
# Summary by category
csvstat -c Amount --group Category transactions.csv

重要な注意事項

• 日付範囲の開始日と終了日は、どちらも含まれます。
• 支出の概要では、読みやすさを高めるため、絶対値（正の数）で表示します。
• データを再インポートしなくても、パラメーターを変えてレポートを再生成できます。
• Markdown エクスポートには、レポートのメタデータ（生成日、適用したフィルター）を含む YAML ヘッダーが付属します。