主题
宠物增服物流监控
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /operationsManagement/logisticsManagement/logisticsMonitoring |
| 路由名称 | logisticsMonitoring（组件 name） |
| 页面组件 | src/views/operationsManagement/logisticsManagement/logisticsMonitoring/index.vue |
| 接口模块 | 组件内 api.post(...) / api.get(...) 直接调用（@/api） |
| Store | 无 |
| 页面定位 | 监控宠物增服物流的异常与各类超时情况，支持核实、处理完结、备注标记与导出 |
页面功能
页面由「异常统计卡片 + 筛选区 + 表格 + 弹窗」组成。卡片点击切换 form.errorType 后立即查询；筛选区查询条件作用于表格分页查询 pageQuery。表格行可执行查看、核实、处理、备注等操作。
1. 异常统计卡片
顶部展示 4 张可点击卡片，点击高亮并按 errorType 过滤表格，再次点击同一卡片取消过滤：
| 卡片 | errorType | 统计含义 |
|---|---|---|
| 物流异常 | 2 | 物流状态为派送失败/疑难件/退回签收/退件签收 |
| 揽收超时 | 3 | 下单-揽收超过 24 小时且仍未揽收 |
| 转运超时 | 4 | 揽收后超过 24 小时无有效物流节点更新 |
| 签收超时 | 5 | 派送-签收超过 24 小时且仍未签收 |
数量来自 wo/ccicServiceOrderCreate/queryLogisticsCount。每张卡片带问号提示「状态查询非实时，仅做参考」。
2. 筛选区
筛选条件：关键词（物流单号/收件人姓名/收件人电话）、物流状态、物流公司、中保工单编号、合作客户保单号、合作客户工单编号、下单时间区间、是否已处理、最新操作人。
下拉项聚焦时（@focus）懒加载：物流状态 logistics_track_status、物流公司 logistics_company、是否已处理 ccic_service_order_create_handle_complete 走 ddic/getList；最新操作人走 wo/ccicServiceOrderCreate/queryLastOperateUser。
3. 数据表格
主查询接口 wo/ccicServiceOrderCreate/pageQuery。列含：中保工单编号（链接跳增服工单详情）、物流单号（异常时显示红色标签）、物流公司、工单来源、合作客户保单号、合作客户工单编号、下单时间、物流状态、是否已处理、最新操作人、操作。
操作列行为：
- 查看：打开
LookDetails弹窗，展示物流详情 + 跟踪记录，可「更新物流信息」「添加/查看备注标记」。 - 核实：仅当物流状态
deliveryStatus === '8'（待核实物流）时出现。单条走onShowVerify，批量（多选）走「批量核实」按钮，均打开VerifyPopup，提交verifyLogistics将状态置为「已签收」。 - 处理：当
errorType为2/4且未处理时出现（showHandle判定），打开DisposePopup，填写处理备注后提交handleComplete，该异常包裹不再提醒。 - 备注：
ShowRemarks气泡，支持添加备注、添加标记（Sign表单：标记类型/优先级/处理截止时间），并展示备注列表与当前标记，标记可「标记完成」。
表格多选框仅 deliveryStatus === '8' 的行可选（selectableMethod），VerifyPopup 关闭时清空选择。
4. 导出
顶部「导出」按钮（受 v-jurisdiction-check="'/api/wo/ccicServiceOrderCreate/exportTrackNew'" 控制），二次确认后调用 wo/ccicServiceOrderCreate/exportTrackNew，结果发往邮箱。
5. 页面缓存
路由 keepAlive: true。进入页面时通过 initLock 防止 onInit 与 onActivated 重复查询；onActivated 时刷新列表与统计并 tableRef.doLayout() 修正表格错位。
说明：目录下
oldindex.vue及components/LogisticsInfo.vue、components/TrackingRecord.vue、components/ExportLogisticsInfo.vue为旧版（基于wo/petServiceOrder/queryCcicLogisticTrackList、exportTrack、queryTrackByLogisticsNo），当前index.vue未引用，仅作历史保留。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面标题容器 |
Pagination | @/components/pagination | 分页 |
SearchContainer / TableContainer | @/components/SearchTableContainer/index.js | 筛选/表格容器 |
LookDetails | ./LookDetails | 物流详情弹窗（跟踪记录 + 更新 + 备注） |
DisposePopup | ./DisposePopup | 处理完结弹窗（处理备注） |
VerifyPopup | ./components/VerifyPopup.vue | 单条/批量核实物流弹窗 |
ShowRemarks | ./ShowRemarks.vue | 备注与标记气泡 |
Sign | ./Sign | 添加标记表单（标记类型/优先级/截止时间） |
使用 Store
无。
调用接口
所有接口实际请求统一带
/api前缀（下表为业务路径简写）。
| 接口 URL | 用途 |
|---|---|
wo/ccicServiceOrderCreate/pageQuery | 异常物流分页查询 |
wo/ccicServiceOrderCreate/queryLogisticsCount | 异常/超时统计数量（GET） |
wo/ccicServiceOrderCreate/queryLastOperateUser | 最新操作人下拉（GET） |
wo/ccicServiceOrderCreate/getById | 物流详情（GET，LookDetails） |
wo/ccicServiceOrderCreate/renewalLogistics | 更新物流信息（GET，LookDetails） |
wo/ccicServiceOrderCreate/verifyLogistics | 核实物流（VerifyPopup） |
wo/ccicServiceOrderCreate/handleComplete | 处理完结（DisposePopup） |
wo/ccicServiceOrderCreate/queryTab | 查询标记信息（ShowRemarks） |
wo/ccicServiceOrderCreate/addTab | 新增标记（Sign） |
wo/ccicServiceOrderCreate/editTab | 标记完成（ShowRemarks） |
wo/ccicServiceOrderCreate/queryRemark | 备注列表（ShowRemarks） |
wo/ccicServiceOrderCreate/addRemark | 新增备注（ShowRemarks） |
wo/ccicServiceOrderCreate/exportTrackNew | 导出物流清单（发邮箱） |
ddic/getList | 字典（物流状态/物流公司/是否已处理） |
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |