Skip to content

自定义网点管理

基础信息

说明
菜单路径/operationsManagement/customNetwork
路由名称customNetwork
页面组件src/views/operationsManagement/customNetwork/index.vue
接口模块组件内 this.$api.post(...) 直接调用
Store
页面定位维护面向 C 端展示的自定义网点分组(手动或按条件关联宠物服务商网点),支持新增 / 编辑 / 查看 / 启用禁用 / 删除 / 刷新数据 / 生成 H5 二维码

页面功能

列表页负责自定义网点分组的查询与生命周期管理;新增 / 编辑 / 查看跳转到独立详情页 customNetwork/details。核心区分两种关联网点规则:手动关联网点(terms=0)与条件关联网点(terms=1)。

1. 筛选条件

  • 自定义分组:下拉,字典 network_group_manage_group
  • 编码:文本输入。
  • 标题:文本输入。
  • 展示端口:下拉,字典 network_group_manage_channel_show
  • 状态:下拉,启用(1) / 禁用(2)。
  • 创建时间:日期区间(yyyy-MM-dd,查询时拼成 00:00:00 ~ 23:59:59)。

2. 操作按钮

  • 新增自定义网点:跳转详情页 type=add

3. 表格字段

序号、自定义分组(networkGroupName)、展示端口(channelShowName)、编码(networkGroupCode)、标题(title)、标签计算规则(labelMatchTypeName)、标签关联网点数(networkCount,单位「家」)、创建时间(createTime)、操作人(createPersonName)、状态(statusName,按钮形式,点击切换启用/禁用)。

4. 行操作

  • 修改:跳转详情页 type=editrefreshFlag===2(刷新中)时禁用。
  • 查看详情:跳转详情页 type=view
  • H5 页面:打开 QRCode 二维码弹窗,展示 qrCodeUrl 对应的网点 H5 列表二维码,可下载二维码 / 复制链接。
  • 删除:仅 status !== 1(禁用态)显示,调用 networkGroupManage/delete
  • 刷新数据:仅 status === 1(启用态)显示,refreshFlag===2 时禁用,调用 networkGroupManage/refreshData 重新按条件检索关联网点。
  • 状态切换(状态列按钮):调用 networkGroupManage/cutStatus 在 1 / 2 间切换。

5. 详情页(details/index.vue)

customNetwork/details/index.vue,由 BasicsInfo(基本信息)与 RelationTable(关联网点)两个卡片组成,底部固定保存 / 返回按钮(查看态隐藏保存)。

5.1 基本信息(BasicsInfo)

表单字段:编码(编辑 / 查看时显示,禁用)、自定义分组(必填,字典 network_group_manage_group)、创建时间(编辑 / 查看显示,禁用)、自定义规则(手动关联网点 0 / 条件关联网点 1,编辑态不可改)、展示渠道(必填,字典 network_group_manage_channel_show)、状态(启用 1 / 禁用 2)、标题(必填,≤30 字)、描述(≤150 字)。

「设置网点展示」区配置两项:

  • 是否根据地理位置展示服务网点(必填):选「是」时再选配置方式——根据省/市/区(condition=1,再选省 / 省+市 / 省+市+区)或根据距离(condition=2,输入 5~100 公里)。保存时按 hasLocationCondition 组装为 locationConditionJson
  • 是否展示报价项目(必填):仅当自定义规则为「条件关联网点」且已配置报价项目条件时可选「是」;选「是」时展示报价项目表格(含关联服务规则别名录入)。

5.2 关联网点(RelationTable)

terms 显示不同能力:

  • 手动关联网点(terms=0):「添加网点」(弹窗 AddNetwork)、「导入网点」(importType=1)、「导入京东安联网点」(importType=2,与普通导入互斥)。编辑态先调 networkTemporaryGroup/show/edit 取临时 code,所有增删改在临时表进行,保存时提交正式表。
  • 条件关联网点(terms=1):「添加 / 修改 / 查看检索条件」(弹窗 AddFilterCondition 及其子条件组件),保存后由系统按条件异步检索网点(条件检索为异步,列表会提示「系统正在努力检索中」)。查看态可「导出网点」「刷新数据」。
  • 表格字段:服务商名称、网点编码、网点名称、联系方式、所在省/市/区、详细地址、操作(删除)。
  • 筛选:服务商名称(supplier/listsupplierServiceType=2 宠物)、网点名称、所在地省 / 市 / 区级联(area/provincearea/list)。

5.3 保存逻辑

详情页 saveFn 校验基本信息与关联网点(手动规则需至少 1 个网点;条件规则需配置过滤条件),将基本信息格式化(地理位置 / 报价条件 JSON)后调用 networkGroupManage/add(新增)或 networkGroupManage/edit?code=(编辑)。

使用组件

组件路径用途
Container@/components/container页面 / 详情容器
SearchContainer / TableContainer@/components/SearchTableContainer/index.js筛选区 / 表格区容器
QRCode./components/QRCodeH5 二维码弹窗(qrcode 生成)
BasicsInfo./details/BasicsInfo详情基本信息表单
RelationTable./details/RelationTable详情关联网点列表
AddNetwork./details/components/AddNetwork手动添加网点弹窗
AddFilterCondition./details/components/AddFilterCondition条件检索条件弹窗入口
LabelCondition / AddressTerms / OtherCondition / QuotationProjectCondition / SelectDistrict / ShopCustomerRelConditions./details/components/检索条件各子表单
ImportPopup@/components/ImportPopup网点导入弹窗

使用 Store

无。

调用接口

所有接口实际请求统一带 /api 前缀(下表为业务路径简写)。

接口 URL方法用途
networkGroupManage/pagePOST自定义网点分组分页列表
networkGroupManage/cutStatusPOST启用 / 禁用切换
networkGroupManage/deleteGET(query)删除(?id=
networkGroupManage/refreshDataGET(query)刷新数据(?groupId=
networkGroupManage/idGET(query)详情基本信息回显(?id=
networkGroupManage/add / networkGroupManage/editPOST新增 / 编辑保存(带 ?code=
networkTemporaryGroup/show/editGET(query)编辑态取临时表 code(?id=
networkTemporaryGroup/pagePOST编辑 / 新增态临时表网点分页
networkGroupManage/queryByPageWorkGroupPOST查看态正式表网点分页
networkTemporaryGroup/deleteGET(query)删除临时表网点(?id=
networkTemporaryGroup/file/inputPOST(FormData)导入网点(?importType=1/2
networkGroupManage/file/exportPOST导出网点(查看态)
networkGroupManage/getCodeGET(query)获取刷新结果(?groupId=refresh_flag
networkTermJoin/queryNetworkTermJoinGET(query)编辑 / 查看时取报价项目关联(?groupId=
selfServiceQuotation/pageQueryPOST报价项目分页(展示报价项目为是时)
supplier/listPOST服务商下拉(supplierServiceType=2
area/province / area/listPOST省份 / 市 / 区级联
ddic/getListPOST字典(network_group_manage_groupnetwork_group_manage_channel_show、列表页另取 network_third_code

修改记录

修改人修改时间修改内容
zhouw2026-07-03初始化页面
zhouw2026-07-09编写页面内容