# 收支管理系统

个人收支管理系统，支持收入/支出记录管理、分类管理、月度统计与图表展示。

## 技术栈

| 层级 | 技术 |
|---|---|
| 后端 | Spring Boot 3.3.6 + Java 21 + MyBatis-Plus + MySQL |
| 前端 | Vue 3 + TypeScript + Vite + Naive UI + ECharts |
| 构建 | Gradle 8.13 (后端) / npm (前端) |
| 认证 | JWT |
| API 文档 | Knife4j (OpenAPI 3) |
| JDK 版本 | 21.0.12.1 (Temurin LTS) |
| Node.js 版本 | v24.0.0 |

## 前置条件

- JDK 21.0.12.1 Temurin LTS，安装在 `D:\venv\jdk-21`
- Node.js v24.0.0

## 数据库初始化

首次运行前需建表，执行 `src/main/resources/sql/init.sql`，或运行 Python 脚本：

```bash
pip install pymysql bcrypt
python init_db.py
python generate_test_data.py
```

## 启动后端

```bash
cd my-app
set JAVA_HOME=D:\venv\jdk-21
gradlew.bat bootRun
```

- 后端地址：http://localhost:8080
- API 文档：http://localhost:8080/doc.html

## 启动前端

```bash
cd my-app/frontend
npm run dev
```

- 前端地址：http://localhost:5173

## 打包

将项目源代码打包为 tar.gz（不含构建产物和 node_modules）：

```bash
gradlew.bat archive
```

输出文件：`build/distributions/finance-app-0.0.1-SNAPSHOT-{时间戳}.tar.gz`

## 测试账号

| 用户名 | 密码 |
|---|---|
| demo | 123456 |

## 项目结构

```
my-app/
├── build.gradle
├── src/main/java/com/example/myapp/
│   ├── controller/        # 接口层
│   ├── service/           # 业务层
│   ├── mapper/            # 数据访问层
│   ├── entity/            # 实体类
│   ├── dto/               # 请求对象
│   ├── vo/                # 响应对象
│   ├── config/            # 配置类
│   ├── common/            # 公共类
│   ├── interceptor/       # 拦截器
│   └── util/              # 工具类
├── src/main/resources/
│   ├── application.yml
│   ├── mapper/
│   └── sql/init.sql
└── frontend/              # Vue 3 前端
    └── src/
        ├── api/           # API 请求封装
        ├── router/        # 路由配置
        ├── store/         # 状态管理
        └── views/         # 页面组件
```