# managing-self

**Repository Path**: luckSnow/managing-self

## Basic Information

- **Project Name**: managing-self
- **Description**: 智能全链路记账系统 ✨
一站式财务管理中枢，精准捕捉每一笔收支轨迹！✅告别繁琐 Excel✅消费行为可视化📊 让每一分钱都清晰可溯，开启智慧理财新范式！立即体验，掌控财务自由第一步 💰
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2019-10-04
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人财务管家 V3（managing-self）

一个跑在自己服务器上的个人记账与信息管理 Web 应用：记账、统计、资产盘点、AI 分析一站式管理个人财务，让每一分钱都被看见。

- 记账：每日消费随记、历史查询、月/年多维统计与图表
- 资产：收入总览、月度资产盘点、资产分析看板、年度目标进度
- AI：接入大模型的数据分析助手（会话永久保存）+ 每个页面的悬浮问答助手
- 个人中心：书签收藏、技术框架管理、学习时长记录、年度目标清单

## 技术栈

| 层次 | 技术 |
|------|------|
| 后端 | Spring Boot 2.1.9、MyBatis Plus 3.2.0（XML 映射模式） |
| 前端 | Thymeleaf、Layui、BUI、jQuery、Apache ECharts 5、My97DatePicker |
| 数据库 | MySQL |
| 构建 | Maven，打包为 WAR 部署到 Tomcat |
| AI | OpenAI 兼容接口（SSE 流式输出），无额外重型依赖 |

## 项目效果图

### 1. 用户登录

支持账号密码 + 验证码登录，另提供酷炫全屏登录页（`/login/cool`）。

![登录页](docs/images/01-login.png)

### 2. 首页 · 记一笔

按"早餐/午饭/晚饭/生活用品/水电网络费..."等类型快速录入每日消费，支持二级分类详情。

![首页](docs/images/02-index.png)

### 3. 历史查询

按类别、时间范围检索消费明细，合并展示单次消费与每日合计，支持删除。

![历史查询](docs/images/04-account-search.png)

### 4. 月统计

按月生成消费饼图（含二级分类下钻）与明细报表，支持打印。

![月统计](docs/images/05-account-month.png)

### 5. 年统计

年度逐月消费趋势、与往年对比折线图，支持勾选类别过滤、连续多年总消费趋势。

![年统计](docs/images/06-account-year.png)

### 6. 预算燃尽图

按月设置工作日/周末预算，实时计算预算使用进度，生成每日使用情况与预算燃尽图。

![预算燃尽图](docs/images/07-account-burn.png)

### 7. 收入总览

历年收入合计、年均/月均收入、收入构成（工资/理财收益/其他）与年度趋势对比。

![收入总览](docs/images/08-asset-income.png)

### 8. 资产盘点（月度快照）

按月记录各账户余额快照，自动计算月度增长/减少，生成资产走势与账户构成分析。

![资产盘点](docs/images/09-asset-settlement.png)

### 9. 资产分析看板

最新总资产、区间资产增长、收入合计、年度目标完成进度、资产走势、账户构成一屏尽览。

![资产分析看板](docs/images/10-asset-chart.png)

### 10. AI 数据分析助手

接入大模型，提供综合财务体检、趋势分析与预测、结构与占比分析、年度目标达成分析四类分析，支持多轮追问，会话永久保存；每个页面右下角还有本页专属的悬浮 AI 助手。

![AI 数据分析助手](docs/images/11-ai-chat.png)

### 11. 书签收藏

树形分类管理个人收藏站点，支持回收站、按类型导航展示。

![书签收藏](docs/images/12-link-index.png)

### 12. 技术框架管理

以树图/分类统计方式管理个人技术栈（语言、框架、中间件、服务器等），记录熟练度与开源组织信息。

![技术框架管理](docs/images/13-tfw-index.png)

### 13. 学习记录

记录每日学习时段与时长，生成每日时长统计图。

![学习记录](docs/images/14-my-study.png)

### 14. 年度目标

按年维护目标清单（个人/技术/职业/理财分类），跟踪完成度与多年完成率趋势。

![年度目标](docs/images/15-my-goal.png)

## 快速开始

### 环境要求

- JDK 8+
- Maven 3.6+
- MySQL 5.7+（本地默认 `127.0.0.1:3306`，账号 `root/root`）

### 开发运行

```bash
# 1. 创建数据库 ms（字符集 utf8mb4），按需导入建表数据
# 2. 按需修改 profiles/dev/application.yml 中的数据库连接
# 3. 启动（默认 dev profile，端口 8080）
mvn spring-boot:run
```

访问 http://localhost:8080/login/index （默认账号/密码均为 `admin`）。

### 生产打包

```bash
mvn clean package -Dmaven.test.skip=true -Pprod
# 输出 target/ROOT.war，部署到 Tomcat
```

> 环境切换通过 Maven 资源目录覆盖实现：`profiles/dev`（默认，日志 debug、关缓存）与 `profiles/prod`（`-Pprod`，日志 info）。

### AI 功能配置（可选）

AI 助手需要配置 OpenAI 兼容接口，支持环境变量覆盖（见 `profiles/{dev,prod}/application.yml`）：

| 环境变量 | 说明 |
|----------|------|
| `LLM_BASE_URL` | 接口地址，如 `https://api.example.com` |
| `LLM_API_KEY` | API Key |
| `LLM_MODEL` | 模型名称 |

未配置时记账、统计等基础功能不受影响。

## 在线演示

- 地址：http://account.zx1989.top
- 账号/密码均为：`admin`

## 更新历史

完整更新记录见 [read.txt](read.txt)，近期主要变更：

- **2026-09-27**：新增资产管理模块（收入管理、月度盘点、资产统计看板）；新增 AI 助手（大模型接入、四类数据分析、会话永久存储）；全部功能页面接入 AI 悬浮助手；登录页 `/login/cool`。
- **2025-02-04**：优化消费查询（类型详情、日消费合计）；月统计饼图增加二级分类，Acharts → Apache ECharts；年度/月度折线图增加与上年对比。
- **2022-01-11**：优化月统计时间选择器；年统计增加连续多年总消费趋势图。
- **2019-10-05**：从传统项目迁移至 Spring Boot。
- **2015-07-07**：项目创建，原始技术栈 Hibernate + Spring MVC + JSP。