文档完善中,如果有什么问题请联系我们:chaho@qq.com
我的任务
"我的任务"是供应商工程师查看与本人相关任务的工作窗口，集中展示本人创建、本人执行或本人作为第二执行人的任务（含普通任务、巡检任务、盘点任务），并提供任务查询、任务详情查看、任务执行（普通处理、巡检填报、盘点填报）、任务备注、任务编辑、任务撤销以及供应商任务创建等能力，帮助供应商工程师完成周期性巡检、盘点与临时任务的交付。
适用角色
| 序号 | 角色 | 说明 |
|---|---|---|
| 1 | 供应商工程师 | 查看与本人相关的任务；作为执行人或第二执行人时执行任务、填报巡检与盘点结果；创建并维护本人负责的供应商任务 |
操作入口
- 菜单路径：供应商工作台顶部导航暂未提供"我的任务"入口，通过地址栏直接访问（或由其他页面链接进入）
任务列表与查询
查看任务列表
- 访问 进入任务列表页，默认展示当前登录供应商工程师创建的任务，按更新时间倒序排列。
- 列表列依次为：序号（NO）、任务类型、任务名称（名称后括号内显示当前状态，名称下方显示完成进度条与百分比）、开始时间、执行人、第二执行人。
- 列表底部显示合计条数、分页栏与每页条数选择器；查询无结果时页面提示"未查询到符合条件的相关结果"。
查询条件
- 在列表页"快捷搜索"区域设置条件后，点击"搜索/Query"提交；点击"重置/Reset"清空条件。
- 查询后的数据范围为：本人创建的、本人为执行人（owner）的、或本人为第二执行人（backup owner）的任务。
- 查询条件字段如下：
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 状态 | 从任务状态参数表（task_status）中选择，按状态精确过滤 | 否 |
| 2 | 内容关键字 | 任务名称模糊查询（输入框提示"请输入任务名称"） | 否 |
任务详情与附件下载
- 在列表中点击任务名称，进入任务详情页。
- 详情页"摘要信息"展示：任务名称、当前状态、任务类型、执行人/第二执行人、任务周期类型；同时由控制器组装该任务的附件列表与全部备注记录在页面中展示。
- 详情页字段说明：
| 序号 | 字段 | 说明 |
|---|---|---|
| 1 | 任务名称 | 任务标题，显示在摘要顶部 |
| 2 | 状态 | 任务当前状态标签 |
| 3 | 任务类型 | 普通任务、巡检任务、盘点任务、项目（供应商）任务等，由 task_type 参数表定义 |
| 4 | 执行人 / 第二执行人 | 任务负责人与备用执行人 |
| 5 | 周期类型 | 任务循环类型，由 task_cycle_type 参数表定义 |
- 附件下载：任务附件在详情页下载；系统按附件关联对象输出文件，并在下载时记录下载人与操作日志。
任务执行
任务按类型分三种执行方式，执行入口均在任务详情页的"更多"菜单中，且仅当任务处于处理中、当前登录人为执行人或第二执行人（内部角色按系统规则另有放行）时出现。
普通任务处理（普通执行）
适用类型：普通任务（任务类型 1/2/3/4）。
操作步骤：
- 打开任务详情页，确认任务状态为处理中。
- 在"更多"菜单中点击"处理"，弹出"处理任务"窗口。
- 在"任务处理记录"中填写处理说明（必填），点击"保存"提交到 。
- 提交成功后返回任务列表。
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 任务处理记录（do_note） | 本次任务处理的说明 | 是 |
| 执行结果规则：若该任务"工时需审批"，提交后任务进入待审批；否则任务直接置为已完成、进度记为 100%。 |
巡检任务执行
适用类型：巡检任务（任务类型 5）。
操作步骤：
- 在任务详情页"更多"菜单中点击"开始巡检"，进入巡检执行页（页面标题"巡检报告[待填写]"）。
- 页面顶部显示巡检任务名称、巡检人、巡检时间；表格逐行列示巡检项。
- 逐项填写巡检结果，必要时填写备注、上传该项附件（现场照片等）。
- 可点击"打印"将当前巡检报告输出为打印件；填写完成后点击"保存"提交，点击"重置"清空已填内容。
- 提交成功后返回任务详情页。
巡检执行表格字段：
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 位置 | 巡检项所在配置项位置（系统显示） | 系统自动 |
| 2 | 设备 | 巡检对象配置项（系统显示） | 系统自动 |
| 3 | 指标 | 巡检指标（KPI，系统显示） | 系统自动 |
| 4 | 参考值 | 指标参考值（系统显示） | 系统自动 |
| 5 | 附件 | 本巡检项现场照片/文件上传 | 否 |
| 6 | 巡检结果 | 实测指标值，逐行填写 | 是 |
| 7 | 备注 | 本巡检项的补充说明 | 否 |
| 提交后系统记录每项的巡检值、备注、填写时间与填写人；任务状态置为待审批。 |
盘点任务执行
适用类型：盘点任务（任务类型 6）。
操作步骤：
- 在任务详情页"更多"菜单中点击"开始盘点"，进入盘点执行页（页面标题"盘点记录[进行中]"）。
- 页面顶部显示盘点任务名称、盘点人、盘点时间；表格逐行列示待盘点设备。
- 逐行将"盘点结果"开关切换为"正常"或"异常"，填写盘点备注，并可上传本项盘点图片（仅支持 jpeg/jpg/png，每项一张）。
- 点击"暂存"可先保存盘点结果（任务仍停留在处理中，可继续完善）；确认无误后点击"保存"，在"你是否要确认所有盘点结果？"提示中确认后提交到 ；"打印"可输出盘点记录，"重置"清空已填内容。
- 提交成功后返回任务详情页。
盘点执行表格字段：
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 设备 | 待盘点配置项（系统显示） | 系统自动 |
| 2 | 位置/安装地点 | 设备安装位置（系统显示） | 系统自动 |
| 3 | 序列号 | 设备序列号（系统显示） | 系统自动 |
| 4 | 使用部门 | 设备使用部门（系统显示） | 系统自动 |
| 5 | 使用人 | 设备使用人（系统显示） | 系统自动 |
| 6 | 责任人 | 设备责任人（系统显示） | 系统自动 |
| 7 | 签收时间 / 签收地点 | 设备签收信息（系统显示） | 系统自动 |
| 8 | 盘点提醒 | 系统预置的盘点提醒说明（系统显示） | 系统自动 |
| 9 | 盘点结果 | 开关：正常 / 异常（未勾选为异常） | 是（逐项切换） |
| 10 | 备注 | 本项盘点说明 | 否 |
| 11 | 盘点图片 | 本项现场图片，仅 jpeg/jpg/png，每项一张；已有图片可编辑或清除 | 否 |
| 提交后系统记录每项的盘点结果、备注、图片、是否已盘点、盘点时间与盘点人；点击"保存"正式提交后任务进入待审批。 |
任务备注、编辑、撤销与创 建
添加任务备注
- 在任务详情页"更多"菜单中点击"备注"，弹出"添加备注"窗口。
- 填写备注内容（必填），可同时上传附件（支持多文件），点击"保存"提交到 。
- 备注与附件记录在该任务下，随详情页展示。
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 备注内容（note_content） | 本次备注文字 | 是 |
| 2 | 附件 | 随备注上传的文件，可多选 | 否 |
编辑任务
- 仅项目（供应商）任务（任务类型 7）处于处理中时，详情页显示"编辑"按钮。
- 点击"编辑"弹出"编辑任务"窗口，修改任务名称、描述、处理描述、执行时间、执行时长、任务进度，必要时上传新附件；审批人只读展示，不可修改。
- 保存后任务重新进入待审批。
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 任务名称 | 任务标题，不可与系统中其他任务重名 | 是 |
| 2 | 审批人 | 只读显示当前审批人 | 只读 |
| 3 | 描述 | 任务内容说明 | 是 |
| 4 | 处理描述 | 补充处理说明 | 否 |
| 5 | 执行时间 | 任务计划执行时间 | 是 |
| 6 | 执行时长 | 预计耗时，5 至 2400 分钟，步进 5 | 是 |
| 7 | 任务进度 | 当前完成百分比，0 至 100，步进 5 | 是 |
| 8 | 附件 | 随任务上传的文件 | 否 |
撤销任务
- 任务 处于新建或处理中时，详情页"更多"菜单显示"撤销"入口。
- 点击"撤销"弹出"撤销任务"窗口，填写撤销原因描述（必填）；窗口提示"任务撤销是不可逆动作，撤销后该工单核定工时为零"。
- 点击"保存"提交到 。
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 撤销原因描述（undo_note） | 撤销理由 | 是 |
创建任务
- 在任务列表页点击"任务/New"按钮，弹出"创建任务"窗口。
- 填写任务名称、选择审批人、填写描述与执行时间，设置执行时长与任务进度，必要时填写处理描述并上传附件。
- 点击"保存"提交；创建成功后任务自动进入待审批，并通知所选审批人。
| 序号 | 字段 | 说明 | 是否必填 |
|---|---|---|---|
| 1 | 任务名称 | 任务标题，不可与系统中其他任务重名 | 是 |
| 2 | 审批人 | 从服务经理列表中选择 | 是 |
| 3 | 描述 | 任务内容说明 | 是 |
| 4 | 处理描述 | 补充处理说明 | 否 |
| 5 | 执行时间 | 任务计划执行时间 | 是 |
| 6 | 执行时长 | 预计耗时，5 至 2400 分钟，步进 5 | 是 |
| 7 | 任务进度 | 创建时初始完成百分比，0 至 100，步进 5 | 是 |
| 8 | 附件 | 随任务上传的文件 | 否 |
说明：供应商工程师在本模块创建的任务固定为项目（供应商）任务（任务类型 7、单次任务）；巡检任务（类型 5）、盘点任务（类型 6）等由系统任务管理模块下发，外包工程师在本模块执行。
状态与规则
- 任务状态取自系统参数表 task_status，界面以状态名称显示；本模块涉及的状态行为如下：
- 创建、编辑供应商任务后，任务进入待审批(3)，并通知审批人。
- 审批通过后任务为处理中(2)，此时详情页才显示"处理""开始巡检""开始盘点"等执行入口。
- 普通任务执行提交后：该任务"工时需审批"则进入待审批(3)，否则直接置为已完成(4)、进度 100%。
- 巡检任务提交后进入待审批(3)；盘点任务"暂存"停留在处理中(2)，正式"保存"提交后进入待审批(3)。
- 新建(1)或处理中(2)的任务可撤销；撤销后任务为已撤销(5)，进度归零、核定工时归零，且不可逆。
- 执行类入口（处理、开始巡检）仅在当前登录人为执行人或第二执行人时显示（内部角色按系统规则另有放行）。
- 任务名称不允许与系统中其他任务重名，否则创建或编辑失败并提示"任务名称已存在"。
- 撤销成功后页面跳转回任务列表。
注意事项
- 供应商工作台顶部导航暂未提供"我的任务"菜单，请通过地址栏 访问。
- 列表页默认只展示"我创建的"任务；点击"搜索"后范围扩大为我创建的、我为执行人、我为第二执行人的任务。
- 路由中没有创建、编辑、备注、处理、撤销的独立 GET 页面，以上操作均为列表页或详情页中的内嵌弹窗表单。
- 巡检/盘点执行页按任务预置的巡检项、盘点设备逐行填报，已填数据与图片随任务保存；盘点图片仅支持 jpeg/jpg/png，每项只能上传一张。
- 撤销为不可逆操作，撤销后该任务核定工时为零，提交前请确认撤销原因描述填写完整。