121 lines
4.0 KiB
Markdown
121 lines
4.0 KiB
Markdown
# 流程列表更新时间展示后端实施计划
|
||
|
||
> **For agentic workers:** REQUIRED: Use superpowers:executing-plans to implement this plan in this repository. Do not use subagents. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 让流程列表接口返回 `updateTime`，并保持按更新时间倒序排序。
|
||
|
||
**Architecture:** 后端只调整列表专用 VO 和联表 SQL，让列表展示字段与现有 `ORDER BY lpw.update_time DESC` 对齐。不修改详情页、不改数据库结构、不变更列表其他字段。
|
||
|
||
**Tech Stack:** Spring Boot、MyBatis Plus、Lombok、Maven、XML Mapper
|
||
|
||
---
|
||
|
||
### Task 1: 为列表专用 VO 补充更新时间字段
|
||
|
||
**Files:**
|
||
- Modify: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/vo/LoanPricingWorkflowListVO.java`
|
||
- Test: `ruoyi-loan-pricing/src/test/java/com/ruoyi/loanpricing/domain/vo/LoanPricingWorkflowListVOTest.java`
|
||
|
||
- [ ] **Step 1: 写失败测试约束 `updateTime` 字段存在**
|
||
|
||
在 `LoanPricingWorkflowListVOTest` 中新增一个最小测试，例如：
|
||
|
||
```java
|
||
@Test
|
||
void shouldExposeUpdateTimeField() {
|
||
LoanPricingWorkflowListVO vo = new LoanPricingWorkflowListVO();
|
||
Date now = new Date();
|
||
vo.setUpdateTime(now);
|
||
|
||
assertEquals(now, vo.getUpdateTime());
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 2: 运行测试确认在字段未添加前失败**
|
||
|
||
Run: `mvn -pl ruoyi-loan-pricing -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=LoanPricingWorkflowListVOTest test`
|
||
Expected: FAIL，提示 `updateTime` 相关 getter/setter 不存在。
|
||
|
||
- [ ] **Step 3: 在 VO 中新增 `updateTime`**
|
||
|
||
在 `LoanPricingWorkflowListVO` 中新增：
|
||
|
||
```java
|
||
private Date updateTime;
|
||
```
|
||
|
||
- [ ] **Step 4: 重新运行测试确认通过**
|
||
|
||
Run: `mvn -pl ruoyi-loan-pricing -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=LoanPricingWorkflowListVOTest test`
|
||
Expected: PASS
|
||
|
||
### Task 2: 让联表 SQL 返回更新时间
|
||
|
||
**Files:**
|
||
- Modify: `ruoyi-loan-pricing/src/main/resources/mapper/loanpricing/LoanPricingWorkflowMapper.xml`
|
||
- Test: `ruoyi-loan-pricing/src/test/java/com/ruoyi/loanpricing/service/impl/LoanPricingWorkflowServiceImplTest.java`
|
||
|
||
- [ ] **Step 1: 写失败测试约束列表分页结果透传 `updateTime`**
|
||
|
||
在 `LoanPricingWorkflowServiceImplTest` 中新增测试，例如：
|
||
|
||
```java
|
||
@Test
|
||
void shouldReturnPagedWorkflowListWithUpdateTime() {
|
||
LoanPricingWorkflowListVO row = new LoanPricingWorkflowListVO();
|
||
Date now = new Date();
|
||
row.setUpdateTime(now);
|
||
|
||
Page<LoanPricingWorkflowListVO> pageResult = new Page<>(1, 10);
|
||
pageResult.setRecords(List.of(row));
|
||
|
||
when(loanPricingWorkflowMapper.selectWorkflowPageWithRates(any(), any())).thenReturn(pageResult);
|
||
|
||
IPage<LoanPricingWorkflowListVO> result = loanPricingWorkflowService.selectLoanPricingPage(new Page<>(1, 10), new LoanPricingWorkflow());
|
||
|
||
assertEquals(now, result.getRecords().get(0).getUpdateTime());
|
||
}
|
||
```
|
||
|
||
- [ ] **Step 2: 运行测试确认在 SQL/VO 未对齐前失败**
|
||
|
||
Run: `mvn -pl ruoyi-loan-pricing -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=LoanPricingWorkflowServiceImplTest test`
|
||
Expected: 若 `updateTime` 尚未补齐，则失败。
|
||
|
||
- [ ] **Step 3: 在联表 SQL 中新增更新时间返回字段**
|
||
|
||
在 `LoanPricingWorkflowMapper.xml` 的 `SELECT` 中新增：
|
||
|
||
```xml
|
||
lpw.update_time AS updateTime
|
||
```
|
||
|
||
并保留：
|
||
|
||
```xml
|
||
ORDER BY lpw.update_time DESC
|
||
```
|
||
|
||
- [ ] **Step 4: 运行服务层测试确认通过**
|
||
|
||
Run: `mvn -pl ruoyi-loan-pricing -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=LoanPricingWorkflowServiceImplTest test`
|
||
Expected: PASS
|
||
|
||
- [ ] **Step 5: 运行模块测试确认无回归**
|
||
|
||
Run: `mvn -pl ruoyi-loan-pricing -am -Dsurefire.failIfNoSpecifiedTests=false test`
|
||
Expected: 模块测试通过。
|
||
|
||
- [ ] **Step 6: 补充后端实施记录**
|
||
|
||
Create: `doc/implementation-report-2026-03-28-workflow-update-time-list-backend.md`
|
||
|
||
至少写明：
|
||
|
||
```markdown
|
||
- 列表专用 VO 已新增 `updateTime`
|
||
- 联表 SQL 已返回 `lpw.update_time AS updateTime`
|
||
- 列表继续按 `lpw.update_time DESC` 排序
|
||
- 已完成后端模块测试验证
|
||
```
|