新增历史项目导入实施计划

2026-03-29 09:40:44 +08:00
parent 26f77bf458
commit c1d56cc153
3 changed files with 812 additions and 0 deletions
--- a/docs/plans/backend/2026-03-29-project-import-history-backend-implementation.md
+++ b/docs/plans/backend/2026-03-29-project-import-history-backend-implementation.md
@@ -0,0 +1,437 @@
+# Project Import History 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:** 后端采用最短路径实现，在现有 `CcdiProjectController -> ICcdiProjectService -> CcdiProjectServiceImpl` 创建项目主链路外新增“历史导入”专用接口与异步编排服务。流水复制不复用文件上传接口语义，而是直接在项目维度重建批次号、批量写入 `ccdi_bank_statement` 和 `ccdi_file_upload_record`，完成后复用 `bankTagService.submitAutoRebuild(...)` 与现有详情页状态轮询。
+
+**Tech Stack:** Java 21, Spring Boot 3, MyBatis Plus, MyBatis XML, MySQL 8, JUnit 5, Mockito, Maven
+
+## 后端验收清单
+
+- `GET /ccdi/project/history` 仅返回已完成、已归档项目，支持项目名搜索
+- `POST /ccdi/project/import` 能先创建新项目，再异步提交历史导入任务
+- 历史导入按 `trxDate` 过滤流水，并按现有唯一性口径去重
+- 新项目中的历史导入文件记录带来源标识，且不允许删除
+- 历史导入完成后自动触发打标、结果表刷新和统计刷新
+
+---
+
+### Task 1: 先用 SQL/Mapper 测试锁定历史导入所需数据结构
+
+**Files:**
+- Create: `sql/migration/2026-03-29-add-file-upload-history-import-source-fields.sql`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java`
+- Modify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapperXmlTest.java`
+
+- [ ] **Step 1: Write the failing mapper/XML assertions**
+
+在 `CcdiBankStatementMapperXmlTest.java` 或新增紧邻的 XML 测试中，先锁定以下点：
+
+```java
+assertTrue(xml.contains("source_type"));
+assertTrue(xml.contains("source_project_id"));
+assertTrue(xml.contains("source_project_name"));
+assertTrue(xml.contains("fur.source_project_name"));
+```
+
+同时确认 `CcdiFileUploadRecord` 实体新增字段后有对应 getter/setter。
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiBankStatementMapperXmlTest test
+```
+
+Expected:
+
+- `FAIL`
+- 原因是当前文件记录表和 Mapper 还没有历史导入来源字段
+
+- [ ] **Step 3: Add the minimal schema and mapper support**
+
+在 SQL 脚本中新增：
+
+```sql
+ALTER TABLE ccdi_file_upload_record
+  ADD COLUMN source_type varchar(32) DEFAULT 'UPLOAD' COMMENT '来源类型',
+  ADD COLUMN source_project_id bigint NULL COMMENT '来源项目ID',
+  ADD COLUMN source_project_name varchar(100) NULL COMMENT '来源项目名称';
+```
+
+在 `CcdiFileUploadRecord.java` 增加：
+
+```java
+private String sourceType;
+private Long sourceProjectId;
+private String sourceProjectName;
+```
+
+在 `CcdiFileUploadRecordMapper.xml` 的 `resultMap`、`select`、`insertBatch` 中补齐字段映射。
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiBankStatementMapperXmlTest test
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add sql/migration/2026-03-29-add-file-upload-history-import-source-fields.sql ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/entity/CcdiFileUploadRecord.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapperXmlTest.java
+git commit -m "补充历史导入文件记录字段"
+```
+
+### Task 2: 锁定项目历史列表接口与导入接口契约
+
+**Files:**
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiProjectImportHistoryDTO.java`
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiProjectHistoryListItemVO.java`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiProjectService.java`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiProjectController.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectControllerContractTest.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectControllerTest.java`
+
+- [ ] **Step 1: Write the failing controller contract test**
+
+在 `CcdiProjectControllerContractTest.java` 中新增断言：
+
+```java
+Method history = CcdiProjectController.class.getMethod("listHistoryProjects", CcdiProjectQueryDTO.class);
+assertEquals("/history", history.getAnnotation(GetMapping.class).value()[0]);
+
+Method importing = CcdiProjectController.class.getMethod("importFromHistory", CcdiProjectImportHistoryDTO.class);
+assertEquals("/import", importing.getAnnotation(PostMapping.class).value()[0]);
+```
+
+并在控制器测试中锁定返回结构至少包含“项目创建成功后返回新项目数据”。
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectControllerContractTest,CcdiProjectControllerTest test
+```
+
+Expected:
+
+- `FAIL`
+- 原因是当前控制器没有历史项目列表和导入提交两个真实接口
+
+- [ ] **Step 3: Add DTO/VO and minimal controller signatures**
+
+在 DTO 中定义：
+
+```java
+private String projectName;
+private String description;
+private List<Long> sourceProjectIds;
+private String startDate;
+private String endDate;
+```
+
+在 `ICcdiProjectService.java` 中补充：
+
+```java
+List<CcdiProjectHistoryListItemVO> listHistoryProjects(CcdiProjectQueryDTO queryDTO);
+CcdiProjectVO importFromHistory(CcdiProjectImportHistoryDTO dto, String operator);
+```
+
+在 `CcdiProjectController.java` 中增加：
+
+```java
+@GetMapping("/history")
+public AjaxResult listHistoryProjects(CcdiProjectQueryDTO queryDTO) { ... }
+
+@PostMapping("/import")
+public AjaxResult importFromHistory(@Validated @RequestBody CcdiProjectImportHistoryDTO dto) { ... }
+```
+
+- [ ] **Step 4: Run tests to verify the contract passes**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectControllerContractTest,CcdiProjectControllerTest test
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiProjectImportHistoryDTO.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiProjectHistoryListItemVO.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiProjectService.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiProjectController.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectControllerContractTest.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectControllerTest.java
+git commit -m "补充历史项目导入接口契约"
+```
+
+### Task 3: 实现历史项目列表查询与项目创建后任务提交流程
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiProjectMapper.java`
+- Modify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectMapper.xml`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImpl.java`
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiProjectHistoryImportService.java`
+- Create: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImplTest.java`
+
+- [ ] **Step 1: Write the failing service tests**
+
+在 `CcdiProjectServiceImplTest.java` 中新增至少两个场景：
+
+```java
+@Test
+void shouldOnlyReturnCompletedAndArchivedHistoryProjects() { ... }
+
+@Test
+void shouldCreateProjectThenSubmitHistoryImportAfterCommit() { ... }
+```
+
+第二个测试至少锁定：
+
+- 先调用 `createProject` 生成本地项目
+- 仅在事务提交后委托 `historyImportService.submitImport(...)`
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectServiceImplTest test
+```
+
+Expected:
+
+- `FAIL`
+
+- [ ] **Step 3: Implement the minimal query and submit flow**
+
+在 `CcdiProjectMapper.xml` 中新增历史项目查询 SQL，条件固定：
+
+```sql
+where p.status in ('1', '2')
+```
+
+并支持项目名模糊搜索。
+
+在 `CcdiProjectServiceImpl.java` 中实现：
+
+```java
+public List<CcdiProjectHistoryListItemVO> listHistoryProjects(CcdiProjectQueryDTO queryDTO) { ... }
+
+public CcdiProjectVO importFromHistory(CcdiProjectImportHistoryDTO dto, String operator) {
+    CcdiProjectSaveDTO saveDTO = new CcdiProjectSaveDTO();
+    saveDTO.setProjectName(dto.getProjectName());
+    saveDTO.setDescription(dto.getDescription());
+    saveDTO.setConfigType("default");
+    CcdiProjectVO project = createProject(saveDTO);
+    TransactionSynchronizationManager.registerSynchronization(... historyImportService.submitImport(...));
+    return project;
+}
+```
+
+约束：
+
+- 不新增导入专用项目状态
+- 不在接口内同步执行大批量复制
+- 只在事务提交后启动异步导入
+
+- [ ] **Step 4: Run tests to verify it passes**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectServiceImplTest,CcdiProjectControllerTest test
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiProjectMapper.java ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectMapper.xml ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImpl.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiProjectHistoryImportService.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImplTest.java
+git commit -m "实现历史项目导入任务提交流程"
+```
+
+### Task 4: 实现流水复制、批次号重映射与来源文件记录生成
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapper.java`
+- Modify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java`
+- Modify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImplTest.java`
+- Create: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImplTest.java`
+
+- [ ] **Step 1: Write the failing history import service tests**
+
+新增 `CcdiProjectHistoryImportServiceImplTest.java`，锁定以下行为：
+
+```java
+@Test
+void shouldFilterStatementsByTrxDateAndDeduplicateAcrossSourceProjects() { ... }
+
+@Test
+void shouldGenerateNewBatchIdsAndHistoryImportFileRecordsOnlyForSuccessfulSourceBatches() { ... }
+```
+
+断言重点：
+
+- 仅复制命中时间范围的流水
+- 新项目 `batchId/logId` 不等于来源批次号
+- 文件记录 `sourceType = HISTORY_IMPORT`
+- 文件记录携带 `sourceProjectId/sourceProjectName`
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectHistoryImportServiceImplTest,CcdiFileUploadServiceImplTest test
+```
+
+Expected:
+
+- `FAIL`
+
+- [ ] **Step 3: Implement the minimal copy pipeline**
+
+在 Mapper 中新增只读查询：
+
+- 查询来源项目成功文件记录
+- 按来源批次和日期区间查询流水
+
+在 `CcdiProjectHistoryImportServiceImpl.java` 中实现：
+
+```java
+Map<Integer, Integer> newBatchIdMapping = new HashMap<>();
+for (SourceBatch batch : matchedBatches) {
+    int newBatchId = nextBatchId();
+    newBatchIdMapping.put(batch.getSourceLogId(), newBatchId);
+}
+```
+
+并在复制流水时写入：
+
+```java
+statement.setProjectId(targetProjectId);
+statement.setGroupId(targetLsfxProjectId);
+statement.setBatchId(newBatchId);
+```
+
+在生成文件记录时写入：
+
+```java
+record.setSourceType("HISTORY_IMPORT");
+record.setSourceProjectId(sourceProjectId);
+record.setSourceProjectName(sourceProjectName);
+record.setFileStatus("parsed_success");
+```
+
+- [ ] **Step 4: Run tests to verify it passes**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectHistoryImportServiceImplTest,CcdiFileUploadServiceImplTest,CcdiBankStatementMapperXmlTest test
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiBankStatementMapper.java ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFileUploadRecordMapper.java ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFileUploadRecordMapper.xml ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImplTest.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImplTest.java
+git commit -m "实现历史项目流水复制后端逻辑"
+```
+
+### Task 5: 接入自动打标、删除拦截与回归验证
+
+**Files:**
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java`
+- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImplTest.java`
+- Modify: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImplTest.java`
+- Modify: `docs/reports/implementation/2026-03-29-project-import-history-plan-record.md`
+
+- [ ] **Step 1: Write the failing tests for auto rebuild and delete guard**
+
+在 `CcdiProjectHistoryImportServiceImplTest.java` 中新增：
+
+```java
+verify(bankTagService).submitAutoRebuild(targetProjectId, TriggerType.AUTO_BATCH_UPLOAD);
+```
+
+在 `CcdiFileUploadServiceImplTest.java` 中新增：
+
+```java
+assertThrows(ServiceException.class, () -> service.deleteFileUploadRecord(historyRecordId, 1L));
+```
+
+并锁定错误信息包含“历史导入文件不支持删除”。
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectHistoryImportServiceImplTest,CcdiFileUploadServiceImplTest test
+```
+
+Expected:
+
+- `FAIL`
+
+- [ ] **Step 3: Implement the minimal rebuild and delete guard**
+
+在历史导入服务复制完成后补充：
+
+```java
+refreshProjectTargetCount(targetProjectId);
+bankTagService.submitAutoRebuild(targetProjectId, TriggerType.AUTO_BATCH_UPLOAD);
+```
+
+在 `deleteFileUploadRecord(...)` 中补充：
+
+```java
+if ("HISTORY_IMPORT".equals(record.getSourceType())) {
+    throw new ServiceException("历史导入文件不支持删除");
+}
+```
+
+- [ ] **Step 4: Run the backend regression suite**
+
+Run:
+
+```bash
+mvn -pl ccdi-project -Dtest=CcdiProjectControllerTest,CcdiProjectControllerContractTest,CcdiProjectServiceImplTest,CcdiProjectHistoryImportServiceImplTest,CcdiFileUploadServiceImplTest,CcdiBankStatementMapperXmlTest test
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImpl.java ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImpl.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectHistoryImportServiceImplTest.java ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiFileUploadServiceImplTest.java docs/reports/implementation/2026-03-29-project-import-history-plan-record.md
+git commit -m "接通历史项目导入后端闭环"
+```
--- a/docs/plans/frontend/2026-03-29-project-import-history-frontend-implementation.md
+++ b/docs/plans/frontend/2026-03-29-project-import-history-frontend-implementation.md
@@ -0,0 +1,356 @@
+# Project Import History 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:** 前端在现有 `ccdiProject` 列表与详情页结构上最小化改造，重点落在 `ImportHistoryDialog.vue`、`index.vue`、`ccdiProject.js`、`UploadData.vue` 和 `uploadFileActionRules.js`。弹窗负责表单校验、历史项目查询、多选和真实提交；列表页负责成功后跳转；详情页上传记录区域负责展示历史导入来源并收敛删除操作。
+
+**Tech Stack:** Vue 2, Element UI, Axios request wrapper, Node, npm
+
+## 前端验收清单
+
+- 导入历史项目弹窗采用“新项目配置在上、历史项目列表在下”的纵向布局
+- 历史项目支持多选，且只展示后端返回的真实历史项目数据
+- 提交成功后关闭弹窗、提示任务已开始并跳转到新项目详情页
+- 上传记录列表能展示“历史导入 · 来源项目名”
+- 历史导入文件记录不显示删除入口
+
+---
+
+### Task 1: 先锁定 API 层与列表页提交后的跳转契约
+
+**Files:**
+- Modify: `ruoyi-ui/src/api/ccdiProject.js`
+- Modify: `ruoyi-ui/src/views/ccdiProject/index.vue`
+- Modify: `ruoyi-ui/tests/unit/project-list-reanalyze-api.test.js`
+- Create: `ruoyi-ui/tests/unit/project-import-history-submit-flow.test.js`
+
+- [ ] **Step 1: Write the failing source-based test**
+
+新增 `project-import-history-submit-flow.test.js`，至少锁定以下代码痕迹：
+
+```javascript
+assert(apiSource.includes("url: '/ccdi/project/history'"));
+assert(apiSource.includes("url: '/ccdi/project/import'"));
+assert(indexSource.includes("this.$router.push({"));
+assert(indexSource.includes("path: `/ccdiProject/detail/${project.projectId}`") || indexSource.includes("path: `/ccdiProject/detail/${data.projectId}`"));
+```
+
+并锁定成功提示文案包含“历史项目导入任务已开始”。
+
+- [ ] **Step 2: Run test to verify it fails**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-submit-flow.test.js
+```
+
+Expected:
+
+- `FAIL`
+- 原因是当前列表页提交导入后只本地提示成功，没有跳转详情页
+
+- [ ] **Step 3: Implement the minimal API and jump logic**
+
+在 `ruoyi-ui/src/api/ccdiProject.js` 保留并改用真实接口：
+
+```javascript
+export function listHistoryProjects(query) { ... }
+export function importFromHistory(data) { ... }
+```
+
+在 `index.vue` 中将 `handleSubmitImport(data)` 收敛为：
+
+```javascript
+handleSubmitImport(project) {
+  this.$modal.msgSuccess("历史项目导入任务已开始");
+  this.importDialogVisible = false;
+  this.getList();
+  this.$router.push({ path: `/ccdiProject/detail/${project.projectId}` });
+}
+```
+
+- [ ] **Step 4: Run test to verify it passes**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-submit-flow.test.js
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ruoyi-ui/src/api/ccdiProject.js ruoyi-ui/src/views/ccdiProject/index.vue ruoyi-ui/tests/unit/project-import-history-submit-flow.test.js
+git commit -m "接通历史项目导入前端提交链路"
+```
+
+### Task 2: 重写导入弹窗为真实纵向表单与多选列表
+
+**Files:**
+- Modify: `ruoyi-ui/src/views/ccdiProject/components/ImportHistoryDialog.vue`
+- Create: `ruoyi-ui/tests/unit/project-import-history-dialog-layout.test.js`
+- Create: `ruoyi-ui/tests/unit/project-import-history-dialog-behavior.test.js`
+
+- [ ] **Step 1: Write the failing layout/behavior tests**
+
+在布局测试中锁定：
+
+```javascript
+assert(source.includes('label="新项目名称"'));
+assert(source.includes('label="备注"'));
+assert(source.includes("type=\"daterange\""));
+assert(source.includes("data-multiselect") === false); // Vue 模板里应改成 checkbox/multiple 语义，而不是单选 radio
+assert(source.includes("selectedProjectIds"));
+```
+
+在行为测试中锁定：
+
+```javascript
+assert(source.includes("listHistoryProjects("));
+assert(source.includes("importFromHistory("));
+assert(source.includes("this.$emit('submit', response.data)"));
+```
+
+- [ ] **Step 2: Run tests to verify they fail**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-dialog-layout.test.js
+node tests/unit/project-import-history-dialog-behavior.test.js
+```
+
+Expected:
+
+- `FAIL`
+- 原因是当前弹窗还是单选、Mock 数据、上下字段不对
+
+- [ ] **Step 3: Implement the minimal vertical dialog**
+
+在 `ImportHistoryDialog.vue` 中完成以下最小改造：
+
+- 新项目配置区放上方：
+  - `newProjectName`
+  - `description`
+  - `dateRange`
+- 历史项目列表区放下方：
+  - 搜索框
+  - 多选项目列表，状态只读展示
+  - 固定高度滚动
+- 数据改为：
+
+```javascript
+selectedProjectIds: [],
+configForm: {
+  newProjectName: "",
+  description: "",
+  dateRange: []
+}
+```
+
+提交时组装：
+
+```javascript
+const payload = {
+  projectName: this.configForm.newProjectName,
+  description: this.configForm.description,
+  sourceProjectIds: this.selectedProjectIds,
+  startDate: this.configForm.dateRange[0] || "",
+  endDate: this.configForm.dateRange[1] || ""
+};
+```
+
+- [ ] **Step 4: Run tests to verify they pass**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-dialog-layout.test.js
+node tests/unit/project-import-history-dialog-behavior.test.js
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ruoyi-ui/src/views/ccdiProject/components/ImportHistoryDialog.vue ruoyi-ui/tests/unit/project-import-history-dialog-layout.test.js ruoyi-ui/tests/unit/project-import-history-dialog-behavior.test.js
+git commit -m "重构历史项目导入弹窗"
+```
+
+### Task 3: 接入上传记录来源展示与历史导入只读操作
+
+**Files:**
+- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue`
+- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/uploadFileActionRules.js`
+- Modify: `ruoyi-ui/tests/unit/upload-data-file-list-table.test.js`
+- Modify: `ruoyi-ui/tests/unit/upload-data-delete-retag-copy.test.js`
+- Create: `ruoyi-ui/tests/unit/upload-data-history-import-readonly.test.js`
+
+- [ ] **Step 1: Write the failing file-list tests**
+
+新增或补充断言：
+
+```javascript
+assert(uploadSource.includes("sourceProjectName"));
+assert(uploadSource.includes("历史导入"));
+assert(actionRuleSource.includes("HISTORY_IMPORT"));
+assert(!deleteBehaviorAllowsHistoryImport);
+```
+
+其中 `upload-data-history-import-readonly.test.js` 至少锁定：
+
+```javascript
+assert(/if\s*\(row\.sourceType\s*===\s*["']HISTORY_IMPORT["']\)\s*\{\s*return null/.test(actionRuleSource));
+```
+
+- [ ] **Step 2: Run tests to verify they fail**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/upload-data-file-list-table.test.js
+node tests/unit/upload-data-delete-retag-copy.test.js
+node tests/unit/upload-data-history-import-readonly.test.js
+```
+
+Expected:
+
+- `FAIL`
+
+- [ ] **Step 3: Implement the minimal readonly display**
+
+在 `UploadData.vue` 的表格中增加来源展示，例如：
+
+```vue
+<el-table-column prop="sourceProjectName" label="来源" min-width="180">
+  <template slot-scope="scope">
+    <span v-if="scope.row.sourceType === 'HISTORY_IMPORT'">
+      历史导入 · {{ scope.row.sourceProjectName || '-' }}
+    </span>
+    <span v-else>-</span>
+  </template>
+</el-table-column>
+```
+
+在 `uploadFileActionRules.js` 中收敛删除规则：
+
+```javascript
+if (row.sourceType === 'HISTORY_IMPORT') {
+  return null
+}
+```
+
+- [ ] **Step 4: Run tests to verify they pass**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/upload-data-file-list-table.test.js
+node tests/unit/upload-data-delete-retag-copy.test.js
+node tests/unit/upload-data-history-import-readonly.test.js
+```
+
+Expected:
+
+- `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ruoyi-ui/src/views/ccdiProject/components/detail/UploadData.vue ruoyi-ui/src/views/ccdiProject/components/detail/uploadFileActionRules.js ruoyi-ui/tests/unit/upload-data-file-list-table.test.js ruoyi-ui/tests/unit/upload-data-delete-retag-copy.test.js ruoyi-ui/tests/unit/upload-data-history-import-readonly.test.js
+git commit -m "收敛历史导入文件前端只读展示"
+```
+
+### Task 4: 收口弹窗校验、详情页衔接与回归验证
+
+**Files:**
+- Modify: `ruoyi-ui/src/views/ccdiProject/components/ImportHistoryDialog.vue`
+- Modify: `ruoyi-ui/src/views/ccdiProject/detail.vue`
+- Modify: `ruoyi-ui/tests/unit/project-detail-tagging-polling.test.js`
+- Modify: `docs/reports/implementation/2026-03-29-project-import-history-plan-record.md`
+
+- [ ] **Step 1: Write the failing validation/regression assertions**
+
+在弹窗行为测试里补充：
+
+```javascript
+assert(source.includes("请选择历史项目"));
+assert(source.includes("请输入新项目名称"));
+```
+
+在 `project-detail-tagging-polling.test.js` 中锁定：
+
+```javascript
+assert(detailSource.includes("this.$route.params.projectId"));
+assert(detailSource.includes("projectStatusPolling"));
+```
+
+目的是保证本次跳转详情页不会破坏现有轮询结构。
+
+- [ ] **Step 2: Run tests to verify they fail or cover the gap**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-dialog-behavior.test.js
+node tests/unit/project-detail-tagging-polling.test.js
+```
+
+Expected:
+
+- 历史导入弹窗测试先 `FAIL`
+- 轮询测试保持 `PASS` 或在改动后回归通过
+
+- [ ] **Step 3: Implement the minimal validation and handoff polish**
+
+在 `ImportHistoryDialog.vue` 中补充：
+
+- 新项目名称必填
+- 至少选择一个历史项目
+- 提交态 loading
+- 成功后 reset 表单
+
+在 `detail.vue` 中不新增新逻辑，只确保项目详情页跳转入口沿用现有 `projectId` 路由参数与状态轮询。
+
+- [ ] **Step 4: Run the frontend regression set**
+
+Run:
+
+```bash
+cd ruoyi-ui
+node tests/unit/project-import-history-submit-flow.test.js
+node tests/unit/project-import-history-dialog-layout.test.js
+node tests/unit/project-import-history-dialog-behavior.test.js
+node tests/unit/upload-data-file-list-table.test.js
+node tests/unit/upload-data-delete-retag-copy.test.js
+node tests/unit/upload-data-history-import-readonly.test.js
+node tests/unit/project-detail-tagging-polling.test.js
+```
+
+Expected:
+
+- 全部 `PASS`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add ruoyi-ui/src/views/ccdiProject/components/ImportHistoryDialog.vue ruoyi-ui/src/views/ccdiProject/detail.vue ruoyi-ui/tests/unit/project-import-history-submit-flow.test.js ruoyi-ui/tests/unit/project-import-history-dialog-layout.test.js ruoyi-ui/tests/unit/project-import-history-dialog-behavior.test.js ruoyi-ui/tests/unit/upload-data-history-import-readonly.test.js docs/reports/implementation/2026-03-29-project-import-history-plan-record.md
+git commit -m "完成历史项目导入前端闭环"
+```
--- a/docs/reports/implementation/2026-03-29-project-import-history-plan-record.md
+++ b/docs/reports/implementation/2026-03-29-project-import-history-plan-record.md
@@ -0,0 +1,19 @@
+# 历史项目导入新项目实施计划记录
+
+## 本次改动
+
+- 新增后端实施计划 `docs/plans/backend/2026-03-29-project-import-history-backend-implementation.md`
+- 新增前端实施计划 `docs/plans/frontend/2026-03-29-project-import-history-frontend-implementation.md`
+- 后端计划拆分为表结构与 Mapper、接口契约、任务提交流程、流水复制、删除拦截与回归验证五个任务
+- 前端计划拆分为 API 与跳转、弹窗重构、上传记录只读展示、校验与回归验证四个任务
+
+## 计划结论
+
+- 后端按“同步创建项目 + 异步历史导入任务”主线推进
+- 前端按“弹窗真实提交 + 详情页承接状态 + 历史导入记录只读展示”主线推进
+- 执行阶段优先遵循最短路径实现，不引入额外任务中心或兼容性分支
+
+## 审阅说明
+
+- 按仓库约束，本次未启用 subagent
+- 已人工检查计划与设计文档的一致性，确认未引入未被批准的新方案