主题
宠物增服物流关键词配置
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /operationsManagement/logisticsManagement/keywordConfig |
| 路由名称 | keywordConfig(组件 name) |
| 页面组件 | src/views/operationsManagement/logisticsManagement/keywordConfig/index.vue |
| 接口模块 | 组件内 api.post(...) / api.get(...) 直接调用(@/api) |
| Store | 无 |
| 页面定位 | 配置「待取件/待核实物流/退回签收」三种物流状态的第三方物流跟踪关键词匹配规则 |
页面功能
页面通过 el-tabs 切换物流状态(activeName),每个 tab 下维护对应的关键词匹配规则列表,顶部说明文案随 tab 变化。
1. 状态分类(Tab)
| Tab | name | 重新定义的物流状态 | 判断前置条件 |
|---|---|---|---|
| 待取件 | 7 | 待取件 | 第三方返回「正在派件」 |
| 待核实物流 | 8 | 待核实物流 | 第三方返回「已签收」 |
| 退回签收 | 9 | 退回签收 | 第三方返回「已签收」 |
2. 数据表格
查询接口 wo/logisticsStatusMatch/queryByPage,参数含 logisticsStatus(=当前 tab)与分页。列含:序号、物流公司、关键词匹配逻辑(是/非)、关键词、状态(启用/禁用)、操作。
关键词支持通配符 .*?(替代关键词中间文字),表头带问号说明。
3. 行操作
- 启用/禁用:按当前状态调用
wo/logisticsStatusMatch/enable或disable(GET,带 id),二次确认。受权限v-jurisdiction-check控制。 - 修改:打开
AddOrUpdate(带 id 回显),受edit权限控制。 - 删除:调用
wo/logisticsStatusMatch/del(POST),二次确认,受del权限控制。
4. 新增关键词(AddOrUpdate)
「新增关键词」按钮(受 add 权限控制)打开弹窗。表单:物流公司(AllSelect 多选,字典 logistics_company)、关键词匹配逻辑(是/非)、关键词(textarea,可「插入通配符」插入 .*? 到光标处);编辑时额外展示更新时间、更新人。
提交逻辑:新增调 wo/logisticsStatusMatch/add,编辑调 wo/logisticsStatusMatch/edit;物流公司多选值以逗号拼接后提交(logisticsCompanyId.join(','))。回显时把逗号串拆回数组。
5. 页面缓存
路由 keepAlive: true,onActivated 时刷新列表并 tableRef.doLayout()。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面标题容器 |
Pagination | @/components/pagination | 分页 |
TableContainer | @/components/SearchTableContainer/index.js | 表格容器 |
AddOrUpdate | ./components/AddOrUpdate.vue | 新增/编辑关键词弹窗 |
AllSelect | @/components/AllSelect | 物流公司多选(AddOrUpdate 内) |
使用 Store
无。
调用接口
所有接口实际请求统一带
/api前缀(下表为业务路径简写)。
| 接口 URL | 用途 |
|---|---|
wo/logisticsStatusMatch/queryByPage | 关键词规则分页查询 |
wo/logisticsStatusMatch/add | 新增关键词规则 |
wo/logisticsStatusMatch/edit | 编辑关键词规则 |
wo/logisticsStatusMatch/enable | 启用规则(GET,AddOrUpdate 外) |
wo/logisticsStatusMatch/disable | 禁用规则(GET,AddOrUpdate 外) |
wo/logisticsStatusMatch/del | 删除规则 |
wo/logisticsStatusMatch/id | 规则详情(GET,编辑回显) |
ddic/getList | 字典(物流公司 logistics_company) |
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |