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]给我发送一条消息（或考虑发送捐赠），以便我知道其他人正在使用此信息。绝对也让我知道您是否有兴趣升级到新版本，或者使用更高级（隐藏的）功能（例如汇率和通货膨胀校正）。