Skip to content

finance-manager

PayPay / 楽天カードの支出を自動で集め、Gemini が Discord で厳し目フィードバックし、Grafana で可視化する自宅サーバ向けお金マネジメント。

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

この docs/ は Zensical 向けのコンテンツツリーです。 集約用リポジトリへコピーしたあと、ハブ側の zensical.toml でナビとビルドを定義する想定です。 ページ間リンクはすべて相対パスなので、docs/finance-manager/ のようにネストしても解決できます。

ハブ側では admonition / pymdownx.details と navigation.indexes を有効にしてください。 フォルダ名順だとナビが意図とずれるので、明示ナビにするのがおすすめです。

例（このツリーを docs/finance-manager/ に置いた場合）:

{ "finance-manager" = [
  "finance-manager/index.md",
  { "概要" = [
    "finance-manager/overview/index.md",
    "finance-manager/overview/requirements.md",
    "finance-manager/overview/architecture.md",
  ]},
  { "セットアップ" = [
    "finance-manager/setup/index.md",
    "finance-manager/setup/postgres-setup.md",
    "finance-manager/setup/bot-dev.md",
    "finance-manager/setup/systemd.md",
  ]},
  { "インフラ" = [
    "finance-manager/infrastructure/index.md",
    "finance-manager/infrastructure/cloudflare.md",
  ]},
  { "データ取込" = [
    "finance-manager/ingestion/index.md",
    "finance-manager/ingestion/discord.md",
    "finance-manager/ingestion/email-ingestion.md",
    "finance-manager/ingestion/android-tasker.md",
  ]},
  { "家計" = [
    "finance-manager/finance/index.md",
    "finance-manager/finance/expense-db.md",
    "finance-manager/finance/income.md",
    "finance-manager/finance/budget.md",
    "finance-manager/finance/grafana.md",
  ]},
  { "Gemini" = [
    "finance-manager/ai/index.md",
    "finance-manager/ai/gemini.md",
  ]},
]}

いまの実装状況

  • Discord Bot + Gemini の会話 + 支出の DB 保存（src/finance_manager）
  • 画像解析・Tasker / IMAP・systemd 常駐はこれから

起動手順は Bot 開発 を参照。

ドキュメント構成

セクション 内容
概要 ビジョン、前提、全体構成
セットアップ 初期準備、PostgreSQL、Bot、systemd
インフラ Proxmox、Cloudflare Tunnel / Access
データ取込 通知、メール、Discord、Tasker
家計 支出、収入、予算、Grafana
Gemini プロンプト、schema、Vision