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` 中现有征信卡片定义，确认本次不改：

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

- [ ] **Step 3: 记录前端不改动结论**

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

```md
## 前端影响说明

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

- [ ] **Step 4: 提交边界确认**

```bash
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: 在实施记录中写明前端验收结论**

补充：

```md
## 前端验收结论

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

## Task 3: 最终检查

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

- [ ] **Step 1: 检查工作区无前端源码改动**

Run:

```bash
git status --short ruoyi-ui
```

Expected:

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

- [ ] **Step 2: 检查计划与设计一致**

确认没有出现以下偏移：

- 把征信解析顺手接入前端上传卡片
- 顺手新增前端 API 封装
- 顺手调整项目上传状态逻辑

- [ ] **Step 3: 最终提交**

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

## Review Notes

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