ccdi/docs/plans/frontend/2026-03-23-credit-parse-client-frontend-implementation.md

Credit Parse Client 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: 确认本次征信解析客户端建设不涉及前端代码改动，并输出可执行的前端协作与验收计划，避免后续联调时误改前端现有上传链路。

Architecture: 本次需求边界限定在 ccdi-lsfx 后端模块：新增独立征信解析 Client、独立配置和联调接口，不接入 ccdi-project 现有上传流程，也不新增前端页面或 API 封装。因此前端计划以“确认无改动、保留联调信息、避免误接入”为主。

Tech Stack: Vue 2, Axios request 封装, 若依前端工程结构, Markdown 文档

---

文件结构与职责

本次不修改的前端文件

• ruoyi-ui/src/api/ccdiProjectUpload.js
• ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue

新增文件

• docs/reports/implementation/2026-03-23-credit-parse-client-implementation.md 在后端实施完成后，由同一次改动统一补充实施记录，其中需明确本次前端无代码改动。

参考文件

• docs/design/2026-03-23-credit-parse-client-design.md
• docs/plans/backend/2026-03-23-credit-parse-client-backend-implementation.md
• ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue

Task 1: 确认前端边界

Files:

• Review: ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue

• Review: ruoyi-ui/src/api/ccdiProjectUpload.js

• Step 1: 核对设计边界

确认以下结论成立：

• 新接口落在 ccdi-lsfx

• 调用入口为 POST /lsfx/credit/parse

• 不接入项目上传主链路

• 不新增前端上传卡片行为

• 不新增前端 API 文件

• Step 2: 检查现有前端征信入口不做误修改

查看 UploadData.vue 中现有征信卡片定义，确认本次不改：

{
  key: "credit",
  title: "征信导入",
  desc: "支持 HTML 格式征信数据解析",
  icon: "el-icon-s-data",
  btnText: "上传征信",
  uploaded: false,
  disabled: true,
}

• Step 3: 记录前端不改动结论

在实施记录中预留一段文字：

## 前端影响说明

本次需求仅在 `ccdi-lsfx` 后端模块新增征信解析 Client 与联调接口，前端未做代码改动。

• Step 4: 提交边界确认

git add docs/plans/frontend/2026-03-23-credit-parse-client-frontend-implementation.md
git commit -m "新增征信解析客户端前端实施计划"

Task 2: 后端联调验收配合

Files:

• Review: docs/reports/implementation/2026-03-23-credit-parse-client-implementation.md

• Step 1: 后端完成后校验接口契约

核对后端实际输出是否满足以下约定：

• AjaxResult.code = 200

• AjaxResult.data.message

• AjaxResult.data.status_code

• AjaxResult.data.payload.lx_header

• AjaxResult.data.payload.lx_debt

• AjaxResult.data.payload.lx_publictype

• Step 2: 确认无前端阻塞项

若没有以下情况，则维持前端零改动：

• 需要在项目页面挂接新按钮
• 需要新增前端 API 封装
• 需要前端解析 payload 并渲染页面

若出现上述新需求，应单独发起新的设计和计划，不在本次实施中顺带处理。

• Step 3: 在实施记录中写明前端验收结论

补充：

## 前端验收结论

- 本次无前端代码改动
- 后端接口契约已形成，可供后续独立前端联调使用

Task 3: 最终检查

Files:

• Modify: docs/plans/frontend/2026-03-23-credit-parse-client-frontend-implementation.md

• Step 1: 检查工作区无前端源码改动

Run:

git status --short ruoyi-ui

Expected:

• 无 ruoyi-ui 目录下源码改动，或只有用户明确要求的相关改动

• Step 2: 检查计划与设计一致

确认没有出现以下偏移：

• 把征信解析顺手接入前端上传卡片

• 顺手新增前端 API 封装

• 顺手调整项目上传状态逻辑

• Step 3: 最终提交

git add docs/plans/frontend/2026-03-23-credit-parse-client-frontend-implementation.md
git commit -m "补充征信解析客户端前端实施说明"

Review Notes

• 本计划明确为“前端零代码改动计划”，目的是固化边界，避免后续联调时无意改动现有项目上传前端链路。
• 由于当前协作约定禁止开启 subagent，本计划不执行子代理审阅环节。