feat(项目需求): 开发项目需求的富文本和附件功能。

- 将 POST /system/file/upload 接口返回结构从 string 改为 { id: string, url: string }
- id 字段以字符串形式返回 infra_file.id，避免 JavaScript 数值精度丢失问题
- 保持接口路径、方法和入参完全不变，仅修改返回格式
- 添加 GET /system/file/download 接口用于文件下载功能
- 优化 AppFileController 中的文件上传实现逻辑
- 更新 AuthConvert 和 AuthUserInfoRespVO 添加用户昵称和头像字段
- 在 CLAUDE.md 中补充鉴权通道和 HTTP 动词语义说明文档
- 在 ErrorCodeConstants.java 中添加多个项目管理和执行相关的错误码定义
- 删除执行成员相关的数据库表和接口定义（执行协办人替代方案）
- 在 FileMapper 中增加按 URL 查询文件的方法支持

.claude/settings.local.json

@@ -0,0 +1,42 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git *)",
+      "Bash(cmd *)",
+      "PowerShell('--rdms-project--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project' | Sort-Object; '--rdms-system--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-system' | Sort-Object; '--rdms-framework--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-framework' | Sort-Object; '--rdms-gateway--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-gateway' | Sort-Object)",
+      "PowerShell('--docs--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\docs' -Recurse -Depth 2 | Sort-Object)",
+      "PowerShell('--project-boot src--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project' -Recurse -Depth 2 | Sort-Object)",
+      "PowerShell('--project-api src--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-api\\\\src\\\\main\\\\java' -Recurse -Depth 5 | Sort-Object)",
+      "PowerShell('--system-boot src--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-system\\\\rdms-system-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\system' -Recurse -Depth 2 | Sort-Object)",
+      "PowerShell('--project-boot service/project--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project\\\\service\\\\project' -Recurse -Depth 3 | Sort-Object)",
+      "PowerShell('--project-boot controller--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project\\\\controller' -Recurse -Depth 4 | Sort-Object)",
+      "PowerShell('--project-api full--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-api\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project' -Recurse | Sort-Object)",
+      "PowerShell('--project-boot dal--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project\\\\dal' -Recurse | Sort-Object)",
+      "PowerShell('--project-api enums--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-api\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project\\\\enums' -Recurse | Sort-Object; '--system-api full--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-system\\\\rdms-system-api\\\\src\\\\main\\\\java' -Recurse -Depth 6 | Sort-Object)",
+      "PowerShell('--project-boot framework--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\java\\\\com\\\\njcn\\\\rdms\\\\module\\\\project\\\\framework' -Recurse | Sort-Object)",
+      "PowerShell('--sql resources--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\resources' -Recurse | Sort-Object; '--system sql--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-system\\\\rdms-system-boot\\\\src\\\\main\\\\resources\\\\sql' -Recurse | Sort-Object)",
+      "PowerShell('--project-boot resources sql--'; Get-ChildItem -Force -Name 'C:\\\\code\\\\gitea\\\\rdms\\\\cn-rdms\\\\rdms-project\\\\rdms-project-boot\\\\src\\\\main\\\\resources\\\\sql' -Recurse | Sort-Object)",
+      "WebSearch",
+      "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 -Dtest=TaskAssigneeServiceImplTest test 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 -am -Dtest=TaskAssigneeServiceImplTest test 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 -am -Dtest=TaskAssigneeServiceImplTest -Dsurefire.failIfNoSpecifiedTests=false test 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 -am \"-Dtest=TaskAssigneeServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" test 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 -am \"-Dtest=TaskAssigneeServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" test 2>&1 | Select-Object -Last 50)",
+      "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 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 \"-Dtest=TaskAssigneeServiceImplTest,ProjectTaskServiceImplTest,ProjectTaskStatusViewServiceTest,ProjectExecutionServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" test 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 \"-Dtest=TaskAssigneeServiceImplTest,ProjectTaskServiceImplTest,ProjectTaskStatusViewServiceTest,ProjectExecutionServiceImplTest\" \"-Dsurefire.failIfNoSpecifiedTests=false\" test 2>&1 | Select-Object -Last 30)",
+      "Bash(grep -rn \"INSERT INTO \\\\`system_menu\\\\`\\\\|INSERT INTO system_menu\" --include=\"*.sql\" rdms-project rdms-system)",
+      "Bash(findstr /i \"plugin\")",
+      "Bash(findstr *)",
+      "Bash(awk END{print NR} *)",
+      "PowerShell(Move-Item *)",
+      "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' -q 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 -am test '-Dtest=VisibilityScopeResolverImplTest' '-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 -am test '-Dtest=VisibilityScopeResolverImplTest' '-Dsurefire.failIfNoSpecifiedTests=false' -q | 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 -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)"
+    ]
+  }
+}

AGENTS.md

@@ -8,6 +8,8 @@
 
 默认回答保持精简，优先给结论、改动点和必要风险，不做过多展开；如果存在你关心但未展开的细节，由你继续追问后再补充。
 
+回答问题时不要过多代码层面的描述：默认用自然语言给结论、判断、影响面；除非用户明确要看实现细节，不要大段贴代码片段、不要逐行解读、不要把分析写成"先看 xxx.java 第 N 行"的形式。涉及代码定位时用 `file_path:line_number` 引用即可。
+
 ## 交互原则
 
 - 默认先给执行方案，说明目标、涉及模块、预计改动点和验证方式。
@@ -25,9 +27,13 @@
 
 ## 本地环境约定
 
+- 本仓库要求使用 `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 命令时，才使用上述路径执行
 
 顶层模块：

CLAUDE.md

@@ -0,0 +1,144 @@
+# CLAUDE.md
+
+本文件为 Claude Code 在 `C:\code\gitea\rdms\cn-rdms` 仓库工作时的常驻指引，等价并补充 `AGENTS.md`。两份文件冲突时以本文件为准；本文件未覆盖的细节回退到 `AGENTS.md`。
+
+## 工作方式
+
+- 默认先给执行方案：目标、涉及模块、改动点、验证方式。用户明确同意前不要直接动手修改、编译、测试、打包。
+- 用户只要分析或评审时，停在分析层；不要顺手开工。
+- 描述仓库现状以**当前**代码、配置、文档可验证的事实为准；不要拿历史实现、过渡方案或已废弃模型解释当前状态。
+- 回答保持精简，先给结论、改动点、必要风险；细节等用户追问。
+- **不要废话**：默认极简输出，不展开背景、不复述需求、不堆叠章节标题；能用一两句讲清就别写成清单；用户主动追问再展开。
+- **回答问题时不要过多代码层面的描述**：默认用自然语言给结论、判断、影响面；除非用户明确要看实现细节，不要大段贴代码片段、不要逐行解读、不要把分析写成"先看 xxx.java 第 N 行"的形式。涉及代码定位时用 `file_path:line_number` 引用即可。
+
+## 本机环境
+
+- 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；否则在该命令上下文中显式切换。
+- **只有在用户已明确同意执行编译/测试/打包等命令时**，才使用上述路径执行。日常默认不跑任何会实际运行项目的命令。
+
+## 仓库结构
+
+多模块 Maven 单仓库，Java 17，Spring Boot 3.5.9，根模块打包 `pom`。
+
+顶层模块：
+1. `rdms-system` — 系统域（用户/组织/岗位/菜单/角色/权限）
+2. `rdms-project` — RDMS 核心交付域（项目集/项目/产品/需求/任务/工单/执行）
+3. `rdms-framework` — 共享框架与内部 starter
+4. `rdms-gateway` — Spring Cloud Gateway 网关
+
+每个业务模块按 `xxx-api` + `xxx-boot` 拆分：
+- `*-api`：对外 RPC/Feign 接口、DTO、错误码、枚举、常量
+- `*-boot`：启动类、controller、service、dal、convert、api 实现、模块级 framework 配置
+
+主包/启动类：
+- `rdms-system-boot`：`com.njcn.rdms.module.system.SystemServerApplication`
+- `rdms-project-boot`：`com.njcn.rdms.module.project.ProjectServerApplication`
+- `rdms-gateway`：`com.njcn.rdms.gateway.GatewayServerApplication`
+
+`rdms-framework` 子模块：`rdms-common` 及一组 `rdms-spring-boot-starter-*`（`env`、`web`、`rpc`、`security`、`mybatis`、`redis`、`mq`、`websocket`、`excel`、`protection`、`test`、`biz-ip`）。
+
+## 模块演进判断
+
+新增能力时**先判断落点**：
+- 落在现有 `rdms-system` 子域 → 沿用 `controller/admin|app`、`service`、`dal/dataobject`、`dal/mysql`、`convert` 的现有结构，跨模块暴露时在 `rdms-system-api` 补 API/DTO/错误码/枚举。
+- 落在现有 `rdms-project` 子域 → 同理，跨模块走 `rdms-project-api`。
+- 已具备独立服务边界（如未来的 `rdms-workflow`）→ 新建 `rdms-xxx` + `rdms-xxx-api` + `rdms-xxx-boot`，根 `pom.xml` 加聚合，包路径 / `spring.application.name` / `ApiConstants` / `RpcConstants` / `rdms.info.base-package` 保持一致。
+
+不要：
+- 把后续业务长期堆进 `rdms-system`。
+- 为新增子域引入一套平行的 `application/domain/infrastructure/adapter` 分层。
+- 让外部模块直接依赖 `*-boot` 的 service 或 mapper（必须走 `*-api`）。
+
+## 分层职责
+
+| 层 | 职责 | 红线 |
+|---|---|---|
+| `rdms-framework` | 基础能力 | 不承载业务语义；除非框架级缺陷或全局基础设施，不要把业务判断塞进来 |
+| `rdms-gateway` | 入口、令牌校验、登录用户透传、路由、横切 | 不要在这里承载组织/成员/负责人/项目/产品/工作流状态/数据可见性 |
+| Controller | HTTP 暴露、参数校验、权限注解、结果封装 | 不要编排复杂业务流程，不要直接操作多个 mapper；用 `ReqVO`/`RespVO`，不要直接暴露 DO |
+| Service | 业务规则、事务、缓存、领域编排 | 已有领域优先扩展，不要为"整齐"平移；不要把规则散到 controller / mapper / util |
+| DAL | DO + Mapper | Mapper 继承 `BaseMapperX<T>`；查询优先 `LambdaQueryWrapperX` 与默认方法封装；非必要不回退 XML；不承担领域校验 |
+| Convert | 已有 `convert` 风格继续沿用，简单场景直接 `BeanUtils` | 不要强推全员 MapStruct，也不要反过来把已有 convert 全删 |
+
+## 认证与跨模块调用
+
+- 默认沿用 OAuth2 / Token / `LoginUser` / `login-user` 透传主链。**不要**另造 ThreadLocal / Session / 自定义 header。
+- 跨模块/跨服务必须通过 `*-api` 模块定义契约；不要直接依赖别人的 `*-boot`。
+
+### 鉴权：必须按"全域 / 对象域"分通道挂
+
+系统有**两条互不交叉**的权限通道，挂错通道 = 永远 403。新增/修改接口前必须先判断它属于哪一域：
+
+| 通道 | 适用场景 | 注解 / 实现 | 角色与菜单 |
+|---|---|---|---|
+| **全域 global** | 传统 RBAC 顶层菜单与"项目管理界面"——选择对象**之前**的所有动作（建项目、列项目、菜单/角色/用户管理等） | Controller 上 `@PreAuthorize("@ss.hasPermission('xxx')")`，由 `PermissionServiceImpl.hasAnyPermissions` 处理 | `system_role.scope_type='global'` + `system_menu.scope_type='global'` |
+| **对象域 object** | 用户**已选择某个对象**（如某个项目/产品）后，对象内部的一切操作（任务、执行、工时、协办人、需求、成员维护等） | Service 上 `@CheckObjectPermission(objectType=..., objectId="#xxxId", permission="...")`，由 `ObjectPermissionAspect` → `ObjectPermissionService.checkPermission` 处理 | `system_role.scope_type='object'` + `system_menu.scope_type='object'` + `object_type` |
+
+红线：
+
+- **对象内接口绝不能挂 `@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），新增读接口暂沿用现状即可，不要顺手改造，等独立立项。
+
+判定口诀：**URL 里有 `{projectId}` / `{productId}` 等对象 ID → 对象域；没有 → 全域**。
+
+## 接口语义(HTTP 动词)
+
+本仓库 update 类接口默认按 RESTful 标准用 HTTP 动词区分语义,前后端必须按下表对齐,避免"前端没传字段"和"前端想清空"在后端无法区分的歧义。
+
+| 动词 | 语义 | 字段处理规则 |
+|---|---|---|
+| **PUT** | 全资源替换 | 前端必须把表单完整状态回传(读到的非必填字段也要原样回传)。后端按字段值落库:**有值=更新,`null`=清空**。DO 字段加 `@TableField(updateStrategy = FieldStrategy.ALWAYS)` 跳过全局 `NOT_NULL` 让 `null` 真的写库 |
+| **PATCH** | 部分字段更新 | **本仓库暂不引入 PATCH 接口**。如果有"只改一两个字段"的需求,用专门的子动作接口(参考 `assignees/{id}/inactive`、`status` 这种语义化路径),不要在 update 接口里靠旁路标记(如 `clearXxx: true`)模拟 PATCH |
+| **DELETE** | 资源删除 | 软删走全局 `deleted` 列,不需要参数 body |
+
+红线:
+
+- **不要在 update 类接口的 ReqVO 里加 `clearXxx: Boolean` 这种旁路标记**来模拟 PATCH —— 等于承认接口是"伪 PATCH",会让所有非必填字段都需要类似标记,长期污染 API 设计。需要部分更新就拆子动作接口。
+- 新增 update 接口时,必须在 API 文档对应章节明示"PUT 全字段回传"约定;DO 上对允许 null 的字段补 `FieldStrategy.ALWAYS` 注解,并加注释说明语义来源(指向本节)。
+- 历史接口若是稀疏 PATCH 风格(传 null = 不动),保留现状但不要拓展;遇到清空诉求时按 PUT 方向重构。
+
+## 数据与 SQL
+
+- 新表 DO 复用现有 `BaseDO` / 审计字段风格，不要再引一套审计基类（除非该表本身明确不需要逻辑删除）。
+- **不要假设运行时自动数据库迁移**：依赖新表/新字段/新索引时，必须同步补 SQL 脚本与文档。
+- SQL 放在目标模块 `src/main/resources/sql/...`，可审阅、可单独执行。
+- 缓存/日志/审计变更优先沿用既有机制，不要绕开登录上下文与审计字段填充。
+
+## 注释与编码
+
+- 关键字段、关键分支、关键约束、非直观实现补**简洁中文**注释。
+- 不要为省事删除原有有效注释；也不要写无信息量的注释。
+- 中文写入必须 UTF-8，并自查显示是否正常；不要用"改成英文"规避乱码。
+- superpowers 产出的功能文档（设计/实施/联调）默认中文落地；代码标识、文件路径、接口路径、SQL、命令保持原样不意译。
+
+## 工作规则（执行前对照）
+
+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`、启动命令、脚本等会实际运行项目的命令。**
+
+## 验证默认动作
+
+先定义验证方式，再做修改。默认静态验证：
+- 调用链是否闭环、是否符合模块边界
+- 配置项 / 接口契约 / 权限标识 / 路由 / 资源注册前后是否一致
+- 改动是否控制在最小集合
+- 文档 / SQL / 配置 / 接口说明是否需要同步更新
+
+如果改动涉及 Spring 配置、序列化、安全、路由、RPC 契约、MyBatis 行为或跨模块 API，必须**显式区分**哪些是已静态检查、哪些尚未实际运行验证。
+
+## 给后续我自己的提醒
+
+- 仓库可能有未提交的本地改动，不要顺手覆盖与当前任务无关的编辑。
+- `docs/` 是当前工作上下文的一部分，不是归档；架构级修改前先查阅。
+- 根 `pom.xml` 统一版本与依赖；版本调整改根 pom，不要散落到子模块。
+- 推荐使用 `Glob` / `Grep` / `Read` 等专用工具，避免用 Bash 做文件搜索/读取/编辑。

rdms-framework/rdms-common/src/main/java/com/njcn/rdms/framework/common/pojo/PageParam.java

@@ -27,9 +27,8 @@ public class PageParam implements Serializable {
     @Min(value = 1, message = "页码最小值为 1")
     private Integer pageNo = PAGE_NO;
 
-    @Schema(description = "每页条数，最大值为 200", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @Schema(description = "每页条数，最大值为 200；传 -1 表示不分页（查询全部）", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
     @NotNull(message = "每页条数不能为空")
-    @Min(value = 1, message = "每页条数最小值为 1")
     @Max(value = 200, message = "每页条数最大值为 200")
     private Integer pageSize = PAGE_SIZE;
 

rdms-gateway/src/main/resources/application-dev.yaml

@@ -6,10 +6,10 @@ spring:
       username: # Nacos 账号
       password: # Nacos 密码
       discovery: # 【配置中心】配置项
-        namespace: dev # 命名空间。这里使用 dev 开发环境
+        namespace: 1924bcfb-4eab-4c58-9003-4a37d5fc2949 # 命名空间。这里使用 dev 开发环境
         group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
       config: # 【注册中心】配置项
-        namespace: dev # 命名空间。这里使用 dev 开发环境
+        namespace: 1924bcfb-4eab-4c58-9003-4a37d5fc2949 # 命名空间。这里使用 dev 开发环境
         group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
 
 #################### 监控相关配置 ####################

rdms-gateway/src/main/resources/application-local.yaml

@@ -6,10 +6,10 @@ spring:
       username: # Nacos 账号
       password: # Nacos 密码
       discovery: # 【配置中心】配置项
-        namespace: dev # 命名空间。这里使用 dev 开发环境
+        namespace: 1924bcfb-4eab-4c58-9003-4a37d5fc2949 # 命名空间。这里使用 dev 开发环境
         group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
       config: # 【注册中心】配置项
-        namespace: dev # 命名空间。这里使用 dev 开发环境
+        namespace: 1924bcfb-4eab-4c58-9003-4a37d5fc2949 # 命名空间。这里使用 dev 开发环境
         group: DEFAULT_GROUP # 使用的 Nacos 配置分组，默认为 DEFAULT_GROUP
 
 #################### 监控相关配置 ####################

rdms-project/2026-04-23-product-activity-timeline-api-design.md

@@ -1,270 +0,0 @@
-# 产品动态时间线后端接口需求说明
-
-日期：2026-04-23
-
-## 1. 背景
-
-当前产品对象首页中的“产品动态时间线”模块，用户期望不是展示几条前端拼装的摘要，而是一个可以在首页内直接查询的正式动态模块。
-
-本轮已确认的目标能力包括：
-
-- 首页内直接展示产品动态时间线
-- 默认查询最近 `30 天`
-- 支持自定义起止时间筛选
-- 支持事件类型多选筛选
-- 支持分页
-- 第一版事件范围收敛在产品对象与团队关系，不混入需求池事件
-
-## 2. 当前前端现状
-
-当前前端可直接使用的真实接口只有：
-
-- `GET /project/product/get`
-- `GET /project/product/{id}/settings`
-- `GET /project/product/{id}/members`
-
-这些接口目前只能提供：
-
-- 产品当前状态
-- 最近一次状态原因
-- 产品经理
-- 成员加入时间
-- 成员退出时间
-- 当前成员角色
-
-它们可以勉强拼出少量“最近动态摘要”，但不足以支撑正式时间线查询模块。
-
-## 3. 当前接口为什么不够
-
-如果继续只依赖现有接口，前端存在以下硬缺口：
-
-1. 没有统一的产品动态分页接口
-2. 没有事件类型维度，无法支持类型筛选
-3. 没有统一发生时间字段集合，无法稳定支持时间筛选
-4. 没有事件操作人字段，无法明确展示“谁做了什么”
-5. 没有统一的事件摘要字段，前端只能自己硬拼文案
-6. 没有产品状态变更前后值，无法展示“从什么状态变更为什么状态”
-7. 没有产品经理变更前后值，无法展示交接关系
-8. 没有分页总数字段，无法做首页内翻页
-
-因此，现有接口只适合做“概览摘要”，不适合做“可查询产品动态时间线”。
-
-## 4. 后端接口交付要求
-
-后端必须新增一条专用分页接口：
-
-`GET /project/product/{id}/activities/page`
-
-这条接口只服务“产品动态时间线”能力，不承担需求池动态，不承担首页其它概览指标。
-
-前端要求后端单独提供这条接口，原因如下：
-
-- 语义清晰，前后端都容易维护
-- 首页时间线可直接消费
-- 后续如果要做独立的产品动态页，也可以继续复用这条接口
-- 不需要继续让前端从多个接口里拼装事件
-
-## 5. 第一版事件范围
-
-第一版事件类型确认收敛为 5 类：
-
-- `product_created`：产品创建
-- `product_status_changed`：产品状态变更
-- `product_manager_changed`：产品经理变更
-- `product_member_joined`：成员加入
-- `product_member_removed`：成员移出
-
-第一版明确不纳入：
-
-- 成员角色调整
-- 需求新增
-- 需求状态流转
-- 需求关闭
-- 里程碑事件
-- 风险点事件
-
-## 6. 查询参数要求
-
-接口必须支持以下查询参数：
-
-- `pageNo`：页码
-- `pageSize`：每页数量
-- `startTime`：开始时间
-- `endTime`：结束时间
-- `types`：事件类型数组，多选
-
-补充要求：
-
-- 当前端未传时间范围时，后端默认按最近 `30 天` 返回
-- 返回结果按 `occurredAt desc` 倒序排列
-- `types` 支持多选，不要求前端单选
-
-示例：
-
-```http
-GET /project/product/1001/activities/page?pageNo=1&pageSize=10&startTime=2026-03-24 00:00:00&endTime=2026-04-23 23:59:59&types=product_status_changed&types=product_manager_changed
-```
-
-## 7. 返回结构要求
-
-接口返回必须支持分页，分页结构至少应满足：
-
-```json
-{
-  "total": 128,
-  "list": [
-    {
-      "id": "act_001",
-      "type": "product_status_changed",
-      "title": "产品状态变更",
-      "operatorId": "10001",
-      "operatorName": "张敏",
-      "occurredAt": "2026-04-23 10:32:15",
-      "summary": "产品状态由暂停变更为启用",
-      "reason": "测试恢复",
-      "beforeStatus": "paused",
-      "afterStatus": "active"
-    }
-  ]
-}
-```
-
-分页顶层字段至少包括：
-
-- `total`
-- `list`
-
-如果后端已有统一分页模型，可以沿用现有分页结构，但前端必须能稳定拿到总数和列表。
-
-## 8. 事件通用字段要求
-
-无论哪种事件类型，后端都应统一返回以下字段：
-
-- `id`：事件唯一 ID
-- `type`：事件类型编码
-- `title`：事件标题
-- `operatorId`：操作人 ID
-- `operatorName`：操作人名称
-- `occurredAt`：发生时间
-- `summary`：事件摘要
-- `reason`：原因或备注，可为空
-
-这些字段是首页时间线最小可展示集合。
-
-## 9. 各事件类型的专属字段要求
-
-### 9.1 产品创建 `product_created`
-
-必须补充：
-
-- `creatorUserId`
-- `creatorUserName`
-
-### 9.2 产品状态变更 `product_status_changed`
-
-这是当前最关键的一类事件，后端必须返回：
-
-- `beforeStatus`
-- `afterStatus`
-- `reason`
-
-前端需要用这组字段明确表达：
-
-- 变更前状态
-- 变更后状态
-- 本次变更原因
-
-例如：
-
-- `暂停 -> 启用`
-- `启用 -> 归档`
-
-### 9.3 产品经理变更 `product_manager_changed`
-
-必须返回：
-
-- `beforeManagerUserId`
-- `beforeManagerUserName`
-- `afterManagerUserId`
-- `afterManagerUserName`
-- `reason`
-
-否则前端无法准确展示交接关系，只能看到当前经理，不能看到变更前后关系。
-
-### 9.4 成员加入 `product_member_joined`
-
-必须返回：
-
-- `memberUserId`
-- `memberUserName`
-- `roleId`
-- `roleName`
-- `remark`
-
-### 9.5 成员移出 `product_member_removed`
-
-必须返回：
-
-- `memberUserId`
-- `memberUserName`
-- `roleId`
-- `roleName`
-- `reason`
-
-## 10. 前端展示口径
-
-前端首页时间线模块第一版会直接基于这条接口支持：
-
-- 默认最近 `30 天`
-- 自定义时间范围筛选
-- 事件类型多选筛选
-- 分页切换
-
-每条记录最少展示：
-
-- 事件类型
-- 事件标题
-- 操作人
-- 发生时间
-- 变更摘要
-- 原因/备注
-
-其中“产品状态变更”需要明确体现：
-
-- 变更前状态
-- 变更后状态
-- 变更原因
-
-## 11. 为什么不建议继续让前端拼装
-
-如果继续沿用当前前端拼装方案，会有这些问题：
-
-- 产品状态变更前后值无法补齐
-- 产品经理变更前后值无法补齐
-- 无法支持分页
-- 无法支持统一时间筛选
-- 无法支持统一类型筛选
-- 不同事件文案会在前端散落拼装，长期维护成本高
-
-因此这里的前后端边界应明确为：
-
-- 后端提供统一产品动态分页接口
-- 前端负责筛选条件组织、分页交互和时间线展示
-
-## 12. 本轮需求结论
-
-本轮给后端的结论可以直接收敛为：
-
-1. 当前前端已有接口不满足正式产品动态时间线需求
-2. 后端新增 `GET /project/product/{id}/activities/page`
-3. 接口必须支持分页、默认最近 `30 天`、自定义时间范围、事件类型多选
-4. 第一版事件类型只做：
-   - 产品创建
-   - 产品状态变更
-   - 产品经理变更
-   - 成员加入
-   - 成员移出
-5. 产品状态变更必须提供前后状态和原因
-6. 产品经理变更必须提供前后经理信息
-
-这条接口交付后，前端才能把当前“产品动态时间线”从拼装摘要升级成正式可查询模块。

rdms-project/2026-04-23-product-overview-homepage-design.md

@@ -1,292 +0,0 @@
-# 产品对象首页改版设计说明
-
-日期：2026-04-23
-
-## 1. 目标
-
-本设计用于收敛 RDMS 产品对象上下文默认首页的改版方向。
-
-本轮目标不是继续做“说明型占位页”，而是明确把当前 `/product/dashboard?objectId=...` 改成一个真正可用的产品对象首页：
-
-- 第一眼先让用户知道当前看的是什么产品
-- 第二眼能快速判断对象最近发生了什么
-- 第三眼能看出需求池现在的经营状态和最近变化
-- 底部为后续业务模块保留正式挂载位，而不是临时拼接入口
-
-## 2. 已确认诉求
-
-基于本轮对话，已确认以下用户诉求：
-
-1. 首页顶部必须先展示产品基础概述，而不是先铺统计卡片
-2. 基础概述至少包含：名称、编号、团队、产品经理等对象基础信息
-3. 页面需要一块明显的时间线，用于承接产品对象与团队变更动态
-4. 页面需要承接需求池管理情况，重点看总量、状态、待处理等统计信息
-5. 需求相关事件不要混入对象时间线，应单独作为需求池最近变化区域
-6. 快捷入口不要保留
-7. 底部允许保留后续扩展区，重点预留给里程碑、风险点管理、产品资料等模块
-8. 能接真实接口就接真实接口，当前没有稳定接口的区域允许先用假数据，但结构必须按正式首页来设计
-
-## 3. 首页定位结论
-
-本页定位不是：
-
-- 纯报表看板
-- 纯审计日志页
-- 设置页搬运版
-- 导航入口集合页
-
-本页定位应当是：
-
-- 产品对象首页
-- 偏统计，也带审计
-- 但页面主语始终是“当前产品对象”
-
-换句话说，这个页面要同时回答三个问题：
-
-1. 我现在看的是什么产品？
-2. 这个产品对象最近发生了什么？
-3. 这个产品的需求池现在处于什么状态？
-
-## 4. 页面结构
-
-### 4.1 桌面端结构
-
-桌面端建议采用三层结构：
-
-1. 顶部 `对象基础概述横幅`
-2. 中部 `左时间线 + 右需求池双模块`
-3. 底部 `扩展信息区`
-
-推荐布局比例：
-
-- 顶部横幅：`24 / 24`
-- 中部主区：左 `16 / 24`，右 `8 / 24`
-- 底部扩展区：`24 / 24`
-
-中部左侧时间线高度应明显高于右侧任一单模块，形成首页主阅读区。
-
-### 4.2 移动端结构
-
-移动端统一退化为单列纵向布局，顺序为：
-
-1. 对象基础概述横幅
-2. 对象 / 团队动态时间线
-3. 需求池管理概览
-4. 需求池最近变化
-5. 扩展信息区
-
-移动端不强撑左右栏并排，不做卡片墙式压缩。
-
-## 5. 模块设计
-
-### 5.1 对象基础概述横幅
-
-顶部采用“档案横幅型”，不采用纯指标卡片型。
-
-横幅左侧承接对象身份信息：
-
-- 产品名称
-- 产品编号
-- 当前状态标签
-- 产品经理
-- 团队规模
-- 团队角色摘要
-- 简短描述或备注
-
-横幅右侧承接 4 个摘要指标：
-
-- 团队人数
-- 需求总量
-- 待处理需求
-- 最近动态时间
-
-设计原则：
-
-- 左侧负责建立对象识别
-- 右侧负责快速判断当前概况
-- 右侧指标只保留 4 项，不堆成报表卡片墙
-
-### 5.2 对象 / 团队动态时间线
-
-该区域位于中部左侧，是首页的主阅读区。
-
-这条时间线只承接对象与团队变化，不承接需求事件。
-
-第一版事件范围收敛为：
-
-- 产品创建
-- 产品状态变更
-- 产品经理变更
-- 成员加入
-- 成员移出
-- 成员角色调整
-
-每条时间线建议展示：
-
-- 事件标题
-- 事件类型标签
-- 发生时间
-- 操作摘要
-- 必要时展示原因或备注
-
-表达目标是“业务时间线”，不是后台审计表格。
-
-### 5.3 需求池管理概览
-
-该区域位于中部右侧上半块，用于表达需求池的经营状态。
-
-第一版首页需要优先看到的内容：
-
-- 需求总量
-- 各状态数量
-- 待处理数量
-- 高优先级待处理数量
-
-展示方式建议为“摘要指标 + 状态分布列表”，不直接在首页展开完整需求表格。
-
-这一块回答的是：
-
-- 需求池是否健康
-- 当前待处理压力大不大
-- 是否存在需要优先关注的积压
-
-### 5.4 需求池最近变化
-
-该区域位于中部右侧下半块，与需求池管理概览上下分层，但属于同一侧栏语义。
-
-该区域不重复展示总量，而是展示需求池最近发生的变化。
-
-第一版建议承接：
-
-- 最近新增需求
-- 最近状态流转
-- 最近关闭或完成
-
-每条记录建议至少展示：
-
-- 需求标题
-- 动作类型
-- 时间
-- 当前状态或状态变更摘要
-
-若当前没有真实数据，仍保留正式模块壳，不退化成“待开发”一句话。
-
-### 5.5 扩展信息区
-
-底部不再保留快捷入口，改为正式扩展信息区。
-
-当前优先预留 3 类模块位：
-
-- 里程碑
-- 风险点管理
-- 产品资料
-
-这一层的作用是：
-
-- 为后续对象级信息继续扩展留下稳定挂载位
-- 不把中部主结构挤成信息大杂烩
-- 避免为了未来模块提前做假导航入口
-
-如果当前没有稳定接口，可先保留正式卡片结构与空态说明。
-
-## 6. 数据策略
-
-### 6.1 真实接口优先
-
-当前首页优先消费现有真实接口：
-
-- `fetchGetProduct`
-- `fetchGetProductSettings`
-- `fetchGetProductMembers`
-
-这些接口足以支撑：
-
-- 对象基础概述中的名称、编号、状态、产品经理、描述
-- 团队人数与角色摘要
-- 最近动态中的产品创建、状态变化、成员加入/移出
-
-### 6.2 假数据使用边界
-
-当前没有稳定真实接口的区域，允许先用假数据，但边界必须明确：
-
-- 需求池管理概览
-- 需求池最近变化
-- 扩展信息区中的里程碑、风险点管理、产品资料摘要
-
-假数据的使用原则：
-
-1. 只补“当前没有稳定接口”的区域
-2. 不反向污染对象基础信息
-3. 不把假数据混入对象上下文 store
-4. 数据源要集中放在概览页自己的 mock 模块中，方便后续替换
-
-### 6.3 不推荐的做法
-
-以下做法应避免：
-
-- 把需求假数据散落写进页面组件
-- 用对象 demo 数据冒充真实产品详情
-- 把对象时间线和需求时间线混成一条
-- 用快捷入口伪装成首页内容
-
-## 7. 空态规则
-
-首页至少要区分三种状态：
-
-1. 能力未接入，只能先显示正式占位信息
-2. 能力已接入，但当前该产品暂无业务数据
-3. 当前用户无权限查看该模块
-
-这三种状态不能共用一套模糊文案。
-
-对需求池和扩展信息区，当前阶段更推荐“正式空态”而不是“待开发”。
-
-## 8. 页面边界
-
-首页明确不承接以下内容：
-
-- 快捷入口导航区
-- 完整团队成员表格
-- 完整需求列表表格
-- 设置页重表单
-- 完整审计日志明细页
-
-首页要做的是概述、判断与阅读，不是重操作页。
-
-## 9. 实施建议
-
-第一阶段建议先完成结构性改造：
-
-1. 重做顶部横幅，建立对象档案感
-2. 保留中部左高右双块结构
-3. 用真实接口接通对象概述与对象 / 团队时间线
-4. 用局部 mock 数据先接通需求池两块和底部扩展区
-
-第二阶段再逐步替换需求池与扩展区数据源：
-
-- 接真实需求池统计接口
-- 接真实需求动态接口
-- 接里程碑、风险点、产品资料摘要接口
-
-## 10. 验证标准
-
-本设计是否成立，可按以下标准判断：
-
-1. 进入首页后，第一眼能认出当前产品对象
-2. 用户能自然读到对象 / 团队最近发生了什么
-3. 右侧能快速判断需求池当前压力与最近变化
-4. 页面看起来像“对象首页”，而不是“普通后台卡片堆叠页”
-5. 当前没有真实接口的区域也保留正式结构，不显得像临时占位
-6. 后续新增里程碑、风险点管理、产品资料等能力时，不需要推翻整页结构
-
-## 11. 本轮设计结论
-
-本轮最终设计结论如下：
-
-- 首页定位为“产品对象首页”，偏统计，也带审计，但不做纯报表页
-- 顶部采用档案横幅型，先立住对象身份信息
-- 中部左侧是高权重的对象 / 团队动态时间线
-- 中部右侧拆为“需求池管理概览 + 需求池最近变化”上下两块
-- 底部去掉快捷入口，改为正式扩展信息区
-- 当前有真实接口的模块优先接真实接口
-- 当前没有稳定接口的区域允许先用假数据，但必须隔离在概览页局部 mock 数据源中

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 {
@@ -33,6 +33,10 @@ public interface ErrorCodeConstants {
     ErrorCode PRODUCT_DELETE_CONFIRM_TEXT_INVALID = new ErrorCode(1_008_001_021, "删除确认口令不正确");
     ErrorCode PRODUCT_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_001_022, "产品状态已发生变化，请刷新后重试");
     ErrorCode PRODUCT_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_001_023, "产品状态定义不存在或已停用");
+    // 产品创建原子接口（/create-with-team）专用：初始团队相关校验
+    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, "初始团队中存在非法角色");
 
     // ========== 产品需求 1-008-002-000 ==========
     ErrorCode REQUIREMENT_NOT_EXISTS = new ErrorCode(1_008_002_000, "产品需求不存在");
@@ -42,15 +46,143 @@ public interface ErrorCodeConstants {
     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_CHILD_NOT_ALLOW_CLOSE = new ErrorCode(1_008_002_008, "存在子需求状态不对，请先处理子需求");
+    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, "存在子需求，请先删除子需求");
     ErrorCode REQUIREMENT_MODULE_NOT_EXISTS = new ErrorCode(1_008_002_009, "需求模块不存在");
     ErrorCode REQUIREMENT_MODULE_NAME_DUPLICATE = new ErrorCode(1_008_002_010, "已经存在名称为【{}】的模块");
     ErrorCode REQUIREMENT_MODULE_NOT_BELONG_TO_PRODUCT = new ErrorCode(1_008_002_011, "模块不属于当前产品");
     ErrorCode REQUIREMENT_MODULE_HAS_NON_TERMINAL_REQUIREMENTS = new ErrorCode(1_008_002_012, "模块下存在非终态需求，不可删除");
-    ErrorCode REQUIREMENT_HAS_CHILDREN = new ErrorCode(1_008_002_013, "存在子需求，请先删除子需求");
-    ErrorCode REQUIREMENT_STATUS_NOT_ALLOW_DELETE = new ErrorCode(1_008_002_014, "只有待确认、待评审、待分流状态的需求才能删除");
     ErrorCode REQUIREMENT_MODULE_HAS_CHILDREN = new ErrorCode(1_008_002_015, "存在子模块，请先删除子模块");
     ErrorCode REQUIREMENT_MODULE_HAS_REQUIREMENTS = new ErrorCode(1_008_002_016, "模块下存在需求，请先删除需求");
+    ErrorCode PROJECT_REQUIREMENT_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_NOT_PROJECT_MEMBER = new ErrorCode(1_008_002_022, "您不是该项目的成员，无权访问");
 
+    // ========== 项目管理 1-008-002-000 ==========
+    ErrorCode PROJECT_NOT_EXISTS = new ErrorCode(1_008_002_000, "项目不存在");
+    ErrorCode PROJECT_CODE_DUPLICATE = new ErrorCode(1_008_002_001, "已经存在编码为【{}】的项目");
+    ErrorCode PROJECT_NAME_DUPLICATE = new ErrorCode(1_008_002_002, "当前产品下已经存在名称为【{}】的项目");
+    ErrorCode PROJECT_CODE_NOT_MODIFIABLE = new ErrorCode(1_008_002_003, "项目编码创建后不允许修改");
+    ErrorCode PROJECT_PRODUCT_NOT_MODIFIABLE = new ErrorCode(1_008_002_004, "项目所属产品第一期不允许直接修改");
+    ErrorCode PROJECT_PRODUCT_NOT_EXISTS = new ErrorCode(1_008_002_005, "所属产品不存在或不可用");
+    ErrorCode PROJECT_TYPE_INVALID = new ErrorCode(1_008_002_006, "项目类型不是有效字典值");
+    ErrorCode PROJECT_MANAGER_USER_INVALID = new ErrorCode(1_008_002_007, "项目负责人不是有效系统用户");
+    ErrorCode PROJECT_MEMBER_USER_INVALID = new ErrorCode(1_008_002_008, "项目成员不是有效系统用户");
+    ErrorCode PROJECT_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_002_009, "当前项目状态不支持动作【{}】");
+    ErrorCode PROJECT_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_002_010, "动作【{}】必须填写原因");
+    ErrorCode PROJECT_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_002_011, "项目状态已发生变化，请刷新后重试");
+    ErrorCode PROJECT_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_002_012, "当前项目状态不允许编辑");
+    ErrorCode PROJECT_MEMBER_NOT_EXISTS = new ErrorCode(1_008_002_013, "项目成员不存在");
+    ErrorCode PROJECT_MEMBER_ALREADY_EXISTS = new ErrorCode(1_008_002_014, "该用户已是当前项目的有效成员");
+    ErrorCode PROJECT_MEMBER_ROLE_INVALID = new ErrorCode(1_008_002_015, "角色不存在或不属于项目对象角色");
+    ErrorCode PROJECT_MANAGER_MEMBER_NOT_ALLOW_REMOVE = new ErrorCode(1_008_002_016, "当前项目负责人不能移出项目团队，请先完成负责人变更");
+    ErrorCode PROJECT_MEMBER_NOT_ACTIVE = new ErrorCode(1_008_002_017, "当前项目成员已失效");
+    ErrorCode PROJECT_DELETE_CONFIRM_TEXT_INVALID = new ErrorCode(1_008_002_018, "删除确认口令不正确");
+    ErrorCode PROJECT_DELETE_NAME_MISMATCH = new ErrorCode(1_008_002_019, "删除确认名称与当前项目名称不一致");
+    ErrorCode PROJECT_NOT_ALLOW_DELETE = new ErrorCode(1_008_002_020, "当前项目不允许删除");
+    ErrorCode PROJECT_OBJECT_PERMISSION_DENIED = new ErrorCode(1_008_002_021, "当前用户不具备该项目的操作权限【{}】");
+    ErrorCode PROJECT_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_002_022, "项目状态定义不存在或已停用");
+    ErrorCode PROJECT_DIRECTION_INVALID = new ErrorCode(1_008_002_023, "项目方向不是有效字典值");
+    ErrorCode PROJECT_MANAGER_TRANSFER_INFO_REQUIRED = new ErrorCode(1_008_002_024, "切换项目经理时必须同时传入原项目经理用户和交接后角色");
+    ErrorCode PROJECT_MANAGER_TRANSFER_SOURCE_INVALID = new ErrorCode(1_008_002_025, "原项目经理信息与当前项目经理不一致");
+    ErrorCode PROJECT_MANAGER_TRANSFER_ROLE_INVALID = new ErrorCode(1_008_002_026, "原项目经理交接后的角色不能仍为项目经理");
+    ErrorCode PROJECT_MANAGER_MEMBER_NOT_ALLOW_DOWNGRADE = new ErrorCode(1_008_002_027, "当前项目经理不能直接调整为非经理角色，请先完成经理转交");
+    ErrorCode PROJECT_MAINLINE_DUPLICATE = new ErrorCode(1_008_002_028, "当前产品下已存在未作废的主线项目");
+    // 项目创建原子接口（/create-with-team）专用：初始团队 + 方向一致性校验
+    ErrorCode PROJECT_INITIAL_TEAM_MANAGER_REQUIRED = new ErrorCode(1_008_002_029, "初始团队必须包含项目经理");
+    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, "项目方向与所属产品方向不一致");
+
+    // ========== 执行管理 1-008-003-000 ==========
+    ErrorCode PROJECT_EXECUTION_NOT_EXISTS = new ErrorCode(1_008_003_000, "执行不存在");
+    ErrorCode PROJECT_EXECUTION_NAME_DUPLICATE = new ErrorCode(1_008_003_001, "当前项目下已经存在名称为【{}】的执行");
+    ErrorCode PROJECT_EXECUTION_OWNER_INVALID = new ErrorCode(1_008_003_002, "执行负责人必须是当前项目的有效成员");
+    ErrorCode PROJECT_EXECUTION_ASSIGNEE_INVALID = new ErrorCode(1_008_003_003, "执行协办人必须是当前项目的有效成员");
+    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, "当前执行协办人已失效");
+    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, "该项目成员仍担任未终态执行负责人，请先完成执行负责人交接");
+    ErrorCode PROJECT_EXECUTION_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_003_010, "执行状态定义不存在或已停用");
+    ErrorCode PROJECT_EXECUTION_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_003_011, "当前执行状态不支持动作【{}】");
+    ErrorCode PROJECT_EXECUTION_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_003_012, "动作【{}】必须填写原因");
+    ErrorCode PROJECT_EXECUTION_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_003_013, "执行状态已发生变化，请刷新后重试");
+    ErrorCode PROJECT_EXECUTION_STATUS_NOT_ALLOW_EDIT = new ErrorCode(1_008_003_014, "当前执行状态不允许维护执行");
+    ErrorCode PROJECT_EXECUTION_TYPE_INVALID = new ErrorCode(1_008_003_015, "执行类型不是有效字典值");
+    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_DELETE_NAME_MISMATCH = new ErrorCode(1_008_003_020, "确认执行名称与实际不一致");
+    ErrorCode PROJECT_EXECUTION_DELETE_CONFIRM_TEXT_INVALID = new ErrorCode(1_008_003_021, "删除确认口令必须为 DELETE 或 删除");
+
+    // ========== 任务管理 1-008-004-000 ==========
+    ErrorCode PROJECT_TASK_NOT_EXISTS = new ErrorCode(1_008_004_000, "任务不存在");
+    ErrorCode PROJECT_TASK_OWNER_INVALID = new ErrorCode(1_008_004_001, "任务负责人必须是当前执行的有效成员");
+    ErrorCode PROJECT_TASK_PARENT_INVALID = new ErrorCode(1_008_004_002, "父任务必须属于当前项目和执行");
+    ErrorCode PROJECT_TASK_NOT_ALLOW_EDIT = new ErrorCode(1_008_004_003, "当前项目或执行状态不允许维护任务");
+    ErrorCode PROJECT_TASK_STATUS_MODEL_NOT_EXISTS_OR_DISABLED = new ErrorCode(1_008_004_004, "任务状态定义不存在或已停用");
+    ErrorCode PROJECT_TASK_STATUS_ACTION_NOT_ALLOWED = new ErrorCode(1_008_004_005, "当前任务状态不支持动作【{}】");
+    ErrorCode PROJECT_TASK_STATUS_ACTION_REASON_REQUIRED = new ErrorCode(1_008_004_006, "动作【{}】必须填写原因");
+    ErrorCode PROJECT_TASK_STATUS_CONCURRENT_MODIFIED = new ErrorCode(1_008_004_007, "任务状态已发生变化，请刷新后重试");
+    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_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_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, "拆子任务前请先删除父任务下已填的工时记录");
+
+    // ========== 任务协办人 1_008_005_xxx ==========
+    ErrorCode PROJECT_TASK_ASSIGNEE_NOT_EXISTS = new ErrorCode(1_008_005_001, "任务协办人记录不存在");
+    ErrorCode PROJECT_TASK_ASSIGNEE_INVALID_MEMBER = new ErrorCode(1_008_005_002, "任务协办人必须是当前有效的执行成员");
+    ErrorCode PROJECT_TASK_ASSIGNEE_OWNER_CONFLICT = new ErrorCode(1_008_005_003, "任务协办人不能与任务负责人重复");
+    ErrorCode PROJECT_TASK_ASSIGNEE_ALREADY_ACTIVE = new ErrorCode(1_008_005_004, "该用户已是当前任务的活跃协办人");
+    ErrorCode PROJECT_TASK_ASSIGNEE_NOT_ACTIVE = new ErrorCode(1_008_005_005, "任务协办人记录已失效，无需重复操作");
+    ErrorCode PROJECT_TASK_ASSIGNEE_REASON_REQUIRED = new ErrorCode(1_008_005_006, "退出协办必须填写原因");
+
+    // ========== 任务工时 1_008_006_xxx ==========
+    ErrorCode PROJECT_TASK_WORKLOG_NOT_EXISTS = new ErrorCode(1_008_006_001, "任务工时记录不存在");
+    ErrorCode PROJECT_TASK_WORKLOG_NOT_LEAF_TASK = new ErrorCode(1_008_006_002, "父任务不允许填报工时，请到具体子任务填报");
+    ErrorCode PROJECT_TASK_WORKLOG_DURATION_INVALID = new ErrorCode(1_008_006_003, "工时小时数必须大于 0 且为 0.5 的整数倍");
+    ErrorCode PROJECT_TASK_WORKLOG_NOT_OWNER_OR_ASSIGNEE = new ErrorCode(1_008_006_004, "仅任务负责人或在岗协办人可填报工时");
+    ErrorCode PROJECT_TASK_WORKLOG_EDIT_NOT_OWN = new ErrorCode(1_008_006_005, "只能修改自己填报的工时记录");
+    ErrorCode PROJECT_TASK_WORKLOG_DELETE_FORBIDDEN = new ErrorCode(1_008_006_006, "仅记录填报人或任务负责人可删除该工时记录");
+    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, "工时进度与日期顺序不一致：早段进度不得高于晚段、晚段进度不得低于早段");
+
+    // ========== 任务 / 工时附件 1_008_007_xxx ==========
+    ErrorCode PROJECT_TASK_ATTACHMENT_TOO_MANY = new ErrorCode(1_008_007_001, "附件数量不能超过 {} 个");
+    ErrorCode PROJECT_TASK_ATTACHMENT_URL_INVALID = new ErrorCode(1_008_007_002, "附件地址非法，必须为 http/https URL 且长度不超过 1024");
+    ErrorCode PROJECT_TASK_ATTACHMENT_NAME_INVALID = new ErrorCode(1_008_007_003, "附件文件名不合法（必填且长度不超过 255）");
+    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, "只有不存在子需求，或子需求都处于已取消和已拒绝状态时，父需求才允许取消");
 }

rdms-project/rdms-project-api/src/main/java/com/njcn/rdms/module/project/enums/ProjectDictTypeConstants.java

@@ -0,0 +1,18 @@
+package com.njcn.rdms.module.project.enums;
+
+/**
+ * 项目域字典类型常量。
+ */
+public interface ProjectDictTypeConstants {
+
+    /**
+     * 项目类型。
+     */
+    String PROJECT_TYPE = "rdms_project_type";
+
+    /**
+     * 执行类型。
+     */
+    String EXECUTION_TYPE = "rdms_project_execution_type";
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ObjectActivityConstants.java

@@ -24,6 +24,7 @@ public final class ObjectActivityConstants {
 
     // ========== 审计业务类型 ==========
     public static final String PRODUCT_BIZ_TYPE = "product";
+    public static final String PROJECT_BIZ_TYPE = "project";
     public static final String MEMBER_BIZ_TYPE = "rdms_user_object_role";
 
     // ========== 产品对象动作 ==========
@@ -32,6 +33,34 @@ public final class ObjectActivityConstants {
     public static final String PRODUCT_ACTION_DELETE = "delete";
     public static final String PRODUCT_ACTION_CHANGE_MANAGER = "change_manager";
 
+    // ========== 项目对象动作 ==========
+    public static final String PROJECT_ACTION_CREATE = "create";
+    public static final String PROJECT_ACTION_UPDATE = "update";
+    public static final String PROJECT_ACTION_DELETE = "delete";
+    public static final String PROJECT_ACTION_CHANGE_MANAGER = "change_manager";
+    public static final String PROJECT_ACTION_AUTO_START = "auto_start";
+
+    // ========== 项目自动推进触发动作 ==========
+    public static final String PROJECT_TRIGGER_CREATE_EXECUTION = "create_execution";
+    public static final String PROJECT_TRIGGER_CREATE_TASK = "create_task";
+    public static final String PROJECT_TRIGGER_SCHEDULE_REQUIREMENT = "schedule_requirement";
+    /**
+     * 项目自动开始触发动作 —— 由执行 auto_start 反向触发。
+     * 与 {@link #EXECUTION_TRIGGER_AUTO_START} 同语义；项目侧用此名走 AUTO_START_TRIGGERS 白名单。
+     */
+    public static final String PROJECT_TRIGGER_EXECUTION_AUTO_START = "execution_auto_start";
+
+    // ========== 任务自动推进触发动作 ==========
+    /**
+     * 任务自动开始动作编码 —— owner 或协办人填报工时时由后端自动触发的状态流转动作。
+     * 对应 rdms_object_status_transition (object_type=task, action_code=auto_start,
+     * from=pending → to=active)。
+     * 修改 DB 该条记录的 action_code 时必须同步修改本常量；本常量被
+     * ProjectTaskServiceImpl#internalAutoStartByWorklog 引用。
+     * 后续若再增加"任务自动完成 / 执行自动开始"等同类语义，按 *_ACTION_AUTO_* 命名加在本分组。
+     */
+    public static final String TASK_ACTION_AUTO_START = "auto_start";
+
     // ========== 状态动作 ==========
     public static final String STATUS_ACTION_PAUSE = "pause";
     public static final String STATUS_ACTION_RESUME = "resume";
@@ -42,6 +71,25 @@ 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";
+    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";
+    public static final String EXECUTION_ACTION_CHANGE_OWNER = "change_execution_owner";
+    public static final String EXECUTION_ASSIGNEE_ACTION_ADD = "add_execution_assignee";
+    public static final String EXECUTION_ASSIGNEE_ACTION_REMOVE = "remove_execution_assignee";
+    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";
+
+    // ========== 任务协办人事件类型（B 模型 - 多行周期记录） ==========
+    public static final String TASK_ASSIGNEE_ACTION_JOIN = "join";
+    public static final String TASK_ASSIGNEE_ACTION_INACTIVE = "inactive";
+
+    // ========== 执行协办人事件类型（B 模型 - 多行周期记录） ==========
+    public static final String EXECUTION_ASSIGNEE_LOG_ACTION_JOIN = "join";
+    public static final String EXECUTION_ASSIGNEE_LOG_ACTION_INACTIVE = "inactive";
+    public static final String EXECUTION_ASSIGNEE_LOG_ACTION_OWNER_TRANSFER_IN = "owner_transfer_in";
+    public static final String EXECUTION_ASSIGNEE_LOG_ACTION_OWNER_TRANSFER_OUT = "owner_transfer_out";
 
     public static final List<String> STATUS_ACTION_TYPES = List.of(
             STATUS_ACTION_PAUSE, STATUS_ACTION_RESUME, STATUS_ACTION_ARCHIVE, STATUS_ACTION_ABANDON);
@@ -67,11 +115,33 @@ public final class ObjectActivityConstants {
             case PRODUCT_ACTION_CREATE -> "创建";
             case PRODUCT_ACTION_UPDATE -> "更新";
             case PRODUCT_ACTION_DELETE -> "删除";
+            case PROJECT_ACTION_AUTO_START -> "开始推进";
+            case PROJECT_TRIGGER_CREATE_EXECUTION -> "创建执行";
+            case PROJECT_TRIGGER_CREATE_TASK -> "创建任务";
+            case PROJECT_TRIGGER_SCHEDULE_REQUIREMENT -> "项目需求排期";
+            case PROJECT_TRIGGER_EXECUTION_AUTO_START -> "执行自动开始";
+            case EXECUTION_ACTION_CREATE -> "创建执行";
+            case EXECUTION_ACTION_UPDATE -> "更新执行";
+            case EXECUTION_ACTION_DELETE -> "删除执行";
+            case EXECUTION_ACTION_CHANGE_OWNER -> "变更执行负责人";
+            case EXECUTION_ASSIGNEE_ACTION_ADD -> "新增执行协办人";
+            case EXECUTION_ASSIGNEE_ACTION_REMOVE -> "移出执行协办人";
+            case TASK_ACTION_CREATE -> "创建任务";
+            case TASK_ACTION_UPDATE -> "更新任务";
+            case TASK_ACTION_DELETE -> "删除任务";
+            case TASK_ASSIGNEE_ACTION_JOIN -> "加入";
+            case TASK_ASSIGNEE_ACTION_INACTIVE -> "退出";
+            case EXECUTION_ASSIGNEE_LOG_ACTION_OWNER_TRANSFER_IN -> "转入负责人";
+            case EXECUTION_ASSIGNEE_LOG_ACTION_OWNER_TRANSFER_OUT -> "转出负责人";
+            case "start" -> "开始";
+            case "block" -> "阻塞";
+            case "complete" -> "完成";
+            case "cancel" -> "取消";
             case STATUS_ACTION_PAUSE -> "暂停";
             case STATUS_ACTION_RESUME -> "恢复";
             case STATUS_ACTION_ARCHIVE -> "归档";
             case STATUS_ACTION_ABANDON -> "废弃";
-            case PRODUCT_ACTION_CHANGE_MANAGER -> "切换产品经理";
+            case PRODUCT_ACTION_CHANGE_MANAGER -> "切换负责人";
             case MEMBER_ACTION_ADD -> "新增成员";
             case MEMBER_ACTION_UPDATE -> "调整成员";
             case MEMBER_ACTION_REMOVE -> "移出成员";

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ObjectRoleConstants.java

@@ -0,0 +1,28 @@
+package com.njcn.rdms.module.project.constant;
+
+import com.njcn.rdms.module.system.enums.permission.PermissionScopeTypeEnum;
+
+/**
+ * RDMS 对象角色与成员关系常量。
+ */
+public final class ObjectRoleConstants {
+
+    private ObjectRoleConstants() {
+    }
+
+    /**
+     * 对象级权限作用域，对应 sys_menu.scope_type = object。
+     */
+    public static final String ROLE_SCOPE_OBJECT = PermissionScopeTypeEnum.OBJECT.getScopeType();
+
+    /**
+     * 对象成员有效状态，对应 rdms_user_object_role.status = 0。
+     */
+    public static final Integer MEMBER_STATUS_ACTIVE = 0;
+
+    /**
+     * 对象成员失效状态，对应 rdms_user_object_role.status = 1。
+     */
+    public static final Integer MEMBER_STATUS_INACTIVE = 1;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProductObjectConstants.java

@@ -0,0 +1,51 @@
+package com.njcn.rdms.module.project.constant;
+
+/**
+ * 产品对象常量。
+ */
+public final class ProductObjectConstants {
+
+    private ProductObjectConstants() {
+    }
+
+    /**
+     * 产品对象类型，对应 rdms_user_object_role.object_type、rdms_object_status_model.object_type。
+     */
+    public static final String OBJECT_TYPE = "product";
+
+    /**
+     * 产品经理对象角色编码。该角色用于初始化与识别产品负责人。
+     */
+    public static final String MANAGER_ROLE_CODE = "product_manager";
+
+    /**
+     * 产品暂停状态。
+     */
+    public static final String STATUS_PAUSED = "paused";
+
+    /**
+     * 产品自动编码前缀。
+     */
+    public static final String CODE_PREFIX = "CNPD";
+
+    /**
+     * 产品编辑权限码。
+     */
+    public static final String PERMISSION_UPDATE = "project:product:update";
+
+    /**
+     * 产品状态动作权限码。
+     */
+    public static final String PERMISSION_STATUS = "project:product:status";
+
+    /**
+     * 产品删除权限码。
+     */
+    public static final String PERMISSION_DELETE = "project:product:delete";
+
+    /**
+     * 产品删除确认口令。
+     */
+    public static final String DELETE_CONFIRM_TEXT = "DELETE";
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectExecutionConstants.java

@@ -0,0 +1,60 @@
+package com.njcn.rdms.module.project.constant;
+
+import java.util.Set;
+
+/**
+ * 执行对象常量。
+ */
+public final class ProjectExecutionConstants {
+
+    private ProjectExecutionConstants() {
+    }
+
+    /**
+     * 执行对象类型，对应 rdms_object_status_model.object_type。
+     */
+    public static final String OBJECT_TYPE = "execution";
+
+    /**
+     * 执行业务类型。
+     */
+    public static final String BIZ_TYPE = "project_execution";
+
+    /**
+     * 创建执行权限码。
+     */
+    public static final String PERMISSION_CREATE = "project:execution:create";
+
+    /**
+     * 编辑执行权限码。
+     */
+    public static final String PERMISSION_UPDATE = "project:execution:update";
+
+    /**
+     * 执行负责人治理权限码。
+     */
+    public static final String PERMISSION_OWNER = "project:execution:owner";
+
+    /**
+     * 执行协办人治理权限码。
+     */
+    public static final String PERMISSION_ASSIGNEE = "project:execution:assignee";
+
+    /**
+     * 执行状态动作权限码。
+     */
+    public static final String PERMISSION_STATUS = "project:execution:status";
+
+    /**
+     * 删除执行权限码。
+     * 推荐挂"项目负责人"角色（参见 docs/项目/2026-05-11-执行按钮可见度对齐设计.md §6.4）。
+     */
+    public static final String PERMISSION_DELETE = "project:execution:delete";
+
+    /**
+     * 删除确认口令合法值集合；兼容大写英文 "DELETE" 与中文 "删除"，前端可纯中文文案。
+     * 校验时精确匹配（trim 后比对）。
+     */
+    public static final Set<String> DELETE_CONFIRM_TEXTS = Set.of("DELETE", "删除");
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectObjectConstants.java

@@ -0,0 +1,82 @@
+package com.njcn.rdms.module.project.constant;
+
+import java.util.Set;
+
+/**
+ * 项目对象常量。
+ */
+public final class ProjectObjectConstants {
+
+    private ProjectObjectConstants() {
+    }
+
+    /**
+     * 项目对象类型，对应 rdms_user_object_role.object_type、rdms_object_status_model.object_type。
+     */
+    public static final String OBJECT_TYPE = "project";
+
+    /**
+     * 项目经理对象角色编码。该角色用于初始化与识别项目负责人。
+     */
+    public static final String MANAGER_ROLE_CODE = "project_manager";
+
+    /**
+     * 项目游客对象角色编码。创建人未成为项目成员时，用于返回只读上下文菜单。
+     */
+    public static final String VISITOR_ROLE_CODE = "visitor";
+
+    /**
+     * 产品主线项目类型字典值。后续字典值收敛后，只需调整这里。
+     */
+    public static final Set<String> MAINLINE_PROJECT_TYPE_CODES = Set.of("mainline", "main", "product_mainline", "主线");
+
+    /**
+     * 已作废项目状态编码。当前作废项目不占用产品主线项目名额。
+     */
+    public static final String STATUS_CANCELLED = "cancelled";
+
+    /**
+     * 项目自动编码前缀。
+     */
+    public static final String CODE_PREFIX = "CNPJ";
+
+    /**
+     * 项目编辑权限码。
+     */
+    public static final String PERMISSION_UPDATE = "project:project:update";
+
+    /**
+     * 项目成员维护权限码。
+     */
+    public static final String PERMISSION_MEMBER = "project:project:member";
+
+    /**
+     * 项目状态动作权限码。
+     */
+    public static final String PERMISSION_STATUS = "project:project:status";
+
+    /**
+     * 项目拆分权限码。
+     */
+    public static final String PERMISSION_SPLIT = "project:project:split";
+
+    /**
+     * 项目删除权限码。
+     */
+    public static final String PERMISSION_DELETE = "project:project:delete";
+
+    /**
+     * 项目删除确认口令。
+     */
+    public static final String DELETE_CONFIRM_TEXT = "DELETE";
+
+    /**
+     * 可触发项目从待开始自动进入进行中的后端业务动作。
+     */
+    public static final Set<String> AUTO_START_TRIGGERS = Set.of(
+            ObjectActivityConstants.PROJECT_TRIGGER_CREATE_EXECUTION,
+            ObjectActivityConstants.PROJECT_TRIGGER_CREATE_TASK,
+            ObjectActivityConstants.PROJECT_TRIGGER_SCHEDULE_REQUIREMENT,
+            ObjectActivityConstants.PROJECT_TRIGGER_EXECUTION_AUTO_START);
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/constant/ProjectTaskConstants.java

@@ -0,0 +1,62 @@
+package com.njcn.rdms.module.project.constant;
+
+import java.util.Set;
+
+/**
+ * 任务对象常量。
+ */
+public final class ProjectTaskConstants {
+
+    private ProjectTaskConstants() {
+    }
+
+    /**
+     * 任务对象类型，对应 rdms_object_status_model.object_type。
+     */
+    public static final String OBJECT_TYPE = "task";
+
+    /**
+     * 任务业务类型。
+     */
+    public static final String BIZ_TYPE = "project_task";
+
+    /**
+     * 创建任务权限码。
+     */
+    public static final String PERMISSION_CREATE = "project:task:create";
+
+    /**
+     * 编辑任务权限码。
+     */
+    public static final String PERMISSION_UPDATE = "project:task:update";
+
+    /**
+     * 任务状态动作权限码。
+     */
+    public static final String PERMISSION_STATUS = "project:task:status";
+
+    /**
+     * 任务协办人维护权限码。
+     */
+    public static final String PERMISSION_ASSIGNEE = "project:task:assignee";
+
+    /**
+     * 任务工时维护权限码。
+     */
+    public static final String PERMISSION_WORKLOG = "project:task:worklog";
+
+    /**
+     * 删除任务权限码。
+     * 推荐挂"项目负责人"角色（参见 docs/项目/2026-05-11-执行按钮可见度对齐设计.md §6.4）。
+     * 实际拦截：service 内按 task.parentTaskId 分流走 checkOwnerOrProjectPermission
+     * （一级任务 → execution.ownerId 字段身份；子任务 → parentTask.ownerId 字段身份；不命中字段时回落本权限码）。
+     */
+    public static final String PERMISSION_DELETE = "project:task:delete";
+
+    /**
+     * 删除确认口令合法值集合；兼容大写英文 "DELETE" 与中文 "删除"，前端可纯中文文案。
+     * 校验时精确匹配（trim 后比对）。
+     */
+    public static final Set<String> DELETE_CONFIRM_TEXTS = Set.of("DELETE", "删除");
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductController.java

@@ -4,7 +4,9 @@ import com.njcn.rdms.framework.common.pojo.CommonResult;
 import com.njcn.rdms.framework.common.pojo.PageResult;
 import com.njcn.rdms.framework.common.util.object.BeanUtils;
 import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductContextRespVO;
+import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductCreateWithTeamReqVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductDeleteReqVO;
+import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductOverviewSummaryRespVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductPageReqVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductRespVO;
 import com.njcn.rdms.module.project.controller.admin.product.vo.product.ProductSaveReqVO;
@@ -38,6 +40,13 @@ public class ProductController {
         return success(productService.createProduct(createReqVO));
     }
 
+    @PostMapping("/create-with-team")
+    @Operation(summary = "创建产品并初始化团队（原子接口）")
+    @PreAuthorize("@ss.hasPermission('project:product:create')")
+    public CommonResult<Long> createProductWithTeam(@Valid @RequestBody ProductCreateWithTeamReqVO reqVO) {
+        return success(productService.createProductWithTeam(reqVO));
+    }
+
     @PutMapping("/update")
     @Operation(summary = "更新产品")
     public CommonResult<Boolean> updateProduct(@Valid @RequestBody ProductSaveReqVO updateReqVO) {
@@ -62,12 +71,17 @@ public class ProductController {
 
     @GetMapping("/page")
     @Operation(summary = "获取产品分页")
-    @PreAuthorize("@ss.hasPermission('project:product:query')")
     public CommonResult<PageResult<ProductRespVO>> getProductPage(@Valid ProductPageReqVO pageReqVO) {
         PageResult<ProductDO> pageResult = productService.getProductPage(pageReqVO);
         return success(BeanUtils.toBean(pageResult, ProductRespVO.class));
     }
 
+    @GetMapping("/overview-summary")
+    @Operation(summary = "获取产品入口页概览统计")
+    public CommonResult<ProductOverviewSummaryRespVO> getProductOverviewSummary() {
+        return success(productService.getProductOverviewSummary());
+    }
+
     @PostMapping("/change-status")
     @Operation(summary = "变更产品状态")
     public CommonResult<Boolean> changeProductStatus(@Valid @RequestBody ProductStatusActionReqVO reqVO) {

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/ProductRequirementController.java

@@ -81,8 +81,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,6 +101,16 @@ public class ProductRequirementController {
         return success(requirementService.getAllowedTransitions(requirementId, productId));
     }
 
+    @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));
+    }
+
     @GetMapping("/lifecycle")
     @Operation(summary = "获取需求生命周期信息")
     @Parameter(name = "requirementId", description = "需求编号", required = true, example = "1024")
@@ -113,8 +121,15 @@ public class ProductRequirementController {
         return success(requirementService.getRequirementLifecycle(requirementId, productId));
     }
 
-    // ========== 模块管理 ==========
+    @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 = "创建需求模块")
     public CommonResult<Long> createRequirementModule(@Valid @RequestBody ProductRequirementModuleReqVO reqVO) {

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductCreateWithTeamReqVO.java

@@ -0,0 +1,42 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.product;
+
+import com.njcn.rdms.module.project.controller.admin.product.vo.member.ProductMemberSaveReqVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 产品创建原子接口请求 VO（POST /project/product/create-with-team）。
+ *
+ * <p>由前端"产品两步向导"一次性提交：产品基础资料 + 初始团队成员。
+ * 后端必须在同一事务内完成全部写入，任一步失败整体回滚。
+ */
+@Schema(description = "管理后台 - 产品创建（含初始团队）Request VO")
+@Data
+public class ProductCreateWithTeamReqVO {
+
+    /**
+     * 产品基础资料。沿用 {@link ProductSaveReqVO} 字段约束（同 POST /create）。
+     */
+    @Schema(description = "产品基础资料", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "产品基础资料不能为空")
+    @Valid
+    private ProductSaveReqVO product;
+
+    /**
+     * 初始团队成员列表。
+     *
+     * <p>必须包含一条 {@code userId == product.managerUserId} 的产品经理成员，
+     * 由前端在打开第 2 步时按 role code = {@code product_manager} 反查 roleId 后聚合提交。
+     * 后端不再根据 {@code product.managerUserId} 自动追加经理成员。
+     */
+    @Schema(description = "初始团队成员（含产品经理本人）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "初始团队成员不能为空")
+    @Valid
+    private List<ProductMemberSaveReqVO> members;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/product/ProductOverviewSummaryRespVO.java

@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.product.vo.product;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.Map;
+
+@Schema(description = "管理后台 - 产品入口页概览统计 Response VO")
+@Data
+public class ProductOverviewSummaryRespVO {
+
+    @Schema(description = "产品状态数量，按当前启用的产品状态模型返回")
+    private Map<String, Long> statusCounts;
+
+}

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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementRespVO.java

@@ -1,5 +1,6 @@
 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 lombok.Data;
 
@@ -16,19 +17,19 @@ public class ProductRequirementRespVO {
     @Schema(description = "需求ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
     private Long id;
 
-    @Schema(description = "父需求ID（0表示顶级需求）", example = "0")
+    @Schema(description = "父需求ID，0 表示顶级需求", example = "0")
     private Long parentId;
 
     @Schema(description = "所属模块ID", example = "1024")
     private Long moduleId;
 
-    @Schema(description = "是否需要评审（0不需要；1需要）", example = "0")
+    @Schema(description = "是否需要评审，0不需要，1需要", example = "0")
     private Integer reviewRequired;
 
     @Schema(description = "需求标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "支持需求模块化管理")
     private String title;
 
-    @Schema(description = "需求描述（富文本）", example = "<p>详细描述需求内容</p>")
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
     private String description;
 
     @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
@@ -37,13 +38,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 = "中")
@@ -58,13 +59,16 @@ public class ProductRequirementRespVO {
     @Schema(description = "最近一次状态动作原因", example = "评审通过")
     private String lastStatusReason;
 
-    @Schema(description = "提出人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
     private Long proposerId;
 
     @Schema(description = "提出人用户姓名", example = "张三")
     private String proposerNickname;
 
-    @Schema(description = "当前处理人用户编号", example = "1024")
+    @Schema(description = "所需工时", example = "8")
+    private Double workHours;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
     private Long currentHandlerUserId;
 
     @Schema(description = "当前处理人姓名", example = "李四")
@@ -76,9 +80,6 @@ public class ProductRequirementRespVO {
     @Schema(description = "实现项目名称", example = "NPQS-10086")
     private String implementProjectName;
 
-    @Schema(description = "预期完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
-    private LocalDateTime completionDate;
-
     @Schema(description = "排序值", example = "0")
     private Integer sort;
 
@@ -88,10 +89,13 @@ public class ProductRequirementRespVO {
     @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
     private LocalDateTime updateTime;
 
-    @Schema(description = "子需求列表（树形结构）")
+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+
+    @Schema(description = "子需求列表，树形结构")
     private List<ProductRequirementRespVO> children;
 
-    @Schema(description = "是否为终态（已拒绝、已取消、已关闭）", example = "false")
+    @Schema(description = "是否为终态", example = "false")
     private Boolean terminal;
 
 }

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSaveReqVO.java

@@ -1,12 +1,14 @@
 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.LocalDateTime;
+import java.util.List;
 
 /**
  * 管理后台 - 产品需求保存 Request VO
@@ -22,10 +24,10 @@ public class ProductRequirementSaveReqVO {
     @NotNull(message = "产品编号不能为空")
     private Long productId;
 
-    @Schema(description = "所属模块ID（为空时归入全部需求）", example = "1024")
+    @Schema(description = "所属模块ID，为空时归入全部需求模块", example = "1024")
     private Long moduleId;
 
-    @Schema(description = "是否需要评审（0不需要；1需要）", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @Schema(description = "是否需要评审，0不需要，1需要", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
     @NotNull(message = "是否需要评审不能为空")
     private Integer reviewRequired;
 
@@ -34,7 +36,7 @@ public class ProductRequirementSaveReqVO {
     @Size(max = 200, message = "需求标题长度不能超过200个字符")
     private String title;
 
-    @Schema(description = "需求描述（富文本）", example = "<p>详细描述需求内容</p>")
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
     private String description;
 
     @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
@@ -42,25 +44,35 @@ public class ProductRequirementSaveReqVO {
     @Size(max = 64, message = "需求分类长度不能超过64个字符")
     private String category;
 
-    @Schema(description = "优先级（0低 1中 2高 3紧急）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
     @NotNull(message = "优先级不能为空")
     private Integer priority;
 
-    @Schema(description = "提出人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
     @NotNull(message = "提出人不能为空")
     private Long proposerId;
 
-    @Schema(description = "当前处理人用户编号", example = "1024")
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "所需工时", example = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
     private Long currentHandlerUserId;
 
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
     @Schema(description = "默认实现项目编号", example = "1024")
     private Long implementProjectId;
 
-    @Schema(description = "预期完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
-    @NotNull(message = "预期完成时间不能为空")
-    private LocalDateTime completionDate;
-
-    @Schema(description = "排序值（越小越靠前）", example = "0")
+    @Schema(description = "排序值，越小越靠前", example = "0")
     private Integer sort;
 
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementSplitReqVO.java

@@ -1,12 +1,14 @@
 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.LocalDateTime;
+import java.util.List;
 
 /**
  * 管理后台 - 产品需求拆分 Request VO
@@ -23,10 +25,10 @@ public class ProductRequirementSplitReqVO {
     @NotNull(message = "产品编号不能为空")
     private Long productId;
 
-    @Schema(description = "所属模块ID（为空时归入全部需求）", example = "1024")
+    @Schema(description = "所属模块ID，为空时归入全部需求模块", example = "1024")
     private Long moduleId;
 
-    @Schema(description = "是否需要评审（0不需要；1需要）", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @Schema(description = "是否需要评审，0不需要，1需要", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
     @NotNull(message = "是否需要评审不能为空")
     private Integer reviewRequired;
 
@@ -35,7 +37,7 @@ public class ProductRequirementSplitReqVO {
     @Size(max = 200, message = "需求标题长度不能超过200个字符")
     private String title;
 
-    @Schema(description = "需求描述（富文本）", example = "<p>详细描述需求内容</p>")
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
     private String description;
 
     @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
@@ -43,25 +45,35 @@ public class ProductRequirementSplitReqVO {
     @Size(max = 64, message = "需求分类长度不能超过64个字符")
     private String category;
 
-    @Schema(description = "优先级（0低 1中 2高 3紧急）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
     @NotNull(message = "优先级不能为空")
     private Integer priority;
 
-    @Schema(description = "提出人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
     @NotNull(message = "提出人不能为空")
     private Long proposerId;
 
-    @Schema(description = "当前处理人用户编号", example = "1024")
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "所需工时", example = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
     private Long currentHandlerUserId;
 
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
     @Schema(description = "默认实现项目编号", example = "1024")
     private Long implementProjectId;
 
-    @Schema(description = "预期完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
-    @NotNull(message = "预期完成时间不能为空")
-    private LocalDateTime completionDate;
-
-    @Schema(description = "排序值（越小越靠前）", example = "0")
+    @Schema(description = "排序值，越小越靠前", example = "0")
     private Integer sort;
 
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/product/vo/requirement/ProductRequirementUpdateReqVO.java

@@ -1,12 +1,14 @@
 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.LocalDateTime;
+import java.util.List;
 
 /**
  * 管理后台 - 产品需求编辑 Request VO
@@ -23,10 +25,10 @@ public class ProductRequirementUpdateReqVO {
     @NotNull(message = "产品ID不能为空")
     private Long productId;
 
-    @Schema(description = "所属模块ID（为空时归入全部需求）", example = "1024")
+    @Schema(description = "所属模块ID，为空时归入全部需求模块", example = "1024")
     private Long moduleId;
 
-    @Schema(description = "是否需要评审（0不需要；1需要）", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @Schema(description = "是否需要评审，0不需要，1需要", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
     @NotNull(message = "是否需要评审不能为空")
     private Integer reviewRequired;
 
@@ -35,7 +37,7 @@ public class ProductRequirementUpdateReqVO {
     @Size(max = 200, message = "需求标题长度不能超过200个字符")
     private String title;
 
-    @Schema(description = "需求描述（富文本）", example = "<p>详细描述需求内容</p>")
+    @Schema(description = "需求描述，支持富文本", example = "<p>详细描述需求内容</p>")
     private String description;
 
     @Schema(description = "需求分类字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "function")
@@ -43,25 +45,35 @@ public class ProductRequirementUpdateReqVO {
     @Size(max = 64, message = "需求分类长度不能超过64个字符")
     private String category;
 
-    @Schema(description = "优先级（0低 1中 2高 3紧急）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @Schema(description = "优先级，0低、1中、2高、3紧急", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
     @NotNull(message = "优先级不能为空")
     private Integer priority;
 
-    @Schema(description = "提出人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @Schema(description = "提出人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
     @NotNull(message = "提出人不能为空")
     private Long proposerId;
 
-    @Schema(description = "当前处理人用户编号", example = "1024")
+    @Schema(description = "提出人姓名", example = "张三")
+    private String proposerNickname;
+
+    @Schema(description = "所需工时", example = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @Schema(description = "当前处理人用户ID", example = "1024")
     private Long currentHandlerUserId;
 
+    @Schema(description = "当前处理人姓名", example = "李四")
+    private String currentHandlerUserNickname;
+
     @Schema(description = "默认实现项目编号", example = "1024")
     private Long implementProjectId;
 
-    @Schema(description = "预期完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
-    @NotNull(message = "预期完成时间不能为空")
-    private LocalDateTime completionDate;
-
-    @Schema(description = "排序值（越小越靠前）", example = "0")
+    @Schema(description = "排序值，越小越靠前", example = "0")
     private Integer sort;
 
+    @Schema(description = "附件列表")
+    @Valid
+    private List<AttachmentItem> attachments;
+
 }

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectController.java

@@ -0,0 +1,107 @@
+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.framework.common.util.object.BeanUtils;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectContextRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectCreateWithTeamReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectDeleteReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectOverviewSummaryRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectSaveReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.project.ProjectStatusActionReqVO;
+import com.njcn.rdms.module.project.dal.dataobject.project.ProjectDO;
+import com.njcn.rdms.module.project.service.project.ProjectService;
+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.security.access.prepost.PreAuthorize;
+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")
+@Validated
+public class ProjectController {
+
+    @Resource
+    private ProjectService projectService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建项目")
+    @PreAuthorize("@ss.hasPermission('project:project:create')")
+    public CommonResult<Long> createProject(@Valid @RequestBody ProjectSaveReqVO createReqVO) {
+        return success(projectService.createProject(createReqVO));
+    }
+
+    @PostMapping("/create-with-team")
+    @Operation(summary = "创建项目并初始化团队（原子接口）")
+    @PreAuthorize("@ss.hasPermission('project:project:create')")
+    public CommonResult<Long> createProjectWithTeam(@Valid @RequestBody ProjectCreateWithTeamReqVO reqVO) {
+        return success(projectService.createProjectWithTeam(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新项目")
+    public CommonResult<Boolean> updateProject(@Valid @RequestBody ProjectSaveReqVO updateReqVO) {
+        projectService.updateProject(updateReqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获取项目详情")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<ProjectRespVO> getProject(@RequestParam("id") Long id) {
+        return success(projectService.getProjectDetail(id));
+    }
+
+    @GetMapping("/{id}/context")
+    @Operation(summary = "获取项目上下文")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<ProjectContextRespVO> getProjectContext(@PathVariable("id") Long id) {
+        return success(projectService.getProjectContext(id));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取项目分页")
+    public CommonResult<PageResult<ProjectRespVO>> getProjectPage(@Valid ProjectPageReqVO pageReqVO) {
+        PageResult<ProjectDO> pageResult = projectService.getProjectPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, ProjectRespVO.class));
+    }
+
+    @GetMapping("/list-by-product")
+    @Operation(summary = "根据产品编号获取该产品下的全部项目")
+    @Parameter(name = "productId", description = "产品编号", required = true, example = "1024")
+    public CommonResult<List<ProjectRespVO>> getProjectListByProductId(@RequestParam("productId") Long productId) {
+        return success(projectService.getProjectListByProductId(productId));
+    }
+
+    @GetMapping("/overview-summary")
+    @Operation(summary = "获取项目入口页概览统计")
+    public CommonResult<ProjectOverviewSummaryRespVO> getProjectOverviewSummary() {
+        return success(projectService.getProjectOverviewSummary());
+    }
+
+    @PostMapping("/change-status")
+    @Operation(summary = "变更项目状态")
+    public CommonResult<Boolean> changeProjectStatus(@Valid @RequestBody ProjectStatusActionReqVO reqVO) {
+        projectService.changeProjectStatus(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/delete")
+    @Operation(summary = "删除项目")
+    public CommonResult<Boolean> deleteProject(@Valid @RequestBody ProjectDeleteReqVO reqVO) {
+        projectService.deleteProject(reqVO);
+        return success(true);
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectMemberController.java

@@ -0,0 +1,63 @@
+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.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;
+import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberUpdateReqVO;
+import com.njcn.rdms.module.project.service.project.ProjectMemberService;
+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")
+@Validated
+public class ProjectMemberController {
+
+    @Resource
+    private ProjectMemberService projectMemberService;
+
+    @GetMapping("/{id}/members")
+    @Operation(summary = "获取项目成员列表")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<List<ProjectMemberRespVO>> getProjectMemberList(@PathVariable("id") Long projectId) {
+        return success(projectMemberService.getProjectMemberList(projectId));
+    }
+
+    @PostMapping("/{id}/members")
+    @Operation(summary = "新增项目成员")
+    @Parameter(name = "id", description = "项目编号", required = true, example = "1024")
+    public CommonResult<Long> createProjectMember(@PathVariable("id") Long projectId,
+                                                  @Valid @RequestBody ProjectMemberSaveReqVO reqVO) {
+        return success(projectMemberService.createProjectMember(projectId, reqVO));
+    }
+
+    @PutMapping("/{id}/members/{memberId}")
+    @Operation(summary = "调整项目成员角色")
+    public CommonResult<Boolean> updateProjectMember(@PathVariable("id") Long projectId,
+                                                     @PathVariable("memberId") Long memberId,
+                                                     @Valid @RequestBody ProjectMemberUpdateReqVO reqVO) {
+        projectMemberService.updateProjectMember(projectId, memberId, reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/{id}/members/{memberId}/inactive")
+    @Operation(summary = "移出项目成员")
+    public CommonResult<Boolean> inactiveProjectMember(@PathVariable("id") Long projectId,
+                                                       @PathVariable("memberId") Long memberId,
+                                                       @Valid @RequestBody ProjectMemberInactiveReqVO reqVO) {
+        projectMemberService.inactiveProjectMember(projectId, memberId, reqVO);
+        return success(true);
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/ProjectRequirementController.java

@@ -0,0 +1,164 @@
+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.ProjectRequirementCloseReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementDeleteReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.vo.requirement.ProjectRequirementLifecycleRespVO;
+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));
+    }
+
+    @GetMapping("/lifecycle")
+    @Operation(summary = "获取需求生命周期信息")
+    @Parameter(name = "requirementId", description = "需求编号", required = true, example = "1024")
+    @Parameter(name = "projectId", description = "项目编号", required = true, example = "1024")
+    public CommonResult<ProjectRequirementLifecycleRespVO> getRequirementLifecycle(
+            @RequestParam("requirementId") Long requirementId,
+            @RequestParam("projectId") Long projectId) {
+        return success(requirementService.getRequirementLifecycle(requirementId, projectId));
+    }
+
+    @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());
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/ProjectExecutionAssigneeController.java

@@ -0,0 +1,70 @@
+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.PageResult;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee.ExecutionAssigneeInactiveReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee.ExecutionAssigneeLogPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee.ExecutionAssigneeLogRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee.ExecutionAssigneeRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee.ExecutionAssigneeSaveReqVO;
+import com.njcn.rdms.module.project.service.project.execution.ProjectExecutionAssigneeService;
+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.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+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/project/{projectId}/executions/{executionId}")
+@Validated
+public class ProjectExecutionAssigneeController {
+
+    @Resource
+    private ProjectExecutionAssigneeService projectExecutionAssigneeService;
+
+    @GetMapping("/assignees")
+    @Operation(summary = "获取执行协办人列表（仅当前活跃）")
+    public CommonResult<List<ExecutionAssigneeRespVO>> getExecutionAssigneeList(@PathVariable("projectId") Long projectId,
+                                                                                @PathVariable("executionId") Long executionId) {
+        return success(projectExecutionAssigneeService.getExecutionAssigneeList(projectId, executionId));
+    }
+
+    @PostMapping("/assignees")
+    @Operation(summary = "新增执行协办人（B 模型 - 每次新增一段）")
+    public CommonResult<Long> createExecutionAssignee(@PathVariable("projectId") Long projectId,
+                                                      @PathVariable("executionId") Long executionId,
+                                                      @Valid @RequestBody ExecutionAssigneeSaveReqVO reqVO) {
+        return success(projectExecutionAssigneeService.createExecutionAssignee(projectId, executionId, reqVO));
+    }
+
+    @PostMapping("/assignees/{assigneeId}/inactive")
+    @Operation(summary = "失效执行协办人（永久保留 removedReason）")
+    public CommonResult<Boolean> inactiveExecutionAssignee(@PathVariable("projectId") Long projectId,
+                                                           @PathVariable("executionId") Long executionId,
+                                                           @PathVariable("assigneeId") Long assigneeId,
+                                                           @Valid @RequestBody ExecutionAssigneeInactiveReqVO reqVO) {
+        projectExecutionAssigneeService.inactiveExecutionAssignee(projectId, executionId, assigneeId, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/assignee-logs")
+    @Operation(summary = "获取执行协办人变更历史（分页）")
+    public CommonResult<PageResult<ExecutionAssigneeLogRespVO>> getExecutionAssigneeLogPage(
+            @PathVariable("projectId") Long projectId,
+            @PathVariable("executionId") Long executionId,
+            @Valid ExecutionAssigneeLogPageReqVO reqVO) {
+        return success(projectExecutionAssigneeService.getExecutionAssigneeLogPage(projectId, executionId, reqVO));
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/ProjectExecutionController.java

@@ -0,0 +1,101 @@
+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.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;
+import com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution.ProjectExecutionStatusBoardReqVO;
+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.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;
+import com.njcn.rdms.module.project.service.project.ProjectStatusBoardService;
+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.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 项目执行")
+@RestController
+@RequestMapping("/project/project/{projectId}/executions")
+@Validated
+public class ProjectExecutionController {
+
+    @Resource
+    private ProjectExecutionService projectExecutionService;
+    @Resource
+    private ProjectStatusBoardService projectStatusBoardService;
+
+    @PostMapping
+    @Operation(summary = "创建执行")
+    public CommonResult<Long> createExecution(@PathVariable("projectId") Long projectId,
+                                              @Valid @RequestBody ProjectExecutionCreateReqVO reqVO) {
+        return success(projectExecutionService.createExecution(projectId, reqVO));
+    }
+
+    @PutMapping("/{executionId}")
+    @Operation(summary = "编辑执行")
+    public CommonResult<Boolean> updateExecution(@PathVariable("projectId") Long projectId,
+                                                 @PathVariable("executionId") Long executionId,
+                                                 @Valid @RequestBody ProjectExecutionUpdateReqVO reqVO) {
+        reqVO.setId(executionId);
+        projectExecutionService.updateExecution(projectId, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/{executionId}")
+    @Operation(summary = "获取执行详情")
+    public CommonResult<ProjectExecutionRespVO> getExecution(@PathVariable("projectId") Long projectId,
+                                                             @PathVariable("executionId") Long executionId) {
+        return success(projectExecutionService.getExecutionRespVO(projectId, executionId));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取执行分页")
+    public CommonResult<PageResult<ProjectExecutionRespVO>> getExecutionPage(@PathVariable("projectId") Long projectId,
+                                                                             @Valid ProjectExecutionPageReqVO reqVO) {
+        return success(projectExecutionService.getExecutionRespVOPage(projectId, reqVO));
+    }
+
+    @GetMapping("/status-board")
+    @Operation(summary = "获取执行状态看板")
+    public CommonResult<ProjectExecutionStatusBoardRespVO> getExecutionStatusBoard(@PathVariable("projectId") Long projectId,
+                                                                                   @Valid ProjectExecutionStatusBoardReqVO reqVO) {
+        return success(projectStatusBoardService.getExecutionStatusBoard(projectId, reqVO));
+    }
+
+    @PostMapping("/{executionId}/change-owner")
+    @Operation(summary = "变更执行负责人")
+    public CommonResult<Boolean> changeOwner(@PathVariable("projectId") Long projectId,
+                                             @PathVariable("executionId") Long executionId,
+                                             @Valid @RequestBody ProjectExecutionOwnerChangeReqVO reqVO) {
+        projectExecutionService.changeOwner(projectId, executionId, reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/{executionId}/change-status")
+    @Operation(summary = "变更执行状态")
+    public CommonResult<Boolean> changeStatus(@PathVariable("projectId") Long projectId,
+                                              @PathVariable("executionId") Long executionId,
+                                              @Valid @RequestBody ProjectExecutionStatusActionReqVO reqVO) {
+        projectExecutionService.changeExecutionStatus(projectId, executionId, reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/{executionId}")
+    @Operation(summary = "删除执行（仅初始态可删，三重确认）")
+    public CommonResult<Boolean> deleteExecution(@PathVariable("projectId") Long projectId,
+                                                 @PathVariable("executionId") Long executionId,
+                                                 @Valid @RequestBody ProjectExecutionDeleteReqVO reqVO) {
+        projectExecutionService.deleteExecution(projectId, executionId, reqVO);
+        return success(true);
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/assignee/ExecutionAssigneeInactiveReqVO.java

@@ -0,0 +1,17 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee;
+
+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 ExecutionAssigneeInactiveReqVO {
+
+    @Schema(description = "失效原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "阶段性退出")
+    @NotBlank(message = "失效原因不能为空")
+    @Size(max = 500, message = "失效原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/assignee/ExecutionAssigneeLogPageReqVO.java

@@ -0,0 +1,29 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - 执行协办人变更历史分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ExecutionAssigneeLogPageReqVO extends PageParam {
+
+    @Schema(description = "事件类型多选；不传表示全部",
+            example = "[\"join\",\"inactive\",\"owner_transfer_in\",\"owner_transfer_out\"]")
+    private List<String> actionTypes;
+
+    @Schema(description = "协办人用户编号；不传表示全部")
+    private Long userId;
+
+    @Schema(description = "起始时间（含），按 actionTime 比较")
+    private LocalDateTime startTime;
+
+    @Schema(description = "截止时间（含），按 actionTime 比较")
+    private LocalDateTime endTime;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/assignee/ExecutionAssigneeLogRespVO.java

@@ -0,0 +1,39 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 执行协办人变更历史 Response VO")
+@Data
+public class ExecutionAssigneeLogRespVO {
+
+    @Schema(description = "日志编号", example = "12001")
+    private Long id;
+
+    @Schema(description = "所属执行编号", example = "5001")
+    private Long executionId;
+
+    @Schema(description = "事件类型：join / inactive / owner_transfer_in / owner_transfer_out", example = "join")
+    private String actionType;
+
+    @Schema(description = "被操作人用户编号", example = "3002")
+    private Long userId;
+
+    @Schema(description = "被操作人昵称，返回时按当前用户信息回填")
+    private String userNicknameSnapshot;
+
+    @Schema(description = "操作人用户编号", example = "3001")
+    private Long operatorUserId;
+
+    @Schema(description = "操作人昵称，返回时按当前用户信息回填")
+    private String operatorNicknameSnapshot;
+
+    @Schema(description = "事件时间")
+    private LocalDateTime actionTime;
+
+    @Schema(description = "原因；inactive 必填，其余可空")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/assignee/ExecutionAssigneeRespVO.java

@@ -0,0 +1,27 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 执行协办人 Response VO")
+@Data
+public class ExecutionAssigneeRespVO {
+
+    @Schema(description = "协办人关系编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "7001")
+    private Long id;
+    @Schema(description = "所属执行编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "5001")
+    private Long executionId;
+    @Schema(description = "协办人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
+    private Long userId;
+    @Schema(description = "协办人用户昵称")
+    private String userNickname;
+    @Schema(description = "加入时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime joinedAt;
+    @Schema(description = "失效时间")
+    private LocalDateTime removedAt;
+    @Schema(description = "失效原因")
+    private String removedReason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/assignee/ExecutionAssigneeSaveReqVO.java

@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 执行协办人新增 Request VO")
+@Data
+public class ExecutionAssigneeSaveReqVO {
+
+    @Schema(description = "协办人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
+    @NotNull(message = "协办人用户不能为空")
+    private Long userId;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionCreateReqVO.java

@@ -0,0 +1,53 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+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;
+import java.util.List;
+
+/**
+ * 创建执行 Request VO。
+ * <p>
+ * 含 ownerId（必填）+ assigneeUserIds（创建时同步装配协办人）。
+ * 后续编辑主数据走 PUT + {@link ProjectExecutionUpdateReqVO}（不含 ownerId / 协办人字段，避免越权裂缝）。
+ */
+@Schema(description = "管理后台 - 执行创建 Request VO")
+@Data
+public class ProjectExecutionCreateReqVO {
+
+    @Schema(description = "执行名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "后端接口联调")
+    @NotBlank(message = "执行名称不能为空")
+    @Size(max = 200, message = "执行名称长度不能超过200个字符")
+    private String executionName;
+
+    @Schema(description = "执行类型，取值来自字典 rdms_project_execution_type", requiredMode = Schema.RequiredMode.REQUIRED, example = "feature")
+    @NotBlank(message = "执行类型不能为空")
+    @Size(max = 32, message = "执行类型长度不能超过32个字符")
+    private String executionType;
+
+    @Schema(description = "执行负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3001")
+    @NotNull(message = "执行负责人不能为空")
+    private Long ownerId;
+
+    @Schema(description = "关联项目需求编号，第一阶段只接受空值", example = "9001")
+    private Long projectRequirementId;
+
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "执行说明（接受 HTML 富文本，图片走 URL 引用；后端经全局 XSS Safelist 自动净化）",
+            example = "接口联调与问题跟踪")
+    @Size(max = 200000, message = "执行说明长度不能超过200000个字符")
+    private String executionDesc;
+
+    @Schema(description = "创建执行时同步写入的协办人用户编号列表", example = "[3002,3003]")
+    private List<Long> assigneeUserIds;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionDeleteReqVO.java

@@ -0,0 +1,31 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * 删除执行 Request VO。与项目侧 ProjectDeleteReqVO 同款三重确认（confirmText / executionName / reason）。
+ * 详见 docs/项目/2026-05-11-执行按钮可见度对齐设计.md §6.2.1。
+ */
+@Schema(description = "管理后台 - 执行删除 Request VO")
+@Data
+public class ProjectExecutionDeleteReqVO {
+
+    @Schema(description = "确认输入的执行名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "后端接口联调")
+    @NotBlank(message = "确认执行名称不能为空")
+    @Size(max = 200, message = "确认执行名称长度不能超过200个字符")
+    private String executionName;
+
+    @Schema(description = "删除确认口令，当前固定输入 DELETE", requiredMode = Schema.RequiredMode.REQUIRED, example = "DELETE")
+    @NotBlank(message = "删除确认口令不能为空")
+    @Size(max = 32, message = "删除确认口令长度不能超过32个字符")
+    private String confirmText;
+
+    @Schema(description = "删除原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "执行录入错误")
+    @NotBlank(message = "删除原因不能为空")
+    @Size(max = 500, message = "删除原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionLifecycleActionRespVO.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;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - 执行生命周期动作 Response VO")
+@Data
+@NoArgsConstructor
+public class ProjectExecutionLifecycleActionRespVO {
+
+    @Schema(description = "动作编码", example = "pause")
+    private String actionCode;
+
+    @Schema(description = "动作名称", example = "暂停")
+    private String actionName;
+
+    @Schema(description = "是否必须填写原因", example = "true")
+    private Boolean needReason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionOwnerChangeReqVO.java

@@ -0,0 +1,20 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 执行负责人变更 Request VO")
+@Data
+public class ProjectExecutionOwnerChangeReqVO {
+
+    @Schema(description = "新负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
+    @NotNull(message = "新负责人不能为空")
+    private Long newOwnerId;
+
+    @Schema(description = "变更原因", example = "负责人调整")
+    @Size(max = 500, message = "变更原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionPageReqVO.java

@@ -0,0 +1,37 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+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 ProjectExecutionPageReqVO extends PageParam {
+
+    @Schema(description = "关键词，匹配执行名称", example = "联调")
+    private String keyword;
+
+    @Schema(description = "执行类型", example = "feature")
+    @Size(max = 32, message = "执行类型长度不能超过32个字符")
+    private String executionType;
+
+    @Schema(description = "执行负责人用户编号", example = "3001")
+    private Long ownerId;
+
+    @Schema(description = "执行状态编码", example = "pending")
+    @Size(max = 32, message = "执行状态编码长度不能超过32个字符")
+    private String statusCode;
+
+    @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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionRespVO.java

@@ -0,0 +1,58 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+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 ProjectExecutionRespVO {
+
+    @Schema(description = "执行编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "5001")
+    private Long id;
+    @Schema(description = "所属项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2001")
+    private Long projectId;
+    @Schema(description = "关联项目需求编号")
+    private Long projectRequirementId;
+    @Schema(description = "执行名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "后端接口联调")
+    private String executionName;
+    @Schema(description = "执行类型", example = "feature")
+    private String executionType;
+    @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<ProjectExecutionLifecycleActionRespVO> availableActions;
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+    @Schema(description = "实际开始日期")
+    private LocalDate actualStartDate;
+    @Schema(description = "实际结束日期")
+    private LocalDate actualEndDate;
+    @Schema(description = "执行进度")
+    private BigDecimal progressRate;
+    @Schema(description = "执行说明")
+    private String executionDesc;
+    @Schema(description = "最近一次状态动作原因")
+    private String lastStatusReason;
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionStatusActionReqVO.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 jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 执行状态动作 Request VO")
+@Data
+public class ProjectExecutionStatusActionReqVO {
+
+    @Schema(description = "动作编码，如 start、pause、resume、cancel", requiredMode = Schema.RequiredMode.REQUIRED, example = "pause")
+    @NotBlank(message = "动作编码不能为空")
+    @Size(max = 32, message = "动作编码长度不能超过32个字符")
+    private String actionCode;
+
+    @Schema(description = "动作原因；是否必填由状态流转配置决定", example = "依赖环境暂不可用")
+    @Size(max = 500, message = "动作原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionStatusBoardReqVO.java

@@ -0,0 +1,32 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+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 = false)
+public class ProjectExecutionStatusBoardReqVO {
+
+    @Schema(description = "关键字，匹配执行名称", example = "联调")
+    private String keyword;
+
+    @Schema(description = "执行类型", example = "feature")
+    @Size(max = 32, message = "执行类型长度不能超过32个字符")
+    private String executionType;
+
+    @Schema(description = "执行负责人用户编号", 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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionStatusBoardRespVO.java

@@ -0,0 +1,35 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 执行状态看板 Response VO")
+@Data
+public class ProjectExecutionStatusBoardRespVO {
+
+    @Schema(description = "当前筛选条件下的执行总数", requiredMode = Schema.RequiredMode.REQUIRED, example = "18")
+    private Long total;
+
+    @Schema(description = "状态项列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<ProjectStatusBoardItemVO> items;
+
+    @Schema(description = "项目状态项")
+    @Data
+    public static class ProjectStatusBoardItemVO {
+
+        @Schema(description = "状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+        private String statusCode;
+        @Schema(description = "状态名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "待开始")
+        private String statusName;
+        @Schema(description = "数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+        private Long count;
+        @Schema(description = "排序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+        private Integer sort;
+        @Schema(description = "是否终态", example = "false")
+        private Boolean terminal;
+
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/execution/vo/execution/ProjectExecutionUpdateReqVO.java

@@ -0,0 +1,47 @@
+package com.njcn.rdms.module.project.controller.admin.project.execution.vo.execution;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDate;
+
+/**
+ * 编辑执行 Request VO（PUT 全字段语义）。
+ * <p>
+ * 不含 ownerId / assigneeUserIds：换负责人走 /change-owner 独立端点，协办人维护走 /assignees 独立端点。
+ * 详见 docs/项目/2026-05-11-执行按钮可见度对齐设计.md §6.3。
+ */
+@Schema(description = "管理后台 - 执行编辑 Request VO")
+@Data
+public class ProjectExecutionUpdateReqVO {
+
+    @Schema(description = "执行编号", example = "5001")
+    private Long id;
+
+    @Schema(description = "执行名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "后端接口联调")
+    @NotBlank(message = "执行名称不能为空")
+    @Size(max = 200, message = "执行名称长度不能超过200个字符")
+    private String executionName;
+
+    @Schema(description = "执行类型，取值来自字典 rdms_project_execution_type", requiredMode = Schema.RequiredMode.REQUIRED, example = "feature")
+    @NotBlank(message = "执行类型不能为空")
+    @Size(max = 32, message = "执行类型长度不能超过32个字符")
+    private String executionType;
+
+    @Schema(description = "关联项目需求编号，第一阶段只接受空值", example = "9001")
+    private Long projectRequirementId;
+
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "执行说明（接受 HTML 富文本，图片走 URL 引用；后端经全局 XSS Safelist 自动净化）",
+            example = "接口联调与问题跟踪")
+    @Size(max = 200000, message = "执行说明长度不能超过200000个字符")
+    private String executionDesc;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/ProjectTaskController.java

@@ -0,0 +1,97 @@
+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.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;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskStatusBoardRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskSaveReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.ProjectTaskStatusActionReqVO;
+import com.njcn.rdms.module.project.service.project.ProjectStatusBoardService;
+import com.njcn.rdms.module.project.service.project.task.ProjectTaskService;
+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.*;
+
+import static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 项目任务")
+@RestController
+@RequestMapping("/project/project/{projectId}/executions/{executionId}/tasks")
+@Validated
+public class ProjectTaskController {
+
+    @Resource
+    private ProjectTaskService projectTaskService;
+    @Resource
+    private ProjectStatusBoardService projectStatusBoardService;
+
+    @PostMapping
+    @Operation(summary = "创建任务")
+    public CommonResult<Long> createTask(@PathVariable("projectId") Long projectId,
+                                         @PathVariable("executionId") Long executionId,
+                                         @Valid @RequestBody ProjectTaskSaveReqVO reqVO) {
+        return success(projectTaskService.createTask(projectId, executionId, reqVO));
+    }
+
+    @PutMapping("/{taskId}")
+    @Operation(summary = "编辑任务")
+    public CommonResult<Boolean> updateTask(@PathVariable("projectId") Long projectId,
+                                            @PathVariable("executionId") Long executionId,
+                                            @PathVariable("taskId") Long taskId,
+                                            @Valid @RequestBody ProjectTaskSaveReqVO reqVO) {
+        reqVO.setId(taskId);
+        projectTaskService.updateTask(projectId, executionId, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/{taskId}")
+    @Operation(summary = "获取任务详情")
+    public CommonResult<ProjectTaskRespVO> getTask(@PathVariable("projectId") Long projectId,
+                                                   @PathVariable("executionId") Long executionId,
+                                                   @PathVariable("taskId") Long taskId) {
+        return success(projectTaskService.getTaskRespVO(projectId, executionId, taskId));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获取任务分页")
+    public CommonResult<PageResult<ProjectTaskRespVO>> getTaskPage(@PathVariable("projectId") Long projectId,
+                                                                   @PathVariable("executionId") Long executionId,
+                                                                   @Valid ProjectTaskPageReqVO reqVO) {
+        return success(projectTaskService.getTaskRespVOPage(projectId, executionId, reqVO));
+    }
+
+    @GetMapping("/status-board")
+    @Operation(summary = "获取任务状态看板")
+    public CommonResult<ProjectTaskStatusBoardRespVO> getTaskStatusBoard(@PathVariable("projectId") Long projectId,
+                                                                         @PathVariable("executionId") Long executionId,
+                                                                         @Valid ProjectTaskStatusBoardReqVO reqVO) {
+        return success(projectStatusBoardService.getTaskStatusBoard(projectId, executionId, reqVO));
+    }
+
+    @PostMapping("/{taskId}/change-status")
+    @Operation(summary = "变更任务状态")
+    public CommonResult<Boolean> changeStatus(@PathVariable("projectId") Long projectId,
+                                              @PathVariable("executionId") Long executionId,
+                                              @PathVariable("taskId") Long taskId,
+                                              @Valid @RequestBody ProjectTaskStatusActionReqVO reqVO) {
+        projectTaskService.changeTaskStatus(projectId, executionId, taskId, reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/{taskId}")
+    @Operation(summary = "删除任务（仅初始态可删，三重确认 + 执行 owner 硬卡）")
+    public CommonResult<Boolean> deleteTask(@PathVariable("projectId") Long projectId,
+                                            @PathVariable("executionId") Long executionId,
+                                            @PathVariable("taskId") Long taskId,
+                                            @Valid @RequestBody ProjectTaskDeleteReqVO reqVO) {
+        projectTaskService.deleteTask(projectId, executionId, taskId, reqVO);
+        return success(true);
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/TaskAssigneeController.java

@@ -0,0 +1,73 @@
+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.assignee.TaskAssigneeInactiveReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee.TaskAssigneeLogPageReqVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee.TaskAssigneeLogRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee.TaskAssigneeRespVO;
+import com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee.TaskAssigneeSaveReqVO;
+import com.njcn.rdms.module.project.service.project.task.assignee.TaskAssigneeService;
+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.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+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/project/{projectId}/executions/{executionId}/tasks/{taskId}")
+@Validated
+public class TaskAssigneeController {
+
+    @Resource
+    private TaskAssigneeService taskAssigneeService;
+
+    @GetMapping("/assignees")
+    @Operation(summary = "获取任务协办人列表（仅当前活跃）")
+    public CommonResult<List<TaskAssigneeRespVO>> getAssigneeList(@PathVariable("projectId") Long projectId,
+                                                                  @PathVariable("executionId") Long executionId,
+                                                                  @PathVariable("taskId") Long taskId) {
+        return success(taskAssigneeService.getAssigneeList(projectId, executionId, taskId));
+    }
+
+    @PostMapping("/assignees")
+    @Operation(summary = "加入任务协办人")
+    public CommonResult<Long> createAssignee(@PathVariable("projectId") Long projectId,
+                                             @PathVariable("executionId") Long executionId,
+                                             @PathVariable("taskId") Long taskId,
+                                             @Valid @RequestBody TaskAssigneeSaveReqVO reqVO) {
+        return success(taskAssigneeService.createAssignee(projectId, executionId, taskId, reqVO));
+    }
+
+    @PostMapping("/assignees/{assigneeId}/inactive")
+    @Operation(summary = "退出任务协办人")
+    public CommonResult<Boolean> inactiveAssignee(@PathVariable("projectId") Long projectId,
+                                                  @PathVariable("executionId") Long executionId,
+                                                  @PathVariable("taskId") Long taskId,
+                                                  @PathVariable("assigneeId") Long assigneeId,
+                                                  @Valid @RequestBody TaskAssigneeInactiveReqVO reqVO) {
+        taskAssigneeService.inactiveAssignee(projectId, executionId, taskId, assigneeId, reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/assignee-logs")
+    @Operation(summary = "获取任务协办人变更历史（分页）")
+    public CommonResult<PageResult<TaskAssigneeLogRespVO>> getAssigneeLogPage(@PathVariable("projectId") Long projectId,
+                                                                              @PathVariable("executionId") Long executionId,
+                                                                              @PathVariable("taskId") Long taskId,
+                                                                              @Valid TaskAssigneeLogPageReqVO reqVO) {
+        return success(taskAssigneeService.getAssigneeLogPage(projectId, executionId, taskId, reqVO));
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/TaskWorklogController.java

@@ -0,0 +1,73 @@
+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.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.project.task.worklog.TaskWorklogService;
+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.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 static com.njcn.rdms.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - 任务工时")
+@RestController
+@RequestMapping("/project/project/{projectId}/executions/{executionId}/tasks/{taskId}")
+@Validated
+public class TaskWorklogController {
+
+    @Resource
+    private TaskWorklogService taskWorklogService;
+
+    @GetMapping("/worklogs")
+    @Operation(summary = "获取任务工时分页")
+    public CommonResult<PageResult<TaskWorklogRespVO>> getWorklogPage(@PathVariable("projectId") Long projectId,
+                                                                      @PathVariable("executionId") Long executionId,
+                                                                      @PathVariable("taskId") Long taskId,
+                                                                      @Valid TaskWorklogPageReqVO reqVO) {
+        return success(taskWorklogService.getWorklogPage(projectId, executionId, taskId, reqVO));
+    }
+
+    @PostMapping("/worklogs")
+    @Operation(summary = "新增任务工时")
+    public CommonResult<Long> createWorklog(@PathVariable("projectId") Long projectId,
+                                            @PathVariable("executionId") Long executionId,
+                                            @PathVariable("taskId") Long taskId,
+                                            @Valid @RequestBody TaskWorklogSaveReqVO reqVO) {
+        return success(taskWorklogService.createWorklog(projectId, executionId, taskId, reqVO));
+    }
+
+    @PutMapping("/worklogs/{worklogId}")
+    @Operation(summary = "修改任务工时（仅自己）")
+    public CommonResult<Boolean> updateWorklog(@PathVariable("projectId") Long projectId,
+                                               @PathVariable("executionId") Long executionId,
+                                               @PathVariable("taskId") Long taskId,
+                                               @PathVariable("worklogId") Long worklogId,
+                                               @Valid @RequestBody TaskWorklogSaveReqVO reqVO) {
+        taskWorklogService.updateWorklog(projectId, executionId, taskId, worklogId, reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/worklogs/{worklogId}")
+    @Operation(summary = "删除任务工时（自己或任务负责人）")
+    public CommonResult<Boolean> deleteWorklog(@PathVariable("projectId") Long projectId,
+                                               @PathVariable("executionId") Long executionId,
+                                               @PathVariable("taskId") Long taskId,
+                                               @PathVariable("worklogId") Long worklogId) {
+        taskWorklogService.deleteWorklog(projectId, executionId, taskId, worklogId);
+        return success(true);
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskDeleteReqVO.java

@@ -0,0 +1,31 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * 删除任务 Request VO。与执行侧 / 项目侧同款三重确认（confirmText / taskName / reason）。
+ * 详见 docs/项目/2026-05-11-执行按钮可见度对齐设计.md §6.2.2。
+ */
+@Schema(description = "管理后台 - 任务删除 Request VO")
+@Data
+public class ProjectTaskDeleteReqVO {
+
+    @Schema(description = "确认输入的任务名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "接口契约对齐")
+    @NotBlank(message = "确认任务名称不能为空")
+    @Size(max = 200, message = "确认任务名称长度不能超过200个字符")
+    private String taskName;
+
+    @Schema(description = "删除确认口令，当前固定输入 DELETE", requiredMode = Schema.RequiredMode.REQUIRED, example = "DELETE")
+    @NotBlank(message = "删除确认口令不能为空")
+    @Size(max = 32, message = "删除确认口令长度不能超过32个字符")
+    private String confirmText;
+
+    @Schema(description = "删除原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "任务录入错误")
+    @NotBlank(message = "删除原因不能为空")
+    @Size(max = 500, message = "删除原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskLifecycleActionRespVO.java

@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - 任务生命周期动作 Response VO")
+@Data
+@NoArgsConstructor
+public class ProjectTaskLifecycleActionRespVO {
+
+    @Schema(description = "动作编码", example = "complete")
+    private String actionCode;
+
+    @Schema(description = "动作名称", example = "完成")
+    private String actionName;
+
+    @Schema(description = "是否必须填写原因", example = "true")
+    private Boolean needReason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskPageReqVO.java

@@ -0,0 +1,36 @@
+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;
+
+@Schema(description = "管理后台 - 任务分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectTaskPageReqVO extends PageParam {
+
+    @Schema(description = "关键词，匹配任务标题", example = "联调")
+    private String keyword;
+
+    @Schema(description = "父任务编号")
+    private Long parentTaskId;
+
+    @Schema(description = "任务负责人用户编号", example = "3002")
+    private Long ownerId;
+
+    @Schema(description = "任务状态编码", example = "pending")
+    @Size(max = 32, message = "任务状态编码长度不能超过32个字符")
+    private String statusCode;
+
+    @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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskRespVO.java

@@ -0,0 +1,85 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+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 ProjectTaskRespVO {
+
+    @Schema(description = "任务编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "9001")
+    private Long id;
+    @Schema(description = "所属项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2001")
+    private Long projectId;
+    @Schema(description = "所属执行编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "5001")
+    private Long executionId;
+    @Schema(description = "父任务编号")
+    private Long parentTaskId;
+    @Schema(description = "父任务负责人用户编号；一级任务为 null，子任务用于前端判断"
+            + "新增子任务/编辑/删除按钮显隐（详见前端联调清单 §4.3）", example = "3002")
+    private Long parentTaskOwnerId;
+    @Schema(description = "所属执行的负责人用户编号；前端判断一级任务"
+            + "新增/编辑/删除按钮显隐（一级任务执行负责人可自行调整）", example = "3001")
+    private Long executionOwnerId;
+    @Schema(description = "任务标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "接口联调任务")
+    private String taskTitle;
+    @Schema(description = "任务负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
+    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<ProjectTaskLifecycleActionRespVO> availableActions;
+    @Schema(description = "任务进度")
+    private BigDecimal progressRate;
+    @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 = "当前活跃协办人列表；详细变更历史见 assignee-logs 接口")
+    private List<TaskAssigneeView> assignees;
+    @Schema(description = "已填报工时合计（小时，0.5 颗粒）；逻辑删除的工时记录不计入。无记录默认为 0",
+            example = "8.0")
+    private BigDecimal totalSpentHours;
+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+
+    @Schema(description = "任务协办人轻量视图")
+    @Data
+    public static class TaskAssigneeView {
+        @Schema(description = "协办关系编号", example = "7001")
+        private Long id;
+        @Schema(description = "协办人用户编号", example = "3002")
+        private Long userId;
+        @Schema(description = "协办人昵称", example = "张三")
+        private String nickname;
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskSaveReqVO.java

@@ -0,0 +1,51 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+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.Size;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Schema(description = "管理后台 - 任务保存 Request VO")
+@Data
+public class ProjectTaskSaveReqVO {
+
+    @Schema(description = "任务编号", example = "9001")
+    private Long id;
+
+    @Schema(description = "父任务编号")
+    private Long parentTaskId;
+
+    @Schema(description = "任务标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "接口联调任务")
+    @NotBlank(message = "任务标题不能为空")
+    @Size(max = 300, message = "任务标题长度不能超过300个字符")
+    private String taskTitle;
+
+    @Schema(description = "任务负责人用户编号；子任务不传时继承父任务负责人", example = "3002")
+    private Long ownerId;
+
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "任务说明（接受 HTML 富文本，图片走 URL 引用；后端经全局 XSS Safelist 自动净化）",
+            example = "完成接口联调")
+    @Size(max = 200000, message = "任务说明长度不能超过200000个字符")
+    private String taskDesc;
+
+    @Schema(description = "初始协办人用户编号列表；仅在创建任务时生效，编辑任务时静默忽略。"
+            + "协办人通过独立接口管理，详见 /tasks/{id}/assignees")
+    private List<Long> assigneeUserIds;
+
+    @Schema(description = "附件列表；规则与限制详见 AttachmentValidator（数量上限、扩展名白/黑名单、URL 协议）")
+    @Valid
+    private List<AttachmentItem> attachments;
+
+}
+

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskStatusActionReqVO.java

@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+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 ProjectTaskStatusActionReqVO {
+
+    @Schema(description = "动作编码，如 auto_start、pause、resume、complete、cancel", 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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskStatusBoardReqVO.java

@@ -0,0 +1,31 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo;
+
+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 = false)
+public class ProjectTaskStatusBoardReqVO {
+
+    @Schema(description = "关键字，匹配任务标题", example = "联调")
+    private String keyword;
+
+    @Schema(description = "父任务编号", example = "9001")
+    private Long parentTaskId;
+
+    @Schema(description = "任务负责人用户编号", example = "3002")
+    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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/ProjectTaskStatusBoardRespVO.java

@@ -0,0 +1,35 @@
+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;
+
+@Schema(description = "管理后台 - 任务状态看板 Response VO")
+@Data
+public class ProjectTaskStatusBoardRespVO {
+
+    @Schema(description = "当前筛选条件下的任务总数", requiredMode = Schema.RequiredMode.REQUIRED, example = "24")
+    private Long total;
+
+    @Schema(description = "状态项列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<ProjectStatusBoardItemVO> items;
+
+    @Schema(description = "任务状态项")
+    @Data
+    public static class ProjectStatusBoardItemVO {
+
+        @Schema(description = "状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+        private String statusCode;
+        @Schema(description = "状态名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "待开始")
+        private String statusName;
+        @Schema(description = "数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "5")
+        private Long count;
+        @Schema(description = "排序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+        private Integer sort;
+        @Schema(description = "是否终态", example = "false")
+        private Boolean terminal;
+
+    }
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/assignee/TaskAssigneeInactiveReqVO.java

@@ -0,0 +1,17 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee;
+
+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 TaskAssigneeInactiveReqVO {
+
+    @Schema(description = "退出协办的原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "调整到其他任务")
+    @NotBlank(message = "退出协办必须填写原因")
+    @Size(max = 500, message = "原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/assignee/TaskAssigneeLogPageReqVO.java

@@ -0,0 +1,28 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - 任务协办人变更历史分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class TaskAssigneeLogPageReqVO extends PageParam {
+
+    @Schema(description = "事件类型多选；不传表示全部")
+    private List<String> actionTypes;
+
+    @Schema(description = "成员用户编号；不传表示全部")
+    private Long userId;
+
+    @Schema(description = "起始时间（含），按 actionTime 比较")
+    private LocalDateTime startTime;
+
+    @Schema(description = "截止时间（含），按 actionTime 比较")
+    private LocalDateTime endTime;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/assignee/TaskAssigneeLogRespVO.java

@@ -0,0 +1,39 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 任务协办人变更历史 Response VO")
+@Data
+public class TaskAssigneeLogRespVO {
+
+    @Schema(description = "日志编号", example = "8001")
+    private Long id;
+
+    @Schema(description = "任务编号", example = "9001")
+    private Long taskId;
+
+    @Schema(description = "事件类型：join / inactive", example = "join")
+    private String actionType;
+
+    @Schema(description = "被操作人用户编号", example = "3002")
+    private Long userId;
+
+    @Schema(description = "被操作人昵称快照")
+    private String userNicknameSnapshot;
+
+    @Schema(description = "操作人用户编号", example = "3001")
+    private Long operatorUserId;
+
+    @Schema(description = "操作人昵称快照")
+    private String operatorNicknameSnapshot;
+
+    @Schema(description = "事件时间")
+    private LocalDateTime actionTime;
+
+    @Schema(description = "原因；inactive 必填，join 可空")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/assignee/TaskAssigneeRespVO.java

@@ -0,0 +1,27 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 任务协办人 Response VO")
+@Data
+public class TaskAssigneeRespVO {
+
+    @Schema(description = "协办关系编号", example = "7001")
+    private Long id;
+
+    @Schema(description = "任务编号", example = "9001")
+    private Long taskId;
+
+    @Schema(description = "协办人用户编号", example = "3002")
+    private Long userId;
+
+    @Schema(description = "协办人昵称")
+    private String userNickname;
+
+    @Schema(description = "加入时间")
+    private LocalDateTime joinedAt;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/assignee/TaskAssigneeSaveReqVO.java

@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.assignee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 任务协办人加入 Request VO")
+@Data
+public class TaskAssigneeSaveReqVO {
+
+    @Schema(description = "协办人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3002")
+    @NotNull(message = "协办人用户编号不能为空")
+    private Long userId;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogPageReqVO.java

@@ -0,0 +1,24 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - 任务工时分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class TaskWorklogPageReqVO extends PageParam {
+
+    @Schema(description = "填报人用户编号；不传表示全部")
+    private Long userId;
+
+    @Schema(description = "查询区间起始日期（含），按段相交过滤（record.endDate >= startDate）")
+    private LocalDate startDate;
+
+    @Schema(description = "查询区间截止日期（含），按段相交过滤（record.startDate <= endDate）")
+    private LocalDate endDate;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogRespVO.java

@@ -0,0 +1,52 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog;
+
+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 TaskWorklogRespVO {
+
+    @Schema(description = "工时记录编号", example = "11001")
+    private Long id;
+
+    @Schema(description = "任务编号", example = "9001")
+    private Long taskId;
+
+    @Schema(description = "填报人用户编号", example = "3002")
+    private Long userId;
+
+    @Schema(description = "填报人昵称", example = "张三")
+    private String userNickname;
+
+    @Schema(description = "段起始日期（含），单天=与 endDate 相等", example = "2026-05-04")
+    private LocalDate startDate;
+
+    @Schema(description = "段结束日期（含），单天=与 startDate 相等", example = "2026-05-08")
+    private LocalDate endDate;
+
+    @Schema(description = "本次填报小时数（0.5 颗粒）", example = "8.0")
+    private BigDecimal durationHours;
+
+    @Schema(description = "本次填报进度（0~100）", example = "60.00")
+    private BigDecimal progressRate;
+
+    @Schema(description = "工作内容描述")
+    private String workContent;
+
+    @Schema(description = "附件列表")
+    private List<AttachmentItem> attachments;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updateTime;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/task/vo/worklog/TaskWorklogSaveReqVO.java

@@ -0,0 +1,57 @@
+package com.njcn.rdms.module.project.controller.admin.project.task.vo.worklog;
+
+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.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+
+/**
+ * 任务工时新增/更新请求。同表共用：updateWorklog 不接受 taskId / userId 切换，前端无需也无法传。
+ * 段语义：startDate / endDate 必填，单天 = 二者相等；同人同任务下日期范围禁止重叠（Service 层校验）。
+ * 颗粒：durationHours 必须 > 0 且为 0.5 的整数倍（Service 层校验）。
+ */
+@Schema(description = "管理后台 - 任务工时 Save Request VO")
+@Data
+public class TaskWorklogSaveReqVO {
+
+    @Schema(description = "段起始日期（含），单天=与 endDate 相等",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-05-04")
+    @NotNull(message = "段起始日期不能为空")
+    private LocalDate startDate;
+
+    @Schema(description = "段结束日期（含），单天=与 startDate 相等",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-05-08")
+    @NotNull(message = "段结束日期不能为空")
+    private LocalDate endDate;
+
+    @Schema(description = "本次填报小时数，> 0 且必须为 0.5 的整数倍",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "8.0")
+    @NotNull(message = "工时小时数不能为空")
+    @DecimalMin(value = "0.5", message = "工时小时数必须大于 0 且为 0.5 的整数倍")
+    private BigDecimal durationHours;
+
+    @Schema(description = "本次填报进度（0~100，必填）。owner 填报：以 owner 本人最新一条工时（按 end_date 排序）"
+            + "为准同步任务进度；协作人填报：仅作为本人自评个人完成度，不影响任务/父任务进度",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "60.00")
+    @NotNull(message = "本次填报进度不能为空")
+    @DecimalMin(value = "0.00", message = "本次填报进度不能小于 0")
+    @DecimalMax(value = "100.00", message = "本次填报进度不能大于 100")
+    private BigDecimal progressRate;
+
+    @Schema(description = "工作内容描述", example = "完成接口联调与冒烟测试")
+    @Size(max = 2000, message = "工作内容长度不能超过 2000 个字符")
+    private String workContent;
+
+    @Schema(description = "附件列表；规则与限制详见 AttachmentValidator（数量上限、扩展名白/黑名单、URL 协议）")
+    @Valid
+    private List<AttachmentItem> attachments;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberInactiveReqVO.java

@@ -0,0 +1,17 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+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 ProjectMemberInactiveReqVO {
+
+    @Schema(description = "移出原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "已退出当前项目协作")
+    @NotBlank(message = "移出原因不能为空")
+    @Size(max = 500, message = "移出原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberRespVO.java

@@ -0,0 +1,35 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 项目成员 Response VO")
+@Data
+public class ProjectMemberRespVO {
+
+    @Schema(description = "成员关系编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+    private Long userId;
+    @Schema(description = "用户昵称", example = "小王")
+    private String userNickname;
+    @Schema(description = "角色编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3100000002001")
+    private Long roleId;
+    @Schema(description = "角色名称", example = "项目经理")
+    private String roleName;
+    @Schema(description = "角色编码", example = "project_manager")
+    private String roleCode;
+    @Schema(description = "是否当前项目负责人", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean managerFlag;
+    @Schema(description = "状态（0有效 1失效）", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Integer status;
+    @Schema(description = "加入时间")
+    private LocalDateTime joinedTime;
+    @Schema(description = "退出时间")
+    private LocalDateTime leftTime;
+    @Schema(description = "备注", example = "当前负责需求收敛")
+    private String remark;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberSaveReqVO.java

@@ -0,0 +1,30 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 项目成员新增 Request VO")
+@Data
+public class ProjectMemberSaveReqVO {
+
+    @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;
+
+    @Schema(description = "原项目经理用户编号，仅切换项目经理时传递", example = "2048")
+    private Long previousManagerUserId;
+
+    @Schema(description = "原项目经理交接后的角色编号，仅切换项目经理时传递", example = "3100000002002")
+    private Long previousManagerRoleId;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/member/ProjectMemberUpdateReqVO.java

@@ -0,0 +1,30 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.member;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 项目成员更新 Request VO")
+@Data
+public class ProjectMemberUpdateReqVO {
+
+    @Schema(description = "角色编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3100000002002")
+    @NotNull(message = "角色编号不能为空")
+    private Long roleId;
+
+    @Schema(description = "变更原因", example = "职责调整")
+    @Size(max = 500, message = "变更原因长度不能超过500个字符")
+    private String reason;
+
+    @Schema(description = "备注", example = "调整为项目观察者")
+    @Size(max = 500, message = "备注长度不能超过500个字符")
+    private String remark;
+
+    @Schema(description = "原项目经理用户编号，仅切换项目经理时传递", example = "2048")
+    private Long previousManagerUserId;
+
+    @Schema(description = "原项目经理交接后的角色编号，仅切换项目经理时传递", example = "3100000002002")
+    private Long previousManagerRoleId;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextNavRespVO.java

@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 项目上下文导航 Response VO")
+@Data
+public class ProjectContextNavRespVO {
+
+    @Schema(description = "菜单编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3201")
+    private Long id;
+    @Schema(description = "菜单名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "概览")
+    private String name;
+    @Schema(description = "菜单路径", example = "/project/project/overview")
+    private String path;
+    @Schema(description = "菜单图标", example = "mdi:view-dashboard-outline")
+    private String icon;
+    @Schema(description = "显示顺序", example = "10")
+    private Integer sort;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextProjectRespVO.java

@@ -0,0 +1,37 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目上下文中的当前项目摘要 Response VO")
+@Data
+public class ProjectContextProjectRespVO {
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+    @Schema(description = "项目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CNPJ2026001")
+    private String projectCode;
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "客户交付项目")
+    private String projectName;
+    @Schema(description = "项目类型字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "delivery")
+    private String projectType;
+    @Schema(description = "项目方向字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "direction_value")
+    private String directionCode;
+    @Schema(description = "所属产品编号")
+    private Long productId;
+    @Schema(description = "项目负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long managerUserId;
+    @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<ProjectLifecycleActionRespVO> availableActions;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextRespVO.java

@@ -0,0 +1,23 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - 项目上下文 Response VO")
+@Data
+@NoArgsConstructor
+public class ProjectContextRespVO {
+
+    @Schema(description = "当前项目摘要")
+    private ProjectContextProjectRespVO currentProject;
+    @Schema(description = "当前用户在该项目下的角色信息")
+    private ProjectContextRoleRespVO currentRole;
+    @Schema(description = "当前项目下可见导航集合")
+    private List<ProjectContextNavRespVO> navs;
+    @Schema(description = "当前项目下按钮权限码集合")
+    private List<String> buttons;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectContextRoleRespVO.java

@@ -0,0 +1,19 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - 项目上下文中的当前角色 Response VO")
+@Data
+public class ProjectContextRoleRespVO {
+
+    @Schema(description = "对象角色编号", example = "3201")
+    private Long roleId;
+    @Schema(description = "对象角色编码", example = "project_manager")
+    private String roleCode;
+    @Schema(description = "对象角色名称", example = "项目经理")
+    private String roleName;
+    @Schema(description = "是否游客上下文", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    private Boolean guestFlag;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectCreateWithTeamReqVO.java

@@ -0,0 +1,43 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import com.njcn.rdms.module.project.controller.admin.project.vo.member.ProjectMemberSaveReqVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 项目创建原子接口请求 VO（POST /project/project/create-with-team）。
+ *
+ * <p>由前端"项目两步向导"一次性提交：项目基础资料 + 初始团队成员。
+ * 后端必须在同一事务内完成全部写入，任一步失败整体回滚。
+ */
+@Schema(description = "管理后台 - 项目创建（含初始团队）Request VO")
+@Data
+public class ProjectCreateWithTeamReqVO {
+
+    /**
+     * 项目基础资料。沿用 {@link ProjectSaveReqVO} 字段约束（同 POST /create）。
+     * 新增场景前端不传 {@code actualStartDate / actualEndDate}（实际日期由项目执行阶段才有值）。
+     */
+    @Schema(description = "项目基础资料", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "项目基础资料不能为空")
+    @Valid
+    private ProjectSaveReqVO project;
+
+    /**
+     * 初始团队成员列表。
+     *
+     * <p>必须包含一条 {@code userId == project.managerUserId} 的项目经理成员，
+     * 由前端在打开第 2 步时按 role code = {@code project_manager} 反查 roleId 后聚合提交。
+     * 后端不再根据 {@code project.managerUserId} 自动追加经理成员。
+     */
+    @Schema(description = "初始团队成员（含项目经理本人）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "初始团队成员不能为空")
+    @Valid
+    private List<ProjectMemberSaveReqVO> members;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectDeleteReqVO.java

@@ -0,0 +1,32 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+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;
+
+@Schema(description = "管理后台 - 项目删除 Request VO")
+@Data
+public class ProjectDeleteReqVO {
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目编号不能为空")
+    private Long id;
+
+    @Schema(description = "确认输入的项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "客户交付项目")
+    @NotBlank(message = "确认项目名称不能为空")
+    @Size(max = 200, message = "确认项目名称长度不能超过200个字符")
+    private String projectName;
+
+    @Schema(description = "删除确认口令，当前固定输入 DELETE", requiredMode = Schema.RequiredMode.REQUIRED, example = "DELETE")
+    @NotBlank(message = "删除确认口令不能为空")
+    @Size(max = 32, message = "删除确认口令长度不能超过32个字符")
+    private String confirmText;
+
+    @Schema(description = "删除原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "项目录入错误")
+    @NotBlank(message = "删除原因不能为空")
+    @Size(max = 500, message = "删除原因长度不能超过500个字符")
+    private String reason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectLifecycleActionRespVO.java

@@ -0,0 +1,21 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - 项目生命周期动作 Response VO")
+@Data
+@NoArgsConstructor
+public class ProjectLifecycleActionRespVO {
+
+    @Schema(description = "动作编码", example = "archive")
+    private String actionCode;
+
+    @Schema(description = "动作名称", example = "归档")
+    private String actionName;
+
+    @Schema(description = "是否必须填写原因", example = "true")
+    private Boolean needReason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectOverviewSummaryRespVO.java

@@ -0,0 +1,15 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.Map;
+
+@Schema(description = "管理后台 - 项目入口页概览统计 Response VO")
+@Data
+public class ProjectOverviewSummaryRespVO {
+
+    @Schema(description = "项目状态数量，按当前启用的项目状态模型返回")
+    private Map<String, Long> statusCounts;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectPageReqVO.java

@@ -0,0 +1,46 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import com.njcn.rdms.framework.common.pojo.PageParam;
+import com.njcn.rdms.framework.dict.validation.InDict;
+import com.njcn.rdms.module.system.enums.DictTypeConstants;
+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 ProjectPageReqVO extends PageParam {
+
+    @Schema(description = "关键词，匹配项目编码或项目名称", example = "CNPJ2026001")
+    private String keyword;
+
+    @Schema(description = "项目类型字典值", example = "delivery")
+    @Size(max = 32, message = "项目类型长度不能超过32个字符")
+    private String projectType;
+
+    @Schema(description = "项目方向字典值", example = "direction_value")
+    @InDict(type = DictTypeConstants.OBJECT_DIRECTION)
+    private String directionCode;
+
+    @Schema(description = "所属产品编号", example = "1001")
+    private Long productId;
+
+    @Schema(description = "项目负责人用户编号", example = "1024")
+    private Long managerUserId;
+
+    @Schema(description = "项目状态编码", example = "active")
+    @Size(max = 32, message = "项目状态编码长度不能超过32个字符")
+    private String statusCode;
+
+    @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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectRespVO.java

@@ -0,0 +1,57 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 项目 Response VO")
+@Data
+public class ProjectRespVO {
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+    @Schema(description = "项目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "CNPJ2026001")
+    private String projectCode;
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "客户交付项目")
+    private String projectName;
+    @Schema(description = "项目类型字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "delivery")
+    private String projectType;
+    @Schema(description = "项目方向字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "direction_value")
+    private String directionCode;
+    @Schema(description = "所属项目集编号")
+    private Long projectSetId;
+    @Schema(description = "所属产品编号")
+    private Long productId;
+    @Schema(description = "所属产品名称", example = "统一交付平台")
+    private String productName;
+    @Schema(description = "所属产品版本编号")
+    private Long productVersionId;
+    @Schema(description = "项目负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long managerUserId;
+    @Schema(description = "项目负责人昵称", example = "张三")
+    private String managerUserNickname;
+    @Schema(description = "项目状态编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "pending")
+    private String statusCode;
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+    @Schema(description = "实际开始日期")
+    private LocalDate actualStartDate;
+    @Schema(description = "实际结束日期")
+    private LocalDate actualEndDate;
+    @Schema(description = "项目进度缓存值")
+    private BigDecimal progressRate;
+    @Schema(description = "项目说明")
+    private String projectDesc;
+    @Schema(description = "最近一次状态动作原因")
+    private String lastStatusReason;
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectSaveReqVO.java

@@ -0,0 +1,64 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+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 ProjectSaveReqVO {
+
+    @Schema(description = "项目编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "项目编码，为空时由系统自动生成", example = "CNPJ2026001")
+    @Size(max = 64, message = "项目编码长度不能超过64个字符")
+    private String projectCode;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "客户交付项目")
+    @NotBlank(message = "项目名称不能为空")
+    @Size(max = 200, message = "项目名称长度不能超过200个字符")
+    private String projectName;
+
+    @Schema(description = "项目类型字典值", requiredMode = Schema.RequiredMode.REQUIRED, example = "delivery")
+    @NotBlank(message = "项目类型不能为空")
+    @Size(max = 32, message = "项目类型长度不能超过32个字符")
+    private String projectType;
+
+    @Schema(description = "项目方向字典值；未选产品时必填，选产品时以后端产品方向为准", example = "direction_value")
+    private String directionCode;
+
+    @Schema(description = "所属项目集编号，第一期预留", example = "1001")
+    private Long projectSetId;
+
+    @Schema(description = "所属产品编号，可为空", example = "1001")
+    private Long productId;
+
+    @Schema(description = "所属产品版本编号，第一期预留", example = "1001")
+    private Long productVersionId;
+
+    @Schema(description = "项目负责人用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目负责人不能为空")
+    private Long managerUserId;
+
+    @Schema(description = "计划开始日期")
+    private LocalDate plannedStartDate;
+
+    @Schema(description = "计划结束日期")
+    private LocalDate plannedEndDate;
+
+    @Schema(description = "实际开始日期")
+    private LocalDate actualStartDate;
+
+    @Schema(description = "实际结束日期")
+    private LocalDate actualEndDate;
+
+    @Schema(description = "项目说明", example = "客户定制交付")
+    @Size(max = 4000, message = "项目说明长度不能超过4000个字符")
+    private String projectDesc;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/project/ProjectStatusActionReqVO.java

@@ -0,0 +1,26 @@
+package com.njcn.rdms.module.project.controller.admin.project.vo.project;
+
+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;
+
+@Schema(description = "管理后台 - 项目状态动作 Request VO")
+@Data
+public class ProjectStatusActionReqVO {
+
+    @Schema(description = "项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "项目编号不能为空")
+    private Long id;
+
+    @Schema(description = "动作编码，如 pause、resume、complete、cancel、reopen、archive", requiredMode = Schema.RequiredMode.REQUIRED, example = "pause")
+    @NotBlank(message = "动作编码不能为空")
+    @Size(max = 32, message = "动作编码长度不能超过32个字符")
+    private String actionCode;
+
+    @Schema(description = "动作原因；是否必填由状态流转配置决定", example = "当前阶段受环境限制暂停推进")
+    @Size(max = 500, message = "动作原因长度不能超过500个字符")
+    private String reason;
+
+}

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;
+
+}

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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementLifecycleRespVO.java

@@ -0,0 +1,33 @@
+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 ProjectRequirementLifecycleRespVO {
+
+    @Schema(description = "当前状态编码", example = "implementing")
+    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<ProjectRequirementStatusTransitionRespVO> availableActions;
+
+}

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;
+
+}

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;
+
+}

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;
+
+}

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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementRespVO.java

@@ -0,0 +1,98 @@
+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.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 = "8")
+    private Double workHours;
+
+    @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;
+
+}

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.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 = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @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;
+
+}

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.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 = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @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;
+
+}

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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementStatusDictRespVO.java

@@ -0,0 +1,28 @@
+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_confirm")
+    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;
+
+}

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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/controller/admin/project/vo/requirement/ProjectRequirementUpdateReqVO.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.util.List;
+
+/**
+ * 管理后台 - 项目需求编辑 Request VO
+ */
+@Schema(description = "管理后台 - 项目需求编辑 Request VO")
+@Data
+public class ProjectRequirementUpdateReqVO {
+
+    @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 = "所属模块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 = "8")
+    @NotNull(message = "所需工时不能为空")
+    private Double workHours;
+
+    @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;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/attachment/AttachmentItem.java

@@ -0,0 +1,37 @@
+package com.njcn.rdms.module.project.dal.dataobject.attachment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * 附件项。
+ * <p>
+ * 既作为业务表 {@code attachments} JSON 列的元素类型，也直接用于 ReqVO/RespVO 透传。
+ * 文件本身由 rdms-system 的 file 模块上传到对象存储，本对象仅记录元数据。
+ */
+@Schema(description = "附件项")
+@Data
+public class AttachmentItem {
+
+    @Schema(description = "文件编号，来自 rdms-system 文件上传返回的 data.id。Long 以字符串保存，避免前端精度丢失",
+            example = "10001")
+    private String id;
+
+    @Schema(description = "文件访问 URL（http/https，长度 ≤ 1024）",
+            requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "http://oss.example.com/task/2026/05/abc.docx")
+    private String url;
+
+    @Schema(description = "原文件名（含扩展名，长度 ≤ 255）",
+            requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "需求评审记录.docx")
+    private String name;
+
+    @Schema(description = "文件大小（字节）", example = "245760")
+    private Long size;
+
+    @Schema(description = "MIME Content-Type（建议长度 ≤ 128）",
+            example = "application/vnd.openxmlformats-officedocument.wordprocessingml.document")
+    private String contentType;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/product/ProductRequirementDO.java

@@ -1,17 +1,20 @@
 package com.njcn.rdms.module.project.dal.dataobject.product;
 
+import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableId;
 import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
 import com.njcn.rdms.framework.mybatis.core.dataobject.BaseDO;
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 
-import java.time.LocalDateTime;
+import java.util.List;
 
 /**
  * 产品需求主表
  */
-@TableName("rdms_product_requirement")
+@TableName(value = "rdms_product_requirement", autoResultMap = true)
 @Data
 @EqualsAndHashCode(callSuper = true)
 public class ProductRequirementDO extends BaseDO {
@@ -22,11 +25,11 @@ public class ProductRequirementDO extends BaseDO {
     @TableId
     private Long id;
     /**
-     * 父需求ID（0表示顶级需求）
+     * 父需求ID，0 表示顶级需求
      */
     private Long parentId;
     /**
-     * 所属模块ID（0表示全部需求）
+     * 所属模块ID，空表示全部需求
      */
     private Long moduleId;
     /**
@@ -34,7 +37,7 @@ public class ProductRequirementDO extends BaseDO {
      */
     private Long productId;
     /**
-     * 是否需要评审（0不需要；1需要）
+     * 是否需要评审，0不需要，1需要
      */
     private Integer reviewRequired;
     /**
@@ -42,7 +45,7 @@ public class ProductRequirementDO extends BaseDO {
      */
     private String title;
     /**
-     * 需求描述（富文本）
+     * 需求描述，支持富文本
      */
     private String description;
     /**
@@ -50,7 +53,7 @@ public class ProductRequirementDO extends BaseDO {
      */
     private String category;
     /**
-     * 来源类型（manual:手工新增, work_order:工单流转）
+     * 来源类型，manual 表示手工新增，work_order 表示工单流转
      */
     private String sourceType;
     /**
@@ -58,7 +61,7 @@ public class ProductRequirementDO extends BaseDO {
      */
     private Long sourceBizId;
     /**
-     * 优先级（0低 1中 2高 3紧急）
+     * 优先级，0低、1中、2高、3紧急
      */
     private Integer priority;
     /**
@@ -74,9 +77,13 @@ public class ProductRequirementDO extends BaseDO {
      */
     private Long proposerId;
     /**
-     * 提出人用户姓名快照
+     * 提出人姓名快照
      */
     private String proposerNickname;
+    /**
+     * 所需工时
+     */
+    private Double workHours;
     /**
      * 当前处理人用户ID
      */
@@ -86,16 +93,17 @@ public class ProductRequirementDO extends BaseDO {
      */
     private String currentHandlerUserNickname;
     /**
-     * 默认实现项目ID（分流后填写）
+     * 默认实现项目ID，分流后可回填
      */
     private Long implementProjectId;
     /**
-     * 预期完成时间
-     */
-    private LocalDateTime completionDate;
-    /**
-     * 排序值（越小越靠前）
+     * 排序值，越小越靠前
      */
     private Integer sort;
+    /**
+     * 闄勪欢鍒楄〃锛圝SON锛夈€傚厓绱?{@link AttachmentItem}锛歩d / url / name / size / contentType銆?
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<AttachmentItem> attachments;
 
 }

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/project/ProjectDO.java

@@ -0,0 +1,90 @@
+package com.njcn.rdms.module.project.dal.dataobject.project;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.njcn.rdms.framework.mybatis.core.dataobject.BaseDO;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+/**
+ * 项目主表
+ */
+@TableName("rdms_project")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectDO extends BaseDO {
+
+    /**
+     * 项目编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 项目编码
+     */
+    private String projectCode;
+    /**
+     * 项目名称
+     */
+    private String projectName;
+    /**
+     * 项目类型字典值
+     */
+    private String projectType;
+    /**
+     * 项目方向字典值
+     */
+    private String directionCode;
+    /**
+     * 所属项目集编号，第一期预留
+     */
+    private Long projectSetId;
+    /**
+     * 所属产品编号，可为空
+     */
+    private Long productId;
+    /**
+     * 所属产品版本编号，第一期预留
+     */
+    private Long productVersionId;
+    /**
+     * 项目负责人用户编号
+     */
+    private Long managerUserId;
+    /**
+     * 项目状态编码
+     */
+    private String statusCode;
+    /**
+     * 计划开始日期
+     */
+    private LocalDate plannedStartDate;
+    /**
+     * 计划结束日期
+     */
+    private LocalDate plannedEndDate;
+    /**
+     * 实际开始日期
+     */
+    private LocalDate actualStartDate;
+    /**
+     * 实际结束日期
+     */
+    private LocalDate actualEndDate;
+    /**
+     * 项目进度缓存值
+     */
+    private BigDecimal progressRate;
+    /**
+     * 项目说明
+     */
+    private String projectDesc;
+    /**
+     * 最近一次状态动作原因
+     */
+    private String lastStatusReason;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/project/ProjectRequirementDO.java

@@ -0,0 +1,109 @@
+package com.njcn.rdms.module.project.dal.dataobject.project;
+
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import com.njcn.rdms.framework.mybatis.core.dataobject.BaseDO;
+import com.njcn.rdms.module.project.dal.dataobject.attachment.AttachmentItem;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 项目需求主表
+ */
+@TableName(value = "rdms_project_requirement", autoResultMap = true)
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectRequirementDO extends BaseDO {
+
+    /**
+     * 主键 ID
+     */
+    @TableId
+    private Long id;
+    /**
+     * 父需求 ID，0 表示顶级需求
+     */
+    private Long parentId;
+    /**
+     * 所属项目 ID
+     */
+    private Long projectId;
+    /**
+     * 所属模块 ID
+     */
+    private Long moduleId;
+    /**
+     * 产品需求id
+     */
+    private Long productRequirementId;
+    /**
+     * 是否需要评审，0 不需要，1 需要
+     */
+    private Integer reviewRequired;
+    /**
+     * 需求标题
+     */
+    private String title;
+    /**
+     * 需求描述，支持富文本
+     */
+    private String description;
+    /**
+     * 需求分类字典值
+     */
+    private String category;
+    /**
+     * 来源类型
+     */
+    private String sourceType;
+    /**
+     * 来源业务 ID
+     */
+    private Long sourceBizId;
+    /**
+     * 优先级
+     */
+    private Integer priority;
+    /**
+     * 当前状态编码
+     */
+    private String statusCode;
+    /**
+     * 最近一次状态动作原因
+     */
+    private String lastStatusReason;
+    /**
+     * 提出人用户 ID
+     */
+    private Long proposerId;
+    /**
+     * 提出人昵称快照
+     */
+    private String proposerNickname;
+    /**
+     * 当前处理人用户 ID
+     */
+    private Long currentHandlerUserId;
+    /**
+     * 当前处理人昵称快照
+     */
+    private String currentHandlerUserNickname;
+    /**
+     * 预估工时
+     */
+    private Double workHours;
+    /**
+     * 排序值
+     */
+    private Integer sort;
+    /**
+     * 闄勪欢鍒楄〃锛圝SON锛夈€傚厓绱?{@link AttachmentItem}锛歩d / url / name / size / contentType銆?
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<AttachmentItem> attachments;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/project/ProjectRequirementModuleDO.java

@@ -0,0 +1,47 @@
+package com.njcn.rdms.module.project.dal.dataobject.project;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.njcn.rdms.framework.mybatis.core.dataobject.BaseDO;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 项目需求模块表
+ */
+@TableName("rdms_project_requirement_module")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectRequirementModuleDO extends BaseDO {
+
+    /**
+     * 主键 ID
+     */
+    @TableId
+    private Long id;
+    /**
+     * 父模块 ID，0 表示顶级模块
+     */
+    private Long parentId;
+    /**
+     * 所属项目 ID
+     */
+    private Long projectId;
+    /**
+     * 模块名称
+     */
+    private String moduleName;
+    /**
+     * 模块说明
+     */
+    private String remark;
+    /**
+     * 图标
+     */
+    private String icon;
+    /**
+     * 排序值
+     */
+    private Integer sort;
+
+}

rdms-project/rdms-project-boot/src/main/java/com/njcn/rdms/module/project/dal/dataobject/project/ProjectRequirementStatusLogDO.java

@@ -0,0 +1,55 @@
+package com.njcn.rdms.module.project.dal.dataobject.project;
+
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.njcn.rdms.framework.mybatis.core.dataobject.BaseDO;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 项目需求状态变更日志表
+ */
+@TableName("rdms_project_requirement_status_log")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ProjectRequirementStatusLogDO extends BaseDO {
+
+    /**
+     * 主键 ID
+     */
+    @TableId
+    private Long id;
+    /**
+     * 需求 ID
+     */
+    private Long requirementId;
+    /**
+     * 动作编码
+     */
+    private String actionType;
+    /**
+     * 变更前状态
+     */
+    private String fromStatus;
+    /**
+     * 变更后状态
+     */
+    private String toStatus;
+    /**
+     * 动作原因
+     */
+    private String reason;
+    /**
+     * 操作人 ID
+     */
+    private Long operatorUserId;
+    /**
+     * 操作人名称快照
+     */
+    private String operatorName;
+    /**
+     * 需求标题快照
+     */
+    private String requirementTitleSnapshot;
+
+}