家庭记账工具（Facto）常见问题解决方案

家庭记账工具（Facto）常见问题解决方案

facto Family Accounting Tool 项目地址: https://gitcode.com/gh_mirrors/fa/facto

项目基础介绍

家庭记账工具（Facto）是一个开源的家庭会计工具，旨在帮助家庭记录和管理每一笔交易。该项目的主要目标是：

1. 提取有用统计数据：例如，每月在食品上的花费。
2. 计算内部债务：例如，Alice为整个家庭购买了卫生纸，工具会记录家庭欠Alice的金额。
3. 防止意外支出：例如，发现隐藏的银行费用。

该项目主要使用Scala编程语言开发，结合了Play框架和Slick数据库访问库。

新手使用注意事项及解决方案

1. 数据库配置问题

问题描述：新手在配置数据库时可能会遇到连接问题，尤其是在设置MariaDB时。

解决步骤：

1. 安装MariaDB：确保MariaDB服务器已正确安装并运行。
2. 创建数据库：在MariaDB中创建一个名为facto的空数据库。
3. 配置数据库连接：
   • 打开conf/application.conf文件。
   • 配置数据库连接信息，例如：

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

4. 验证连接：使用命令行工具（如mysql）连接到数据库，确保配置正确。

2. 管理员用户创建问题

问题描述：新手在创建管理员用户时可能会遇到权限问题或命令执行失败。

解决步骤：

1. 运行创建数据库表命令：

   bin/server -DdropAndCreateNewDb
   

2. 创建管理员用户：

   bin/server -DcreateAdminUser
   

3. 验证用户创建：
   • 启动应用程序：bin/server。
   • 访问http://localhost:9000/app/useradministration。
   • 使用默认用户名admin和密码changeme登录，验证管理员用户是否创建成功。

3. Docker安装问题

问题描述：新手在使用Docker安装时可能会遇到容器启动失败或配置问题。

解决步骤：

1. 获取docker-compose文件：

   wget https://raw.githubusercontent.com/nymanjens/facto/master/docker-compose.yml
   

2. 设置应用程序密钥：

   export APPLICATION_SECRET="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 64 | head -n 1)"
   

3. 启动Docker容器：

   docker-compose up -d
   

4. 验证容器状态：
   • 使用docker ps命令查看容器是否正常运行。
   • 访问http://localhost:9000，验证应用程序是否正常启动。

通过以上步骤，新手可以顺利解决在使用家庭记账工具（Facto）时可能遇到的常见问题。

facto Family Accounting Tool 项目地址: https://gitcode.com/gh_mirrors/fa/facto