spotCheck 链路分析

源文件：docs/front end/dm/lemes-web/src/views/devicemate/report/spotCheck/spotCheck.vue

前端 API：docs/front end/dm/lemes-web/src/views/devicemate/api/report/spotCheck/index.js

后端落点：lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-server/src/main/java/com/lenovo/lemes/service/dm/device/controller/InspectTasksController.java / 未识别

主表：spot_check

Vue 组件总览

组件	层级路径	角色	是否主链路	是否直接CRUD	独立MD	跳转	一句话作用
index	index	主页面	是	否	当前页	查看	承接 spotCheck 页面主入口、列表查询和业务操作入口。

辅助组件说明

• chart：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。
• boxSearch：负责查询条件区，支持搜索和清空事件触发。
• iTable：负责通用列表渲染、分页、多选、排序和操作列承载。
• selectLineDevice：辅助组件，负责页面局部交互或展示，不直接承载新增/编辑主业务逻辑。

技术图

• Flow 布局：standard

• Summary 布局：standard

1. 页面概览

• 当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/report/spotCheck/spotCheck.vue。
• 当前节点识别到 0 个重点组件、7 个辅助组件。
• 当前节点识别到 1 条业务页面跳转链路、3 个真实接口。
• 搜索动作会把 filterList 同步到 searchFilter，并把页码重置为第 1 页。
• 重置动作会清空查询条件，再走一次分页查询。
• 表格排序会把前端排序字段写入 field / order，再触发服务端排序查询。
• 导出动作会把当前筛选条件、排序字段以及勾选 ids 一起传给导出接口。

2. 上游入口

• 当前节点是本次递归文档的根入口。

3. 业务页面跳转链路

• 方法 goOrderDetail -> /default/devicemate/spotCheck/task/orderDetail -> orderDetail，参数 id / type。

4. 前端真实调用链

• <el-date-picker> @change -> dateChange -> workOrdersCountAjax
• <el-select> @change -> productLineChange -> workOrdersCountAjax
• <boxSearch> @research -> research -> queryWorkOrdersPageAjax
• <boxSearch> @reempty -> reempty -> queryWorkOrdersPageAjax
• <iTable> @size-change / <iTable> @current-change -> currentChange -> queryWorkOrdersPageAjax
• <el-button> @click -> exportAction -> exportExcelAjax
• activated 生命周期 -> activated -> workOrdersCountAjax / queryWorkOrdersPageAjax

5. 接口总览

method	path	功能	所属节点	前端触发	后端入口
POST	/dm-device/inspectTasks/exportInspectWorkOrdersStatExcel	业务请求	主页面	<el-button> @click -> exportAction -> exportExcelAjax	exportInspectWorkOrdersStatExcel
POST	/dm-device/inspectTasks/queryWorkOrdersPage	业务请求	主页面	<boxSearch> @research -> research -> currentChange -> getPage -> queryWorkOrdersPageAjax	queryWorkOrdersPage
POST	/dm-device/inspectTasks/workOrdersCountByDays	业务请求	主页面	<el-date-picker> @change -> dateChange -> getWorkOrdersCount -> workOrdersCountAjax	workOrdersCountByDays

6. 接口详细说明

6.1 POST /dm-device/inspectTasks/exportInspectWorkOrdersStatExcel

接口信息

• 请求地址：/dm-device/inspectTasks/exportInspectWorkOrdersStatExcel
• 请求方式：POST
• 功能简述：业务请求
• 所属页面：主页面
• 前端触发链路：
• <el-button> @click -> exportAction -> exportExcelAjax
• 后端入口：exportInspectWorkOrdersStatExcel
• Service 方法：exportInspectWorkOrdersStatExcel

入参

• 参数位置：unknown

• 当前链路未展开到更细的字段级定义。

出参

• 外层响应：ResultData

• 业务数据体：框架统一成功响应

• 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

1. 校验

• Controller 入口为 exportInspectWorkOrdersStatExcel(@RequestBody WorkOrdersQueryVo vo, HttpServletResponse response)，由 @Validated 和请求对象注解触发基础参数校验。

2. 预处理

• 当前链路未识别出额外步骤。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 当前链路未识别出额外步骤。

5. 数据影响

• 当前链路未识别出额外步骤。

6. 收尾

• 当前链路未识别出额外步骤。

数据链路

• 当前链路未识别到明确数据库表操作。

数据流走向

• 数据来源：
• 前端页面通过 <el-button> @click -> exportAction -> exportExcelAjax 触发请求
• 数据处理路径：
• Controller：exportInspectWorkOrdersStatExcel
• Service：exportInspectWorkOrdersStatExcel
• 数据落点：
• 当前链路未识别到明确数据落点。

备注

• 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.2 POST /dm-device/inspectTasks/queryWorkOrdersPage

接口信息

• 请求地址：/dm-device/inspectTasks/queryWorkOrdersPage
• 请求方式：POST
• 功能简述：业务请求
• 所属页面：主页面
• 前端触发链路：
• <boxSearch> @research -> research -> currentChange -> getPage -> queryWorkOrdersPageAjax
• <boxSearch> @reempty -> reempty -> currentChange -> getPage -> queryWorkOrdersPageAjax
• <iTable> @size-change / <iTable> @current-change -> currentChange -> getPage -> queryWorkOrdersPageAjax
• activated 生命周期 -> activated -> currentChange -> getPage -> queryWorkOrdersPageAjax
• 后端入口：queryWorkOrdersPage
• Service 方法：queryWorkOrdersPage

入参

• 参数位置：unknown

• 当前链路未展开到更细的字段级定义。

出参

• 外层响应：ResultData

• 业务数据体：框架统一成功响应

• 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

1. 校验

• Controller 入口为 queryWorkOrdersPage(@RequestBody WorkOrdersQueryVo vo)，由 @Validated 和请求对象注解触发基础参数校验。

2. 预处理

• 当前链路未识别出额外步骤。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 当前链路未识别出额外步骤。

5. 数据影响

• 当前链路未识别出额外步骤。

6. 收尾

• Controller 通过 success(...) 返回框架统一成功响应。

数据链路

• 当前链路未识别到明确数据库表操作。

数据流走向

• 数据来源：
• 前端页面通过 <boxSearch> @research -> research -> currentChange -> getPage -> queryWorkOrdersPageAjax 触发请求
• 数据处理路径：
• Controller：queryWorkOrdersPage
• Service：queryWorkOrdersPage
• 数据落点：
• 当前链路未识别到明确数据落点。

备注

• 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

6.3 POST /dm-device/inspectTasks/workOrdersCountByDays

接口信息

• 请求地址：/dm-device/inspectTasks/workOrdersCountByDays
• 请求方式：POST
• 功能简述：业务请求
• 所属页面：主页面
• 前端触发链路：
• <el-date-picker> @change -> dateChange -> getWorkOrdersCount -> workOrdersCountAjax
• <el-select> @change -> productLineChange -> getWorkOrdersCount -> workOrdersCountAjax
• activated 生命周期 -> activated -> getWorkOrdersCount -> workOrdersCountAjax
• 后端入口：workOrdersCountByDays
• Service 方法：workOrdersCountByDays

入参

• 参数位置：unknown

• 当前链路未展开到更细的字段级定义。

出参

• 外层响应：ResultData

• 业务数据体：框架统一成功响应

• 当前链路重点在业务动作与后端处理，公共包裹字段未继续展开。

后端逻辑链路

1. 校验

• Controller 入口为 workOrdersCountByDays(@RequestBody WorkOrdersQueryVo vo)，由 @Validated 和请求对象注解触发基础参数校验。

2. 预处理

• 当前链路未识别出额外步骤。

3. 核心业务

• 当前链路未识别出额外步骤。

4. 状态变更

• 当前链路未识别出额外步骤。

5. 数据影响

• 当前链路未识别出额外步骤。

6. 收尾

• Controller 通过 success(...) 返回框架统一成功响应。

数据链路

• 当前链路未识别到明确数据库表操作。

数据流走向

• 数据来源：
• 前端页面通过 <el-date-picker> @change -> dateChange -> getWorkOrdersCount -> workOrdersCountAjax 触发请求
• 数据处理路径：
• Controller：workOrdersCountByDays
• Service：workOrdersCountByDays
• 数据落点：
• 当前链路未识别到明确数据落点。

备注

• 前端请求路径含服务前缀 /dm-device，合理推断该前缀来自网关或服务路由。

重点组件说明

组件：index

• 角色：主页面
• 层级路径：index
• 是否直接CRUD：否
• 一句话作用：承接 spotCheck 页面主入口、列表查询和业务操作入口。

7. 子组件列表

• orderDetail：路由路径 /default/devicemate/spotCheck/task/orderDetail

8. 修改入口

• 改当前节点逻辑：先看上游入口，再看组件总览和业务页面跳转链路，最后核对接口与后端落点。
• 改跳页逻辑：不仅要改当前页的方法和参数，还要同步检查目标页文档是否受影响。
• 当前自动分析未识别出额外高风险点，但仍建议顺着子组件列表逐级核对。