ccdi/docs/plans/frontend/2026-03-23-credit-parsing-mock-server-frontend-implementation.md

Credit Parsing Mock Server Frontend Implementation Plan

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 在不新增前端页面和业务补丁的前提下，明确本次征信解析 Mock Server 建设对前端的影响边界，并沉淀联调核验与零改动结论。

Architecture: 本次需求主体是 lsfx-mock-server 的后端 Mock 能力建设，不要求 ruoyi-ui 新增页面、路由、接口封装或交互。前端计划采用“零源码改动 + 契约核验 + 记录沉淀”的最短路径；若核验发现必须新增前端消费字段，则应停止执行并回到设计阶段，而不是在本计划中临时扩展功能。

Tech Stack: Vue 2, Axios request wrapper, rg, Markdown docs

---

File Structure

• ruoyi-ui/src/api/: 只用于核验当前仓库是否已有征信解析相关调用，不预期修改。
• ruoyi-ui/src/views/: 只用于核验是否存在需要接入征信解析 Mock 的页面触点，不预期修改。
• ruoyi-ui/src/utils/request.js: 只用于确认现有请求封装是否足以承接未来联调，不预期修改。
• docs/reports/implementation/2026-03-23-credit-parsing-mock-server-frontend-record.md: 记录本次前端零代码改动的范围与依据。
• docs/tests/records/2026-03-23-credit-parsing-mock-server-frontend-verification.md: 记录前端契约核验命令、结果和结论。

Task 1: 核验当前前端不存在征信解析 Mock 接入改造需求

Files:

• Reference: ruoyi-ui/src/api/

• Reference: ruoyi-ui/src/views/

• Reference: ruoyi-ui/src/utils/request.js

• Reference: docs/design/2026-03-23-credit-parsing-mock-server-design.md

• Step 1: Check the existing frontend touchpoints

检查当前前端是否已经存在以下任一触点：

• 征信 HTML 上传入口
• 征信解析结果展示页
• 指向 htmlEval、xfeature、征信解析 的接口封装

如无上述触点，则本次计划默认保持前端零代码改动。

• Step 2: Verify with search commands

Run:

cd ruoyi-ui
rg -n "htmlEval|xfeature|征信|credit" src

Expected:

• 若无输出或仅命中无关文字，说明当前前端仓库没有现成的征信解析接入点

• 本次 Mock Server 不需要同步新增前端代码

• Step 3: Confirm no contract adaptation is needed

对照设计文档确认：

• Mock 接口为独立服务能力，不替换现有前端接口返回结构
• 不要求前端新增必填请求字段
• 不要求前端渲染新增结果列或交互入口

若上述任一不成立，则停止执行并回到设计阶段。

• Step 4: Record the no-op conclusion

在后续实施记录中明确写明：

• 本次需求不涉及 ruoyi-ui 源码改动

• 不为了“看起来完整”而额外创建演示页或调试页

• Step 5: Commit

git add docs/reports/implementation/2026-03-23-credit-parsing-mock-server-frontend-record.md docs/tests/records/2026-03-23-credit-parsing-mock-server-frontend-verification.md
git commit -m "记录征信解析Mock前端零改动结论"

Task 2: 沉淀前端联调与验证记录

Files:

• Create: docs/reports/implementation/2026-03-23-credit-parsing-mock-server-frontend-record.md

• Create: docs/tests/records/2026-03-23-credit-parsing-mock-server-frontend-verification.md

• Step 1: Write implementation record

在 docs/reports/implementation/2026-03-23-credit-parsing-mock-server-frontend-record.md 中记录：

• 本次需求核心在 Mock 服务后端

• 当前前端仓库不存在征信解析接入点

• 因此本轮实施不修改 ruoyi-ui 任何源码

• Step 2: Write verification record

在 docs/tests/records/2026-03-23-credit-parsing-mock-server-frontend-verification.md 中记录：

• 执行过的 rg 核验命令

• 查验的目录范围

• “无需前端改动”的判断依据

• Step 3: Verify frontend diff stays empty

Run:

git diff --name-only -- ruoyi-ui

Expected:

• 无输出

• 证明本次前端计划执行保持零源码改动

• Step 4: Confirm no frontend build is required

在验证记录中明确写明：

• 因为 ruoyi-ui 无源码改动，本次不执行 npm run build:prod

• 若后续新增实际接入页面，再补充构建和联调测试

• Step 5: Commit

git add docs/reports/implementation/2026-03-23-credit-parsing-mock-server-frontend-record.md docs/tests/records/2026-03-23-credit-parsing-mock-server-frontend-verification.md
git commit -m "补充征信解析Mock前端核验记录"