4.1 KiB
4.1 KiB
流程列表更新时间展示设计文档
1. 背景
当前流程列表页展示的是“创建时间”，但列表排序语义已经是按 update_time 倒序。这会导致页面展示字段与排序依据不一致。
本次需求是将流程列表中的“创建时间”替换为“更新时间”，并保持列表继续按更新时间排序。
2. 已确认约束
- 仅调整流程列表页时间列展示
- 列表中不同时展示创建时间和更新时间
- 后端列表链路继续按
update_time倒序排序 - 前端时间列改为展示
updateTime - 不修改详情页时间展示逻辑
- 文档和计划统一保存在
doc目录
3. 现状分析
当前列表链路情况如下：
- 前端流程列表页时间列文案为“创建时间”
- 前端时间列绑定字段为
createTime - 后端列表专用 SQL 已按
lpw.update_time DESC排序 - 列表专用 VO 当前仅暴露
createTime
因此页面展示与实际排序依据不一致。
4. 方案对比
方案一：前后端统一切换为更新时间
做法：
- 前端将时间列文案改为“更新时间”
- 前端字段绑定从
createTime改为updateTime - 后端列表专用 VO 增加
updateTime - 联表 SQL 返回
lpw.update_time AS updateTime - 排序继续保留
ORDER BY lpw.update_time DESC
优点：
- 展示语义与排序语义完全一致
- 改动范围小
- 不引入字段语义混乱
缺点：
- 无明显缺点
方案二：继续展示创建时间，只补充说明按更新时间排序
做法：
- 保持前端展示
createTime - 仅在文档或页面认知上说明排序按更新时间进行
优点：
- 改动最少
缺点：
- 不符合“列表中展示更新时间”的需求
- 页面展示和排序逻辑仍不一致
方案三：后端把 update_time 映射到 createTime
做法：
- 前端继续绑定
createTime - 后端列表返回时用
update_time填到createTime
优点：
- 前端改动更少
缺点：
- 字段语义错误
- 后续维护容易误解
5. 设计结论
采用方案一。
最终实现为：
- 流程列表页将“创建时间”替换为“更新时间”
- 时间列字段绑定改为
updateTime - 后端列表专用 VO 补充
updateTime - 联表 SQL 返回
lpw.update_time AS updateTime - 排序继续按
lpw.update_time DESC
6. 后端设计
6.1 返回对象
列表专用返回对象 LoanPricingWorkflowListVO 增加：
private Date updateTime;
保留现有字段不变。
6.2 SQL 设计
在列表专用 SQL 中：
- 新增
lpw.update_time AS updateTime - 保持
ORDER BY lpw.update_time DESC
不修改当前筛选条件。
7. 前端设计
在 ruoyi-ui/src/views/loanPricing/workflow/index.vue 中：
- 将时间列文案从“创建时间”改为“更新时间”
- 将列绑定字段从
createTime改为updateTime - 模板中
parseTime的参数改为scope.row.updateTime
页面中只保留这一列，不再显示创建时间。
8. 边界与非目标
本次不包含以下内容：
- 不新增双时间列展示
- 不修改详情页时间展示逻辑
- 不修改数据库表结构
- 不调整列表筛选项
- 不改变分页行为
9. 风险与控制
风险点主要有两个：
- 后端 VO 未补充
updateTime，前端会拿不到值 - 前端列头改了但仍绑定
createTime，会继续展示旧字段
控制方式：
- 同步修改 VO、SQL、前端模板三个位置
- 保持排序语句不动，只对齐展示字段
- 通过源码检查、后端测试和前端构建做验证
10. 验证方案
实施后需要完成以下验证：
- 前端列表时间列文案为“更新时间”
- 前端列表时间列绑定字段为
updateTime - 后端
LoanPricingWorkflowListVO已定义updateTime - 后端联表 SQL 已返回
lpw.update_time AS updateTime - 后端模块测试通过
- 前端生产构建通过
11. 实施范围
- 前端：流程列表页 1 个页面文件
- 后端：列表 VO 与联表 SQL
- 数据库：无改动
本次属于列表展示字段与排序语义对齐，不涉及业务流程变更。