ccdi/openspec/changes/add-project-management/tasks.md

# Tasks: 项目管理模块开发

本文档列出了实现项目管理模块的具体开发任务，按优先级和依赖关系排序。

## 阶段1：基础架构搭建

### 1.1 创建数据库表
- [ ] 创建 `ccdi_project` 表
- [ ] 创建 `ccdi_project_person` 表
- [ ] 创建索引和外键约束
- [ ] 准备测试数据

**验证**：执行SQL脚本，表结构创建成功，可以使用 `DESC ccdi_project;` 查看表结构

### 1.2 创建后端模块结构
- [ ] 创建 `ruoyi-dpc` 新模块
- [ ] 配置模块 `pom.xml` 依赖
- [ ] 在根 `pom.xml` 中添加模块引用
- [ ] 在 `ruoyi-admin` 的 `pom.xml` 中添加对 `ruoyi-dpc` 的依赖
- [ ] 配置 Spring 扫描 `com.ruoyi.dpc.controller` 包
- [ ] 创建包结构：`com.ruoyi.dpc.controller`, `com.ruoyi.dpc.domain`, `com.ruoyi.dpc.mapper`, `com.ruoyi.dpc.service`

**验证**：项目可以正常编译启动

### 1.3 创建实体类和DTO
- [ ] 创建 `CcdiProject.java` 实体类（使用 `@Data` 注解，不继承 BaseEntity）
- [ ] 创建 `CcdiProjectPerson.java` 实体类（使用 `@Data` 注解）
- [ ] 创建 `CcdiProjectVO.java` 视图对象
- [ ] 创建 `CcdiProjectQueryVO.java` 查询视图对象
- [ ] 创建 `CcdiProjectDTO.java` 数据传输对象（新增/修改）
- [ ] 创建 `CcdiProjectQueryDTO.java` 查询DTO
- [ ] 创建 `CcdiProjectImportDTO.java` 导入DTO
- [ ] 为审计字段添加 `@TableField` 注解配置自动填充

**验证**：实体类和DTO编译通过，字段注解正确

### 1.4 创建DTO转换工具类
- [ ] 创建 `CcdiProjectConverter.java` 工具类
- [ ] 实现 `toEntity(CcdiProjectDTO)` 方法
- [ ] 实现 `toVO(CcdiProject)` 方法
- [ ] 实现 `toVOList(List<CcdiProject>)` 方法

**验证**：转换逻辑正确，覆盖所有字段

### 1.5 配置审计字段自动填充
- [ ] 创建 `CcdiMetaObjectHandler.java` 实现 `MetaObjectHandler` 接口
- [ ] 实现 `insertFill` 方法自动填充 `create_by` 和 `create_time`
- [ ] 实现 `updateFill` 方法自动填充 `update_by` 和 `update_time`
- [ ] 从 Spring Security 上下文获取当前登录用户
- [ ] 将处理器注册为 Spring 组件（`@Component`）

**验证**：插入和更新操作时审计字段自动填充

## 阶段2：数据访问层开发

### 2.1 创建Mapper接口
- [ ] 创建 `CcdiProjectMapper.java`（使用 MyBatis Plus）
- [ ] 创建 `CcdiProjectPersonMapper.java`（使用 MyBatis Plus）

### 2.2 创建Mapper XML
- [ ] 创建 `CcdiProjectMapper.xml`
- [ ] 创建 `CcdiProjectPersonMapper.xml`
- [ ] 定义基础CRUD SQL（MyBatis Plus 自动生成）
- [ ] 定义关联查询SQL（项目+人员）

**验证**：可以使用MyBatis Log查看SQL执行正确

## 阶段3：服务层开发

### 3.1 创建Service接口
- [ ] 创建 `ICcdiProjectService.java`
- [ ] 定义方法签名：
  - `List<CcdiProject> selectProjectList(CcdiProject project)`
  - `CcdiProject selectProjectById(Long projectId)`
  - `int insertProject(CcdiProject project)`
  - `int updateProject(CcdiProject project)`
  - `int deleteProjectByIds(Long[] projectIds)`
  - `boolean checkProjectNameUnique(CcdiProject project)`
  - `void archiveProject(Long projectId)`
  - `void reanalyzeProject(Long projectId)`

### 3.2 实现Service
- [ ] 创建 `CcdiProjectServiceImpl.java`
- [ ] 使用 `@Resource` 注入依赖
- [ ] 实现基础CRUD方法
- [ ] 实现项目名称唯一性校验
- [ ] 实现项目归档逻辑（状态检查、PDF生成）
- [ ] 实现重新分析逻辑（异步任务）

**验证**：单元测试通过，业务逻辑符合需求

## 阶段4：控制器层开发

### 4.1 创建Controller
- [ ] 创建 `CcdiProjectController.java`（位于 `ruoyi-dpc` 模块的 `com.ruoyi.dpc.controller` 包中）
- [ ] 实现列表查询接口 `GET /dpc/project/list`
- [ ] 实现详情查询接口 `GET /dpc/project/{id}`
- [ ] 实现新增接口 `POST /dpc/project`
- [ ] 实现修改接口 `PUT /dpc/project`
- [ ] 实现删除接口 `DELETE /dpc/project/{ids}`
- [ ] 实现归档接口 `POST /dpc/project/archive/{id}`
- [ ] 实现重新分析接口 `POST /dpc/project/reanalyze/{id}`
- [ ] 实现导入历史项目接口 `POST /dpc/project/import`

### 4.2 添加权限注解
- [ ] 为所有接口添加 `@PreAuthorize` 注解
- [ ] 配置权限字符串：
  - `dpc:project:list`
  - `dpc:project:query`
  - `dpc:project:add`
  - `dpc:project:edit`
  - `dpc:project:remove`
  - `dpc:project:archive`
  - `dpc:project:reanalyze`

### 4.3 添加操作日志
- [ ] 为关键操作添加 `@Log` 注解
- [ ] 配置业务类型

**验证**：使用Postman测试所有接口，返回正确

## 阶段4.5：生成API文档

### 4.5.1 生成接口文档
- [ ] 使用 SpringDoc/Knife4j 生成 API 文档
- [ ] 在项目文件目录下导出 API 文档

**验证**：API 文档生成成功，包含所有接口

## 阶段5：前端API开发

### 5.1 创建API文件
- [ ] 创建 `ruoyi-ui/src/api/dpcProject.js`
- [ ] 封装所有API请求方法：
  - `listProject(query)`
  - `getProject(projectId)`
  - `addProject(data)`
  - `updateProject(data)`
  - `delProject(projectIds)`
  - `archiveProject(projectId)`
  - `reanalyzeProject(projectId)`
  - `importProject(data)`

**验证**：API方法可以正常调用

## 阶段6：前端页面开发

### 6.1 创建项目列表页
- [ ] 创建 `ruoyi-ui/src/views/dpcProject/index.vue`
- [ ] 实现搜索区域（项目名称输入框、搜索按钮）
- [ ] 实现操作按钮（新建、导入历史项目）
- [ ] 实现数据表格（项目信息展示）
- [ ] 实现状态标签（进行中/已完成/已归档）
- [ ] 实现操作列（进入项目、查看结果、重新分析、归档）

### 6.2 创建新增/编辑弹窗
- [ ] 创建 `ruoyi-ui/src/views/dpcProject/add-or-edit.vue`
- [ ] 实现项目基本信息表单（项目名称、描述、时间范围）
- [ ] 实现人员选择器（多选）
- [ ] 实现表单验证

### 6.3 创建导入历史项目弹窗
- [ ] 创建 `ruoyi-ui/src/views/dpcProject/import-history.vue`
- [ ] 实现历史项目列表（只显示已完成项目）
- [ ] 实现项目详情预览
- [ ] 实现新项目配置

**验证**：页面显示正常，交互流畅

## 阶段7：菜单与权限配置

### 7.1 创建系统菜单
- [ ] 在系统管理 > 菜单管理中创建"项目管理"菜单
- [ ] 配置菜单图标和路由（路径：`dpcProject`）
- [ ] 创建子菜单/按钮权限

### 7.2 配置角色权限
- [ ] 为管理员角色分配项目管理权限
- [ ] 为其他角色配置适当权限

**验证**：登录后可以看到项目管理菜单

## 阶段8：测试与优化

### 8.1 功能测试
- [ ] 测试项目创建流程
- [ ] 测试项目搜索功能
- [ ] 测试项目状态流转
- [ ] 测试项目归档功能
- [ ] 测试重新分析功能
- [ ] 测试导入历史项目功能

### 8.2 边界测试
- [ ] 测试必填字段验证
- [ ] 测试项目名称唯一性
- [ ] 测试状态权限控制
- [ ] 测试数据权限

### 8.3 性能优化
- [ ] 优化SQL查询
- [ ] 添加必要的数据库索引
- [ ] 优化大数据量列表加载

**验证**：所有测试用例通过，无明显性能问题

## 阶段9：文档与交付

### 9.1 代码注释
- [ ] 为所有公开方法添加JavaDoc注释
- [ ] 为复杂逻辑添加行内注释

### 9.2 更新系统文档
- [ ] 更新数据库设计文档
- [ ] 更新API接口文档
- [ ] 更新用户操作手册

**验证**：文档完整、准确

## 任务依赖关系

```
阶段1 (基础架构)
  ↓
阶段2 (数据访问层) → 阶段3 (服务层) → 阶段4 (控制器层) → 阶段4.5 (API文档)
                                                                     ↓
阶段5 (前端API) ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ← ←
  ↓
阶段6 (前端页面)
  ↓
阶段7 (菜单权限)
  ↓
阶段8 (测试优化)
  ↓
阶段9 (文档交付)
```

## 可并行开发任务

以下任务可以并行开发：
- 阶段2和阶段3（后端不同层级）
- 阶段5和阶段6的前端页面组件
- 阶段7的菜单配置可以在后端开发完成后进行

## 预计工作量

| 阶段 | 预计工时 |
|-----|---------|
| 阶段1 | 0.5天 |
| 阶段2 | 0.5天 |
| 阶段3 | 1天 |
| 阶段4 | 1天 |
| 阶段5 | 0.5天 |
| 阶段6 | 2天 |
| 阶段7 | 0.5天 |
| 阶段8 | 1天 |
| 阶段9 | 0.5天 |
| **总计** | **7.5天** |