主题
自定义网点管理
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /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=edit;refreshFlag===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/list,supplierServiceType=2宠物)、网点名称、所在地省 / 市 / 区级联(area/province、area/list)。
5.3 保存逻辑
详情页 saveFn 校验基本信息与关联网点(手动规则需至少 1 个网点;条件规则需配置过滤条件),将基本信息格式化(地理位置 / 报价条件 JSON)后调用 networkGroupManage/add(新增)或 networkGroupManage/edit?code=(编辑)。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面 / 详情容器 |
SearchContainer / TableContainer | @/components/SearchTableContainer/index.js | 筛选区 / 表格区容器 |
QRCode | ./components/QRCode | H5 二维码弹窗(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/page | POST | 自定义网点分组分页列表 |
networkGroupManage/cutStatus | POST | 启用 / 禁用切换 |
networkGroupManage/delete | GET(query) | 删除(?id=) |
networkGroupManage/refreshData | GET(query) | 刷新数据(?groupId=) |
networkGroupManage/id | GET(query) | 详情基本信息回显(?id=) |
networkGroupManage/add / networkGroupManage/edit | POST | 新增 / 编辑保存(带 ?code=) |
networkTemporaryGroup/show/edit | GET(query) | 编辑态取临时表 code(?id=) |
networkTemporaryGroup/page | POST | 编辑 / 新增态临时表网点分页 |
networkGroupManage/queryByPageWorkGroup | POST | 查看态正式表网点分页 |
networkTemporaryGroup/delete | GET(query) | 删除临时表网点(?id=) |
networkTemporaryGroup/file/input | POST(FormData) | 导入网点(?importType=1/2) |
networkGroupManage/file/export | POST | 导出网点(查看态) |
networkGroupManage/getCode | GET(query) | 获取刷新结果(?groupId=,refresh_flag) |
networkTermJoin/queryNetworkTermJoin | GET(query) | 编辑 / 查看时取报价项目关联(?groupId=) |
selfServiceQuotation/pageQuery | POST | 报价项目分页(展示报价项目为是时) |
supplier/list | POST | 服务商下拉(supplierServiceType=2) |
area/province / area/list | POST | 省份 / 市 / 区级联 |
ddic/getList | POST | 字典(network_group_manage_group、network_group_manage_channel_show、列表页另取 network_third_code) |
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |