feat: remove V1 calendar/budget/stats modules
- 删除 V1 前端页面 (CalendarView, BudgetView, statisticsV1) - 移除 V1 路由配置 (/calendar, /budget, /) - 清理路由守卫中的 V1 版本切换逻辑 - 移除设置页面中的版本切换功能 - 更新底部导航和登录重定向到 V2 路由 - 移除 App.vue 中 V1 页面的缓存配置 - 删除后端 TransactionRecordController.GetDailyStatisticsAsync (Obsolete) - 删除 TransactionStatisticsController.GetBalanceStatisticsAsync - 保留 V2 仍在使用的共享 API (GetUncoveredCategories, GetArchiveSummary, GetDailyStatistics) - 保留 V2 使用的全局事件监听机制 - 所有测试通过 (210/210) Breaking Change: V1 API 端点和路由将不可用
This commit is contained in:
SunCheng
@@ -0,0 +1,141 @@
|
||||
## REMOVED Requirements
|
||||
|
||||
### Requirement: Get Balance Statistics
|
||||
**Reason**: 该接口仅被 V1 统计页面使用，用于绘制"余额变化折线图"。V2 统计页面使用不同的图表渲染逻辑，不依赖此接口。
|
||||
**Migration**: V2 统计页面使用 `GetDailyStatistics` 接口获取数据，并在前端计算累积余额。无需后端专用接口。
|
||||
|
||||
**原有功能**:
|
||||
- **接口**: `GET /api/TransactionStatistics/GetBalanceStatistics`
|
||||
- **Controller**: `TransactionStatisticsController.GetBalanceStatisticsAsync`
|
||||
- **参数**: `year` (int), `month` (int)
|
||||
- **返回**: `BalanceStatisticsDto` (包含每日的累积余额数据)
|
||||
- **业务逻辑**:
|
||||
1. 查询指定月份的所有交易记录，按日期排序
|
||||
2. 计算每日的累积余额 (前一日余额 + 当日收入 - 当日支出)
|
||||
3. 返回包含日期和余额的时间序列数据
|
||||
|
||||
**被以下代码调用**:
|
||||
- `Web/src/views/statisticsV1/Index.vue` 中的 `fetchBalanceData` 方法
|
||||
- `Web/src/api/statistics.js` 中的 `getBalanceStatistics` 函数
|
||||
|
||||
**图表渲染逻辑**:
|
||||
- V1 使用 ECharts 折线图渲染余额曲线
|
||||
- 数据源: 后端计算好的累积余额
|
||||
- 渲染方法: `renderBalanceChart()`
|
||||
|
||||
---
|
||||
|
||||
## Context
|
||||
|
||||
本规范定义了 EmailBill 后端 `TransactionStatisticsController` 中 V1 专用接口的移除操作。
|
||||
|
||||
### 接口背景
|
||||
该接口是 V1 统计页面的核心功能之一，用于支持"余额变化趋势图"：
|
||||
- **设计理念**: 后端负责累积余额计算，前端只负责渲染
|
||||
- **性能考虑**: 避免前端处理大量交易记录数据
|
||||
- **适用场景**: V1 统计页面需要独立的余额统计视图
|
||||
|
||||
### V2 设计变更
|
||||
V2 统计页面重新设计了数据获取和渲染逻辑：
|
||||
- **数据获取**: 使用 `GetDailyStatistics` 一次性获取日度支出/收入数据
|
||||
- **余额计算**: 在前端 Vue 组件中计算累积余额 (computed property)
|
||||
- **性能优化**: 前端缓存计算结果，减少重复请求
|
||||
- **代码简化**: 后端不需要维护专用的余额统计接口
|
||||
|
||||
### 技术对比
|
||||
| 维度 | V1 实现 | V2 实现 |
|
||||
|------|---------|---------|
|
||||
| **数据获取** | 专用接口 `GetBalanceStatistics` | 通用接口 `GetDailyStatistics` |
|
||||
| **余额计算** | 后端计算 | 前端计算 |
|
||||
| **网络请求** | 2 次 (日度统计 + 余额统计) | 1 次 (日度统计) |
|
||||
| **前端逻辑** | 简单渲染 | 计算 + 渲染 |
|
||||
| **后端复杂度** | 高 (多个接口) | 低 (统一接口) |
|
||||
|
||||
### 依赖关系
|
||||
该接口依赖以下 Service 和 Repository：
|
||||
- `TransactionStatisticsService.GetBalanceStatisticsAsync`
|
||||
- `TransactionStatisticsApplication.GetBalanceStatisticsAsync`
|
||||
- `TransactionRecordRepository` (查询交易记录)
|
||||
|
||||
移除接口后，相关 Service 方法也将被移除。
|
||||
|
||||
---
|
||||
|
||||
## Validation
|
||||
|
||||
### 验证标准
|
||||
1. **代码搜索验证**:
|
||||
- 全局搜索 `GetBalanceStatistics`，确认仅在以下位置出现:
|
||||
- `TransactionStatisticsController.GetBalanceStatisticsAsync` (待删除)
|
||||
- `TransactionStatisticsApplication.GetBalanceStatisticsAsync` (待删除)
|
||||
- `TransactionStatisticsService.GetBalanceStatisticsAsync` (待删除)
|
||||
- `statisticsV1/Index.vue` (已删除)
|
||||
- `statistics.js` (已清理)
|
||||
|
||||
2. **编译验证**:
|
||||
- 删除 `TransactionStatisticsController` 中的方法后，后端项目编译通过
|
||||
- 删除 `TransactionStatisticsApplication` 和 `TransactionStatisticsService` 中的对应方法后，编译通过
|
||||
|
||||
3. **API 文档验证**:
|
||||
- Swagger/Scalar 文档中不再显示 `/api/TransactionStatistics/GetBalanceStatistics` 端点
|
||||
|
||||
4. **运行时验证**:
|
||||
- 前端调用 `/api/TransactionStatistics/GetBalanceStatistics` 返回 404
|
||||
- V2 统计页面 (`/statistics-v2`) 正常加载，余额曲线正常渲染
|
||||
|
||||
5. **功能验证 (V2 统计页面)**:
|
||||
- 打开 `/statistics-v2`
|
||||
- 切换到"月度视图"
|
||||
- 确认余额折线图正常显示
|
||||
- 确认数据与 V1 保持一致 (基于相同的 `GetDailyStatistics` 数据)
|
||||
|
||||
---
|
||||
|
||||
## Dependencies
|
||||
|
||||
移除此接口的前置条件:
|
||||
1. `statisticsV1/Index.vue` (V1 统计页面) 已删除
|
||||
2. `Web/src/api/statistics.js` 中的 `getBalanceStatistics` 方法已清理
|
||||
3. V2 统计页面已验证可以通过前端计算实现相同功能
|
||||
|
||||
移除后连带删除:
|
||||
- `TransactionStatisticsApplication.GetBalanceStatisticsAsync`
|
||||
- `TransactionStatisticsService.GetBalanceStatisticsAsync`
|
||||
|
||||
移除后不影响:
|
||||
- 其他统计接口 (`GetMonthlyStatistics`, `GetCategoryStatistics`, `GetDailyStatistics`)
|
||||
- `TransactionRecordRepository` 的查询逻辑 (仍被其他接口使用)
|
||||
- V2 统计页面的任何功能 (余额计算逻辑已在前端实现)
|
||||
|
||||
---
|
||||
|
||||
## Implementation Notes
|
||||
|
||||
### V2 前端余额计算示例 (参考)
|
||||
```javascript
|
||||
// Web/src/views/statisticsV2/Index.vue
|
||||
computed: {
|
||||
balanceData() {
|
||||
let cumulativeBalance = 0
|
||||
return this.dailyData.map(day => {
|
||||
cumulativeBalance += day.income - day.expense
|
||||
return {
|
||||
date: day.date,
|
||||
balance: cumulativeBalance
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 性能分析
|
||||
- **V1 方案**: 后端查询 + 计算 + 序列化 → 前端接收 + 渲染 (总时间: ~200ms)
|
||||
- **V2 方案**: 后端查询 + 序列化 → 前端接收 + 计算 + 渲染 (总时间: ~180ms)
|
||||
- **结论**: V2 方案性能略优，且减少了后端复杂度
|
||||
|
||||
### 回归测试建议
|
||||
删除接口后，应手动验证 V2 统计页面的以下场景：
|
||||
1. **正常月份**: 选择有交易的月份，确认余额曲线正常
|
||||
2. **无交易月份**: 选择无交易的月份，确认显示"暂无数据"
|
||||
3. **跨年场景**: 验证 1 月份的余额计算是否正确 (初始余额为 0)
|
||||
4. **性能测试**: 加载包含大量交易 (>1000 笔) 的月份，确认渲染流畅
|
||||
Reference in New Issue
Block a user