Skip to content

finance-manager

自宅サーバ上で、PayPay / 楽天カードの支出を自動で集める。 Gemini が Discord で関西弁の確認を返し、Grafana で可視化する。

このドキュメントについて

この docs/ は Zensical 向けのコンテンツツリーである。 集約リポジトリ（docs-hub）はフォルダ構成からナビを自動生成する。 ページの追加と移動は、このリポジトリの docs/ だけ直せば足りる。

読み方（4系統）

系統 問い 入口
使い方 何を言えばいいか、予算の意味は Discord / 予算 / Grafana / Streamlit
アーキテクチャ どう動くか、数字の正本は 全体図、エージェント、スキーマ
取込 データはどこから入るか Tasker、メール、Tunnel、Discord
運用 何をすればいいか deploy、systemd、PostgreSQL、Grafana 接続

長い定義・SQL・アーカイブは 参照。

いまできること

  • Discord Bot + Gemini（テキスト／画像の支出・収入・予算）
  • 週／日の再配分ガイド（食費のみ日割り）
  • PostgreSQL 保存と Grafana / Streamlit での可視化
  • systemd 常駐（finance-manager.service。ダッシュボードは finance-dashboard.service）
  • ingest API（Bearer 設定時。Tasker 連携）

コード反映: Bot の更新（git pull + systemctl restart）。

よく使うページ

用途 ページ
Discord の言い方 Discord の使い方
予算の式 月次予算モデル
tool の使い分け Discord エージェント
テーブル定義 スキーマ
本番反映 Bot の更新
Grafana 接続 / SQL
Streamlit（LAN） ダッシュボード

ディレクトリ構成

.
├── .github/workflows/
├── src/finance_manager/
├── dashboard/          # Streamlit（LAN）
├── sql/
├── deploy/
├── scripts/
├── docs/
│   ├── guide/          # 使い方
│   ├── architecture/   # 仕組み
│   ├── intake/         # 入口
│   ├── ops/            # 手順
│   └── reference/      # 参照・アーカイブ
└── requirements.txt