# 系统更新通知

**更新日期：** 2026年1月22日

---

## 📋 更新概览

本次更新主要包含以下内容：
- ✨ 扩展任务搜索功能，支持搜索任务卡片的所有信息
- 🔒 一级需求部门发起任务必须上传预览图
- 🎨 任务卡片增加一级需求人显示，优化长名字显示
- 🐛 修复流水线任务异常扣分问题
- 🐛 修复需求部门看不到一级需求任务的问题
- 🐛 修复需求部门负责人无法驳回任务的问题
- 🐛 修复筛选功能搜索报错问题
- 🐛 修复 SQL 查询错误

---

## ✨ 新增功能

### 1. 扩展任务搜索功能

**功能描述：** 任务搜索功能现在支持搜索任务卡片的所有信息，不再仅限于任务标题和编号。

**搜索范围包括：**
- ✅ 任务标题 (`title`)
- ✅ 任务编号 (`task_no`)
- ✅ SPU信息 (`spu_info`)
- ✅ 备注信息 (`remark`)
- ✅ 产品条码 (`product_barcodes`)
- ✅ 发布人姓名 (`publisher_name`)
- ✅ 发布人部门名称 (`publisher_dept_name`)
- ✅ 品牌名称 (`brand_name`)
- ✅ 类目名称 (`category_name`)
- ✅ 平台名称 (`platform_name`)
- ✅ 任务类型名称 (`task_type_name`)
- ✅ 一级需求人姓名 (`primary_publisher_name`)
- ✅ 一级需求部门名称 (`primary_publisher_dept_name`)
- ✅ 需求部门发起人姓名 (`detail_completer_name`)
- ✅ 接收人姓名 (`receiver_name`)

**适用场景：**
- 任务大厅搜索
- 进行中任务搜索
- 已完成任务搜索
- 子任务搜索

**使用示例：**
- 搜索品牌名称（如"卓禾"）可以找到该品牌的所有任务
- 搜索发布人姓名可以找到该用户发布的所有任务
- 搜索一级需求人姓名可以找到该用户发起的一级需求任务

---

### 2. 一级需求部门必须上传预览图

**功能描述：** 一级需求部门用户发起任务时，系统强制要求上传预览图。

**实现方式：**
- 前端验证：表单验证规则中添加预览图必填验证
- 后端验证：创建任务时检查预览图是否上传
- 用户提示：预览图上传区域显示明确的必填提示

**影响范围：**
- 一级需求部门用户创建普通任务
- 一级需求部门用户创建流水线任务

**用户体验：**
- 如果未上传预览图，提交时会显示错误提示："一级需求部门发起任务必须上传预览图"
- 预览图上传区域会显示红色警告图标和提示文字

---

### 3. 任务卡片增加一级需求人显示

**功能描述：** 对于一级需求部门发起的任务，任务卡片现在会显示一级需求人和需求部门发起人的信息，让任务来源更加清晰。

**显示内容：**
- ✅ **一级需求人**：显示一级需求部门发起人的姓名和部门名称（橙色标识）
- ✅ **需求部门发起人**：显示补充任务明细的需求部门成员姓名（绿色标识）
- ✅ **发布人**：显示任务的发布人姓名（默认绿色标识）

**显示逻辑：**
- 如果是一级需求任务（`isPrimaryTask=1`）：
  - 显示"一级需求人"（如果存在）
  - 显示"需求部门发起人"（如果存在，即已补充明细）
  - 否则显示"发布人"
- 如果是普通任务：
  - 显示"发布人"

**优化内容：**
- 一级需求人名字超过 8 个字符时显示省略号
- 需求部门发起人名字超过 8 个字符时显示省略号
- 发布人名字超过 8 个字符时显示省略号
- 鼠标悬停时通过 Tooltip 显示完整信息（包含部门名称）

**显示效果：**
- 一级需求任务示例：
  - `一级需求人: 张三... (运营中心...)`（橙色）
  - `需求部门发起人: 李四...`（绿色）
- 悬停提示：`一级需求人: 张三丰 (运营中心A-事业二部)`

**适用位置：**
- 任务大厅任务卡片
- 进行中任务卡片
- 已完成任务卡片
- 我发起的任务卡片
- 待审核任务卡片
- 草稿箱任务卡片
- 子任务卡片

---

## 🐛 问题修复

### 1. 修复流水线任务异常扣分问题

**问题描述：**
- 流水线任务的子任务按时完成后，主任务仍然被系统检查进度更新情况
- 导致已完成子任务的用户被错误扣分
- 影响范围：所有流水线任务的接收人

**问题原因：**
- 进度检查服务 (`ProgressCheckService`) 在检查任务进度时，没有区分流水线任务的主任务和子任务
- 流水线任务的主任务 (`is_pipeline=1`) 在子任务完成后，主任务状态仍为 `in_progress`，但主任务本身不需要更新进度
- 系统错误地对主任务进行了进度检查，导致已完成子任务的用户被扣分

**解决方案：**
- 修改 `ProgressCheckService.checkDailyProgressUpdate()` 方法
- 在进度检查时排除流水线任务的主任务（`is_pipeline=1`）
- 只对流水线任务的子任务进行进度检查
- 清理了历史错误扣分记录（共 21 条）

**修复效果：**
- ✅ 流水线任务的主任务不再被检查进度
- ✅ 已完成子任务的用户不会再被错误扣分
- ✅ 历史错误扣分记录已清理

**影响用户：**
- 所有流水线任务的接收人
- 特别是已完成子任务但主任务仍在进行中的用户

---

### 2. 修复需求部门看不到一级需求任务的问题

**问题描述：**
- 需求部门负责人审核通过一级需求部门的任务后，在"进行中任务"中看不到该任务
- 需求部门成员补充完任务明细并发布后，在"进行中任务"中也看不到该任务
- 影响范围：所有需求部门负责人和成员

**问题原因：**
- 一级需求部门的任务在需求部门负责人审核通过后，状态变为 `pending_detail_completion`（待明细完善）
- 此时任务的 `publisher_dept_id` 是一级需求部门的 ID，不是需求部门的 ID
- 需求部门负责人的"进行中任务"查询只按 `publisherDeptIds` 过滤，无法找到这些任务
- 需求部门成员的"进行中任务"查询只查询 `role='publisher'` 的任务，无法找到作为 `detail_completer` 的任务

**解决方案：**
- **后端修改：**
  - 在 `TaskController.getTaskList` 中添加 `includeDetailCompleterDeptIds` 参数
  - 在 `TaskService.getTaskList` 中添加按明细完善人部门查询的逻辑
  - 在 `TaskController.getMyTasks` 中添加 `role='detail_completer'` 支持
  - 新增 `TaskService.getMyDetailCompleterTasks` 方法，查询用户作为明细完善人的任务
- **前端修改：**
  - 需求部门负责人查看"进行中任务"时，传递 `includeDetailCompleterDeptIds` 参数
  - 需求部门成员查看"进行中任务"时，同时查询 `publisher` 和 `detail_completer` 角色的任务并合并结果

**修复效果：**
- ✅ 需求部门负责人可以在"进行中任务"中看到已审核通过的一级需求任务
- ✅ 需求部门成员可以在"进行中任务"中看到自己作为明细完善人的任务
- ✅ 任务状态流转更加清晰，用户能正确跟踪任务进度

**影响用户：**
- 所有需求部门负责人
- 所有需求部门成员

---

### 3. 修复需求部门负责人无法驳回任务的问题

**问题描述：**
- 需求部门负责人在驳回一级需求部门的任务时，系统报错："需求部门负责人不存在"
- 导致需求部门负责人无法正常驳回任务
- 影响范围：所有需求部门负责人

**问题原因：**
- 一级需求部门的任务被驳回时，系统尝试将任务返回给需求部门的负责人
- 但某些一级需求部门（`dept_type='primary_demand'`）可能没有设置 `leader_id`
- 当 `TaskApprovalService.rejectByReceivingLeader` 方法检查 `demandDept.getLeaderId()` 时，如果为 `null`，会抛出异常

**解决方案：**
- 修改 `TaskApprovalService.rejectByReceivingLeader` 方法
- 当需求部门的 `leader_id` 为 `null` 时，不再抛出异常
- 改为将任务的 `currentApproverId` 设置为任务的 `publisherId`，将任务返回给原始发起人
- 这样即使需求部门没有负责人，任务也能正常被驳回并返回给发起人

**修复效果：**
- ✅ 需求部门负责人可以正常驳回一级需求部门的任务
- ✅ 即使需求部门没有负责人，任务也能正常被驳回
- ✅ 任务会正确返回给原始发起人

**影响用户：**
- 所有需求部门负责人
- 特别是需要驳回一级需求部门任务的负责人

---

### 4. 修复筛选功能搜索报错

**问题描述：**
- 错误信息：`TypeError: Assignment to constant variable`
- 触发场景：在任务大厅、进行中任务、已完成任务等页面使用筛选功能时

**问题原因：**
- 使用 `v-model` 绑定 `reactive` 对象时，Vue 尝试重新赋值整个对象
- `reactive` 对象不能直接重新赋值，导致报错

**解决方案：**
- 将所有 `TaskFilters` 组件的 `v-model` 改为 `:model-value` 和 `@update:model-value`
- 在事件处理函数中使用 `Object.assign` 更新对象属性，而不是重新赋值整个对象

**修复的筛选器：**
- ✅ 可接任务筛选 (`filters`)
- ✅ 待审核任务筛选 (`reviewFilters`)
- ✅ 进行中任务筛选 (`inProgressFilters`)
- ✅ 已完成任务筛选 (`completedFilters`)
- ✅ 我发起的任务筛选 (`publishedFilters`)
- ✅ 草稿箱筛选 (`draftsFilters`)

---

### 4. 修复 SQL 查询错误

**问题描述：**
- 错误信息：`Unknown column 't.description' in 'where clause'`
- 触发场景：使用搜索功能时

**问题原因：**
- 在扩展搜索功能时，SQL 查询中引用了 `task` 表中不存在的 `description` 字段

**解决方案：**
- 从所有 SQL 查询中移除了对 `t.description` 字段的引用
- 修复了以下文件中的查询：
  - `TaskMapper.java` - `selectTaskHall` 和 `selectTaskHallByDept` 方法
  - `TaskItemMapper.java` - 所有子任务查询方法
  - `TaskService.java` - `getCompletedTasks` 方法

---

## 📝 技术细节

### 前端修改

**文件：** `frontend/src/views/TaskHall.vue`
- 导入 `Tooltip` 组件
- 添加 `truncateText` 辅助函数
- 修改所有显示需求人名字的地方，添加 Tooltip 和截断显示
- 修复 `v-model` 绑定问题，改用 `:model-value` 和 `@update:model-value`
- **修复需求部门看不到一级需求任务：**
  - 需求部门负责人查看"进行中任务"时，添加 `includeDetailCompleterDeptIds` 参数
  - 需求部门成员查看"进行中任务"时，同时查询 `publisher` 和 `detail_completer` 角色的任务并合并结果
  - 更新 `loadDashboardStats` 统计逻辑，包含 `detail_completer` 角色的任务

**文件：** `frontend/src/views/CreateTask.vue`
- 添加预览图必填验证规则
- 在提交时添加额外的预览图验证
- 更新预览图上传区域的提示信息

**文件：** `frontend/src/api/task.ts`
- 在 `MyTasksParams` 接口中添加 `detail_completer` 作为有效的 `role` 值
- 在 `getTasks` 函数中添加 `includeDetailCompleterDeptIds` 参数

### 后端修改

**文件：** `backend/src/main/java/com/designhub/mapper/TaskMapper.java`
- 扩展 `selectTaskHall` 和 `selectTaskHallByDept` 的搜索条件
- 添加明细完善人、接收人、任务类型的关联查询
- 移除不存在的 `description` 字段引用

**文件：** `backend/src/main/java/com/designhub/mapper/TaskItemMapper.java`
- 扩展所有子任务查询方法的搜索条件
- 移除不存在的 `description` 字段引用

**文件：** `backend/src/main/java/com/designhub/service/TaskService.java`
- 扩展 `getCompletedTasks` 方法的搜索条件
- 在 `createTask` 和 `createPipelineTask` 方法中添加预览图必填验证
- 移除不存在的 `description` 字段引用
- **修复需求部门看不到一级需求任务：**
  - 在 `getTaskList` 方法中添加 `includeDetailCompleterDeptIds` 参数支持
  - 添加按明细完善人部门查询的逻辑（支持一级需求任务）
  - 在 `getMyTasks` 方法中添加 `role='detail_completer'` 支持
  - 新增 `getMyDetailCompleterTasks` 方法，查询用户作为明细完善人的任务
  - 在 `fillTaskRelatedInfo` 方法中添加 `detailCompleterName` 的填充逻辑

**文件：** `backend/src/main/java/com/designhub/controller/TaskController.java`
- **修复需求部门看不到一级需求任务：**
  - 在 `getTaskList` 接口中添加 `includeDetailCompleterDeptIds` 参数（逗号分隔的部门ID列表）
  - 在 `getMyTasks` 接口中添加 `role='detail_completer'` 支持

**文件：** `backend/src/main/java/com/designhub/service/ProgressCheckService.java`
- **修复流水线任务异常扣分：**
  - 修改 `checkDailyProgressUpdate` 方法，排除流水线任务的主任务（`is_pipeline=1`）
  - 只对流水线任务的子任务进行进度检查

---

## 🎯 影响范围

### 用户影响
- ✅ **一级需求部门用户**：发起任务时必须上传预览图
- ✅ **所有用户**：搜索功能更强大，可以搜索更多字段
- ✅ **所有用户**：任务卡片显示更美观，长名字不再影响布局
- ✅ **流水线任务接收人**：不再被错误扣分，已完成子任务后不会被检查主任务进度
- ✅ **需求部门负责人**：可以在"进行中任务"中看到已审核通过的一级需求任务
- ✅ **需求部门成员**：可以在"进行中任务"中看到自己作为明细完善人的任务

### 功能影响
- ✅ **搜索功能**：支持搜索任务卡片的所有信息
- ✅ **筛选功能**：修复了搜索时的报错问题
- ✅ **任务创建**：一级需求部门用户必须上传预览图
- ✅ **进度检查**：流水线任务的主任务不再被检查进度，避免错误扣分
- ✅ **任务可见性**：需求部门可以正确查看一级需求任务的进度

---

## ⚠️ 注意事项

1. **一级需求部门用户**：从本次更新开始，发起任务时必须上传预览图，否则无法提交任务。

2. **搜索功能**：搜索功能已扩展，现在可以搜索更多字段，但不再支持搜索 `description` 字段（该字段在数据库中不存在）。

3. **名字显示**：任务卡片中的需求人名字如果超过 8 个字符会自动截断，鼠标悬停可查看完整信息。

4. **流水线任务进度检查**：流水线任务的主任务不再进行进度检查，只有子任务会被检查进度。已完成子任务的用户不会再被错误扣分。

5. **一级需求任务可见性**：
   - 需求部门负责人审核通过一级需求任务后，可以在"进行中任务"中看到该任务
   - 需求部门成员补充完任务明细并发布后，可以在"进行中任务"中看到该任务
   - 任务状态为 `pending_detail_completion`（待明细完善）时，会显示在需求部门的"进行中任务"中

---

## 📞 问题反馈

如果在使用过程中遇到任何问题，请及时反馈：
- 系统异常
- 功能异常
- 用户体验问题

---

**更新完成时间：** 2026年1月22日 15:40

**部署状态：** ✅ 已部署到生产环境