Finance Manager

個人資産管理のための包括的なツールキット。取引データを処理し、高度な財務分析を実行し、実行可能なインサイトを生成し、美しいビジュアルレポートを作成します。

主な機能

1. 取引データ処理: PDF、CSV、JSONファイルから財務データを抽出
2. 財務分析: 主要メトリクスの計算、支出パターンの特定、貯金追跡
3. ビジュアライゼーション: チャートとグラフを含むインタラクティブHTMLレポートを生成
4. 予算推奨: 支出パターンに基づいたパーソナライズされた実行可能なアドバイスを提供
5. トレンド分析: 支出パターン、異常値、最適化の機会を特定

ワークフロー

1. データ抽出と準備

PDFファイルの場合:

python scripts/extract_pdf_data.py <input.pdf> <output.csv>

CSV/JSONファイルの場合:

• データに以下のカラムが含まれていることを確認: Date、Description、Income(カテゴリ)、Type、Amount
• 日付形式: YYYY-MM-DD または解析可能な日付文字列
• 金額: 収入は正の値、支出は負の値

2. 財務分析

取引データに関する包括的な分析を実行:

python scripts/analyze_finances.py <transactions.csv> > analysis_output.json

出力に含まれるもの:

• 統計サマリー(総収入、総支出、純貯金、貯金率)
• 支出トレンド(日平均、最大支出、カテゴリ割合)
• 予算推奨(支出パターンに基づくパーソナライズ)
• ビジュアライゼーションデータ(グラフ作成用に準備済み)

3. レポート生成

ビジュアライゼーション付きのインタラクティブHTMLレポートを作成:

python scripts/generate_report.py <analysis_output.json> <report.html>

レポート機能:

• 主要メトリクスを表示するサマリーダッシュボード
• カテゴリ別支出を示すインタラクティブ円グラフ
• 時系列での収入対支出を比較する棒グラフ
• カラーコード化されたインジケーター(正の場合は緑、負の場合は赤)
• パーソナライズされた推奨事項セクション
• すべてのデバイスに対応するレスポンシブデザイン

4. 完全なワークフロー例

# PDFからデータを抽出
python scripts/extract_pdf_data.py finance_data.pdf transactions.csv

# データを分析
python scripts/analyze_finances.py transactions.csv > analysis.json

# ビジュアルレポートを生成
python scripts/generate_report.py analysis.json financial_report.html

主要メトリクスとベンチマーク

貯金率

Savings Rate = (Total Income - Total Expenses) / Total Income × 100

ベンチマーク:

• 10%未満: 改善が必要
• 10-20%: 良好
• 20-30%: 優秀
• 30%以上: 卓越

カテゴリガイドライン(収入の%)

• 住宅: 25-30%
• 交通: 10-15%
• 食費: 10-15%
• 光熱費: 5-10%
• 貯金: 最低20%

詳細なフレームワークと方法論については、references/financial_frameworks.mdを参照してください。

分析機能

統計サマリー

• 期間中の総収入と総支出
• 純貯金(正または負の場合がある)
• 貯金率パーセンテージ
• 取引数
• カバーされた日付範囲

支出トレンド

• 日平均支出
• 詳細付きの最大5件の支出
• カテゴリパーセンテージ内訳
• 時系列での支出パターン

予算推奨

システムは以下に基づいてパーソナライズされた推奨事項を生成します:

• 貯金率の閾値
• カテゴリ支出パーセンテージ
• 収入の多様化
• 予算ガイドラインとの比較

推奨事項の例:

• "⚠️ あなたの貯金率は10%未満です。裁量支出を削減することを検討してください。"
• "🍽️ 食費は支出の18%です。コスト削減のための食事計画を検討してください。"
• "✅ 優秀な貯金率です。強力な財務健全性に向けて軌道に乗っています。"

ビジュアライゼーションコンポーネント

カテゴリ支出チャート(ドーナツ)

カテゴリ別の支出の割合的内訳をカラーコーディングで表示します。

収入対支出チャート(棒グラフ)

月別の収入と支出の比較を表示し、キャッシュフロートレンドを特定します。

インタラクティブ機能

• 正確な値を表示するホバーツールチップ
• 画面サイズに適応するレスポンシブデザイン
• 正の値(緑)と負の値(赤)をカラーコード化したインジケーター

最良の結果を得るためのヒント

データ品質

• すべての取引が適切にカテゴリ化されていることを確認
• カテゴリ名に一貫性を使用
• 完全な日付情報を含める
• 金額が正しく符号付けされている(収入は+、支出は-)ことを確認

分析頻度

• 月単位で分析を実行してトレンドを追跡
• 月末にレポートを生成して確認
• 月別比較で変化を特定

推奨事項への対応

• 潜在的な影響によって推奨事項を優先順位付け
• インサイトに基づいて具体的で測定可能な目標を設定
• 定期的に分析を再実行して進捗を追跡

依存関係

すべてのスクリプトはPython 3.7+と標準ライブラリが必要です。追加要件:

PDF抽出の場合:

pip install pdfplumber --break-system-packages

データ分析の場合:

pip install pandas --break-system-packages

すべてのビジュアライゼーション依存関係はHTML出力のCDNから読み込まれます(Chart.js)。

ファイル構成

finance-manager/
├── scripts/
│   ├── extract_pdf_data.py     # PDF → CSV変換
│   ├── analyze_finances.py     # 財務分析エンジン
│   └── generate_report.py      # HTMLレポートジェネレーター
└── references/
    └── financial_frameworks.md # 詳細な分析方法論

カスタマイズ

カスタムカテゴリの追加

analyze_finances.pyのカテゴリ定義を編集して、あなたの追跡システムに合わせます。

閾値の調整

generate_budget_recommendations()関数の推奨事項の閾値を変更して、個人的な目標に合わせます。

レポートのスタイル設定

generate_report.pyのHTML_TEMPLATEをカスタマイズして、色、フォント、レイアウトを調整します。

一般的なユースケース

月次レビュー: "10月の支出を分析してレポートを作成してください"

予算最適化: "どこにお金を使いすぎていますか?"

トレンド分析: "今月の支出は先月と比べてどうですか?"

目標設定: "私の貯金率はいくつで、どうすれば改善できますか?"

カテゴリインサイト: "食費を取引別に分解してください"

PDF処理: "銀行口座明細書PDFからすべての取引を抽出してください"

ベストプラクティス

1. 一貫したカテゴリ化: すべての取引で同じカテゴリ名を使用
2. 定期的な分析: 月単位で実行してトレンドを早期に発見
3. インサイトに基づく行動: 推奨事項を使用して特定の支出変更を実施
4. 進捗追跡: 月別でレポートを比較
5. データ検証: 分析前に抽出されたPDFデータの正確性を常に確認

参考資料

包括的な財務フレームワーク、予算ガイドライン、分析方法論については以下を参照:

view references/financial_frameworks.md

これには以下が含まれます:

• 50/30/20予算ルール
• カテゴリ支出ベンチマーク
• 財務健全性インジケーター
• 分析ワークフローの詳細
• ビジュアライゼーションのベストプラクティス
• 推奨事項ロジック