Skip to content

add 链路分析

源文件:docs/front end/dm/lemes-web/src/views/devicemate/routingInspection/standards/add.vue

前端 API:docs/front end/dm/lemes-web/src/views/devicemate/api/routingInspection/standards/standards.js

后端落点:未识别 / 未识别

主表:add

Vue 组件总览

组件层级路径角色是否主链路是否直接CRUD独立MD跳转一句话作用
indexindex主页面当前页查看承接 add 页面主入口、列表查询和业务操作入口。
importFileBoxindex > importFileBox业务化公共组件查看复用通用组件外壳,但当前页通过 :import-file-ajax 注入业务配置,承接业务处理。
toolConsumableindex > toolConsumable业务链路节点查看负责串联 importFile / index 等主链路节点,本身不直接提交核心请求。
importFileindex > toolConsumable > importFile业务化公共组件查看复用通用组件外壳,但当前页通过 :import-file-ajax 注入业务配置,承接业务处理。
indexindex > toolConsumable > index共享业务组件查看作为共享组件复用在当前页面主链路中,负责业务处理。

辅助组件说明

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

技术图

add 页面数据流图

  • Flow 布局:standardadd 页面摘要图

  • Summary 布局:standard

1. 页面概览

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

2. 上游入口

  • standards 通过 <el-button> @click 跳转到当前页,路由为 /default/devicemate/routingInspection/standards/add

3. 业务页面跳转链路

  • <el-button> @click -> /default/devicemate/routingInspection/standards/standards -> standards,该目标页已在上游链路展开,当前只保留回跳引用。
  • <el-button> @click -> /default/devicemate/routingInspection/standards/standards -> standards,该目标页已在上游链路展开,当前只保留回跳引用。

4. 前端真实调用链

  • <basicInfo> @maintenanceLevelGet -> maintenanceLevelGet -> standardsQueryListAjax
  • <el-button> @click -> submit -> addStandardsAjax

5. 接口总览

methodpath功能所属节点前端触发后端入口
POST/dm-device/onSiteInspect/standards/detail/save详情回显主页面<el-button> @click -> submit -> addStandardsAjax-
POST/dm-device/onSiteInspect/standards/queryList业务请求主页面<basicInfo> @maintenanceLevelGet -> maintenanceLevelGet -> standardsQueryListAjax-
POST/dm-device/onSiteInspect/standards/upload/file业务请求主页面--

6. 接口详细说明

6.1 POST /dm-device/onSiteInspect/standards/detail/save

接口信息

  • 请求地址:/dm-device/onSiteInspect/standards/detail/save
  • 请求方式:POST
  • 功能简述:详情回显
  • 所属页面:主页面
  • 前端触发链路:
  • <el-button> @click -> submit -> addStandardsAjax

入参

  • 后端接口实际接收对象:Long
  • 参数位置:path
json
{
  "id": 1
}

已在源码中确认的有效字段包括:

  • id;类型:Long;说明:路径中的业务 id;校验:必填

出参

  • 外层响应:ResultData<PartMainVo>
  • 业务数据体:单个 PartMainVo 对象
json
{
  "id": 1,
  "partNo": "...",
  "partCode": "...",
  "partName": "...",
  "spec": "...",
  "uom": "...",
  "controlType": "...",
  "price": "...",
  "preferredSupplier": "...",
  "isPeriod": "...",
  "isLife": "...",
  "maxLife": "...",
  "maxLifeUom": "...",
  "useModel": "...",
  "preciousType": "...",
  "validFlag": "...",
  "description": "...",
  "packageNumber": "...",
  "attachmentVoList": "...",
  "baseUrl": "..."
}
  • id

  • partNo

  • partCode

  • partName

  • spec

  • uom

  • controlType

  • price

  • preferredSupplier

  • isPeriod

  • isLife

  • maxLife

  • maxLifeUom

  • useModel

  • preciousType

  • validFlag

  • description

  • packageNumber

  • attachmentVoList

  • baseUrl

  • 详情接口会把附件集合写入 attachmentVoList,并补充前端可直接回显的 baseUrl

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路无数据库写操作。
  1. 数据影响
  • 库存、金额、业务状态都不会发生持久化变更;若有价格处理,仅作用于返回值或导出值。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

接口调用类型库名.表名mapper.pagesql作用(简写)
POST /dm-device/onSiteInspect/standards/detail/save查询?.addMyBatis-Plus getById按 id 查询物料详情

数据流走向

  • 数据来源:
  • 前端页面通过 <el-button> @click -> submit -> addStandardsAjax 触发请求
  • 数据处理路径:
  • 数据落点:
  • ?.add

备注

  • 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
  • 前端请求路径含服务前缀 /dm-device,合理推断该前缀来自网关或服务路由。

6.2 POST /dm-device/onSiteInspect/standards/queryList

接口信息

  • 请求地址:/dm-device/onSiteInspect/standards/queryList
  • 请求方式:POST
  • 功能简述:业务请求
  • 所属页面:主页面
  • 前端触发链路:
  • <basicInfo> @maintenanceLevelGet -> maintenanceLevelGet -> standardsQueryListAjax

入参

  • 参数位置:unknown

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

出参

  • 外层响应:ResultData

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

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

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

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

数据流走向

  • 数据来源:
  • 前端页面通过 <basicInfo> @maintenanceLevelGet -> maintenanceLevelGet -> standardsQueryListAjax 触发请求
  • 数据处理路径:
  • 数据落点:
  • 当前链路未识别到明确数据落点。

备注

  • 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
  • 前端请求路径含服务前缀 /dm-device,合理推断该前缀来自网关或服务路由。

6.3 POST /dm-device/onSiteInspect/standards/upload/file

接口信息

  • 请求地址:/dm-device/onSiteInspect/standards/upload/file
  • 请求方式:POST
  • 功能简述:业务请求
  • 所属页面:主页面

入参

  • 参数位置:unknown

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

出参

  • 外层响应:ResultData

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

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

后端逻辑链路

  1. 校验
  • 当前链路未识别出额外步骤。
  1. 预处理
  • 当前链路未识别出额外步骤。
  1. 核心业务
  • 当前链路未识别出额外步骤。
  1. 状态变更
  • 当前链路未识别出额外步骤。
  1. 数据影响
  • 当前链路未识别出额外步骤。
  1. 收尾
  • 当前链路未识别出额外步骤。

数据链路

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

数据流走向

  • 数据来源:
  • 前端页面通过 当前页面动作 触发请求
  • 数据处理路径:
  • 数据落点:
  • 当前链路未识别到明确数据落点。

备注

  • 当前只定位到前端接口与后端落点文件,未从 Controller 中匹配到完全一致的方法映射。
  • 前端请求路径含服务前缀 /dm-device,合理推断该前缀来自网关或服务路由。

重点组件说明

组件:index

  • 角色:主页面
  • 层级路径:index
  • 是否直接CRUD:否
  • 一句话作用:承接 add 页面主入口、列表查询和业务操作入口。
  • 业务动作:新增提交
  • 下游重点组件:importFileBox / toolConsumable

组件:importFileBox

  • 角色:业务化公共组件
  • 层级路径:index > importFileBox
  • 父组件:index
  • 是否直接CRUD:否
  • 一句话作用:复用通用组件外壳,但当前页通过 :import-file-ajax 注入业务配置,承接业务处理。
  • 详细说明:不单独生成 MD,说明保留在当前主页面文档。

组件:toolConsumable

  • 角色:业务链路节点
  • 层级路径:index > toolConsumable
  • 父组件:index
  • 是否直接CRUD:否
  • 一句话作用:负责串联 importFile / index 等主链路节点,本身不直接提交核心请求。
  • 详细说明:不单独生成 MD,说明保留在当前主页面文档。
  • 下游重点组件:importFile / index

组件:importFile

  • 角色:业务化公共组件
  • 层级路径:index > toolConsumable > importFile
  • 父组件:toolConsumable
  • 是否直接CRUD:否
  • 一句话作用:复用通用组件外壳,但当前页通过 :import-file-ajax 注入业务配置,承接业务处理。
  • 详细说明:不单独生成 MD,说明保留在当前主页面文档。

组件:index

  • 角色:共享业务组件
  • 层级路径:index > toolConsumable > index
  • 父组件:toolConsumable
  • 是否直接CRUD:否
  • 一句话作用:作为共享组件复用在当前页面主链路中,负责业务处理。
  • 详细说明:不单独生成 MD,说明保留在当前主页面文档。

7. 子组件列表

  • standards:路由路径 /default/devicemate/routingInspection/standards/standards,当前为回跳引用

8. 修改入口

  • 改当前节点逻辑:先看上游入口,再看组件总览和业务页面跳转链路,最后核对接口与后端落点。
  • 改跳页逻辑:不仅要改当前页的方法和参数,还要同步检查目标页文档是否受影响。
  • 重点组件较多,改组件分类或主链路时要同时看组件链和路由链。