Skip to content

快速开始

本章面向已部署好的系统,介绍初次使用时需要完成的配置与操作。

如何安装、启动与部署(开发模式、打包可执行 jar、Docker),请见开发文档的构建与部署

访问系统

使用部署者提供的地址访问,例如:

  • 本机部署:http://localhost:8080(端口以实际部署为准)
  • 局域网 / 服务器:http://<服务器 IP>:<端口>

首次访问且数据库尚未配置时,会自动进入「初始化数据库」引导页。

数据库配置

系统支持在服务启动之后再配置数据库,无需启动前准备:

  • 未检测到配置时,应用仍可正常启动,前端会引导进入「初始化数据库」页面。
  • 支持 SQLite(本地单文件,零配置)与 MySQL 两种数据库。
  • 保存配置后立即生效并自动建表,无需手动执行 SQL。
  • 配置持久化在 config/database.json,SQLite 数据默认位于 data/ 目录。

数据库初始化

首次进入时按引导选择数据库类型并填写连接信息,点击「保存并应用」即可。登录后可通过右上角用户菜单 →「数据库设置」随时切换数据库;切换后原数据库的数据保留,不做自动迁移。

注册与登录

  • 首次使用需要注册账号。若系统尚无任何用户,注册入口始终可用。
  • 注册成功后使用用户名与密码登录,登录状态通过 JWT 保存。

登录卡片

注册卡片

注册功能可在「系统设置 → 注册设置」中开启或关闭。新注册用户会自动获得一套默认分类、标签与邮箱发件人规则。

界面语言

系统支持简体中文、English、日本語三种语言。登录页、注册页右上角以及主界面顶部栏均可切换语言。

首次使用建议

  1. 完成数据库配置并注册登录。
  2. 进入「分类管理」「标签管理」按自己的习惯调整分类与标签。
  3. 在「规则管理」配置常用自动归类规则(如「星巴克 → 餐饮」)。
  4. 导出并导入历史账单(见账单类型与获取)。
  5. 按需配置「AI 模型」「定时通知」「邮箱账单」。

下一步

基于 Spring Boot 3 + Vue 3 的个人收支管理系统