Skip to content

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跳转一句话作用
indexindex主页面当前页查看承接 detail 页面主入口、列表查询和业务操作入口。
toolConsumableindex > toolConsumable业务子模块查看负责 toolConsumable 模块的展示、操作编排和新增提交、删除提交、更新提交。
indexindex > toolConsumable > index业务链路节点查看负责串联 index 等主链路节点,本身不直接提交核心请求。
indexindex > toolConsumable > index > index共享业务组件查看作为共享组件复用在当前页面主链路中,负责业务处理。

辅助组件说明

  • basicInfo:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。
  • fileList:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。
  • iTitle:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。
  • iTable:负责通用列表渲染、分页、多选、排序和操作列承载,在 toolConsumable / index 中复用。
  • dialogs:负责通用弹窗容器、确认和关闭交互,在 index / toolConsumable 中复用。
  • boxSearch:负责查询条件区,支持搜索和清空事件触发。
  • repairManage:辅助组件,负责页面局部交互或展示,不直接承载新增/编辑主业务逻辑。

技术图

detail 页面数据流图

  • Flow 布局:standarddetail 页面摘要图

  • Summary 布局:standard

1. 页面概览

  • 当前节点对应文件 docs/front end/dm/lemes-web/src/views/devicemate/repair/order/detail.vue
  • 当前节点识别到 3 个重点组件、21 个辅助组件。
  • 当前节点识别到 1 条业务页面跳转链路、4 个真实接口。

2. 上游入口

  • detail 通过 方法 goDetail 跳转到当前页,路由为 /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. 接口总览

methodpath功能所属节点前端触发后端入口
POST/dm-device/repairWorkOrders/update更新提交主页面<el-button> @click -> save -> updateAjaxupdate
GET/dm-device/repairWorkOrders/{id}业务请求主页面-findRepairWorkOrdersById
GET/dm-device/repairWorkOrders/findRepairWorkOrdersByNO业务请求主页面<toolConsumable> @applySuccess -> applySuccessHandler -> getBasicInfoData -> findRepairWorkOrdersByNOAjaxfindRepairWorkOrdersByNO
POST/dm-device/repairWorkOrders/submitRepairWorkOrders业务请求主页面<el-button> @click -> dialogConfirm -> submitRepairWorkOrdersAjaxsubmitRepairWorkOrders

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

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

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

后端逻辑链路

  1. 校验
  • Controller 入口为 update(@Valid @RequestBody RepairWorkOrdersVo workOrdersVo),由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 附件删除会先查旧附件,再调用文件服务删除文件。
  1. 状态变更
  • 会更新 part_main 现有记录;若上传了新附件,会先删旧图再绑定新图。
  1. 数据影响
  • 主表更新既有物料主数据,附件关联可能被替换。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
POST /dm-device/repairWorkOrders/update更新?.repair_work_ordersMyBatis-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

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

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

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • Service 内先构造 LambdaQueryWrapper 作为条件容器。
  1. 核心业务
  • 按目标 id 拉取附件集合,并回填 attachmentVoList / baseUrl
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
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

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

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

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • Service 内先构造 LambdaQueryWrapper 作为条件容器。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

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

数据流走向

  • 数据来源:
  • 前端页面通过 <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

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

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

后端逻辑链路

  1. 校验
  • Controller 入口为 submitRepairWorkOrders(@Valid @RequestBody RepairWorkOrdersVo workOrdersVo),由 @Validated 和请求对象注解触发基础参数校验。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

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

数据流走向

  • 数据来源:
  • 前端页面通过 <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. 修改入口

  • 改当前节点逻辑:先看上游入口,再看组件总览和业务页面跳转链路,最后核对接口与后端落点。
  • 改跳页逻辑:不仅要改当前页的方法和参数,还要同步检查目标页文档是否受影响。
  • 当前节点被多个上游入口复用,改动前要确认所有入口语义是否一致。