补充执行利率展示前后端实施计划

2026-03-28 11:43:37 +08:00
parent 7e15171059
commit 44000a7b76
3 changed files with 192 additions and 0 deletions
--- a/doc/2026-03-28-workflow-execute-rate-display-backend-plan.md
+++ b/doc/2026-03-28-workflow-execute-rate-display-backend-plan.md
@@ -0,0 +1,71 @@
+# 流程列表执行利率展示后端实施计划
+
+> **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:** 确认流程列表执行利率展示需求无需后端代码改动，并完成后端链路验证与留档。
+
+**Architecture:** 当前后端列表接口直接返回 `LoanPricingWorkflow` 实体，而实体已包含 `executeRate` 字段。本次后端计划不引入接口变更，只做链路确认、边界验证和实施记录，确保执行阶段不会误改接口或字段语义。
+
+**Tech Stack:** Spring Boot、MyBatis Plus、Maven、RuoYi 后端工程
+
+---
+
+### Task 1: 确认后端列表链路已具备执行利率返回能力
+
+**Files:**
+- Modify: `doc/implementation-report-2026-03-28-workflow-execute-rate-display-backend.md`
+- Reference: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/entity/LoanPricingWorkflow.java`
+- Reference: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/controller/LoanPricingWorkflowController.java`
+- Reference: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/service/impl/LoanPricingWorkflowServiceImpl.java`
+
+- [ ] **Step 1: 确认实体包含 `executeRate` 字段**
+
+Run: `rg -n 'private String executeRate' ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/entity/LoanPricingWorkflow.java`
+Expected: 能定位到 `executeRate` 字段定义。
+
+- [ ] **Step 2: 确认列表接口直接返回 `LoanPricingWorkflow`**
+
+Run: `sed -n '60,90p' ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/controller/LoanPricingWorkflowController.java`
+Expected: 能看到 `/loanPricing/workflow/list` 直接返回 `LoanPricingWorkflow` 分页结果。
+
+- [ ] **Step 3: 确认分页查询未对 `executeRate` 做截断或替换**
+
+Run: `sed -n '100,150p' ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/service/impl/LoanPricingWorkflowServiceImpl.java`
+Expected: 能看到分页查询直接返回实体分页记录，无额外字段转换逻辑。
+
+- [ ] **Step 4: 形成后端结论并写入实施记录**
+
+将以下内容写入实施记录：
+
+```markdown
+- 后端实体已包含 `executeRate`
+- 列表接口已直接返回 `LoanPricingWorkflow`
+- 本次需求无需后端代码改动
+```
+
+建议记录文件：`doc/implementation-report-2026-03-28-workflow-execute-rate-display-backend.md`
+
+### Task 2: 完成后端验证边界说明
+
+**Files:**
+- Modify: `doc/implementation-report-2026-03-28-workflow-execute-rate-display-backend.md`
+
+- [ ] **Step 1: 说明本次明确不改后端接口和数据库结构**
+
+将以下说明加入实施记录：
+
+```markdown
+- 不修改 `/loanPricing/workflow/list` 接口结构
+- 不修改 `loanRate` 字段业务含义
+- 不修改数据库表结构和 SQL
+```
+
+- [ ] **Step 2: 如执行了后端本地验证，结束相关进程**
+
+Run: `ps -ef | rg 'RuoYiApplication|java'`
+Expected: 若本次任务为验证启动了后端进程，验证完成后主动停止本次启动的进程。
+
+- [ ] **Step 3: 提交后端留档改动**
+
+Run: `git add doc/implementation-report-2026-03-28-workflow-execute-rate-display-backend.md && git commit -m "补充执行利率展示后端实施记录"`
+Expected: 生成仅包含后端留档内容的中文提交。
--- a/doc/2026-03-28-workflow-execute-rate-display-frontend-plan.md
+++ b/doc/2026-03-28-workflow-execute-rate-display-frontend-plan.md
@@ -0,0 +1,96 @@
+# 流程列表执行利率展示前端实施计划
+
+> **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:** 让流程列表页“执行利率(%)”列展示数据库 `execute_rate` 的实际值。
+
+**Architecture:** 本次只调整前端流程列表页的表格列绑定，不改接口、不改后端、不改详情页。通过将列表列的 `prop` 从 `loanRate` 切换为 `executeRate`，直接消费后端实体已返回的执行利率字段。
+
+**Tech Stack:** Vue 2、Element UI、RuoYi 前端工程、npm
+
+---
+
+### Task 1: 修正流程列表页执行利率列绑定
+
+**Files:**
+- Modify: `ruoyi-ui/src/views/loanPricing/workflow/index.vue`
+
+- [ ] **Step 1: 查看当前流程列表页执行利率列定义**
+
+Run: `sed -n '40,70p' ruoyi-ui/src/views/loanPricing/workflow/index.vue`
+Expected: 能看到列头为“执行利率(%)”，且当前 `prop="loanRate"`。
+
+- [ ] **Step 2: 将列表列绑定改为 `executeRate`**
+
+将以下代码：
+
+```vue
+<el-table-column label="执行利率(%)" align="center" prop="loanRate" width="100" />
+```
+
+改为：
+
+```vue
+<el-table-column label="执行利率(%)" align="center" prop="executeRate" width="100" />
+```
+
+- [ ] **Step 3: 重新查看源码确认绑定已切换**
+
+Run: `rg -n '执行利率\\(%\\)|prop=\"executeRate\"|prop=\"loanRate\"' ruoyi-ui/src/views/loanPricing/workflow/index.vue`
+Expected: 能看到“执行利率(%)”仍存在，且该列表列绑定为 `prop="executeRate"`，不再出现该列绑定 `loanRate` 的情况。
+
+- [ ] **Step 4: 执行前端构建验证**
+
+Run: `npm --prefix ruoyi-ui run build:prod`
+Expected: 构建成功，输出包含 `Build complete.`
+
+- [ ] **Step 5: 补充本次前端实施记录**
+
+新增或更新实施记录，至少写明：
+
+```markdown
+- 将流程列表页“执行利率(%)”列绑定从 `loanRate` 调整为 `executeRate`
+- 保持列表接口、后端实体和数据库结构不变
+- 验证前端构建通过
+```
+
+建议记录文件：`doc/implementation-report-2026-03-28-workflow-execute-rate-display-frontend.md`
+
+- [ ] **Step 6: 如果为验证启动了前端进程，结束对应进程**
+
+Run: `ps -ef | rg 'ruoyi-ui|vue-cli-service'`
+Expected: 识别本次验证启动的前端进程；如果本次任务启动过前端服务，验证结束后主动停止。
+
+- [ ] **Step 7: 提交前端改动**
+
+Run: `git add ruoyi-ui/src/views/loanPricing/workflow/index.vue doc/implementation-report-2026-03-28-workflow-execute-rate-display-frontend.md && git commit -m "修正流程列表执行利率前端展示"`
+Expected: 生成仅包含本次前端改动的中文提交。
+
+### Task 2: 页面联调确认展示值来源正确
+
+**Files:**
+- Modify: `doc/implementation-report-2026-03-28-workflow-execute-rate-display-frontend.md`
+
+- [ ] **Step 1: 打开流程列表页并确认页面可进入**
+
+Run: 按项目现有方式启动前端后，进入贷款定价流程列表页。
+Expected: 页面正常加载，表格正常渲染。
+
+- [ ] **Step 2: 核对存在执行利率记录的展示结果**
+
+Run: 在页面上选择一条已设定执行利率的数据，与数据库或后端返回进行比对。
+Expected: 列表展示值与 `execute_rate` 一致，而不是 `loan_rate`。
+
+- [ ] **Step 3: 记录联调结果**
+
+将以下结果写入实施记录：
+
+```markdown
+- 已确认流程列表页执行利率列展示的是 `executeRate`
+- 已确认列表页其余查询、查看入口未受影响
+```
+
+- [ ] **Step 4: 停止联调过程中启动的前端进程**
+
+Run: `ps -ef | rg 'ruoyi-ui|vue-cli-service'`
+Expected: 若存在本次联调启动的进程，全部停止后再结束任务。
--- a/doc/implementation-report-2026-03-28-workflow-execute-rate-display-plans.md
+++ b/doc/implementation-report-2026-03-28-workflow-execute-rate-display-plans.md
@@ -0,0 +1,25 @@
+# 流程列表执行利率展示实施计划产出记录
+
+## 实施时间
+- 2026-03-28
+
+## 修改内容
+- 基于设计文档补充前端实施计划
+- 基于设计文档补充后端实施计划
+- 明确本次需求前端负责修正列表字段绑定，后端负责边界确认与留档
+
+## 文档路径
+- `doc/2026-03-28-workflow-execute-rate-display-design.md`
+- `doc/2026-03-28-workflow-execute-rate-display-frontend-plan.md`
+- `doc/2026-03-28-workflow-execute-rate-display-backend-plan.md`
+- `doc/implementation-report-2026-03-28-workflow-execute-rate-display-plans.md`
+
+## 计划结论
+- 前端计划只修改流程列表页 `ruoyi-ui/src/views/loanPricing/workflow/index.vue`
+- 前端实施目标是把列表列绑定从 `loanRate` 调整为 `executeRate`
+- 后端计划不改代码，只确认现有返回链路已具备 `executeRate` 返回能力
+- 两份计划均要求验证结束后关闭本次任务启动的前后端进程
+
+## 说明
+- 按仓库要求，设计文档和实施计划均保存在 `doc` 目录
+- 仓库约束禁止启用 subagent，因此本次未执行基于 subagent 的计划文档复审流程