夫婦で使う家計簿アプリ、あったらいいので作ります。④ Webアプリの全体設計と技術の選び方

家計簿アプリ

前回は、家計簿アプリを毎日使いやすくするための画面設計や入力の工夫について紹介しました。

今回からは、いよいよ技術的な部分に入っていきます。

まずは、今回の家計簿アプリがどのような技術を使い、どういう仕組みで動いているのかを紹介します。

今回作ったのは、夫婦それぞれのiPhoneから同じ家計簿を利用できるWebアプリです。

自宅のUbuntu PCをサーバーとして動かし、外出先からもアクセスできるようにしています。

また、通信できないときにも家計簿を入力できる仕組みも取り入れました。

そのために使用したのが、FastAPI・SQLite・PWA・Tailscaleなどの技術です。

聞き慣れない名前もあるかもしれませんが、それぞれの役割は比較的シンプルです。

今回は、実際の構成をもとに、各技術の役割や採用した理由、データの流れを紹介します。


家計簿アプリの全体構成

まずは、今回のアプリの全体像です。

大きく分けると、スマートフォン側とサーバー側の2つで構成しています。

スマートフォンでは画面の表示や入力を行い、サーバーではデータの保存や集計、清算などの処理を行います。

使用している主な技術は次のとおりです。

技術主な役割
HTML / CSS / JavaScript画面の表示や操作
PWAWebアプリをスマホアプリのように利用
IndexedDBスマホ内にデータを保存
FastAPIデータの受付や家計簿の処理
SQLite支出や設定などのデータ保存
Ubuntuアプリを常時動かすサーバー
Tailscale外出先から自宅サーバーへの接続

それぞれの技術を組み合わせることで、夫婦2人のスマートフォンから同じ家計簿を使えるようにしました。

ここからは、各技術について簡単に紹介します。


FastAPIとは?PythonでWebアプリを動かす仕組み

まず、家計簿アプリの中心となるバックエンドについてです。

今回採用したFastAPIは、PythonでWeb APIを作成できるフレームワークです。

APIとは、アプリ同士がデータをやり取りするための窓口のようなものです。

例えば、スマートフォンから家計簿に2,000円の支出を登録したとします。

このとき、スマートフォンから送られてきたデータを受け取り、保存する処理を行うのがバックエンドの役割です。

今回のアプリでは、主に次のような処理を担当しています。

  • 支出・収入の登録や取得
  • カテゴリごとの予算集計
  • 夫婦間の清算額の計算
  • 固定費やNISAの管理
  • スマートフォンとのデータ同期

なぜFastAPIを選んだのか

一番の理由は、普段からPythonを使って開発していることです。

使い慣れた言語を使えば、新しく覚えることを減らしながら開発できます。

また、FastAPIはAPIを比較的簡単に作成でき、入力データの検証やAPIドキュメントの自動生成にも対応しています。

今回のように、スマートフォンとサーバーでデータをやり取りするアプリには使いやすいと考え、採用しました。


SQLiteとは?家計簿のデータを保存する仕組み

次に、データを保存するための仕組みです。

今回採用したSQLiteは、データベースを1つのファイルとして管理できる仕組みです。

データベースとは、たくさんの情報を整理して保存し、必要なときに取り出せるようにするものです。

今回のアプリでは、支出の履歴や予算、支払い方法、NISAの積立記録などを保存しています。

例えば、支出を登録すると、金額や日付、カテゴリ、支払者などの情報がSQLiteに保存されます。

そのデータを使って、予算の残額や夫婦間の清算額を計算しています。

なぜSQLiteを選んだのか

今回のアプリは夫婦2人で利用するものなので、大規模なデータベースは必要ありません。

SQLiteであれば、MySQLなどのように別のデータベースサーバーを用意する必要がなく、Pythonから簡単に利用できます。

また、データベースをファイルとして管理できるため、バックアップや別のPCへの移行も比較的簡単です。

利用する人数や規模に合わせて、必要以上に複雑な仕組みにしないことを意識しました。


PWAとは?Webアプリをスマホアプリのように使う

今回の家計簿は、iPhoneから利用することを前提にしています。

そこで採用したのが、PWAという仕組みです。

PWA(Progressive Web App)は、Webアプリをスマートフォンのアプリに近い感覚で利用できるようにする技術です。

例えば、iPhoneのホーム画面にアイコンを追加し、そこから家計簿を起動できます。

通常のWebサイトのように、毎回ブラウザでURLを入力する必要がありません。

また、Service Workerという仕組みを使うことで、画面の表示に必要なファイルを端末内に保存できます。

さらに、IndexedDBというブラウザ内のデータベースを組み合わせることで、通信できないときにも支出を記録できるようにしました。

なぜPWAを採用したのか

開発を始めたとき、iPhone専用アプリを作ることも考えました。

しかし、今回利用するのは夫婦2人だけです。

App Storeで一般公開する予定もなかったため、開発や運用が比較的簡単なWebアプリを選びました。

PWAなら、Web技術を使いながらスマートフォンでも使いやすいアプリを作れます。

今回の用途では、ネイティブアプリを作るよりも手軽な方法だと考えました。


Tailscaleとは?外出先から自宅サーバーに接続する

今回の家計簿アプリは、自宅のUbuntu PCで動かしています。

そのため、外出先からどうやってアクセスするかを考える必要がありました。

そこで採用したのがTailscaleです。

Tailscaleは、複数の端末をVPNでつなぎ、プライベートなネットワークを簡単に構築できるサービスです。

VPNとは、離れた場所にある端末同士を、安全な通信経路で接続するための仕組みです。

今回の場合、自宅のUbuntu PCと夫婦それぞれのiPhoneにTailscaleを導入しています。

これにより、外出先からも自宅のサーバーにアクセスできます。

なぜTailscaleを選んだのか

通常、自宅のサーバーを外部から利用するには、ルーターの設定やネットワークの構築が必要になることがあります。

Tailscaleを使えば、比較的簡単にVPNを構築でき、ルーターのポート開放も必要ありません。

また、家計簿には個人的なお金の情報が保存されています。

そのため、誰でもアクセスできるWebサイトとして公開するのではなく、許可した端末からだけ利用する構成にしました。

できるだけ簡単に運用でき、家計簿の情報を不特定多数に公開しないことを重視して採用しています。


ソースコードも役割ごとに分ける

ここまで紹介した技術を使って、実際に家計簿アプリを作成しています。

ただ、支出管理や予算管理、清算、NISAなどの機能をすべて1つのファイルに書いてしまうと、コードが複雑になってしまいます。

そこで、今回のアプリでは役割ごとにファイルを分けています。

実際のソースコードの主な構成は次のとおりです。

app/
├── main.py
├── database.py
├── schemas.py
│
├── routers/
│   ├── transactions.py
│   ├── summary.py
│   ├── settings.py
│   └── sync.py
│
├── transaction_service.py
├── settlement_service.py
│
├── templates/
│   ├── input.html
│   ├── summary.html
│   └── ...
│
└── static/
    ├── css/
    ├── js/
    └── service-worker.js

※主要なファイルのみ抜粋しています。

それぞれの役割は次のようになっています。

ファイル役割
main.pyFastAPIの起動設定
routers/APIへのアクセスを受け付ける
service.py系家計簿の計算や登録処理
database.pySQLiteの接続や初期化
schemas.py入力データの検証
templates/HTML画面
static/JavaScript・CSSなど

例えば、夫婦間の清算計算は settlement_service.py にまとめています。

一方、清算結果を表示する画面はHTMLやJavaScriptで管理しています。

こうすることで、清算ルールを変更するときと、画面のデザインを変更するときで、修正する場所を分けられます。

機能が増えても、できるだけ修正しやすい構成にすることを意識しました。

具体的なAPIの作り方やコードの実装は、次回以降の記事で紹介します。


実際に支出を登録するときの流れ

最後に、ここまで紹介した技術がどのようにつながっているのかを見てみます。

例えば、妻がスーパーで2,000円の食材を購入し、家計簿に登録する場合です。

まず、iPhoneの入力画面で金額やカテゴリ、支払者などを選択します。

登録ボタンを押すと、JavaScriptが入力内容を取得し、最初にiPhone内のIndexedDBへ一時保存します。

ここが今回のアプリの特徴です。

オンラインでもオフラインでも、まず端末内に保存することで、通信が完了するのを待たずに次の入力へ進めます。

その後、サーバーに接続できる場合は、Tailscale経由でFastAPIへデータを送信します。

FastAPIは受け取ったデータを確認し、SQLiteに保存します。

保存された支出は、まとめ画面で予算を集計するときや、夫婦間の清算額を計算するときに利用します。

例えば、食費の予算が40,000円で、それまでに10,000円使っていた場合、今回の2,000円を登録すると残り予算は28,000円になります。

また、妻が支払った2,000円は、毎月の清算にも反映されます。

一方、通信できない場合は端末内にデータを残しておき、再び接続できるようになったら同期します。

このように、1回の入力を、支出履歴・予算管理・清算処理に共通して利用できる仕組みにしました。

オフラインでの保存や同期処理については、別の記事で詳しく紹介します。


まとめ

今回は、夫婦で使う家計簿アプリの全体構成と、使用している技術について紹介しました。

今回の開発では、次のような考え方を大切にしています。

  • 夫婦2人で使うため、できるだけシンプルな技術構成にする
  • 使い慣れたPythonやWeb技術を活用する
  • 画面・処理・データ保存の役割を分ける
  • 自宅サーバーでも安全かつ手軽に使えるようにする
  • 通信できない場合にも支出を記録できるようにする

FastAPIやSQLite、PWA、Tailscaleなど、それぞれの技術自体は珍しいものではありません。

しかし、これらを組み合わせることで、自分たちに必要な家計簿アプリを実現できました。

今回も、必要な機能を、できるだけシンプルな仕組みで実現することを意識しています。

次の記事では、今回紹介したFastAPIについて、実際のソースコードを使いながら、APIの設計やバックエンドの実装方法を詳しく紹介します。


関連記事

コメント

タイトルとURLをコピーしました