cont/mjava-sairui/modules/拜访管理

拜访管理模块

业务范围

拜访管理承接“医院 -> 科室 -> 医生 -> 拜访计划 -> 定位/拍照签到 -> 拜访记录 -> 跟进与风险提示”的客户过程管理链路。

已交付功能

1. 拜访计划：选择市场维护中的医院、科室、医生档案，填写计划拜访时间、拜访人员、目的和沟通重点。
2. 客户拜访列表：支持按关键字和状态查询，提供分页、详情、计划编辑、签到和记录提交入口。
3. 定位签到：浏览器优先调用设备定位；定位不可用时自动使用本地开发模拟定位，保证开发联调可完成。
4. 现场照片：支持手机拍照或本地选择图片，前端限制 2MB 并展示预览，照片随签到记录保存。
5. 拜访记录：签到后填写客户沟通结果、后续跟进计划、下次拜访日期、风险等级和风险说明。
6. 风险提示：支持正常、需关注、高风险三个等级，并在列表和统计区展示。

数据库

执行 sairui-server/src/main/resources/db/schema/V4__visit_management.sql，创建：

• visit_record：计划、定位签到、照片、拜访记录、跟进和风险信息。

拜访对象通过 hospital_id、department_id、doctor_id 关联既有市场维护档案。

API

方法	地址	说明
GET	/api/v1/visits	查询拜访记录，支持关键字和状态过滤
GET	/api/v1/visits/{id}	查询拜访详情
POST	/api/v1/visits	创建拜访计划
PUT	/api/v1/visits/{id}	编辑待拜访计划
POST	/api/v1/visits/{id}/check-in	提交定位与现场照片签到
POST	/api/v1/visits/{id}/complete	提交拜访记录、跟进及风险信息

状态流转：PLANNED（待拜访） -> CHECKED_IN（已签到） -> COMPLETED（已完成）。

联调步骤

1. 确保市场维护中已存在医院档案；科室和医生档案可选。
2. 重启后端后，打开 http://127.0.0.1:5173/visits。
3. 在“计划录入”创建拜访计划，再切换至“全部记录”。
4. 对待拜访记录点击“签到”，完成定位与现场照片选择。
5. 对已签到记录点击“记录”，填写拜访结果、跟进计划和风险信息后归档。

当前边界

当前浏览器版本使用 navigator.geolocation 与本地文件选择模拟钉钉定位、拍照能力。接入钉钉容器后，可在前端替换为钉钉 JS API，后端接口和数据字段无需调整。