CatHand Blog

ローカル家計簿アプリ作りました

#家計簿 #自作ツール #Next.js #SQLite #Prisma #React #Tailwind CSS #資産管理

MoneyForwardの不正アクセス事件をきっかけにローカル家計簿アプリを作った

銀行、クレジットカード、証券、DC の口座をまとめて管理する、自分用のローカル家計簿アプリを作りました。household-money で公開しています。

各機関のサイトから落とした CSV / PDF / HTML を取り込んで、資産推移、取引明細、ポートフォリオを見られるようにするものです。データは手元の SQLite ファイル 1 個に入ります。

作ったきっかけ

MoneyForward の不正アクセスの件をきっかけに、手元だけで動く家計簿アプリを作ることにしました。

対応している機関

いまのところ、次の機関に対応しています。

どう動くか

使う流れはこんなかんじです。

  1. /accounts で各機関の口座を登録します。
  2. /import に CSV / PDF / HTML をドラッグ&ドロップします。どの機関のファイルかは自動で判定して、口座が 1 つならそれを選びます。
  3. プレビューを見て、よければ「この内容で取り込む」を押します。
  4. ダッシュボード(/)で資産推移のグラフ、月ごとの収支、カテゴリごとの集計を見ます。/portfolio では銘柄を口座をまたいで集計して、構成比を出します。

取り込みは機関ごとにアダプタを書いて登録する作りです。アダプタはファイルの中身を見て「自分のファイルっぽいか」を数値で返すので、それで機関を判定しています。

文字コードは Shift_JIS / UTF-8 / JIS を自動で判定します。BOM があれば UTF-8、JIS の開始シーケンスがあれば JIS、どちらでもなければ Shift_JIS と UTF-8 の両方でデコードしてみて、化けた文字が少ないほうを採ります。

同じデータを 2 回取り込まないように、重複は 2 段階で弾いています。

カテゴリ分けのルール

明細のカテゴリはルールで自動で振り分けます。ルールは相手先やメモへの部分一致か正規表現で書き、金額の範囲で絞ることもできます。ルールを直したあとは、既存の明細に全件まとめて再適用できます。

明細の画面でカテゴリを選ぶと、そのままルール化のダイアログが開きます。相手先の文字列からパターンの候補を作って並べるので、選ぶだけでルールになり、ほかの未分類の明細にもまとめて適用されます。

候補の作り方は次のとおりです。

それぞれにスコアを付けて、上位 5 件を出しています。

技術スタック

セットアップは .env.example を .env にコピーして npm run setup を実行するだけです。依存のインストール、DB の作成とマイグレーション、機関とカテゴリの初期データの投入までをまとめてやります。何度実行しても大丈夫なので、更新を取り込むときも git pull のあとに同じコマンドを流せば済みます。

注意

このアプリには認証も暗号化も入っていません。DB は平文の SQLite ファイルで、画面を開ければ誰でも全部のデータを見たり書き換えたりできます。自分のマシンの中か、信頼できる自分だけの LAN の中で動かしてください。

あくまで個人用の実験的なもので、無保証です。集計した値が金融機関の記録と合うことは保証しないので、取り込んだあとは明細の画面で検算してください。税金の申告など、正確さが必要な用途には使わないでください。

2026-10 より前の記事は Tumblr にあります。