网点拜访管理

基础信息

项	说明
菜单路径	/operationsManagement/taskManagement/visitTaskManage
路由名称	visitTaskManage
页面组件	src/views/operationsManagement/taskManagement/visitTaskManage/index.vue
接口模块	@/api/visitTaskManage（独立 api 文件） + 组件内 api.post
Store	无
页面定位	网点拜访任务的全流程管理，含列表查询、新增、草稿、启停、改派、上传资料、核验、任务链接、工时统计

页面功能

页面使用 Container + SearchContainer（带操作区、更多筛选）+ TableContainer 标准布局，Vue3 <script setup> 实现。

1. 筛选区（Query 组件）

筛选条件包括：创建方式（手动/批量）、任务编号、网点名称、网点编号、信用代码、网点地址（省市区级联）、拜访人、实际拜访时间、拜访状态（多选）、拜访类型（到店/远程）、是否需要预约、到店打卡时间、状态（启用/停用）、是否草稿、创建时间。

2. 操作区

• 新增：跳转 /visitTaskManage/add（权限 /api/visitJob/create）。
• 导出：导出 Excel 到邮箱（权限 /api/visitJob/export）。
• 网点拜访工时统计：跳转 /visitTaskManage/workTimeList（权限 /api/visitJob/queryVisitStatistics）。

3. 任务列表

列	说明
创建方式	sourceName
是否草稿	isDraft === 1 显示「是」
任务编号	code
任务名称	name（超 10 字截断，tooltip 显示全名）
任务有效期	expireTime
拜访网点	networkName
拜访人	visitUserName
拜访类型	visitTypeName
计划拜访时间	expectVisitTime
是否需要预约	isNeedAppointName
到店打卡时间	checkInTime
到店打卡位置	checkInAddress
状态	statusName，启用绿/停用红
拜访状态	visitStatusName
创建人	createUserName
创建时间	createTime

4. 行操作（按草稿/状态/拜访状态动态展示，图标按钮 + tooltip）

• 草稿行：编辑草稿（/visitJob/editDraft）、删除（/visitJob/delete）。
• 非草稿行：
  • 编辑：状态 0 或拜访状态 6 且非 7 时（/visitJob/edit）
  • 启用：状态 0 且拜访状态非 7（/visitJob/enable）
  • 停用：状态 1 且拜访状态 1（/visitJob/disable）
  • 核验：状态 1 且拜访状态 4（/visitJob/verify）
  • 任务链接：拜访状态非 6（弹窗展示二维码）
  • 改派：有拜访人且拜访状态非 1/4/5/7（/visitJob/reassignment）
  • 拜访网点：远程拜访且状态 1 且拜访状态 1（跳转上传资料页）
  • 上传资料：拜访状态 2/3 且状态 1（/visitJob/uploadDataCommit）
  • 任务详情、拜访详情

5. 弹窗

• ReassignmentTaskDialog：改派弹窗，选择新拜访人后确认。
• TaskLinkDialog：任务链接弹窗，展示任务信息与二维码（queryVisitInfo + getQrCodeUrl）。

6. 分页与缓存

• ZbPagination 分页，onActivated 时重新查询。

使用组件

组件	路径	用途
Container	@/components/container	页面容器
SearchContainer	@/components/SearchTableContainer	筛选区容器
TableContainer	@/components/SearchTableContainer	表格容器
Query	./components/Query.vue	筛选表单
ZbPagination	@/components/zbkj-ui	分页
ReassignTaskDialog	./components/ReassignTaskDialog.vue	改派弹窗
TaskLinkDialog	./components/TaskLinkDialog.vue	任务链接二维码弹窗

使用 Store

无。

调用接口

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

接口 URL	用途
visitJob/page	拜访任务分页查询
visitJob/enable	启用任务
visitJob/disable	停用任务
visitJob/delete	删除草稿
visitJob/reassignment	改派任务
visitJob/export	导出 Excel 到邮箱
visitJob/queryVisitInfo	查询拜访信息（任务链接弹窗）
visitJob/getQrCodeUrl	获取任务二维码链接
visitJob/getUserList	拜访人下拉
ddic/getList	拜访状态下拉（visit_job_status）
area/queryAreaAll	省市区地址级联数据

修改记录

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