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（用戶名：“ admin”，密碼：“ 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/（用戶名：“ admin”，密碼：“ changeme”）

配置

• conf/application.conf ：
  設置並在此處配置數據庫。
• 添加用戶：
  使用-DcreateAdminUser flag（用戶名：admin，passwass：changeme）創建默認用戶。該帳戶可以創建新用戶。
• conf/accounting-config.yml ：
  編輯此文件以反映您的情況和偏好。請注意， userLoginName必須參考數據庫中已經存在的用戶（請參見上幾點）

用法

要有效地使用此工具，您必須學會正確輸入交易。因此，了解類別和帳戶的含義很重要。

類別

這些用於將您的費用分為類別。每個帳戶都有一些特殊類別：

• 會計類別：
  用於非現實收入/費用。在分析費用方面分析每月盈餘/赤字時，此類別將被忽略。使用此類別，例如，當您的雇主還清費用時
• 捐贈類別：
  用於貨幣轉移到公共帳戶（請參見下一節中的示例）

帳戶

帳戶可以參考普通人或公共帳戶。

例子：

一個家庭有兩個成員：愛麗絲和鮑勃。將有三個帳戶：

• 愛麗絲
• 鮑勃
• 公共帳戶

愛麗絲（Alice）和鮑勃（Bob）將定期將錢轉移到公共帳戶中，該帳戶可用於製造共同費用。該轉移到公共帳戶稱為“捐贈” 。

輸入交易

特殊領域：

• 受益人：
  如果支出：將從費用中受益的費用
  如果收入：支付的收入
• 用/到：
  如果支出：付款
  如果收入：付款給
• 流動：
  如果有費用：代表價格的負數
  如果收入：正數

有效地使用現金流概述

現金流量概述是一種強大的工具，可以檢查未劃分的費用。

您應該：

• 為每種付款方式（現金，卡，...）設置當前金額。您可以使用“集”按鈕來執行此操作。
• 每當您執行交易時，餘額都會自動更新。
• 您可以重新計算現金，看看它是否與計算值相匹配。如果是這樣，您可以使用複選框按鈕對此進行標記。如果不是這樣，您就犯了錯誤或虧損。

關於這個項目

這個項目是由我（Jens）在我為家人的業餘時間創建和維護的，我將其設置為開源，希望它對他人有用。

如果您決定使用它，則很可能會經常使用它，或者一段時間後停止使用它。如果您屬於前者類別，請通過[email protected]給我發送一條消息（或考慮發送捐贈），以便我知道其他人正在使用此信息。絕對也讓我知道您是否有興趣升級到新版本，或者使用更高級（隱藏的）功能（例如匯率和通貨膨脹校正）。