更新
This commit is contained in:
@@ -0,0 +1,322 @@
|
||||
# 医助 AI 患者服务与质检功能开发方案
|
||||
|
||||
日期:2026-11-09。**本方案中的患者主入口设计已被用户纠正。当前产品要求以主管分析和管理医助为主,最新方案见 [医助维度纠偏方案](assistant-supervisor-dimension-plan-2026-11-09.md)。** 下文保留最初的视频功能映射及分期背景,涉及入口、统计对象和待办分配的描述以纠偏方案为准。
|
||||
|
||||
建议在现有医助工作流程中新增 **医助 AI 服务助手**,围绕患者沟通形成“看懂患者、辅助跟进、检查服务、培训提升”的完整流程。第一优先级是同一次沟通的两个分析视角:**患者有哪些诉求和未解决事项,医助哪些服务动作完成或遗漏。** 分析结果必须能回到原文,并能在人工确认后生成跟进待办;待办沿用现有入口,补上负责人、业务完成状态和执行结果。
|
||||
|
||||
方案按“医助负责患者沟通、资料收集、就诊协调、诊后随访和复诊提醒;主管负责团队质检与培训”设计。临床诊断、处方及调整用药由既有医生流程承担。
|
||||
|
||||
## 1 视频功能如何转成医助功能
|
||||
|
||||
视频约 11 分 10 秒,已覆盖全时段抽帧、关键页面细看及本地机器转写核对。画面中的金融和通用销售字段应转换成医疗服务字段;侧栏中仅出现入口的功能不等于已验证可用。具体证据见 [参考视频分析](../../artifacts/medical-assistant-feature-plan/video-analysis.md)。
|
||||
|
||||
| 视频中的功能 | 本项目建议功能 | 医助直接获得什么 |
|
||||
|---|---|---|
|
||||
| 多渠道客户档案、沟通原文 | 患者沟通时间线 | 接手患者时能看到沟通经过、来源与未处理事项 |
|
||||
| AI 总结、画像、标签 | 患者服务摘要与候选标签 | 知道患者关心什么、卡在哪里、需要补什么资料 |
|
||||
| 客户分析与员工表现 | 患者分析与医助服务质检 | 分清患者需求与医助服务问题,支持主管核查 |
|
||||
| 谈单思路、跟进话术 | 沟通提纲与回复草稿 | 准备下一次随访、复诊邀请、流程解释和资料提醒 |
|
||||
| 企业知识库、谈单助手 | 医助服务知识库与问答 | 用已审核的院内口径回答服务问题,并显示依据 |
|
||||
| 自定义阶段、字段、分析模板 | 场景化 SOP 与分析配置 | 初诊接待、诊后回访、复诊协调使用不同检查项 |
|
||||
| AI 实训和逐题评分 | 医助培训、情景对练与复训 | 按真实薄弱点练习,查看遗漏要点和参考表达 |
|
||||
| 日周月报告、人员看板 | 医助个人复盘与主管团队看板 | 找到共性问题、漏跟进患者以及下一步管理动作 |
|
||||
|
||||
## 2 医助每天如何使用
|
||||
|
||||
### 2.1 开始工作
|
||||
|
||||
打开“我的工作”,优先看到今天待随访、复诊到期未处理、承诺回电到期、资料待补齐和待转医生事项。时间、到期状态、归属人来自现有业务记录;AI 说明排序理由,业务规则决定优先级。没有沟通数据时显示“暂无可分析记录”,不能推断为“医助未联系”。
|
||||
|
||||
### 2.2 联系患者前
|
||||
|
||||
从现有患者或诊单详情打开“AI 服务分析”:
|
||||
|
||||
- **患者摘要**:服务阶段、最近沟通事项、患者明确表达的诉求、顾虑、联系偏好、资料缺口。
|
||||
- **尚未解决**:患者待回答的问题、医助曾作出的承诺、待医生确认事项。
|
||||
- **本次建议**:建议先问什么、需要核对什么、可以引用哪条院内知识。
|
||||
- **证据**:每条结论可展开对应原文;录音只在已有可信时间定位时跳到片段,否则打开完整录音。
|
||||
|
||||
将“患者明确说过”“AI 推测”“资料不足或冲突”分开呈现。候选标签需确认后进入服务画像,不覆盖诊断、处方和正式病历。
|
||||
|
||||
### 2.3 联系患者时及结束后
|
||||
|
||||
医助选择患者问题或输入问题,生成回复草稿,查看知识出处后编辑使用。首期由医助复制或填入现有输入框,并自行完成发送。
|
||||
|
||||
沟通结束后生成两份结果:患者侧的本次摘要、诉求变化、未解决问题、下一步;医助侧的 SOP 覆盖、漏答问题、承诺是否具体、需要改进的表达。医助确认后,将“明日下午回电”“提醒补交资料”等转换为现有待办;日期不明确时先由医助补齐,不能让模型随意指定时间。
|
||||
|
||||
### 2.4 主管如何使用
|
||||
|
||||
主管查看本团队有证据的疑似服务问题和逾期待办,下钻原文复核,标记“成立、误判、无需整改”。确认的问题可分配整改;脱敏后可形成训练素材,审核通过的优秀表达可进入服务知识库。AI 评分用于辅导,人工复核后才可作为正式管理依据。
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A[已授权的沟通记录] --> B[来源归一与患者身份核验]
|
||||
B --> C[患者诉求分析]
|
||||
B --> D[医助 SOP 质检]
|
||||
C --> E[医助审阅]
|
||||
D --> E
|
||||
K[已审核服务知识] --> F[沟通提纲和回复草稿]
|
||||
C --> F
|
||||
E --> G[确认后创建既有待办]
|
||||
D --> H[主管复核与团队复盘]
|
||||
H --> I[知识更新和培训任务]
|
||||
I --> K
|
||||
```
|
||||
|
||||
## 3 分析内容与医助评价维度
|
||||
|
||||
### 3.1 患者服务画像
|
||||
|
||||
| 维度 | 建议内容 | 判断规则 |
|
||||
|---|---|---|
|
||||
| 就诊上下文 | 初诊或复诊、关联诊单、负责医助、关联医生 | 读取现有系统事实,不能由模型猜测身份或诊次 |
|
||||
| 当前需求 | 想了解的问题、期望解决的服务事项 | 必须有患者原文或正式记录依据 |
|
||||
| 服务障碍 | 时间安排、流程不清、资料未齐、费用疑问等 | 用中性描述,不推断经济状况或购买能力 |
|
||||
| 配合情况 | 是否确认预约、是否提交资料、是否回应提醒 | 标注观察时间和来源,不贴“难沟通”等人格标签 |
|
||||
| 联系安排 | 可联系时间、沟通方式、是否有家属代办 | 只记录明确表达,家属陈述需标记说话人 |
|
||||
| 待解决事项 | 未回答问题、待医生答复、未完成承诺 | 每项附负责人、下一步、截止时间或“待确认” |
|
||||
| 建议服务动作 | 回访、补资料、协调预约、转医生 | 作为草稿,经医助确认进入业务流程 |
|
||||
|
||||
“已预约、已接诊、已支付”等状态以业务表为准。AI 可提出“患者表达了预约意愿”的候选标签,但不能据此把业务状态改成“已预约”。
|
||||
|
||||
### 3.2 医助服务质检
|
||||
|
||||
先输出每项的“完成、疑似遗漏、不适用、证据不足”,试点期间校准后再启用汇总评分。以下权重为建议初值,需与医助主管共同确认。
|
||||
|
||||
| 检查项 | 建议权重 | 可观察依据 |
|
||||
|---|---:|---|
|
||||
| 身份与沟通背景确认 | 10 | 是否核对本次沟通对象和事项,是否混淆患者与家属 |
|
||||
| 需求收集 | 20 | 是否问清当前诉求、关键资料与需要协调的事项 |
|
||||
| 解释与答疑 | 20 | 是否回答患者的问题,表达是否符合审核后的服务口径 |
|
||||
| 下一步约定 | 15 | 是否说明下一步、责任人和可核对的时间安排 |
|
||||
| 记录与跟进 | 15 | 是否补全必要记录并落实已承诺动作,结合实际待办核查 |
|
||||
| 问题升级与职责边界 | 20 | 应由医生或主管处理的问题是否正确转交,是否出现无依据的疗效承诺 |
|
||||
|
||||
总分只对“适用且有充分证据”的项目计算:已得分 ÷ 适用项目满分 × 100,同时显示可评价覆盖率。覆盖不足、说话人不明或录音不完整时不输出总分;缺失记录不能直接计零分。是否按期履约应由后续业务事实判定,不能在一次谈话后直接认定。
|
||||
|
||||
每个问题包含:检查项、原文证据、时间或消息定位、问题说明、改进建议、复核状态。提示语版本和评分规则版本均需保存,防止规则变化后历史结果不可解释。
|
||||
|
||||
## 4 页面与交互
|
||||
|
||||
| 页面或位置 | 新增内容 | 主要操作 |
|
||||
|---|---|---|
|
||||
| 现有诊单详情 | “AI 服务分析”页签,含患者摘要、沟通时间线、未解决事项、医助质检 | 查看来源、生成分析、修正标签、采纳待办、生成回复 |
|
||||
| 医助工作入口 | “我的 AI 助手”,聚合本人的待处理事项与沟通准备 | 跳转现有患者详情、处理待办、快速准备随访 |
|
||||
| 现有聊天场景 | 患者关联明确时提供“辅助回复”入口 | 选择问题、生成草稿、查看依据、复制或填入输入框 |
|
||||
| 主管质检页 | 按医助、团队、场景、时间、问题类型筛选 | 回看证据、复核误判、指派改进、查看闭环 |
|
||||
| 服务知识页 | 分类、问题、审核答案、版本、适用范围、生效日期 | 草稿维护、审核发布、停用、反馈修订 |
|
||||
| 培训页 | 场景脚本、学习任务、对练记录、逐项评价 | 发布、练习、复训、人工复核 |
|
||||
| 团队服务报告 | 分析覆盖、待办履约、常见问题与改进建议 | 下钻患者或沟通、查看证据、跟踪管理动作 |
|
||||
|
||||
患者详情优先展现“本次要处理什么”,长原文、历史版本、评分细项按需展开。H5 优先保留摘要、草稿、待办采纳和证据查看;复杂规则配置与团队报表先在桌面管理端完成。
|
||||
|
||||
### 4.1 一个具体例子
|
||||
|
||||
患者表示:“这周安排不开,想了解下次复诊怎么预约;上次说要发的资料还没收到。”
|
||||
|
||||
系统生成的服务摘要是“需要协调复诊时间;此前资料发送承诺待核实”。原有业务记录决定是否已经预约;资料发送记录决定承诺是否完成。医助确认后,可创建“联系患者确认可预约时间”和“核实并补发已承诺资料”两项待办。回复草稿引用当前有效的预约流程,不能编造医生出诊时间。质检提示“本轮需确认资料承诺是否落实”,主管可回看原文和后续完成记录。
|
||||
|
||||
## 5 分期与验收范围
|
||||
|
||||
### P0 可试用的患者分析和医助质检
|
||||
|
||||
1. 明确患者身份、医助归属和可用来源;先接现有可授权读取的文字及已验证转写。
|
||||
2. 患者详情新增服务分析;具备摘要、候选标签、未解决事项和证据。
|
||||
3. 初诊接待、诊后随访、复诊协调三类 SOP 检查;先显示检查项,不急于员工排名。
|
||||
4. 小规模已审核 FAQ 支持回复草稿,所有输出可编辑。
|
||||
5. 采纳建议对接现有待办;主管可查看单次质检并标记误判。
|
||||
6. 完成权限、失败重试、撤权、转派、重复采纳和过期结果的保护。
|
||||
|
||||
这一期就应让医助能完成一次真实工作流程,不能只交付展示用的 AI 卡片。
|
||||
|
||||
### P1 知识维护与团队管理
|
||||
|
||||
1. 服务知识库的审核、发布、版本与反馈界面。
|
||||
2. SOP、标签、场景和分析维度配置。
|
||||
3. 按批准的来源逐步扩大沟通接入;企微聊天需先验证实际会话数据能力。
|
||||
4. 个人与团队日报、周报;下钻原文、复核、整改待办形成闭环。
|
||||
5. 增加服务指标,与既有复诊、预约、业绩数据并列展示。
|
||||
|
||||
### P2 医助培训与持续改进
|
||||
|
||||
1. 主管维护学习材料、情景脚本、评分要点和参考答案,支持医疗业务知识内容的人工审核。
|
||||
2. 将复核后的共性问题生成训练草稿,脱敏后发布任务。
|
||||
3. 先交付文本情景对练和逐题评价,再按已验证的语音能力增加语音对练、录音回看。
|
||||
4. 展示学习完成、薄弱项变化和复训结果;训练分数与真实服务表现分别统计。
|
||||
|
||||
首期不依赖视频中所有采集渠道,也不要求实时语音指导、AI 自动外呼或自动代患者沟通。
|
||||
|
||||
## 6 本项目如何落地
|
||||
|
||||
### 6.1 已有基础与需要补齐的部分
|
||||
|
||||
当前医助主要使用 `admin/` 的 Vue 3 + Element Plus 管理端及诊单 H5;服务端为 ThinkPHP 8。`app/` 是 Python 医生工作站,不是本次新增功能的主要客户端。完整现状、75 处代码定位和检查范围见 [项目审查报告](../../artifacts/medical-assistant-feature-plan/repo-audit.md)。
|
||||
|
||||
| 现有能力 | 核实位置 | 本次处理 |
|
||||
|---|---|---|
|
||||
| 我的患者、归属与数据范围 | [MyPatientLogic.php](/D:/web/zyt/server/app/adminapi/logic/firstvisit/MyPatientLogic.php:14)、[我的患者页面](/D:/web/zyt/admin/src/views/first_visit/my_patients/index.vue:16) | 复用患者实体、归属关系和数据范围;新增入口与服务分析页签 |
|
||||
| 患者资料和沟通详情 | [readonly.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:49)、[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:332) | 复用展示与来源读取,新增沟通统一索引、服务摘要和证据跳转 |
|
||||
| AI 授权上下文聚合 | [PatientAiReportLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/PatientAiReportLogic.php:301) | 复用授权、患者关联与来源整理机制;新增服务专用的最小字段视图,不直接把完整临床附件包发给服务分析 |
|
||||
| AI 任务与调用 | [DiagnosisAiLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisAiLogic.php:100) | 复用调用与错误处理基础;新增服务分析、质检和回复草稿契约,独立版本和任务记录 |
|
||||
| 复诊到期与主管处理 | [revisitDue.ts](/D:/web/zyt/admin/src/api/revisitDue.ts:79) | 沿用预计复诊日、已联系、承诺日、延迟与关闭规则,服务建议跳回现有动作 |
|
||||
| 诊单待办提醒 | [DiagnosisTodoLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisTodoLogic.php:24) | 扩展业务执行状态,原发送状态继续独立使用;补充当前患者和操作权限校验 |
|
||||
| 回访录音审阅 | [FollowupAudioReview.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/components/FollowupAudioReview.vue:39)、[验收记录](/D:/web/zyt/docs/plans/followup-audio-deployment.md:11) | 借鉴原文引用、角色确认和人工采纳;启用范围以新验收为准,不能把代码存在当作生产可用 |
|
||||
| 业务看板和医助个人统计 | [PerformanceDashboardLogic.php](/D:/web/zyt/server/app/adminapi/logic/stats/PerformanceDashboardLogic.php:19)、[个人业绩页](/D:/web/zyt/admin/src/views/stats/assistant-performance/index.vue:60) | 复用范围与权威业务数字,新增服务指标,不改现有复诊率和业绩口径 |
|
||||
| 临床参考库 | [ClinicalKnowledgeReference.php](/D:/web/zyt/server/app/common/service/ClinicalKnowledgeReference.php:8) | 仅复用引用设计;另建经院内审核的服务 FAQ,不能把古籍参考库当客服流程知识库 |
|
||||
|
||||
### 6.2 数据接入的实施顺序
|
||||
|
||||
1. **现有 IM 文字、人工服务记录**:在患者身份和访问范围校验后接入。先用已存在数据验证分析价值。
|
||||
2. **企微文字存档**:分别检查员工绑定、会话存档开通与同意状态、同步是否实际成功、覆盖时间。当前代码有相关能力,不代表每名员工和患者已有完整数据。
|
||||
3. **录音与转写**:接入已上传并核验的手机录音转写、回访转写。原文、说话人或时间不可信时,只允许人工核对,不生成正式员工评价。
|
||||
4. **其他来源**:面诊转写按独立权限和业务必要性纳入;未接入渠道显示“未接入”,不显示为零沟通。
|
||||
|
||||
来源页展示“可用、未接入、待同步、部分覆盖、失败”和最后同步时间。无法可靠映射患者的记录进入待关联列表,不凭姓名或手机号相似度自动合并。
|
||||
|
||||
三项必须遵守的现有数据语义:
|
||||
|
||||
- `diagnosis.assistant_id` 对应 `admin.id`;企微员工需通过 `work_wechat_userid` 映射。质检归属使用沟通时的实际员工,而非患者当前医助。
|
||||
- IM 的 `doctor_<adminId>` 前缀也可能表示医助;历史按真实患者合并。接口为展示回填的 `diagnosis_id` 不能证明消息属于该次诊次,诊次关联必须另有依据。
|
||||
- 预约表中部分 `patient_id` 实际按诊单 ID 关联,不能只按字段名字连接。使用现有预约服务,避免新聚合器重新猜测关联。
|
||||
|
||||
### 6.3 服务端处理链路
|
||||
|
||||
新增独立的服务分析业务层:授权检查 → 读取允许的沟通来源 → 核验身份与覆盖范围 → 读取适用 SOP 与已发布知识 → 创建持久任务 → 调用既有 AI 适配层 → 校验结构与证据 → 保存候选结果 → 人工采纳。
|
||||
|
||||
固定输出结构包括 `patient_summary`、`service_needs`、`unresolved_items`、`suggested_actions`、`quality_checks`、`evidence_refs`、`coverage`。模型返回的引用必须对应本次输入的合法来源,找不到证据的事实不能作为确认结论展示。
|
||||
|
||||
- 数字统计、预约状态、复诊到期、患者归属由业务代码确定;模型负责整理和说明。
|
||||
- 原文、转写和知识附件作为数据传入,不允许其中的指令改变系统规则、访问范围或触发发送。
|
||||
- 分析和对外操作分离。分析任务无权发消息、修改处方或写正式病历;“采纳待办”是单独的鉴权接口。
|
||||
- 分析异步执行,页面显示排队、处理中、待审阅、失败、需核对上游结果、已过期;刷新页面不会重复计费创建任务。
|
||||
- 同一患者/来源版本、分析类型、模板版本和授权范围构成幂等键;不同权限范围的上下文不得共用一个可越权的缓存结果。
|
||||
- 超长记录按来源和时间分批,明确覆盖范围,保留可定位证据,不静默截掉后半段;变化后更新受影响结果。
|
||||
- 上游调用结果不明时保留请求标识并核对,不盲目重发。已成功的来源处理步骤可复用,失败不伪装为空结论。
|
||||
- 患者转派、撤权、来源删除或知识过期后,读取和采纳时重新检查;旧分析保留版本痕迹,不能继续用于过期动作。
|
||||
|
||||
### 6.4 建议代码落点
|
||||
|
||||
下表为拟新增或拟修改范围,尚未创建相应业务文件。
|
||||
|
||||
| 层 | 拟落点 | 职责 |
|
||||
|---|---|---|
|
||||
| 患者入口 | `admin/src/views/tcm/diagnosis/readonly.vue`、`edit.vue`、`first_visit/my_patients/index.vue` | 打开服务分析,保持现有病历编辑边界 |
|
||||
| 服务分析组件 | `admin/src/views/tcm/diagnosis/components/AssistantServicePanel.vue` | 双视角结果、原文证据、草稿、采纳与反馈 |
|
||||
| 医助工作页 | `admin/src/views/tcm/assistant_service/index.vue` | 本人待处理、沟通准备、来源覆盖 |
|
||||
| 主管质检 | `admin/src/views/stats/assistant_quality/index.vue` | 问题列表、复核与服务指标 |
|
||||
| 前端 API | `admin/src/api/assistantServiceAi.ts` | 调用分析、任务、证据、草稿、采纳和复核接口 |
|
||||
| 后端入口 | `server/app/adminapi/controller/tcm/AssistantServiceAiController.php` | 薄控制器;请求校验和统一响应 |
|
||||
| 业务逻辑 | `server/app/adminapi/logic/tcm/AssistantServiceAiLogic.php` 及对应 `validate`、`lists` | 权限、筛选、任务创建、结果读取、采纳事务 |
|
||||
| 公共服务 | `server/app/common/service/assistantserviceai/` | 上下文适配、来源映射、模板、知识检索、结构校验、证据与结果生命周期 |
|
||||
| 独立 worker | `server/app/command/AssistantServiceAiWork.php` | 持久任务领取、租约、重试、上游结果核对 |
|
||||
| 待办扩展 | 现有 `DiagnosisTodo` 模型、逻辑、列表、通知任务与前端组件 | 业务执行状态和通知状态分开,新增来源关联与权限检查 |
|
||||
| 迁移和菜单 | `server/sql/1.9.20261109/` 下拟新增编号 SQL | 表结构、索引、菜单和 action 权限;实施时核实目标版本与实际表前缀 |
|
||||
|
||||
菜单、API action 和角色授权一起交付。首期明确列出 `view`、`analyze`、`draftReply`、`adoptAction`、`reviewQuality`、`manageKnowledge` 等权限;能看分析不等于能改病历,能管理知识不等于能看全部患者。
|
||||
|
||||
## 7 数据结构与关键接口
|
||||
|
||||
### 7.1 首期最小数据模型
|
||||
|
||||
以下为逻辑表名,实施时使用项目实际前缀。优先保存原始来源指针,确需保存的引用片段按患者权限保护。
|
||||
|
||||
| 拟新增表 | 主要字段与用途 |
|
||||
|---|---|
|
||||
| `assistant_ai_source_ref` | 来源类型与源 ID、真实患者 ID、入口诊单及已验证的诊次关联、实际员工、发生时间、版本/摘要哈希、覆盖/角色可信状态;唯一索引防止同一来源重复导入 |
|
||||
| `assistant_ai_job` | 分析类型、请求人、范围指纹、输入版本、模板版本、幂等键、任务状态、租约、上游请求标识、错误码、耗时和用量 |
|
||||
| `assistant_ai_result` | 任务关联、患者和服务时间窗、结构化结果、覆盖范围、证据引用、生成版本、过期状态;人工确认标签和画像由结果与复核记录投影 |
|
||||
| `assistant_ai_review` | 结果/检查项、确认/修正/驳回、操作者、原因、前后版本、来源引用;记录质检复核与患者服务标签修正 |
|
||||
| `assistant_service_template` | 场景、字段与 SOP、适用来源、规则及提示词版本、启停和发布时间;P0 固定少量模板,P1 开放配置界面 |
|
||||
| `assistant_service_knowledge` | 问题、审核答案、分类、来源、版本、适用范围、生效/失效时间、审核状态和审核人;P0 提供小规模发布内容,P1 完善维护流程 |
|
||||
|
||||
P1 再补周期报告与知识反馈;P2 再增加培训场景、任务、对练会话和评价记录,不提前建设没有入口的完整平台。
|
||||
|
||||
### 7.2 补全待办而不混淆状态
|
||||
|
||||
现有 `tcm_diagnosis_todo.status` 表示待发送、已发送、取消、发送失败。新增 `assignee_id`、`business_state`、`due_at`、`completed_at`、`completion_note`、`source_result_id`、`source_action_key` 等业务字段,既有记录默认“不纳入服务完成率”,不批量把历史已发送提醒改成已完成任务。
|
||||
|
||||
服务状态建议为“待处理 → 处理中 → 已完成”,支持有原因的取消;“逾期”从截止时间和未完成状态派生。质检整改另加复核记录表示通过或退回。通知发送失败不代表业务任务失败,业务完成也不依赖企微通知成功。
|
||||
|
||||
采纳时事务性创建待办和来源审计,以来源动作键防止重复点击生成多条;返回真实待办 ID。医助本人采纳默认指派自己,主管只能指派其数据范围内员工。当前提醒通知创建人的行为需要同时调整为通知实际负责人,并保持原待办兼容。
|
||||
|
||||
现有待办代码把角色 1 当超管,而患者范围逻辑把角色 1 当医生。接入前须统一为当前 root、权限点和患者范围判断,并检查原入口,避免新增聚合器旁边仍保留绕过路径。
|
||||
|
||||
### 7.3 拟接口契约
|
||||
|
||||
接口遵循当前 `tcm.xxx/action` 风格,名称为方案建议。
|
||||
|
||||
| 接口 | 关键输入和结果 |
|
||||
|---|---|
|
||||
| `GET tcm.assistantServiceAi/overview` | 本人或授权团队、时间窗;返回待处理汇总与来源覆盖,统计由 SQL/业务服务产生 |
|
||||
| `GET tcm.assistantServiceAi/context` | 入口 `diagnosis_id`;返回允许查看的来源列表、当前结果与版本,不能由调用方自行扩大患者范围 |
|
||||
| `POST tcm.assistantServiceAi/analyze` | 入口诊单、来源范围、场景、版本与幂等键;返回任务 ID,重复请求返回原任务 |
|
||||
| `GET tcm.assistantServiceAi/task` | 任务 ID;校验请求人权限及当前患者范围后返回状态、覆盖与可读结果 |
|
||||
| `POST tcm.assistantServiceAi/draftReply` | 当前问题、上下文版本、场景;返回草稿、知识版本、来源和待确认项,不产生发送副作用 |
|
||||
| `POST tcm.assistantServiceAi/adoptAction` | 结果版本、动作项、明确日期和责任人;创建待办并返回 ID,过期或冲突返回可处理错误 |
|
||||
| `POST tcm.assistantServiceAi/reviewQuality` | 检查项、成立/误判/无需整改、原因、版本;记录复核,重算受影响汇总 |
|
||||
| `GET tcm.assistantServiceAi/evidence` | 结果引用 ID;重新检查来源和患者/员工权限,再返回原文或受保护的播放能力 |
|
||||
|
||||
复诊“已联系、延迟、关闭”仍调用现有复诊接口;预约仍走现有时段和挂号流程。服务分析只提供关联入口。
|
||||
|
||||
## 8 指标与报告口径
|
||||
|
||||
新指标单独定义,现有接诊率、复诊率、订单统计沿用原口径。每日窗口使用北京时间,明确查询采用沟通发生时间还是任务截止时间,不能混用生成时间。
|
||||
|
||||
| 指标 | 建议定义 |
|
||||
|---|---|
|
||||
| 有效分析覆盖率 | 窗口内成功产生可评价结果的去重沟通单元 ÷ 窗口内已接入、身份明确且符合场景的去重沟通单元;同时列出未接入与证据不足数量 |
|
||||
| 跟进按期完成率 | 截止时间落在窗口且按期完结的服务任务 ÷ 同窗口应完成任务;取消和未指定截止时间单列,取消须有原因 |
|
||||
| 质检问题确认率 | 人工确认成立的问题数 ÷ 人工已复核的问题数;不使用“全部 AI 提示”作为分母 |
|
||||
| 整改闭环率 | 窗口内应完成整改且复核通过的任务 ÷ 同窗口应完成的整改任务 |
|
||||
| 高频服务问题 | 按去重患者和沟通分别计数,附样本量及来源;不把模型写出的次数当统计值 |
|
||||
| 回复辅助使用 | 分别记录生成、复制/填入、明确反馈采纳;复制不能当作已发送或患者满意 |
|
||||
| 培训完成与改善 | 任务完成率、复训前后同规则得分分别展示;实战服务质量另算,不从训练得分推算 |
|
||||
|
||||
沟通单元需按实际来源定义:一通电话、一次回访、或经约定时间规则切分的文字会话;不得把每条聊天消息当一次服务。重复同步不重复计数。先报告来源分布与样本规模,再进行同场景、同规则版本的团队比较。
|
||||
|
||||
主管周报由后端生成指标,再由 AI 整理“本周共性问题、代表案例、建议改进行动”。每条员工问题都能回到原文和复核状态,未复核的建议明确标记。
|
||||
|
||||
## 9 开发安排与工作量估算
|
||||
|
||||
以下是基于源码静态审查的排期估算,假设配置 1 名前端、1 名后端/AI 工程师,测试与医助主管参与验收;来源可访问,现有模型调用可用。不是供应商报价或已承诺交付日期。
|
||||
|
||||
| 阶段 | 建议时间 | 交付与退出条件 |
|
||||
|---|---|---|
|
||||
| 准备与小样本验证 | 3–5 个工作日 | 用测试账号核验患者与会话范围;确定三类 SOP、FAQ 和脱敏样本;完成文字分析原型验证 |
|
||||
| P0 首期开发与联调 | 12–17 个工作日 | 患者入口、双视角结果、回复草稿、待办扩展、主管复核与完整验收通过 |
|
||||
| P1 管理能力 | 10–15 个工作日 | 知识发布、配置、主管看板、周期报告及批准的来源扩展 |
|
||||
| P2 培训能力 | 10–15 个工作日 | 文本对练、任务、逐项评价、复训与培训统计;语音对练另按音频验收安排 |
|
||||
|
||||
准备加 P0 约 **3–5 周**可形成可试用版本;以上完整文本能力约 **7–11 周**。企微存档开通、历史补采、语音质量整改或既有权限缺陷修复若超出预期,需独立调整排期。首期可选 3–5 名医助和 1 名主管,在一个明确团队中试用。
|
||||
|
||||
运行成本先以试点实测:新增沟通量 × 每次分析输入/输出用量,加回复生成、音频转写和存储成本。去重、增量更新、已分析片段复用、每日预算和并发上限应在首期实现;本方案未假设具体模型单价。
|
||||
|
||||
## 10 验收与发布条件
|
||||
|
||||
### 功能和数据
|
||||
|
||||
- 从现有患者列表进入,完成读取沟通、生成双视角分析、核对证据、生成回复、采纳待办、填写完成结果、主管复核的完整流程。
|
||||
- 患者转派、同一患者多诊单、多人参与沟通、家属代述、记录不足和冲突都能正确显示;展示用诊单 ID 不造成诊次错误归因。
|
||||
- 重复分析和重复采纳不重复创建任务;来源或模板更新有新版本,旧结果可追溯且不能无提示采纳。
|
||||
- 旧待办发送和新任务完成各自正确;通知失败、员工离职、转派、取消和逾期均有可解释结果。
|
||||
|
||||
### 权限和质量
|
||||
|
||||
- 医助仅访问自身患者及允许的来源;组长/经理仅访问所属范围。直接改请求 ID、证据 ID、任务 ID、缓存复用、下载录音和导出均不能突破范围。
|
||||
- 新 AI 聚合先补齐企微员工会话范围检查;敏感来源不因统一分析入口而扩大访问。
|
||||
- 建立至少 50 段经授权脱敏的人工标注样本,覆盖三个场景、不同员工、说话人不明、无答案与冲突情况。业务负责人标注事实、未解决事项、SOP 项和证据,用独立留出样本验证,不能只测开发样例。
|
||||
- 建议首期门槛:所有事实项都有可解析来源;抽检的关键事实正确率 ≥95%;可评价 SOP 项与人工一致率 ≥85%;错误患者关联、越权、重复采纳写入为 0。这些是拟定验收目标,尚未实测,也不代表临床准确率。
|
||||
- 无知识依据的问题明确待确认;不生成未经确认的诊断、改药指令或疗效保证。说话人/语义未核实的音频不能用于正式员工评分。
|
||||
|
||||
### 工程与上线
|
||||
|
||||
- 实施时对新增 PHP、前端类型与构建做检查;增加有业务意义的权限、身份归因、幂等、版本冲突、任务状态和指标口径测试,沿用仓库现有测试方式。
|
||||
- 新功能独立开关与 worker,先启用小范围文字分析,观察来源覆盖、失败率、处理时延、人工修正率和成本,再逐步扩大。
|
||||
- 数据保留与原来源保持一致;删除/撤权同时影响引用副本、缓存、下载与未完成任务。培训材料使用审核后的脱敏或合成场景。
|
||||
- 回退可关闭入口和停止新任务;已确认待办与审计记录保留并可通过原流程处理,不能因为关闭 AI 功能丢失未完成的患者服务事项。
|
||||
|
||||
## 11 开发前需要固定的业务选择
|
||||
|
||||
方案默认首批面向当前 Web 后台医助,试点一个团队,以初诊接待、诊后随访、复诊协调三个场景展开。实施准备阶段由业务负责人确定试点范围、权威 SOP、FAQ 审核人、质检复核负责人及可用的沟通来源;这些选择影响模板与排期,不妨碍本方案先形成可评审结果。
|
||||
|
||||
本次仅新增方案及视频/源码分析材料,未修改业务代码、读取生产配置、执行迁移、调用本项目模型或部署功能。`.trellis/workflow.md` 与 `.trellis/spec/` 在当前工作区不存在,因此未凭空创建 Trellis 记录;开发启动时若恢复这些文件,应再按实际规范补齐流程。
|
||||
@@ -0,0 +1,47 @@
|
||||
# 医助今日联系任务核查
|
||||
|
||||
用户需要主管按医助查看:今天应该维护多少患者、哪些已经有联系记录、还有哪些患者需要维护,并能直接展开名单。本功能放在既有医助团队总览中,近 30 天 AI 服务质检继续保留。
|
||||
|
||||
## 当前默认口径
|
||||
|
||||
首先采用已有复诊节点和明确的联系计划,不假定所有在管患者每天必须联系。复诊到期(含此前到期)、过号、承诺当日,以及人工采纳时勾选“需要联系患者”的到期跟进,可成为今日计划来源。旧自由文本提醒和没有联系类型的服务动作不自动归类。
|
||||
|
||||
当日计划由后台独立生成并保留纳入原因,按医助和患者去重;同患者多张诊单、多条原因不重复算人。今日新增任务可以补入;转交、换绑、周期变化或取消记录为豁免。联系后设置新的承诺日不会使已经纳入的今日任务消失。
|
||||
|
||||
每日统计使用上海自然日。首次启用之前没有日计划快照,不回填或宣称完整重建过去的日报。当前没有擅自增加每 3 天或每 7 天的维护义务;如运营采用固定周期,应另行明确人群、起点和节假日规则。
|
||||
|
||||
## 联系状态
|
||||
|
||||
| 状态 | 依据 | 主管看到的含义 |
|
||||
| --- | --- | --- |
|
||||
| 已联系 | 当天可靠患者/医助账号配对、非空、已归档的 IM 出站文字 | 有实际账号发出记录;不等同患者已读或完成全部服务 |
|
||||
| 人工登记待核实 | 医助本人操作的复诊已联系流水,或本人登记完成的明确联系动作 | 有人工登记,但与可验证的 IM 留痕分开 |
|
||||
| 待维护 | 计划内尚未发现以上当天记录 | 需要联系或补充核查外部电话/企微等渠道 |
|
||||
| 已豁免 | 计划来源取消、失效或归属变化等 | 不算联系完成,保留原因 |
|
||||
|
||||
通知发送、患者单方面发消息、生活记录更新、跟踪备注和 AI 分析完成,都不能单独把待维护人数清零。主管代操作保留真实操作者,不冒充医助本人完成。现有电话与企微会话未完整接入,缺少系统留痕不等于已经证明该医助没有联系。
|
||||
|
||||
有效计划人数 = 已联系 + 人工登记待核实 + 待维护。无任务显示“今日暂无应维护患者”;数据缺失、当天扫描未完成或过期显示对应状态,不显示“全部完成”。
|
||||
|
||||
## 使用流程
|
||||
|
||||
1. 主管进入“医助服务 → 服务工作台”,查看今天各医助的应维护、已联系和待维护人数。
|
||||
2. 点击某医助的待维护人数,侧边直接显示患者、纳入原因、计划时间及联系记录。
|
||||
3. 在同一面板查看原文、近 30 天服务质检和跟进执行,返回保留筛选与分页。
|
||||
4. 页面定时读取最新结果;日计划与联系核查无需等待模型。AI 持续分析沟通内容,但不代替真实联系凭据。
|
||||
5. 从 AI 建议采纳需要联系患者的跟进时,明确勾选联系任务并设置截止时间;系统按日期自动纳入,无需每天手动发起分析。
|
||||
|
||||
## 部署边界
|
||||
|
||||
新增 SQL 位于 `server/sql/1.9.20261110/01_assistant_service_daily_contact.sql`,增加独立日计划表和服务动作联系类型/实际完成操作者字段,不改变诊单待办通知状态。先在隔离 MySQL 5.7 验证幂等迁移,再应用目标库。
|
||||
|
||||
本模块配置沿用 `server/config/assistant_service.php`,独立启用日任务并显式绑定已授权主管账号。模型开关与日计划开关独立。命令:
|
||||
|
||||
```text
|
||||
php think assistant-service:daily --once
|
||||
php think assistant-service:daily --sleep=60
|
||||
```
|
||||
|
||||
调度器使用真实文件锁、持久游标与心跳,适用于共享同一 runtime 的单机进程。GET 只读,不生成任务、不调用模型、不推送消息。首轮未扫描完整范围时明确显示正在生成。外部多机部署应先接入共享调度存储和进程管理。
|
||||
|
||||
具体接口、文件所有权与回归边界见 [实现契约](../../artifacts/medical-assistant-feature-plan/daily-contact-contract.md);本地运行与测试结果见 [验收记录](../../artifacts/medical-assistant-feature-plan/daily-contact-validation.md)。
|
||||
@@ -0,0 +1,116 @@
|
||||
# 医助服务模块部署与使用说明
|
||||
|
||||
独立后台模块入口为“医助服务 → 服务工作台 / 服务知识”。用户已明确以“主管分析和管理医助”为核心:工作台按医助和时间段查看工作概览、跨患者沟通记录、服务质检问题及跟进执行,患者只在关联核查明细中出现。最新产品口径见 [医助维度纠偏方案](assistant-supervisor-dimension-plan-2026-11-09.md)。完整培训对练、周期报告和企微全渠道接入仍按原方案分期。
|
||||
|
||||
## 功能和来源
|
||||
|
||||
- 主导航为当前权限范围内的医助,主管按部门范围查看团队,普通医助仅看本人。每条关联诊单仍与操作者现有患者权限取交集,不另建患者主档。
|
||||
- “当前负责诊单”按当前归属统计,“IM 发言/登记记录”按实际服务账号/记录人统计,质检按可信目标医助和来源归因,跟进按实际执行人统计。这些口径不能混用。
|
||||
- 来源优先接入现有腾讯 IM 文字、跟踪备注与本模块人工服务记录。人工核对的转写仍不自动证明上传者是实际服务员工;无法可靠归因时显示证据不足。
|
||||
- 企微存档、自动录音和未经核验的转写不在首期自动接入范围。页面显示来源覆盖,不把未接入当作没有沟通。
|
||||
- 分析和回复均为持久异步任务,由独立 worker 执行。结果保留来源引用;患者关系、知识或来源变化后不能继续采纳过期结果。
|
||||
- 回复只生成草稿,供医助编辑和复制。不会自动向患者发送,也不会写入临床诊断或处方。
|
||||
- 服务待办采用新增执行记录关联现有 `tcm_diagnosis_todo` 的方式,保存实际完成结果。主管从目标医助分析采纳时,分配给该医助,并保留真实操作人;普通旧任务仍归原操作人。模块提醒按执行人发送;新目标任务发送前核验医助账号、有效角色、当前负责关系和任务绑定,不要求收件人拥有本模块菜单权限。旧提醒发送状态保留原意,历史提醒不自动纳入完成率。
|
||||
- 为兼容现有提醒正文,采纳动作限制 500 字;超长内容应人工精简,不静默截断。完成或取消需记录说明。
|
||||
|
||||
## 数据库与菜单
|
||||
|
||||
先核对目标环境表前缀、PHP 版本和备份,按顺序执行:
|
||||
|
||||
1. `server/sql/1.9.20261109/01_assistant_service_tables.sql`
|
||||
2. `server/sql/1.9.20261109/02_assistant_service_menus.sql`
|
||||
|
||||
新增五张表:人工服务记录、AI 任务、质检复核、跟进动作、服务知识。迁移可重复执行,不改变已有诊单、处方和历史提醒。依赖现有 `tcm_diagnosis_todo` 表;不要跳过项目已有迁移。
|
||||
|
||||
如果前述两份 SQL 已成功执行,本次医助维度纠偏无需重新建表或删除数据。同步更新前后端代码,并重启新版本 worker;新任务的分析对象保存在现有任务快照中。数据库选择成功只代表已选库,仍需确认五张表和菜单实际创建成功。
|
||||
|
||||
医助、经理、诊室组长和管理员获得工作台及基础操作权限;质检复核、知识发布仅默认授予管理角色。root 仍由当前数据库身份判断。菜单可见和后端数据范围分别检查,不能只靠前端隐藏按钮。若站点使用其他角色名称,应由管理员按实际角色授权。
|
||||
|
||||
菜单变更后按现有后台流程刷新权限缓存并重新登录,确认 `/assistant_service/workbench` 和 `/assistant_service/knowledge` 正常出现。
|
||||
|
||||
## AI 配置与运行
|
||||
|
||||
模块配置文件为 `server/config/assistant_service.php`。模型凭据沿用服务端 `prescription_ai` 配置,不在前端设置,不复制密钥到模块表。模块 AI 默认关闭;人工服务资料和知识维护与模型调用分开。
|
||||
|
||||
配置示例:
|
||||
|
||||
```ini
|
||||
[assistant_service]
|
||||
ENABLED = false
|
||||
PROFILE = qwen
|
||||
TIMEOUT = 120
|
||||
LEASE_SECONDS = 300
|
||||
MAX_SOURCE_ROWS = 200
|
||||
MAX_SOURCE_CHARS = 30000
|
||||
MAX_KNOWLEDGE_ROWS = 40
|
||||
DAILY_JOB_LIMIT = 100
|
||||
AUTO_ENABLED = false
|
||||
AUTO_ACTOR_ID = 0
|
||||
AUTO_INTERVAL_SECONDS = 60
|
||||
AUTO_QUIET_SECONDS = 300
|
||||
AUTO_BATCH_SIZE = 10
|
||||
```
|
||||
|
||||
先由管理角色录入院内服务知识,保存草稿后明确发布。修改已发布正文会重新成为草稿,版本变化使依赖旧知识的结果需要重新核对。不得把随意编造的流程、价格或医生排班作为初始知识导入。
|
||||
|
||||
确认实际模型配置可用并通过脱敏样例验收后,将模块 `ENABLED` 改为 `true`。采用批准的进程管理方式运行:
|
||||
|
||||
```sh
|
||||
cd server
|
||||
php think assistant-service:work --once
|
||||
php think assistant-service:work --sleep=3
|
||||
```
|
||||
|
||||
前一命令处理一次,后一命令持续消费。生产使用进程管理器运行持续命令,不在网页请求内调用长时间模型任务。租约需大于请求超时;同一租约失效的旧 worker 不能覆盖结果。
|
||||
|
||||
队列状态:排队、处理中、待审阅、失败、需要核对上游结果、过期。上游调用结果未知或运行租约过期时不自动重发;需核对原请求后处理,不能通过清空任务状态绕过防重复调用。
|
||||
|
||||
明确未发起生成的配置类失败,在修复配置后由用户再次提交相同请求,可恢复同一任务并增加版本。已生成但结果无效、上游状态未知等情况不会自动重发。关闭 AI 开关只暂停入队和模型执行;人工登记、知识维护、有效结果的人工复核及已有待办处理仍按原权限开放。
|
||||
|
||||
## 自动分析与主管试用路径(当前版本)
|
||||
|
||||
配置中把 `AUTO_ACTOR_ID` 绑定到明确授权、现存且启用的主管账号,并启用 `AUTO_ENABLED`。默认不挑选 root;调度范围实时取该账号的员工与患者权限交集。运行 `php think assistant-service:auto --sleep=60`,同时保持原 `assistant-service:work --sleep=3` 消费进程。
|
||||
|
||||
当前实现适用于单机:所有扫描进程、worker 和 Web 必须共享 `server/runtime/assistant_service_automation/`;扫描锁、游标及真实心跳保存在该目录。多机部署应先改成共享锁与持久调度存储,不能直接复制此本地运行方式。
|
||||
|
||||
1. 主管登录后进入“医助服务 → 服务工作台”,直接看到最近 30 天团队总览。
|
||||
2. 系统每 60 秒发现有效来源,沟通安静 5 分钟后自动入队;首轮也覆盖近 30 天已有来源,每轮最多 10 条,沿用每日 100 条默认额度。
|
||||
3. 主管筛选待复核、逾期或需关注医助,在侧边详情核查问题和原文。返回总览保留筛选和分页。
|
||||
4. 自动分析只是初筛;人工记录问题成立、误判或不适用,按需确认并分配跟进建议给该医助。
|
||||
5. 页面每 30 秒静默读取最新结果,不在刷新时调用模型;核查中的分析和已输入表单保留,新分析通过“查看最新结果”显式切换。
|
||||
6. 如需回复草稿,先发布实际审核的服务 FAQ,再在关联记录里明确生成。此操作仍需用户发起,不会自动发送消息。
|
||||
|
||||
无新来源、仅时间窗口变化、失败或结果未知的任务不会被扫描器反复调用。达到日额度会保留后续候选;来源超限、通道未接入等状态需要处理,不能视为已完成。无需新增数据库迁移。
|
||||
|
||||
## 回退与运行观察
|
||||
|
||||
关闭 `AUTO_ENABLED` 并停止自动扫描进程可暂停后续自动入队;已排队的任务仍由 worker 处理。关闭模块 AI 开关并停止其 worker 可停止新的模型分析。保留新表和审计,不删除已采纳的跟进任务或历史服务记录。工作台应继续允许按权限查看资料和处理已有任务。
|
||||
|
||||
观察排队时长、失败与需核对任务、证据不足比例、人工修正情况及日调用量。以业务正确性和真实来源覆盖为准,不能把结构校验通过或 HTTP 成功当作医疗语义准确率通过。
|
||||
|
||||
## 验证命令
|
||||
|
||||
新增测试使用合成数据及注入的模型响应,不需要真实患者或模型密钥。PHP 安装如未默认启用 SQLite,可对单次测试命令增加 `-d extension=php_pdo_sqlite.dll`;无需修改系统 PHP 配置。
|
||||
|
||||
数据库迁移测试必须显式提供临时库端口和数据目录,并校验 `@@datadir`;不读取业务 `.env`。前端构建应直接运行 Vite,不能以带发布脚本的 `npm run build` 代替本地验证。
|
||||
|
||||
```powershell
|
||||
# 在 server 目录执行;仅合成数据,不调用模型
|
||||
php tests/AssistantServiceEngineTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceWorkerTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceAutomationTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceReminderRecipientTest.php
|
||||
|
||||
# 在 admin 目录执行
|
||||
node --test tests/assistant-service.test.cjs
|
||||
node node_modules/vite/bin/vite.js build --outDir ../.spool/assistant-service-build
|
||||
```
|
||||
|
||||
2026-11-09 医助维度验收:Engine 63、Worker 66、API 76、Staff 84、提醒收件人 17 项断言通过;MySQL 5.7 API→Worker 与并发链路扩展至 46 项通过,之前的隔离迁移 18 项通过且本次未改 SQL。前端 21 项组件行为测试通过,最终全量 Vite 构建成功。类型检查仍退出 1,未输出本模块路径的诊断;本次未重新比对全仓错误基线,不宣称全项目类型检查通过。
|
||||
|
||||
浏览器验收挂载真实 Vue 组件,API 使用合成内存夹具:验证默认医助概览、医助/时间切换、批量分析刷新汇总、员工视角核查、人工驳回移出问题列表、分配给目标医助和跨患者跟进。该验收证明页面交互,MySQL 测试证明后端链路;未宣称已通过真实模型内容准确性或线上完整登录流程验收。截图与详细记录见 [医助维度验收记录](../../artifacts/medical-assistant-feature-plan/staff-validation.md)。
|
||||
|
||||
以上为早期医助维度验收的历史记录。当前本地已使用现有五张表和模型配置;自动版本运行与验收以 [本地运行说明](../../artifacts/medical-assistant-feature-plan/local-running.md) 和本轮 automatic 验收记录为准。外部环境仍需独立完成部署与授权。
|
||||
@@ -0,0 +1,61 @@
|
||||
# 主管按医助分析与管理:功能纠偏方案
|
||||
|
||||
用户确认:主要供主管分析和管理医助。原版把“选患者”做成主入口,是产品维度错误。本版以医助为统计、分析和管理对象,患者只作为服务记录的关联对象。
|
||||
|
||||
## 主管的使用路径
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A[主管可见的医助列表] --> B[选择医助与时间范围]
|
||||
B --> C[工作概览与服务质检汇总]
|
||||
B --> D[该医助的沟通记录]
|
||||
B --> E[待复核问题与跟进执行]
|
||||
D --> F[勾选记录批量分析]
|
||||
F --> C
|
||||
C --> G[展开具体记录核查依据]
|
||||
E --> G
|
||||
G --> H[主管复核并分配跟进]
|
||||
H --> E
|
||||
```
|
||||
|
||||
1. 主管进入工作台,首先看到权限范围内的医助;选择一位医助和最近 7、30 或 90 天。
|
||||
2. 不选择患者,即可看到该医助的工作记录、服务质检汇总、逾期及待执行任务。
|
||||
3. 在“沟通记录”中跨患者勾选最多 10 条诊单记录,统一提交该医助的服务分析,后台异步处理。
|
||||
4. 在“质检问题”中查看有证据、明确归因该医助的疑似遗漏,进入明细核查原文,记录成立、误判或不适用。
|
||||
5. 从分析建议采纳跟进任务,负责人为被分析医助,主管保留为实际操作人;跟踪执行结果与逾期情况。
|
||||
6. 普通医助登录时仅看到本人,主管的团队范围继续服从现有部门数据权限。
|
||||
|
||||
## 管理指标与口径
|
||||
|
||||
| 管理问题 | 展示内容 | 归属与去重规则 |
|
||||
|---|---|---|
|
||||
| 目前承担多少工作 | 当前负责诊单数 | 当前诊单 assistant_id;不是历史服务业绩 |
|
||||
| 期间有哪些沟通留痕 | 医助 IM 发言条数、登记记录数、最近活动 | 可靠 IM 账号对应真实医助;登记按实际记录人,登记不证明历史发言身份 |
|
||||
| 服务有哪些优点或问题 | 六项 SOP 的已覆盖、疑似遗漏、资料不足、人工复核情况 | 仅当前有效、目标医助与时间范围一致的分析;同诊单同检查项使用最新有效结果 |
|
||||
| 哪些问题需要主管处理 | 待复核或已确认问题列表 | 最新人工驳回/不适用不再作为问题展示;每项可回到来源 |
|
||||
| 跟进有没有落地 | 待执行/进行中、已逾期、期间完成及完成备注 | 按 action.assignee_id,不按分析提交人或提醒创建人 |
|
||||
|
||||
六项服务质检:身份与背景确认、需求收集、解释与答疑、下一步约定、记录与跟进、问题升级。界面汇总实际证据与复核结果,不把无记录判为未服务,不凭患者归属推断历史服务员工,不用重复生成次数充当工作量。
|
||||
|
||||
## 具体页面组织
|
||||
|
||||
- **主入口:医助服务分析**。医助选择、时间范围、工作概览、质检汇总是首页主体。
|
||||
- **沟通记录**。展示当前所选医助关联的诊单、沟通/登记数量和最近活动;支持勾选后批量分析。患者名字只是记录的一列。
|
||||
- **质检问题**。默认按所选医助聚合,支持进入对应记录和分析版本核查、人工复核。
|
||||
- **跟进执行**。直接展示该医助跨患者的任务,主管无需逐个患者寻找待办。
|
||||
- **记录核查明细**。查看该医助的来源和服务分析,默认员工服务视角;患者诉求及回复草稿作为辅助信息。关闭明细回到医助总览。
|
||||
- **服务知识**。保留既有审核发布能力,支撑院内服务口径。
|
||||
|
||||
## 数据与权限
|
||||
|
||||
继续使用已建的五张模块表。异步任务 payload 记录质检对象 `subject_admin_id`,job.actor_id 保留真正提交分析的主管。生成、读取、复核和采纳都校验目标医助域、操作者患者域和来源版本;两位医助服务过同一患者时,分别过滤其可靠沟通来源。
|
||||
|
||||
主管只看到当前部门范围内的有效医助。跨部门医助 ID 和任意诊单 ID 由服务端拒绝;医助不能通过改请求参数查看同事。患者转派不会把旧服务记到新医助名下,访问旧记录仍须当前权限允许。
|
||||
|
||||
跟进执行人和操作人分别保存。既有普通提醒仍发给创建人;模块关联任务发给执行人,并在发送前复核账号、患者关系及访问权限。开发验收不发送真实消息。
|
||||
|
||||
## 分期与本次边界
|
||||
|
||||
本次纠偏交付医助主入口、跨患者统计、目标服务分析、批量入队、质检问题、主管复核和任务分配跟踪。完整情景对练、周期报告自动生成、企微会话存档和自动音频接入仍为后续阶段。现有单次分析用于形成可追溯的医助汇总,不伪装成完整渠道覆盖。
|
||||
|
||||
先前建表与菜单脚本若已成功执行,无需删除或重建数据库;本次按复用现有结构开发。前后端代码与 worker 必须同步更新,避免旧 worker 用全患者上下文处理新目标任务。
|
||||
Reference in New Issue
Block a user