调整征信导入入口跳转到征信维护页面

2026-03-24 13:59:36 +08:00
parent f4481792c8
commit 47eed3e63c
7 changed files with 374 additions and 130 deletions
--- a/docs/design/2026-03-24-project-upload-credit-entry-jump-design.md
+++ b/docs/design/2026-03-24-project-upload-credit-entry-jump-design.md
@@ -32,7 +32,7 @@
 ## 最终方案
 采用方案一。

-将项目详情页 [`UploadData.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue) 中“征信导入”按钮的点击行为，从“打开征信上传弹窗”调整为直接执行前端路由跳转，目标页面为“信息维护-征信维护”对应的 `"/creditInfo"`。
+将项目详情页 [`UploadData.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue) 中“征信导入”按钮的点击行为，从“打开征信上传弹窗”调整为直接执行前端路由跳转，目标页面为“信息维护-征信维护”对应的 `"/maintain/creditInfo"`。

 原按钮专属的本地弹窗入口不再作为用户操作路径保留。本次只处理入口行为，不调整征信维护页 [`index.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiCreditInfo/index.vue) 的既有交互与接口调用。

@@ -44,7 +44,7 @@
 ## 数据流与交互
 1. 用户在项目详情页进入“上传数据”
 2. 点击“征信导入”按钮
-3. 前端执行 `this.$router.push('/creditInfo')`
+3. 前端执行 `this.$router.push('/maintain/creditInfo')`
 4. 系统进入“信息维护-征信维护”页面

 ## 异常处理
--- a/docs/plans/backend/2026-03-24-project-upload-credit-entry-jump-backend-implementation.md
+++ b/docs/plans/backend/2026-03-24-project-upload-credit-entry-jump-backend-implementation.md
@@ -0,0 +1,90 @@
+# Project Upload Credit Entry Jump Backend 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/creditInfo/*` 接口链路已存在且继续复用。本计划只保留后端影响面检查和实施记录，避免误改后端逻辑。
+
+**Tech Stack:** Spring Boot 3, Java 21, SQL 脚本检视, 文档记录
+
+---
+
+## 文件结构与职责
+
+**修改文件**
+
+- `docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-backend-record.md`
+  记录本次后端影响评估结果，明确无代码改动。
+
+**参考文件**
+
+- `docs/design/2026-03-24-project-upload-credit-entry-jump-design.md`
+- `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/controller/CcdiCreditInfoController.java`
+- `sql/ccdi_credit_info_menu.sql`
+
+## Task 1: 确认后端无改动需求
+
+**Files:**
+- Review: `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/controller/CcdiCreditInfoController.java`
+- Review: `sql/ccdi_credit_info_menu.sql`
+
+- [ ] **Step 1: 检查征信维护入口已有后端能力**
+
+Run:
+
+```bash
+rg -n "/ccdi/creditInfo|征信维护|ccdi:creditInfo" ccdi-info-collection/src/main/java sql/ccdi_credit_info_menu.sql
+```
+
+Expected:
+
+- PASS，能看到征信维护接口与菜单配置已存在。
+
+- [ ] **Step 2: 明确本次无需后端改造**
+
+结论需要覆盖：
+
+```text
+1. 按钮跳转发生在前端页面层
+2. 目标页面和其调用接口已经存在
+3. 本次不需要新增 controller、service、mapper、SQL
+```
+
+## Task 2: 补后端实施记录
+
+**Files:**
+- Create: `docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-backend-record.md`
+
+- [ ] **Step 1: 新增后端实施记录**
+
+记录以下内容：
+
+```markdown
+# 上传数据页征信导入入口跳转后端实施记录
+
+## 结论
+- 本次需求仅调整前端按钮入口
+- 征信维护后端接口与菜单数据已存在
+- 后端代码、SQL、数据库均无需改动
+
+## 检查范围
+- ccdi-info-collection Controller
+- 征信维护菜单 SQL
+
+## 验证
+- rg -n "/ccdi/creditInfo|征信维护|ccdi:creditInfo" ccdi-info-collection/src/main/java sql/ccdi_credit_info_menu.sql
+```
+```
+
+- [ ] **Step 2: 复核本计划执行结果**
+
+Run:
+
+```bash
+git diff -- docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-backend-record.md
+```
+
+Expected:
+
+- PASS，仅包含后端影响评估记录，无后端源码改动。
--- a/docs/plans/frontend/2026-03-24-project-upload-credit-entry-jump-frontend-implementation.md
+++ b/docs/plans/frontend/2026-03-24-project-upload-credit-entry-jump-frontend-implementation.md
@@ -0,0 +1,218 @@
+# Project Upload Credit Entry Jump 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:** 仅调整 `UploadData.vue` 中“征信导入”入口的前端交互，沿用现有动态菜单路由 `/maintain/creditInfo` 作为跳转目标。保持征信维护页面和后端接口完全不变，避免双入口并减少交互分叉。
+
+**Tech Stack:** Vue 2, Vue Router, Element UI, Node.js 源码契约测试
+
+---
+
+## 文件结构与职责
+
+**修改文件**
+
+- `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+  将“征信导入”按钮点击行为从打开弹窗改为路由跳转，并清理不再使用的本地征信上传入口逻辑。
+- `docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-frontend-record.md`
+  记录本次前端实施内容、验证命令与结果。
+
+**新增测试文件**
+
+- `ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js`
+  锁定“征信导入”按钮使用路由跳转且不再依赖本地上传弹窗入口。
+
+**参考文件**
+
+- `docs/design/2026-03-24-project-upload-credit-entry-jump-design.md`
+- `ruoyi-ui/src/views/ccdiCreditInfo/index.vue`
+- `sql/ccdi_credit_info_menu.sql`
+
+## Task 1: 先锁定入口跳转契约
+
+**Files:**
+- Create: `ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js`
+- Test: `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+
+- [ ] **Step 1: 编写失败契约测试**
+
+在 `ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js` 中读取 `UploadData.vue` 源码，至少断言以下关键点：
+
+```javascript
+const assert = require("assert");
+const fs = require("fs");
+const path = require("path");
+
+const viewPath = path.resolve(
+  __dirname,
+  "../../src/views/ccdiProject/components/detail/UploadData.vue"
+);
+const source = fs.readFileSync(viewPath, "utf8");
+
+assert(source.includes("@click=\"handleOpenCreditUpload\""), "征信导入按钮事件已变化，需先看到旧入口");
+assert(source.includes("showCreditUploadDialog"), "旧征信导入弹窗状态不存在，无法证明改动前行为");
+```
+
+- [ ] **Step 2: 运行测试确认当前为旧行为**
+
+Run:
+
+```bash
+node ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+```
+
+Expected:
+
+- PASS，证明当前按钮仍绑定旧的弹窗入口。
+
+- [ ] **Step 3: 改写测试为目标行为**
+
+将断言改为目标行为：
+
+```javascript
+[
+  "@click=\"handleGoCreditInfoPage\"",
+  "this.$router.push(\"/maintain/creditInfo\")",
+].forEach((token) => {
+  assert(source.includes(token), `缺少征信入口跳转关键代码: ${token}`);
+});
+
+[
+  "showCreditUploadDialog",
+  "handleConfirmCreditUpload",
+  "handleCreditFileChange",
+].forEach((token) => {
+  assert(!source.includes(token), `旧征信弹窗逻辑未清理: ${token}`);
+});
+```
+
+- [ ] **Step 4: 运行测试确认失败**
+
+Run:
+
+```bash
+node ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+```
+
+Expected:
+
+- FAIL，因为代码尚未切换到跳页实现。
+
+## Task 2: 实现按钮跳转并清理旧入口
+
+**Files:**
+- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+- Test: `ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js`
+
+- [ ] **Step 1: 修改模板点击事件**
+
+把“征信导入”按钮点击事件：
+
+```vue
+@click="handleOpenCreditUpload"
+```
+
+改为：
+
+```vue
+@click="handleGoCreditInfoPage"
+```
+
+- [ ] **Step 2: 删除本地征信导入弹窗模板**
+
+移除 `title="征信导入"` 的 `el-dialog` 以及其中的 `el-upload`、底部按钮，确保该按钮点击后不再出现本地弹窗。
+
+- [ ] **Step 3: 删除无用状态与方法并新增跳转方法**
+
+删除以下无用状态与方法：
+
+```javascript
+showCreditUploadDialog: false,
+creditFileList: [],
+creditUploading: false,
+```
+
+```javascript
+handleOpenCreditUpload() {}
+handleCreditFileChange() {}
+handleConfirmCreditUpload() {}
+pollCreditImportStatus() {}
+```
+
+新增最小跳转实现：
+
+```javascript
+handleGoCreditInfoPage() {
+  if (this.isProjectTagging) {
+    return;
+  }
+  this.$router.push("/maintain/creditInfo");
+}
+```
+
+- [ ] **Step 4: 处理无用 import**
+
+若 `uploadFile`、`getImportStatus` 仅服务于旧征信弹窗逻辑，则从 `UploadData.vue` 顶部 import 中删除，避免残留死代码。
+
+- [ ] **Step 5: 运行契约测试确认通过**
+
+Run:
+
+```bash
+node ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+```
+
+Expected:
+
+- PASS
+
+- [ ] **Step 6: 手工检视跳转链路**
+
+至少检查：
+
+```bash
+rg -n "handleGoCreditInfoPage|/maintain/creditInfo|征信导入" ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue
+```
+
+Expected:
+
+- PASS，按钮事件与路由目标清晰可见，不再出现旧弹窗控制逻辑。
+
+## Task 3: 补前端实施记录
+
+**Files:**
+- Create: `docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-frontend-record.md`
+
+- [ ] **Step 1: 新增实施记录文档**
+
+记录以下内容：
+
+```markdown
+# 上传数据页征信导入入口跳转前端实施记录
+
+## 本次改动
+- 将项目详情上传数据页“征信导入”按钮改为直接跳转征信维护页面
+- 删除当前页征信导入弹窗入口逻辑
+
+## 影响文件
+- ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue
+- ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+
+## 验证
+- node ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+```
+```
+
+- [ ] **Step 2: 复核暂存区仅包含本次前端相关文件**
+
+Run:
+
+```bash
+git status --short
+```
+
+Expected:
+
+- 仅暂存本次前端计划执行产生的相关文件；若有无关文件已暂存，先移出暂存区。
--- a/docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-backend-record.md
+++ b/docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-backend-record.md
@@ -0,0 +1,17 @@
+# 上传数据页征信导入入口跳转后端实施记录
+
+## 结论
+- 本次需求仅调整前端按钮入口
+- 征信维护后端接口与菜单数据已存在
+- 后端代码、SQL、数据库均无需改动
+
+## 检查范围
+- `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/controller/CcdiCreditInfoController.java`
+- `sql/ccdi_credit_info_menu.sql`
+
+## 验证
+- `rg -n "/ccdi/creditInfo|征信维护|ccdi:creditInfo" ccdi-info-collection/src/main/java sql/ccdi_credit_info_menu.sql -S`
+
+## 验证结果
+- 已确认征信维护 Controller、权限点与菜单配置均存在
+- 本次无需新增或修改 controller、service、mapper、SQL
--- a/docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-frontend-record.md
+++ b/docs/reports/implementation/2026-03-24-project-upload-credit-entry-jump-frontend-record.md
@@ -0,0 +1,18 @@
+# 上传数据页征信导入入口跳转前端实施记录
+
+## 本次改动
+- 将项目详情上传数据页“征信导入”按钮改为直接跳转征信维护页面
+- 删除当前页征信导入弹窗入口逻辑
+- 新增源码契约测试，锁定入口跳转和旧逻辑清理结果
+
+## 影响文件
+- `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+- `ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js`
+
+## 验证
+- `node ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js`
+- `rg -n "handleGoCreditInfoPage|/maintain/creditInfo|showCreditUploadDialog|handleConfirmCreditUpload|handleCreditFileChange" ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue -S`
+
+## 验证结果
+- 契约测试通过，确认按钮改为跳转到 `/maintain/creditInfo`
+- 源码检索确认旧征信导入弹窗状态与方法已清理
--- a/ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue
+++ b/ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue
@@ -27,7 +27,7 @@
            size="small"
            icon="el-icon-upload2"
            :disabled="isProjectTagging"
-            @click="handleOpenCreditUpload"
+            @click="handleGoCreditInfoPage"
          >
            征信导入
          </el-button>
@@ -167,41 +167,6 @@
      </div> -->
    </div>

-    <el-dialog
-      v-if="showCreditUploadDialog"
-      title="征信导入"
-      :visible.sync="showCreditUploadDialog"
-      :close-on-click-modal="false"
-      width="500px"
-    >
-      <el-upload
-        class="upload-area"
-        drag
-        action="#"
-        :disabled="isProjectTagging"
-        :auto-upload="false"
-        :on-change="handleCreditFileChange"
-        :file-list="creditFileList"
-      >
-        <i class="el-icon-upload"></i>
-        <div class="el-upload__text">将文件拖到此处，或<em>点击上传</em></div>
-        <div class="el-upload__tip" slot="tip">
-          支持 HTML 格式文件
-        </div>
-      </el-upload>
-      <span slot="footer">
-        <el-button @click="showCreditUploadDialog = false">取消</el-button>
-        <el-button
-          type="primary"
-          :disabled="isProjectTagging"
-          :loading="creditUploading"
-          @click="handleConfirmCreditUpload"
-        >
-          确定
-        </el-button>
-      </span>
-    </el-dialog>
-
    <el-dialog
      title="拉取本行信息"
      :visible.sync="pullBankInfoDialogVisible"
@@ -354,11 +319,9 @@

 <script>
 import {
-  getImportStatus,
  getUploadStatus,
  pullBankInfo,
  parseIdCardFile,
-  uploadFile,
  batchUploadFiles,
  getFileUploadList,
  getFileUploadStatistics,
@@ -397,9 +360,6 @@ export default {
      currentMenuTitle: "上传数据",
      // 圆环周长
      circumference: 2 * Math.PI * 14,
-      showCreditUploadDialog: false,
-      creditFileList: [],
-      creditUploading: false,
      pullBankInfoDialogVisible: false,
      pullBankInfoLoading: false,
      parsingIdCardFile: false,
@@ -619,12 +579,11 @@ export default {
      }
      this.$emit("menu-change", { key: "overview", route: "overview" });
    },
-    handleOpenCreditUpload() {
+    handleGoCreditInfoPage() {
      if (this.isProjectTagging) {
        return;
      }
-      this.creditFileList = [];
-      this.showCreditUploadDialog = true;
+      this.$router.push("/maintain/creditInfo");
    },
    /** 上传卡片点击 */
    handleUploadClick(key) {
@@ -636,90 +595,6 @@ export default {
        this.selectedFiles = [];
      }
    },
-    handleCreditFileChange(file, fileList) {
-      this.creditFileList = fileList.slice(-1);
-    },
-    async handleConfirmCreditUpload() {
-      if (this.isProjectTagging) {
-        this.$message.warning("项目正在进行银行流水打标，暂不可上传或拉取数据");
-        return;
-      }
-      if (this.creditFileList.length === 0) {
-        this.$message.warning("请选择要上传的文件");
-        return;
-      }
-
-      this.creditUploading = true;
-
-      try {
-        const res = await uploadFile(
-          this.projectId,
-          "CREDIT",
-          this.creditFileList[0].raw
-        );
-
-        this.showCreditUploadDialog = false;
-        this.$message.success("征信文件上传成功，正在处理中...");
-        this.$emit("data-uploaded", { type: "credit" });
-
-        await this.loadUploadStatus();
-        this.pollCreditImportStatus(res && res.data);
-      } catch (error) {
-        this.$message.error("征信上传失败：" + (error.msg || "未知错误"));
-      } finally {
-        this.creditUploading = false;
-        this.creditFileList = [];
-      }
-    },
-    async pollCreditImportStatus(taskId) {
-      if (!taskId) {
-        return;
-      }
-
-      const maxAttempts = 20;
-      let attempts = 0;
-
-      const poll = async () => {
-        if (attempts >= maxAttempts) {
-          this.$message.warning("征信导入处理超时，请稍后查看");
-          return;
-        }
-
-        try {
-          const res = await getImportStatus(taskId);
-          const status = res.data;
-
-          if (!status) {
-            attempts += 1;
-            setTimeout(poll, 30000);
-            return;
-          }
-
-          if (status.uploadStatus === "SUCCESS") {
-            await this.loadUploadStatus();
-            this.$message.success("征信导入处理完成");
-            return;
-          }
-
-          if (status.uploadStatus === "FAILED") {
-            await this.loadUploadStatus();
-            this.$message.error(
-              "征信导入处理失败：" + (status.errorMessage || "未知错误")
-            );
-            return;
-          }
-
-          attempts += 1;
-          setTimeout(poll, 30000);
-        } catch (error) {
-          console.error("轮询征信导入状态失败:", error);
-          attempts += 1;
-          setTimeout(poll, 30000);
-        }
-      };
-
-      poll();
-    },
    async loadUploadStatus() {
      try {
        const res = await getUploadStatus(this.projectId);
--- a/ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
+++ b/ruoyi-ui/tests/unit/project-upload-credit-entry-jump.test.js
@@ -0,0 +1,26 @@
+const assert = require("assert");
+const fs = require("fs");
+const path = require("path");
+
+const viewPath = path.resolve(
+  __dirname,
+  "../../src/views/ccdiProject/components/detail/UploadData.vue"
+);
+const source = fs.readFileSync(viewPath, "utf8");
+
+[
+  '@click="handleGoCreditInfoPage"',
+  'this.$router.push("/maintain/creditInfo")',
+].forEach((token) => {
+  assert(source.includes(token), `缺少征信入口跳转关键代码: ${token}`);
+});
+
+[
+  "showCreditUploadDialog",
+  "handleConfirmCreditUpload",
+  "handleCreditFileChange",
+].forEach((token) => {
+  assert(!source.includes(token), `旧征信弹窗逻辑未清理: ${token}`);
+});
+
+console.log("征信入口跳转契约检查通过");