Appearance
detail 链路分析
源文件:
docs/front end/dm/lemes-web/src/views/devicemate/repair/order/detail.vue前端 API:
docs/front end/dm/lemes-web/src/views/devicemate/api/repair/order/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/RepairWorkOrdersController.java/lemes-cloud/lemes-business-devicemate/lemes-service-dm-device/lemes-service-dm-device-server/src/main/java/com/lenovo/lemes/service/dm/device/service/impl/RepairWorkOrdersServiceImpl.java主表:
repair_work_orders
Vue 组件总览
| 组件 | 层级路径 | 角色 | 是否主链路 | 是否直接CRUD | 独立MD | 跳转 | 一句话作用 |
|---|---|---|---|---|---|---|---|
index | index | 主页面 | 是 | 否 | 当前页 | 查看 | 承接 detail 页面主入口、列表查询和业务操作入口。 |
toolConsumable | index > toolConsumable | 业务子模块 | 是 | 是 | 否 | 查看 | 负责 toolConsumable 模块的展示、操作编排和新增提交、删除提交、更新提交。 |
index | index > toolConsumable > index | 业务链路节点 | 是 | 否 | 否 | 查看 | 负责串联 index 等主链路节点,本身不直接提交核心请求。 |
index | index > toolConsumable > index > index | 共享业务组件 | 是 | 否 | 否 | 查看 | 作为共享组件复用在当前页面主链路中,负责业务处理。 |
辅助组件说明
basicInfo:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。fileList:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。iTitle:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。iTable:负责通用列表渲染、分页、多选、排序和操作列承载,在toolConsumable/index中复用。dialogs:负责通用弹窗容器、确认和关闭交互,在index/toolConsumable中复用。boxSearch:负责查询条件区,支持搜索和清空事件触发。repairManage:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。
技术图

Flow 布局:
standard
Summary 布局:
standard
1. 页面概览
- 当前节点对应文件
docs/front end/dm/lemes-web/src/views/devicemate/repair/order/detail.vue。 - 当前节点识别到 3 个重点组件、21 个辅助组件。
- 当前节点识别到 1 条业务页面跳转链路、4 个真实接口。
2. 上游入口
exception通过 方法gorepairOrder跳转到当前页,路由为/default/devicemate/repair/order/detail,携带参数workOrderNo/type。order通过 方法goDetail跳转到当前页,路由为/default/devicemate/repair/order/detail,携带参数workOrderNo/type。
3. 业务页面跳转链路
- 方法
closeCurrentPage->/default/devicemate/repair/order/order->order。
4. 前端真实调用链
- <toolConsumable> @applySuccess -> applySuccessHandler ->
findRepairWorkOrdersByNOAjax - <el-button> @click -> save ->
updateAjax - <el-button> @click -> dialogConfirm ->
submitRepairWorkOrdersAjax - activated 生命周期 -> activated ->
findRepairWorkOrdersByNOAjax - <el-button> @click -> cancel ->
closeCurrentPage - <el-button> @click -> dialogCancel ->
closeClick
5. 接口总览
| method | path | 功能 | 所属节点 | 前端触发 | 后端入口 |
|---|---|---|---|---|---|
| POST | /dm-device/repairWorkOrders/update | 更新提交 | 主页面 | <el-button> @click -> save -> updateAjax | update |
| GET | /dm-device/repairWorkOrders/{id} | 业务请求 | 主页面 | - | findRepairWorkOrdersById |
| GET | /dm-device/repairWorkOrders/findRepairWorkOrdersByNO | 业务请求 | 主页面 | <toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> findRepairWorkOrdersByNOAjax | findRepairWorkOrdersByNO |
| POST | /dm-device/repairWorkOrders/submitRepairWorkOrders | 业务请求 | 主页面 | <el-button> @click -> dialogConfirm -> submitRepairWorkOrdersAjax | submitRepairWorkOrders |
6. 接口详细说明
6.1 POST /dm-device/repairWorkOrders/update
接口信息
- 请求地址:
/dm-device/repairWorkOrders/update - 请求方式:
POST - 功能简述:更新提交
- 所属页面:主页面
- 前端触发链路:
- <el-button> @click -> save -> updateAjax
- 后端入口:
update - Service 方法:
updateRepairWorkOrders
入参
- 后端接口实际接收对象:
RepairWorkOrdersVo - 参数位置:
body
json
{
"id": ""
}- 当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- Controller 入口为
update(@Valid @RequestBody RepairWorkOrdersVo workOrdersVo),由@Validated和请求对象注解触发基础参数校验。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 附件删除会先查旧附件,再调用文件服务删除文件。
- 状态变更
- 会更新
part_main现有记录;若上传了新附件,会先删旧图再绑定新图。
- 数据影响
- 主表更新既有物料主数据,附件关联可能被替换。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
| 接口 | 调用类型 | 库名.表名 | mapper.page | sql作用(简写) |
|---|---|---|---|---|
POST /dm-device/repairWorkOrders/update | 更新 | ?.repair_work_orders | MyBatis-Plus updateById | 按 id 更新物料主数据 |
POST /dm-device/repairWorkOrders/update | 远程写入 | ?.附件数据 | fileClient.updateFile | 回写附件 targetId,绑定业务对象 |
POST /dm-device/repairWorkOrders/update | 远程写入 | ?.附件数据 | fileClient.deleteFiles | 删除旧附件文件 |
数据流走向
- 数据来源:
- 前端页面通过 <el-button> @click -> save -> updateAjax 触发请求
- 数据处理路径:
- Controller:
update - Service:
updateRepairWorkOrders - 附件删除会先查旧附件,再调用文件服务删除文件。
- 数据落点:
- ?.repair_work_orders
- ?.附件数据
- ?.附件数据
备注
- 前端请求路径含服务前缀
/dm-device,合理推断该前缀来自网关或服务路由。
6.2 GET /dm-device/repairWorkOrders/:id
接口信息
- 请求地址:
/dm-device/repairWorkOrders/{id} - 请求方式:
GET - 功能简述:业务请求
- 所属页面:主页面
- 后端入口:
findRepairWorkOrdersById - Service 方法:
getRepairWorkOrdersById
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- Service 内先构造
LambdaQueryWrapper作为条件容器。
- 核心业务
- 按目标 id 拉取附件集合,并回填
attachmentVoList/baseUrl。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
| 接口 | 调用类型 | 库名.表名 | mapper.page | sql作用(简写) |
|---|---|---|---|---|
GET /dm-device/repairWorkOrders/{id} | 远程读取 | ?.附件数据 | fileClient.listFileWithTarget | 按业务目标查询附件并回填 attachmentVoList 或 baseUrl |
数据流走向
- 数据来源:
- 前端页面通过 当前页面动作 触发请求
- 数据处理路径:
- Controller:
findRepairWorkOrdersById - Service:
getRepairWorkOrdersById - 按目标 id 拉取附件集合,并回填
attachmentVoList/baseUrl。 - 数据落点:
- ?.附件数据
备注
- 前端请求路径含服务前缀
/dm-device,合理推断该前缀来自网关或服务路由。
6.3 GET /dm-device/repairWorkOrders/findRepairWorkOrdersByNO
接口信息
- 请求地址:
/dm-device/repairWorkOrders/findRepairWorkOrdersByNO - 请求方式:
GET - 功能简述:业务请求
- 所属页面:主页面
- 前端触发链路:
- <toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> findRepairWorkOrdersByNOAjax
- activated 生命周期 -> activated -> getBasicInfoData -> findRepairWorkOrdersByNOAjax
- 后端入口:
findRepairWorkOrdersByNO - Service 方法:
getRepairWorkOrdersByNo
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- 当前链路未识别出额外步骤。
- 预处理
- Service 内先构造
LambdaQueryWrapper作为条件容器。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
- 当前链路未识别到明确数据库表操作。
数据流走向
- 数据来源:
- 前端页面通过 <toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> findRepairWorkOrdersByNOAjax 触发请求
- 数据处理路径:
- Controller:
findRepairWorkOrdersByNO - Service:
getRepairWorkOrdersByNo - 数据落点:
- 当前链路未识别到明确数据落点。
备注
- 前端请求路径含服务前缀
/dm-device,合理推断该前缀来自网关或服务路由。
6.4 POST /dm-device/repairWorkOrders/submitRepairWorkOrders
接口信息
- 请求地址:
/dm-device/repairWorkOrders/submitRepairWorkOrders - 请求方式:
POST - 功能简述:业务请求
- 所属页面:主页面
- 前端触发链路:
- <el-button> @click -> dialogConfirm -> submitRepairWorkOrdersAjax
- 后端入口:
submitRepairWorkOrders - Service 方法:
submitRepairWorkOrders
入参
参数位置:
unknown当前链路未展开到更细的字段级定义。
出参
外层响应:ResultData
业务数据体:框架统一成功响应
当前链路重点在业务动作与后端处理,公共包裹字段未继续展开。
后端逻辑链路
- 校验
- Controller 入口为
submitRepairWorkOrders(@Valid @RequestBody RepairWorkOrdersVo workOrdersVo),由@Validated和请求对象注解触发基础参数校验。
- 预处理
- 当前链路未识别出额外步骤。
- 核心业务
- 当前链路未识别出额外步骤。
- 状态变更
- 当前链路未识别出额外步骤。
- 数据影响
- 当前链路未识别出额外步骤。
- 收尾
- 当前链路未识别出额外步骤。
数据链路
- 当前链路未识别到明确数据库表操作。
数据流走向
- 数据来源:
- 前端页面通过 <el-button> @click -> dialogConfirm -> submitRepairWorkOrdersAjax 触发请求
- 数据处理路径:
- Controller:
submitRepairWorkOrders - Service:
submitRepairWorkOrders - 数据落点:
- 当前链路未识别到明确数据落点。
备注
- 前端请求路径含服务前缀
/dm-device,合理推断该前缀来自网关或服务路由。
重点组件说明
组件:index
- 角色:主页面
- 层级路径:
index - 是否直接CRUD:否
- 一句话作用:承接 detail 页面主入口、列表查询和业务操作入口。
- 业务动作:更新提交
- 下游重点组件:
toolConsumable
组件:toolConsumable
- 角色:业务子模块
- 层级路径:
index > toolConsumable - 父组件:
index - 是否直接CRUD:是
- 一句话作用:负责 toolConsumable 模块的展示、操作编排和新增提交、删除提交、更新提交。
- 业务动作:新增提交、删除提交、更新提交
- 详细说明:不单独生成 MD,说明保留在当前主页面文档。
- 下游重点组件:
index
组件:index
- 角色:业务链路节点
- 层级路径:
index > toolConsumable > index - 父组件:
toolConsumable - 是否直接CRUD:否
- 一句话作用:负责串联
index等主链路节点,本身不直接提交核心请求。 - 详细说明:不单独生成 MD,说明保留在当前主页面文档。
- 下游重点组件:
index
组件:index
- 角色:共享业务组件
- 层级路径:
index > toolConsumable > index > index - 父组件:
index - 是否直接CRUD:否
- 一句话作用:作为共享组件复用在当前页面主链路中,负责业务处理。
- 详细说明:不单独生成 MD,说明保留在当前主页面文档。
7. 子组件列表
order:路由路径/default/devicemate/repair/order/order
8. 修改入口
- 改当前节点逻辑:先看上游入口,再看组件总览和业务页面跳转链路,最后核对接口与后端落点。
- 改跳页逻辑:不仅要改当前页的方法和参数,还要同步检查目标页文档是否受影响。
- 当前节点被多个上游入口复用,改动前要确认所有入口语义是否一致。