Appearance
点检巡检管理
**本文引用的文件** - [inspectTasks.vue](file://app/devicemate-app/modules/inspectTasks/inspectTasks.vue) - [execute.vue（点检）](file://app/devicemate-app/modules/inspectTasks/execute.vue) - [check.vue（点检子组件）](file://app/devicemate-app/modules/inspectTasks/components/check.vue) - [basicInfo.vue（点检子组件）](file://app/devicemate-app/modules/inspectTasks/components/basicInfo.vue) - [document.vue（点检子组件）](file://app/devicemate-app/modules/inspectTasks/components/document.vue) - [checkDetail.vue（点检详情）](file://app/devicemate-app/modules/inspectTasks/checkDetail.vue) - [patrolTasks.vue（巡检）](file://app/devicemate-app/modules/patrolTasks/patrolTasks.vue) - [execute.vue（巡检）](file://app/devicemate-app/modules/patrolTasks/execute.vue) - [inspection.vue（设备详情页-点检）](file://dm/lemes-web/src/views/devicemate/equipment/components/details/inspection.vue) - [Rounting_inspection_plan_template.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/DM en模板sheet名修复/Rounting_inspection_plan_template.xlsx) - [inspection_sheet.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/DM en模板sheet名修复/inspection_sheet.xlsx) - [Rounting_inspection_plan_template (1).xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/ROW DM替换的原始模板/Rounting_inspection_plan_template (1).xlsx) - [inspection_sheet.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/ROW DM替换的原始模板/inspection_sheet.xlsx)目录
简介
本技术文档围绕“点检巡检管理”功能展开，覆盖移动端应用侧的点检与巡检任务的查看、执行、拍照上传、提交确认等全流程；同时结合后端接口约定与前端交互行为，给出数据模型设计建议、任务生成机制说明、统计分析与导入导出最佳实践，以及移动端适配建议。
项目结构
移动端采用 uni-app 架构，点检与巡检分别对应独立模块，共享通用组件与工具能力：
- 点检模块：inspectTasks（任务列表、执行、详情）
- 巡检模块：patrolTasks（任务列表、执行、详情）
- 通用组件：basicInfo、check、document
- 设备详情页：inspection.vue（用于查看设备关联的点检/巡检计划）
图表来源
- inspectTasks.vue:1-349
- patrolTasks.vue（巡检）:1-350
- execute.vue（点检）:1-254
- execute.vue（巡检）:1-254
- check.vue（点检子组件）:1-215
- basicInfo.vue（点检子组件）:1-83
- document.vue（点检子组件）:1-138
- checkDetail.vue（点检详情）:1-83
章节来源
核心组件
- 任务列表页：支持筛选状态、扫码查询、分页加载、批量确认/驳回、跳转执行与历史/维修入口。
- 执行页：三段式视图（基础信息、检查项、附件），支持选择确认人、保存草稿、拍照上传、提交。
- 子组件：
- 基础信息：展示工单号、计划名称、设备信息、执行人、确认人、状态等。
- 检查项：展示参考值、实测值、判定结果（OK/NG/NA）、更新时间与人员、拍照上传、手动判定。
- 附件：下载与打开文档（PDF/DOCX/XLSX）。
- 检查项详情：展示模块名、项目名、内容、方法、参考图、提示图等。
章节来源
- inspectTasks.vue:1-349
- execute.vue（点检）:1-254
- check.vue（点检子组件）:1-215
- basicInfo.vue（点检子组件）:1-83
- document.vue（点检子组件）:1-138
- checkDetail.vue（点检详情）:1-83
- patrolTasks.vue（巡检）:1-350
- execute.vue（巡检）:1-254
架构总览
移动端通过 HTTP 客户端调用后端接口，完成点检/巡检任务的查询、详情获取、执行、保存草稿与提交。检查项支持拍照上传，附件支持离线下载与打开。
图表来源
- inspectTasks.vue:206-228
- patrolTasks.vue（巡检）:212-230
- execute.vue（点检）:73-91
- execute.vue（巡检）:73-91
- check.vue（点检子组件）:103-127
详细组件分析
点检任务列表（inspectTasks.vue）
- 功能要点
- 支持按设备状态筛选、全局搜索、扫码查询设备编号。
- 分页加载与下拉刷新。
- 针对不同状态显示“派发/执行/确认”按钮，支持批量确认/驳回。
- 跳转至执行页、历史记录、维修入口。
- 关键交互
- 列表页调用分页查询接口，渲染工单号、设备编码、计划名称、线路、状态等。
- 状态变更通过统一的状态更新接口完成。
章节来源
巡检任务列表（patrolTasks.vue）
- 功能要点
- 与点检列表一致的交互模式：筛选、搜索、扫码、分页、状态按钮、跳转执行。
- 区别在于使用巡检专用查询接口与状态字典。
- 关键交互
- 使用巡检查询接口返回任务列表，状态字典来自本地字典服务。
章节来源
执行页（点检/巡检 execute.vue）
- 视图结构
- 顶部标签页：基础信息、检查项、附件。
- 基础信息：展示工单号、计划名称、设备信息、执行人、确认人、状态、等级、备注等。
- 检查项：逐项展示参考值、实测值、判定（OK/NG/NA）、更新时间与人员、拍照上传、保存草稿。
- 附件：点击下载并尝试打开 PDF/DOCX/XLSX。
- 关键流程
- 获取当前任务详情，设置导航标题。
- 选择确认人后提交，或保存草稿。
- 仅在未完成状态下允许编辑与拍照。
章节来源
检查项组件（check.vue）
- 功能要点
- 实测值输入框，失焦时根据上下限自动判定 OK/NG。
- 判定按钮（OK/NG/NA）手动切换。
- 拍照上传：选择相册或相机，上传至后端，成功后回填图片链接。
- 保存草稿：将当前检查项结果持久化。
- 查看检查项详情：跳转到详情页。
- 数据与权限
- 通过全局状态控制页面类型（已完成不可编辑）。
- 上传接口需要携带认证头。
章节来源
基础信息组件（basicInfo.vue）
- 功能要点
- 渲染只读的基础信息列表，便于快速浏览工单与设备信息。
- 适用场景
- 在执行页的“基础信息”标签中展示。
章节来源
附件组件（document.vue）
- 功能要点
- 展示附件列表（文件名、创建时间），点击后触发下载任务。
- 下载完成后可直接打开文件，支持 PDF/DOCX/XLSX。
- 技术细节
- 使用 plus.downloader 创建下载任务，完成后通过 plus.runtime 打开文件。
章节来源
检查项详情（checkDetail.vue）
- 功能要点
- 展示模块名、项目名、内容、方法、参考图、提示图等。
- 适用场景
- 在检查项列表中点击进入，辅助现场检查。
章节来源
设备详情页（inspection.vue）
- 功能要点
- 展示设备关联的点检/巡检计划相关信息，便于现场核对。
- 适用场景
- 移动端设备详情页集成点检/巡检计划入口。
章节来源
依赖关系分析
- 组件耦合
- 执行页聚合基础信息、检查项、附件三个子组件，形成完整的执行界面。
- 检查项组件依赖上传接口与全局状态，耦合度中等。
- 外部依赖
- HTTP 请求：任务列表、详情、执行、上传、下载。
- 字典服务：任务状态、维护等级等。
- 文件下载：plus.downloader、plus.runtime。
图表来源
- execute.vue（点检）:19-31
- execute.vue（巡检）:19-31
- check.vue（点检子组件）:1-215
- checkDetail.vue（点检详情）:1-83
- document.vue（点检子组件）:1-138
性能与移动端适配
- 图片上传
- 建议限制图片尺寸与数量，避免大文件导致上传失败或卡顿。
- 上传前进行本地预览与压缩，提升用户体验。
- 页面渲染
- 使用虚拟滚动或分页加载，避免一次性渲染过多检查项。
- 对只读页面禁用不必要的事件绑定，减少重绘。
- 网络与离线
- 检查项保存草稿应支持离线缓存，网络恢复后自动同步。
- 附件下载采用断点续传策略，提高成功率。
- 语言与国际化
- 统一使用多语言资源，确保中英文切换时文案完整。
- 无障碍与兼容性
- 针对不同系统（iOS/Android）的文件打开方式做降级处理。
- 控制台日志与错误提示需友好化，便于一线人员理解。
故障排查指南
- 无法加载任务列表
- 检查网络请求与鉴权头是否正确。
- 确认筛选条件与分页参数是否合法。
- 无法拍照上传
- 检查权限（相册/相机）是否开启。
- 确认上传接口地址与认证头配置。
- 附件下载失败
- 检查文件服务器地址与权限。
- 确认 plus.downloader 的回调状态与 plus.runtime 打开文件的权限。
- 提交失败
- 确认已选择确认人且状态满足提交条件。
- 查看后端返回的错误码与提示信息。
章节来源
结论
点检巡检管理在移动端实现了从任务下发、执行、拍照、确认到附件归档的闭环流程。通过统一的执行页与通用组件，提升了复用性与一致性。建议后续完善统计分析与报表能力，并优化导入导出与批量处理体验。
附录
数据模型设计建议（基于现有字段与交互）
- 工单主表
- 字段：工单号、计划名称、设备编码、线路名称、位置描述、设备序列号、执行人、确认人、状态、维护等级、备注、创建时间、更新时间。
- 检查项明细
- 字段：模块名、项目名、内容、工作方法、参考值、实测值、判定（OK/NG/NA）、更新时间、更新人、参考图、提示图。
- 附件
- 字段：文件名、创建时间、存储路径、访问基址。
- 状态字典
- 字段：任务状态（待派发/待执行/执行中/已完成/已驳回）、维护等级等。
章节来源
任务生成机制说明
- 定期检查：由计划引擎按周期生成工单，推送至移动端。
- 专项检查：根据特定需求或事件触发生成工单。
- 随机抽查：按规则抽取设备或工单，生成临时工单。
- 状态流转：待派发 → 待执行 → 执行中 → 已完成/已驳回。
章节来源
执行流程（移动端）
图表来源
统计分析与报表（建议）
- 合格率统计：按设备/线路/时间段计算 OK/NG 比例。
- 趋势分析：折线图展示月度/季度合格率变化。
- 问题分布：饼图/柱状图展示常见缺陷类型与频次。
- 导出：支持 Excel 导出，包含原始数据与汇总统计。
章节来源
导入导出与模板
- 导入模板
- 点检计划导入模板：Rounting_inspection_plan_template.xlsx、inspection_sheet.xlsx
- 巡检计划导入模板：Rounting_inspection_plan_template (1).xlsx、inspection_sheet.xlsx
- 导入流程建议
- 解析模板列名映射到系统字段。
- 校验必填项与格式（日期、数值范围、设备编码等）。
- 批量写入并返回导入结果与错误明细。
- 导出流程建议
- 支持按筛选条件导出任务列表、检查结果、附件清单等。
- 导出格式为 Excel，包含表头与数据明细。
章节来源
- [Rounting_inspection_plan_template.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/DM en模板sheet名修复/Rounting_inspection_plan_template.xlsx)
- [inspection_sheet.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/DM en模板sheet名修复/inspection_sheet.xlsx)
- [Rounting_inspection_plan_template (1).xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/ROW DM替换的原始模板/Rounting_inspection_plan_template (1).xlsx)
- [inspection_sheet.xlsx（导入模板）](file://docs/info/BUG修复溯源文件/NCSC模板sheet名称异常/ROW DM替换的原始模板/inspection_sheet.xlsx)