Files
EmailBill/openspec/changes/refactor-bill-list-component/proposal.md
SunCheng a88556c784 fix
2026-02-15 10:10:28 +08:00

2.3 KiB
Raw Blame History

Why

当前项目中存在多个账单列表实现(TransactionList.vuecomponents/calendarV2/modules/导致代码重复、样式不统一、维护成本高。v2 版本的账单列表calendarV2/modules/TransactionList.vue采用了更现代的卡片式设计和更好的视觉层次应当作为标准组件在全项目范围内复用。

What Changes

  • 新增:创建高内聚、可复用的 BillListComponent.vue 组件(基于 v2 风格)
  • 调整:修改 v2 的一行一卡片布局,支持更紧凑的列表展示
  • 新增:内置筛选(按类型、分类、日期)、排序(金额、时间)、分页功能
  • 新增左滑删除交互Vant SwipeCell
  • 新增点击查看详情功能emit 事件)
  • 删除:移除旧版本的 TransactionList.vueWeb/src/components/
  • 迁移现有使用旧组件的页面TransactionsRecord.vue、BillAnalysisView.vue 等)改为引用新组件

Capabilities

New Capabilities

  • bill-list-component: 可复用的账单列表组件,支持筛选、排序、分页、左滑删除、点击详情等功能,样式基于 calendarV2 的现代化设计

Modified Capabilities

  • transaction-list-display: 现有的交易列表展示能力需要统一到新组件,旧版本 TransactionList.vue 的功能将被新组件替代

Impact

受影响的代码:

  • Web/src/components/TransactionList.vue - 将被删除
  • Web/src/views/calendarV2/modules/TransactionList.vue - 作为参考基础,可能需要重构
  • Web/src/views/TransactionsRecord.vue - 需要切换到新组件
  • Web/src/views/BillAnalysisView.vue - 需要切换到新组件
  • 其他可能引用旧版 TransactionList 的视图

API 依赖:

  • @/api/transactionRecord - deleteTransaction, getTransactionsByDate 等接口
  • 保持现有 API 调用方式不变

UI 依赖:

  • Vant UI: van-swipe-cell, van-list, van-loading, van-empty, van-icon, van-tag
  • 需要新增筛选/排序 UI 组件van-dropdown-menu, van-popup

用户体验影响:

  • 正面:统一的视觉风格、更流畅的交互、更好的性能(高内聚设计)
  • 迁移风险:需要确保功能对等,避免遗漏旧版本的特殊功能(如 checkbox 选择模式)