# EasyAccounts

**Repository Path**: lfczj/EasyAccounts

## Basic Information

- **Project Name**: EasyAccounts
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: gh-pages
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-14
- **Last Updated**: 2025-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyAccounts  

## 简介
EasyAccounts是一款**开源中文记账软件**  
如果恰好你也是一个喜欢记账的人，并且符合下面的项目要求  
如果你对互联网上的记账App不放心，如果你怕**信息泄露**，如果你怕几年的**数据丢失**  
🎉🎉🎉也许这个项目能满足你的需求  
### 面向受众：
- 家庭
- 个人

> 项目无法支撑团队记账，所以不推荐团队使用。  

### 项目要求
- 有一定的计算机基础
- 会部署Docker
- 理解记账的基本概念
- 有可以部署的平台(见下文)
### 支持平台  
* Ubuntu&Debain  
* Windows  
* Mac OS  
* 飞牛私有云 Fnos  

### 项目特点
- 记账基础维度：
  - 账户
  - 收支操作
  - 分类
  - 明细

- 数据筛选维度：
  - 时间
  - 账户
  - 分类(2级)
  - 备注

- 易用性维度：
  - 自己设置模板，3步一笔账
  - 生成Excel账单，自己制作账本
  - 定时备份数据库
  - 账单数据推送
---

具体内容见项目主页：[GitPage](https://qingheyang.github.io/EasyAccounts/#/)

## 更新计划
### 2025 Update plan：  
更新计划  
本来投入到另外一个项目中，后来多方面的原因，进度有些推不动  
今年还会做一些开发，大概有下面的几个内容  
- [ ] 增加数据库切换，Mysql / sqlite  
- [x] ~~增加鉴权功能，主要是用户名和密码~~  
- [ ] 桌面端开发，预计是Electron  
- [ ] 安卓移动端开发 （苹果我没有账号）  

### 2.4.0 Feature 
更新日期：2025-02-07  
更新视频：[【开源记账软件 EasyAccounts v2.4.0 新版本说明】 ](https://www.bilibili.com/video/BV1P1NPe4Er8/?share_source=copy_web&vd_source=d0722b43e81cb8a8b7ef09b76193df8d)
- 重要特性
  - 增加登录功能，可以通过compose来开启关闭，compose不设置，默认关闭
  - 增加统计功能，原财务分析页面作废，统计功能为按分类统计汇总，按单项分类汇总，可按月查看单项分类
- 新增功能
  - 增加点击生成Excel报表后反馈，变为同步式等待
  - webhook修改逻辑判断
  - 重构总览界面，增加当年月度概览，账户详情转移至顶部
  - 记一笔按钮转移至明细（原流水）界面底部，可以拖动（电脑端可点击）
  - 筛选入口转移至原记一笔位置，主页不在提供筛选选项卡
  - 筛选默认开启备注搜索
明细
  - 分类管理增加不参与统计选项，不参与统计的分类不会出现在统计页面
- fixbugs
  - 修复主页请求500错误，跨年后请求错误
  - 修复webhook发送邮件，多收件人可能发送失败问题
  - 生成历史月份Excel，报表中账户金额可以追溯
- 技术特性
  - 增加外部Mysql数据库支持，可以通过compose来开启关闭，compose不设置，默认关闭
  - 前端VUE2->VUE3
  - 前端组件Vant2->Vant4

### 升级教程及历史版本
[Release-Note](https://qingheyang.github.io/EasyAccounts/#/version/Release-Notes)  
  

## 功能  
使用功能详见：  [【开源记账软件 EasyAccounts 使用教程-哔哩哔哩】 ](https://b23.tv/BV1Ds421w78S)  
知乎等详见： [关于我写的个人记账软件方案 - 四点不在线的小能猫的文章 - 知乎](https://zhuanlan.zhihu.com/p/645208377)

### 部分截图  
<table>
  <tr width="80%">
    <td>
      <img src="./image/Feature/Feature-Board.png" width="100%" />
      <p align="center">总览</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Flow.png" width="100%" />
      <p align="center">明细</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Analysis-List.png" width="100%" />
      <p align="center">统计</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-About.png" width="100%" />
      <p align="center">设置</p>
    </td>
  </tr>
  <tr width="80%">
    <td>
      <img src="./image/Feature/Feature-Board-Accounts.png" width="100%" />
      <p align="center">总览账户</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Flow-Add.png" width="100%" />
      <p align="center">新增明细</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Flow-Template.png" width="100%" />
      <p align="center">筛选</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Screen.png" width="100%" />
      <p align="center">分类界面</p>
    </td>
  </tr>
  <tr width="80%">
    <td>
      <img src="./image/Feature/Feature-Type-List.png" width="100%" />
      <p align="center">分类列表</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Analysis-Type.png" width="100%" />
      <p align="center">分类单项统计</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Analysis-Chart.png" width="100%" />
      <p align="center">统计图表</p>
    </td>
    <td>
      <img src="./image/Feature/Feature-Login.png" width="100%" />
      <p align="center">登录</p>
    </td>
  </tr>

</table>

<table>
  <tr width="80%">
    <td>
      <img src="./image/Swagger_info.png" width="100%" />
      <p align="center">Swagger 文档</p>
    </td>
    <td>
      <img src="./image/Nginx_info.png" width="100%" />
      <p align="center">Nginx 文件下载</p>
    </td>
  </tr>
   <tr width="70%">
    <td>
      <img src="./image/Email_info.png" width="100%" />
      <p align="center">Email 推送</p>
    </td>
    <td>
      <img src="./image/Excel_info.png" width="100%" />
      <p align="center">Excel 生成</p>
    </td>
   
  </tr>
</table>

### 项目功能导图  
<img src="./image/EasyAccountsFunction.png" width="90%" />  

### 可以定义的操作有
1. 账户：有金额、名称等选项。
2. 收支：收入、支出、借入、借出、内部转账等选项，此项目我已经再初始化数据库中添加了常用的几项，足够覆盖生活99%以上的场景，不建议修改。  
3. 分类：有一二级类型，例如用车支出，下属可以选择：加油、保险，具体选项参考自己日常生活，需要注意的是，分类与操作没有关联，你可以叫做 “我的收入”,但是你记账的时候可以选择“支出”操作，**分类仅用于快捷记录使用**。  
（新版本中 分类已经与收支关联）

### 记账功能  
选择账户->选择操作->选择记账类型->输入金额->保存。  
一条账目就记录完毕，所在金额会在选择的账户中增加或减少。  

### 报表功能  
一共可以生成三种Excel文档：
- 月度账单：生成一个月的账单。
    - 位置：主页流水选项卡里，如果你有流水记录，点击生成报表，没有记录的话就没有这个按钮。
    - 可以生成一个月的流水账单，有一点一定要记住，生成账单的时间点，再excel里面是会有你所有的账户金额的，所以如果你再5月记账，生成4月的账单，那么4月的账单里面是有5月的账户金额的，所以生成账单的时候一定要注意时间点。**请在记录当月的流水之前，生成上个月的账单。**
- 筛选账单：生成筛选的账单。
    - 位置：主页点击总览，然后点击筛选按钮，选择筛选条件，然后点击生成报表。
    - 生成报表前，记得点筛选验证数据，如果没有筛选结果数据，是不会生成报表的，接口会报错，哈哈哈，这是一个小bug，每一次更新我都忘记修改。
- 分析报表：生成分析同环比报表。
    - 位置：主页点击分析选项卡，然后选择周期，点击生成报表。
    - 生成完的同比环比数据会汇总到一个Excel表格中，可以查看同比环比数据。

### 筛选功能  
基本所有的操作包括类型，都可以算作筛选的选项，得到结果后可以手动生成xls。  

### 备份功能  
启动项目的时候可以设置SQL备份日期规则，使用cron规则，详情见docker-compose.yml文件中的环境变量。  
备份的文件会存放在Resource/sql目录下，文件名为日期.sql。  
Excel生成后，会自动备份到Resource/excel目录下，对应上面三个账单的文件夹。  

### WebHook功能(发送邮件)  
WebHook是一个发送邮件，和处理SQL备份的功能，可以在docker-compose.yml中配置。  
具体使用方法见：[WebHook使用说明](./WebHook/README.md)  
配置好发送邮件功能后，就可以在手机上接收excel以及SQL文件了，效果如下：  
<img src="./image/Email_get.png" width="45%" />
<img src="./image/Email_sql.png" width="45%" />
  
### 其他功能  
1. Swagger接口文档，可以查看接口文档，支持自定义开发前端。  
<img src="./image/Swagger.png" width="65%" />  
2. Nginx提供生成文件的下载服务，可以直接下载生成的文件  
<img src="./image/Nginx.png" width="65%" />  
  
上述两个地址详见：[项目部署-项目访问](https://github.com/QingHeYang/EasyAccounts/blob/main/README-Deploy.md#%E9%A1%B9%E7%9B%AE%E6%9C%8D%E5%8A%A1%E8%AF%B4%E6%98%8E)  


## 结语  
该项目会长期维护下去，因为我自己就一直在使用，如果你有什么关于记账的想法，我会酌情评估添加。  
如果该项目对你有帮助，欢迎Star，如果有问题，欢迎提issue。  
维护一个项目不容易，如果你愿意支持一下，可以请我喝杯咖啡。  
<table>
  <tr width="70%">
    <td>
    <img src="./image/WeChat.jpg" width="70%" /> 
    </td>
    </td>
    <td><img src="./image/Ali_pay.jpg" width="50%" />
    </td>
</tr>
</table>