# Account个人记账

**Repository Path**: wangtaoaaa/personal-accounting

## Basic Information

- **Project Name**: Account个人记账
- **Description**: 个人记账
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 记账本 - 个人财务管理工具

一款轻量、智能的个人及家庭财务健康管理工具。基于 Spring Boot + Vue 3 + MySQL 构建。

完整使用手册见：[docs/项目使用手册.md](docs/项目使用手册.md)

## 功能特性

- **极速记账** - 大金额输入框，分类选择，一键保存
- **流水明细** - 按时间/分类/账户/关键字多维筛选
- **分类管理** - 预设高频分类，支持自定义添加
- **多账户管理** - 现金/微信/支付宝/银行卡等多账户
- **净资产看板** - 总资产、总负债、净资产一目了然
- **数据分析** - 饼图/条形图/折线图多维度分析
- **预算管理** - 全局/分类预算设置与预警
- **周期账单** - 固定支出自动记账
- **新手引导** - 总览页提供推荐起步清单与快捷跳转
- **页面帮助** - 关键模块内置用途说明、复杂功能帮助提示和任务导向空状态
- **数据导出** - Excel/CSV 格式导出

## 技术栈

- **后端**: Java 8 + Spring Boot 2.7 + MyBatis + MySQL
- **前端**: Vue 3 + Element Plus + ECharts (CDN加载，无需npm构建)
- **打包**: Maven，打包为单个 jar，启动即用

## 快速开始

### 1. 准备 MySQL 数据库

```sql
-- 执行 src/main/resources/schema.sql 初始化数据库和表
source src/main/resources/schema.sql;
```

### 2. 修改数据库配置

编辑 `src/main/resources/application.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/accounting?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root        # 修改为你的用户名
    password: root        # 修改为你的密码
```

### 3. 构建与运行

```bash
# 构建
mvn clean package -DskipTests

# 运行
java -jar target/accounting-1.0.0.jar
```

### 4. 访问

打开浏览器访问 http://localhost:8080

## 使用建议

首次登录后，建议按以下顺序开始：

1. 在“资产管理”中创建常用账户，如现金、银行卡、微信或支付宝
2. 在“记一笔”中录入第一笔收入、支出或转账
3. 到“流水明细”或“数据分析”确认结果是否正确
4. 再逐步使用“预算管理”“周期账单”“数据导入”“数据管理”等进阶功能

应用内已为“资产管理”“预算管理”“分类管理”“周期账单”“年度报告”“数据导入”“数据管理”等页面提供模块说明和空状态指引，遇到不熟悉的功能可优先查看页头说明或帮助提示。

## API 接口

| 路径 | 方法 | 说明 |
|------|------|------|
| `/api/transactions` | GET/POST | 交易记录查询/新增 |
| `/api/transactions/{id}` | GET/PUT/DELETE | 交易记录详情/修改/删除 |
| `/api/transactions/dashboard` | GET | 首页总览数据 |
| `/api/transactions/stat/category` | GET | 分类统计 |
| `/api/transactions/stat/trend` | GET | 月度趋势 |
| `/api/categories` | GET/POST | 分类查询/新增 |
| `/api/accounts` | GET/POST | 账户查询/新增 |
| `/api/budgets` | GET/POST | 预算查询/新增 |
| `/api/recurring-bills` | GET/POST | 周期账单查询/新增 |
| `/api/export/excel` | GET | 导出Excel |
| `/api/export/csv` | GET | 导出CSV |