diff --git a/doc/2026-03-28-workflow-execute-rate-display-backend-plan.md b/doc/2026-03-28-workflow-execute-rate-display-backend-plan.md new file mode 100644 index 0000000..56be47f --- /dev/null +++ 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: 生成仅包含后端留档内容的中文提交。 diff --git a/doc/2026-03-28-workflow-execute-rate-display-frontend-plan.md b/doc/2026-03-28-workflow-execute-rate-display-frontend-plan.md new file mode 100644 index 0000000..fafd023 --- /dev/null +++ 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 + +``` + +改为: + +```vue + +``` + +- [ ] **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: 若存在本次联调启动的进程,全部停止后再结束任务。 diff --git 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 new file mode 100644 index 0000000..93b417d --- /dev/null +++ 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 的计划文档复审流程