fix(加班申请): 修复加班申请的状态机相关代码的不合理的地方。

fix(person-item): 权限放开
feat(新增加班申请功能): 新增申请功能，可在工作台进行审核。
2026-06-03 21:00:11 +08:00 · 2026-06-02 09:14:40 +08:00 · 2026-06-01 21:25:02 +08:00 · 2026-05-29 16:24:09 +08:00 · 2026-05-26 19:11:17 +08:00 · 2026-05-25 14:17:37 +08:00
286 changed files with 16277 additions and 2246 deletions
--- a/.claude/settings.local.json
+++ b/.claude/settings.local.json
@@ -36,7 +36,80 @@
      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am test '-Dtest=VisibilityScopeResolverImplTest' '-Dsurefire.failIfNoSpecifiedTests=false' | Select-String -Pattern 'Tests run|BUILD|ERROR|FAIL' | Select-Object -Last 40)",
      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am test '-Dsurefire.failIfNoSpecifiedTests=false' | Select-String -Pattern 'Tests run|BUILD|ERROR|FAILED|FAIL' | Select-Object -Last 100)",
      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am test-compile '-Dsurefire.failIfNoSpecifiedTests=false' | Select-String -Pattern 'ERROR|BUILD|FAIL' | Select-Object -Last 40)",
-      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot test '-Dsurefire.failIfNoSpecifiedTests=false' | Select-String -Pattern 'Tests run|BUILD|FAILED|ERROR' | Select-Object -Last 80)"
+      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot test '-Dsurefire.failIfNoSpecifiedTests=false' | Select-String -Pattern 'Tests run|BUILD|FAILED|ERROR' | Select-Object -Last 80)",
+      "Skill(code-review:code-review)",
+      "Bash(Test-Path *)",
+      "Skill(superpowers:systematic-debugging)",
+      "Bash(mv \"项目框架设计与后续改造约束说明.md\" architecture/)",
+      "Bash(mv \"新增微服务模块必需项清单.md\" architecture/)",
+      "Bash(mv \"后端提交规范与示例.md\" architecture/)",
+      "Bash(mv \"单体启动模式可行性评估.md\" architecture/)",
+      "Bash(mv \"对象状态能力落地规范.md\" architecture/)",
+      "Bash(mv \"rdms-gateway.md\" \"modules/网关说明.md\")",
+      "Bash(mv \"rdms-spring-boot-starter-biz-ip.md\" \"modules/业务IP启动器.md\")",
+      "Bash(mv \"rdms-spring-boot-starter-env.md\" \"modules/环境配置启动器.md\")",
+      "Bash(mv \"rdms-spring-boot-starter-excel.md\" \"modules/Excel启动器.md\")",
+      "Bash(mv \"rdms-spring-boot-starter-mq.md\" \"modules/消息队列启动器.md\")",
+      "Bash(mv \"文件存储_内网MinIO接入说明.md\" domains/system/)",
+      "Bash(mv \"登录验证码前端接入说明.md\" domains/system/)",
+      "Bash(mv \"product/02-产品管理_业务设计.md\" domains/product/)",
+      "Bash(mv \"product/03-工单到任务全链路与工作流方案.md\" domains/product/)",
+      "Bash(mv \"product/05-产品管理_前端联调最小闭环清单.md\" domains/product/)",
+      "Bash(mv \"product/06-产品设置_补丁版说明.md\" domains/product/)",
+      "Bash(mv \"product/07-产品设置_前端联调API文档.md\" domains/product/)",
+      "Bash(mv \"项目/03-项目管理_业务设计.md\" domains/project/)",
+      "Bash(mv \"项目/2026-05-08-execution-member-change-history-design.md\" \"domains/project/2026-05-08-执行成员变更历史设计.md\")",
+      "Bash(mv \"项目/2026-05-09-task-fix-plan.md\" \"domains/project/2026-05-09-任务修复计划.md\")",
+      "Bash(mv \"项目/2026-05-09-task-logic-review.md\" \"domains/project/2026-05-09-任务逻辑评审.md\")",
+      "Bash(mv \"项目/2026-05-09-task-worklog-design.md\" \"domains/project/2026-05-09-任务工时设计.md\")",
+      "Bash(mv \"任务工时与进度模型_业内标杆调研.md\" research/)",
+      "Bash(mv \"任务负责人模型_业内标杆调研.md\" research/)",
+      "Bash(mv \"技术负债台账.html\" debt/)",
+      "Bash(mv \"product/product-overview-mockup.html\" \"temp/产品概览-mockup.html\")",
+      "Bash(mv \"项目/2026-05-12-按钮可见度演示.html\" temp/)",
+      "Bash(mv \"product/rdms_object_status_transition.sql\" sql/)",
+      "Bash(mv \"product/system_menu.sql\" sql/)",
+      "Bash(mv \"项目/object.sql\" sql/)",
+      "Bash(mv \"项目/rdms_biz_audit_log.sql\" sql/)",
+      "Bash(mv \"项目/sql/\"*.sql sql/)",
+      "Bash(mv \"项目/项目管理待确认项清单_V1.0.md\" domains/project/)",
+      "Bash(rmdir 项目)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot compile -am -DskipTests 2>&1 | Select-Object -Last 20)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot compile -am -DskipTests -f \"C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\pom.xml\" 2>&1 | Select-Object -Last 30)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test-compile -am 2>&1 | Select-Object -Last 40)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test -am \"-Dtest=ProjectTaskServiceImplTest,ProjectExecutionServiceImplTest\" 2>&1 | Select-Object -Last 80)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test -am \"-Dtest=ProjectTaskServiceImplTest,ProjectExecutionServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" 2>&1 | Select-Object -Last 80)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test -am \"-Dtest=ProjectTaskServiceImplTest,ProjectExecutionServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" 2>&1 | Select-Object -First 200)",
+      "PowerShell(Get-ChildItem \"C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\.claude\\\\worktrees\\\\agent-a0979555dc2fe9384\\\\rdms-project\\\\rdms-project-boot\\\\target\\\\surefire-reports\" | Where-Object { $_.Name -match \"Test\" } | ForEach-Object { $_.Name })",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot compile -am -DskipTests 2>&1 | Select-Object -Last 30)",
+      "Bash(/c/software/apache-maven-3.8.9/bin/mvn.cmd -pl rdms-project/rdms-project-boot test -am -Dtest=ProjectTaskServiceImplTest#changeTaskStatus_shouldUseTransitionAndWriteLogs -q)",
+      "Bash(/c/software/apache-maven-3.8.9/bin/mvn.cmd -pl rdms-project/rdms-project-boot test -Dtest=ProjectTaskServiceImplTest#changeTaskStatus_shouldUseTransitionAndWriteLogs -Dsurefire.failIfNoSpecifiedTests=false -q)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test \"-Dtest=ProjectTaskServiceImplTest#changeTaskStatus_shouldUseTransitionAndWriteLogs\" \"-Dsurefire.failIfNoSpecifiedTests=false\" -q 2>&1 | Select-Object -Last 60)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test-compile -am -q 2>&1 | Select-Object -Last 40)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test-compile -am -q 2>&1 | Select-Object -Last 20)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test-compile -am 2>&1 | Select-String \"BUILD SUCCESS|BUILD FAILURE|ERROR\" | Select-Object -Last 5)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot test -am \"-Dtest=ProjectTaskServiceImplTest,ProjectExecutionServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" 2>&1 | Select-String \"Tests run|BUILD SUCCESS|BUILD FAILURE|FAILED|<<<\" | Select-Object -Last 30)",
+      "PowerShell([System.IO.Directory]::GetCurrentDirectory\\(\\))",
+      "Bash(Get-ChildItem -Directory -Name)",
+      "Bash(grep \"\\\\.java$\")",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot -am compile -DskipTests 2>&1 | Select-Object -Last 30)",
+      "PowerShell($env:JAVA_HOME = \"C:\\\\Program Files\\\\Java\\\\jdk-17\"; & \"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot -am clean compile -DskipTests 2>&1 | Select-Object -Last 35)",
+      "Bash(C:/Program Files/Java/jdk-17/bin/java.exe *)",
+      "Bash(export JAVA_HOME=\"C:/Program Files/Java/jdk-17\")",
+      "Bash(cd \"C:/code/gitea/rdms/cn-rdms\")",
+      "Bash(\"C:/software/apache-maven-3.8.9/bin/mvn.cmd\" -pl rdms-project/rdms-project-boot -am compile -DskipTests)",
+      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; $env:PATH = \"$env:JAVA_HOME\\\\bin;$env:PATH\"; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am compile -DskipTests -q)",
+      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; $env:PATH = \"$env:JAVA_HOME\\\\bin;$env:PATH\"; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am compile -DskipTests | Select-Object -Last 15)",
+      "PowerShell(java *)",
+      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; $env:PATH = \"$env:JAVA_HOME\\\\bin;$env:PATH\"; & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am compile -DskipTests -q 2>&1 | Select-Object -Last 30)",
+      "PowerShell($env:JAVA_HOME = 'C:\\\\Program Files\\\\Java\\\\jdk-17'; $env:PATH = \"$env:JAVA_HOME\\\\bin;$env:PATH\"; $out = & 'C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd' -pl rdms-project/rdms-project-boot -am compile -DskipTests 2>&1; $code = $LASTEXITCODE; $out | Select-Object -Last 15; Write-Output \"EXIT=$code\")",
+      "Bash(set \"JAVA_HOME=C:\\\\Program Files\\\\Java\\\\jdk-17\")",
+      "Bash(\"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot -am compile -DskipTests -q)",
+      "Bash(\"C:\\\\software\\\\apache-maven-3.8.9\\\\bin\\\\mvn.cmd\" -pl rdms-project/rdms-project-boot -am compile -DskipTests)",
+      "Bash(grep -E \"\\\\.\\(sql|java|md\\)$\")",
+      "Bash(xargs grep -l \"INSERT INTO.*system_menu\")",
+      "Bash(Get-ChildItem *)",
+      "Bash(Select-Object FullName)"
    ]
  }
 }
--- a/.gitignore
+++ b/.gitignore
@@ -76,3 +76,6 @@ sessionStore

 # local docs
 /docs/
+
+# Claude Code 本地工作区
+.claude/
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,245 +1,5 @@
 # AGENTS.md

-## 适用范围
+本仓库的 Agent 工作指引以 [`CLAUDE.md`](./CLAUDE.md) 为准。

-本说明适用于以 `C:\code\gitea\rdms\cn-rdms` 为根目录的整个仓库。
-
-描述仓库现状时，以当前代码、当前配置、当前文档中可直接验证的事实为准；除非用户明确要求，不引入历史实现、过渡方案或已废弃模型来解释当前状态。
-
-默认回答保持精简，优先给结论、改动点和必要风险，不做过多展开；如果存在你关心但未展开的细节，由你继续追问后再补充。
-
-回答问题时不要过多代码层面的描述：默认用自然语言给结论、判断、影响面；除非用户明确要看实现细节，不要大段贴代码片段、不要逐行解读、不要把分析写成"先看 xxx.java 第 N 行"的形式。涉及代码定位时用 `file_path:line_number` 引用即可。
-
-## 交互原则
-
- 默认先给执行方案，说明目标、涉及模块、预计改动点和验证方式。
- 在用户评审并明确同意前，不直接开始实际修改、编译、测试、打包或其他执行动作。
- 是否执行由用户决定；如果用户只要求分析、审阅或出方案，就停留在分析和方案层。
-
-## 项目概览
-
-这是一个面向 RDMS 服务的多模块 Maven 单仓库项目。
-
- Java 版本：17
- 构建工具：Maven
- 根模块打包类型：`pom`
- Spring Boot 版本：`3.5.9`
-
-## 本地环境约定
-
- 本仓库要求使用 `JDK 17`；不要使用 `JDK 8`、`JDK 11` 或其他版本执行编译、测试、启动、打包。
- 本机 JDK 17 路径：`C:\Program Files\Java\jdk-17`
- 如需执行 Maven、Java、测试、启动等命令，应先确认当前 `JAVA_HOME` 指向 `C:\Program Files\Java\jdk-17`，并确保 `java -version` 实际输出为 `17`
- 本机 Maven 安装路径：`C:\software\apache-maven-3.8.9`
- 如需执行 Maven 命令，优先使用完整路径：`C:\software\apache-maven-3.8.9\bin\mvn.cmd`
- 不要假设 `mvn` 已加入 PATH
- 不要假设系统默认 `JAVA_HOME` 已正确指向 JDK 17；如果当前 shell 不是 JDK 17，先在当前命令上下文显式切换后再执行 Maven
- 只有在用户已明确同意执行编译、测试、打包等 Maven 命令时，才使用上述路径执行
-
-顶层模块：
-
-1. `rdms-system`
-2. `rdms-project`
-3. `rdms-framework`
-4. `rdms-gateway`
-
-当前系统域能力主要集中在 `rdms-system`，RDMS 核心交付域能力主要集中在 `rdms-project`，但这只是现阶段结构，不应被理解为长期只保留这两个业务模块。
-
-后续如果新增独立业务服务，例如项目/产品管理模块、工作流模块，应继续沿用当前仓库的模块拆分方式，而不是把所有后续业务长期堆进 `rdms-system`。
-
-## 模块说明
-
-### `rdms-system`
-
-当前已存在的系统业务聚合模块。
-
- `rdms-system/rdms-system-boot`
-  - 主应用模块
-  - 启动入口：`rdms-system/rdms-system-boot/src/main/java/com/njcn/rdms/module/system/SystemServerApplication.java`
-  - 主包路径：`com.njcn.rdms.module.system`
-  - 常见子包：`api`、`controller`、`convert`、`dal`、`framework`、`job`、`service`、`util`、`websocket`
- `rdms-system/rdms-system-api`
-  - 供其他服务依赖的共享 API 模块
-  - 包含对外 API 契约与枚举定义
-
-说明：
-
- 当前权限、用户、组织、岗位、菜单、角色等系统核心能力主要落在这里。
- 如果后续只是给系统域补充新的系统子能力，可以继续在 `rdms-system` 内按现有结构扩展。
- 如果后续形成独立业务域，例如 `rdms-project`、`rdms-workflow`，应优先建设为新的独立业务模块，而不是默认继续塞进 `rdms-system`。
-
-### `rdms-project`
-
-当前已存在的 RDMS 核心交付业务聚合模块。
-
- `rdms-project/rdms-project-boot`
-  - 主应用模块
-  - 启动入口：`rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/ProjectServerApplication.java`
-  - 主包路径：`com.njcn.rdms.module.project`
-  - 常见子包：`api`、`controller`、`convert`、`dal`、`framework`、`service`
- `rdms-project/rdms-project-api`
-  - 供其他服务依赖的共享 API 模块
-  - 包含对外 API 契约与枚举定义
-
-说明：
-
- 当前项目集、项目、产品、需求、任务、工单、执行等 RDMS 核心业务能力应优先落在这里。
- 需要复用用户、组织、岗位、权限等系统能力时，应通过 `rdms-system-api` 调用，不要反向依赖 `rdms-system-boot`。
-
-### `rdms-framework`
-
-共享框架与内部 starter 模块。
-
- `rdms-framework/rdms-common`
-  - 核心通用工具与公共抽象
- 其他 `rdms-spring-boot-starter-*` 模块
-  - 内部 starter，覆盖 `env`、`web`、`rpc`、`security`、`mybatis`、`redis`、`mq`、`websocket`、`excel`、`protection`、`test`、`biz-ip`
-
-### `rdms-gateway`
-
-Spring Cloud Gateway 网关服务。
-
- 启动入口：`rdms-gateway/src/main/java/com/njcn/rdms/gateway/GatewayServerApplication.java`
- 主包路径：`com.njcn.rdms.gateway`
- 常见子包：`filter`、`handler`、`jackson`、`route`、`util`
-
-## 模块演进约束
-
-后续新增业务能力时，先区分下面两种情况，不要混用：
-
-1. 新增独立微服务模块，例如 `rdms-project`、`rdms-workflow`
-2. 只是在现有 `rdms-system` 中新增一个业务子域
-
-### 新增独立微服务模块
-
-如果后续能力已经具备独立服务边界，应优先按下面结构建设：
-
-```text
-rdms-xxx
-├─ rdms-xxx-api
-└─ rdms-xxx-boot
-```
-
-约束：
-
- 根 `pom.xml` 增加新的聚合模块
- `api` 模块承载对外 RPC/Feign 接口、DTO、错误码、枚举、常量
- `boot` 模块承载启动类、controller、service、dal、convert、api 实现、模块级 framework 配置和资源文件
- 包路径、`spring.application.name`、`ApiConstants`、`RpcConstants`、`rdms.info.base-package` 必须保持一致
- 新服务不是简单复制 `rdms-system` 的名字，而是复用它的工程骨架和分层习惯
-
-### 在 `rdms-system` 中新增业务子域
-
-如果只是给系统服务补一个当前阶段仍适合放在 `rdms-system` 内的子域，则继续沿用现有结构：
-
- `controller/admin/...` 或 `controller/app/...`
- `service/...`
- `dal/dataobject/...`
- `dal/mysql/...`
- `convert/...`
- 需要跨模块暴露时，在 `rdms-system-api` 中补 API、DTO、错误码、枚举
-
-约束：
-
- 不要为了新增子域引入一套平行的 `application/domain/infrastructure/adapter` 分层语言
- 不要让外部模块直接依赖 `rdms-system-boot` 的 service 或 mapper
- 如果某项能力未来明显会演进成独立微服务，文档和实现上都要避免把它写死成只能存在于 `rdms-system`
-
-## 代码目录
-
- Java 源码：`*/src/main/java`
- 资源文件：`*/src/main/resources`
- 测试代码：`*/src/test/java`
- 本地辅助脚本：`scripts/`
-
-## 分层职责约束
-
-### `rdms-framework`
-
- `rdms-framework` 承担基础能力，不承载具体业务语义。
- 除非出现框架级缺陷，或该能力明确属于全局可复用基础设施，否则不要把业务判断硬塞进 framework。
-
-### `rdms-gateway`
-
- `rdms-gateway` 只负责统一入口、令牌校验、登录用户透传、路由和网关层横切逻辑。
- 不要在 gateway 层承载组织、成员、负责人、项目、产品、工作流状态流转或数据可见性这类业务语义。
-
-### Controller 层
-
- Controller 负责 HTTP 暴露、参数校验、权限注解、结果封装。
- 不要在 controller 中直接编排复杂业务流程，也不要直接操作多个 mapper 拼装业务规则。
- 请求和响应对象优先沿用 `ReqVO`、`RespVO` 风格，不要直接把 DO 暴露给前端。
-
-### Service 层
-
- 核心业务规则、事务、缓存、领域编排应落在 service 层。
- 如果是已有领域增强，优先在现有 service 下扩展，不要为了“看起来更整齐”平移整套代码。
- 不要把复杂规则散落到 controller、mapper 或 `util` 中。
-
-### DAL 层
-
- 新表应有对应的 DO 和 Mapper。
- Mapper 优先继承 `BaseMapperX<T>`，不要重复写样板 CRUD。
- 查询条件优先沿用 `LambdaQueryWrapperX`、默认方法封装和现有 MyBatis Plus 风格，不要无必要回退到 XML。
- Mapper 以查询封装为主，不承担领域校验职责。
-
-### Convert 层
-
- 如果某个领域已经有 `convert` 风格，则继续沿用。
- 简单场景允许直接使用 `BeanUtils`。
- 不要为了统一而强推所有地方都改成 MapStruct，也不要反过来把已有 convert 全部删掉。
-
-## 认证与共享调用约束
-
- 默认沿用现有 OAuth2 / Token / `LoginUser` / `login-user` 透传主链，不要另造一套认证上下文体系。
- 不要额外发明 ThreadLocal、Session 或自定义 header 体系替代当前登录态恢复方式。
- 接口级权限判断默认沿用 `@PreAuthorize("@ss.hasPermission(...)")` 这条链路，不要绕开现有权限框架另起一套实现。
- 跨模块、跨服务访问能力时，优先通过对应的 `*-api` 模块定义 API、DTO、常量和枚举。
- 不要让外部模块直接依赖某个 `*-boot` 模块的 service 或 mapper。
-
-## 数据与 SQL 约束
-
- 新增业务表的 DO 优先复用当前 `BaseDO` / 审计字段风格；除非表本身明确不需要逻辑删除，不要再引入另一套审计基类。
- 不要假设运行时存在自动数据库迁移；如果代码依赖新表、新字段或新索引，必须同步补齐对应 SQL 与文档说明。
- SQL 脚本应放在目标模块的 `src/main/resources/sql/...` 下，并保持可审阅、可单独执行、语义清晰。
- 变更缓存、日志、审计相关逻辑时，优先沿用现有机制，不要绕开现有登录上下文、缓存约定和审计字段填充方式。
-
-## 注释与编码
-
- 新增或修改代码时，关键字段、关键分支、关键约束和非直观实现应补充简洁中文注释。
- 不要为了省事删除原有有效注释，也不要添加无信息量的注释。
- 写入中文内容时必须保持 UTF-8 编码，并自行检查中文显示是否正常；不要用“改成英文”规避乱码问题。
- 使用 superpowers 产出的功能文档时，例如设计文档、实施计划、联调说明，除非用户明确要求，否则默认用中文落地；代码标识、文件路径、接口路径、SQL、命令保持原始技术标识，不做意译。
-
-## 工作规则
-
-1. 除非任务明确要求修改共享契约或 starter，否则优先进行有边界的模块内改动，避免跨模块扩散。
-2. 业务逻辑应放在对应业务模块的 `*-boot` 实现模块；可复用契约放在对应的 `*-api` 模块；可复用框架能力放在 `rdms-framework`。
-3. 除非任务本身就是环境配置调整，否则避免修改 `application-local.yaml` 和 `application-dev.yaml`。
-4. 将本地资源 YAML 视为可能带有机器环境差异的文件；修改前先检查 git 状态。
-5. 保持既有包结构约定不变：
-   - 控制器放在 `controller`
-   - 服务层放在 `service`
-   - 持久层放在 `dal`
-   - DTO/VO 转换放在 `convert`
-6. 当前系统域代码主要在 `rdms-system`，RDMS 核心交付域代码主要在 `rdms-project`，但这不是永久约束；新增业务能力时，先判断应该落在现有系统域内、现有项目交付域内，还是应建设为新的 `rdms-xxx` 业务模块。
-7. 新增共享能力时，优先扩展现有 `rdms-spring-boot-starter-*` 模块，不要在业务服务里重复堆配置。
-8. 修改跨模块使用的 API 时，需要同时更新提供方实现和对应的 `rdms-system-api` 或对应 `rdms-xxx-api` 契约。
-9. 除非用户明确要求，否则不执行任何编译、构建、测试、打包或其他会实际运行项目的命令，包括但不限于 `mvn`、启动命令和脚本。
-
-## 测试指引
-
-先定义验证方式，再实施修改。默认通过以下方式验证：
-
- 代码路径是否闭环，调用链是否与模块边界一致
- 配置项、接口契约、权限标识、路由或资源注册是否前后一致
- 改动范围是否控制在当前任务所需的最小集合内
- 受影响的文档、SQL、配置或接口说明是否需要同步更新
-
-如果任务影响了 Spring 配置、序列化、安全、路由、RPC 契约、MyBatis 行为或跨模块 API，一律明确说明哪些部分已静态检查、哪些部分尚未实际运行验证。
-
-## 给后续 Agent 的说明
-
- 仓库中可能存在未提交的本地配置改动，不要覆盖与当前任务无关的编辑。
- `docs/` 目录属于当前工作上下文的一部分，不是归档材料；做架构级修改前先查阅。
- 根目录 `pom.xml` 负责统一版本和依赖对齐；涉及版本调整时，优先修改根 `pom.xml`，不要散落到子模块中。
+适用范围：以 `C:\code\gitea\rdms\cn-rdms` 为根目录的整个仓库。所有交互原则、本机环境、模块结构、分层职责、鉴权通道、HTTP 动词语义、数据与 SQL、注释编码、Git 纪律、验证默认动作等约束，请直接阅读 `CLAUDE.md`。
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,22 +1,21 @@
 # CLAUDE.md

-本文件为 Claude Code 在 `C:\code\gitea\rdms\cn-rdms` 仓库工作时的常驻指引，等价并补充 `AGENTS.md`。两份文件冲突时以本文件为准；本文件未覆盖的细节回退到 `AGENTS.md`。
+本文件为 `C:\code\gitea\rdms\cn-rdms` 仓库下所有 Agent（含 Claude Code）的常驻工作指引；`AGENTS.md` 引用本文件。

 ## 工作方式

- 默认先给执行方案：目标、涉及模块、改动点、验证方式。用户明确同意前不要直接动手修改、编译、测试、打包。
+- 默认先给执行方案：目标、涉及模块、改动点、验证方式；不擅自动手。
 - 用户只要分析或评审时，停在分析层；不要顺手开工。
 - 描述仓库现状以**当前**代码、配置、文档可验证的事实为准；不要拿历史实现、过渡方案或已废弃模型解释当前状态。
- 回答保持精简，先给结论、改动点、必要风险；细节等用户追问。
- **不要废话**：默认极简输出，不展开背景、不复述需求、不堆叠章节标题；能用一两句讲清就别写成清单；用户主动追问再展开。
- **回答问题时不要过多代码层面的描述**：默认用自然语言给结论、判断、影响面；除非用户明确要看实现细节，不要大段贴代码片段、不要逐行解读、不要把分析写成"先看 xxx.java 第 N 行"的形式。涉及代码定位时用 `file_path:line_number` 引用即可。
+- **输出极简**：先给结论、改动点、必要风险；用自然语言给判断和影响面，少贴代码片段；涉及代码用 `file_path:line_number` 引用；用户追问再展开。
+- **下定论需要充足证据**。疑似 bug 时先判断是否稳定复现：跑了很久没动过的功能**首次**报错，优先怀疑运行时状态污染（devtools / IDE 热替换、ApplicationContext 残留、缓存、Redis / DB 连接、JVM 静态字段被旧 context 设过等），**不要凭单次堆栈就断言代码 bug，更不要直接甩修改方案**。先给"可能原因 + 最便宜的取证步骤"（多数场景是**冷重启 JVM**），用户确认能稳定复现，再讨论代码层面的修复。同款写法在仓库其它位置存在并不能反推"也是 bug"，长期能跑的代码突然失效 ≠ 代码本身错。
+- **技术风险判断（性能 / N+1 / 索引缺失 / 架构缺陷 / 并发安全 / 内存泄漏 等）与"bug 判断"同等严格**：未读到实现层不下结论。不要凭 subagent 摘要、字段名、注释或印象"顺嘴提一句风险/瓶颈/可能问题"——那也是下结论，**且杀伤力更大**：用户会基于"风险提示"决定要不要立项整改。如果当前上下文没核实到实现，就明说"这部分未核实，需要打开 X 文件确认"，不要把猜测包装成"风险提示"塞出去。已识别教训：执行进度查询答完"已批量聚合无 N+1"后又凭印象抛"列表 N+1 风险"，被追问才收回。

 ## 本机环境

 - JDK：必须使用 `JDK 17`，路径 `C:\Program Files\Java\jdk-17`。不要使用 JDK 8 / 11 / 其他版本。
 - Maven：`C:\software\apache-maven-3.8.9`，命令优先用完整路径 `C:\software\apache-maven-3.8.9\bin\mvn.cmd`。不要假设 `mvn` 在 PATH。
 - 执行任何 Maven / java 命令前，先确认当前 shell 的 `JAVA_HOME` 指向 JDK 17，且 `java -version` 输出 17；否则在该命令上下文中显式切换。
- **只有在用户已明确同意执行编译/测试/打包等命令时**，才使用上述路径执行。日常默认不跑任何会实际运行项目的命令。

 ## 仓库结构

@@ -65,7 +64,7 @@
 ## 认证与跨模块调用

 - 默认沿用 OAuth2 / Token / `LoginUser` / `login-user` 透传主链。**不要**另造 ThreadLocal / Session / 自定义 header。
- 跨模块/跨服务必须通过 `*-api` 模块定义契约；不要直接依赖别人的 `*-boot`。
+- 业务逻辑落 `*-boot`；可复用契约落 `*-api`；可复用框架能力落 `rdms-framework`。跨模块/跨服务必须通过 `*-api` 定义契约，**不要直接依赖别人的 `*-boot`**；改跨模块 API 时，`*-boot` 实现与对应 `*-api` 契约同步更新。

 ### 鉴权：必须按"全域 / 对象域"分通道挂

@@ -81,7 +80,7 @@
 - **对象内接口绝不能挂 `@PreAuthorize("@ss.hasPermission(...)")`**。该注解走的链路在 `PermissionServiceImpl` 里强制按 GLOBAL 取角色（line 343-347）+ 强制按 GLOBAL 查菜单（line 92-94），对象域角色与对象域菜单都进不来，即使授权配置完全正确也必然 403。
 - **对象域权限校验必须落在 Service 层 `@CheckObjectPermission`**，原因：路径里 `objectId` 通常以 `#projectId`/`#productId` 等 SpEL 解析，Controller 的参数校验前置阶段不便复用；与同模块（`ProjectMemberServiceImpl` / `ProjectExecutionServiceImpl` / `ProjectExecutionAssigneeServiceImpl` / `ProjectTaskServiceImpl`）保持一致。
 - **同一接口不要两条通道叠加**。要么全域，要么对象域；叠加只会让对象域用户被全域那条卡死。
- 列表/详情这类对象内**读路径**目前未挂 `@CheckObjectPermission`（属已识别负债，台账 TD-001），新增读接口暂沿用现状即可，不要顺手改造，等独立立项。
+- 对象内**读路径**（列表 / 详情 / 状态看板 / 聚合）已统一在 **Service 层**挂 `@CheckObjectPermission(objectType=PROJECT, permission=...PERMISSION_QUERY)`——查询同样要扫库耗资源，必须按对象域鉴权（原台账 TD-001 所述"读路径未挂"已不成立）。**Controller 方法层一律不挂权限注解**，对象域鉴权全部落 Service；新增读接口照此在 Service 层挂对象域权限，不要只在 Controller 留空、更不要误判"Controller 没注解 = 无鉴权"。

 判定口诀：**URL 里有 `{projectId}` / `{productId}` 等对象 ID → 对象域；没有 → 全域**。

@@ -108,23 +107,55 @@
 - SQL 放在目标模块 `src/main/resources/sql/...`，可审阅、可单独执行。
 - 缓存/日志/审计变更优先沿用既有机制，不要绕开登录上下文与审计字段填充。

+### 种子 SQL（纯 SQL INSERT 雪花 ID 表）
+
+`system_dict_type` / `system_dict_data` / `system_menu` 等历史表 id 由 MyBatis-Plus 雪花算法在 Java 层生成，DDL 无 `AUTO_INCREMENT`。纯 SQL 路径（字典种子、菜单种子等）写 INSERT 必须显式提供 id，否则 MySQL 报 `1364 - Field 'id' doesn't have a default value`。
+
+- **id 取值**：`SET @new_id = (SELECT IFNULL(MAX(id), 0) + 1 FROM xxx_table);` 然后 INSERT `SELECT @new_id, ...`。雪花 ID 单调递增，`MAX+1` 落在已用区间之后，不会与未来 Java 生成的新雪花 ID 冲突。
+- **多条连续 INSERT**：每条 INSERT **前重新取** `MAX+1`——不要用 `base+1 / +2 / +3` 一次性算多个。配合 `NOT EXISTS` 守卫，部分已存在场景（半路重跑）才不会出现两条共用一个 id。
+- **collation 1267 陷阱**：仓库历史表 collation 不统一（如 `system_dict_data` 是 `utf8mb4_unicode_ci`，新表 `rdms_task_worklog` 是 `utf8mb4_0900_ai_ci`）。**不要**用 `SET @t = 'xxx'` 存字符串再 `WHERE col = @t`——用户变量自带连接级 collation，与列 collation 撞会报 `1267 Illegal mix of collations (utf8mb4_unicode_ci,IMPLICIT) and (utf8mb4_0900_ai_ci,IMPLICIT) for operation '='`。**对策**：直接展开成字面值，MySQL 字面值会按列 collation 隐式解析，不冲突。
+
+样板参考：`docs/sql/rdms_task_worklog.sql:47-50`（菜单种子）+ `docs/sql/rdms_worklog_difficulty_seed.sql`（字典种子）。
+
 ## 注释与编码

- 关键字段、关键分支、关键约束、非直观实现补**简洁中文**注释。
- 不要为省事删除原有有效注释；也不要写无信息量的注释。
- 中文写入必须 UTF-8，并自查显示是否正常；不要用"改成英文"规避乱码。
+- 关键字段/分支/约束/非直观实现补**简洁中文**注释；中文写入必须 UTF-8，不要用"改成英文"规避乱码。
 - superpowers 产出的功能文档（设计/实施/联调）默认中文落地；代码标识、文件路径、接口路径、SQL、命令保持原样不意译。

+## 文档输出格式
+
+- 新写文档默认输出 **HTML 格式**（便于浏览器直接打开、自带样式）。
+- 例外：`docs/superpowers/` 下保持 markdown（工作流约定）。
+- 历史已有的 markdown 文档不强制迁移；只有新写的按 HTML。
+
 ## 工作规则（执行前对照）

 1. 优先做有边界的模块内改动，避免跨模块扩散。
-2. 业务逻辑落 `*-boot`；可复用契约落 `*-api`；可复用框架能力落 `rdms-framework`。
-3. **不要修改** `application-local.yaml` / `application-dev.yaml`，除非任务本身就是环境配置调整。
-4. 把本地 YAML 当作可能带机器差异的文件，改前先查 git 状态。
-5. 包结构：`controller` / `service` / `dal` / `convert`，保持不变。
-6. 新增共享能力优先扩展现有 `rdms-spring-boot-starter-*`，不要在业务服务里重复堆配置。
-7. 改跨模块 API 时，提供方实现与对应 `*-api` 契约同步更新。
-8. **未经用户明确同意，不执行任何 `mvn`、启动命令、脚本等会实际运行项目的命令。**
+2. **不要修改** `application-local.yaml` / `application-dev.yaml`，除非任务本身就是环境配置调整；改前先查 git 状态。
+3. 新增共享能力优先扩展现有 `rdms-spring-boot-starter-*`，不要在业务服务里重复堆配置。
+4. **未经用户明确同意，不执行任何 `mvn`、启动命令、脚本等会实际运行项目的命令。**
+
+## Git 操作纪律
+
+### 默认不引导分支管理（**首要**）
+
+用户在本仓库长期固定在 `main` 上工作。开发流程中：
+
+- **不要主动建议建 feature 分支**（`git checkout -b feat/xxx`、`git switch -c ...`）。
+- **不要把"先切到 xxx 分支再操作"作为方案前置步骤**。
+- 一切围绕 `main` 展开：直接在 `main` 上改、`main` 上提交、`main` 上推。
+- 例外：用户明确要求建分支、或涉及多人协作 / PR 评审 / 大规模重构（此时仍只是"提一句作为可选"，不强推）。
+
+**理由**：这次差点丢用户 3 天工作的事故，根因就是分支管理本身——某次操作意外把文件名当成分支名（建出 `用户行动清单.md` 分支），后续"切回 main + `git branch -D` 删怪分支"流程里就把未推送 commit `8bad989` 干掉了。**少走分支 = 少埋雷**。
+
+### 破坏性 git 命令必须先核实
+
+任何**会丢工作**的 git 命令——`branch -D`、`reset --hard`、`clean -fd`、`push --force` / `--force-with-lease`、`checkout` / `switch` 带未提交改动、`rebase` 在已推送分支上、直接动 `.git/` 内部文件（`refs/`、`HEAD`、`packed-refs`）——**给出建议前必须先核实**，不得凭"看起来安全"就甩命令：
+
+1. **目标 ref 上是否有未推送 / 未合并 commit**：让用户跑 `git log --oneline -5 <ref>` 或 `git log <主线>..<ref>` 把输出贴回来。
+2. **工作区是否干净**：`git status`。
+3. **先挂救生圈**：建议用 `git tag backup-xxx <sha>` 锁定当前 SHA，**再执行**破坏性命令。
+4. **明示翻车回滚路径**：例如"如果不对，`git reset --hard backup-xxx` 即可回到此处"。

 ## 验证默认动作

@@ -139,6 +170,6 @@
 ## 给后续我自己的提醒

 - 仓库可能有未提交的本地改动，不要顺手覆盖与当前任务无关的编辑。
- `docs/` 是当前工作上下文的一部分，不是归档；架构级修改前先查阅。
+- `docs/` 是当前工作上下文的一部分，不是归档；架构级修改前先查阅 [`docs/README.md`](./docs/README.md)。
 - 根 `pom.xml` 统一版本与依赖；版本调整改根 pom，不要散落到子模块。
 - 推荐使用 `Glob` / `Grep` / `Read` 等专用工具，避免用 Bash 做文件搜索/读取/编辑。
--- a/docs/superpowers/specs/2026-05-22-ticket-design.md
+++ b/docs/superpowers/specs/2026-05-22-ticket-design.md
@@ -0,0 +1,355 @@
+# 工单需求规格说明
+
+日期：2026-05-22
+
+## 1. 背景
+
+`rdms-project` 当前承载项目、产品、需求、执行、任务等核心交付对象。现有代码中产品需求、项目需求已经具备 `sourceType` / `sourceBizId` 来源字段，可以承接来自工单的需求派生关系；执行和任务也已经形成“项目需求 -> 执行 -> 任务”的后续交付链路。
+
+本需求新增内部工单能力。工单作为独立业务对象存在，不复用需求、执行或任务主表。工单用于记录内部用户提交的诉求，经工单负责人受理后，可按归属类型派生产品需求或项目需求，并通过现有需求链路继续流转到执行、任务。
+
+## 2. 目标
+
+1. 支持内部用户创建普通工单或父工单。
+2. 支持父工单逐步拆分子工单，父工单只汇总，不直接处理。
+3. 支持普通工单、子工单作为最小处理单位，由指定工单负责人受理、拒绝、处理和关闭。
+4. 支持工单单归属到一个产品或一个项目。
+5. 支持产品工单派生产品需求、项目工单派生项目需求。
+6. 支持有派生需求的工单在全部需求完成后自动关闭。
+7. 支持无派生需求的工单由工单负责人手动关闭。
+
+## 3. 非目标
+
+1. 本期不做外部客户工单，不保留 `sourceChannel`、`externalCustomerName`、`externalContact` 等外部来源字段。
+2. 本期不做工单编号 `ticketNo`。
+3. 工单不能直接派生执行或任务。
+4. 父工单不能受理、拒绝、派生需求或手动关闭。
+5. 本期不引入流程引擎，不做可配置审批流。
+6. 本期不自动判断工单是否涉及多个产品/项目，也不自动判断归属产品或项目；这些由录入人员人工选择。
+
+## 4. 核心概念
+
+### 4.1 工单形态
+
+使用 `ticketMode` 表达工单形态：
+
+| 值 | 含义 | 是否可处理 | 说明 |
+|---|---|---|---|
+| `single` | 普通工单 | 是 | 单归属工单，不挂父工单 |
+| `parent` | 父工单 | 否 | 原始诉求汇总单，可持续拆分子工单 |
+| `child` | 子工单 | 是 | 挂在父工单下的最小处理单位 |
+
+不使用 `isParent`。`ticketMode` 比布尔字段更准确，可以区分普通工单、父工单和子工单，避免在父工单尚未创建子工单时无法识别其形态。
+
+### 4.2 归属类型
+
+普通工单和子工单必须单归属：
+
+| `belongType` | 归属对象 | 可派生对象 | 后续链路 |
+|---|---|---|---|
+| `product` | 一个产品 | 产品需求 | 产品需求 -> 指派项目 -> 项目需求 -> 执行 -> 任务 |
+| `project` | 一个项目 | 项目需求 | 项目需求 -> 执行 -> 任务 |
+
+父工单不填写 `belongType`、`productId`、`projectId`。
+
+## 5. 业务流程
+
+### 5.1 总流程图
+
+```mermaid
+flowchart TD
+    A([开始]) --> B[录入人员创建工单]
+    B --> C{ticketMode}
+
+    C -->|parent| P1[父工单: splitting]
+    P1 --> P2[列表操作列拆分子工单]
+    P2 --> C1[创建子工单: pending_accept]
+    P1 --> P3{是否存在子工单且全部为终态}
+    P3 -->|否| P1
+    P3 -->|是| P4[父工单: closed]
+    P4 --> Z([结束])
+
+    C -->|single| S1[普通工单: pending_accept]
+    C1 --> S2[工单负责人待处理]
+    S1 --> S2
+    S2 --> D{是否受理}
+    D -->|否| R[工单: rejected]
+    R --> Z
+    D -->|是| E[工单: processing]
+
+    E --> F{是否派生需求}
+    F -->|否| G[负责人填写处理结论并手动关闭]
+    G --> H[工单: closed]
+    H --> I[触发父工单汇总检查]
+    I --> Z
+
+    F -->|是| J{归属类型}
+    J -->|product| K[派生一个或多个产品需求]
+    J -->|project| L[派生一个或多个项目需求]
+    K --> M[等待派生需求全部完成]
+    L --> M
+    M --> N{全部派生需求完成}
+    N -->|否| E
+    N -->|是| O[系统自动关闭工单: closed]
+    O --> I
+```
+
+### 5.2 父工单流程
+
+1. 录入人员创建父工单，状态为 `splitting`。
+2. 父工单只记录原始诉求和附件，不进入处理队列。
+3. 工单列表查询的操作列为父工单提供“拆分子工单”入口。
+4. 录入人员可以持续新增子工单。
+5. 父工单至少存在一个子工单，且所有子工单均进入终态后，系统自动关闭父工单。
+6. 父工单关闭后不再作为处理对象，但可继续作为历史汇总查看。
+
+### 5.3 普通工单 / 子工单流程
+
+1. 创建后进入 `pending_accept`。
+2. 工单负责人判断是否受理。
+3. 不受理则进入 `rejected`，需要填写拒绝原因。
+4. 受理后进入 `processing`。
+5. 处理中可以派生需求，也可以在无派生需求时填写处理结论并手动关闭。
+6. 一旦存在派生需求，工单不能手动关闭，必须等待全部派生需求完成后自动关闭。
+
+## 6. 状态模型
+
+### 6.1 父工单状态
+
+| 状态 | 含义 | 进入方式 | 退出方式 |
+|---|---|---|---|
+| `splitting` | 拆分中 / 汇总中 | 创建父工单 | 所有子工单终态后自动关闭 |
+| `closed` | 已关闭 | 系统自动关闭 | 终态 |
+
+父工单不允许进入 `pending_accept`、`rejected`、`processing`。
+
+### 6.2 普通工单 / 子工单状态
+
+| 状态 | 含义 | 进入方式 | 退出方式 |
+|---|---|---|---|
+| `pending_accept` | 待受理 | 创建普通工单或子工单 | 受理或拒绝 |
+| `rejected` | 已拒绝 | 工单负责人拒绝 | 终态 |
+| `processing` | 处理中 | 工单负责人受理 | 手动关闭或自动关闭 |
+| `closed` | 已关闭 | 手动关闭或派生需求全部完成后自动关闭 | 终态 |
+
+终态包括 `rejected`、`closed`。
+
+### 6.3 自动关闭规则
+
+1. 普通工单 / 子工单存在派生需求时，只有全部派生需求完成后才自动关闭。
+2. 普通工单 / 子工单不存在派生需求时，允许工单负责人手动关闭，必须填写 `closeResult`。
+3. 父工单至少存在一个子工单，且所有子工单均为 `rejected` 或 `closed` 后，自动关闭。
+4. 父工单不直接检查需求完成情况，只汇总子工单终态。
+
+## 7. 数据模型
+
+### 7.1 工单主表
+
+建议表名：`rdms_ticket`
+
+| 字段 | 类型建议 | 必填规则 | 说明 |
+|---|---|---|---|
+| `id` | `bigint` | 是 | 主键 |
+| `parent_id` | `bigint` | 否 | 父工单 ID；`child` 必填 |
+| `ticket_mode` | `varchar(32)` | 是 | `single` / `parent` / `child` |
+| `title` | `varchar(255)` | 是 | 工单标题 |
+| `description` | `text` | 否 | 工单描述，支持富文本 |
+| `ticket_type` | `varchar(32)` | 是 | 工单类型，字典 |
+| `priority` | `varchar(32)` | 否 | 优先级，建议复用需求优先级字典 |
+| `status_code` | `varchar(32)` | 是 | 工单状态 |
+| `submitter_id` | `bigint` | 是 | 提交人用户 ID |
+| `submitter_nickname` | `varchar(64)` | 否 | 提交人昵称快照 |
+| `owner_id` | `bigint` | `single` / `child` 必填 | 工单负责人用户 ID |
+| `owner_nickname` | `varchar(64)` | 否 | 工单负责人昵称快照 |
+| `belong_type` | `varchar(32)` | `single` / `child` 必填 | `product` / `project` |
+| `product_id` | `bigint` | 产品工单必填 | 归属产品 ID |
+| `project_id` | `bigint` | 项目工单必填 | 归属项目 ID |
+| `accept_time` | `datetime` | 否 | 受理时间 |
+| `reject_reason` | `varchar(500)` | 拒绝时必填 | 拒绝原因 |
+| `close_time` | `datetime` | 否 | 关闭时间 |
+| `close_result` | `varchar(1000)` | 手动关闭时必填 | 处理结论 |
+| `attachments` | `json` | 否 | 附件列表，沿用 `AttachmentItem` |
+
+审计字段、逻辑删除字段复用现有 `BaseDO` 风格。
+
+### 7.2 工单需求关联表
+
+建议表名：`rdms_ticket_requirement_link`
+
+| 字段 | 类型建议 | 必填规则 | 说明 |
+|---|---|---|---|
+| `id` | `bigint` | 是 | 主键 |
+| `ticket_id` | `bigint` | 是 | 工单 ID |
+| `target_type` | `varchar(32)` | 是 | `product_requirement` / `project_requirement` |
+| `target_id` | `bigint` | 是 | 需求 ID |
+
+不设置 `relationType`。本期关联表只表达“该工单派生了哪些需求”。
+
+建议唯一约束：`ticket_id + target_type + target_id`。
+
+## 8. 需求派生规则
+
+### 8.1 产品工单派生产品需求
+
+适用条件：
+
+1. `ticketMode` 为 `single` 或 `child`。
+2. `belongType = product`。
+3. 工单状态为 `processing`。
+
+派生结果：
+
+1. 创建 `ProductRequirementDO`。
+2. `productId` 使用工单 `productId`。
+3. `sourceType = "work_order"`。
+4. `sourceBizId = ticketId`。
+5. 标题、描述、优先级、附件、提出人等字段可从工单带入，并允许派生表单二次编辑。
+6. 写入 `rdms_ticket_requirement_link`，`targetType = product_requirement`。
+
+后续链路沿用现有产品需求分发到项目的能力。
+
+### 8.2 项目工单派生项目需求
+
+适用条件：
+
+1. `ticketMode` 为 `single` 或 `child`。
+2. `belongType = project`。
+3. 工单状态为 `processing`。
+
+派生结果：
+
+1. 创建 `ProjectRequirementDO`。
+2. `projectId` 使用工单 `projectId`。
+3. `sourceType = "work_order"`。
+4. `sourceBizId = ticketId`。
+5. 标题、描述、优先级、附件、提出人等字段可从工单带入，并允许派生表单二次编辑。
+6. 写入 `rdms_ticket_requirement_link`，`targetType = project_requirement`。
+
+后续执行和任务沿用现有项目需求、执行、任务链路。
+
+### 8.3 完成判定
+
+1. 产品工单只检查由该工单派生的产品需求。
+2. 项目工单只检查由该工单派生的项目需求。
+3. 需求完成态应复用现有需求状态模型的终态配置，不在工单逻辑中写死具体状态码。
+4. 派生需求数量大于 0 且全部完成时，系统自动关闭对应工单。
+
+## 9. 页面与待办
+
+### 9.1 我的提交
+
+展示当前用户提交的工单，包括：
+
+1. 父工单。
+2. 普通工单。
+3. 子工单。
+
+建议支持按状态、工单类型、归属类型、归属对象、创建时间筛选。
+
+### 9.2 我的待处理
+
+展示当前用户负责的普通工单和子工单，不展示父工单。
+
+筛选条件：
+
+1. `ownerId = 当前用户`。
+2. `ticketMode in (single, child)`。
+3. `statusCode in (pending_accept, processing)`。
+
+### 9.3 父工单列表操作
+
+工单列表查询中，父工单行需要在操作列展示“拆分子工单”入口。该入口只对父工单提交人或具备工单管理权限的用户可见。
+
+点击后进入新增子工单表单，表单需要携带父工单上下文，并要求录入人员填写子工单的归属类型、归属产品/项目、工单负责人、工单类型等处理字段。
+
+### 9.4 父工单汇总展示
+
+父工单汇总展示需要包含：
+
+1. 原始诉求信息。
+2. 子工单列表。
+3. 子工单归属产品/项目。
+4. 子工单负责人。
+5. 子工单状态。
+6. 子工单派生需求数量与完成数量。
+7. 父工单自动关闭结果。
+
+## 10. 权限规则
+
+1. 创建工单走全域权限。
+2. 父工单新增子工单：父工单提交人或具备工单管理权限的用户可操作。
+3. 普通工单 / 子工单受理、拒绝、手动关闭：工单负责人或具备工单管理权限的用户可操作。
+4. 派生产品需求时，需要满足产品对象权限。
+5. 派生项目需求时，需要满足项目对象权限。
+6. 父工单不能执行受理、拒绝、派生需求、手动关闭动作。
+
+## 11. 接口建议
+
+接口路径建议落在 `rdms-project` 模块：
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| `POST` | `/project/tickets` | 创建普通工单或父工单 |
+| `POST` | `/project/tickets/{parentId}/children` | 父工单新增子工单 |
+| `GET` | `/project/tickets/my-submitted/page` | 我的提交 |
+| `GET` | `/project/tickets/my-pending/page` | 我的待处理 |
+| `GET` | `/project/tickets/{id}` | 工单详情 |
+| `POST` | `/project/tickets/{id}/accept` | 受理 |
+| `POST` | `/project/tickets/{id}/reject` | 拒绝 |
+| `POST` | `/project/tickets/{id}/close` | 无派生需求时手动关闭 |
+| `POST` | `/project/tickets/{id}/derive-product-requirement` | 派生产品需求 |
+| `POST` | `/project/tickets/{id}/derive-project-requirement` | 派生项目需求 |
+
+创建、更新类接口需要继续遵守仓库 HTTP 动词语义约定。部分动作使用语义化 `POST` 子动作接口，不引入 `PATCH`。
+
+## 12. 校验规则
+
+1. `ticketMode = parent` 时，`ownerId`、`belongType`、`productId`、`projectId` 必须为空。
+2. `ticketMode = single` 时，`ownerId`、`belongType` 必填，且 `productId` / `projectId` 按归属类型二选一。
+3. `ticketMode = child` 时，`parentId`、`ownerId`、`belongType` 必填，且父工单必须存在且 `ticketMode = parent`。
+4. 产品工单必须填写 `productId`，不能填写 `projectId`。
+5. 项目工单必须填写 `projectId`，不能填写 `productId`。
+6. 只有 `pending_accept` 状态的普通工单 / 子工单可以受理或拒绝。
+7. 只有 `processing` 状态的普通工单 / 子工单可以派生需求。
+8. 有派生需求的工单不能手动关闭。
+9. 无派生需求的 `processing` 工单可以手动关闭，必须填写 `closeResult`。
+10. 父工单不能手动关闭。
+11. 父工单至少有一个子工单，且全部子工单终态后才能自动关闭。
+
+## 13. 错误处理
+
+建议新增明确错误码覆盖以下场景：
+
+1. 工单不存在。
+2. 工单形态非法。
+3. 父工单不能处理。
+4. 子工单父级非法。
+5. 工单归属类型非法。
+6. 产品工单不能派生项目需求。
+7. 项目工单不能派生产品需求。
+8. 工单状态不允许当前动作。
+9. 有派生需求的工单不能手动关闭。
+10. 派生需求未全部完成，工单不能自动关闭。
+
+## 14. 测试重点
+
+1. 创建父工单后状态为 `splitting`，且不能受理、拒绝、派生需求、手动关闭。
+2. 父工单可以持续新增多个子工单。
+3. 子工单必须单归属产品或项目。
+4. 普通工单 / 子工单创建后进入 `pending_accept`。
+5. 工单负责人拒绝后进入 `rejected`。
+6. 工单负责人受理后进入 `processing`。
+7. 无派生需求的 `processing` 工单可手动关闭。
+8. 有派生需求的工单不能手动关闭。
+9. 产品工单只能派生产品需求。
+10. 项目工单只能派生项目需求。
+11. 派生需求全部完成后自动关闭工单。
+12. 所有子工单终态后自动关闭父工单。
+
+## 15. 风险与约束
+
+1. 自动关闭依赖需求完成态判定，实施时必须和现有需求状态模型对齐。
+2. 产品需求分发到项目后的项目需求、执行、任务链路不属于工单直接职责，工单只追踪自己直接派生的需求。
+3. 父工单允许持续补子工单，会带来“父工单已关闭后是否允许继续补子单”的边界。本规格默认父工单关闭后不再补子单；如需重开父工单，需要单独设计重开动作。
+4. 现有前端已有 `/ticket/my-submitted`、`/ticket/my-pending` 资源入口，后端接口落地时需要与前端路由和菜单权限同步。
+
--- a/pom.xml
+++ b/pom.xml
@@ -29,6 +29,7 @@
        <spring.boot.version>3.5.9</spring.boot.version>
        <mapstruct.version>1.6.3</mapstruct.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <swagger.version>2.2.38</swagger.version>
    </properties>

    <dependencyManagement>
--- a/rdms-framework/rdms-common/pom.xml
+++ b/rdms-framework/rdms-common/pom.xml
@@ -72,7 +72,8 @@
        <!-- Swagger 注解,用于 API 文档生成(@Schema、@Operation 等) -->
        <dependency>
            <groupId>io.swagger.core.v3</groupId>
-            <artifactId>swagger-annotations</artifactId>
+            <artifactId>swagger-annotations-jakarta</artifactId>
+            <version>${swagger.version}</version>
        </dependency>

        <!-- RPC 远程调用相关 -->
@@ -180,4 +181,4 @@
        </dependency>
    </dependencies>

-</project>
+</project>
--- a/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/grey/GrayLoadBalancer.java
+++ b/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/grey/GrayLoadBalancer.java
@@ -99,7 +99,8 @@ public class GrayLoadBalancer implements ReactorServiceInstanceLoadBalancer {
            List<ServiceInstance> chooseInstances = CollectionUtils.filterList(instances, instance -> StrUtil.isEmpty(EnvUtils.getTag(instance)));
            // 【重要】补充说明：如果希望在 chooseInstances 为空时，不允许打到有 tag 的实例，可以取消注释下面的代码
            if (CollUtil.isEmpty(chooseInstances)) {
-                log.warn("[filterTagServiceInstances][serviceId({}) 没有不带 tag 的服务实例列表，直接使用所有服务实例列表]", serviceId);
+                // 本地开发场景下所有实例都带 tag（HOSTNAME），fallback 到全集属于设计内常态、请求并未失败，降级为 debug 避免噪音
+                log.debug("[filterTagServiceInstances][serviceId({}) 没有不带 tag 的服务实例列表，直接使用所有服务实例列表]", serviceId);
                chooseInstances = instances;
            }
            return chooseInstances;
@@ -108,7 +109,8 @@ public class GrayLoadBalancer implements ReactorServiceInstanceLoadBalancer {
        // 情况二，有 tag 时，使用 tag 匹配服务实例
        List<ServiceInstance> chooseInstances = CollectionUtils.filterList(instances, instance -> tag.equals(EnvUtils.getTag(instance)));
        if (CollUtil.isEmpty(chooseInstances)) {
-            log.warn("[filterTagServiceInstances][serviceId({}) 没有满足 tag({}) 的服务实例列表，直接使用所有服务实例列表]", serviceId, tag);
+            // 同上：未命中 tag 时 fallback 到全集是设计内正常路径，降级为 debug
+            log.debug("[filterTagServiceInstances][serviceId({}) 没有满足 tag({}) 的服务实例列表，直接使用所有服务实例列表]", serviceId, tag);
            chooseInstances = instances;
        }
        return chooseInstances;
--- a/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java
+++ b/rdms-gateway/src/main/java/com/njcn/rdms/gateway/filter/security/TokenAuthenticationFilter.java
@@ -14,6 +14,7 @@ import com.njcn.rdms.framework.common.util.json.JsonUtils;
 import com.njcn.rdms.gateway.util.SecurityFrameworkUtils;
 import com.njcn.rdms.gateway.util.WebFrameworkUtils;
 import com.njcn.rdms.module.system.enums.ErrorCodeConstants;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.cloud.client.loadbalancer.reactive.ReactorLoadBalancerExchangeFilterFunction;
 import org.springframework.cloud.gateway.filter.GatewayFilterChain;
 import org.springframework.cloud.gateway.filter.GlobalFilter;
@@ -25,10 +26,12 @@ import reactor.core.publisher.Mono;

 import java.time.Duration;
 import java.util.Objects;
+import java.util.Set;
 import java.util.function.Function;

 import static com.njcn.rdms.framework.common.util.cache.CacheUtils.buildAsyncReloadingCache;

+@Slf4j
@Component
 public class TokenAuthenticationFilter implements GlobalFilter, Ordered {

@@ -37,6 +40,18 @@ public class TokenAuthenticationFilter implements GlobalFilter, Ordered {

    private static final LoginUser LOGIN_USER_EMPTY = new LoginUser();

+    /**
+     * 跳过 access token 校验的路径白名单。
+     * 这些接口在 system 端标注 @PermitAll，本就不需要登录态；若前端调用时带过期 access，
+     * 网关不应在此处拦截 1002023000，否则 /refresh-token 永远走不到 system 的 1002023001 / 业务逻辑。
+     */
+    private static final Set<String> SKIP_AUTH_PATHS = Set.of(
+            "/admin-api/system/auth/login",
+            "/admin-api/system/auth/logout",
+            "/admin-api/system/auth/refresh-token",
+            "/admin-api/system/auth/register"
+    );
+
    private final WebClient webClient;

    private final LoadingCache<String, LoginUser> loginUserCache = buildAsyncReloadingCache(Duration.ofMinutes(1),
@@ -44,8 +59,16 @@ public class TokenAuthenticationFilter implements GlobalFilter, Ordered {

                @Override
                public LoginUser load(String token) {
-                    String body = checkAccessToken(token).block();
-                    return buildUser(body, token);
+                    // 仅异步 refresh 走这里（同步链路用 getIfPresent + 直接 checkAccessToken，不触发 load）
+                    // 远端 token 已过期/校验失败时吞掉 ServiceException：
+                    // 若抛出，会被 Guava 包成 ExecutionException 并由刷新线程池作为 UncaughtException 打到日志，看起来像故障。
+                    try {
+                        String body = checkAccessToken(token).block();
+                        return buildUser(body, token);
+                    } catch (ServiceException ex) {
+                        log.info("[loginUserCache] 异步刷新忽略 token 校验失败：code={}, msg={}", ex.getCode(), ex.getMessage());
+                        return LOGIN_USER_EMPTY;
+                    }
                }

            });
@@ -58,6 +81,11 @@ public class TokenAuthenticationFilter implements GlobalFilter, Ordered {
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        exchange = SecurityFrameworkUtils.removeLoginUser(exchange);

+        // 白名单路径直接放行，不做 token 校验
+        if (SKIP_AUTH_PATHS.contains(exchange.getRequest().getPath().value())) {
+            return chain.filter(exchange);
+        }
+
        String token = SecurityFrameworkUtils.obtainAuthorization(exchange);
        if (StrUtil.isEmpty(token)) {
            return chain.filter(exchange);
--- a/rdms-gateway/src/main/resources/application.yaml
+++ b/rdms-gateway/src/main/resources/application.yaml
@@ -30,6 +30,15 @@ spring:
    gateway:
      server:
        webflux:
+          # HttpClient 连接池配置：网关作为反向代理客户端，复用到下游服务的 keep-alive 连接。
+          # 必须保证 max-idle-time < 下游 server.tomcat.keep-alive-timeout（当前下游为 60s），
+          # 否则服务端先 FIN、网关池仍持有"已死连接"，复用时会抛 reactor.netty.http.client.PrematureCloseException。
+          httpclient:
+            connect-timeout: 10000           # 建立连接超时，毫秒
+            response-timeout: 30s            # 接收响应超时
+            pool:
+              max-idle-time: 30s             # 闲置连接最长保留 30s，严格小于下游 keep-alive-timeout(60s)
+              evict-in-background: 60s       # 周期后台驱逐过期连接，进一步降低 race 概率
          # 路由配置项，对应 RouteDefinition 数组
          routes:
            ## system-server 服务
--- a/rdms-project/rdms-project-api/pom.xml
+++ b/rdms-project/rdms-project-api/pom.xml
@@ -24,7 +24,8 @@
        <!-- Web 相关 -->
        <dependency>
            <groupId>io.swagger.core.v3</groupId>
-            <artifactId>swagger-annotations</artifactId>
+            <artifactId>swagger-annotations-jakarta</artifactId>
+            <version>${swagger.version}</version>
        </dependency>

        <!-- 参数校验 -->
--- a/rdms-project/rdms-project-api/src/main/java/com/njcn/rdms/module/project/enums/ErrorCodeConstants.java
+++ b/rdms-project/rdms-project-api/src/main/java/com/njcn/rdms/module/project/enums/ErrorCodeConstants.java
@@ -4,7 +4,7 @@ import com.njcn.rdms.framework.common.exception.ErrorCode;

 /**
 * Project 错误码枚举类
- *
+ * <p>
 * 产品管理当前使用 1-008-001-000 段。
 */
 public interface ErrorCodeConstants {
@@ -37,17 +37,25 @@ public interface ErrorCodeConstants {
    ErrorCode PRODUCT_INITIAL_TEAM_MANAGER_REQUIRED = new ErrorCode(1_008_001_024, "初始团队必须包含产品经理");
    ErrorCode PRODUCT_INITIAL_TEAM_MEMBER_DUPLICATE = new ErrorCode(1_008_001_025, "初始团队成员存在重复");
    ErrorCode PRODUCT_INITIAL_TEAM_ROLE_INVALID = new ErrorCode(1_008_001_026, "初始团队中存在非法角色");
+    ErrorCode PRODUCT_MANAGER_TRANSFER_TARGET_ROLE_DUPLICATE = new ErrorCode(1_008_001_027, "原产品经理在该产品已持有目标角色【{}】（含历史失效行），不能直接转交，请先清理后重试");
+    ErrorCode PRODUCT_INTERNAL_ROLE_NOT_CONFIGURED = new ErrorCode(1_008_001_028, "内置产品角色【{}】未在 system_role 找到，请联系管理员");
+    ErrorCode PRODUCT_MEMBER_USER_INVALID = new ErrorCode(1_008_001_029, "产品成员不是有效系统用户");
+    // 批量新增（POST /project/product/{id}/members/batch）专用：同一请求内 userId 重复 / 经理拦截
+    ErrorCode PRODUCT_MEMBER_BATCH_USER_DUPLICATE = new ErrorCode(1_008_001_030, "请勿在批量列表中重复添加同一成员");
+    ErrorCode PRODUCT_MEMBER_BATCH_MANAGER_NOT_ALLOWED = new ErrorCode(1_008_001_031, "批量新增不允许指定为经理，请通过编辑成员调整");
+    // 批量移出（POST /project/product/{id}/members/batch/inactive）专用：同一请求内 memberId 重复
+    ErrorCode PRODUCT_MEMBER_BATCH_INACTIVE_MEMBER_DUPLICATE = new ErrorCode(1_008_001_032, "请勿在批量移出列表中重复指定同一成员");

    // ========== 产品需求 1-008-002-000 ==========
    ErrorCode REQUIREMENT_NOT_EXISTS = new ErrorCode(1_008_002_000, "产品需求不存在");
    ErrorCode REQUIREMENT_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_002_001, "当前需求状态不支持动作【{}】");
    ErrorCode REQUIREMENT_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_002_002, "动作【{}】必须填写原因");
    ErrorCode REQUIREMENT_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_002_003, "需求状态已发生变化，请刷新后重试");
-    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_002_004, "当前需求状态为终态，不允许编辑");
+    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_002_004, "当前需求状态不允许编辑");
    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_CLOSE = new ErrorCode(1_008_002_005, "只有已验收的需求才能关闭");
    ErrorCode REQUIREMENT_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_002_006, "需求状态定义不存在或已停用");
-    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_DELETE = new ErrorCode(1_008_002_014, "只有待确认、待评审、待分流状态的需求才能删除");
-    ErrorCode REQUIREMENT_PARENT_NOT_ALLOW_SPLIT = new ErrorCode(1_008_002_007, "父需求状态不是待分流或实施中，不允许拆分");
+    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_DELETE = new ErrorCode(1_008_002_014, "只有待认领、待评审、待指派状态的需求才能删除");
+    ErrorCode REQUIREMENT_PARENT_NOT_ALLOW_SPLIT = new ErrorCode(1_008_002_007, "父需求状态不是已评审、待指派、实施中，不允许拆分");
    ErrorCode REQUIREMENT_CHILD_NOT_ALLOW_CLOSE = new ErrorCode(1_008_002_008, "存在未处理完的子需求，请先处理子需求");
    ErrorCode REQUIREMENT_CHILD_NOT_ALLOW_CANCEL = new ErrorCode(1_008_002_017, "只有不存在子需求，或子需求都处于已取消和已拒绝的状态才能取消");
    ErrorCode REQUIREMENT_HAS_CHILDREN = new ErrorCode(1_008_002_013, "存在子需求，请先删除子需求");
@@ -57,6 +65,15 @@ public interface ErrorCodeConstants {
    ErrorCode REQUIREMENT_MODULE_HAS_NON_TERMINAL_REQUIREMENTS = new ErrorCode(1_008_002_012, "模块下存在非终态需求，不可删除");
    ErrorCode REQUIREMENT_MODULE_HAS_CHILDREN = new ErrorCode(1_008_002_015, "存在子模块，请先删除子模块");
    ErrorCode REQUIREMENT_MODULE_HAS_REQUIREMENTS = new ErrorCode(1_008_002_016, "模块下存在需求，请先删除需求");
+    ErrorCode REQUIREMENT_PROJECT_MODULE_ROOT_NOT_EXISTS = new ErrorCode(1_008_002_018, "关联项目下不存在根模块，请先创建项目根模块");
+    ErrorCode REQUIREMENT_DISPATCHED_NOT_ALLOW_SPLIT = new ErrorCode(1_008_002_019, "产品需求已指派生成项目需求，不允许再在产品端拆分");
+    ErrorCode REQUIREMENT_NOT_DISPATCHED = new ErrorCode(1_008_002_020, "该产品需求尚未指派到关联项目");
+    ErrorCode REQUIREMENT_DISPATCHED_PROJECT_REQUIREMENT_NOT_FOUND = new ErrorCode(1_008_002_021, "未找到该产品需求对应的项目需求");
+    ErrorCode REQUIREMENT_HANDLER_NOT_PRODUCT_MEMBER = new ErrorCode(1_008_002_023, "当前需求负责人不是此产品团队成员，请重新选择");
+    ErrorCode REQUIREMENT_REVIEW_ALREADY_EXISTS = new ErrorCode(1_008_002_024, "该产品需求已提交评审记录");
+    ErrorCode REQUIREMENT_REVIEW_NOT_EXISTS = new ErrorCode(1_008_002_025, "产品需求评审记录不存在");
+    ErrorCode REQUIREMENT_REVIEW_CONCLUSION_INVALID = new ErrorCode(1_008_002_026, "产品需求评审结论不合法");
+    ErrorCode REQUIREMENT_NOT_PROJECT_MEMBER = new ErrorCode(1_008_002_022, "您不是该项目的成员，无权访问");

    // ========== 项目管理 1-008-002-000 ==========
    ErrorCode PROJECT_NOT_EXISTS = new ErrorCode(1_008_002_000, "项目不存在");
@@ -93,6 +110,13 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_INITIAL_TEAM_MEMBER_DUPLICATE = new ErrorCode(1_008_002_030, "初始团队成员存在重复");
    ErrorCode PROJECT_INITIAL_TEAM_ROLE_INVALID = new ErrorCode(1_008_002_031, "初始团队中存在非法角色");
    ErrorCode PROJECT_DIRECTION_NOT_MATCH_PRODUCT = new ErrorCode(1_008_002_032, "项目方向与所属产品方向不一致");
+    ErrorCode PROJECT_MANAGER_TRANSFER_TARGET_ROLE_DUPLICATE = new ErrorCode(1_008_002_033, "原项目经理在该项目已持有目标角色【{}】（含历史失效行），不能直接转交，请先清理后重试");
+    ErrorCode PROJECT_INTERNAL_ROLE_NOT_CONFIGURED = new ErrorCode(1_008_002_034, "内置项目角色【{}】未在 system_role 找到，请联系管理员");
+    // 批量新增（POST /project/project/{id}/members/batch）专用：同一请求内 userId 重复 / 经理拦截
+    ErrorCode PROJECT_MEMBER_BATCH_USER_DUPLICATE = new ErrorCode(1_008_002_035, "请勿在批量列表中重复添加同一成员");
+    ErrorCode PROJECT_MEMBER_BATCH_MANAGER_NOT_ALLOWED = new ErrorCode(1_008_002_036, "批量新增不允许指定为经理，请通过编辑成员调整");
+    // 批量移出（POST /project/project/{id}/members/batch/inactive）专用：同一请求内 memberId 重复
+    ErrorCode PROJECT_MEMBER_BATCH_INACTIVE_MEMBER_DUPLICATE = new ErrorCode(1_008_002_037, "请勿在批量移出列表中重复指定同一成员");

    // ========== 执行管理 1-008-003-000 ==========
    ErrorCode PROJECT_EXECUTION_NOT_EXISTS = new ErrorCode(1_008_003_000, "执行不存在");
@@ -102,6 +126,7 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_EXECUTION_ASSIGNEE_ALREADY_EXISTS = new ErrorCode(1_008_003_004, "该用户已是当前执行的有效协办人");
    ErrorCode PROJECT_EXECUTION_ASSIGNEE_NOT_EXISTS = new ErrorCode(1_008_003_005, "执行协办人不存在");
    ErrorCode PROJECT_EXECUTION_ASSIGNEE_NOT_ACTIVE = new ErrorCode(1_008_003_006, "当前执行协办人已失效");
+    // 保留：TD-013 解锁后业务路径已不会再触发，预留用于灰度回滚关闭关联能力
    ErrorCode PROJECT_EXECUTION_REQUIREMENT_NOT_READY = new ErrorCode(1_008_003_007, "当前阶段不支持给执行绑定项目需求");
    ErrorCode PROJECT_EXECUTION_NOT_ALLOW_EDIT = new ErrorCode(1_008_003_008, "当前项目状态不允许维护执行");
    ErrorCode PROJECT_EXECUTION_OWNER_HANDOFF_REQUIRED = new ErrorCode(1_008_003_009, "该项目成员仍担任未终态执行负责人，请先完成执行负责人交接");
@@ -114,9 +139,13 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_EXECUTION_ASSIGNEE_REQUIRED = new ErrorCode(1_008_003_016, "创建执行时必须至少选择一名执行协办人");
    ErrorCode PROJECT_EXECUTION_STATUS_OWNER_ONLY = new ErrorCode(1_008_003_017, "只有执行负责人才能执行【{}】动作");
    ErrorCode PROJECT_EXECUTION_COMPLETE_TASKS_REQUIRED = new ErrorCode(1_008_003_018, "完成执行前，执行下所有任务必须全部完成或取消");
-    ErrorCode PROJECT_EXECUTION_NOT_ALLOW_DELETE = new ErrorCode(1_008_003_019, "仅初始态（待开始）的执行允许删除");
+    ErrorCode PROJECT_EXECUTION_NOT_ALLOW_DELETE = new ErrorCode(1_008_003_019, "已完成的执行不允许删除");
    ErrorCode PROJECT_EXECUTION_DELETE_NAME_MISMATCH = new ErrorCode(1_008_003_020, "确认执行名称与实际不一致");
    ErrorCode PROJECT_EXECUTION_DELETE_CONFIRM_TEXT_INVALID = new ErrorCode(1_008_003_021, "删除确认口令必须为 DELETE 或 删除");
+    ErrorCode PROJECT_EXECUTION_PRIORITY_INVALID = new ErrorCode(1_008_003_022, "执行优先级不是有效字典值");
+    ErrorCode PROJECT_EXECUTION_REQUIREMENT_NOT_EXISTS = new ErrorCode(1_008_003_023, "关联的项目需求不存在或已删除");
+    ErrorCode PROJECT_EXECUTION_REQUIREMENT_NOT_BELONG_TO_PROJECT = new ErrorCode(1_008_003_024, "关联的项目需求不属于当前项目");
+    ErrorCode PROJECT_EXECUTION_REQUIREMENT_TERMINAL = new ErrorCode(1_008_003_025, "项目需求已处于终态，不允许关联新执行");

    // ========== 任务管理 1-008-004-000 ==========
    ErrorCode PROJECT_TASK_NOT_EXISTS = new ErrorCode(1_008_004_000, "任务不存在");
@@ -130,9 +159,10 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_TASK_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_004_008, "当前任务状态不允许维护任务");
    ErrorCode PROJECT_TASK_COMPLETE_CHILDREN_REQUIRED = new ErrorCode(1_008_004_010, "父任务完成前，子任务必须全部完成或取消");
    ErrorCode PROJECT_TASK_STATUS_OWNER_ONLY = new ErrorCode(1_008_004_011, "只有任务负责人才能执行【{}】动作");
-    ErrorCode PROJECT_TASK_NOT_ALLOW_DELETE = new ErrorCode(1_008_004_012, "仅初始态（待开始）的任务允许删除");
+    ErrorCode PROJECT_TASK_NOT_ALLOW_DELETE = new ErrorCode(1_008_004_012, "已完成的任务不允许删除");
    ErrorCode PROJECT_TASK_DELETE_NAME_MISMATCH = new ErrorCode(1_008_004_013, "确认任务名称与实际不一致");
    ErrorCode PROJECT_TASK_DELETE_CONFIRM_TEXT_INVALID = new ErrorCode(1_008_004_014, "删除确认口令必须为 DELETE 或 删除");
+    ErrorCode PROJECT_TASK_PRIORITY_INVALID = new ErrorCode(1_008_004_015, "任务优先级不是有效字典值");
    ErrorCode PROJECT_TASK_LEAF_TO_PARENT_FORBIDDEN_PROGRESS = new ErrorCode(1_008_004_012, "拆子任务前请先将父任务进度清零");
    ErrorCode PROJECT_TASK_LEAF_TO_PARENT_FORBIDDEN_WORKLOG = new ErrorCode(1_008_004_013, "拆子任务前请先删除父任务下已填的工时记录");

@@ -154,6 +184,7 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_TASK_WORKLOG_DATE_RANGE_INVALID = new ErrorCode(1_008_006_007, "段起始日期不能晚于段结束日期");
    ErrorCode PROJECT_TASK_WORKLOG_DATE_OVERLAP = new ErrorCode(1_008_006_008, "日期范围与该任务下您已有的工时记录重叠");
    ErrorCode PROJECT_TASK_WORKLOG_PROGRESS_NOT_MONOTONIC = new ErrorCode(1_008_006_010, "工时进度与日期顺序不一致：早段进度不得高于晚段、晚段进度不得低于早段");
+    ErrorCode PROJECT_TASK_WORKLOG_DIFFICULTY_INVALID = new ErrorCode(1_008_006_011, "完成难度不在字典范围内");

    // ========== 任务 / 工时附件 1_008_007_xxx ==========
    ErrorCode PROJECT_TASK_ATTACHMENT_TOO_MANY = new ErrorCode(1_008_007_001, "附件数量不能超过 {} 个");
@@ -162,4 +193,51 @@ public interface ErrorCodeConstants {
    ErrorCode PROJECT_TASK_ATTACHMENT_TYPE_NOT_ALLOWED = new ErrorCode(1_008_007_004, "附件扩展名【{}】不在允许列表内");
    ErrorCode PROJECT_TASK_ATTACHMENT_TYPE_BLOCKED = new ErrorCode(1_008_007_005, "附件类型【{}】被禁止上传");

+    // ========== 项目需求 1_008_007_xxx ==========
+    ErrorCode PROJECT_REQUIREMENT_NOT_EXISTS = new ErrorCode(1_008_007_000, "项目需求不存在");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_007_001, "当前项目需求状态不支持动作【{}】");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_007_002, "动作【{}】必须填写原因");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_007_003, "项目需求状态已发生变化，请刷新后重试");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_007_004, "当前项目需求状态不允许编辑");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_NOT_ALLOW_CLOSE = new ErrorCode(1_008_007_005, "只有已验收的项目需求才能关闭");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_007_006, "项目需求状态定义不存在或已停用");
+    ErrorCode PROJECT_REQUIREMENT_PARENT_NOT_ALLOW_SPLIT = new ErrorCode(1_008_007_007, "父需求状态不是已评审、实施中，不允许拆分");
+    ErrorCode PROJECT_REQUIREMENT_CHILD_NOT_ALLOW_CLOSE = new ErrorCode(1_008_007_008, "存在未处理完的子需求，请先处理子需求");
+    ErrorCode PROJECT_REQUIREMENT_MODULE_NOT_EXISTS = new ErrorCode(1_008_007_009, "项目需求模块不存在");
+    ErrorCode PROJECT_REQUIREMENT_MODULE_NAME_DUPLICATE = new ErrorCode(1_008_007_010, "已经存在名称为【{}】的项目需求模块");
+    ErrorCode PROJECT_REQUIREMENT_MODULE_NOT_BELONG_TO_PROJECT = new ErrorCode(1_008_007_011, "模块不属于当前项目");
+    ErrorCode PROJECT_REQUIREMENT_HAS_CHILDREN = new ErrorCode(1_008_007_013, "存在子需求，请先删除子需求");
+    ErrorCode PROJECT_REQUIREMENT_STATUS_NOT_ALLOW_DELETE = new ErrorCode(1_008_007_014, "只有待认领、待评审状态的项目需求才能删除");
+    ErrorCode PROJECT_REQUIREMENT_MODULE_HAS_CHILDREN = new ErrorCode(1_008_007_015, "存在子模块，请先删除子模块");
+    ErrorCode PROJECT_REQUIREMENT_MODULE_HAS_REQUIREMENTS = new ErrorCode(1_008_007_016, "模块下存在项目需求，请先删除需求");
+    ErrorCode PROJECT_REQUIREMENT_CHILD_NOT_ALLOW_CANCEL = new ErrorCode(1_008_007_017, "只有不存在子需求，或子需求都处于已取消和已拒绝状态时，父需求才允许取消");
+    ErrorCode PROJECT_REQUIREMENT_HAS_EXECUTIONS_NOT_ALLOW_DELETE = new ErrorCode(1_008_007_018, "该项目需求下存在承接执行，请先解绑或转移");
+    ErrorCode PROJECT_REQUIREMENT_SYNCED_FROM_PRODUCT_NOT_ALLOW_CANCEL = new ErrorCode(1_008_007_019, "从产品侧流转来的需求不可取消");
+    ErrorCode PROJECT_REQUIREMENT_REVIEW_ALREADY_EXISTS = new ErrorCode(1_008_007_020, "该项目需求已提交评审记录");
+    ErrorCode PROJECT_REQUIREMENT_REVIEW_NOT_EXISTS = new ErrorCode(1_008_007_021, "项目需求评审记录不存在");
+    ErrorCode PROJECT_REQUIREMENT_REVIEW_CONCLUSION_INVALID = new ErrorCode(1_008_007_022, "项目需求评审结论不合法");
+
+    // ========== 个人事项 1_008_008_xxx ==========
+    ErrorCode PERSONAL_ITEM_NOT_EXISTS = new ErrorCode(1_008_008_001, "个人事项不存在");
+    ErrorCode PERSONAL_ITEM_OWNER_NOT_IN_EXECUTION = new ErrorCode(1_008_008_002, "个人事项负责人必须属于当前有效执行团队成员");
+    ErrorCode PERSONAL_ITEM_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_008_003, "个人事项状态定义不存在或已停用");
+    ErrorCode PERSONAL_ITEM_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_008_004, "当前个人事项状态不支持动作【{}】");
+    ErrorCode PERSONAL_ITEM_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_008_005, "动作【{}】必须填写原因");
+    ErrorCode PERSONAL_ITEM_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_008_006, "个人事项状态已发生变化，请刷新后重试");
+    ErrorCode PERSONAL_ITEM_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_008_007, "当前个人事项状态不允许编辑");
+    ErrorCode PERSONAL_ITEM_NOT_ALLOW_DELETE = new ErrorCode(1_008_008_008, "仅初始态（待开始）的个人事项允许删除");
+    ErrorCode PERSONAL_ITEM_WRITE_FORBIDDEN = new ErrorCode(1_008_008_009, "无权修改个人事项");
+
+    // ========== 加班申请 1_008_009_xxx ==========
+    ErrorCode OVERTIME_APPLICATION_NOT_EXISTS = new ErrorCode(1_008_009_001, "加班申请不存在");
+    ErrorCode OVERTIME_APPLICATION_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_009_002, "加班申请状态定义不存在或已停用");
+    ErrorCode OVERTIME_APPLICATION_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_009_003, "当前加班申请状态不支持动作【{}】");
+    ErrorCode OVERTIME_APPLICATION_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_009_004, "动作【{}】必须填写原因");
+    ErrorCode OVERTIME_APPLICATION_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_009_005, "加班申请状态已发生变化，请刷新后重试");
+    ErrorCode OVERTIME_APPLICATION_APPLICANT_ONLY = new ErrorCode(1_008_009_006, "仅申请人可执行该操作");
+    ErrorCode OVERTIME_APPLICATION_APPROVER_ONLY = new ErrorCode(1_008_009_007, "仅当前审核人可执行该操作");
+    ErrorCode OVERTIME_APPLICATION_APPROVER_INVALID = new ErrorCode(1_008_009_008, "审核人不是有效系统用户");
+    ErrorCode OVERTIME_APPLICATION_APPROVER_SELF_FORBIDDEN = new ErrorCode(1_008_009_009, "审核人不能选择申请人本人");
+    ErrorCode OVERTIME_APPLICATION_READ_FORBIDDEN = new ErrorCode(1_008_009_010, "无权查看该加班申请");
+    ErrorCode OVERTIME_APPLICATION_DELETE_ONLY_CANCELLED = new ErrorCode(1_008_009_011, "仅已撤销的加班申请允许删除");
 }
--- a/rdms-project/rdms-project-api/src/main/java/com/njcn/rdms/module/project/enums/ProjectDictTypeConstants.java
+++ b/rdms-project/rdms-project-api/src/main/java/com/njcn/rdms/module/project/enums/ProjectDictTypeConstants.java
@@ -15,4 +15,14 @@ public interface ProjectDictTypeConstants {
     */
    String EXECUTION_TYPE = "rdms_project_execution_type";

+    /**
+     * 优先级（任务 / 执行 共用；P0=最高 ~ P3=最低）。
+     */
+    String REQ_PRIORITY = "rdms_req_priority";
+
+    /**
+     * 工时完成难度。
+     */
+    String WORKLOG_DIFFICULTY = "rdms_worklog_difficulty";
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ObjectActivityConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ObjectActivityConstants.java
@@ -71,6 +71,11 @@ public final class ObjectActivityConstants {
    public static final String MEMBER_ACTION_ADD = "add_member";
    public static final String MEMBER_ACTION_UPDATE = "update_member";
    public static final String MEMBER_ACTION_REMOVE = "remove_member";
+    /**
+     * 复活动作：原 INACTIVE 成员行被重新激活（status: 1 → 0），用于把"再次新增 / update 改 role 命中老 INACTIVE 行"路径
+     * 跟物理"新增 / 更新"的 audit 语义区分开。createXxxMember 命中 INACTIVE 三元组复活老行时使用本动作，避免 ADD 语义误用。
+     */
+    public static final String MEMBER_ACTION_REACTIVATE = "reactivate_member";
    public static final String EXECUTION_ACTION_CREATE = "create_execution_entity";
    public static final String EXECUTION_ACTION_UPDATE = "update_execution_entity";
    public static final String EXECUTION_ACTION_DELETE = "delete_execution_entity";
@@ -80,6 +85,9 @@ public final class ObjectActivityConstants {
    public static final String TASK_ACTION_CREATE = "create_task_entity";
    public static final String TASK_ACTION_UPDATE = "update_task_entity";
    public static final String TASK_ACTION_DELETE = "delete_task_entity";
+    public static final String PERSONAL_ITEM_ACTION_CREATE = "create_personal_item";
+    public static final String PERSONAL_ITEM_ACTION_UPDATE = "update_personal_item";
+    public static final String PERSONAL_ITEM_ACTION_DELETE = "delete_personal_item";

    // ========== 任务协办人事件类型（B 模型 - 多行周期记录） ==========
    public static final String TASK_ASSIGNEE_ACTION_JOIN = "join";
@@ -98,7 +106,7 @@ public final class ObjectActivityConstants {
            PRODUCT_ACTION_CREATE, PRODUCT_ACTION_CHANGE_MANAGER);

    public static final List<String> MEMBER_TIMELINE_ACTION_TYPES = List.of(
-            MEMBER_ACTION_ADD, MEMBER_ACTION_UPDATE, MEMBER_ACTION_REMOVE);
+            MEMBER_ACTION_ADD, MEMBER_ACTION_UPDATE, MEMBER_ACTION_REMOVE, MEMBER_ACTION_REACTIVATE);

    private static final Set<String> STATUS_ACTION_TYPE_SET = Set.copyOf(STATUS_ACTION_TYPES);

@@ -129,6 +137,9 @@ public final class ObjectActivityConstants {
            case TASK_ACTION_CREATE -> "创建任务";
            case TASK_ACTION_UPDATE -> "更新任务";
            case TASK_ACTION_DELETE -> "删除任务";
+            case PERSONAL_ITEM_ACTION_CREATE -> "创建个人事项";
+            case PERSONAL_ITEM_ACTION_UPDATE -> "更新个人事项";
+            case PERSONAL_ITEM_ACTION_DELETE -> "删除个人事项";
            case TASK_ASSIGNEE_ACTION_JOIN -> "加入";
            case TASK_ASSIGNEE_ACTION_INACTIVE -> "退出";
            case EXECUTION_ASSIGNEE_LOG_ACTION_OWNER_TRANSFER_IN -> "转入负责人";
@@ -145,6 +156,7 @@ public final class ObjectActivityConstants {
            case MEMBER_ACTION_ADD -> "新增成员";
            case MEMBER_ACTION_UPDATE -> "调整成员";
            case MEMBER_ACTION_REMOVE -> "移出成员";
+            case MEMBER_ACTION_REACTIVATE -> "重新激活成员";
            default -> normalizedActionType;
        };
    }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/OvertimeApplicationConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/OvertimeApplicationConstants.java
@@ -0,0 +1,38 @@
+package com.njcn.rdms.module.project.constant;
+
+/**
+ * 加班申请常量。
+ */
+public final class OvertimeApplicationConstants {
+
+    private OvertimeApplicationConstants() {
+    }
+
+    public static final String BIZ_TYPE = "overtime_application";
+    public static final String STATUS_OBJECT_TYPE = BIZ_TYPE;
+
+    public static final String STATUS_PENDING = "pending";
+    public static final String STATUS_APPROVED = "approved";
+    public static final String STATUS_REJECTED = "rejected";
+    public static final String STATUS_CANCELLED = "cancelled";
+
+    /**
+     * 新建即提交的业务日志动作。
+     * <p>
+     * 该动作仅用于状态日志、审计日志留痕，不要求在 rdms_object_status_transition 中存在显式流转配置。
+     */
+    public static final String ACTION_SUBMIT = "submit";
+    public static final String ACTION_RESUBMIT = "resubmit";
+    public static final String ACTION_APPROVE = "approve";
+    public static final String ACTION_REJECT = "reject";
+    public static final String ACTION_CANCEL = "cancel";
+    public static final String ACTION_DELETE = "delete";
+
+    public static final String PERMISSION_QUERY = "project:overtime-application:query";
+    public static final String PERMISSION_CREATE = "project:overtime-application:create";
+    public static final String PERMISSION_UPDATE = "project:overtime-application:update";
+    public static final String PERMISSION_DELETE = "project:overtime-application:delete";
+    public static final String PERMISSION_APPROVE = "project:overtime-application:approve";
+    public static final String PERMISSION_EXPORT = "project:overtime-application:export";
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/PersonalItemConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/PersonalItemConstants.java
@@ -0,0 +1,28 @@
+package com.njcn.rdms.module.project.constant;
+
+/**
+ * 个人事项常量。
+ */
+public final class PersonalItemConstants {
+
+    private PersonalItemConstants() {
+    }
+
+    /**
+     * 个人事项状态模型复用任务对象类型。
+     */
+    public static final String STATUS_OBJECT_TYPE = ProjectTaskConstants.OBJECT_TYPE;
+
+    /**
+     * 个人事项业务类型。
+     */
+    public static final String BIZ_TYPE = "personal_item";
+
+    public static final String PERMISSION_QUERY = "project:personal-item:query";
+    public static final String PERMISSION_CREATE = "project:personal-item:create";
+    public static final String PERMISSION_UPDATE = "project:personal-item:update";
+    public static final String PERMISSION_DELETE = "project:personal-item:delete";
+    public static final String PERMISSION_STATUS = "project:personal-item:status";
+
+    public static final String STATUS_COMPLETED = "completed";
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProductObjectConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProductObjectConstants.java
@@ -38,6 +38,11 @@ public final class ProductObjectConstants {
     */
    public static final String PERMISSION_STATUS = "project:product:status";

+    /**
+     * 产品需求评审权限码。
+     */
+    public static final String PERMISSION_REVIEW = "project:product:review";
+
    /**
     * 产品删除权限码。
     */
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectExecutionConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectExecutionConstants.java
@@ -20,6 +20,13 @@ public final class ProjectExecutionConstants {
     */
    public static final String BIZ_TYPE = "project_execution";

+    /**
+     * 执行读路径查询权限码（对象域，object_type='project'）。
+     * 覆盖执行对象所有读路径：page / status-board / detail。
+     * "我参与 / 所有"视角由前端发不发 involveUserId 决定；进得来 = 看项目下全部，无此权限码直接 403。
+     */
+    public static final String PERMISSION_QUERY = "project:execution:query";
+
    /**
     * 创建执行权限码。
     */
@@ -51,6 +58,12 @@ public final class ProjectExecutionConstants {
     */
    public static final String PERMISSION_DELETE = "project:execution:delete";

+    /**
+     * 执行"已完成"状态码，对应 rdms_object_status_model 中 object_type='execution' 且 status_code='completed' 的状态。
+     * 删除时拒绝主动删除（已完成的执行不允许删除）。
+     */
+    public static final String STATUS_COMPLETED = "completed";
+
    /**
     * 删除确认口令合法值集合；兼容大写英文 "DELETE" 与中文 "删除"，前端可纯中文文案。
     * 校验时精确匹配（trim 后比对）。
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectObjectConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectObjectConstants.java
@@ -55,6 +55,16 @@ public final class ProjectObjectConstants {
     */
    public static final String PERMISSION_STATUS = "project:project:status";

+    /**
+     * 项目需求评审权限码。
+     */
+    public static final String PERMISSION_REVIEW = "project:project:review";
+
+    /**
+     * 项目拆分权限码。
+     */
+    public static final String PERMISSION_SPLIT = "project:project:split";
+
    /**
     * 项目删除权限码。
     */
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectTaskConstants.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectTaskConstants.java
@@ -15,11 +15,24 @@ public final class ProjectTaskConstants {
     */
    public static final String OBJECT_TYPE = "task";

+    /**
+     * 任务"已完成"状态码，对应 rdms_object_status_model 中 object_type='task' 且 status_code='completed' 的状态。
+     * 用于 execution 的 complete 按钮可见性判定：要求根任务在排除排除集后全部为该状态。
+     */
+    public static final String STATUS_COMPLETED = "completed";
+
    /**
     * 任务业务类型。
     */
    public static final String BIZ_TYPE = "project_task";

+    /**
+     * 任务读路径查询权限码（对象域，object_type='project'）。
+     * 覆盖任务对象所有读路径：page / status-board / board-page / detail / summary（含跨执行 aggregate）。
+     * "我参与 / 所有"视角由前端发不发 involveUserId 决定；进得来 = 看项目下全部，无此权限码直接 403。
+     */
+    public static final String PERMISSION_QUERY = "project:task:query";
+
    /**
     * 创建任务权限码。
     */
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/OvertimeApplicationController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/OvertimeApplicationController.java
@@ -0,0 +1,135 @@
+package com.njcn.rdms.module.project.controller.admin.overtime;
+
+import com.njcn.rdms.framework.apilog.core.annotation.ApiAccessLog;
+import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.framework.common.pojo.PageResult;
+import com.njcn.rdms.framework.excel.core.util.ExcelUtils;
+import com.njcn.rdms.module.project.constant.OvertimeApplicationConstants;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationExportVO;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationRespVO;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationSaveReqVO;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationStatusActionReqVO;
+import com.njcn.rdms.module.project.controller.admin.overtime.vo.OvertimeApplicationStatusLogRespVO;
+import com.njcn.rdms.module.project.service.overtime.OvertimeApplicationService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.time.LocalDate;
+import java.util.List;
+
+import static com.njcn.rdms.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 加班申请")
+@RestController
+@RequestMapping("/project/overtime-applications")
+@Validated
+public class OvertimeApplicationController {
+
+    @Resource
+    private OvertimeApplicationService overtimeApplicationService;
+
+    @PostMapping
+    @Operation(summary = "新增加班申请并提交")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_CREATE + "')")
+    public CommonResult<Long> create(@Valid @RequestBody OvertimeApplicationSaveReqVO reqVO) {
+        return success(overtimeApplicationService.createApplication(reqVO));
+    }
+
+    @PutMapping("/{id}")
+    @Operation(summary = "退回或撤销后修改并重新提交加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> resubmit(@PathVariable("id") Long id,
+                                          @Valid @RequestBody OvertimeApplicationSaveReqVO reqVO) {
+        overtimeApplicationService.resubmitApplication(id, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/{id}")
+    @Operation(summary = "获取加班申请详情")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_QUERY + "')")
+    public CommonResult<OvertimeApplicationRespVO> get(@PathVariable("id") Long id) {
+        return success(overtimeApplicationService.getApplication(id));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取我的加班申请分页")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_QUERY + "')")
+    public CommonResult<PageResult<OvertimeApplicationRespVO>> page(@Valid OvertimeApplicationPageReqVO reqVO) {
+        return success(overtimeApplicationService.getMyPage(reqVO));
+    }
+
+    @GetMapping("/approval-page")
+    @Operation(summary = "获取待我审批的加班申请分页")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_APPROVE + "')")
+    public CommonResult<PageResult<OvertimeApplicationRespVO>> approvalPage(@Valid OvertimeApplicationPageReqVO reqVO) {
+        return success(overtimeApplicationService.getApprovalPage(reqVO));
+    }
+
+    @PostMapping("/{id}/approve")
+    @Operation(summary = "审核通过加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_APPROVE + "')")
+    public CommonResult<Boolean> approve(@PathVariable("id") Long id,
+                                         @Valid @RequestBody OvertimeApplicationStatusActionReqVO reqVO) {
+        overtimeApplicationService.approve(id, reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/{id}/reject")
+    @Operation(summary = "审核退回加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_APPROVE + "')")
+    public CommonResult<Boolean> reject(@PathVariable("id") Long id,
+                                        @Valid @RequestBody OvertimeApplicationStatusActionReqVO reqVO) {
+        overtimeApplicationService.reject(id, reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/{id}/cancel")
+    @Operation(summary = "撤销加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> cancel(@PathVariable("id") Long id,
+                                        @Valid @RequestBody OvertimeApplicationStatusActionReqVO reqVO) {
+        overtimeApplicationService.cancel(id, reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/{id}")
+    @Operation(summary = "删除已撤销的加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_DELETE + "')")
+    public CommonResult<Boolean> delete(@PathVariable("id") Long id) {
+        overtimeApplicationService.deleteApplication(id);
+        return success(true);
+    }
+
+    @GetMapping("/{id}/status-logs")
+    @Operation(summary = "获取加班申请状态日志")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_QUERY + "')")
+    public CommonResult<List<OvertimeApplicationStatusLogRespVO>> statusLogs(@PathVariable("id") Long id) {
+        return success(overtimeApplicationService.getStatusLogs(id));
+    }
+
+    @GetMapping("/export")
+    @Operation(summary = "导出我的加班申请")
+    @PreAuthorize("@ss.hasPermission('" + OvertimeApplicationConstants.PERMISSION_EXPORT + "')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void export(@Valid OvertimeApplicationPageReqVO reqVO, HttpServletResponse response) throws IOException {
+        List<OvertimeApplicationExportVO> list = overtimeApplicationService.getExportList(reqVO);
+        ExcelUtils.write(response, "加班申请_" + LocalDate.now() + ".xls", "加班申请",
+                OvertimeApplicationExportVO.class, list);
+    }
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationExportVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationExportVO.java
@@ -0,0 +1,40 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@ExcelIgnoreUnannotated
+public class OvertimeApplicationExportVO {
+
+    @ExcelProperty("申请人")
+    private String applicantName;
+
+    @ExcelProperty("加班日期")
+    private LocalDate overtimeDate;
+
+    @ExcelProperty("加班时长")
+    private String overtimeDuration;
+
+    @ExcelProperty("加班原因")
+    private String overtimeReason;
+
+    @ExcelProperty("加班内容")
+    private String overtimeContent;
+
+    @ExcelProperty("状态")
+    private String statusName;
+
+    @ExcelProperty("审核人")
+    private String approverName;
+
+    @ExcelProperty("提交时间")
+    private LocalDateTime submitTime;
+
+    @ExcelProperty("审核时间")
+    private LocalDateTime approvalTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationPageReqVO.java
@@ -0,0 +1,44 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY;
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 加班申请分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class OvertimeApplicationPageReqVO extends PageParam {
+
+    @Schema(description = "关键词，匹配加班原因或加班内容", example = "上线")
+    private String keyword;
+
+    @Schema(description = "申请人姓名，模糊匹配", example = "张三")
+    private String applicantName;
+
+    @Schema(description = "审核人用户编号", example = "1001")
+    private Long approverId;
+
+    @Schema(description = "审核人姓名，模糊匹配", example = "李四")
+    private String approverName;
+
+    @Schema(description = "状态编码", example = "pending")
+    @Size(max = 32, message = "状态编码长度不能超过32个字符")
+    private String statusCode;
+
+    @Schema(description = "加班日期范围", example = "[2026-06-01, 2026-06-30]")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY)
+    private LocalDate[] overtimeDate;
+
+    @Schema(description = "创建时间", example = "[2026-06-01 00:00:00, 2026-06-30 23:59:59]")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationRespVO.java
@@ -0,0 +1,66 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 加班申请 Response VO")
+@Data
+public class OvertimeApplicationRespVO {
+
+    @Schema(description = "加班申请编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "9001")
+    private Long id;
+
+    @Schema(description = "申请人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3001")
+    private Long applicantId;
+
+    @Schema(description = "申请人姓名", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    private String applicantName;
+
+    @Schema(description = "加班日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDate overtimeDate;
+
+    @Schema(description = "加班时长", requiredMode = Schema.RequiredMode.REQUIRED, example = "1天")
+    private String overtimeDuration;
+
+    @Schema(description = "加班原因", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String overtimeReason;
+
+    @Schema(description = "加班内容", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String overtimeContent;
+
+    @Schema(description = "审核人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    private Long approverId;
+
+    @Schema(description = "审核人姓名", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    private String approverName;
+
+    @Schema(description = "状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+    private String statusCode;
+
+    @Schema(description = "状态名称", example = "待审批")
+    private String statusName;
+
+    @Schema(description = "当前状态是否允许编辑", example = "false")
+    private Boolean allowEdit;
+
+    @Schema(description = "是否终态", example = "false")
+    private Boolean terminal;
+
+    @Schema(description = "最近一次审核意见")
+    private String approvalComment;
+
+    @Schema(description = "提交时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime submitTime;
+
+    @Schema(description = "最近一次审核时间")
+    private LocalDateTime approvalTime;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationSaveReqVO.java
@@ -0,0 +1,37 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - 加班申请保存 Request VO")
+@Data
+public class OvertimeApplicationSaveReqVO {
+
+    @Schema(description = "加班日期", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-06-01")
+    @NotNull(message = "加班日期不能为空")
+    private LocalDate overtimeDate;
+
+    @Schema(description = "加班时长", requiredMode = Schema.RequiredMode.REQUIRED, example = "1天")
+    @NotBlank(message = "加班时长不能为空")
+    @Size(max = 30, message = "加班时长长度不能超过30个字符")
+    private String overtimeDuration;
+
+    @Schema(description = "加班原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "版本上线保障")
+    @NotBlank(message = "加班原因不能为空")
+    @Size(max = 500, message = "加班原因长度不能超过500个字符")
+    private String overtimeReason;
+
+    @Schema(description = "加班内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "处理上线验证和问题修复")
+    @NotBlank(message = "加班内容不能为空")
+    @Size(max = 1000, message = "加班内容长度不能超过1000个字符")
+    private String overtimeContent;
+
+    @Schema(description = "审核人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @NotNull(message = "审核人不能为空")
+    private Long approverId;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationStatusActionReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationStatusActionReqVO.java
@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 加班申请状态动作 Request VO")
+@Data
+public class OvertimeApplicationStatusActionReqVO {
+
+    @Schema(description = "动作原因或审核意见。是否必填以状态机配置为准；当前退回必填，撤销选填",
+            example = "请补充加班内容")
+    @Size(max = 1000, message = "动作原因长度不能超过 1000 个字符")
+    private String reason;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationStatusLogRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/overtime/vo/OvertimeApplicationStatusLogRespVO.java
@@ -0,0 +1,51 @@
+package com.njcn.rdms.module.project.controller.admin.overtime.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 加班申请状态日志 Response VO")
+@Data
+public class OvertimeApplicationStatusLogRespVO {
+
+    @Schema(description = "日志编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long id;
+
+    @Schema(description = "加班申请编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long applicationId;
+
+    @Schema(description = "动作编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "approve")
+    private String actionType;
+
+    @Schema(description = "变更前状态", example = "pending")
+    private String fromStatus;
+
+    @Schema(description = "变更后状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "approved")
+    private String toStatus;
+
+    @Schema(description = "原因或审核意见")
+    private String reason;
+
+    @Schema(description = "操作人用户编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long operatorUserId;
+
+    @Schema(description = "操作人名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String operatorName;
+
+    @Schema(description = "申请人姓名快照", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String applicantNameSnapshot;
+
+    @Schema(description = "加班日期快照", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDate overtimeDateSnapshot;
+
+    @Schema(description = "加班时长快照", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String overtimeDurationSnapshot;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/PersonalItemController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/PersonalItemController.java
@@ -0,0 +1,160 @@
+package com.njcn.rdms.module.project.controller.admin.personal;
+
+import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.framework.common.pojo.PageResult;
+import com.njcn.rdms.module.project.constant.PersonalItemConstants;
+import com.njcn.rdms.module.project.controller.admin.personal.vo.item.PersonalItemPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.personal.vo.item.PersonalItemRespVO;
+import com.njcn.rdms.module.project.controller.admin.personal.vo.item.PersonalItemSaveReqVO;
+import com.njcn.rdms.module.project.controller.admin.personal.vo.item.PersonalItemStatusActionReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog.TaskWorklogPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog.TaskWorklogRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog.TaskWorklogSaveReqVO;
+import com.njcn.rdms.module.project.service.personal.PersonalItemService;
+import com.njcn.rdms.module.project.service.project.execution.ProjectExecutionService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 个人事项")
+@RestController
+@RequestMapping("/project/personal-items")
+@Validated
+public class PersonalItemController {
+
+    @Resource
+    private PersonalItemService personalItemService;
+    @Resource
+    private ProjectExecutionService projectExecutionService;
+
+    @PostMapping
+    @Operation(summary = "创建个人事项")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_CREATE + "')")
+    public CommonResult<Long> create(@Valid @RequestBody PersonalItemSaveReqVO reqVO) {
+        return success(personalItemService.createItem(reqVO));
+    }
+
+    @PutMapping("/{id}")
+    @Operation(summary = "更新个人事项")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> update(@PathVariable("id") Long id,
+                                        @Valid @RequestBody PersonalItemSaveReqVO reqVO) {
+        personalItemService.updateItem(id, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/{id}")
+    @Operation(summary = "获取个人事项详情")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_QUERY + "')")
+    public CommonResult<PersonalItemRespVO> get(@PathVariable("id") Long id) {
+        return success(personalItemService.getItemRespVO(id));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取个人事项分页")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_QUERY + "')")
+    public CommonResult<PageResult<PersonalItemRespVO>> page(@Valid PersonalItemPageReqVO reqVO) {
+        return success(personalItemService.getItemRespVOPage(reqVO));
+    }
+
+    @PostMapping("/{id}/change-status")
+    @Operation(summary = "变更个人事项状态")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_STATUS + "')")
+    public CommonResult<Boolean> changeStatus(@PathVariable("id") Long id,
+                                              @Valid @RequestBody PersonalItemStatusActionReqVO reqVO) {
+        personalItemService.changeStatus(id, reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/{id}/worklogs")
+    @Operation(summary = "新增个人事项工作日志")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Long> createWorklog(@PathVariable("id") Long id,
+                                            @Valid @RequestBody TaskWorklogSaveReqVO reqVO) {
+        return success(personalItemService.createWorklog(id, reqVO));
+    }
+
+    @GetMapping("/{id}/worklogs")
+    @Operation(summary = "获取个人事项工作日志分页")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_QUERY + "')")
+    public CommonResult<PageResult<TaskWorklogRespVO>> getWorklogPage(@PathVariable("id") Long id,
+                                                                      @Valid TaskWorklogPageReqVO reqVO) {
+        return success(personalItemService.getWorklogPage(id, reqVO));
+    }
+
+    @PutMapping("/{id}/worklogs/{worklogId}")
+    @Operation(summary = "修改个人事项工作日志")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> updateWorklog(@PathVariable("id") Long id,
+                                               @PathVariable("worklogId") Long worklogId,
+                                               @Valid @RequestBody TaskWorklogSaveReqVO reqVO) {
+        personalItemService.updateWorklog(id, worklogId, reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/{id}/worklogs/{worklogId}")
+    @Operation(summary = "删除个人事项工作日志")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> deleteWorklog(@PathVariable("id") Long id,
+                                               @PathVariable("worklogId") Long worklogId) {
+        personalItemService.deleteWorklog(id, worklogId);
+        return success(true);
+    }
+
+    @DeleteMapping("/{id}/worklogs/delete-list")
+    @Operation(summary = "批量删除个人事项工作日志")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> deleteWorklogs(@PathVariable("id") Long id,
+                                                @RequestParam("ids") List<Long> ids) {
+        personalItemService.deleteWorklogs(id, ids);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除个人事项")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_DELETE + "')")
+    public CommonResult<Boolean> delete(@RequestParam("id") Long id) {
+        personalItemService.deleteItem(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "批量删除个人事项")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_DELETE + "')")
+    public CommonResult<Boolean> deleteList(@RequestParam("ids") List<Long> ids) {
+        personalItemService.deleteItems(ids);
+        return success(true);
+    }
+
+    @PostMapping("/relate-execution")
+    @Operation(summary = "批量个人事项关联执行")
+    //@PreAuthorize("@ss.hasPermission('" + PersonalItemConstants.PERMISSION_UPDATE + "')")
+    public CommonResult<Boolean> relateExecution(@RequestParam("itemIds") List<Long> itemIds,
+                                                 @RequestParam("executionId") Long executionId) {
+        personalItemService.relateExecution(itemIds, executionId);
+        return success(true);
+    }
+
+    @GetMapping("/owner/all-execution")
+    @Operation(summary = "获取当前登录用户负责的所有执行")
+    public CommonResult<List<ProjectExecutionRespVO>> getCurrentUserExecutionList() {
+        return success(projectExecutionService.getCurrentUserExecutionList());
+    }
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemLifecycleActionRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemLifecycleActionRespVO.java
@@ -0,0 +1,20 @@
+package com.njcn.rdms.module.project.controller.admin.personal.vo.item;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - 个人事项生命周期动作 Response VO")
+@Data
+@NoArgsConstructor
+public class PersonalItemLifecycleActionRespVO {
+
+    @Schema(description = "动作编码", example = "complete")
+    private String actionCode;
+
+    @Schema(description = "动作名称", example = "完成")
+    private String actionName;
+
+    @Schema(description = "是否必须填写原因", example = "true")
+    private Boolean needReason;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemPageReqVO.java
@@ -0,0 +1,32 @@
+package com.njcn.rdms.module.project.controller.admin.personal.vo.item;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 个人事项分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class PersonalItemPageReqVO extends PageParam {
+
+    @Schema(description = "关键词，匹配个人事项标题", example = "沟通纪要")
+    private String keyword;
+
+    @Schema(description = "负责人用户编号；当前阶段仅支持查询本人事项", example = "3001")
+    private Long ownerId;
+
+    @Schema(description = "个人事项状态编码", example = "pending")
+    @Size(max = 32, message = "个人事项状态编码长度不能超过32个字符")
+    private String statusCode;
+
+    @Schema(description = "更新时间", example = "[2026-05-01 00:00:00, 2026-05-31 23:59:59]")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] updateTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemRespVO.java
@@ -0,0 +1,79 @@
+package com.njcn.rdms.module.project.controller.admin.personal.vo.item;
+
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - 个人事项 Response VO")
+@Data
+public class PersonalItemRespVO {
+
+    @Schema(description = "个人事项编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "9001")
+    private Long id;
+
+    @Schema(description = "个人事项标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "整理供应商沟通纪要")
+    private String taskTitle;
+
+    @Schema(description = "个人事项类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "todo")
+    private String type;
+
+    @Schema(description = "负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3001")
+    private Long ownerId;
+
+    @Schema(description = "负责人用户昵称", example = "小王")
+    private String ownerNickname;
+
+    @Schema(description = "个人事项状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+    private String statusCode;
+
+    @Schema(description = "个人事项状态名称", example = "待开始")
+    private String statusName;
+
+    @Schema(description = "是否终态", example = "false")
+    private Boolean terminal;
+
+    @Schema(description = "当前状态是否允许编辑", example = "true")
+    private Boolean allowEdit;
+
+    @Schema(description = "当前状态可执行动作")
+    private List<PersonalItemLifecycleActionRespVO> availableActions;
+
+    @Schema(description = "个人事项进度", example = "60.00")
+    private BigDecimal progressRate;
+
+    @Schema(description = "已填报工时合计（小时，0.5 颗粒）；逻辑删除的工时记录不计入。无记录默认为 0",
+            example = "8.0")
+    private BigDecimal totalSpentHours;
+
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "实际开始日期")
+    private LocalDate actualStartDate;
+
+    @Schema(description = "实际结束日期")
+    private LocalDate actualEndDate;
+
+    @Schema(description = "个人事项说明")
+    private String taskDesc;
+
+    @Schema(description = "最近一次状态动作原因")
+    private String lastStatusReason;
+
+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemSaveReqVO.java
@@ -0,0 +1,50 @@
+package com.njcn.rdms.module.project.controller.admin.personal.vo.item;
+
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+
+@Schema(description = "管理后台 - 个人事项保存 Request VO")
+@Data
+public class PersonalItemSaveReqVO {
+
+    @Schema(description = "执行编号，仅用于创建/编辑时补充执行成员合法性校验", example = "5001")
+    private Long executionId;
+
+    @Schema(description = "个人事项标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "整理供应商沟通纪要")
+    @NotBlank(message = "个人事项标题不能为空")
+    @Size(max = 300, message = "个人事项标题长度不能超过300个字符")
+    private String taskTitle;
+
+    @Schema(description = "个人事项类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "todo")
+    @NotBlank(message = "个人事项类型不能为空")
+    @Size(max = 32, message = "个人事项类型长度不能超过32个字符")
+    private String type;
+
+    @Schema(description = "个人事项进度（0~100）", example = "60.00")
+    @DecimalMin(value = "0.00", message = "个人事项进度不能小于 0")
+    @DecimalMax(value = "100.00", message = "个人事项进度不能大于 100")
+    private BigDecimal progressRate;
+
+    @Schema(description = "计划开始日期", example = "2026-05-20")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期", example = "2026-05-25")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "个人事项说明（富文本 HTML）")
+    private String taskDesc;
+
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemStatusActionReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/personal/vo/item/PersonalItemStatusActionReqVO.java
@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.personal.vo.item;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 个人事项状态动作 Request VO")
+@Data
+public class PersonalItemStatusActionReqVO {
+
+    @Schema(description = "动作编码，如 start、complete、reopen", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "complete")
+    @NotBlank(message = "动作编码不能为空")
+    @Size(max = 32, message = "动作编码长度不能超过32个字符")
+    private String actionCode;
+
+    @Schema(description = "动作原因；是否必填由状态流转配置决定", example = "事项完成")
+    @Size(max = 500, message = "动作原因长度不能超过500个字符")
+    private String reason;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductMemberController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductMemberController.java
@@ -1,6 +1,8 @@
 package com.njcn.rdms.module.project.controller.admin.product;

 import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberBatchCreateReqVO;
+import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberBatchInactiveReqVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberInactiveReqVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberRespVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberSaveReqVO;
@@ -42,6 +44,14 @@ public class ProductMemberController {
        return success(productMemberService.createProductMember(productId, reqVO));
    }

+    @PostMapping("/{id}/members/batch")
+    @Operation(summary = "批量新增产品团队成员")
+    @Parameter(name = "id", description = "产品编号", required = true, example = "1024")
+    public CommonResult<List<Long>> batchCreateProductMembers(@PathVariable("id") Long productId,
+                                                              @Valid @RequestBody ProductMemberBatchCreateReqVO reqVO) {
+        return success(productMemberService.batchCreateProductMembers(productId, reqVO));
+    }
+
    @PutMapping("/{id}/members/{memberId}")
    @Operation(summary = "调整产品团队成员角色")
    public CommonResult<Boolean> updateProductMember(@PathVariable("id") Long productId,
@@ -60,4 +70,13 @@ public class ProductMemberController {
        return success(true);
    }

+    @PostMapping("/{id}/members/batch/inactive")
+    @Operation(summary = "批量移出产品团队成员")
+    @Parameter(name = "id", description = "产品编号", required = true, example = "1024")
+    public CommonResult<Boolean> batchInactiveProductMembers(@PathVariable("id") Long productId,
+                                                             @Valid @RequestBody ProductMemberBatchInactiveReqVO reqVO) {
+        productMemberService.batchInactiveProductMembers(productId, reqVO);
+        return success(true);
+    }
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductRequirementController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductRequirementController.java
@@ -28,8 +28,6 @@ public class ProductRequirementController {
    @Resource
    private ProductRequirementService requirementService;

-    // ========== 需求管理 ==========
-
    @PostMapping("/create")
    @Operation(summary = "创建产品需求")
    public CommonResult<Long> createRequirement(@Valid @RequestBody ProductRequirementSaveReqVO createReqVO) {
@@ -59,11 +57,18 @@ public class ProductRequirementController {
    }

    @GetMapping("/tree")
-    @Operation(summary = "获取需求树形列表（分页）")
+    @Operation(summary = "获取需求树分页列表")
    public CommonResult<PageResult<ProductRequirementRespVO>> getRequirementTree(@Valid ProductRequirementPageReqVO pageReqVO) {
        return success(requirementService.getRequirementTree(pageReqVO));
    }

+    @GetMapping("/dashboard")
+    @Operation(summary = "获取产品需求概览数据")
+    @Parameter(name = "productId", description = "产品编号", required = true, example = "1024")
+    public CommonResult<ProductRequirementDashboardRespVO> getRequirementDashboard(@RequestParam("productId") Long productId) {
+        return success(requirementService.getRequirementDashboard(productId));
+    }
+
    @PostMapping("/change-status")
    @Operation(summary = "变更需求状态")
    public CommonResult<Boolean> changeRequirementStatus(@Valid @RequestBody ProductRequirementStatusActionReqVO reqVO) {
@@ -81,8 +86,6 @@ public class ProductRequirementController {
    @PostMapping("/split")
    @Operation(summary = "拆分产品需求")
    public CommonResult<Long> splitRequirement(@Valid @RequestBody ProductRequirementSplitReqVO reqVO) {
-        System.out.println("-----------------------");
-        System.out.println(reqVO);
        return success(requirementService.splitRequirement(reqVO));
    }

@@ -103,17 +106,37 @@ public class ProductRequirementController {
        return success(requirementService.getAllowedTransitions(requirementId, productId));
    }

-    @GetMapping("/lifecycle")
-    @Operation(summary = "获取需求生命周期信息")
-    @Parameter(name = "requirementId", description = "需求编号", required = true, example = "1024")
-    @Parameter(name = "productId", description = "产品编号", required = true, example = "1024")
-    public CommonResult<ProductRequirementLifecycleRespVO> getRequirementLifecycle(
-            @RequestParam("requirementId") Long requirementId,
-            @RequestParam("productId") Long productId) {
-        return success(requirementService.getRequirementLifecycle(requirementId, productId));
+    @PostMapping("/allowed-transitions/batch")
+    @Operation(summary = "批量获取需求可执行的状态动作列表")
+    public CommonResult<List<ProductRequirementAllowedTransitionBatchRespVO>> getAllowedTransitionsBatch(
+            @Valid @RequestBody ProductRequirementBatchReqVO reqVO) {
+        return success(requirementService.getAllowedTransitionsBatch(reqVO));
    }

-    // ========== 模块管理 ==========
+    @GetMapping("/has-dispatched")
+    @Operation(summary = "判断产品需求是否已分流生成项目需求")
+    @Parameter(name = "requirementId", description = "需求编号", required = true, example = "1024")
+    @Parameter(name = "productId", description = "产品编号", required = true, example = "1024")
+    public CommonResult<Boolean> hasDispatchedProjectRequirement(
+            @RequestParam("requirementId") Long requirementId,
+            @RequestParam("productId") Long productId) {
+        return success(requirementService.hasDispatchedProjectRequirement(requirementId, productId));
+    }
+
+    @PostMapping("/has-dispatched/batch")
+    @Operation(summary = "批量判断产品需求是否已分流生成项目需求")
+    public CommonResult<List<ProductRequirementHasDispatchedBatchRespVO>> hasDispatchedProjectRequirementBatch(
+            @Valid @RequestBody ProductRequirementBatchReqVO reqVO) {
+        return success(requirementService.hasDispatchedProjectRequirementBatch(reqVO));
+    }
+
+    @GetMapping("/dispatched-project-link")
+    @Operation(summary = "获取产品需求分流后对应的项目需求跳转链接")
+    @Parameter(name = "productRequirementId", description = "产品需求编号", required = true, example = "1024")
+    public CommonResult<ProductRequirementDispatchedProjectLinkRespVO> getDispatchedProjectLink(
+            @RequestParam("productRequirementId") Long productRequirementId) {
+        return success(requirementService.getDispatchedProjectLink(productRequirementId));
+    }

    @PostMapping("/module/create")
    @Operation(summary = "创建需求模块")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberBatchCreateReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberBatchCreateReqVO.java
@@ -0,0 +1,44 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 产品团队成员批量新增 Request VO")
+@Data
+public class ProductMemberBatchCreateReqVO {
+
+    /**
+     * 批量上限沿用需求约定的 200，超过走 Bean Validation 直接 400 拦截。
+     * 经理角色（product_manager）由 Service 兜底拦截，不在此体现。
+     */
+    @Schema(description = "待新增的成员列表，长度 [1, 200]", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "请至少选择一名成员")
+    @Size(max = 200, message = "单次批量加入成员不能超过 200 人")
+    @Valid
+    private List<Item> members;
+
+    @Schema(description = "批量新增成员项")
+    @Data
+    public static class Item {
+
+        @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "用户编号不能为空")
+        private Long userId;
+
+        @Schema(description = "角色编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3100000002001")
+        @NotNull(message = "角色编号不能为空")
+        private Long roleId;
+
+        @Schema(description = "备注", example = "本次批量加入")
+        @Size(max = 500, message = "备注长度不能超过500个字符")
+        private String remark;
+
+    }
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberBatchInactiveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberBatchInactiveReqVO.java
@@ -0,0 +1,27 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 产品团队成员批量移出 Request VO")
+@Data
+public class ProductMemberBatchInactiveReqVO {
+
+    /**
+     * 批量上限沿用需求约定的 200，超过走 Bean Validation 直接 400 拦截。
+     * 经理、已失效、重复 memberId 等业务规则由 Service 兜底，不在此体现。
+     */
+    @Schema(description = "待移出的成员关系 ID 列表，长度 [1, 200]", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "请至少选择一名成员")
+    @Size(max = 200, message = "单次批量移出成员不能超过 200 人")
+    private List<Long> memberIds;
+
+    @Schema(description = "移出原因，单一字符串应用于本批所有成员", example = "组织架构调整，本批成员退出当前产品团队")
+    @Size(max = 500, message = "移出原因长度不能超过500个字符")
+    private String reason;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/member/ProductMemberRespVO.java
@@ -1,9 +1,12 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.member;

 import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import lombok.Data;

 import java.time.LocalDateTime;
+import java.util.Collections;
+import java.util.List;

@Schema(description = "管理后台 - 产品团队成员 Response VO")
@Data
@@ -42,4 +45,7 @@ public class ProductMemberRespVO {
    @Schema(description = "备注", example = "当前负责需求收敛")
    private String remark;

+    @ArraySchema(schema = @Schema(description = "非主角色的中文名列表，多角色场景使用（如同人 manager + creator）；单角色时为空数组", example = "产品创建者"))
+    private List<String> additionalRoleNames = Collections.emptyList();
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductContextRoleRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductContextRoleRespVO.java
@@ -1,8 +1,12 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.product;

+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;

+import java.util.Collections;
+import java.util.List;
+
@Schema(description = "管理后台 - 产品上下文中的当前角色 Response VO")
@Data
 public class ProductContextRoleRespVO {
@@ -10,10 +14,16 @@ public class ProductContextRoleRespVO {
    @Schema(description = "对象角色编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3201")
    private Long roleId;

-    @Schema(description = "对象角色编码", example = "product_manager")
+    @Schema(description = "对象角色编码（主角色 code，权限判断兼容字段）", example = "product_manager")
    private String roleCode;

-    @Schema(description = "对象角色名称", example = "产品经理")
+    @Schema(description = "对象角色名称（主角色 name）", example = "产品经理")
    private String roleName;

+    @Schema(description = "是否游客上下文（隐式 observer 兜底时为 true）", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    private Boolean guestFlag;
+
+    @ArraySchema(schema = @Schema(description = "非主角色的中文名列表，多角色场景使用；单角色时为空数组", example = "创建者"))
+    private List<String> additionalRoleNames = Collections.emptyList();
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductCreateWithTeamReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductCreateWithTeamReqVO.java
@@ -39,4 +39,14 @@ public class ProductCreateWithTeamReqVO {
    @Valid
    private List<ProductMemberSaveReqVO> members;

+    /**
+     * 关心人 user ID 列表（创建时手动添加，可选）。
+     *
+     * <p>跟 members 是平行字段：watcher 不参与团队管理，只是被授予"产品关心人"角色（product_watcher）拿
+     * 数据可见性。允许跟 members 的 user 重叠（多角色合法）；后端按 (user, object, role) 三元组写入，
+     * 重复跳过 / INACTIVE 复活，业务侧不强校验。
+     */
+    @Schema(description = "关心人用户ID列表（可选，可与团队成员重叠）", example = "101,102")
+    private List<Long> watcherUserIds;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementAllowedTransitionBatchRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementAllowedTransitionBatchRespVO.java
@@ -0,0 +1,18 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 产品需求批量可执行动作 Response VO")
+@Data
+public class ProductRequirementAllowedTransitionBatchRespVO {
+
+    @Schema(description = "需求编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long requirementId;
+
+    @Schema(description = "可执行动作列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<ProductRequirementStatusTransitionRespVO> transitions;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementBatchReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementBatchReqVO.java
@@ -0,0 +1,22 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 产品需求批量查询 Request VO")
+@Data
+public class ProductRequirementBatchReqVO {
+
+    @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "产品编号不能为空")
+    private Long productId;
+
+    @Schema(description = "需求编号列表", requiredMode = Schema.RequiredMode.REQUIRED, example = "[1, 2, 3]")
+    @NotEmpty(message = "需求编号列表不能为空")
+    private List<Long> requirementIds;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardRecentChangeRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardRecentChangeRespVO.java
@@ -0,0 +1,42 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * 管理后台 - 产品需求概览最近变化 Response VO
+ */
+@Schema(description = "管理后台 - 产品需求概览最近变化 Response VO")
+@Data
+public class ProductRequirementDashboardRecentChangeRespVO {
+
+    @Schema(description = "前端列表唯一键", requiredMode = Schema.RequiredMode.REQUIRED, example = "requirement:create:2048")
+    private String id;
+
+    @Schema(description = "产品需求ID", example = "1003")
+    private Long requirementId;
+
+    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "补充对象首页需求池统计接口")
+    private String title;
+
+    @Schema(description = "动作类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "create")
+    private String actionType;
+
+    @Schema(description = "动作名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "需求新增")
+    private String actionLabel;
+
+    @Schema(description = "展示内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "当前状态：待评审")
+    private String content;
+
+    @Schema(description = "发生时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime occurredAt;
+
+    @Schema(description = "操作人用户ID", example = "1024")
+    private Long operatorUserId;
+
+    @Schema(description = "操作人名称快照", example = "张三")
+    private String operatorName;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardRespVO.java
@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 管理后台 - 产品需求概览 Response VO
+ */
+@Schema(description = "管理后台 - 产品需求概览 Response VO")
+@Data
+public class ProductRequirementDashboardRespVO {
+
+    @Schema(description = "需求池统计")
+    private ProductRequirementDashboardSummaryRespVO summary;
+
+    @Schema(description = "需求池最近重要变化")
+    private List<ProductRequirementDashboardRecentChangeRespVO> recentChanges;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardSummaryRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDashboardSummaryRespVO.java
@@ -0,0 +1,37 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 管理后台 - 产品需求概览统计 Response VO
+ */
+@Schema(description = "管理后台 - 产品需求概览统计 Response VO")
+@Data
+public class ProductRequirementDashboardSummaryRespVO {
+
+    @Schema(description = "需求总量，包括根需求和子需求", requiredMode = Schema.RequiredMode.REQUIRED, example = "18")
+    private Long total;
+
+    @Schema(description = "待处理需求数", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Long todo;
+
+    @Schema(description = "待认领需求数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long pendingClaim;
+
+    @Schema(description = "待评审需求数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long pendingReview;
+
+    @Schema(description = "待指派需求数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long pendingDispatch;
+
+    @Schema(description = "完成需求数，已验收和已关闭计入完成", requiredMode = Schema.RequiredMode.REQUIRED, example = "6")
+    private Long completed;
+
+    @Schema(description = "完成率，四舍五入后的百分比整数", requiredMode = Schema.RequiredMode.REQUIRED, example = "33")
+    private Integer completionRate;
+
+    @Schema(description = "高优先待处理需求数，P0/P1 且处于待处理状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Long highPriorityTodo;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDispatchedProjectLinkRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementDispatchedProjectLinkRespVO.java
@@ -0,0 +1,19 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 管理后台 - 产品需求指派后项目需求跳转链接 Response VO
+ */
+@Schema(description = "管理后台 - 产品需求指派后项目需求跳转链接 Response VO")
+@Data
+public class ProductRequirementDispatchedProjectLinkRespVO {
+
+    @Schema(description = "项目需求ID", example = "10086")
+    private Long projectRequirementId;
+
+    @Schema(description = "关联项目ID", example = "8888")
+    private Long projectId;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementHasDispatchedBatchRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementHasDispatchedBatchRespVO.java
@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 产品需求批量指派状态 Response VO")
+@Data
+public class ProductRequirementHasDispatchedBatchRespVO {
+
+    @Schema(description = "需求编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long requirementId;
+
+    @Schema(description = "是否已指派生成项目需求", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean hasDispatched;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementLifecycleRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementLifecycleRespVO.java
@@ -1,33 +0,0 @@
-package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-import lombok.Data;
-
-import java.util.List;
-
-/**
- * 管理后台 - 产品需求生命周期 Response VO
- */
-@Schema(description = "管理后台 - 产品需求生命周期 Response VO")
-@Data
-public class ProductRequirementLifecycleRespVO {
-
-    @Schema(description = "当前状态编码", example = "pending_dispatch")
-    private String statusCode;
-
-    @Schema(description = "当前状态名称", example = "待分流")
-    private String statusName;
-
-    @Schema(description = "最近一次状态动作原因", example = "评审通过")
-    private String lastStatusReason;
-
-    @Schema(description = "是否终态", example = "false")
-    private Boolean terminal;
-
-    @Schema(description = "是否允许编辑", example = "true")
-    private Boolean allowEdit;
-
-    @Schema(description = "当前状态可执行动作列表")
-    private List<ProductRequirementStatusTransitionRespVO> availableActions;
-
-}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementRespVO.java
@@ -1,8 +1,11 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;

+import com.baomidou.mybatisplus.annotation.TableField;
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;

+import java.time.LocalDate;
 import java.time.LocalDateTime;
 import java.util.List;

@@ -37,13 +40,13 @@ public class ProductRequirementRespVO {
    @Schema(description = "需求分类名称", example = "功能需求")
    private String categoryName;

-    @Schema(description = "需求来源类型，manual 表示手工新增，work_order 表示工单流转", requiredMode = Schema.RequiredMode.REQUIRED, example = "manual")
+    @Schema(description = "需求来源类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "manual")
    private String sourceType;

    @Schema(description = "来源业务ID", example = "1024")
    private Long sourceBizId;

-    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @Schema(description = "优先级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
    private Integer priority;

    @Schema(description = "优先级名称", example = "中")
@@ -52,10 +55,10 @@ public class ProductRequirementRespVO {
    @Schema(description = "当前状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending_dispatch")
    private String statusCode;

-    @Schema(description = "当前状态名称", example = "待分流")
+    @Schema(description = "当前状态名称", example = "待指派")
    private String statusName;

-    @Schema(description = "最近一次状态动作原因", example = "评审通过")
+    @Schema(description = "最近一次状态动作原因", example = "需求全部结束")
    private String lastStatusReason;

    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
@@ -64,8 +67,8 @@ public class ProductRequirementRespVO {
    @Schema(description = "提出人用户姓名", example = "张三")
    private String proposerNickname;

-    @Schema(description = "所需工时", example = "8")
-    private Double workHours;
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;

    @Schema(description = "当前处理人用户ID", example = "1024")
    private Long currentHandlerUserId;
@@ -88,10 +91,9 @@ public class ProductRequirementRespVO {
    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
    private LocalDateTime updateTime;

+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+
    @Schema(description = "子需求列表，树形结构")
    private List<ProductRequirementRespVO> children;
-
-    @Schema(description = "是否为终态，已拒绝、已取消、已关闭都算终态", example = "false")
-    private Boolean terminal;
-
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSaveReqVO.java
@@ -1,11 +1,16 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;

+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Size;
 import lombok.Data;

+import java.time.LocalDate;
+import java.util.List;
+
 /**
 * 管理后台 - 产品需求保存 Request VO
 */
@@ -29,7 +34,7 @@ public class ProductRequirementSaveReqVO {

    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
    @NotBlank(message = "需求标题不能为空")
-    @Size(max = 200, message = "需求标题长度不能超过 200 个字符")
+    @Size(max = 200, message = "需求标题长度不能超过200个字符")
    private String title;

    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
@@ -37,7 +42,7 @@ public class ProductRequirementSaveReqVO {

    @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
    @NotBlank(message = "需求分类不能为空")
-    @Size(max = 64, message = "需求分类长度不能超过 64 个字符")
+    @Size(max = 64, message = "需求分类长度不能超过64个字符")
    private String category;

    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
@@ -51,9 +56,8 @@ public class ProductRequirementSaveReqVO {
    @Schema(description = "提出人姓名", example = "张三")
    private String proposerNickname;

-    @Schema(description = "所需工时", example = "8")
-    @NotNull(message = "所需工时不能为空")
-    private Double workHours;
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;

    @Schema(description = "当前处理人用户ID", example = "1024")
    private Long currentHandlerUserId;
@@ -67,4 +71,8 @@ public class ProductRequirementSaveReqVO {
    @Schema(description = "排序值，越小越靠前", example = "0")
    private Integer sort;

+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSplitReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSplitReqVO.java
@@ -1,11 +1,16 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;

+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Size;
 import lombok.Data;

+import java.time.LocalDate;
+import java.util.List;
+
 /**
 * 管理后台 - 产品需求拆分 Request VO
 */
@@ -30,7 +35,7 @@ public class ProductRequirementSplitReqVO {

    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
    @NotBlank(message = "需求标题不能为空")
-    @Size(max = 200, message = "需求标题长度不能超过 200 个字符")
+    @Size(max = 200, message = "需求标题长度不能超过200个字符")
    private String title;

    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
@@ -38,7 +43,7 @@ public class ProductRequirementSplitReqVO {

    @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
    @NotBlank(message = "需求分类不能为空")
-    @Size(max = 64, message = "需求分类长度不能超过 64 个字符")
+    @Size(max = 64, message = "需求分类长度不能超过64个字符")
    private String category;

    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
@@ -52,9 +57,8 @@ public class ProductRequirementSplitReqVO {
    @Schema(description = "提出人姓名", example = "张三")
    private String proposerNickname;

-    @Schema(description = "所需工时", example = "8")
-    @NotNull(message = "所需工时不能为空")
-    private Double workHours;
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;

    @Schema(description = "当前处理人用户ID", example = "1024")
    private Long currentHandlerUserId;
@@ -68,4 +72,8 @@ public class ProductRequirementSplitReqVO {
    @Schema(description = "排序值，越小越靠前", example = "0")
    private Integer sort;

+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusActionReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusActionReqVO.java
@@ -27,9 +27,9 @@ public class ProductRequirementStatusActionReqVO {
    @Size(max = 32, message = "动作编码长度不能超过32个字符")
    private String actionCode;

-    @Schema(description = "状态变更原因", example = "评审通过，进入分流阶段")
+    @Schema(description = "状态变更原因", example = "需求全部完成")
    private String reason;

-    @Schema(description = "实现项目编号（dispatch动作时可选）", example = "1024")
+    @Schema(description = "关联项目编号（dispatch动作时可选）", example = "1024")
    private Long implementProjectId;
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusDictRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusDictRespVO.java
@@ -10,10 +10,10 @@ import lombok.Data;
@Data
 public class ProductRequirementStatusDictRespVO {

-    @Schema(description = "状态编码", example = "pending_confirm")
+    @Schema(description = "状态编码", example = "pending_claim")
    private String statusCode;

-    @Schema(description = "状态名称", example = "待确认")
+    @Schema(description = "状态名称", example = "待认领")
    private String statusName;

    @Schema(description = "排序值", example = "1")
@@ -25,4 +25,7 @@ public class ProductRequirementStatusDictRespVO {
    @Schema(description = "是否终态", example = "false")
    private Boolean terminalFlag;

+    @Schema(description = "是否允许编辑", example = "true")
+    private Boolean allowEdit;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusTransitionRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementStatusTransitionRespVO.java
@@ -15,7 +15,7 @@ public class ProductRequirementStatusTransitionRespVO {
    @Schema(description = "动作编码", example = "dispatch")
    private String actionCode;

-    @Schema(description = "动作名称", example = "明确分流/拆分")
+    @Schema(description = "动作名称", example = "明确指派/拆分")
    private String actionName;

    @Schema(description = "目标状态编码", example = "implementing")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementUpdateReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementUpdateReqVO.java
@@ -1,11 +1,16 @@
 package com.njcn.rdms.module.project.controller.admin.product.vo.requirement;

+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
 import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Size;
 import lombok.Data;

+import java.time.LocalDate;
+import java.util.List;
+
 /**
 * 管理后台 - 产品需求编辑 Request VO
 */
@@ -30,7 +35,7 @@ public class ProductRequirementUpdateReqVO {

    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
    @NotBlank(message = "需求标题不能为空")
-    @Size(max = 200, message = "需求标题长度不能超过 200 个字符")
+    @Size(max = 200, message = "需求标题长度不能超过200个字符")
    private String title;

    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
@@ -38,7 +43,7 @@ public class ProductRequirementUpdateReqVO {

    @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
    @NotBlank(message = "需求分类不能为空")
-    @Size(max = 64, message = "需求分类长度不能超过 64 个字符")
+    @Size(max = 64, message = "需求分类长度不能超过64个字符")
    private String category;

    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
@@ -52,9 +57,8 @@ public class ProductRequirementUpdateReqVO {
    @Schema(description = "提出人姓名", example = "张三")
    private String proposerNickname;

-    @Schema(description = "所需工时", example = "8")
-    @NotNull(message = "所需工时不能为空")
-    private Double workHours;
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;

    @Schema(description = "当前处理人用户ID", example = "1024")
    private Long currentHandlerUserId;
@@ -68,4 +72,8 @@ public class ProductRequirementUpdateReqVO {
    @Schema(description = "排序值，越小越靠前", example = "0")
    private Integer sort;

+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectMemberController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectMemberController.java
@@ -1,6 +1,8 @@
 package com.njcn.rdms.module.project.controller.admin.project;

 import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberBatchCreateReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberBatchInactiveReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberInactiveReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberRespVO;
 import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberSaveReqVO;
@@ -42,6 +44,14 @@ public class ProjectMemberController {
        return success(projectMemberService.createProjectMember(projectId, reqVO));
    }

+    @PostMapping("/{id}/members/batch")
+    @Operation(summary = "批量新增项目成员")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<List<Long>> batchCreateProjectMembers(@PathVariable("id") Long projectId,
+                                                              @Valid @RequestBody ProjectMemberBatchCreateReqVO reqVO) {
+        return success(projectMemberService.batchCreateProjectMembers(projectId, reqVO));
+    }
+
    @PutMapping("/{id}/members/{memberId}")
    @Operation(summary = "调整项目成员角色")
    public CommonResult<Boolean> updateProjectMember(@PathVariable("id") Long projectId,
@@ -60,4 +70,13 @@ public class ProjectMemberController {
        return success(true);
    }

+    @PostMapping("/{id}/members/batch/inactive")
+    @Operation(summary = "批量移出项目成员")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<Boolean> batchInactiveProjectMembers(@PathVariable("id") Long projectId,
+                                                             @Valid @RequestBody ProjectMemberBatchInactiveReqVO reqVO) {
+        projectMemberService.batchInactiveProjectMembers(projectId, reqVO);
+        return success(true);
+    }
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectRequirementController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectRequirementController.java
@@ -0,0 +1,162 @@
+package com.njcn.rdms.module.project.controller.admin.project;
+
+import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.framework.common.pojo.PageResult;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementAllowedTransitionBatchRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementBatchReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementCloseReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementDeleteReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementModuleDeleteReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementModuleReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementModuleRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementSaveReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementSplitReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementStatusActionReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementStatusDictRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementStatusTransitionRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementUpdateReqVO;
+import com.njcn.rdms.module.project.service.project.ProjectRequirementService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+/**
+ * 管理后台 - 项目需求控制器
+ */
+@Tag(name = "管理后台 - 项目需求")
+@RestController
+@RequestMapping("/project/project/requirement")
+@Validated
+public class ProjectRequirementController {
+
+    @Resource
+    private ProjectRequirementService requirementService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建项目需求")
+    public CommonResult<Long> createRequirement(@Valid @RequestBody ProjectRequirementSaveReqVO createReqVO) {
+        return success(requirementService.createRequirement(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新项目需求")
+    public CommonResult<Boolean> updateRequirement(@Valid @RequestBody ProjectRequirementUpdateReqVO updateReqVO) {
+        requirementService.updateRequirement(updateReqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获取需求详情")
+    @Parameter(name = "id", description = "需求编号", required = true, example = "1024")
+    @Parameter(name = "projectId", description = "项目编号", required = true, example = "1024")
+    public CommonResult<ProjectRequirementRespVO> getRequirement(@RequestParam("id") Long id,
+                                                                 @RequestParam("projectId") Long projectId) {
+        return success(requirementService.getRequirement(id, projectId));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取需求分页列表")
+    public CommonResult<PageResult<ProjectRequirementRespVO>> getRequirementPage(@Valid ProjectRequirementPageReqVO pageReqVO) {
+        return success(requirementService.getRequirementPage(pageReqVO));
+    }
+
+    @GetMapping("/tree")
+    @Operation(summary = "获取需求树分页列表")
+    public CommonResult<PageResult<ProjectRequirementRespVO>> getRequirementTree(@Valid ProjectRequirementPageReqVO pageReqVO) {
+        return success(requirementService.getRequirementTree(pageReqVO));
+    }
+
+    @PostMapping("/change-status")
+    @Operation(summary = "变更需求状态")
+    public CommonResult<Boolean> changeRequirementStatus(@Valid @RequestBody ProjectRequirementStatusActionReqVO reqVO) {
+        requirementService.changeRequirementStatus(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/delete")
+    @Operation(summary = "删除项目需求")
+    public CommonResult<Boolean> deleteRequirement(@Valid @RequestBody ProjectRequirementDeleteReqVO reqVO) {
+        requirementService.deleteRequirement(reqVO.getId(), reqVO.getProjectId());
+        return success(true);
+    }
+
+    @PostMapping("/split")
+    @Operation(summary = "拆分项目需求")
+    public CommonResult<Long> splitRequirement(@Valid @RequestBody ProjectRequirementSplitReqVO reqVO) {
+        return success(requirementService.splitRequirement(reqVO));
+    }
+
+    @PostMapping("/close")
+    @Operation(summary = "关闭项目需求")
+    public CommonResult<Boolean> closeRequirement(@Valid @RequestBody ProjectRequirementCloseReqVO reqVO) {
+        requirementService.closeRequirement(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/allowed-transitions")
+    @Operation(summary = "获取需求可执行的状态动作列表")
+    @Parameter(name = "requirementId", description = "需求编号", required = true, example = "1024")
+    @Parameter(name = "projectId", description = "项目编号", required = true, example = "1024")
+    public CommonResult<List<ProjectRequirementStatusTransitionRespVO>> getAllowedTransitions(
+            @RequestParam("requirementId") Long requirementId,
+            @RequestParam("projectId") Long projectId) {
+        return success(requirementService.getAllowedTransitions(requirementId, projectId));
+    }
+
+    @PostMapping("/allowed-transitions/batch")
+    @Operation(summary = "批量获取需求可执行的状态动作列表")
+    public CommonResult<List<ProjectRequirementAllowedTransitionBatchRespVO>> getAllowedTransitionsBatch(
+            @Valid @RequestBody ProjectRequirementBatchReqVO reqVO) {
+        return success(requirementService.getAllowedTransitionsBatch(reqVO));
+    }
+
+    @PostMapping("/module/create")
+    @Operation(summary = "创建需求模块")
+    public CommonResult<Long> createRequirementModule(@Valid @RequestBody ProjectRequirementModuleReqVO reqVO) {
+        return success(requirementService.createRequirementModule(reqVO));
+    }
+
+    @PutMapping("/module/update")
+    @Operation(summary = "更新需求模块")
+    public CommonResult<Boolean> updateRequirementModule(@Valid @RequestBody ProjectRequirementModuleReqVO reqVO) {
+        requirementService.updateRequirementModule(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/module/delete")
+    @Operation(summary = "删除需求模块")
+    public CommonResult<Boolean> deleteRequirementModule(@Valid @RequestBody ProjectRequirementModuleDeleteReqVO reqVO) {
+        requirementService.deleteRequirementModule(reqVO.getId(), reqVO.getProjectId());
+        return success(true);
+    }
+
+    @GetMapping("/module/tree")
+    @Operation(summary = "获取需求模块树")
+    @Parameter(name = "projectId", description = "项目编号", required = true, example = "1024")
+    public CommonResult<List<ProjectRequirementModuleRespVO>> getRequirementModuleTree(@RequestParam("projectId") Long projectId) {
+        return success(requirementService.getRequirementModuleTree(projectId));
+    }
+
+    @GetMapping("/status/dict")
+    @Operation(summary = "获取需求所有状态字典")
+    public CommonResult<List<ProjectRequirementStatusDictRespVO>> getRequirementStatusDict() {
+        return success(requirementService.getRequirementStatusDict());
+    }
+
+    @GetMapping("/status/dict/terminal")
+    @Operation(summary = "获取需求终止态状态字典")
+    public CommonResult<List<ProjectRequirementStatusDictRespVO>> getRequirementTerminalStatusDict() {
+        return success(requirementService.getRequirementTerminalStatusDict());
+    }
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/ProjectExecutionController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/ProjectExecutionController.java
@@ -1,6 +1,7 @@
 package com.njcn.rdms.module.project.controller.admin.project.execution;

 import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.framework.common.pojo.PageParam;
 import com.njcn.rdms.framework.common.pojo.PageResult;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionOwnerChangeReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionPageReqVO;
@@ -8,6 +9,7 @@ import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execut
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionStatusBoardRespVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionRespVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionCreateReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionDeletePrecheckRespVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionDeleteReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionUpdateReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionStatusActionReqVO;
@@ -20,6 +22,8 @@ import jakarta.validation.Valid;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.*;

+import java.util.List;
+
 import static com.njcn.rdms.framework.common.pojo.CommonResult.success;

@Tag(name = "管理后台 - 项目执行")
@@ -33,6 +37,7 @@ public class ProjectExecutionController {
    @Resource
    private ProjectStatusBoardService projectStatusBoardService;

+
    @PostMapping
    @Operation(summary = "创建执行")
    public CommonResult<Long> createExecution(@PathVariable("projectId") Long projectId,
@@ -61,6 +66,11 @@ public class ProjectExecutionController {
    @Operation(summary = "获取执行分页")
    public CommonResult<PageResult<ProjectExecutionRespVO>> getExecutionPage(@PathVariable("projectId") Long projectId,
                                                                             @Valid ProjectExecutionPageReqVO reqVO) {
+        // 前端用负数 pageSize 表示"查询全部"，统一归一为框架约定的 PAGE_SIZE_NONE(-1)，
+        // 走 BaseMapperX.selectPage 的不分页短路；@Max(200) 仅拦上界，负数不会被 validator 卡。
+        if (reqVO.getPageSize() != null && reqVO.getPageSize() < 0) {
+            reqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        }
        return success(projectExecutionService.getExecutionRespVOPage(projectId, reqVO));
    }

@@ -89,8 +99,16 @@ public class ProjectExecutionController {
        return success(true);
    }

+    @GetMapping("/{executionId}/delete-precheck")
+    @Operation(summary = "执行删除预检：返回下挂任务数 + 是否需要重型确认")
+    public CommonResult<ProjectExecutionDeletePrecheckRespVO> precheckDeleteExecution(
+            @PathVariable("projectId") Long projectId,
+            @PathVariable("executionId") Long executionId) {
+        return success(projectExecutionService.precheckDeleteExecution(projectId, executionId));
+    }
+
    @DeleteMapping("/{executionId}")
-    @Operation(summary = "删除执行（仅初始态可删，三重确认）")
+    @Operation(summary = "删除执行（已完成态禁止，三重确认）")
    public CommonResult<Boolean> deleteExecution(@PathVariable("projectId") Long projectId,
                                                 @PathVariable("executionId") Long executionId,
                                                 @Valid @RequestBody ProjectExecutionDeleteReqVO reqVO) {
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionCreateReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionCreateReqVO.java
@@ -29,11 +29,17 @@ public class ProjectExecutionCreateReqVO {
    @Size(max = 32, message = "执行类型长度不能超过32个字符")
    private String executionType;

+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) / 1=P1 / 2=P2 / 3=P3(最低)",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotBlank(message = "优先级不能为空")
+    @Size(max = 8, message = "优先级长度不能超过8个字符")
+    private String priority;
+
    @Schema(description = "执行负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3001")
    @NotNull(message = "执行负责人不能为空")
    private Long ownerId;

-    @Schema(description = "关联项目需求编号，第一阶段只接受空值", example = "9001")
+    @Schema(description = "关联项目需求编号，可选；不传或传 null 表示无主执行。传入值必须属于本项目且需求非终态", example = "9001")
    private Long projectRequirementId;

    @Schema(description = "计划开始日期")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionDeletePrecheckRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionDeletePrecheckRespVO.java
@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 执行删除预检 Response VO。
+ * 前端按 hasDependentData 走"简化路径 / 重型路径"分流：
+ * - false（无下挂数据） → 用户二次确认即可
+ * - true                → 弹层要求输入执行名称 + 删除口令 + 删除原因
+ */
+@Schema(description = "管理后台 - 执行删除预检 Response VO")
+@Data
+public class ProjectExecutionDeletePrecheckRespVO {
+
+    @Schema(description = "执行下任务总数（含子孙、含 completed）")
+    private Integer taskCount;
+
+    @Schema(description = "是否存在下挂数据：taskCount > 0 视为 true")
+    private Boolean hasDependentData;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionPageReqVO.java
@@ -23,15 +23,26 @@ public class ProjectExecutionPageReqVO extends PageParam {
    @Size(max = 32, message = "执行类型长度不能超过32个字符")
    private String executionType;

-    @Schema(description = "执行负责人用户编号", example = "3001")
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；与 ownerId 二选一；不传 = 项目内全部执行")
+    private Long involveUserId;
+
+    @Schema(description = "仅作为 owner 匹配（不含协办）；与 involveUserId 二选一", example = "3001")
    private Long ownerId;

    @Schema(description = "执行状态编码", example = "pending")
    @Size(max = 32, message = "执行状态编码长度不能超过32个字符")
    private String statusCode;

+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) ~ 3=P3(最低)", example = "0")
+    @Size(max = 8)
+    private String priority;
+
    @Schema(description = "更新时间", example = "[2026-04-01 00:00:00, 2026-04-30 23:59:59]")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime[] updateTime;

+    @Schema(description = "截止时间范围 chip：overdue（逾期）/ today（今天到期）/ thisWeek（本周到期）；" +
+            "基于 plannedEndDate 且排除终态执行；不传 = 不按截止时间过滤", example = "overdue")
+    private String dueRange;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionRespVO.java
@@ -18,6 +18,10 @@ public class ProjectExecutionRespVO {
    private Long projectId;
    @Schema(description = "关联项目需求编号")
    private Long projectRequirementId;
+    @Schema(description = "关联项目需求名称（service 层批量回填，避免 N+1）", example = "前端联调-需求A")
+    private String projectRequirementName;
+    @Schema(description = "关联项目需求状态编码（service 层批量回填）", example = "implementing")
+    private String projectRequirementStatusCode;
    @Schema(description = "执行名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "后端接口联调")
    private String executionName;
    @Schema(description = "执行类型", example = "feature")
@@ -30,6 +34,10 @@ public class ProjectExecutionRespVO {
    private String statusCode;
    @Schema(description = "执行状态名称", example = "待开始")
    private String statusName;
+    @Schema(description = "优先级编码（字典 rdms_req_priority），0=P0(最高) ~ 3=P3(最低)", example = "0")
+    private String priority;
+    @Schema(description = "优先级名称（字典 label，后端不填、前端按字典 cache 自译）", example = "P0")
+    private String priorityName;
    @Schema(description = "是否终态", example = "false")
    private Boolean terminal;
    @Schema(description = "当前状态是否允许编辑", example = "true")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionStatusBoardReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionStatusBoardReqVO.java
@@ -22,11 +22,18 @@ public class ProjectExecutionStatusBoardReqVO {
    @Size(max = 32, message = "执行类型长度不能超过32个字符")
    private String executionType;

-    @Schema(description = "执行负责人用户编号", example = "3001")
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；与 ownerId 二选一；不传 = 项目内全部执行")
+    private Long involveUserId;
+
+    @Schema(description = "仅作为 owner 匹配（不含协办）；与 involveUserId 二选一", example = "3001")
    private Long ownerId;

    @Schema(description = "更新时间", example = "[2026-05-01 00:00:00, 2026-05-31 23:59:59]")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime[] updateTime;

+    @Schema(description = "截止时间范围 chip：overdue（逾期）/ today（今天到期）/ thisWeek（本周到期）；" +
+            "基于 plannedEndDate 且排除终态执行；不传 = 不按截止时间过滤", example = "overdue")
+    private String dueRange;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionUpdateReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionUpdateReqVO.java
@@ -30,7 +30,13 @@ public class ProjectExecutionUpdateReqVO {
    @Size(max = 32, message = "执行类型长度不能超过32个字符")
    private String executionType;

-    @Schema(description = "关联项目需求编号，第一阶段只接受空值", example = "9001")
+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) / 1=P1 / 2=P2 / 3=P3(最低)",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotBlank(message = "优先级不能为空")
+    @Size(max = 8, message = "优先级长度不能超过8个字符")
+    private String priority;
+
+    @Schema(description = "关联项目需求编号。PUT 全字段语义：传 null=解绑，传值=更新关联。传入值必须属于本项目且需求非终态", example = "9001")
    private Long projectRequirementId;

    @Schema(description = "计划开始日期")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/ProjectTaskAggregateController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/ProjectTaskAggregateController.java
@@ -0,0 +1,66 @@
+package com.njcn.rdms.module.project.controller.admin.project.task;
+
+import com.njcn.rdms.framework.common.pojo.CommonResult;
+import com.njcn.rdms.framework.common.pojo.PageResult;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskBoardPageRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskStatusBoardRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate.ProjectTaskAggregateBoardPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate.ProjectTaskAggregatePageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate.ProjectTaskAggregateStatusBoardReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate.ProjectTaskSummaryReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate.ProjectTaskSummaryRespVO;
+import com.njcn.rdms.module.project.service.project.task.ProjectTaskAggregateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 项目级跨执行任务查询")
+@RestController
+@RequestMapping("/project/project/{projectId}/tasks")
+@Validated
+public class ProjectTaskAggregateController {
+
+    @Resource
+    private ProjectTaskAggregateService projectTaskAggregateService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获取项目级跨执行任务分页")
+    public CommonResult<PageResult<ProjectTaskRespVO>> getTaskPage(
+            @PathVariable("projectId") Long projectId,
+            @Valid ProjectTaskAggregatePageReqVO reqVO) {
+        return success(projectTaskAggregateService.getAggregateTaskPage(projectId, reqVO));
+    }
+
+    @GetMapping("/status-board")
+    @Operation(summary = "获取项目级跨执行任务状态看板")
+    public CommonResult<ProjectTaskStatusBoardRespVO> getTaskStatusBoard(
+            @PathVariable("projectId") Long projectId,
+            @Valid ProjectTaskAggregateStatusBoardReqVO reqVO) {
+        return success(projectTaskAggregateService.getAggregateTaskStatusBoard(projectId, reqVO));
+    }
+
+    @GetMapping("/board-page")
+    @Operation(summary = "获取项目级跨执行任务看板分页")
+    public CommonResult<ProjectTaskBoardPageRespVO> getTaskBoardPage(
+            @PathVariable("projectId") Long projectId,
+            @Valid ProjectTaskAggregateBoardPageReqVO reqVO) {
+        return success(projectTaskAggregateService.getAggregateTaskBoardPage(projectId, reqVO));
+    }
+
+    @GetMapping("/summary")
+    @Operation(summary = "获取项目任务今日小条（involveUserId 控制是否限定 owner / 活跃协办）")
+    public CommonResult<ProjectTaskSummaryRespVO> getTaskSummary(
+            @PathVariable("projectId") Long projectId,
+            @Valid ProjectTaskSummaryReqVO reqVO) {
+        return success(projectTaskAggregateService.getAggregateTaskSummary(projectId, reqVO));
+    }
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/ProjectTaskController.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/ProjectTaskController.java
@@ -2,6 +2,9 @@ package com.njcn.rdms.module.project.controller.admin.project.task;

 import com.njcn.rdms.framework.common.pojo.CommonResult;
 import com.njcn.rdms.framework.common.pojo.PageResult;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskBoardPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskBoardPageRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskDeletePrecheckRespVO;
 import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskDeleteReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskPageReqVO;
 import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskStatusBoardReqVO;
@@ -74,6 +77,14 @@ public class ProjectTaskController {
        return success(projectStatusBoardService.getTaskStatusBoard(projectId, executionId, reqVO));
    }

+    @GetMapping("/board-page")
+    @Operation(summary = "获取任务看板分页（按状态分列 + 每列分页 + 各列总数）")
+    public CommonResult<ProjectTaskBoardPageRespVO> getTaskBoardPage(@PathVariable("projectId") Long projectId,
+                                                                     @PathVariable("executionId") Long executionId,
+                                                                     @Valid ProjectTaskBoardPageReqVO reqVO) {
+        return success(projectStatusBoardService.getTaskBoardPage(projectId, executionId, reqVO));
+    }
+
    @PostMapping("/{taskId}/change-status")
    @Operation(summary = "变更任务状态")
    public CommonResult<Boolean> changeStatus(@PathVariable("projectId") Long projectId,
@@ -84,8 +95,17 @@ public class ProjectTaskController {
        return success(true);
    }

+    @GetMapping("/{taskId}/delete-precheck")
+    @Operation(summary = "任务删除预检：返回下挂子任务数 + 工作日志数 + 是否需要重型确认")
+    public CommonResult<ProjectTaskDeletePrecheckRespVO> precheckDeleteTask(
+            @PathVariable("projectId") Long projectId,
+            @PathVariable("executionId") Long executionId,
+            @PathVariable("taskId") Long taskId) {
+        return success(projectTaskService.precheckDeleteTask(projectId, executionId, taskId));
+    }
+
    @DeleteMapping("/{taskId}")
-    @Operation(summary = "删除任务（仅初始态可删，三重确认 + 执行 owner 硬卡）")
+    @Operation(summary = "删除任务（已完成态禁止，三重确认 + 上级 owner 硬卡）")
    public CommonResult<Boolean> deleteTask(@PathVariable("projectId") Long projectId,
                                            @PathVariable("executionId") Long executionId,
                                            @PathVariable("taskId") Long taskId,
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskBoardPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskBoardPageReqVO.java
@@ -0,0 +1,49 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+/**
+ * 看板视图任务分页 Request VO。
+ * <p>过滤口径（keyword / parentTaskId / ownerId / updateTime）与 {@link ProjectTaskPageReqVO} 严格一致；
+ * statusCode 升级为数组：缺省=返回该执行下任务状态字典的全部列；传若干个=只返回这些状态的列；
+ * 字典外的 statusCode 静默忽略。pageNo / pageSize 应用到返回的所有列（每列各自分页但页码统一）。
+ */
+@Schema(description = "管理后台 - 任务看板分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectTaskBoardPageReqVO extends PageParam {
+
+    @Schema(description = "列选择；缺省返回全部状态列，传若干个只返回这些状态的列；字典外的值静默忽略",
+            example = "[\"pending\",\"active\"]")
+    private String[] statusCode;
+
+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) ~ 3=P3(最低)", example = "0")
+    @Size(max = 8)
+    private String priority;
+
+    @Schema(description = "关键词，匹配任务标题", example = "联调")
+    private String keyword;
+
+    @Schema(description = "父任务编号", example = "9001")
+    private Long parentTaskId;
+
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；与 ownerId 二选一；不传 = 执行下全部任务")
+    private Long involveUserId;
+
+    @Schema(description = "仅作为 owner 匹配（不含协办）；与 involveUserId 二选一", example = "3002")
+    private Long ownerId;
+
+    @Schema(description = "更新时间", example = "[2026-04-01 00:00:00, 2026-04-30 23:59:59]")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] updateTime;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskBoardPageRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskBoardPageRespVO.java
@@ -0,0 +1,46 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 看板视图任务分页 Response VO。
+ * <p>每个 item 表示一列：列定义（statusCode/statusName/sort/terminal）+ 当前页切片（list）+ 该列在当前过滤条件下的总数（total）。
+ * list 元素结构与 {@link ProjectTaskRespVO} 完全一致。
+ */
+@Schema(description = "管理后台 - 任务看板分页 Response VO")
+@Data
+public class ProjectTaskBoardPageRespVO {
+
+    @Schema(description = "列数组（按 sort 升序）", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<ColumnItemVO> items;
+
+    @Schema(description = "任务看板单列分页")
+    @Data
+    public static class ColumnItemVO {
+
+        @Schema(description = "状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+        private String statusCode;
+
+        @Schema(description = "状态名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "待开始")
+        private String statusName;
+
+        @Schema(description = "排序权重（与 /status-board.items[].sort 同源）", requiredMode = Schema.RequiredMode.REQUIRED,
+                example = "10")
+        private Integer sort;
+
+        @Schema(description = "是否终态", example = "false")
+        private Boolean terminal;
+
+        @Schema(description = "该列当前页切片；元素结构与 /tasks/page 的 list 元素一致",
+                requiredMode = Schema.RequiredMode.REQUIRED)
+        private List<ProjectTaskRespVO> list;
+
+        @Schema(description = "该列在当前过滤条件下的总数", requiredMode = Schema.RequiredMode.REQUIRED, example = "12")
+        private Long total;
+
+    }
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskDeletePrecheckRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskDeletePrecheckRespVO.java
@@ -0,0 +1,22 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 任务删除预检 Response VO。
+ * 协办人不计入 hasDependentData 判定，但级联删任务时仍会被一并软删。
+ */
+@Schema(description = "管理后台 - 任务删除预检 Response VO")
+@Data
+public class ProjectTaskDeletePrecheckRespVO {
+
+    @Schema(description = "直接子任务数（不含再下层子孙——前端展示用，判定仍按递归收集后实际删的数量）")
+    private Integer childTaskCount;
+
+    @Schema(description = "工作日志条数")
+    private Integer worklogCount;
+
+    @Schema(description = "是否存在下挂数据：childTaskCount + worklogCount > 0")
+    private Boolean hasDependentData;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskPageReqVO.java
@@ -22,13 +22,20 @@ public class ProjectTaskPageReqVO extends PageParam {
    @Schema(description = "父任务编号")
    private Long parentTaskId;

-    @Schema(description = "任务负责人用户编号", example = "3002")
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；与 ownerId 二选一；不传 = 执行下全部任务")
+    private Long involveUserId;
+
+    @Schema(description = "仅作为 owner 匹配（不含协办）；与 involveUserId 二选一", example = "3002")
    private Long ownerId;

    @Schema(description = "任务状态编码", example = "pending")
    @Size(max = 32, message = "任务状态编码长度不能超过32个字符")
    private String statusCode;

+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) ~ 3=P3(最低)", example = "0")
+    @Size(max = 8)
+    private String priority;
+
    @Schema(description = "更新时间", example = "[2026-04-01 00:00:00, 2026-04-30 23:59:59]")
    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
    private LocalDateTime[] updateTime;
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskRespVO.java
@@ -21,6 +21,16 @@ public class ProjectTaskRespVO {
    private Long projectId;
    @Schema(description = "所属执行编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "5001")
    private Long executionId;
+    @Schema(description = "所属执行名称", example = "迭代 V1.0")
+    private String executionName;
+    @Schema(description = "所属执行状态码")
+    private String executionStatusCode;
+    @Schema(description = "所属执行关联的项目需求编号（service 层批量回填）")
+    private Long projectRequirementId;
+    @Schema(description = "项目需求名称（service 层批量回填，避免 N+1）", example = "前端联调-需求A")
+    private String projectRequirementName;
+    @Schema(description = "项目需求状态编码（service 层批量回填）", example = "implementing")
+    private String projectRequirementStatusCode;
    @Schema(description = "父任务编号")
    private Long parentTaskId;
    @Schema(description = "父任务负责人用户编号；一级任务为 null，子任务用于前端判断"
@@ -31,6 +41,8 @@ public class ProjectTaskRespVO {
    private Long executionOwnerId;
    @Schema(description = "任务标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "接口联调任务")
    private String taskTitle;
+    @Schema(description = "任务类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "feature")
+    private String type;
    @Schema(description = "任务负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
    private Long ownerId;
    @Schema(description = "任务负责人昵称", example = "李四")
@@ -39,6 +51,10 @@ public class ProjectTaskRespVO {
    private String statusCode;
    @Schema(description = "任务状态名称", example = "待开始")
    private String statusName;
+    @Schema(description = "优先级编码（字典 rdms_req_priority），0=P0(最高) ~ 3=P3(最低)", example = "0")
+    private String priority;
+    @Schema(description = "优先级名称（字典 label，后端不填、前端按字典 cache 自译）", example = "P0")
+    private String priorityName;
    @Schema(description = "是否终态", example = "false")
    private Boolean terminal;
    @Schema(description = "当前状态是否允许编辑", example = "true")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskSaveReqVO.java
@@ -25,6 +25,11 @@ public class ProjectTaskSaveReqVO {
    @Size(max = 300, message = "任务标题长度不能超过300个字符")
    private String taskTitle;

+    @Schema(description = "任务类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "feature")
+    @NotBlank(message = "任务类型不能为空")
+    @Size(max = 32, message = "任务类型长度不能超过32个字符")
+    private String type;
+
    @Schema(description = "任务负责人用户编号；子任务不传时继承父任务负责人", example = "3002")
    private Long ownerId;

@@ -39,6 +44,12 @@ public class ProjectTaskSaveReqVO {
    @Size(max = 200000, message = "任务说明长度不能超过200000个字符")
    private String taskDesc;

+    @Schema(description = "优先级字典 rdms_req_priority 值，0=P0(最高) / 1=P1 / 2=P2 / 3=P3(最低)",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotBlank(message = "优先级不能为空")
+    @Size(max = 8, message = "优先级长度不能超过8个字符")
+    private String priority;
+
    @Schema(description = "初始协办人用户编号列表；仅在创建任务时生效，编辑任务时静默忽略。"
            + "协办人通过独立接口管理，详见 /tasks/{id}/assignees")
    private List<Long> assigneeUserIds;
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskStatusBoardReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskStatusBoardReqVO.java
@@ -21,7 +21,10 @@ public class ProjectTaskStatusBoardReqVO {
    @Schema(description = "父任务编号", example = "9001")
    private Long parentTaskId;

-    @Schema(description = "任务负责人用户编号", example = "3002")
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；与 ownerId 二选一；不传 = 执行下全部任务")
+    private Long involveUserId;
+
+    @Schema(description = "仅作为 owner 匹配（不含协办）；与 involveUserId 二选一", example = "3002")
    private Long ownerId;

    @Schema(description = "更新时间", example = "[2026-05-01 00:00:00, 2026-05-31 23:59:59]")
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregateBoardPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregateBoardPageReqVO.java
@@ -0,0 +1,54 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 项目级跨执行任务看板分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectTaskAggregateBoardPageReqVO extends PageParam {
+
+    @Schema(description = "任务名称模糊匹配关键字")
+    private String keyword;
+
+    @Schema(description = "限定执行 id 列表;空数组 = 明确返空;不传 = 项目内全部执行")
+    private List<Long> executionIds;
+
+    @Schema(description = "限定任务所属执行的状态码多选;空数组 = 明确返空;不传 = 不按执行状态过滤")
+    private List<String> executionStatusCodes;
+
+    @Schema(description = "我参与语义;与 ownerId 二选一")
+    private Long involveUserId;
+
+    @Schema(description = "执行成员语义:该 userId 是执行 owner 或活跃执行协办;过滤其参与的执行下的任务。与 involveUserId(任务成员)正交,可同传;用户未参与任何执行时返空")
+    private Long executionInvolveUserId;
+
+    @Schema(description = "仅作为 owner 匹配;与 involveUserId 二选一")
+    private Long ownerId;
+
+    @Schema(description = "限定状态列(板上显示哪些列);空 / 不传 = 字典全状态")
+    private List<String> statusCodes;
+
+    @Schema(description = "优先级")
+    @Size(max = 8)
+    private String priority;
+
+    @Schema(description = "父任务 id")
+    private Long parentTaskId;
+
+    @Schema(description = "到期范围 chip:overdue / today / thisWeek")
+    private String dueRange;
+
+    @Schema(description = "更新时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] updateTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregatePageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregatePageReqVO.java
@@ -0,0 +1,60 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 项目级跨执行任务分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectTaskAggregatePageReqVO extends PageParam {
+
+    @Schema(description = "任务名称模糊匹配关键字")
+    private String keyword;
+
+    @Schema(description = "限定执行 id 列表;空数组 = 明确返空;不传 = 项目内全部执行")
+    private List<Long> executionIds;
+
+    @Schema(description = "限定任务所属执行的状态码多选;空数组 = 明确返空;不传 = 不按执行状态过滤")
+    private List<String> executionStatusCodes;
+
+    @Schema(description = "我参与语义:该 userId 是 owner 或活跃协办;与 ownerId 二选一")
+    private Long involveUserId;
+
+    @Schema(description = "执行成员语义:该 userId 是执行 owner 或活跃执行协办;过滤其参与的执行下的任务。与 involveUserId(任务成员)正交,可同传;用户未参与任何执行时返空")
+    private Long executionInvolveUserId;
+
+    @Schema(description = "仅作为 owner 匹配(不含协办);与 involveUserId 二选一")
+    private Long ownerId;
+
+    @Schema(description = "状态码多选;空 / 不传 = 全部")
+    private List<String> statusCodes;
+
+    @Schema(description = "优先级字典 value (0~3)")
+    @Size(max = 8)
+    private String priority;
+
+    @Schema(description = "父任务 id(限定到某父任务下)")
+    private Long parentTaskId;
+
+    @Schema(description = "到期范围 chip:overdue / today / thisWeek")
+    private String dueRange;
+
+    @Schema(description = "更新时间范围(2 长度数组)")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] updateTime;
+
+    @Schema(description = "排序字段:plannedEndDate / priority / updateTime / createTime(默认 plannedEndDate)")
+    private String sortBy;
+
+    @Schema(description = "排序方向:asc / desc(默认 asc)")
+    private String sortOrder;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregateStatusBoardReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskAggregateStatusBoardReqVO.java
@@ -0,0 +1,48 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static com.njcn.rdms.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 项目级跨执行任务状态看板 Request VO(入参同 page 去掉分页 / statusCodes / sort)")
+@Data
+public class ProjectTaskAggregateStatusBoardReqVO {
+
+    @Schema(description = "任务名称模糊匹配关键字")
+    private String keyword;
+
+    @Schema(description = "限定执行 id 列表;空数组 = 明确返空;不传 = 项目内全部执行")
+    private List<Long> executionIds;
+
+    @Schema(description = "限定任务所属执行的状态码多选;空数组 = 明确返空;不传 = 不按执行状态过滤")
+    private List<String> executionStatusCodes;
+
+    @Schema(description = "我参与语义;与 ownerId 二选一")
+    private Long involveUserId;
+
+    @Schema(description = "执行成员语义:该 userId 是执行 owner 或活跃执行协办;过滤其参与的执行下的任务。与 involveUserId(任务成员)正交,可同传;用户未参与任何执行时返空")
+    private Long executionInvolveUserId;
+
+    @Schema(description = "仅作为 owner 匹配;与 involveUserId 二选一")
+    private Long ownerId;
+
+    @Schema(description = "优先级")
+    @Size(max = 8)
+    private String priority;
+
+    @Schema(description = "父任务 id")
+    private Long parentTaskId;
+
+    @Schema(description = "到期范围 chip:overdue / today / thisWeek")
+    private String dueRange;
+
+    @Schema(description = "更新时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] updateTime;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskSummaryReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskSummaryReqVO.java
@@ -0,0 +1,16 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 项目任务今日小条 Request VO")
+@Data
+public class ProjectTaskSummaryReqVO {
+
+    /**
+     * 我参与语义：传入的 userId 是 owner 或活跃协办；不传 = 项目内全部任务。
+     * 切换"我参与 / 所有"由前端直接控制此字段是否携带，与其他读接口（page / status-board / board-page）契约一致。
+     */
+    @Schema(description = "我参与语义：该 userId 是 owner 或活跃协办；不传 = 项目内全部")
+    private Long involveUserId;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskSummaryRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/aggregate/ProjectTaskSummaryRespVO.java
@@ -0,0 +1,32 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.aggregate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - 项目任务今日小条 Response VO")
+@Data
+public class ProjectTaskSummaryRespVO {
+
+    @Schema(description = "逾期任务数:计划完成日 < 今天,且任务状态非终态")
+    private Long overdue;
+
+    @Schema(description = "今日截止任务数:计划完成日 = 今天,且任务状态非终态")
+    private Long dueToday;
+
+    @Schema(description = "本周到期任务数:计划完成日 ∈ [本周一, 本周日],且任务状态非终态(与 chip thisWeek 过滤同口径)")
+    private Long dueThisWeek;
+
+    @Schema(description = "本周已完成任务数:actualEndDate ∈ [本周一, 今天],且任务状态 = completed")
+    private Long doneThisWeek;
+
+    @Schema(description = "服务器当日(YYYY-MM-DD,Asia/Shanghai)", example = "2026-05-22")
+    private LocalDate today;
+
+    @Schema(description = "服务器本周一(YYYY-MM-DD,Asia/Shanghai)", example = "2026-05-18")
+    private LocalDate weekStart;
+
+    @Schema(description = "服务器本周日(YYYY-MM-DD,Asia/Shanghai)", example = "2026-05-24")
+    private LocalDate weekEnd;
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogPageReqVO.java
@@ -21,4 +21,8 @@ public class TaskWorklogPageReqVO extends PageParam {
    @Schema(description = "查询区间截止日期（含），按段相交过滤（record.startDate <= endDate）")
    private LocalDate endDate;

+    @Schema(description = "完成难度字典 rdms_worklog_difficulty 值；不传表示全部",
+            example = "3")
+    private String difficulty;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogRespVO.java
@@ -37,6 +37,12 @@ public class TaskWorklogRespVO {
    @Schema(description = "本次填报进度（0~100）", example = "60.00")
    private BigDecimal progressRate;

+    @Schema(description = "完成难度编码（字典 rdms_worklog_difficulty）", example = "2")
+    private String difficulty;
+
+    @Schema(description = "完成难度名称（字典 label，后端不填、前端按字典 cache 自译）", example = "一般")
+    private String difficultyName;
+
    @Schema(description = "工作内容描述")
    private String workContent;

--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogSaveReqVO.java
@@ -5,6 +5,7 @@ import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.Valid;
 import jakarta.validation.constraints.DecimalMax;
 import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Size;
 import lombok.Data;
@@ -46,6 +47,12 @@ public class TaskWorklogSaveReqVO {
    @DecimalMax(value = "100.00", message = "本次填报进度不能大于 100")
    private BigDecimal progressRate;

+    @Schema(description = "完成难度字典 rdms_worklog_difficulty 值，1=简单 / 2=一般 / 3=困难 / 4=超难",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotBlank(message = "完成难度不能为空")
+    @Size(max = 8, message = "完成难度长度不能超过 8 个字符")
+    private String difficulty;
+
    @Schema(description = "工作内容描述", example = "完成接口联调与冒烟测试")
    @Size(max = 2000, message = "工作内容长度不能超过 2000 个字符")
    private String workContent;
@@ -53,5 +60,4 @@ public class TaskWorklogSaveReqVO {
    @Schema(description = "附件列表；规则与限制详见 AttachmentValidator（数量上限、扩展名白/黑名单、URL 协议）")
    @Valid
    private List<AttachmentItem> attachments;
-
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberBatchCreateReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberBatchCreateReqVO.java
@@ -0,0 +1,44 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目成员批量新增 Request VO")
+@Data
+public class ProjectMemberBatchCreateReqVO {
+
+    /**
+     * 批量上限沿用需求约定的 200，超过走 Bean Validation 直接 400 拦截。
+     * 经理角色（project_manager）由 Service 兜底拦截，不在此体现。
+     */
+    @Schema(description = "待新增的成员列表，长度 [1, 200]", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "请至少选择一名成员")
+    @Size(max = 200, message = "单次批量加入成员不能超过 200 人")
+    @Valid
+    private List<Item> members;
+
+    @Schema(description = "批量新增成员项")
+    @Data
+    public static class Item {
+
+        @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "用户编号不能为空")
+        private Long userId;
+
+        @Schema(description = "角色编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3100000002001")
+        @NotNull(message = "角色编号不能为空")
+        private Long roleId;
+
+        @Schema(description = "备注", example = "本次批量加入")
+        @Size(max = 500, message = "备注长度不能超过500个字符")
+        private String remark;
+
+    }
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberBatchInactiveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberBatchInactiveReqVO.java
@@ -0,0 +1,27 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目成员批量移出 Request VO")
+@Data
+public class ProjectMemberBatchInactiveReqVO {
+
+    /**
+     * 批量上限沿用需求约定的 200，超过走 Bean Validation 直接 400 拦截。
+     * 经理、已失效、重复 memberId、仍担任未关闭执行负责人等业务规则由 Service 兜底，不在此体现。
+     */
+    @Schema(description = "待移出的成员关系 ID 列表，长度 [1, 200]", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "请至少选择一名成员")
+    @Size(max = 200, message = "单次批量移出成员不能超过 200 人")
+    private List<Long> memberIds;
+
+    @Schema(description = "移出原因，单一字符串应用于本批所有成员", example = "组织架构调整，本批成员退出当前项目团队")
+    @Size(max = 500, message = "移出原因长度不能超过500个字符")
+    private String reason;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberRespVO.java
@@ -1,9 +1,12 @@
 package com.njcn.rdms.module.project.controller.admin.project.vo.member;

 import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import lombok.Data;

 import java.time.LocalDateTime;
+import java.util.Collections;
+import java.util.List;

@Schema(description = "管理后台 - 项目成员 Response VO")
@Data
@@ -31,5 +34,7 @@ public class ProjectMemberRespVO {
    private LocalDateTime leftTime;
    @Schema(description = "备注", example = "当前负责需求收敛")
    private String remark;
+    @ArraySchema(schema = @Schema(description = "非主角色的中文名列表，多角色场景使用（如同人 manager + creator）；单角色时为空数组", example = "项目创建者"))
+    private List<String> additionalRoleNames = Collections.emptyList();

 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextRoleRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextRoleRespVO.java
@@ -1,19 +1,25 @@
 package com.njcn.rdms.module.project.controller.admin.project.vo.project;

+import io.swagger.v3.oas.annotations.media.ArraySchema;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;

+import java.util.Collections;
+import java.util.List;
+
@Schema(description = "管理后台 - 项目上下文中的当前角色 Response VO")
@Data
 public class ProjectContextRoleRespVO {

    @Schema(description = "对象角色编号", example = "3201")
    private Long roleId;
-    @Schema(description = "对象角色编码", example = "project_manager")
+    @Schema(description = "对象角色编码（主角色 code，权限判断兼容字段）", example = "project_manager")
    private String roleCode;
-    @Schema(description = "对象角色名称", example = "项目经理")
+    @Schema(description = "对象角色名称（主角色 name）", example = "项目经理")
    private String roleName;
    @Schema(description = "是否游客上下文", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
    private Boolean guestFlag;
+    @ArraySchema(schema = @Schema(description = "非主角色的中文名列表，多角色场景使用；单角色时为空数组", example = "创建者"))
+    private List<String> additionalRoleNames = Collections.emptyList();

 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectCreateWithTeamReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectCreateWithTeamReqVO.java
@@ -40,4 +40,14 @@ public class ProjectCreateWithTeamReqVO {
    @Valid
    private List<ProjectMemberSaveReqVO> members;

+    /**
+     * 关心人 user ID 列表（创建时手动添加，可选）。
+     *
+     * <p>跟 members 是平行字段：watcher 不参与团队管理，只是被授予"项目关心人"角色（project_watcher）拿
+     * 数据可见性。允许跟 members 的 user 重叠（多角色合法）；后端按 (user, object, role) 三元组写入，
+     * 重复跳过 / INACTIVE 复活，业务侧不强校验。
+     */
+    @Schema(description = "关心人用户ID列表（可选，可与团队成员重叠）", example = "101,102")
+    private List<Long> watcherUserIds;
+
 }
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementAllowedTransitionBatchRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementAllowedTransitionBatchRespVO.java
@@ -0,0 +1,18 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目需求批量可执行动作 Response VO")
+@Data
+public class ProjectRequirementAllowedTransitionBatchRespVO {
+
+    @Schema(description = "需求编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long requirementId;
+
+    @Schema(description = "可执行动作列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<ProjectRequirementStatusTransitionRespVO> transitions;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementBatchReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementBatchReqVO.java
@@ -0,0 +1,22 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目需求批量查询 Request VO")
+@Data
+public class ProjectRequirementBatchReqVO {
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目编号不能为空")
+    private Long projectId;
+
+    @Schema(description = "需求编号列表", requiredMode = Schema.RequiredMode.REQUIRED, example = "[1, 2, 3]")
+    @NotEmpty(message = "需求编号列表不能为空")
+    private List<Long> requirementIds;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementCloseReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementCloseReqVO.java
@@ -0,0 +1,29 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求关闭 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求关闭 Request VO")
+@Data
+public class ProjectRequirementCloseReqVO {
+
+    @Schema(description = "需求 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "需求 ID 不能为空")
+    private Long id;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目 ID 不能为空")
+    private Long projectId;
+
+    @Schema(description = "关闭原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "需求已完成验收")
+    @NotBlank(message = "关闭原因不能为空")
+    @Size(max = 255, message = "关闭原因长度不能超过 255 个字符")
+    private String reason;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementDeleteReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementDeleteReqVO.java
@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求删除 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求删除 Request VO")
+@Data
+public class ProjectRequirementDeleteReqVO {
+
+    @Schema(description = "需求 ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目 ID 不能为空")
+    private Long projectId;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleDeleteReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleDeleteReqVO.java
@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求模块删除 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求模块删除 Request VO")
+@Data
+public class ProjectRequirementModuleDeleteReqVO {
+
+    @Schema(description = "模块 ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目 ID 不能为空")
+    private Long projectId;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleReqVO.java
@@ -0,0 +1,40 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求模块保存 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求模块保存 Request VO")
+@Data
+public class ProjectRequirementModuleReqVO {
+
+    @Schema(description = "模块 ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目 ID 不能为空")
+    private Long projectId;
+
+    @Schema(description = "父模块 ID，0 表示顶级", example = "0")
+    private Long parentId;
+
+    @Schema(description = "模块名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "核心功能")
+    @NotBlank(message = "模块名称不能为空")
+    @Size(max = 100, message = "模块名称长度不能超过 100 个字符")
+    private String moduleName;
+
+    @Schema(description = "模块说明", example = "项目核心功能模块")
+    private String remark;
+
+    @Schema(description = "图标", example = "icon-function")
+    private String icon;
+
+    @Schema(description = "排序值", example = "0")
+    private Integer sort;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementModuleRespVO.java
@@ -0,0 +1,39 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 管理后台 - 项目需求模块 Response VO
+ */
+@Schema(description = "管理后台 - 项目需求模块 Response VO")
+@Data
+public class ProjectRequirementModuleRespVO {
+
+    @Schema(description = "模块 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "父模块 ID，0 表示顶级", example = "0")
+    private Long parentId;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long projectId;
+
+    @Schema(description = "模块名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "核心功能")
+    private String moduleName;
+
+    @Schema(description = "模块说明", example = "项目核心功能模块")
+    private String remark;
+
+    @Schema(description = "图标", example = "icon-function")
+    private String icon;
+
+    @Schema(description = "排序值", example = "0")
+    private Integer sort;
+
+    @Schema(description = "子模块列表")
+    private List<ProjectRequirementModuleRespVO> children;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementPageReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementPageReqVO.java
@@ -0,0 +1,48 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 管理后台 - 项目需求分页 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectRequirementPageReqVO extends PageParam {
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long projectId;
+
+    @Schema(description = "所属模块 ID", example = "1024")
+    private Long moduleId;
+
+    @Schema(description = "所属模块 ID 列表，包含子模块，用于 IN 查询", example = "[1024, 1025]")
+    private List<Long> moduleIds;
+
+    @Schema(description = "父需求 ID，查询子需求时使用", example = "1024")
+    private Long parentId;
+
+    @Schema(description = "标题关键字", example = "模块")
+    private String title;
+
+    @Schema(description = "需求分类字典值", example = "function")
+    private String category;
+
+    @Schema(description = "优先级", example = "1")
+    private Integer priority;
+
+    @Schema(description = "状态编码", example = "implementing")
+    private String statusCode;
+
+    @Schema(description = "当前处理人用户 ID", example = "1024")
+    private Long currentHandlerUserId;
+
+    @Schema(description = "来源类型", example = "manual")
+    private String sourceType;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementRespVO.java
@@ -0,0 +1,107 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 管理后台 - 项目需求 Response VO
+ */
+@Schema(description = "管理后台 - 项目需求 Response VO")
+@Data
+public class ProjectRequirementRespVO {
+
+    @Schema(description = "需求ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "父需求ID，0 表示顶级需求", example = "0")
+    private Long parentId;
+
+    @Schema(description = "所属项目ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long projectId;
+
+    @Schema(description = "所属模块ID", example = "1024")
+    private Long moduleId;
+
+    @Schema(description = "是否需要评审，0不需要，1需要", example = "0")
+    private Integer reviewRequired;
+
+    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
+    private String title;
+
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
+    private String description;
+
+    @Schema(description = "需求分类字典值", example = "function")
+    private String category;
+
+    @Schema(description = "需求分类名称", example = "功能需求")
+    private String categoryName;
+
+    @Schema(description = "需求来源类型", example = "manual")
+    private String sourceType;
+
+    @Schema(description = "来源业务ID", example = "1024")
+    private Long sourceBizId;
+
+    @Schema(description = "优先级", example = "1")
+    private Integer priority;
+
+    @Schema(description = "优先级名称", example = "中")
+    private String priorityName;
+
+    @Schema(description = "当前状态编码", example = "implementing")
+    private String statusCode;
+
+    @Schema(description = "当前状态名称", example = "实施中")
+    private String statusName;
+
+    @Schema(description = "最近一次状态动作原因", example = "需求全部结束")
+    private String lastStatusReason;
+
+    @Schema(description = "提出人用户ID", example = "1024")
+    private Long proposerId;
+
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
+    private Long currentHandlerUserId;
+
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
+    @Schema(description = "排序值", example = "0")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+
+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+
+    @Schema(description = "子需求列表，树形结构")
+    private List<ProjectRequirementRespVO> children;
+
+    @Schema(description = "是否为终态", example = "false")
+    private Boolean terminal;
+
+    @Schema(description = "需求进度（TD-016 读时聚合，service 层批量计算）。"
+            + "公式：AVG(该需求自己承接的执行进度 ∪ 直接子需求进度)，"
+            + "排除 rdms_object_status_model.progress_excluded_flag=1 的执行状态（当前为 cancelled）；"
+            + "无任何执行且无子需求时返回 0.00。两位小数，HALF_UP。",
+            example = "0.65")
+    private BigDecimal progressRate;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementSaveReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementSaveReqVO.java
@@ -0,0 +1,75 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.List;
+
+/**
+ * 管理后台 - 项目需求保存 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求保存 Request VO")
+@Data
+public class ProjectRequirementSaveReqVO {
+
+    @Schema(description = "需求ID", example = "1024")
+    private Long id;
+
+    @Schema(description = "所属项目ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目ID不能为空")
+    private Long projectId;
+
+    @Schema(description = "所属模块ID，为空时归入全部需求模块", example = "1024")
+    private Long moduleId;
+
+    @Schema(description = "是否需要评审，0不需要，1需要", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "是否需要评审不能为空")
+    private Integer reviewRequired;
+
+    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
+    @NotBlank(message = "需求标题不能为空")
+    @Size(max = 200, message = "需求标题长度不能超过200个字符")
+    private String title;
+
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
+    private String description;
+
+    @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
+    @NotBlank(message = "需求分类不能为空")
+    @Size(max = 64, message = "需求分类长度不能超过64个字符")
+    private String category;
+
+    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "优先级不能为空")
+    private Integer priority;
+
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "提出人不能为空")
+    private Long proposerId;
+
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
+    private Long currentHandlerUserId;
+
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
+    @Schema(description = "排序值，越小越靠前", example = "0")
+    private Integer sort;
+
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementSplitReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementSplitReqVO.java
@@ -0,0 +1,76 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.List;
+
+/**
+ * 管理后台 - 项目需求拆分 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求拆分 Request VO")
+@Data
+public class ProjectRequirementSplitReqVO {
+
+    @Schema(description = "父需求ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "父需求ID不能为空")
+    private Long parentId;
+
+    @Schema(description = "所属项目ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目ID不能为空")
+    private Long projectId;
+
+    @Schema(description = "所属模块ID，为空时继承父需求模块", example = "1024")
+    private Long moduleId;
+
+    @Schema(description = "是否需要评审，0不需要，1需要", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "是否需要评审不能为空")
+    private Integer reviewRequired;
+
+    @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
+    @NotBlank(message = "需求标题不能为空")
+    @Size(max = 200, message = "需求标题长度不能超过200个字符")
+    private String title;
+
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
+    private String description;
+
+    @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
+    @NotBlank(message = "需求分类不能为空")
+    @Size(max = 64, message = "需求分类长度不能超过64个字符")
+    private String category;
+
+    @Schema(description = "优先级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "优先级不能为空")
+    private Integer priority;
+
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "提出人不能为空")
+    private Long proposerId;
+
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "预期完成时间", example = "2026-05-31")
+    private LocalDate expectedTime;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
+    private Long currentHandlerUserId;
+
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
+    @Schema(description = "排序值，越小越靠前", example = "0")
+    private Integer sort;
+
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusActionReqVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusActionReqVO.java
@@ -0,0 +1,32 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求状态变更 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求状态变更 Request VO")
+@Data
+public class ProjectRequirementStatusActionReqVO {
+
+    @Schema(description = "需求 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "需求 ID 不能为空")
+    private Long id;
+
+    @Schema(description = "所属项目 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目 ID 不能为空")
+    private Long projectId;
+
+    @Schema(description = "动作编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pass_review")
+    @NotBlank(message = "动作编码不能为空")
+    @Size(max = 32, message = "动作编码长度不能超过 32 个字符")
+    private String actionCode;
+
+    @Schema(description = "状态变更原因", example = "需求全部结束")
+    private String reason;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusDictRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusDictRespVO.java
@@ -0,0 +1,31 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 管理后台 - 项目需求状态字典 Response VO
+ */
+@Schema(description = "管理后台 - 项目需求状态字典 Response VO")
+@Data
+public class ProjectRequirementStatusDictRespVO {
+
+    @Schema(description = "状态编码", example = "pending_claim")
+    private String statusCode;
+
+    @Schema(description = "状态名称", example = "待认领")
+    private String statusName;
+
+    @Schema(description = "排序值", example = "1")
+    private Integer sort;
+
+    @Schema(description = "是否初始状态", example = "true")
+    private Boolean initialFlag;
+
+    @Schema(description = "是否终态", example = "false")
+    private Boolean terminalFlag;
+
+    @Schema(description = "是否允许编辑", example = "true")
+    private Boolean allowEdit;
+
+}
--- a/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusTransitionRespVO.java
+++ b/rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusTransitionRespVO.java
@@ -0,0 +1,30 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.requirement;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * 管理后台 - 项目需求状态可执行动作 Response VO
+ */
+@Schema(description = "管理后台 - 项目需求状态可执行动作 Response VO")
+@Data
+@NoArgsConstructor
+public class ProjectRequirementStatusTransitionRespVO {
+
+    @Schema(description = "动作编码", example = "pass_review")
+    private String actionCode;
+
+    @Schema(description = "动作名称", example = "通过评审")
+    private String actionName;
+
+    @Schema(description = "目标状态编码", example = "implementing")
+    private String toStatusCode;
+
+    @Schema(description = "目标状态名称", example = "实施中")
+    private String toStatusName;
+
+    @Schema(description = "是否必须填写原因", example = "false")
+    private Boolean needReason;
+
+}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
dk	55a50eb3d5	fix(加班申请): 修复加班申请的状态机相关代码的不合理的地方。	2026-06-03 21:00:11 +08:00
caozehui	679edf08ba	fix(person-item): 权限放开	2026-06-02 09:14:40 +08:00
dk	e71140d8a2	feat(新增加班申请功能): 新增申请功能，可在工作台进行审核。 fix(dict_data): 字典数据的颜色类型字段不允许null更新。	2026-06-01 21:25:02 +08:00
hongawen	5c7dbf7286	docs(guide): 更新对象域权限文档与数据库连接配置 - 修改开发环境和本地环境的数据库连接从 rdms_v3 切换到 rdms_view - 更新 CLAUDE.md 中的对象域权限校验说明，统一在 Service 层使用 @CheckObjectPermission - 移除 ExecutionAssigneeMapper 中的废弃查询方法和相关注解 - 优化 ObjectPermissionService 中的权限码描述信息 - 新增执行查询权限常量 PERMISSION_QUERY - 重构 ProjectExecutionMapper 分页查询逻辑，使用 @Select 注解替代 LambdaQueryWrapper - 添加执行状态面板和截止时间范围过滤功能 - 在 ProjectExecutionServiceImpl 中集成对象域权限检查 - 更新状态面板服务中的权限校验注解配置	2026-05-29 16:24:09 +08:00
hongawen	9f03dc27cc	fix(security): 修复token认证过滤器异步刷新异常处理 - 添加Slf4j注解用于日志记录 - 在load方法中添加try-catch块捕获ServiceException异常 - 当远端token过期或校验失败时返回LOGIN_USER_EMPTY而不是抛出异常 - 记录token校验失败的日志信息避免被Guava包装为ExecutionException - 防止异步刷新线程将预期的验证异常作为未捕获异常打印到日志中	2026-05-26 19:11:17 +08:00
hongawen	d669d53a80	feat(project): 添加项目进度自动计算功能 - 在 ProjectMapper 中新增 updateProgressRateById 方法，支持单独更新项目进度 - 在 ProjectService 中新增 recalcProgress 接口，用于重新计算项目进度 - 实现 ProjectServiceImpl 的进度重计算逻辑，通过根任务平均进度更新项目进度 - 新增 ProjectTaskMapper 的 selectRootTaskAvgProgressByProjectId 查询方法 - 在任务创建、更新、删除、状态变更等操作后触发项目进度重计算 - 添加进度归一化处理，确保数值精度为两位小数 - 更新 CLAUDE.md 文档，加强技术风险判断要求	2026-05-25 14:17:37 +08:00
hongawen	df13a90107	feat(project): 添加项目任务跨执行聚合查询功能 - 新增 ObjectPermissionService.hasPermission 非抛模式权限检查方法 - 实现 ProjectObjectPermissionService.hasPermission 权限验证逻辑 - 为 ProductObjectPermissionService 预留空实现并添加日志警告 - 在 ProjectExecutionController 中支持负数 pageSize 查询全部功能 - 添加 ProjectTaskConstants.PERMISSION_LIST_ALL 权限码常量定义 - 扩展 ProjectTaskMapper 支持跨执行聚合分页、状态统计和摘要查询 - 更新 ProjectTaskRespVO 包含执行名称和状态码字段 - 实现 ProjectTaskService.assembleTaskRespVOPageCrossExecution 跨执行装配方法 - 优化任务服务中的执行信息批量回填和生命周期应用逻辑 - 统一使用服务器时区 Asia/Shanghai 处理日期时间操作 - 为 .claude 设置添加新的代码搜索和分析命令	2026-05-23 14:18:15 +08:00
hongawen	8a36b49128	feat(project): 添加项目任务跨执行聚合查询功能 - 新增 ObjectPermissionService.hasPermission 非抛模式权限检查方法 - 实现 ProjectObjectPermissionService.hasPermission 权限验证逻辑 - 为 ProductObjectPermissionService 预留空实现并添加日志警告 - 在 ProjectExecutionController 中支持负数 pageSize 查询全部功能 - 添加 ProjectTaskConstants.PERMISSION_LIST_ALL 权限码常量定义 - 扩展 ProjectTaskMapper 支持跨执行聚合分页、状态统计和摘要查询 - 更新 ProjectTaskRespVO 包含执行名称和状态码字段 - 实现 ProjectTaskService.assembleTaskRespVOPageCrossExecution 跨执行装配方法 - 优化任务服务中的执行信息批量回填和生命周期应用逻辑 - 统一使用服务器时区 Asia/Shanghai 处理日期时间操作 - 为 .claude 设置添加新的代码搜索和分析命令	2026-05-23 14:18:04 +08:00
dk	c9549bed46	feat(新增需求评审功能): 新增需求评审功能。 fix(产品需求、项目需求): 按照会议意见修改诸多细节。 fix(产品对象域的概览界面): 提供相应接口给前端。	2026-05-22 13:52:29 +08:00
dk	5caf3bbdc9	Merge branch 'main' of http://192.168.1.22:3000/Microservice/cn-rdms	2026-05-22 13:51:17 +08:00
caozehui	9e4f8becc8	docs(ticket): update child split entry	2026-05-22 13:46:01 +08:00
dk	58eed8234a	feat(新增需求评审功能): 新增需求评审功能。 fix(产品需求、项目需求): 按照会议意见修改诸多细节。 fix(产品对象域的概览界面): 提供相应接口给前端。	2026-05-22 13:45:24 +08:00
caozehui	b4e9685344	docs(ticket): add ticket design spec	2026-05-22 13:36:58 +08:00
caozehui	2ad9a4e206	fix(dict): 添加字典类型参量	2026-05-22 10:02:58 +08:00
hongawen	fd637ae604	chore(git): 添加 Claude Code 本地工作区到忽略列表 - 在 .gitignore 中新增 .claude/ 目录 - 防止本地工作区文件被提交到仓库 - 保持仓库整洁避免临时文件污染	2026-05-21 21:19:55 +08:00
hongawen	1bee5eb05b	fix(project): 修复项目执行管理中的多项问题并优化字典数据功能 - 修复字典数据分页接口命名错误，从 getDictTypePage 改为 getDictDataPage - 修复字典数据查询排序逻辑，从 orderByDesc 改为 orderByAsc 并增加 id 排序 - 更新字典数据分页请求参数验证，将 dictType 设为必填项并添加非空验证 - 在字典数据简单响应对象中添加备注字段 - 修复项目执行删除权限验证，允许非初始态执行删除但阻止已完成执行删除 - 添加项目执行和任务优先级验证错误码常量 - 优化项目执行删除逻辑，支持级联软删相关任务、工作日志和协办数据 - 添加项目需求关联验证，防止无效需求关联到执行 - 修复执行协办数据批量删除方法的参数验证逻辑 - 添加工时完成难度验证错误码，完善项目需求删除前检查机制 - 更新 CLAUDE.md 文档，补充种子 SQL 编写规范和雪花 ID 处理说明	2026-05-21 21:17:54 +08:00
caozehui	19637d74a4	fix(personal-item): 个人事项&任务添加type类型字段	2026-05-21 13:59:45 +08:00
caozehui	d069948d2a	feat(personal-item): 个人事项	2026-05-21 10:31:09 +08:00
caozehui	3199c876c3	fix(file): 上传文件微调	2026-05-19 14:48:18 +08:00
caozehui	b6d31ab156	feat(personal-center): 个人头像更新	2026-05-19 10:56:13 +08:00
hongawen	1ef86fc1cb	feat(guidelines): 更新工作指引并添加批量成员管理功能 - 简化 AGENTS.md 内容，统一引用 CLAUDE.md 作为主要指引 - 更新 CLAUDE.md 中的工作方式和验证流程说明 - 添加产品和项目成员批量新增/移出的错误码定义 - 扩展系统角色 API 响应 DTO，增加可见性字段 - 实现产品团队成员批量新增和批量移出控制器接口 - 添加产品成员批量操作的服务层实现和业务校验逻辑 - 实现项目团队成员批量操作的相关控制器接口 - 优化产品成员列表查询，过滤不可见角色行 - 添加批量操作的审计日志记录功能	2026-05-18 21:16:11 +08:00
dk	75886d7af5	fix(产品需求、项目需求): 按照会议所说进行修改。	2026-05-18 16:44:29 +08:00
hongawen	50b84a57bb	fix(gateway): 优化网关连接池和服务端保活配置 - 配置网关HttpClient连接池max-idle-time为30s，确保小于下游服务keep-alive-timeout - 设置网关连接超时时间为10s，响应超时时间为30s - 配置下游服务tomcat keep-alive-timeout为60s，避免与网关连接池形成竞争条件 - 将灰度负载均衡器日志级别从warn调整为debug，减少本地开发环境日志噪音 - 添加系统性调试技能配置到Claude设置中	2026-05-18 08:28:33 +08:00
caozehui	bd05f6d593	feat(personal-center): 实现个人信息功能	2026-05-15 15:52:50 +08:00
hongawen	470096aa9a	feat(gateway): 修改文件上传接口返回结构并添加认证路径白名单 - 将 POST /system/file/upload 接口返回结构从字符串改为 { id: string, url: string } 对象 - 添加 id 字段作为 infra_file.id 的字符串形式，解决前端精度丢失问题 - 新增 SKIP_AUTH_PATHS 白名单集合，包含登录、登出、刷新令牌等免校验路径 - 在网关过滤器中添加白名单检查逻辑，跳过指定路径的 access token 校验 - 解决过期 token 拦截导致刷新令牌接口无法正常执行的问题	2026-05-15 13:38:06 +08:00
hongawen	4ad2ddeabe	feat(file): 扩展文件上传响应信息并增强匿名文件访问安全控制 - 在FileUploadRespVO中增加configId和path字段，丰富文件上传返回信息 - 新增selectByConfigIdAndPath方法用于按配置ID和路径查询文件记录 - 在getFileContent服务中添加存在性校验，防止已删除文件被匿名访问 - 更新getFileContent接口注释为"获取文件内容（匿名）"，明确使用场景 - 为图片文件添加缓存控制头，设置max-age为一天并使用ETag实现条件缓存 - 通过DigestUtil计算文件内容SHA256作为ETag值，优化CDN和网关层缓存命中	2026-05-15 09:48:36 +08:00
caozehui	9ee49b1863	feat(project): 新增对象状态模型与状态流转管理能力 - 新增对象状态模型和状态流转的后台管理接口 - 补充分页查询、增删改查及批量删除能力 - 增加状态编码、初始状态和流转配置的唯一性校验 - 增加状态引用校验和删除前校验 - 统一 Swagger 注解依赖为 jakarta 版本以适配 Spring Boot 3	2026-05-15 09:21:10 +08:00
hongawen	be7e0d6162	feat(project): 添加项目成员响应VO中的附加角色名称字段 - 引入 ArraySchema 注解用于描述角色名称数组 - 添加 additionalRoleNames 字段存储非主角色的中文名列表 - 设置默认值为 Collections.emptyList() 确保单角色时为空数组 - 提供多角色场景支持（如同人 manager + creator） - 完善注释说明字段用途和使用场景	2026-05-14 13:58:55 +08:00
hongawen	8f6b762bf3	feat(system): 扩展用户部门权限功能 - 在 AdminUserService 中新增 listEnabledUserIdsByDeptIds 方法获取指定部门集合下启用且未离职的用户 ID 集合 - 在 DeptService 中新增 listDescendantDeptIds 方法获得指定部门集合及其所有子孙部门的 ID 集合 - 在 DeptService 中新增 listCodesByIds 方法按 id 集合批量查询部门 code 集合 - 在 OrgLeaderRelationService 中新增 listEffectiveDeptIdsByUserId 方法查询指定用户当前生效的负责人关系所对应的 dept_id 集合 - 在 PermissionApi 中新增 isSuperAdmin 接口判断用户是否超管 - 在 ObjectPermissionApi 中新增 getObjectRolePermissionDetailMerged 接口按 roleId 列表聚合菜单 + 权限码 - 扩展 ProductContextRoleRespVO 添加多角色场景的附加角色名称列表 - 扩展 ProductCreateWithTeamReqVO 支持创建时添加关心人用户 ID 列表 - 优化 ProductMemberServiceImpl 支持同一用户多角色显示，区分主角色和附加角色 - 新增 MEMBER_ACTION_REACTIVATE 复活动作类型用于处理 INACTIVE 成员行重新激活场景 - 在 ObjectStatusModelDO 中新增 progressExcludedFlag 字段控制是否参与上层进度统计 - 更新 AGENTS.md 和 CLAUDE.md 添加 Git 操作纪律规范 - 在 rdms-project-api 中新增多个错误码常量支持角色转移和内置角色配置验证	2026-05-14 13:58:40 +08:00
dk	3946c0a0aa	feat(项目需求): 开发项目需求的富文本和附件功能。	2026-05-13 22:55:31 +08:00
dk	e1db030c37	Merge branch 'main' of http://192.168.1.22:3000/Microservice/cn-rdms	2026-05-13 20:56:58 +08:00
dk	544b56a5d9	feat(项目需求): 开发项目需求。	2026-05-13 20:56:48 +08:00
dk	7b4edd6b59	feat(项目需求): 开发项目需求。	2026-05-13 20:56:16 +08:00
dk	43d8be724e	feat(项目需求): 开发项目需求。	2026-05-13 20:54:17 +08:00