feat: 统一交易详情组件,替换为 TransactionDetailSheet,增强功能并删除旧组件
All checks were successful
Docker Build & Deploy / Build Docker Image (push) Successful in 17s
Docker Build & Deploy / Deploy to Production (push) Successful in 6s
Docker Build & Deploy / Cleanup Dangling Images (push) Successful in 1s
Docker Build & Deploy / WeChat Notification (push) Successful in 1s

This commit is contained in:
SunCheng
2026-02-21 12:11:50 +08:00
parent 5f5c15ffb5
commit 749624f290
16 changed files with 479 additions and 445 deletions

View File

@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-02-21

View File

@@ -0,0 +1,78 @@
## Context
当前项目存在两个交易详情组件,视觉样式和功能存在差异:
| 组件 | 使用位置 | 特点 |
|------|---------|------|
| `TransactionDetailSheet.vue` | calendarV2, CategoryBillPopup | 简洁卡片式设计,点击金额可编辑,无建议分类提示 |
| `TransactionDetail.vue` | TransactionsRecord | 传统表单设计,有建议分类提示,支持余额编辑 |
**核心差异**
1. 视觉样式TransactionDetailSheet 更现代简洁
2. 建议分类提示:仅 TransactionDetail.vue 支持显示 AI 建议的分类
3. 余额编辑TransactionDetail.vue 支持余额编辑
## Goals / Non-Goals
**Goals:**
- 统一所有页面的交易详情视觉样式,使用 TransactionDetailSheet 的设计
- 保留 TransactionDetail.vue 中的必要功能(建议分类提示)
- 简化组件维护,减少重复代码
**Non-Goals:**
- 不修改 API 接口
- 不修改后端逻辑
- 不增加新功能(仅整合现有功能)
## Decisions
### 决策 1选择 TransactionDetailSheet 作为基准组件
**理由**
- 视觉设计更现代,用户体验更好
- 已被 calendarV2主要入口和 CategoryBillPopup 使用
- 代码结构更清晰,使用 Composition API
**替代方案**
- 方案 A合并两个组件为一个通过 props 控制样式 → 拒绝,增加复杂度
- 方案 B保持两个组件分别维护 → 拒绝,维护成本高,用户体验不一致
### 决策 2将建议分类提示功能迁移到 TransactionDetailSheet
**理由**
- 该功能是智能分类体验的核心部分
- 用户在 TransactionsRecord 页面查看未确认分类的交易时需要此提示
**实现方式**
- 在 TransactionDetailSheet 的分类选择区域上方添加建议提示条
- 点击"应用"后自动填充建议的分类和类型
### 决策 3删除旧的 TransactionDetail.vue 组件
**理由**
- 功能已完全迁移到 TransactionDetailSheet
- 避免代码冗余和维护负担
## Risks / Trade-offs
| 风险 | 缓解措施 |
|-----|---------|
| 用户习惯旧界面样式 | 新界面更简洁直观,学习成本低 |
| 迁移过程中遗漏功能 | 详细对比两个组件功能,确保无遗漏 |
| 建议分类提示功能迁移不完整 | 测试未确认分类交易的显示和交互 |
## Migration Plan
1. **Phase 1**: 增强 TransactionDetailSheet
- 添加建议分类提示功能
- 确保所有功能完整
2. **Phase 2**: 更新 TransactionsRecord 页面
- 替换组件引用
- 调整事件处理
3. **Phase 3**: 清理
- 删除 TransactionDetail.vue
- 更新相关文档
**回滚策略**Git revert 即可,无数据迁移风险

View File

@@ -0,0 +1,33 @@
## Why
当前项目中存在两个交易详情组件:`TransactionDetailSheet.vue`calendarV2 使用)和 `TransactionDetail.vue`TransactionsRecord 使用),导致用户在不同页面查看交易详情时视觉体验不一致。需要统一为 calendarV2 页面的详情样式,提升用户体验一致性并减少维护成本。
## What Changes
- **统一交易详情组件**:将所有页面的交易详情统一使用 `TransactionDetailSheet.vue` 组件
- **更新 TransactionsRecord 页面**:将详情组件从 `TransactionDetail.vue` 替换为 `TransactionDetailSheet.vue`
- **弃用旧组件**:移除不再使用的 `TransactionDetail.vue` 组件
- **增强 TransactionDetailSheet**:确保组件具备完整功能(余额编辑支持、建议分类提示等)
## Capabilities
### New Capabilities
- `unified-transaction-detail`: 统一的交易详情弹窗组件,支持金额编辑、分类选择、时间修改、删除操作,所有页面共用同一视觉样式
### Modified Capabilities
- 无(现有功能保持不变,仅统一样式)
## Impact
**受影响的文件**
- `Web/src/views/TransactionsRecord.vue` - 替换详情组件引用
- `Web/src/components/Transaction/TransactionDetail.vue` - 删除或标记弃用
**不受影响的文件**
- `Web/src/views/calendarV2/Index.vue` - 已使用 TransactionDetailSheet
- `Web/src/components/Transaction/CategoryBillPopup.vue` - 已使用 TransactionDetailSheet
- `Web/src/components/Transaction/TransactionDetailSheet.vue` - 基准组件,保持不变
**API 无变更**:仅前端组件层面的统一

View File

@@ -0,0 +1,74 @@
## ADDED Requirements
### Requirement: 统一的交易详情弹窗组件
系统 SHALL 提供统一的交易详情弹窗组件 `TransactionDetailSheet.vue`,所有页面使用同一组件查看和编辑交易详情。
#### Scenario: 从任意页面打开交易详情
- **WHEN** 用户在 calendarV2、TransactionsRecord 或其他页面点击交易记录
- **THEN** 系统显示统一的 TransactionDetailSheet 弹窗组件
#### Scenario: 详情弹窗显示交易信息
- **WHEN** 弹窗打开
- **THEN** 显示金额(可点击编辑)、时间、备注、类型、分类
#### Scenario: 编辑金额
- **WHEN** 用户点击金额区域
- **THEN** 进入金额编辑模式,显示数字输入框
- **AND** 失焦后自动保存格式化的金额值
### Requirement: 建议分类提示功能
系统 SHALL 在交易详情弹窗中显示 AI 建议的分类提示(当存在未确认分类时)。
#### Scenario: 显示建议分类提示
- **WHEN** 交易存在 `unconfirmedClassify` 字段且与当前分类不同
- **THEN** 在分类选择区域上方显示建议提示条
- **AND** 提示条包含建议的分类名称和应用按钮
#### Scenario: 应用建议分类
- **WHEN** 用户点击"应用"按钮
- **THEN** 自动填充建议的分类到分类字段
- **AND** 如果存在 `unconfirmedType`,同时更新交易类型
### Requirement: 交易保存功能
系统 SHALL 允许用户修改交易详情并保存。
#### Scenario: 保存修改的交易
- **WHEN** 用户修改交易信息后点击"保存"按钮
- **AND** 必填字段(金额、分类、时间)已填写
- **THEN** 系统调用更新 API 并显示成功提示
- **AND** 关闭弹窗并刷新交易列表
#### Scenario: 保存时验证失败
- **WHEN** 用户点击"保存"但必填字段未填写
- **THEN** 显示对应的错误提示信息
### Requirement: 交易删除功能
系统 SHALL 允许用户删除交易记录。
#### Scenario: 删除交易确认
- **WHEN** 用户点击"删除"按钮
- **THEN** 显示确认对话框
#### Scenario: 确认删除交易
- **WHEN** 用户在确认对话框中点击"删除"
- **THEN** 系统调用删除 API
- **AND** 成功后关闭弹窗并刷新交易列表
- **AND** 显示删除成功提示
### Requirement: 页面兼容性
系统 SHALL 确保统一组件在所有使用场景正常工作。
#### Scenario: TransactionsRecord 页面使用详情组件
- **WHEN** 用户在 TransactionsRecord 页面点击交易记录
- **THEN** 显示 TransactionDetailSheet 弹窗
- **AND** 功能与原 TransactionDetail 组件一致
#### Scenario: calendarV2 页面使用详情组件
- **WHEN** 用户在 calendarV2 页面点击交易记录
- **THEN** 显示 TransactionDetailSheet 弹窗
- **AND** 保持原有功能和交互不变

View File

@@ -0,0 +1,25 @@
## 1. 增强组件功能
- [x] 1.1 在 TransactionDetailSheet.vue 中添加建议分类提示功能
- [x] 1.2 添加建议提示 UI 组件(显示 unconfirmedClassify 和应用按钮)
- [x] 1.3 实现应用建议分类逻辑(更新 classify 和 type 字段)
## 2. 迁移页面引用
- [x] 2.1 修改 TransactionsRecord.vue将 TransactionDetail 组件替换为 TransactionDetailSheet
- [x] 2.2 更新 TransactionsRecord.vue 中的事件处理save → save, delete → delete
- [x] 2.3 测试 TransactionsRecord 页面的详情功能
## 3. 清理旧代码
- [x] 3.1 确认无其他页面引用 TransactionDetail.vue
- [x] 3.2 删除 TransactionDetail.vue 组件文件
- [x] 3.3 更新相关文档(如有)
## 4. 测试验证
- [x] 4.1 测试 calendarV2 页面交易详情功能(无回归)
- [x] 4.2 测试 TransactionsRecord 页面交易详情功能
- [x] 4.3 测试 CategoryBillPopup 中交易详情功能
- [x] 4.4 测试建议分类提示功能
- [x] 4.5 运行前端 lint 检查

View File

@@ -0,0 +1,74 @@
## Requirements
### Requirement: 统一的交易详情弹窗组件
系统 SHALL 提供统一的交易详情弹窗组件 `TransactionDetailSheet.vue`,所有页面使用同一组件查看和编辑交易详情。
#### Scenario: 从任意页面打开交易详情
- **WHEN** 用户在 calendarV2、TransactionsRecord 或其他页面点击交易记录
- **THEN** 系统显示统一的 TransactionDetailSheet 弹窗组件
#### Scenario: 详情弹窗显示交易信息
- **WHEN** 弹窗打开
- **THEN** 显示金额(可点击编辑)、时间、备注、类型、分类
#### Scenario: 编辑金额
- **WHEN** 用户点击金额区域
- **THEN** 进入金额编辑模式,显示数字输入框
- **AND** 失焦后自动保存格式化的金额值
### Requirement: 建议分类提示功能
系统 SHALL 在交易详情弹窗中显示 AI 建议的分类提示(当存在未确认分类时)。
#### Scenario: 显示建议分类提示
- **WHEN** 交易存在 `unconfirmedClassify` 字段且与当前分类不同
- **THEN** 在分类选择区域上方显示建议提示条
- **AND** 提示条包含建议的分类名称和应用按钮
#### Scenario: 应用建议分类
- **WHEN** 用户点击"应用"按钮
- **THEN** 自动填充建议的分类到分类字段
- **AND** 如果存在 `unconfirmedType`,同时更新交易类型
### Requirement: 交易保存功能
系统 SHALL 允许用户修改交易详情并保存。
#### Scenario: 保存修改的交易
- **WHEN** 用户修改交易信息后点击"保存"按钮
- **AND** 必填字段(金额、分类、时间)已填写
- **THEN** 系统调用更新 API 并显示成功提示
- **AND** 关闭弹窗并刷新交易列表
#### Scenario: 保存时验证失败
- **WHEN** 用户点击"保存"但必填字段未填写
- **THEN** 显示对应的错误提示信息
### Requirement: 交易删除功能
系统 SHALL 允许用户删除交易记录。
#### Scenario: 删除交易确认
- **WHEN** 用户点击"删除"按钮
- **THEN** 显示确认对话框
#### Scenario: 确认删除交易
- **WHEN** 用户在确认对话框中点击"删除"
- **THEN** 系统调用删除 API
- **AND** 成功后关闭弹窗并刷新交易列表
- **AND** 显示删除成功提示
### Requirement: 页面兼容性
系统 SHALL 确保统一组件在所有使用场景正常工作。
#### Scenario: TransactionsRecord 页面使用详情组件
- **WHEN** 用户在 TransactionsRecord 页面点击交易记录
- **THEN** 显示 TransactionDetailSheet 弹窗
- **AND** 功能与原 TransactionDetail 组件一致
#### Scenario: calendarV2 页面使用详情组件
- **WHEN** 用户在 calendarV2 页面点击交易记录
- **THEN** 显示 TransactionDetailSheet 弹窗
- **AND** 保持原有功能和交互不变