3.4 KiB
项目状态变更日志实施计划
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: 统一在 CcdiProjectServiceImpl 中收口项目状态日志。项目创建时记录初始状态日志，后续通过 updateProjectStatus 处理的状态变更统一记录“变更前/变更后/操作人”日志，并在状态未变化时避免重复输出。
Tech Stack: Java 21、Spring Boot 3、MyBatis Plus、SLF4J/Logback、JUnit 5、Mockito
Task 1: 明确状态变更入口
Files:
-
Modify:
ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImpl.java -
Check:
ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiBankTagServiceImpl.java -
Step 1: 盘点项目状态变更入口
确认项目状态仅在项目创建默认置为“进行中”以及 updateProjectStatus 方法中发生持久化变更。
- Step 2: 确认日志收口位置
确保打标流程等调用方继续复用 updateProjectStatus，不在调用方分散新增重复日志。
Task 2: 先补失败测试
Files:
-
Test:
ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImplTest.java -
Step 1: 为项目创建补日志测试
编写测试验证创建项目成功后输出初始状态日志，日志内容包含 projectId、projectName、状态和值。
- Step 2: 为状态切换补日志测试
编写测试验证 updateProjectStatus 在状态真实变化时输出状态变更日志，并包含旧状态、新状态、操作人。
- Step 3: 为重复状态写入补日志约束测试
编写测试验证当目标状态与当前状态一致时，不重复输出状态变更日志。
- Step 4: 运行单测确认先失败
Run: mvn -pl ccdi-project -Dtest=CcdiProjectServiceImplTest test
Expected: 新增日志相关断言失败，证明测试覆盖到新增行为。
Task 3: 实现统一日志
Files:
-
Modify:
ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectServiceImpl.java -
Step 1: 为服务类补日志能力
引入 @Slf4j 或等效 Logger，保持与模块现有日志风格一致。
- Step 2: 在项目创建后记录初始状态
在项目持久化成功后输出“项目状态初始化”日志。
- Step 3: 在状态变更时记录统一日志
在 updateProjectStatus 中记录“项目状态变更”日志，打印项目标识、项目名称、旧状态、新状态、操作人。
- Step 4: 避免无效重复日志
当旧状态与新状态一致时，不输出状态变更日志，但保留现有更新时间写入行为。
Task 4: 补实施记录并验证
Files:
-
Create:
docs/reports/implementation/2026-03-18-项目状态变更日志实施记录.md -
Step 1: 记录本次实施内容
补充实施记录，说明状态日志覆盖范围、代码修改点和测试结果。
- Step 2: 运行最终验证
Run: mvn -pl ccdi-project -Dtest=CcdiProjectServiceImplTest,CcdiBankTagServiceImplTest test
Expected: 相关测试全部通过，确认状态日志不影响现有打标状态流转。