125 lines
4.9 KiB
Markdown
125 lines
4.9 KiB
Markdown
# LSFX Mock Server 异常账户命中流水前端 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.
|
||
>
|
||
> 仓库约束：当前仓库明确禁止开启 subagent，执行时统一使用 `superpowers:executing-plans`。
|
||
|
||
**Goal:** 在不新增 `ruoyi-ui` 页面、接口或交互的前提下，明确本次 `lsfx-mock-server` 异常账户命中流水建设对前端的影响边界，并沉淀零代码改动结论与核验记录。
|
||
|
||
**Architecture:** 本次需求主体是 `lsfx-mock-server` 内部造数能力增强，不修改主系统前端消费协议。前端计划采用“零源码改动 + 承接边界核查 + 文档沉淀”的最短路径；若核查发现必须新增前端字段或联调适配，应停止执行并回到设计阶段，而不是在本计划中临时扩展 UI。
|
||
|
||
**Tech Stack:** Vue 2, rg, Markdown docs
|
||
|
||
---
|
||
|
||
## File Structure
|
||
|
||
- `ruoyi-ui/src/api/`: 只用于检索是否存在依赖 Mock 异常账户造数的新接口封装，不预期修改。
|
||
- `ruoyi-ui/src/views/ccdiProject/`: 只用于确认现有风险页面是否直接消费后端聚合结果，不预期修改。
|
||
- `docs/reports/implementation/2026-03-31-lsfx-mock-server-abnormal-account-frontend-implementation.md`: 记录本次前端零代码改动的结论。
|
||
- `docs/tests/records/2026-03-31-lsfx-mock-server-abnormal-account-frontend-verification.md`: 记录核验命令、目录范围和判断依据。
|
||
|
||
## Task 1: 核验当前前端无需新增异常账户 Mock 适配代码
|
||
|
||
**Files:**
|
||
- Reference: `ruoyi-ui/src/api/`
|
||
- Reference: `ruoyi-ui/src/views/ccdiProject/`
|
||
- Reference: `docs/design/2026-03-31-lsfx-mock-server-abnormal-account-design.md`
|
||
|
||
- [ ] **Step 1: Check the existing frontend touchpoints**
|
||
|
||
确认当前前端是否存在以下任一需要同步改造的触点：
|
||
|
||
- 直接调用 `lsfx-mock-server` 的页面或接口封装
|
||
- 依赖异常账户 Mock 返回新字段的前端展示逻辑
|
||
- 需要为 Mock 联调新增独立上传页、测试页或调试按钮的场景
|
||
|
||
若不存在，则本轮前端默认保持零代码改动。
|
||
|
||
- [ ] **Step 2: Verify with search commands**
|
||
|
||
Run:
|
||
|
||
```bash
|
||
cd ruoyi-ui
|
||
rg -n "lsfx|mock|异常账户|getBSByLogId|bankStatement" src
|
||
```
|
||
|
||
Expected:
|
||
|
||
- 若仅命中既有业务页面或无直接 Mock 依赖，说明本轮无需新增前端代码
|
||
- 不应因为 Mock 服务增强而顺手新增演示页或调试页
|
||
|
||
- [ ] **Step 3: Confirm no contract adaptation is needed**
|
||
|
||
对照设计文档确认：
|
||
|
||
- Mock 返回的银行流水接口结构没有变化
|
||
- 本次仅增强内部造数，不新增前端必填参数
|
||
- 风险页面继续消费后端聚合结果，不直接依赖 Mock 内部账户事实
|
||
|
||
若上述任一不成立，则停止执行并回到设计阶段。
|
||
|
||
- [ ] **Step 4: Record the no-op conclusion**
|
||
|
||
在后续实施记录中明确写明：
|
||
|
||
- 本次需求不涉及 `ruoyi-ui` 源码改动
|
||
- 不为了“方便联调”临时增加前端占位页面或按钮
|
||
|
||
- [ ] **Step 5: Commit**
|
||
|
||
```bash
|
||
git add docs/reports/implementation/2026-03-31-lsfx-mock-server-abnormal-account-frontend-implementation.md docs/tests/records/2026-03-31-lsfx-mock-server-abnormal-account-frontend-verification.md
|
||
git commit -m "记录异常账户Mock前端零改动结论"
|
||
```
|
||
|
||
## Task 2: 沉淀前端核验记录并确保源码无变更
|
||
|
||
**Files:**
|
||
- Create: `docs/reports/implementation/2026-03-31-lsfx-mock-server-abnormal-account-frontend-implementation.md`
|
||
- Create: `docs/tests/records/2026-03-31-lsfx-mock-server-abnormal-account-frontend-verification.md`
|
||
|
||
- [ ] **Step 1: Write implementation record**
|
||
|
||
在 `docs/reports/implementation/2026-03-31-lsfx-mock-server-abnormal-account-frontend-implementation.md` 中记录：
|
||
|
||
- 需求主体是 `lsfx-mock-server` 后端造数
|
||
- 前端当前不直接消费 Mock 内部新增的异常账户事实
|
||
- 因此本轮不修改 `ruoyi-ui` 任何源码
|
||
|
||
- [ ] **Step 2: Write verification record**
|
||
|
||
在 `docs/tests/records/2026-03-31-lsfx-mock-server-abnormal-account-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-31-lsfx-mock-server-abnormal-account-frontend-implementation.md docs/tests/records/2026-03-31-lsfx-mock-server-abnormal-account-frontend-verification.md
|
||
git commit -m "补充异常账户Mock前端核验记录"
|
||
```
|