补充项目列表重新分析实施计划
This commit is contained in:
@@ -0,0 +1,151 @@
|
||||
# Project List Reanalyze 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:** 后端实现保持不改代码的最短路径，继续复用 `CcdiBankTagController -> ProjectBankTagRebuildCoordinator -> CcdiBankTagServiceImpl -> CcdiProjectOverviewServiceImpl` 这条现有链路。实施工作集中在边界核验、接口契约回归、关键测试运行和实施记录沉淀，确保前端接入后不会因为后端口径不清而额外返工。
|
||||
|
||||
**Tech Stack:** Java 21, Spring Boot 3, JUnit 5, Mockito, Maven
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 核验现有后端链路已覆盖需求
|
||||
|
||||
**Files:**
|
||||
- Modify: `docs/plans/backend/2026-03-24-project-list-reanalyze-backend-implementation.md`
|
||||
- Reference: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiBankTagController.java`
|
||||
- Reference: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/ProjectBankTagRebuildCoordinator.java`
|
||||
- Reference: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiBankTagServiceImpl.java`
|
||||
- Reference: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImpl.java`
|
||||
|
||||
- [ ] **Step 1: Write the acceptance checklist**
|
||||
|
||||
先在计划中明确本次后端必须被验证的四个事实：
|
||||
|
||||
- `POST /ccdi/project/tags/rebuild` 支持只传 `projectId`
|
||||
- 手动提交后项目状态会切换为 `3-打标中`
|
||||
- 打标成功后会调用 `refreshOverviewEmployeeResults(projectId, operator)`
|
||||
- `refreshOverviewEmployeeResults(...)` 会同步刷新高/中/低风险人数
|
||||
|
||||
- [ ] **Step 2: Run repository grep to verify the call chain**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
rg -n "refreshOverviewEmployeeResults|submitManual|/rebuild|updateProjectStatus\\(projectId, CcdiProjectStatusConstants.TAGGING" ccdi-project/src/main/java -S
|
||||
```
|
||||
|
||||
Expected:
|
||||
|
||||
- 能同时看到控制器入口、协调器提交流程、`TAGGING` 状态切换和人数重算调用
|
||||
|
||||
- [ ] **Step 3: Keep implementation minimal**
|
||||
|
||||
如果上述四个事实都成立，则明确记录：
|
||||
|
||||
- 本次后端不新增接口
|
||||
- 本次后端不新增服务分支
|
||||
- 本次后端不新增人数重算调用
|
||||
|
||||
- [ ] **Step 4: Commit**
|
||||
|
||||
```bash
|
||||
git add docs/plans/backend/2026-03-24-project-list-reanalyze-backend-implementation.md
|
||||
git commit -m "补充项目列表重新分析后端实施计划"
|
||||
```
|
||||
|
||||
### Task 2: 运行关键后端测试锁定现有契约
|
||||
|
||||
**Files:**
|
||||
- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiBankTagControllerTest.java`
|
||||
- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/ProjectBankTagRebuildCoordinatorTest.java`
|
||||
- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiBankTagServiceRiskCountRefreshTest.java`
|
||||
|
||||
- [ ] **Step 1: Run controller and coordinator contract tests**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
mvn -pl ccdi-project -Dtest=CcdiBankTagControllerTest,ProjectBankTagRebuildCoordinatorTest test
|
||||
```
|
||||
|
||||
Expected:
|
||||
|
||||
- `PASS`
|
||||
- 能证明手动重打标入口、运行中防重提交流程和归档保护逻辑都已存在
|
||||
|
||||
- [ ] **Step 2: Run risk count refresh test**
|
||||
|
||||
Run:
|
||||
|
||||
```bash
|
||||
mvn -pl ccdi-project -Dtest=CcdiBankTagServiceRiskCountRefreshTest test
|
||||
```
|
||||
|
||||
Expected:
|
||||
|
||||
- `PASS`
|
||||
- 能证明重打标成功后会刷新员工结果并同步更新项目风险人数
|
||||
|
||||
- [ ] **Step 3: If any test fails, inspect before changing code**
|
||||
|
||||
若失败，先检查是否为环境或依赖问题，再决定是否需要补充代码；本次默认目标是不产生新的后端代码改动。
|
||||
|
||||
- [ ] **Step 4: Commit**
|
||||
|
||||
```bash
|
||||
git status --short
|
||||
```
|
||||
|
||||
Expected:
|
||||
|
||||
- 若仅运行测试无文件变化，则本任务无需代码提交
|
||||
|
||||
### Task 3: 补充后端验证记录与边界说明
|
||||
|
||||
**Files:**
|
||||
- Create: `docs/tests/records/2026-03-24-project-list-reanalyze-backend-verification.md`
|
||||
- Create: `docs/reports/implementation/2026-03-24-project-list-reanalyze-backend-record.md`
|
||||
|
||||
- [ ] **Step 1: Write verification skeleton**
|
||||
|
||||
创建后端验证记录，至少包含：
|
||||
|
||||
```markdown
|
||||
# 项目管理列表重新分析后端验证记录
|
||||
|
||||
## 验证范围
|
||||
- 手动重打标接口可直接复用于列表页
|
||||
- 重打标开始后项目进入打标中
|
||||
- 重打标成功后自动重算项目风险人数
|
||||
- 运行中任务和归档项目保留既有后端保护
|
||||
```
|
||||
|
||||
- [ ] **Step 2: Record exact commands and results**
|
||||
|
||||
把实际执行的测试命令和结果写入验证记录：
|
||||
|
||||
```bash
|
||||
mvn -pl ccdi-project -Dtest=CcdiBankTagControllerTest,ProjectBankTagRebuildCoordinatorTest,CcdiBankTagServiceRiskCountRefreshTest test
|
||||
```
|
||||
|
||||
Expected:
|
||||
|
||||
- 记录通过或失败原因
|
||||
|
||||
- [ ] **Step 3: Write the implementation record**
|
||||
|
||||
在 `docs/reports/implementation/2026-03-24-project-list-reanalyze-backend-record.md` 中写明：
|
||||
|
||||
- 为什么本次后端不需要改代码
|
||||
- 现有复用链路覆盖了哪些需求
|
||||
- 已验证的保护场景有哪些
|
||||
- 后续仅由前端接线即可进入实现阶段
|
||||
|
||||
- [ ] **Step 4: Commit**
|
||||
|
||||
```bash
|
||||
git add docs/tests/records/2026-03-24-project-list-reanalyze-backend-verification.md docs/reports/implementation/2026-03-24-project-list-reanalyze-backend-record.md
|
||||
git commit -m "补充项目列表重新分析后端验证记录"
|
||||
```
|
||||
Reference in New Issue
Block a user