feat: 初始化收支管理系统

2026-08-30 14:36:22 +08:00
commit 733ed4bb86
79 changed files with 5808 additions and 0 deletions
@@ -0,0 +1,94 @@
+# 收支管理系统
+
+个人收支管理系统，支持收入/支出记录管理、分类管理、月度统计与图表展示。
+
+## 技术栈
+
+| 层级 | 技术 |
+|---|---|
+| 后端 | 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/         # 页面组件
+```