7.0 KiB
Spec: 项目管理能力
概述
本规范定义了项目管理模块的核心能力，包括项目的创建、查询、状态管理和归档功能。
ADDED Requirements
Requirement: 项目列表查询
系统 MUST 允许用户查询所有项目列表，支持按项目名称进行模糊搜索。
Scenario: 查询所有项目
Given 用户已登录系统并具有项目查看权限 When 用户进入项目管理页面 Then 系统显示所有项目列表，包括项目名称、描述、创建时间、状态、目标人数、预警人数
Scenario: 按名称搜索项目
Given 用户在项目管理页面 When 用户在搜索框输入"Q1初核"并点击搜索 Then 系统显示所有包含"Q1初核"的项目
Scenario: 项目状态标识
Given 项目列表中有多个不同状态的项目 When 用户查看项目列表 Then 进行中的项目显示蓝色标签，已完成的项目显示绿色标签，已归档的项目显示灰色标签
Scenario: 预警人数动态更新
Given 存在状态为"进行中"的项目 When 用户刷新项目列表 Then 预警人数显示最新的统计值
Requirement: 创建新项目
系统 MUST 允许用户创建新的初核项目，填写项目基本信息并选择参与人员。
Scenario: 创建标准项目
Given 用户在项目管理页面 When 用户点击"新建项目"按钮 Then 系统打开新增项目弹窗，包含项目名称、项目描述、时间范围、人员选择字段
Scenario: 必填字段验证
Given 用户新增项目时未填写项目名称 When 用户点击"确定"按钮 Then 系统提示"项目名称不能为空"
Scenario: 至少选择一名人员
Given 用户新增项目时未选择任何人员 When 用户点击"确定"按钮 Then 系统提示"请至少选择一名参与人员"
Scenario: 创建成功
Given 用户填写了完整的项目信息 When 用户点击"确定"按钮 Then 系统创建项目并提示"新增成功"，项目列表刷新显示新项目
Requirement: 导入历史项目
系统 MUST 允许用户从已完成的历史项目导入配置，快速创建新项目。
Scenario: 查看历史项目列表
Given 用户点击"导入历史项目"按钮 When 系统打开导入历史项目弹窗 Then 系统显示所有已完成状态的历史项目列表
Scenario: 选择历史项目
Given 用户在导入历史项目弹窗中 When 用户选择一个历史项目 Then 系统显示该项目的详细信息（人员范围、配置等）
Scenario: 复制配置创建新项目
Given 用户选择了历史项目并填写了新项目名称 When 用户点击"确定"按钮 Then 系统创建新项目，复制原项目的人员和配置，状态为"进行中"
Requirement: 项目状态管理
系统 MUST 支持项目状态的流转和管理。
Scenario: 进入进行中的项目
Given 存在状态为"进行中"的项目 When 用户点击"进入项目"按钮 Then 系统跳转到该项目的工作台页面
Scenario: 查看已完成项目结果
Given 存在状态为"已完成"的项目 When 用户点击"查看结果"按钮 Then 系统跳转到该项目的初核结果总览页面
Scenario: 重新分析已完成项目
Given 存在状态为"已完成"的项目 When 用户点击"重新分析"按钮 Then 系统基于原有数据重新运行风险模型，更新预警人数和结果
Scenario: 重新分析权限控制
Given 用户没有重新分析的权限 When 用户查看项目列表 Then 不显示"重新分析"按钮
Requirement: 项目归档
系统 MUST 允许用户将已结束的项目归档，并生成PDF归档文件。
Scenario: 归档已完成项目
Given 存在状态为"已完成"的项目 When 用户点击"归档"按钮 Then 系统生成PDF归档文件，更新项目状态为"已归档"
Scenario: 归档状态校验
Given 存在状态为"进行中"的项目 When 用户尝试归档该项目 Then 系统提示"只能归档已完成的项目"
Scenario: 归档文件下载
Given 存在已归档的项目 When 用户点击"下载归档"按钮 Then 系统下载该项目的PDF归档文件
Scenario: 归档项目不显示在默认列表
Given 存在已归档的项目 When 用户查看项目列表 Then 默认不显示已归档的项目
Scenario: 查看归档项目
Given 用户想查看已归档的项目 When 用户勾选"显示已归档"选项 Then 系统在列表中显示已归档的项目
Requirement: 项目数据模型
系统 MUST 使用正确的数据结构存储项目信息。
Scenario: 项目基础信息存储
Given 创建新项目 When 系统保存项目数据 Then 数据库存储：项目ID、项目名称、项目描述、创建时间、状态、目标人数、预警人数
Scenario: 项目人员关联存储
Given 项目包含多名参与人员 When 系统保存项目数据 Then 人员在关联表中存储，包含项目ID、人员ID、人员姓名（冗余）
Scenario: 状态枚举值
Given 项目状态字段 When 系统存储项目状态 Then 状态值为：'0'进行中、'1'已完成、'2'已归档
Requirement: API接口规范
系统 MUST 提供符合RESTful规范的API接口。
Scenario: 查询项目列表API
Given 前端需要获取项目列表
When 调用 GET /dpc/project/list?projectName=xxx&pageNum=1&pageSize=10
Then 返回分页数据，包含total、rows、code、msg
Scenario: 创建项目API
Given 前端需要创建新项目
When 调用 POST /dpc/project 并传递项目数据
Then 返回操作结果，code为200表示成功
Scenario: 归档项目API
Given 前端需要归档项目
When 调用 POST /dpc/project/archive/{projectId}
Then 系统执行归档操作并返回结果
Scenario: 权限校验
Given 用户没有相应的权限 When 调用需要权限的API Then 返回403错误，提示无权限访问
Requirement: 前端用户体验
系统 MUST 提供友好的用户交互体验。
Scenario: 响应式布局
Given 用户使用不同分辨率的设备 When 用户访问项目管理页面 Then 页面布局自适应，所有功能可用
Scenario: 操作反馈
Given 用户执行操作 When 操作成功或失败 Then 系统显示明确的成功或错误提示消息
Scenario: 加载状态
Given 数据加载需要时间 When 用户请求数据 Then 系统显示loading加载状态
相关能力
- 用户管理能力：依赖用户系统获取人员信息
- 部门管理能力：依赖部门系统进行部门范围选择
- 文件管理能力：依赖文件上传功能处理项目附件和归档PDF
- 项目工作台能力：进入项目后跳转到工作台（后续实现）
- 初核结果能力：查看结果跳转到结果页（后续实现）