Files
EmailBill/openspec/specs/unified-transaction-detail/spec.md

75 lines
2.7 KiB
Markdown
Raw Normal View History

## 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** 保持原有功能和交互不变