facto

家族会計ツール

家族会計ツールは、家族が行うすべての取引を追跡します。その目標は次のとおりです。

• データから有用な統計を抽出します
  例：毎月食べ物にいくら費やされていますか？
• 内部債務を計算します
  例：アリスは家族全員のためにトイレットペーパーを自分のお金で購入します。このツールは、家族がアリスにトイレットペーパーのコストを負っていることを登録します。
• 予期しない費用でお金が消えていないかどうかを確認する方法を提供する
  例：隠された銀行費用があることに気付くでしょう

スクリーンショット

リリースからのインストール

• サーバーにJava 11（JDK 11）をインストールします
• 最新リリースから「デモ構成を備えたバイナリ（コンパイルされたファイル）」をダウンロード
• アーカイブを開梱します
• 開梱されているフォルダーでconf/application.confを開きます。
  • データベースを構成します。最も簡単な方法は、MariadBサーバーをローカルにセットアップし、 factoと呼ばれる空のデータベースを作成し、次のように構成することです。

 db.default {
  driver = com.mysql.jdbc.Driver
  url = "jdbc:mysql://localhost/facto?user=mysqluser&password=mysqlpassword"
  slick.profile = "slick.jdbc.MySQLProfile$"
}

• play.http.secret.keyおよびapp.setup.defaultPasswordの秘密の値を選択します

• 未梱包されたフォルダーに端子を開きます

• 次のコマンドを実行して、アプリを実行します。

   # Create database tables
  bin/server -DdropAndCreateNewDb
  
  # Create admin user
  bin/server -DcreateAdminUser
  
  # Run application
  bin/server
  

• http：// localhost：9000/app/useradministration（username： "admin"、password： "changeme"）を参照してください。

Dockerでのインストール（落胆）

警告：デモサーバーを起動するために、次のように機能します。ただし、実際のデータとカスタム構成を備えたサービスとしてこれを実行する場合は、代わりに「リリースからのインストール」セクションに従うことをお勧めします（理由については、この問題を参照してください）。

次のコマンドは、Dockerコンテナのデータベースとともに新しいサーバーを起動します。

 # Get the docker-compose.yml file
wget https://raw.githubusercontent.com/nymanjens/facto/master/docker-compose.yml

# Choose a unique random string here of sufficient length
export APPLICATION_SECRET="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)"

# Create an empty database with a single admin user
docker-compose run web sleep 5 # Wait for the database to be ready
docker-compose run web bin/server -DdropAndCreateNewDb
docker-compose run web bin/server -DcreateAdminUser

# Bring up the server
docker-compose up

完了したら、http：// localhost：9000/（username： "admin"、password： "changeme"）を参照してください。

構成

• conf/application.conf ：
  ここでデータベースをセットアップして構成します。
• ユーザーを追加：
  デフォルトのユーザーは、 -DcreateAdminUserフラグ（username：admin、password：changeme）で作成されます。このアカウントは、新しいユーザーを作成できます。
• conf/accounting-config.yml ：
  このファイルを編集して、状況と好みを反映してください。 userLoginName 、データベースに既に存在するユーザーを参照する必要があることに注意してください（前のポイントを参照）

使用法

このツールを効果的に使用するには、トランザクションを正しく入力することを学ぶ必要があります。したがって、カテゴリとアカウントの意味を理解することが重要です。

カテゴリ

これらは、あなたの費用をカテゴリに分割するために使用されます。すべてのアカウントにはいくつかの特別なカテゴリがあります。

• 会計カテゴリ：
  非現実的な収入/費用に使用されます。このカテゴリは、費用の面で毎月の余剰/赤字を分析するときに無視されます。このカテゴリを使用して、雇用主によって費用が返済される場合
• 基金カテゴリ：
  共通アカウントへの送金に使用されます（次のセクションの例を参照）

アカウント

アカウントは、通常の人または共通のアカウントを指すことができます。

例：

家族には、アリスとボブの2人のメンバーがいます。 3つのアカウントがあります。

• アリス
• ボブ
• 共通アカウント

アリスとボブは、一般的な費用を作成するために使用できる共通口座に定期的に送金します。この共通アカウントへのこの転送は、 「寄付」と呼ばれます。

入力トランザクション

特別なフィールド：

• 受益者：
  費用の場合：費用の恩恵を受けるもの
  収入の場合：支払われたもの
• /toに支払われる：
  費用の場合：で支払われます
  収入の場合：支払われます
• 流れ：
  費用の場合：価格を表すマイナス数
  収入の場合：プラスの数

キャッシュフローの概要を効果的に使用します

キャッシュフローの概要は、未計上費用を確認するための強力なツールです。

あなたがすべき：

• すべての支払い方法（現金、カード、...）に対して現在の金額を設定します。 「セット」ボタンを使用してこれを行うことができます。
• トランザクションを実行するたびに、残高は自動的に更新されます。
• 現金を再カウントして、計算値と一致するかどうかを確認できます。もしそうなら、チェックボックスボタンを使用してこれをマークできます。そうでない場合、あなたはエラーを犯したか、お金を失いました。

このプロジェクトについて

このプロジェクトは、私の家族のために私の暇なときに私（Jens）によって作成され、維持されました。私はそれが他の人にとって有用であることを期待してオープンソースにしました。

これを使用することに決めた場合、それをたくさん使用するか、しばらくして使用するのをやめる可能性があります。以前のカテゴリにいる場合は、[email protected]にメッセージを送ってください（または寄付を送信することを検討してください）。また、新しいバージョンへのアップグレードや、為替レートやインフレ修正などのより高度な（隠された）機能を使用することに興味がある場合は、間違いなくお知らせください。