153 lines
4.5 KiB
Markdown
153 lines
4.5 KiB
Markdown
# 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，本计划不执行子代理审阅环节。
|