# pig-account

**Repository Path**: struggle_ly/pig-account

## Basic Information

- **Project Name**: pig-account
- **Description**: 记账猪小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI记账小程序

> 基于 记账猪 的基础上进行的编写，由于小猪记账本只开源了小程序代码，
>
> 目前进度约 90%，V3 协作增强已落地；服务号快捷记账等待公众号侧对接。  
>  GitHub： https://github.com/liuyu-struggle/pig-account
>
> 感谢记账猪， 下面为他的源码地址： 
>
> Gitee： https://gitee.com/i-like-potato-chips/pig-account
>
> Github：https://github.com/tiancheng2002/pig-account    



# 项目介绍

一个AI对话自动记账小程序，能够根据你输入的文字或上传的账单图片自动识别出对应的账单数据，比如 “今天中午吃饭花了30元”，AI 便能迅速捕捉到关键信息，精准识别消费金额、类别以及时间等数据，并自动完成记账操作。

界面设计简洁直观，没有复杂繁琐的操作流程，即使是初次使用的用户，也能在短时间内轻松上手。同时，小程序还有账本功能，用户可以创建不同的账单来记录自己的账单，还可以邀请朋友加入到账本中进行协作。

并且还有一些日历表以及饼图这些图形化的组件，让你能够更清晰的了解到自己的支出或收入情况，能够更好的规划管理自己的财务。

## 技术栈

前端：微信小程序

UI组件：Vant、IView

统计图：ECharts

后端：SpringBoot、Mybatis、Redis、MySQL、Minio、Spring AI等

## 功能列表

- 支持微信授权一键登录，全程不强制收集手机号，保障用户隐私

- 首页查看某月支出收入账单列表，按照日期进行划分显示，点击账单可查看对应账单详情，可编辑可删除
- 通过日历表形式展示某月对应日期的支出或收入金额，点击某一日期可查看详情
- 用饼图展示某月支出或收入对应的类别占比，快速了解自己大致消费或收入方向
- 账单排行功能，可按照类别或月份等按照时间或金额查看排行列表
- 记账功能，用户选择类别、输入金额、选择合适账本等即可快速完成记账
- 自定义类别功能，支持自定义支出或收入类别内容
- 预算功能，可自定义设置预算，能够更合理规划自己的支出情况
- 账本功能，可自定义添加不同类型的账本，单个用户最大可创建和加入五个账本
- 邀请好友加入账本功能，创建一个类型为公开的账本，用户就能邀请自己的好友加入账本进行共同协作
- 账本的发起人可移除账本内的成员，成员也可以自行退出；**退出后账单默认保留并标记为「已退出成员」，也可转交管理员**（见 V3）

- 添加账本时可自定义上传账本图标

- 支持用户自定义上传个人喜欢的图片作为头像

- 生成动态小程序邀请码邀请朋友加入账本协作

- **AI 聊天式记账功能**，用户只需与 AI 交互，即可快速完成记账，并即时返回记账成功的账单数据

- **OCR图片识别记账功能**，适用于外卖、微信/支付宝账单、纸质小票、截图等场景

- **账单导入 / 导出**：支持微信、支付宝、银行卡 Excel/CSV 导入，以及按账本导出到邮箱

- **V3 协作增强（详见下文）**
  - 账本角色权限（管理员 / 普通 / 只读）与成员退出保留账单
  - 导入智能查重（时间 + 金额 + 商家）
  - 多人分摊与 AA 结算单（可复制到微信群）
  - 协作动态时间线
  - 数据看板趋势（日折线 / 月对比）
  - 记账成就、勋章与消费人格
  - 主题皮肤、首页布局与「添加至桌面」指引
  - 多条件搜索筛选

  **TODO 待实现功能**

- **AI账单分析功能**，通过对某月账单数据的深度分析，为用户提供专业的消费建议，助力用户优化财务管理（Beta）
- 微信服务号/小助手消息快捷记账（需公众号侧配置，小程序侧已预留桌面快捷指引）

## V3 功能说明与数据库升级

> 已有数据库请执行增量脚本：
>
> `pig-account-backend/src/main/resources/schema-v3-features.sql`
>
> 全新安装直接使用更新后的 `schema.sql` 即可。

### 1. 账单归属与成员权限
- 角色：`0` 只读、`1` 普通成员、`2` 管理员（房主默认管理员）
- 成员退出/移除时**不删除账单**：默认标记 `left_flag=1`（已退出成员）；也可 `leavePolicy=transfer_admin` 转交管理员
- 接口：`GET /have/role` 设置角色；`GET /have/del&leavePolicy=keep_mark|transfer_admin`

### 2. 智能查重
- 导入时按 `日期 + 金额 + 商家` 生成 `fingerprint`，文件内与库内重复自动跳过
- 结果字段 `duplicated` 表示去重条数

### 3 / 4. 分摊与 AA 结算
- `POST /split/save` 设置账单分摊（equal / ratio / custom）
- `GET /split/settle/create` 生成结算单；`/split/settle/list|detail|finish`
- 小程序页：`pages/settle/index`（支持复制结算文案到微信）

### 5. 桌面快捷
- `pages/pref/index` 内「添加至桌面」操作指引；`pref.quickTipSeen` 记录是否已读

### 6. 协作动态
- 记账/删除/结算等写入 `t_book_activity`
- `GET /activity/list`；小程序页 `pages/activity/index`

### 7. 数据看板
- `GET /dashboard/trend`：自定义起止日期，`grain=day|month`

### 8. 成就打卡
- 连续天数、全勤勋章、消费人格文案
- `GET /achievement/overview`；页 `pages/achievement/index`

### 9. 个性化
- `GET /pref/get`、`GET /pref/save`（theme / homeLayout / homeModules）

### 10. 搜索筛选
- `GET /account/search`；页 `pages/search/index`

## 演示环境

<img src="https://liuyu.xfce.top:19443/resource/pig-account/share/appletCode.jpg" alt="小猪便携记账本" width="33%" />


# 功能演示

### 首页

在首页可以查看到某个月的所有支出与收入情况，并且会根据日期对每一天的支出与收入进行划分，在顶部可以点击对应的年月进行切换，右侧还可以查看指定账本中的账单数据

<img src="pig-account-frontend/image/IMG_3680.png" width="30%" />

点击对应的账单数据就能查看到对应的详情，也可以对账单进行编辑，也可以将他删除

<img src="pig-account-frontend/image/IMG_3703.png" width="30%" />

### 日历表展示

在统计页的最上方会有一个日历表，会显示某个月的每一天的支出或收入金额，并且各自的颜色深度会随着金额的大小而变化，点击对应的日期还能查看到某一天的支出或收入情况

<img src="pig-account-frontend/image/IMG_3681.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3701.png" width="30%" />

### 统计图展示

在日历表的下方会有一个饼状统计图，主要是展示某个月支出或收入的占比，让用户可以清晰的感知自己在不同类别的消费或收入情况，点击下方对应类别会调转到账单排行页，里面可以查看某一类别的账单数据排行

<img src="pig-account-frontend/image/IMG_3702.png" width="30%" />

### 账单排行

在饼图的下方会有一栏账单排行的数据列表，会按照金额大小从高到低展示某月支出或收入的账单数据，如果数据超过十条的话，可以点击最下方的`全部排行`跳转到账单排行页进行查看，在里面可以按照金额或时间进行排序

<img src="pig-account-frontend/image/IMG_3704.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3682.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3683.png" width="30%" />

### 个人中心

在个人中心页面，用户可以看到自己的记账天数以及记账笔数，还可以看到自己的剩余预算信息。点击头像名称或预算就会跳转到编辑页，在里面可以更改自己的头像、昵称以及预算信息

<img src="pig-account-frontend/image/IMG_3684.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3685.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3706.png" width="30%" />

### 记账功能

在记账页中，用户可以自主的选择对应的类别、支付方式、要记录的账本以及输入金额和备注等信息，然后点击记账按钮就可以轻松的完成一笔记账啦

<img src="pig-account-frontend/image/IMG_3686.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3687.png" width="30%" />

### 自定义类别

在自定义类别页，用户可以自定义自己的类别内容，目前暂不支持自定义类别图标，只能添加对应的文字。可以有选择性的定义不同的支出或收入类别

<img src="pig-account-frontend/image/IMG_3699.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3700.png" width="30%" />

### 自定义账本

在我的账本页中用户可以看到自己创建和加入的账本信息，如果是公开账本的话，就会显示对应账本的加入人数和最大人数，点击下方的添加按钮会跳转到账本添加页

<img src="pig-account-frontend/image/IMG_3694.png" width="30%" />

在账本添加页中，可以对添加账本也可以对账本信息进行编辑，用户可以选择系统的图标也可以自定义上传图标

<img src="pig-account-frontend/image/IMG_3692.png" width="30%" />

### 账本账单页

在该页面中会显示该账本的所有账单信息，如果是公开账本的话，在每一条账单记录下都会有对应记账人的头像和昵称。点击右上角的设置会显示菜单栏，目前菜单栏只有查看成员、邀请成员、编辑账本、解散账本这四个选项。

<img src="pig-account-frontend/image/IMG_3695.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3698.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3696.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3697.png" width="30%" />

### AI聊天记账

在记账页点击自动记账就会跳转到AI自动记账页，用户只需输入或上传对应的账单图片，即可快速完成记账，系统会自动提取对应的类别。图片识别也采用OCR的方式，将账单文字提取出来后，交给AI帮我们完成记账操作。

<img src="pig-account-frontend/image/IMG_3689.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3688.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3690.png" width="30%" />

<img src="pig-account-frontend/image/IMG_3691.png" width="30%" />

# 源码说明

适用于毕业设计、个人学习及自主二次开发

提供前后端全部源码， 有任何疑问可以提交 Issues 或者添加 个人微信 咨询

<img src="pig-account-frontend/image/wechat.png" alt="个人微信" width="50%" />