125 lines
4.6 KiB
Markdown
125 lines
4.6 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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**
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
git diff --name-only -- ruoyi-ui
|
|
```
|
|
|
|
Expected:
|
|
|
|
- 无输出
|
|
- 证明本次前端计划执行保持零源码改动
|
|
|
|
- [ ] **Step 4: Confirm no frontend build is required**
|
|
|
|
在验证记录中明确写明：
|
|
|
|
- 因为 `ruoyi-ui` 无源码改动，本次不执行 `npm run build:prod`
|
|
- 若后续新增实际接入页面，再补充构建和联调测试
|
|
|
|
- [ ] **Step 5: Commit**
|
|
|
|
```bash
|
|
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前端核验记录"
|
|
```
|