更新
@@ -0,0 +1,2 @@
|
||||
# 原视频抽帧和机器转写仅用于本地分析,不随方案提交。
|
||||
video/
|
||||
@@ -0,0 +1,52 @@
|
||||
# 医助服务 AI 引擎与持久 worker 实现
|
||||
|
||||
> 最终集成补充:建议动作提示与服务端校验已统一为 500 字,覆盖 500/501 字边界,Engine 最终为 63 项通过。见 [validation.md](validation.md)。
|
||||
|
||||
日期:2026-11-09。范围仅为实现契约中的 `ai_engine` 所有权。已读根 `AGENTS.md`、`CLAUDE.md`、实施契约与 `repo-audit.md`;`.trellis/` 不存在。未读 `.env`、未连接业务数据库、未调用真实模型、未发送患者消息、未部署、未提交 Git。
|
||||
|
||||
## 新增文件
|
||||
|
||||
- `server/app/common/service/assistantservice/AssistantServiceEngine.php`:真实默认适配 `DifyChatService::chat()`,模型 profile/timeout 来自 `assistant_service`。使用 `knowledge_mode=evidence`、空 inputs 与空 files,避开既有临床古籍提示注入;只发送脱敏来源的白名单字段与已发布知识快照,不发送患者姓名或完整患者对象。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceWorker.php`:持久队列领取、租约与 token CAS、生成前及提交事务中的权限/患者/来源/知识复核。
|
||||
- `server/app/command/AssistantServiceWork.php`:`assistant-service:work --once` 与持续轮询 `--sleep=3`;支持 POSIX 退出信号,输出处理计数或固定错误名,不输出来源正文、SQL 或异常原文。
|
||||
- `server/tests/AssistantServiceEngineTest.php`、`server/tests/AssistantServiceWorkerTest.php`:独立 PHP 回归脚本。配置、console 注册、菜单与迁移由主代理负责,未修改其他代理文件。
|
||||
|
||||
## 结果约束
|
||||
|
||||
严格 JSON 对象、固定字段、字段类型、长度、数组数量和六个唯一质检 key 均校验。不尝试靠补字段或补引文把失败响应“修成成功”;额外 score/send 字段拒绝。所有事实、候选标签和服务动作必须引用真实来源 ID;动作 key 唯一且格式有限。
|
||||
|
||||
对 `met/missed/not_applicable` 员工归因,必须存在可评估的员工逐字来源,原文 `speaker=service`、`actor_admin_id` 与结果一致。跟踪备注、unknown、患者单方陈述、混合不同员工的引文不能产生个人评价。完全没有可归因服务原文时,六项统一归为 `insufficient` 并清除 actor,原因由服务端替换为资料不足。模型不得从当前医助归属推测历史说话人。
|
||||
|
||||
回复必须引用快照内真实知识 ID 与版本;显式 draft/disabled 条目拒绝。`needs_confirmation` 由服务端强制 true。草稿和分析的文本均拒绝明显诊断、剂量/改药指令、处方建议及疗效承诺;涉及医疗问题只保留转医生核对的服务路径。原始模型响应、推理内容和非白名单 metadata 不落库。
|
||||
|
||||
## 队列与失败处理
|
||||
|
||||
任务领取使用事务与 queued 状态 CAS,生成前已持久化随机 claim_token 和 lease_until。租约下限为单次模型 timeout 加 60 秒。提交成功/失败均要求当前状态 running、token 相同且租约未过期。
|
||||
|
||||
过期 running 统一转 `needs_reconciliation`,不重新排队;超时、连接中断、未知异常、未知上游错误均不重发。Dify 将限流和 5xx 合并为 BUSY,无法证明未执行,故同样保守隔离。已明确的配置错误、请求拒绝或结构失败落 failed,也没有自动重试。Dify 原有明确路径不存在时的协议兼容行为未修改;没有新增供应商重试层。
|
||||
|
||||
调用前及写入结果前重新执行 Access::diagnosis 与 Context::build,比较 patient_id/source_hash/scope_hash;提交时锁任务及诊单。快照里的每条知识重新锁读,核对 published、version 与 question/answer/category/source_note;任何变更落 stale,丢弃结果。新增无关知识不导致旧快照过期。不会将当前数据覆盖快照后继续产出旧任务。
|
||||
|
||||
## 已执行验证
|
||||
|
||||
```powershell
|
||||
php server/tests/AssistantServiceEngineTest.php
|
||||
php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceWorkerTest.php
|
||||
php -l server/app/common/service/assistantservice/AssistantServiceEngine.php
|
||||
php -l server/app/common/service/assistantservice/AssistantServiceWorker.php
|
||||
php -l server/app/command/AssistantServiceWork.php
|
||||
php -l server/tests/AssistantServiceEngineTest.php
|
||||
php -l server/tests/AssistantServiceWorkerTest.php
|
||||
```
|
||||
|
||||
- Engine:60 项断言通过。覆盖真实 transport 参数、evidence 模式、患者身份白名单、伪造/缺失/重复引文、错误员工与未知说话人、六项不足评价、知识引用与状态、诊疗越界、强制人工确认、上游错误脱敏、严格 JSON 与禁用门禁。
|
||||
- Worker:66 项断言通过。使用真实 Think ORM 与内存 SQLite、真实 Engine 及注入合成 transport;覆盖调用前持久租约、两次权限检查、调用期间撤权/换患者/来源或员工域变化、知识更新/撤回/正文偷偷改变、无关知识新增、第二 worker 不重复领 running、token 丢失、租约过期、未知异常不重试,以及实际 CLI `--once` 与缺表错误脱敏。
|
||||
- 五个 PHP 文件 `php -l` 全通过。SQLite 扩展仅用进程参数启用,不改 php.ini,不需要也没有访问 MySQL。
|
||||
|
||||
## 验证局限与交接
|
||||
|
||||
测试中的 Access/Context 是受控适配器,以便验证真实 worker 在依赖返回变化时的行为;真实角色与患者域算法、API 采纳动作校验由 backend_api 测试覆盖。SQLite 验证真实 SQL 状态转移及 CAS,但不证明 MySQL 的多进程锁竞争表现,发布前应在隔离 MySQL 做并发验证。
|
||||
|
||||
规则能校验结构、引用成员关系和确定性员工归属,不能用正则证明自然语言事实完全被引文蕴含,也不声称医疗语义已验收。诊疗词规则有意保守,可能拒绝带医疗词的无害复述;所有输出仍须人工复核。未做真实模型语义验收,不应据此宣称生产已开启或质量达标。
|
||||
|
||||
未实现自动 reconciliation 或重新排队接口;需管理员核对供应商记录与任务状态后另行处理,禁止直接循环重发不确定任务。主代理需完成 config/console 注册、迁移、模块开关与部署说明。真实模型依赖既有 `prescription_ai` 配置,默认禁用由配置负责人管理。
|
||||
@@ -0,0 +1,27 @@
|
||||
{
|
||||
"at": "2026-11-09T17:33:03+08:00",
|
||||
"type": "reply",
|
||||
"synthetic_only": true,
|
||||
"database_written": false,
|
||||
"profile": "qwen",
|
||||
"seconds": 1.51,
|
||||
"ok": true,
|
||||
"error_code": "",
|
||||
"transport": {
|
||||
"ok": true,
|
||||
"error_code": "",
|
||||
"content_bytes": 640,
|
||||
"json_object": true,
|
||||
"result_keys": [
|
||||
"reply",
|
||||
"knowledge_refs",
|
||||
"evidence_ids",
|
||||
"needs_confirmation",
|
||||
"reason"
|
||||
]
|
||||
},
|
||||
"quality_items": 0,
|
||||
"suggested_actions": 0,
|
||||
"knowledge_refs": 1,
|
||||
"needs_confirmation": true
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
{
|
||||
"at": "2026-11-09T17:33:34+08:00",
|
||||
"type": "analysis",
|
||||
"synthetic_only": true,
|
||||
"database_written": false,
|
||||
"profile": "qwen",
|
||||
"seconds": 5.14,
|
||||
"ok": true,
|
||||
"error_code": "",
|
||||
"transport": {
|
||||
"ok": true,
|
||||
"error_code": "",
|
||||
"content_bytes": 2725,
|
||||
"json_object": true,
|
||||
"result_keys": [
|
||||
"summary",
|
||||
"needs",
|
||||
"unresolved",
|
||||
"tags",
|
||||
"suggested_actions",
|
||||
"quality_checks"
|
||||
]
|
||||
},
|
||||
"quality_items": 6,
|
||||
"suggested_actions": 1,
|
||||
"knowledge_refs": 0,
|
||||
"needs_confirmation": null
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
# 本地医助 AI 已启用
|
||||
|
||||
2026-11-09,用户明确要求启用 AI 并启动后台任务,以完整测试主管分析和管理医助流程。
|
||||
|
||||
## 运行状态
|
||||
|
||||
- 工作台:http://127.0.0.1:5560/admin/assistant_service/workbench
|
||||
- 本地 `server/.env` 增加医助独立开关 `ENABLED=true`,profile 为 qwen。原有模型凭据和其他模块配置保持原值;配置文件的默认关闭行为未改变。
|
||||
- 后台进程:`php think assistant-service:work --sleep=3`,工作目录 `D:/web/zyt/server`,隐藏窗口持续运行,启动 PID 59136。进程及时间记录在 `.spool/assistant-local-processes.json`。
|
||||
- 运行日志:`.spool/assistant-local-worker.out.log`、`.spool/assistant-local-worker.err.log`。启动后持续检查未见存储/配置错误;只读检查时队列为空,等待用户提交。
|
||||
- HTTP、worker 使用同一本地 `zyt` 数据库。用户已登录的工作台刷新可用状态后,原“AI 分析尚未启用”提示消失。
|
||||
|
||||
## 实际模型验证与修正
|
||||
|
||||
使用明确标记的合成服务对话和合成 FAQ 直接调用真实模型,不查询或发送患者内容,不创建业务任务,不发布合成知识。
|
||||
|
||||
首次真实分析发现提示示例没有展示 tags 元素结构,模型返回字符串标签;不适用项也缺少员工依据。补齐对象结构与状态依据要求,继续严格拒绝缺证据结果。首次回复发现同一提示还要求输出分析的六项质检,导致回复多出字段;已将分析与回复的格式要求分离。
|
||||
|
||||
最终结果:
|
||||
|
||||
| 项目 | 结果 |
|
||||
|---|---|
|
||||
| 真实分析 | 通过;5.14 秒,6 项质检、1 项跟进建议;严格 JSON、来源、员工归因和服务边界校验通过 |
|
||||
| 真实回复草稿 | 通过;1.51 秒,1 条合法知识引用,强制 `needs_confirmation=true` |
|
||||
| Engine 回归 | 71 项通过,覆盖标签依据、不适用项员工依据、回复独立格式和原有边界 |
|
||||
| PHP 语法 | 通过 |
|
||||
| 浏览器 | 已登录工作台刷新后不再提示 AI 未启用,概览正常加载 |
|
||||
|
||||
结构化记录:`ai-live-smoke.json`、`ai-live-reply-smoke.json`。耗时只代表这两条合成样例,不能视为正式任务时延或语义准确率保证。本轮没有代用户对真实员工作出质检复核、绩效判断、分配跟进或发送消息;先前隔离队列与主管交互测试记录保持有效,当前后台等待用户提交实际测试任务。
|
||||
|
||||
## 用户测试路径
|
||||
|
||||
1. 工作台选择医助、时间范围,进入“沟通记录”,选择有有效来源的关联诊单后提交分析。
|
||||
2. 等待后台从排队、处理中转为待审阅,查看员工服务视角和引用依据。
|
||||
3. 在质检问题中核查原文并人工复核;选择建议分配给对应医助,再到“跟进执行”处理。
|
||||
4. 当前本地已发布服务知识为 0。若测试回复草稿,先到“服务知识”发布已审核 FAQ,再回到记录中生成回复。
|
||||
|
||||
后台不自动发送患者回复;通知与业务跟进完成状态保持独立。改变配置后需让 worker 重新加载,运行中有任务时先等待其结束,避免产生未知上游状态。
|
||||
|
||||

|
||||
@@ -0,0 +1,130 @@
|
||||
# 医助 AI 真实运行只读核对
|
||||
|
||||
日期:2026-11-09。已读根 `AGENTS.md` 与相关实现;`.trellis/` 不存在。本次未读取 `.env` 凭据、未联网、未访问数据库、未启停进程、未修改业务代码,也未执行真实模型。以下是源码结论与供主任务执行的验证方案,不能替代实际运行证据。
|
||||
|
||||
## 结论
|
||||
|
||||
默认生产调用确实会进入 `DifyChatService::chat()`,没有默认 mock。启动需要同时满足医助独立开关、处方 AI 共享配置、模块表、账号权限和独立 worker。`capabilities.ready=true` 仅代表静态配置及五张表字段可读,不代表供应商鉴权/模型协议成功,也不代表 worker 存活。建议先做两次只含合成资料的真实 Engine 调用,再在主管页面创建一个任务验证持久队列。
|
||||
|
||||
## 配置及就绪条件
|
||||
|
||||
| 项目 | 源码要求 | 核对意义 |
|
||||
|---|---|---|
|
||||
| `assistant_service.enabled` | `assistant_service.ENABLED`,默认 false | HTTP 入队与 worker 都检查;仅开共享 AI 不够 |
|
||||
| `assistant_service.profile` | `qwen` 或 `openai`,默认 qwen | 决定读取哪个 `prescription_ai.models` 的 key/name |
|
||||
| `prescription_ai.enable` | `prescription_ai.ENABLE`,默认 false | DifyChatService 再次检查;医助并没有独立凭据 |
|
||||
| `prescription_ai.base_url` | 非空 HTTP(S),调用端还禁止 URL 用户名、密码、query、fragment | 只读取配置是否有效,不输出地址/密钥 |
|
||||
| 模型条目 | 所选 `models[profile].api_key` 非空且无 CR/LF,`name` 非空 | `name` 对 Dify 不入请求体,对 Chat Completions 才入 `model` |
|
||||
| cURL | `curl_init` 可用 | CLI worker 与 Web PHP 可能使用不同 php.ini,须分别核对 |
|
||||
| timeout | 配置文件钳制为 10–240 秒,默认 120 | Engine/Dify 接口均接受 1–300;医助 options 覆盖共享默认超时 |
|
||||
| lease | 默认至少 300 秒,领取时再保证至少 timeout + 60 | 常规 120 秒调用在 300 秒租约内;无心跳续租 |
|
||||
| schema | record/job/review/action/knowledge 五表所有列可查 | 不核验索引、队列消费者或模型连通性 |
|
||||
| 权限/数据 | Access 动态判断员工、主管、患者和操作权限 | 菜单可见不能替代分析/复核/采纳权限 |
|
||||
|
||||
定位:`server/config/assistant_service.php`、`server/config/prescription_ai.php`、`AssistantServiceLogic.php:56,541`。模型名称为源码既有值,本核对未验证其在实际供应商侧存在。
|
||||
|
||||
## 真实输入输出协议
|
||||
|
||||
`AssistantServiceEngine.php:26` 调用:
|
||||
|
||||
```php
|
||||
DifyChatService::chat($profile, [], $prompt, 'assistant-service', [], [
|
||||
'knowledge_mode' => 'evidence',
|
||||
'timeout' => $timeout,
|
||||
]);
|
||||
```
|
||||
|
||||
- 不提供 transport 时即为真实链路;测试文件中的闭包只是显式隔离测试。
|
||||
- `inputs` 和 `files` 均空;`knowledge_mode=evidence` 仅跳过本仓库的临床参考提示注入,不能改变远端 Dify 已发布应用自己的系统提示、工具、必填输入或答案格式。
|
||||
- prompt 包括服务边界、场景、任务类型、六项质检约束、目标医助 ID,以及 `question/sources/knowledge`。sources 仅发 id/channel/text/occurred_at/speaker/actor_admin_id/quality_eligible 白名单,context 的患者对象不发。真实 Context 先进行现有文本脱敏;合成探针也应完全不含真实身份。
|
||||
- Dify:POST `…/v1/chat-messages`,`inputs={}`、`query=prompt`、`response_mode=blocking`、`user=assistant-service`、`auto_generate_name=false`;没有 conversation_id,不续接历史对话。
|
||||
- Chat Completions:POST `…/v1/chat/completions`,`model=配置 name`、一条 user message。不传 `response_format/json_schema`,JSON 可靠性依赖提示词和返回校验。
|
||||
- base_url 如已明确以 `/chat-messages` 或 `/chat/completions` 结束,只走该协议;普通 `/v1` 优先 Dify,只有明确 404/405/501 等路径不支持才尝试兼容协议。医助的空 inputs/空 files 不触发临床附件或输入降级重发。
|
||||
- 上游成功包从 `answer` 或 `choices[0].message.content` 提取文本,经既有 reasoning filter 后 trim。Engine 只接受一个严格 JSON 对象,最多 100000 字节、JSON 深度 32;Markdown 围栏、额外字段、结构缺失均失败,不自动修复或二次追问。
|
||||
|
||||
分析必须恰好有 `summary/needs/unresolved/tags/suggested_actions/quality_checks`。前四项为带 text/evidence_ids 的数组;每个事实及建议动作需真实来源引文。建议动作最多 8 条,key 唯一,text 最多 500 字。质检必须恰好为 identity/needs/explanation/next_step/followup/escalation 六项,状态只能 met/missed/not_applicable/insufficient;非 insufficient 的员工归因必须引用可归责的员工逐字来源并匹配 actor_admin_id。
|
||||
|
||||
回复必须恰好有 `reply/knowledge_refs/evidence_ids/needs_confirmation/reason`;至少一条真实知识 ID 和版本与至少一条来源引文。服务端强制 needs_confirmation=true,不发送消息。两类结果都拒绝明显诊断、改药剂量、处方与疗效承诺文本。
|
||||
|
||||
定位:`AssistantServiceEngine.php:84,268`;`DifyChatService.php:1316,2813,2884`。
|
||||
|
||||
## Worker 启动与观察
|
||||
|
||||
命令已在 `server/config/console.php:8` 注册。主任务核实环境后可从 `D:\web\zyt\server` 启动:
|
||||
|
||||
```powershell
|
||||
php think assistant-service:work --sleep=3
|
||||
```
|
||||
|
||||
`--once` 只领取最旧的一条 queued 任务,不限定当前测试任务,不是只读健康检查。持续 worker 同样会消费该数据库中全部现存医助队列;启动前应核对队列数量和配置目标,防止把旧测试任务也当成本次测试结果。
|
||||
|
||||
- HTTP 与 worker 必须连接同一已确认数据库并加载一致开关/profile。长驻进程在启动时加载配置,改配置后要让 worker 使用新进程;不能仅根据网页 ready 判断老 worker 已启用。
|
||||
- `runOnce()` 在关闭开关时直接 false。`--once` 会打印 `processed=0` 并正常退出,所以退出码 0 不证明 AI 可用。
|
||||
- `processed=1` 只表示领取过一条任务;任务可能 ready/failed/stale/needs_reconciliation。必须继续读取 job 状态和结果。
|
||||
- 任务先持久化 running/token/lease,再调用模型;生成前及最终写入事务中复核权限、患者、source_hash、scope_hash、知识状态/版本/正文。调用期间改记录或知识可能得到 stale,测试时应先准备齐全部来源,再提交。
|
||||
- 同步模型调用没有取消接口及租约心跳。命令仅在存在 pcntl 时注册 POSIX 信号;Windows 上强制结束运行中的 PHP 可能留下未知上游结果。空闲时停止最稳妥;已运行任务不要直接杀进程后重发。
|
||||
- 超时/连接异常/429/5xx 等不确定结果落 needs_reconciliation;过期 running 下次领取时改为 LEASE_EXPIRED,绝不自动重新生成。只有持有有效 token 且租约未到期的 worker 能落结果。
|
||||
- CLI 的 storage_or_configuration_error 为脱敏固定字符串,持续模式会继续轮询。进程存活不代表数据库就绪。当前没有 worker 心跳 API,因此完成一条真实队列任务是最小有效运行证明。
|
||||
|
||||
定位:`AssistantServiceWorker.php:13,70,94,124`;`AssistantServiceWork.php:23`。
|
||||
|
||||
## 已存在的具体可用性问题与边界
|
||||
|
||||
1. **静态 URL 就绪检查与实际请求校验不一致。** `AssistantServiceLogic::modelReady()` 只检查 FILTER_VALIDATE_URL 与 scheme;`DifyChatService::isValidBaseUrl()` 另禁止 user/pass/query/fragment。形如 `https://example.invalid/v1?x=1` 的配置可以被页面判断 ready,却在 Engine 实际调用前失败 CONFIG_INVALID。这是可定位的源码缺陷;当前实际 URL 未读取,因此不能声称本环境已命中。
|
||||
2. **主管录入的人工记录不自动成为目标医助来源。** record 保存 `actor_id=当前登录人`,而带 assistant_id 的 Context 只读取该医助 actor_id 的人工记录。若主管自己登记一条再分析另一位医助,该记录不会出现在该医助输入中。测试来源应由目标医助身份创建,或使用归属可靠的既有 IM;不要将主管录入人冒充为历史员工发言人。定位 `AssistantServiceLogic.php:107`、`AssistantServiceContext.php:34`。
|
||||
3. **人工转写不能覆盖员工质检成功路径。** 即便 verified_transcript 且 speaker_confirmed,Context 仍把整段人工文本设为 unknown/actor=0;仅有人工记录时六项由服务端归为 insufficient。该限制是有意的身份边界;若要测试主管的员工问题归因,应使用 reliable IM 对话,而不是期待勾选“确认转写”就产生员工归责。定位 `AssistantServiceContext.php:39`、`AssistantServiceEngine.php:84`。
|
||||
4. **失败后的重复点击不会普遍重跑。** 相同来源/范围/问题/知识形成相同 dedupe_key。RESULT_INVALID、UPSTREAM_REJECTED、needs_reconciliation 均返回旧任务;仅明确未生成的配置/输入失败可重新入队。profile 不参与 dedupe,所以单纯切模型也不会重跑同一格式失败任务。这里是现有防重复执行策略,尚无 reconciliation UI;真实探针应先于正式入队,避免“已开 AI 但点击无新结果”的误判。定位 `AssistantServiceLogic.php:125,148`。
|
||||
|
||||
其他容量边界:全部已发布知识整体送入上下文,默认最多 40 条;超过上限会连 analysis 也拒绝入队,当前没有相关性检索。没有来源会直接拒绝;回复没有已发布知识也直接拒绝。这些属于明确配置/资料条件,不是 worker 故障。
|
||||
|
||||
## 最小真实合成样例验证方案
|
||||
|
||||
### A. 先验证真实模型协议,两次调用,不落业务任务
|
||||
|
||||
主任务在已经确认的服务端配置环境中调用 Engine,不传 transport。使用固定的完全合成资料,无需连接业务库查询:
|
||||
|
||||
```php
|
||||
$context = [
|
||||
'subject_admin_id' => 11,
|
||||
'sources' => [
|
||||
['id' => 'im:synthetic_patient', 'channel' => 'im',
|
||||
'text' => '请问周六能否预约?我希望先确认可预约时段。',
|
||||
'occurred_at' => time() - 60, 'speaker' => 'patient',
|
||||
'actor_admin_id' => 0, 'quality_eligible' => true],
|
||||
['id' => 'im:synthetic_service', 'channel' => 'im',
|
||||
'text' => '我是负责预约协助的医助。我会协助核对周六可预约时段,确认后再回复您;现在还不能承诺具体时间。',
|
||||
'occurred_at' => time() - 30, 'speaker' => 'service',
|
||||
'actor_admin_id' => 11, 'quality_eligible' => true],
|
||||
],
|
||||
];
|
||||
$knowledge = [[
|
||||
'id' => 7, 'version' => 1, 'status' => 'published',
|
||||
'question' => '如何确认预约时段?',
|
||||
'answer' => '医助需先核对系统中的可预约时段,确认后再回复;未核实前不承诺具体时间。',
|
||||
'category' => '预约', 'source_note' => '完全合成的协议验收知识,不代表真实院内规则',
|
||||
]];
|
||||
$analysis = AssistantServiceEngine::generate('analysis', 'initial', $context, [], '');
|
||||
$reply = AssistantServiceEngine::generate(
|
||||
'reply', 'initial', $context, $knowledge, '请就周六预约给出一条待人工确认的服务回复草稿。'
|
||||
);
|
||||
```
|
||||
|
||||
样例 ID 是合成标识,只在直接 Engine 验证中使用。应分别记录 ok/error_code、耗时、有无 message_id、返回结构与引文校验;不输出 key/base_url,不存原始上游响应。预期两次均 ok=true,analysis 六项完整、动作可采纳;不能强求模型给出某个具体质检状态。reply 知识引用为 7/version1,needs_confirmation=true。仅这一步通过可证明真实供应商兼容当前契约,不能声称 worker/主管流程通过。
|
||||
|
||||
若失败 RESULT_INVALID,先保留最小结构诊断并核对远端应用是否固定输出临床 Markdown 或不接受 blocking;不要直接对正式来源循环再请求。若 UPSTREAM_UNCERTAIN,记录后核对上游,不把网络超时当作未执行。
|
||||
|
||||
### B. 验证持久 worker 与主管页面,一条合成诊单范围
|
||||
|
||||
主任务选择已经授权的隔离/合成诊单与有效医助、主管关系;不得把探针写进真实患者资料。
|
||||
|
||||
1. 用目标医助身份建立可见服务来源;要覆盖员工归因,准备符合 patient_{patient_id} ↔ doctor_{assistant_id} 配对的本地合成 IM 记录,不能仅用主管手工笔记。真实 UI 操作即可测人工不足路径,但不能宣称员工归因路径已测。
|
||||
2. 主管选择该医助和 7 天范围,先确认 context 返回目标 source、subject_admin_id 和 coverage,再提交一条 analyzeStaff。提交后保持资料及知识不变。
|
||||
3. 记录任务 ID,观察 queued → running → ready;同一 ID 的 result 非空且 quality_checks 为六项。worker 日志 processed=1 只作辅助证据。
|
||||
4. 在页面复核一个质检项;采纳一个实际存在的 suggested_action,提醒时间晚于当前至少 30 秒;验证归属目标医助、待办可见及完成反馈。测试是否触发其他定时提醒由主任务控制,不发送患者消息。
|
||||
5. 如还需回复路径,在受控知识中发布样例条目并使用实际数据库 ID/version,然后生成回复,核验草稿及知识引用。A 步的 7/version1 不得直接冒充数据库真实知识。
|
||||
6. 记录真实任务最终状态、主管 UI 结果和跟进闭环证据。不要更改真实任务状态为 ready 来获得“通过”。测试完成后保留可追溯证据,清理范围由主任务按已有授权处理。
|
||||
|
||||
## 本次交付范围
|
||||
|
||||
唯一写入:`artifacts/medical-assistant-feature-plan/ai-runtime-review.md`。这是一份静态核对报告,不包含实际开关值、凭据、数据库目标、供应商运行结论或服务启停结果。
|
||||
|
||||
@@ -0,0 +1,50 @@
|
||||
# 自动分析调度后台实施报告
|
||||
|
||||
## 已完成
|
||||
|
||||
- 新增 `server/app/common/service/assistantservice/AssistantServiceAutomation.php`,提供 `status()` 与 `tick()`。
|
||||
- 新增 `assistant-service:auto --sleep=60`,支持 `--once`;命令注册于现有 console 配置。调度命令只创建原持久队列任务,不调用模型或同步远程 IM。
|
||||
- 原 `assistant-service:work` 命令仅增加实际轮询前后及异常/退出的安全心跳,未改 Worker/Engine 的认领、租约、生成、来源重验或结果提交逻辑。
|
||||
- 配置默认保持 `auto_enabled=false`、`auto_actor_id=0`、间隔 60 秒、安静期 300 秒、每批最多 10 条,固定 30 天来源窗口。
|
||||
|
||||
## 来源、权限及重复保护
|
||||
|
||||
每轮重新读取显式配置账号,要求账号现存启用、具备 view/analyze 权限,且为 root 或现有管理角色 3/7/8。不会自动查找或借用 root。目标员工使用已有员工域、有效医助角色;目标无需有模块菜单。候选查询和 Context/Logic 入队均沿现有患者域复查。
|
||||
|
||||
候选仅来自可靠 IM 账号配对、目标本人登记、本人跟踪备注;不从当前患者负责人猜测历史发言人。IM 归档原有 `diagnosis_id` 不作为唯一可靠映射,使用可靠患者账号与 `patient_id`:同患者有多条有效诊单时,仅选择当前操作者可见的最大诊单 ID。人工登记、跟踪备注保留自身诊单绑定;人工记录同时核对 `patient_id`。纯 IM 分析还按患者检查已有目标快照,防止新建诊单导致同一段聊天重复生成。
|
||||
|
||||
安静期检查 Context 全部实际来源的发生时间,也检查手工记录 `created_at`、跟踪备注 `create_time/update_time` 与存在时的 IM `create_time`,因此补录旧日期、追加旧日备注不会立即触发。来源没有文字、删除、越权、资料超限会跳过,后续候选仍继续扫描。
|
||||
|
||||
queued/running/needs_reconciliation 会阻止同一目标重复排队;纯 IM 跨诊单也保护同一患者。自动调用 `Logic::analyzeAutomatic()`,传完整 `diagnosis_id/assistant_id/days=30/scenario=followup`;Logic 中既有事务权限、来源快照、同人额度锁与自动模式不重置失败的保护继续生效。现有任务来源完全相同或当前仅为旧来源子集时,不因窗口滚动、知识变化或权限哈希变化反复生成。确定终态后有新增或修订来源才允许新快照;未知结果不自动恢复。
|
||||
|
||||
## 持久公平扫描与运行状态
|
||||
|
||||
- 统一使用项目级 `server/runtime/assistant_service_automation/`,CLI 与 adminapi 不依赖不同的应用 runtime 目录。
|
||||
- `scan.lock` 为真实 OS `flock`,每轮完整扫描期间持锁;多进程不会同时扫描。不是仅靠时间戳模拟互斥。
|
||||
- `scan.json` 保存三个来源渠道的 `(source_id, diagnosis_id)` 游标和下次轮换渠道。每轮候选读取总量有界,实际扫描最多 `max(30, batch * 10)` 条(默认 100),入队最多 10 条;三个渠道轮换,不会持续卡在第一批记录。
|
||||
- 游标走到末尾后下一轮重新开始,安静期/新权限/新来源仍会被重检。额度阻塞时保留尚未入队候选之前的游标,下一次允许时继续,不永久遗漏。
|
||||
- 对每个候选的活动/历史队列检查分别最多读取 101 条;历史过多而无法安全确认时保守跳过并公开定性“历史任务需人工核对”提示,不把未知历史当成可重发。
|
||||
- `workers.json` 在单独锁下记录最多 64 个实际消费者进程心跳。轮询已完成和正在处理分别使用有界 TTL,退出标记 stopped,异常标记 error。只有调度与消费者心跳均有效才显示 running;缺失/过期显示 waiting,配置/存储故障显示 error。
|
||||
- `status()` 不入队、不调用模型、不写文件;默认 disabled 会直接返回。返回严格为契约的 enabled/state/last_scan_at/next_scan_at/interval_seconds/quiet_seconds/days/reason,不公开账号、患者、来源原文或全域任务数量。超限/来源缺失/安静期等仅给定性原因;无新增来源明确表示继续等待。近期资料问题保留至重新核查或最多一小时,避免游标空页将未解决问题隐藏。
|
||||
|
||||
本方案明确面向单机部署,调度与消费进程应共用同一项目本地 runtime;不宣称具备多主机分布式锁能力。未新增数据库表。
|
||||
|
||||
## 验证
|
||||
|
||||
以下测试均用合成 SQLite `:memory:`、临时运行目录和现有真实 Access/Context/Logic/ORM;无应用 initialize、无 .env 读取、无业务库连接、无网络或真实模型调用:
|
||||
|
||||
```text
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceAutomationTest.php
|
||||
ASSISTANT_SERVICE_AUTOMATION assertions=53 PASS sqlite=memory real_access_context_enqueue=1 multiprocess_flock=1 network=0
|
||||
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceWorkerTest.php
|
||||
ASSISTANT_SERVICE_WORKER assertions=66 PASS sqlite=memory real_worker_orm=1 network=0
|
||||
```
|
||||
|
||||
自动调度测试覆盖:默认关闭、禁止隐式 root、管理角色与 analyze 撤回、停用账号、模型未就绪、空来源、扫描/消费者真实心跳、真实第二进程持有 flock、可靠账号配对、历史医助与无菜单目标、历史跟踪备注、跨诊单 IM 去重、失败不重排、未知结果阻止新快照、新来源续排、来源子集不生成、补录和追加安静期、撤权/恢复、删除诊单、40 个候选跨页公平、重启游标复用、日上限后续扫、超限后继续其他候选及持续提示、IM 表缺失时手工来源可用、公开状态脱敏和损坏状态文件。
|
||||
|
||||
相关 PHP 文件 `php -l` 通过;已检查新增 console 行无 diff 空白问题。
|
||||
|
||||
## 本轮未执行
|
||||
|
||||
未读写 `.env`,未连接业务数据库,未调用真实模型,未启动/停止本地服务。未修改 Controller、Validate、Logic、Staff、Access、Context、Engine、Worker service 或前端。绑定本地主管、启用自动配置、重启消费进程加载心跳及真实环境验收由主代理集成阶段执行。
|
||||
@@ -0,0 +1,31 @@
|
||||
# 团队待分析覆盖修复
|
||||
|
||||
已修复 `automatic-integration-review.md` 的 P2 #1。仅修改 Team 服务及相关合成测试;未修改 Automation、Logic、配置、命令或前端。未访问业务数据库、`.env`、真实模型,未启停服务,未派生代理。
|
||||
|
||||
## 原因及修复
|
||||
|
||||
原团队总览将同患者的 IM 展开为每一张诊单的待分析活动,而自动调度仅选择最新可见诊单,并按患者快照去重。已完成全部可调度工作后,旧诊单仍留在待分析差集中。
|
||||
|
||||
修复将活动覆盖和实际已分析诊单数量分离:
|
||||
|
||||
- IM 待分析活动以 **目标医助 + 患者** 为键;任一仍有效、当前有权可见的该患者分析可覆盖其当前 IM。首次多诊单和完成后新增同患者诊单不再制造重复待分析,也不增加模型任务。
|
||||
- 人工登记、跟踪备注以 **目标医助 + 原绑定诊单** 为键;其他诊单上的有效 IM 分析不能替代这些独立来源。登记仍校验 patient_id。
|
||||
- 实际 `analyzed_cases` 仍按有效目标诊单去重;未用患者覆盖数冒充已分析诊单数。
|
||||
- 真实新增/修改文字会使旧成功快照过期。对最新过期快照重新比较实际 Context 的完整来源对象;存在新内容时显示 pending,等待新分析,不将正常内容更新当作分析失败。仅权限/知识变化或来源移除造成的过期仍显示 attention;failed/needs_reconciliation 仍保留人工处理状态。
|
||||
- 只对最新过期快照追加来源比较,正常有效历史结果仍走原请求内缓存。所有 GET 操作保持只读。
|
||||
|
||||
## 文件
|
||||
|
||||
- `server/app/common/service/assistantservice/AssistantServiceTeam.php`
|
||||
- `server/tests/AssistantServiceTeamTest.php`:更新真实来源变化应 pending 的断言。
|
||||
- `server/tests/AssistantServiceTeamCoverageTest.php`:新增独立回归;使用真实 ORM、Access、Context、Logic,并反射调用 Automation 的只读候选及去重方法,不执行 tick。
|
||||
|
||||
## 验证
|
||||
|
||||
- TeamCoverage:24 断言通过,覆盖首次多诊单、完成后新诊单、真实新聊天、旧诊单独立 manual 和 tracking、来源快照绑定、患者错绑排除、权限变化仍需核对,以及全程不新增隐式任务。
|
||||
- Team:58 断言通过,包括原分页/全局汇总/双权限域/最新复核/缓存查询数量回归。
|
||||
- Automation:53 断言通过,SQLite 内存库及独立进程文件锁测试。
|
||||
- API:76 断言通过。
|
||||
- 本轮 3 个 PHP 文件语法检查通过。
|
||||
|
||||
另运行 Staff 回归时,主代理正在并行修改 P2 #2 的 Staff 测试和后端参数接口,测试在新增 jobs 参数用例报“不支持的字段”。已告知主代理,未擅自修改其并行文件;待 P2 #2 集成完成统一重跑 Staff。该失败不在本轮 Team 修改路径。
|
||||
@@ -0,0 +1,47 @@
|
||||
# 自动分析与团队总览后端交付
|
||||
|
||||
已完成本代理负责的后端接口、聚合、权限映射、自动入队入口与合成验证。未读取或修改 `.env`,未连接业务库、启动服务或调用真实模型。仓库 `.trellis/workflow.md` 与 `.trellis/spec/` 不存在,依据 `AGENTS.md`、`CLAUDE.md`、本轮契约及现有代码实现。
|
||||
|
||||
## 文件
|
||||
|
||||
- `server/app/common/service/assistantservice/AssistantServiceTeam.php`:新增团队聚合。
|
||||
- `server/app/adminapi/logic/tcm/AssistantServiceLogic.php`:新增 `teamOverview`、`analyzeAutomatic`、`automationReady`,在请求内缓存真实来源重建,保留旧人工接口行为。
|
||||
- `server/app/adminapi/controller/tcm/AssistantServiceController.php`:新增只读 GET;所有已知 HTTP 动作显式重新校验实际操作者权限。
|
||||
- `server/app/adminapi/validate/tcm/AssistantServiceValidate.php`:新增严格 keyword/filter/page 参数校验。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceAccess.php`:新增明确动作→权限映射;自动入队未注册为 HTTP 动作。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceStaff.php`:抽取共用质检归因/复核/去重方法,避免个人明细与团队统计分叉。
|
||||
- `server/tests/AssistantServiceTeamTest.php`:新增真实 ORM/Access/Context/Logic 的 SQLite 内存测试。
|
||||
|
||||
## 统计与权限口径
|
||||
|
||||
- `summary` 是 keyword 匹配的全部授权医助;`filter` 只过滤列表,分页不改变 summary,空后页仍返回准确总数。
|
||||
- 员工域由现存有效医助身份和当前操作者员工范围交集决定;患者来源、队列、跟进均再取操作者患者域交集。不会把当前负责人当历史发言人,也不会让“患者可见”扩散为其他员工任务可见。
|
||||
- 当前负责统计诊单存量。近 30 天可靠 IM 本人发言按患者账号配对统计,同患者多诊单不重复计沟通量;人工登记必须匹配诊单当前 patient_id。目标本人跟踪备注可表示待分析来源,不算本人历史发言。
|
||||
- IM 表/身份字段未接入返回 `im_messages=null`;结构完备但无可靠文字才返回 0。无来源、待分析、排队、处理中、已分析、需核对分别返回。
|
||||
- 质检沿用真实来源哈希、原操作者授权/知识版本、当前可见来源与目标员工校验;每目标+诊单+项目取最新有效分析,复核取最新决定。不足证据会阻止旧分析再归责;过期结果不计已分析与待复核。
|
||||
- `analyzed_cases` 团队总计是各医助有效分析诊单数之和(目标医助+诊单);最新分析时间来自有效完成时间。
|
||||
- queued/running 统计仍有效的实际对应任务;needs_reconciliation 要求人工关注;同目标+诊单只有最新 failed/stale 计为异常,旧错误不会永久占用关注数。
|
||||
- `issues` 筛待复核项;`overdue` 筛逾期跟进;`attention` 筛待复核、分析异常或未完成跟进。
|
||||
- 列表优先逾期、待复核、分析异常、待执行,再按近期沟通时间,最终 staff.id 同分排序。这是处理顺序,不是员工绩效评分。
|
||||
- GET 不入队、不生成、不改业务状态;自动状态依赖另一代理实现的 `AssistantServiceAutomation::status()`。
|
||||
|
||||
## 聚合与新鲜度
|
||||
|
||||
团队一次取得可见诊单,来源按 200 个患者/诊单分块聚合,跟进一次 group 聚合,任务按 100 条游标扫描,复核按任务批量读。没有逐医助重复全量诊单查询。来源仍通过原 `Context::build` 校验;同请求内以操作者/目标/诊单/天数为键缓存,跨请求不复用权限与来源结果。SQL 监听合成用例验证同一快照 8 条历史任务仅读取 3 次来源表正文。
|
||||
|
||||
## 自动入队
|
||||
|
||||
`analyzeAutomatic` 使用现有参数校验,要求明确医助及 30 天范围;必须经过实际操作者 analyze 权限、有效员工、患者域和来源校验。在操作者和诊单事务锁内重新阻挡同目标+诊单+当前患者绑定的 queued/running/needs_reconciliation,涵盖另一操作者创建的活跃任务。已存在 dedupe 任务直接返回,自动调用绝不恢复失败任务;新 payload 增加 `trigger=automatic`。人工调用既有的明确未生成失败恢复规则不变。
|
||||
|
||||
## 验证
|
||||
|
||||
以下均未初始化业务应用、未读取 `.env`、未访问网络:
|
||||
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamTest.php`:58 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php`:76 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php`:84 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceWorkerTest.php`:66 断言通过。
|
||||
- `php tests/AssistantServiceEngineTest.php`:71 断言通过。
|
||||
- 全部本代理修改/新增 PHP 文件 `php -l` 通过。
|
||||
|
||||
未在本代理范围运行 MySQL 或浏览器;由主代理集成后完成部署及真实只读验收。没有修改 Engine、Worker、配置、命令、Automation 或前端文件。
|
||||
@@ -0,0 +1,37 @@
|
||||
# 主管团队总览与自动结果前端实施
|
||||
|
||||
## 已完成
|
||||
|
||||
- `admin/src/api/assistantService.ts` 增加团队总览、自动运行状态、医助处理状态类型和只读 `assistantTeamOverview`,保留旧明细接口兼容;继续传 AbortSignal,禁止请求层自动重试。
|
||||
- `workbench/index.vue` 改为近 30 天团队总览:紧凑横向指标、团队表、姓名搜索、全部/需关注/待复核/有逾期筛选。直接使用服务端团队汇总,未把当前页行数当团队总数;不再选人、选诊单或提交批量分析。
|
||||
- 自动分析状态、最近/下次检查时间、等待/分析中数量来自接口。区分未开启、等待、运行和需处理,以及无来源、等待分析、分析中、已分析、需核对。没有结果不显示达标结论;沟通来源不可用显示“未接入”。
|
||||
- 新增 `components/StaffDetail.vue`:点击医助打开右侧详情,默认待核查问题;跟进和关联记录在同一抽屉中查看。原文核查继续使用现有 CaseDetail / JobResult;返回医助详情、关闭抽屉都保留总览筛选和页码。
|
||||
- 窗口宽度 ≤ 1100px 使用 5 个核心表列(医助、待复核、跟进/逾期、状态、操作),已分析数量并入姓名下方。指标变为 3 列两行;抽屉全宽,Element Plus 抽屉保留固定头部关闭按钮与 Escape 支持。大屏保留沟通量、最近分析等完整列。
|
||||
- 每 30 秒只读静默刷新团队和已打开详情。隐藏或停用页面时暂停定时刷新、取消总览请求;卸载清理请求、监听器和计时器。保留未提交搜索词、页码、详情、回复草稿、执行备注和复核输入。
|
||||
- CaseDetail 增加兼容性可选 `automatic` 属性;新总览传入 true,隐藏“生成服务分析”及其场景选择,并在操作函数层阻止提交分析。回复草稿、复核和跟进仍需人工明确操作,旧独立明细保留手动分析能力。
|
||||
- 当前正在核查的分析不会被新结果直接替换;发现新分析后显示“查看最新结果”,保持当前输入。现有结果仍刷新有效性。显式查看最新结果可跳出原问题关联的旧结果。
|
||||
- 继续保留目标医助/诊单校验、权限判断、旧响应隔离、来源过期保护、证据定位、双重提交保护、版本冲突处理及请求取消。刷新失败清理旧敏感列表或结果,避免权限失效后继续展示。
|
||||
|
||||
## 改动范围
|
||||
|
||||
- `admin/src/api/assistantService.ts`
|
||||
- `admin/src/views/assistant_service/workbench/index.vue`
|
||||
- `admin/src/views/assistant_service/components/StaffDetail.vue`(新增)
|
||||
- `admin/src/views/assistant_service/components/CaseDetail.vue`
|
||||
- `admin/src/views/assistant_service/components/ServiceActions.vue`
|
||||
- `admin/src/views/assistant_service/components/JobResult.vue`
|
||||
- `admin/tests/assistant-service.test.cjs`
|
||||
|
||||
遵循现有 Vue 3 / Element Plus / Tailwind 3 栈和项目主题色,没有增加字体、图片、图表或其他依赖。`.trellis/workflow.md` 与 `.trellis/spec/` 在本工作区不存在,已读取 AGENTS.md、CLAUDE.md、redesign-existing-projects 技能和本轮接口契约。
|
||||
|
||||
## 验证
|
||||
|
||||
- `node --test tests/assistant-service.test.cjs`:**26/26 通过**(工作目录 admin)。包括所有模块 SFC 脚本、模板、样式编译;原有权限、目标隔离、证据/过期、版本冲突测试;新团队只读行为、搜索竞态、隐藏暂停、抽屉导航、分页及表单保留、自动模式不生成分析、最新结果切换。
|
||||
- `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit --pretty false`:全项目检查退出 1,错误全部位于本次范围外(现有 chat-dialog/editor、处方/订单、doctor、diagnosis、权限表单等);本次 assistantService / assistant_service 文件无类型错误。
|
||||
- 已对修改文件运行本地 Prettier。
|
||||
- 未运行带 release 的构建、未启停服务、未读取修改 .env、未连接业务库或调用真实模型。全局构建与真实浏览器视觉验收交由主代理。
|
||||
|
||||
## 集成提示
|
||||
|
||||
- 前端仅展示后端真实运行状态,不通过页面读取触发自动入队。自动扫描是否开启与运行应由本轮后台服务决定。
|
||||
- 建议主代理在 804px 视口核对核心表列和全宽抽屉,再在大屏核对完整指标及最近分析列;真实接口验证团队汇总与列表过滤口径。
|
||||
@@ -0,0 +1,75 @@
|
||||
# 自动分析与主管总览独立复核
|
||||
|
||||
复核日期:2026-11-09。只读业务代码;只写本报告。未读 `.env`、未连接业务库、未调用模型、未启停服务。复现全部使用现有测试的 SQLite `:memory:` 及 Vue 脚本夹具。
|
||||
|
||||
## 结论
|
||||
|
||||
发现 2 个可稳定复现的 P2 集成问题:一个让已完成全部可调度分析的医助持续显示“等待自动分析”,一个使回复任务掩盖更新后的自动分析。未发现本轮代码新增的权限绕过、自动重排失败任务、模型调用由 GET/前端刷新触发、多进程扫描互斥失效问题。建议修复下列两项后完成验收。
|
||||
|
||||
## 1. P2:IM 待分析统计与自动调度的诊单归属不一致
|
||||
|
||||
位置:`server/app/common/service/assistantservice/AssistantServiceTeam.php:97`,以及 `:52` 的待分析差集计算。对应调度决策在 `AssistantServiceAutomation.php:196`。
|
||||
|
||||
同一患者有多个可见有效诊单且只有一份 IM 对话时,调度器明确只选择该患者当前最大诊单 ID,并以患者级历史快照防止重复生成。但总览将同一份 IM 活动展开到患者的**所有**诊单,再逐诊单减去已分析集合。较早诊单永远未进入自动队列,因此即使唯一应分析任务已成功完成,医助仍永久显示 `analysis_state=pending`(“等待自动分析”)。这不是模型慢或队列未消费,继续扫描不会消除该状态。
|
||||
|
||||
已执行的真实 ORM/Logic 合成复现:
|
||||
|
||||
1. 复用 `AssistantServiceTeamTest.php` 的纯内存建表与身份夹具,停止在测试断言前。
|
||||
2. 清除夹具跟踪备注与 IM,保留诊单 101/patient 201,添加诊单 104/patient 201,均在主管 13 可见范围。
|
||||
3. 添加唯一可靠文本 `doctor_11 -> patient_201`,发生时间为当前时间减 1000 秒,无人工记录或跟踪备注。
|
||||
4. 调用实际 Automation 私有候选查询(反射,只读),返回 `[104]`。
|
||||
5. 通过 `Logic::analyzeAutomatic` 创建诊单 104、医助 11 的任务,以纯合成空质检结果标为 ready。
|
||||
6. 调用实际 `Logic::teamOverview` 和 Automation `analysisDecision`。
|
||||
|
||||
观测:
|
||||
|
||||
```json
|
||||
{
|
||||
"candidate_diagnoses": [104],
|
||||
"next_scan_decision": "existing",
|
||||
"im_messages": 1,
|
||||
"analyzed_cases": 1,
|
||||
"analysis_state": "pending",
|
||||
"queued_jobs": 0,
|
||||
"running_jobs": 0,
|
||||
"attention_jobs": 0
|
||||
}
|
||||
```
|
||||
|
||||
建议将“待自动分析”的 IM 覆盖口径与调度器的患者/诊单选择及患者级去重保持一致;不要靠为旧诊单再生成相同聊天来消除统计差集。回归应同时覆盖:首次存在多个诊单、分析完成后又新增同患者诊单、旧诊单确实存在独立人工/跟踪来源。
|
||||
|
||||
## 2. P2:较新的回复任务会隐藏新自动分析提示
|
||||
|
||||
位置:`admin/src/views/assistant_service/components/CaseDetail.vue:589` 至 `:596`。
|
||||
|
||||
`assistantContext.latest_job` 是目标诊单最新的任意类型任务(后端 `context()` 没有限定 analysis)。自动刷新仅当 `latest_job.type === 'analysis'` 才检查新分析。若用户正在核查 analysis #30,后台生成 analysis #31,之后用户明确生成了 reply #32,则下一次刷新拿到 latest_job=#32;尽管历史列表已包含 #31,页面仍不显示“查看最新结果”,继续停留旧分析。这破坏了本轮保留当前表单、以提示让用户切换新结果的路径。
|
||||
|
||||
已使用现有 Vue `setup` 夹具运行实际 CaseDetail 脚本,初始锁定 #30,然后令 context 返回 reply #32、history 返回 reply #32 和 analysis #31,再触发 `refreshKey`。
|
||||
|
||||
观测:
|
||||
|
||||
```json
|
||||
{
|
||||
"currentAnalysis": 30,
|
||||
"newAnalysisAvailable": false,
|
||||
"history": [
|
||||
{"id": 32, "type": "reply"},
|
||||
{"id": 31, "type": "analysis"}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
建议按任务类型确定最新分析,并保持当前核查/输入不被自动替换;不要用当前历史分页中是否包含 analysis 来推断“没有新分析”。增加“旧分析已打开,新分析后又创建回复任务”的回归用例。
|
||||
|
||||
## 已通过验证
|
||||
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceAutomationTest.php`:53 断言通过,真实 Access/Context/Logic/ORM,独立进程 `flock` 验证通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamTest.php`:58 断言通过。
|
||||
- `node --test tests/assistant-service.test.cjs`:26/26 通过。
|
||||
- 另加上述两个不落地代码的 stdin 合成复现,均复现所述输出;没有把测试数据写入业务库。
|
||||
|
||||
代码及既有测试已覆盖:三个来源渠道持久游标及轮换、有界扫描、日额度后候选保留、安静期补录/追加时间、删除和越权候选跳过、来源子集不重发、失败不自动重排、未知结果阻止自动续排、实际账号/员工/患者权限复查、只读总览、keyword 全域汇总及列表筛选分页分离。正常成功的静默刷新保留抽屉、搜索词、页码、回复和复核输入,生成仍需明确操作,自动分析模式在函数层阻止前端发起分析。
|
||||
|
||||
## 验证边界
|
||||
|
||||
MySQL 并发、真实来源数量、服务进程运行状态与浏览器布局由主代理独立验证,本报告不将内存测试等同为这些验证完成。未派生任何代理。
|
||||
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 38 KiB |
@@ -0,0 +1,43 @@
|
||||
# 新分析提示被回复任务遮蔽:修复与回归
|
||||
|
||||
日期:2026-11-09。对应 `automatic-integration-review.md` 的 P2 #2。
|
||||
|
||||
## 修复结果
|
||||
|
||||
`context` 新增 `latest_analysis_job: Job | null`,按当前诊单、患者绑定、目标医助及时间范围查找最新分析,不受后续回复任务或历史分页影响。原 `latest_job` 继续返回最新任意类型任务;两个字段均复用现有权限复查、来源有效性与任务格式化逻辑。无新表、无 GET 入队行为。
|
||||
|
||||
详情首次进入时直接使用 `latest_analysis_job`;明确指定旧质检任务时仍打开该任务。历史第一页即使全是回复,也不会遗漏最新分析;历史分页里的旧分析也不能覆盖接口返回的新分析。
|
||||
|
||||
静默刷新保留当前分析任务 ID、回复问题、页码、当前标签与原文抽屉,仅根据独立最新分析 ID 计算更新提示。用户点击“查看最新结果”后才切换已有分析。查看较旧历史分析时也能显示更新提示。新增字段在首次加载和静默刷新中都校验医助、诊单及 analysis 类型,错误响应沿用原有隐藏结果的保护。
|
||||
|
||||
## 修改范围
|
||||
|
||||
- `server/app/adminapi/logic/tcm/AssistantServiceLogic.php`:仅修改 `context()`。
|
||||
- `admin/src/api/assistantService.ts`:补充 `Context.latest_analysis_job` 类型。
|
||||
- `admin/src/views/assistant_service/components/CaseDetail.vue`:独立最新分析、提示计算、加载与目标校验。
|
||||
- `server/tests/AssistantServiceStaffTest.php`:真实 ORM / Context / Logic 的纯内存回归。
|
||||
- `admin/tests/assistant-service.test.cjs`:运行实际 Vue setup 的回归,及相同任务刷新保留复核输入的断言。
|
||||
|
||||
## 验证
|
||||
|
||||
通过:
|
||||
|
||||
- `cd admin; node --test tests/assistant-service.test.cjs`:29/29。
|
||||
- `cd server; php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php`:90 断言。
|
||||
- `cd server; php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php`:76 断言。
|
||||
- `cd server; php -l app/adminapi/logic/tcm/AssistantServiceLogic.php`:语法通过。
|
||||
- `cd admin; node node_modules/prettier/bin/prettier.cjs --check src/api/assistantService.ts src/views/assistant_service/components/CaseDetail.vue tests/assistant-service.test.cjs`:通过。
|
||||
|
||||
新增场景包括:
|
||||
|
||||
1. 当前分析 #30,后台新分析 #31,用户生成回复 #32;历史当前页仅有 #29。刷新仍保留 #30 和输入,提示可查看最新;点击后切至 #31,即使第一页只有 #32。
|
||||
2. 首次打开时历史第一页 10 条全为回复,仍显示独立最新分析;加载含旧分析的历史页不覆盖它。
|
||||
3. 后端连续 12 条较新回复占满历史第一页;同时存在别的医助、7 天范围、其他诊单、不同患者绑定的新任务,仍返回正确目标的最新分析。
|
||||
4. 新字段的跨医助、跨诊单和错误任务类型响应被拒绝;同一任务刷新保留复核说明、决定和回复编辑内容。
|
||||
5. `context` 读取前后任务数量一致。
|
||||
|
||||
全仓类型检查 `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit --composite false --incremental false` 已执行,未通过;诊断位于本次未改动的聊天、编辑器、处方、统计、诊单等文件,例如 `src/components/chat-dialog/ChatMessageItem.vue`、`src/utils/call-local-recorder.ts` 和 `src/views/consumer/prescription/order_list_h5.vue`。没有 `assistant_service` 或 `assistantService.ts` 诊断。首次仅关闭 incremental 的尝试被 composite 配置拒绝,随后同时关闭 composite 完成上述检查;未写入构建缓存。
|
||||
|
||||
## 边界
|
||||
|
||||
已阅读项目 `AGENTS.md`、`CLAUDE.md`、独立复核与接口契约;当前 checkout 无 `.trellis/`。未派生代理,未读 `.env`、未连接业务数据库、未调用模型、未启停服务;测试仅使用 SQLite `:memory:` 与本地合成 Vue 夹具。未改 Team / Automation,未运行带发布步骤的构建。浏览器及部署验收由主代理执行。
|
||||
@@ -0,0 +1,66 @@
|
||||
# 自动分析与主管总览:本轮接口契约
|
||||
|
||||
用户要求:界面不友好、切换繁琐,分析应由系统自动调用模型完成。保留主管人工复核和跟进决定,不自动发送消息或替主管认定员工过失。
|
||||
|
||||
## 主体验
|
||||
|
||||
- 工作台默认团队总览,直接看到可管理医助的沟通量、已分析记录、待核查问题、跟进/逾期、最近分析与处理状态。
|
||||
- 列表搜索医助、筛选待关注;点击行右侧滑出该医助详情,不离开总览。关联记录明细和原文在侧边继续核查,关闭恢复总览位置。
|
||||
- 去掉主页逐人选择、诊单勾选和“分析所选记录”,不要求主管触发生成。自动扫描近 30 天有效来源,沟通安静 5 分钟后入队,每 60 秒检查;每轮最多 10 条、每日上限继续使用已有配置。
|
||||
- 首次扫描覆盖已有近 30 天来源。无来源/未接入/等待分析/分析中/已分析/需核对要分清;不得用空白或 0 暗示服务已达标。
|
||||
- 主管默认只处理待复核问题、跟进和逾期。详情保留旧操作能力;人工“生成分析”仅兼容旧明细,主体验不出现。结果定时静默刷新,保留当前筛选、抽屉、页码和输入,页面隐藏时暂停。
|
||||
|
||||
## 后端团队接口(dashboard agent 所有)
|
||||
|
||||
新增 GET `teamOverview` 参数:keyword 字符串(默认空),filter = all/issues/overdue/attention(默认 all),page_no 默认 1,page_size 默认 20 上限 50。沿用 view 权限,返回只读数据,不在 GET 中入队或调用模型。
|
||||
|
||||
返回:
|
||||
|
||||
```
|
||||
{
|
||||
days: 30,
|
||||
summary: { staff_count, active_staff, analyzed_cases, unreviewed_issues,
|
||||
pending_actions, overdue_actions, queued_jobs, running_jobs, attention_jobs },
|
||||
automation: { enabled, state: disabled|running|waiting|error,
|
||||
last_scan_at, next_scan_at, interval_seconds, quiet_seconds, days:30, reason },
|
||||
lists: [{staff:{id,name,is_self}, metrics:{assigned_cases,im_messages:number|null,manual_records,
|
||||
analyzed_cases,pending_actions,overdue_actions,completed_actions},
|
||||
unreviewed_issues:number, last_analyzed_at:number,
|
||||
analysis_state: no_sources|pending|queued|running|ready|attention,
|
||||
queued_jobs:number,running_jobs:number,attention_jobs:number}],
|
||||
count,page_no,page_size
|
||||
}
|
||||
```
|
||||
|
||||
summary 为当前 keyword 搜索范围的全部授权医助,filter 只过滤列表,不得把当前页总数伪装团队总数。所有记录仍经操作者患者域交集;有效质检沿用来源过期/最新复核/去重规则。优先聚合查询,避免每个员工重复拉全量诊单和每条来源。自动状态仅公开运行时间和原因,不泄露其他团队任务或 actor 身份。
|
||||
|
||||
新增 `AssistantServiceLogic::analyzeAutomatic(array $p, int $adminId): array`,复用私有 enqueue,沿用权限、同人事务锁、来源快照和去重。给 enqueue 增加末尾 bool automatic=false:自动请求遇到任意已存在任务不重置失败状态;新 job payload 加 trigger=automatic。手动调用保持原逻辑。可公开轻量 `automationReady()` 返回 bool(schema + enabled + modelReady)供调度器使用,无鉴权旁路。
|
||||
|
||||
接口/权限 action mapping/Validate 由 dashboard agent 修改;不要修改 Engine 或已有 Worker 的来源校验。
|
||||
|
||||
## 自动调度(automation agent 所有)
|
||||
|
||||
新增 `AssistantServiceAutomation`,公开 `status(): array` 返回上面 automation 结构;`tick(): array` 扫描入队;命令 `assistant-service:auto --sleep=60`(支持 --once)。独立进程,不依赖主管打开网页,HTTP 不自动产生外部调用。
|
||||
|
||||
配置放在现有 assistant_service:auto_enabled 默认 false、auto_actor_id 默认 0、auto_interval_seconds 默认 60、auto_quiet_seconds 默认 300、auto_batch_size 默认 10,默认窗口固定 30。主代理部署时按用户授权开启并绑定当前本地主管账号,禁止程序自动挑选 root 或伪造用户。
|
||||
|
||||
- 每轮验证配置 actor 现存、启用、analyze 权限、管理角色(root 或现有 3/7/8),以其实际 staff/patient 权限扫描;目标不需有模块菜单。scope 变化即时生效。
|
||||
- 从可靠 IM、目标登记/跟踪备注发现候选,验证 Context;不要把患者当前归属当历史发言人,不触发远程 IM 同步,不扫无来源诊单来制造任务。
|
||||
- 用持久 cursor 做公平有界扫描,不能每轮卡在第一批旧记录。单轮扫描/入队均有界;多进程互斥,持久去重沿用队列表,禁止每次刷新或时间窗口滚动无新来源反复生成。
|
||||
- queued/running/needs_reconciliation 同一目标+诊单存在时不重复入队。失败已生成/未知结果不自动重试;新内容可在前一确定终态后产生新快照。自动模式不能复用人工恢复失败重排逻辑。
|
||||
- 对资料超限、无来源、删除或越权候选跳过并继续后续;达到日上限时明确状态,未入队候选不能永久遗漏。
|
||||
- heartbeat/cursor 可用项目 runtime 文件/缓存,无需新表;必须基于真实扫描和 worker 活跃时间,过期显示 waiting/error,不用仅配置开关谎报运行。单机部署注明,多进程锁须实际有效。
|
||||
- Worker 的现有消费者命令可仅补安全心跳;不更改 worker 生成语义。automation agent 所有文件:新 service/new command、AssistantServiceWork.php、server/config/assistant_service.php、server/config/console.php、其新增测试。
|
||||
- 先保留 disabled 配置默认值,子代理禁止读写 .env、连接业务库、调用真实模型、启动服务。
|
||||
|
||||
## 前端(frontend agent 所有)
|
||||
|
||||
使用上述 teamOverview,沿用真实组件 CaseDetail/JobResult/ServiceActions,保留全部权限、目标验证、AbortController 与旧响应隔离。默认只读取自动结果,不调用 analyzeStaff。详情可单独请求已有 staffOverview/Cases/Issues,列表显式“核查记录”进入 CaseDetail;抽屉有清晰返回按钮和关闭/键盘支持。
|
||||
|
||||
使用项目 redesign-existing-projects 技能,保持中文后台产品语境:紧凑横向指标条、团队表格为主、右侧工作详情、单色强调、清楚的自动状态,不新增图片/图表库或营销装饰。保留加载/空态/错误、响应式、表格数字对齐和可访问焦点。生产页面不放开发术语和合成数据。
|
||||
|
||||
前端 agent 所有 admin/src/api/assistantService.ts、admin/src/views/assistant_service/**、admin/tests/assistant-service.test.cjs。更新行为测试,保留旧安全链路覆盖。勿运行带 release 的 npm run build;全局构建与浏览器由主代理执行。
|
||||
|
||||
## 交付
|
||||
|
||||
各 agent 各自写本目录报告 automatic-{backend,frontend,dashboard}-implementation.md,并报告测试。主代理等待全部终态后集成、独立复核、部署本地、真实来源数量只读核对和浏览器验收。不替用户完成真实质检决定或自动创建跟进。
|
||||
|
After Width: | Height: | Size: 65 KiB |
@@ -0,0 +1,22 @@
|
||||
# 主管工作台交互审查与调整
|
||||
|
||||
依据用户反馈:界面不友好、切换繁琐,分析应由系统自动执行。应用项目 `redesign-existing-projects` 技能,保持 Vue 3、Element Plus 与现有权限组件。
|
||||
|
||||
原页面的问题:
|
||||
|
||||
- 必须先选一名医助,切换后重新加载多组列表;主管无法直接掌握团队哪些人需要处理。
|
||||
- 大面积七项指标及六行质检表占据首屏,真正需要处理的事项在下方多层标签里。
|
||||
- 主管还要勾选诊单、选择场景和提交分析,重复承担系统可以完成的资料发现与排队工作。
|
||||
- 打开关联诊单后离开总览,返回时容易丢失上下文;自动刷新若重建组件会干扰复核表单。
|
||||
- 小宽度下多列指标和控制项堆叠,需要频繁滚动;空结果与没有分析不够容易区分。
|
||||
|
||||
改造方向:
|
||||
|
||||
- 紧凑横向指标和团队表格置于主页,待复核、逾期、分析异常优先;不产生员工绩效分或排名。
|
||||
- 系统按近期实际来源独立扫描、安静窗口、去重与排队,主管只查看结果、核查证据和安排跟进。
|
||||
- 医助详情改为侧边面板,关联记录在同一面板中展开;返回保留筛选、分页与位置。
|
||||
- 页面静默刷新结果,保留当前输入;隐藏或卸载时停止定时器并拒绝迟到响应。
|
||||
- 804px 左右宽度保留核心列、合并次要指标,侧边详情全宽;更宽屏幕保持并行的表格与详情。
|
||||
- 自动状态依据扫描和消费者心跳,分别展示暂无来源、等待、排队、处理中、完成和需核对;不把缺资料解释为达标。
|
||||
|
||||
视觉处理以可读性为主:中文系统字体、统一中性色与现有主题强调色、数字等宽、明确的键盘焦点、短状态文案;不引入营销图、装饰动画或新字体依赖。
|
||||
@@ -0,0 +1,56 @@
|
||||
# 主管团队总览与自动分析验收
|
||||
|
||||
2026-11-09。本轮用户要求:减少切换,系统自动使用模型分析,主管直接查看和管理医助。
|
||||
|
||||
## 当前交互
|
||||
|
||||
- 主页为最近 30 天团队总览,显示授权医助、来源活跃度、已分析、待复核和跟进/逾期。
|
||||
- 搜索和问题筛选作用于列表;团队指标保持当前搜索范围的全部授权医助口径,不被单页或问题过滤缩小。
|
||||
- 点击医助打开侧边详情,默认待核查问题;原文证据和跟进在该上下文内查看,关闭恢复主表。
|
||||
- 主页去掉逐人选择、诊单勾选与发起分析;每 30 秒只读刷新,保留当前筛选、分页、抽屉和输入。
|
||||
- 独立扫描进程自动发现最近 30 天来源,默认 60 秒检查、5 分钟安静期、每批 10 条、每日 100 条。
|
||||
- 配置账号明确绑定本地主管 id=1;权限实时核验。自动任务不发送消息、不作人工复核决定、不自动采纳跟进。
|
||||
|
||||
## 浏览器验收
|
||||
|
||||
真实 Vue 组件 + 明确标识的合成内存数据,未将合成记录写入业务库:
|
||||
|
||||
1. 团队列表先显示分析中,后自动更新为已分析;不需要点击生成。
|
||||
2. 筛选有逾期只保留符合的医助,团队汇总不缩减为单行。
|
||||
3. 点击医助 → 待核查问题 → 核查记录 → 自动分析结果 → 定位原文 → 返回医助详情,均在同一工作台。
|
||||
4. 切换到跟进执行可以查看跨患者待办,未替用户提交真实处理决定。
|
||||
5. 804px 窄屏核心列和全宽详情无页面横向溢出;恢复默认宽度后完整列正常。
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
## 独立复核
|
||||
|
||||
原复核记录见 [automatic-integration-review.md](automatic-integration-review.md)。发现的两个集成问题均已修正,分别补跨诊单来源覆盖、新回复遮住分析提示的回归;见 [覆盖修复](automatic-dashboard-fix.md) 和 [刷新修复](automatic-refresh-fix.md)。集成后再次运行 Staff 90、TeamCoverage 24 断言均通过。
|
||||
|
||||
本功能无新增迁移,沿用五张模块表。自动扫描的文件锁、游标和心跳适用于单机共享 runtime;外部多机部署需另行设计共享调度存储。
|
||||
|
||||
|
||||
## 自动化验证
|
||||
|
||||
- Engine 71、Worker 66、API 76、Staff 90、Team 58、TeamCoverage 24、Automation 53 断言通过;合成数据,未依赖业务库或真实模型。
|
||||
- 前端真实 Vue setup 行为测试 29/29,通过刷新保留输入、迟到请求隔离、独立最新分析、筛选分页与自动模式不发起模型分析等检查。
|
||||
- 隔离 MySQL 5.7 的 API → Worker、并发和租约链路 46 断言通过。测试目录及端口经核对,验收后已关闭独立 15339 实例,未停止本地业务 MySQL。
|
||||
- 类型检查仍失败,错误位于现有聊天、编辑器、处方等模块;本模块无诊断。不宣称全项目类型检查通过。
|
||||
|
||||
## 真实本地运行
|
||||
|
||||
2026-11-09 18:00 起按用户授权启用自动配置,绑定当前本地主管账号 id=1。没有新增账号或扩大角色权限。
|
||||
|
||||
- PHP 47392、Vite 27248 保持运行;空闲旧 worker 已验证身份后替换为 41616,新扫描进程 40524。进程均为隐藏窗口,具体值以 `.spool/assistant-local-processes.json` 为准。
|
||||
- 本地已登录后台通过真实 API 显示“自动分析已运行”,64 位可见医助、5 位存在近 30 天有效来源;页面无需点击生成。
|
||||
- 18:02:28 只读检查:15 条真实自动任务,12 条 ready、3 条 failed(RESULT_INVALID),无 queued/running;有效结果 12,需核对 3。待复核问题为 0 不代表所有服务达标,证据不足仍按原规则保留。
|
||||
- 3 条失败表示模型响应未通过结构、证据或服务边界校验。无效响应未留存,现有数据不足以进一步区分具体校验项;未伪造结果、未放宽校验、未自动重复提交。
|
||||
- 本地团队 GET 读取约 0.5 秒、峰值 16 MB;读取前后任务数量保持 15,未隐式调用模型。
|
||||
- 没有代用户完成真实人工复核、采纳跟进或发送消息。当前已发布服务知识为 0,回复草稿仍需先发布真实审核 FAQ,自动分析不依赖 FAQ。
|
||||
|
||||
浏览器合成预览与隔离 MySQL 已关闭,真实 PHP/Vite/worker/扫描进程持续保留。上述计数为验收时点,后续新来源将继续自动处理。
|
||||
|
||||
|
||||
最终收尾:直接 Vite 完整构建成功(3m 50s,无发布步骤);构建自动生成的声明与缓存已恢复原始状态。连续多个扫描周期(包含回到游标起点扫描 15 条)的新增任务均为 0,任务总数仍为 15,证实未对相同来源重复调用。四个正式本地进程均确认存活。`git diff --check` 通过。
|
||||
@@ -0,0 +1,65 @@
|
||||
# 医助服务后端 API 实施记录
|
||||
|
||||
> 最终集成补充:AI 开关已仅限制生成,人工记录、有效结果的人工复核/采纳和待办执行仍按原权限开放。主代理补充回归后 API 为 76 项通过,MySQL 完整链路仍为 34 项通过;见 [validation.md](validation.md)。下文记录本代理原始交付。
|
||||
|
||||
## 已实现
|
||||
|
||||
- `server/app/adminapi/controller/tcm/AssistantServiceController.php`:15 个独立 action,GET/POST 限制、参数白名单、统一成功 envelope,异常不泄露 SQL、来源正文或上游配置。
|
||||
- `server/app/adminapi/validate/tcm/AssistantServiceValidate.php`:严格 JSON 类型、ID/版本/枚举/时间范围/分页/文字长度、人工转写显式确认、完成与取消原因必填。
|
||||
- `server/app/adminapi/logic/tcm/AssistantServiceLogic.php`:范围内患者搜索、上下文、人工服务记录、异步分析/回复任务、任务列表和读取、质检历史、跟进采纳/执行、知识维护/发布。分析只入持久队列,不在 HTTP 请求中调用模型。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceAccess.php`:每次操作重读有效账号、当前角色及菜单权限;当前 DB root,拒绝依赖 token 中的 root。患者范围复用 MyPatient;一线员工 IM 固定本人,主管 IM 再用 DataScope。旧 RR 快照中的角色、角色范围或部门关系与锁定当前读不一致时拒绝并要求刷新。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceContext.php`:人工服务记录、当前诊单跟踪备注、可靠 patient_/doctor_ 对的已归档 IM 纯文字;不发起同步,不读取完整临床病历。记录源 ID、时间、说话人、员工归因和覆盖状态。电话号码等用现有脱敏函数处理,hash 不含当前秒。超出行数或字数限制明确拒绝,不截断。
|
||||
- `server/tests/AssistantServiceApiTest.php`:真实 ThinkPHP ORM、MyPatient、DataScope、Access、Context、Validate 和 Logic;独立内存 SQLite 合成夹具,无业务连接、无 .env、无网络。
|
||||
- `server/tests/AssistantServiceMysqlFlowTest.php`:目录指纹和固定测试端口双重校验的真实 MySQL 测试,随机测试库内执行真实模块迁移、API→Worker 联动、两个 PHP 子进程的并发请求、第二连接的 RR 撤权、来源变更与事务回滚,最后清理本次随机库。
|
||||
- `server/app/adminapi/logic/firstvisit/MyPatientLogic.php`:向后兼容新增可选 `$currentRoleIds` 参数;仅新模块传入服务端当前读核验的角色。此路径在 MySQL 的预约 EXISTS 子查询内追加当前读,既有默认调用保持原样。
|
||||
|
||||
## 关键行为
|
||||
|
||||
1. `view` 不能推导临床写权限或其他服务动作;所有动作另校验对应权限。列表 join 当前授权诊单,同时核对任务 patient_id,诊单重绑患者后原任务不可读写。
|
||||
2. 人工转写录入人不是历史发言人。人工来源统一 `speaker=unknown, actor_admin_id=0`;确认转写只表示素材已核对。Engine 仍必须检查可归因的 `service` 来源,才能输出员工 `met/missed`。
|
||||
3. 查看其他人的任务时,再按查看者重建员工域。存在不可见来源时隐藏对应来源、整个结果及复核记录,并标记过期,避免通过生成结果绕过 IM 员工域。
|
||||
4. 同一操作者相同来源、权限范围、问题、场景和知识快照复用任务。actor 行锁串行额度检查;先查幂等键,再扣当天任务额度。上游响应不确定的任务没有 API 自动重试入口。
|
||||
5. 采纳与复核前重新检查来源/权限 hash、知识已发布状态、版本及正文。知识新增不会使已有引用失效;修改或撤回被引用知识会使结果过期。
|
||||
6. 采纳锁定任务和诊单,`job_id/action_key` 唯一。跟进负责人固定当前操作者;完整提醒内容限制 500 字以匹配旧表,超限拒绝。sidecar 与旧 todo 同一事务写入。
|
||||
7. `business_state` 与旧提醒 `status` 独立。仅负责人或具备复核权限的主管可更新;完成/取消取消仍未发送的提醒,已发送状态保留。终态仅允许同状态幂等重放,保留最初执行记录,不允许回开或改成另一终态。
|
||||
8. 知识新增为 draft;修改后回 draft,更新/发布使用版本锁;发布要求来源说明,记录发布人。不预置事实 FAQ。
|
||||
9. 用户再次提交相同分析时,只对明确未生成的配置/输入等失败恢复同一任务并增加版本;`needs_reconciliation` 和已调用模型但结果无效的失败不会自动重发。已删除角色遗留的关联关系不再阻断仍有合法角色的员工。
|
||||
10. 状态筛选先按当前来源/授权检查,再确定 count 与分页;ready 筛选排除实时过期行,stale 筛选能找到尚未被 worker 标记的过期行。每批扫描 100 条,结果内存有界。
|
||||
|
||||
## 验证
|
||||
|
||||
运行目录 `D:/web/zyt/server`:
|
||||
|
||||
```powershell
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php
|
||||
```
|
||||
|
||||
结果:`ASSISTANT_SERVICE_API assertions=71 PASS sqlite=memory real_access_context_logic=1 network=0`。
|
||||
|
||||
覆盖跨患者读写、医生/医助/主管实际患者域、停用/撤权、可靠账号与员工 IM 过滤、未知员工拒绝、来源脱敏与 hash 稳定、人工转写确认、不把录入人当说话人、无知识拒绝回复、知识发布和版本冲突、任务幂等/额度、任务白名单、主管质检与伪造 key、查看者 IM 范围、重复采纳、负责人限制、跟进与提醒事务回滚、发送状态分离、终态重放/回开拒绝、知识变化和原文变化后拒绝采纳、患者重绑、超限及未迁移提示;来源增长超限后旧任务仍可安全读取 stale 状态,但隐藏未重新核验的来源和结果。
|
||||
|
||||
后续 MySQL 集成运行(仅 root 已创建的临时实例;脚本还会核对 `@@datadir`):
|
||||
|
||||
```powershell
|
||||
$env:ASSISTANT_SERVICE_TEST_ALLOW_DISPOSABLE='1'
|
||||
$env:ASSISTANT_SERVICE_TEST_PORT='15339'
|
||||
$env:ASSISTANT_SERVICE_TEST_DATADIR='D:/web/zyt/.spool/assistant-service-mysql'
|
||||
php tests/AssistantServiceMysqlFlowTest.php
|
||||
```
|
||||
|
||||
结果:`ASSISTANT_SERVICE_MYSQL_FLOW assertions=34 PASS real_access_context_logic_worker=1 concurrent_processes=2 network_model_calls=0`。
|
||||
|
||||
MySQL 验证包括真实迁移建表、API 创建记录/发布知识/入队、真实 Worker 领取与 Engine 结果验证、回复知识版本、主管复核、两进程重复入队/采纳仅一行、旧提醒与 sidecar 的 InnoDB 回滚;已存在 RR 快照后另一连接撤销角色、菜单、医生预约、患者归属、主管/员工部门及变更角色范围均不能继续授权;来源当前读、模型执行期间来源变化、知识变更均阻断采纳/ready 提交。也覆盖已删角色残留、默认 MyPatient 调用兼容、状态筛选精确计数及已知失败恢复。
|
||||
|
||||
集成测试实际发现并修复了“外层诊单 FOR UPDATE 不会让 EXISTS 预约子查询脱离旧 RR 快照”的问题。新可选路径给预约子查询明确加当前读后,撤销预约用例通过;未改变既有调用默认行为。
|
||||
|
||||
本次涉及的 8 个 PHP 文件均通过 `php -l`。本代理未访问生产数据库、未加载实际 .env、未调用模型、未触发患者发送、未部署或提交。
|
||||
|
||||
## 集成验收与限制
|
||||
|
||||
- MySQL 并发、RR 当前读与事务行为已在指定隔离实例中验证;仍需部署环境按实际版本与索引进行验收,不以隔离测试代替生产授权验收。
|
||||
- `jobs?status` 为保证实时状态精确计数,会分批检查当前范围内候选任务;诊单筛选可减少成本。未实现独立的过期状态物化索引,大规模历史任务筛选应评估延迟。
|
||||
- 来源超过容量时要求缩小时间范围;已发布知识超过 `max_knowledge_rows` 时明确要求管理员调整容量/知识范围,未实现全文知识检索。
|
||||
- 人工转写没有逐句历史员工身份结构,不能据此确定个人服务得失。首期个人归因以可靠 IM 账号为依据。
|
||||
- 企微、未核验音频未接入,并在覆盖信息中明确显示。模型可用性仅检查配置和 PHP 能力,没有对外健康探测;实际任务由 worker 给出结果状态。
|
||||
- 旧提醒进程一旦已抢占发送,完成跟进不能撤回该发送;此时保留旧发送状态,避免虚报取消成功。
|
||||
@@ -0,0 +1,30 @@
|
||||
# 今日联系 API 实现记录
|
||||
|
||||
日期:2026-11-10。范围限于 API 的 Logic、Validate、Controller、Access、Team 与对应内存测试;未读取 `.env`、业务数据库或模型凭据,未操作服务进程。
|
||||
|
||||
## 已实现
|
||||
|
||||
- `teamOverview` 保留原 `days=30`、`summary`、近期质检指标和队列语义,增加 `daily`、`daily_summary` 与每医助 `today_contact`。关键词过滤后的全部授权医助传入独立计划服务,再做列表筛选与分页。
|
||||
- `today_pending` 按 `outstanding>0` 过滤,`today_done` 要求 `required>0` 且 `state=done`。今日待维护、待核实优先,随后沿用原质检排序。未知数量不伪装成已完成。
|
||||
- 新 GET `staffDailyContacts` 显式复用 `view` 权限,调用计划服务的只读 `patients`;不依赖 AI 开关或旧质检表的总 schema 就绪判定。必填正整数医助,默认 pending,支持 all/pending/reported/contacted/exempt;分页上限 50,拒绝非法或注入字段。
|
||||
- `adoptAction` 增加严格 JSON boolean `contact_required`,默认 false。新表写整数 0/1;旧表未迁移时 false 正常工作,true 明确返回迁移要求且不生成待办。重复采纳保持原动作,不通过重试悄悄改变联系意图。
|
||||
- `actions` 返回 boolean `contact_required` 和整数 `completed_by`;旧表分别返回 false、0。数据库查询异常保持原异常路径,不吞成缺列。
|
||||
- `completeAction` 在增量列存在时记录实际终态操作者;终态重放保留最初操作者与执行记录。主管代操作不改成医助本人,旧记录不反推操作者;原通知状态与业务完成状态仍然分离。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php`:124 断言通过,使用 SQLite `:memory:` 与真实 Access/Context/Logic,不调用模型或网络。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamTest.php`:76 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php`:93 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamCoverageTest.php`:24 断言通过。
|
||||
- 8 个修改的 PHP 文件语法检查通过。
|
||||
- Team/Staff 验证旧 fixture 无今日表时返回 unavailable/null,仍保留 30 天统计;验证名单权限撤销与跨员工域拒绝。
|
||||
- Team 测试为 `think\\App` 指定唯一临时根目录,使用独立 runtime、内存来源表和真实计划服务 `tick()`,然后调用真实 API Logic。三位应维护患者分别为:IM 已联系 1、本人动作登记待核实 1、待维护 1。
|
||||
- 正向集成覆盖今日优先排序、today_pending/today_done、关键词范围、过滤与分页前汇总、名单状态筛选与分页、证据类型、无任务、实时豁免,以及 AI 关闭时的独立工作。全部 GET 不新增计划或模型任务。
|
||||
- 原“历史分析重复读取来源”测试监听排除了 `WHERE 1=0` 字段探测,继续验证实际来源正文最多读取三次,没有放宽原查询次数阈值。
|
||||
|
||||
未执行真实业务数据库迁移、服务启停、HTTP 浏览器验收;由主代理按整体交付流程完成。以上验证均为合成数据,不构成真实患者的今日结果。
|
||||
|
||||
## 环境记录
|
||||
|
||||
项目 `AGENTS.md` 与 `CLAUDE.md` 已阅读;当前工作区不存在 `.trellis/`,因此无法读取其 workflow/spec。未覆盖其他代理所有的计划服务、配置、SQL、前端文件。
|
||||
@@ -0,0 +1,89 @@
|
||||
# 今日联系核查实现契约(2026-11-10)
|
||||
|
||||
用户要求:检测每名医助今天的联系患者任务是否完成,显示应维护而未维护人数与名单。已有医助维度、自动 AI 分析和少切换体验必须保留。
|
||||
|
||||
主代理已询问今日应联系来源,暂按明确说明的默认值开发:已有到期联系跟进 + 复诊到期/过号/承诺日;不假定所有患者每天联系,不凭空设置 3/7 天周期。当前本地真实表均存在:复诊快照 4918 行(原始未加权限/归属过滤的到期开放 1468 行)、服务跟进 0 行、今日 IM 文字 0 条;这些不是交付指标,只用于选取既有数据源。
|
||||
|
||||
## 产品与规则
|
||||
|
||||
1. 新增独立、持久的当日联系计划快照,后台每 60 秒更新。与 AI 开关/模型完全独立;GET 只读,不扫描生成、同步、发消息或调用模型。
|
||||
2. 计划来源仅有:
|
||||
- `revisit`:当前有效诊单与快照当前医助一致、未关闭周期,复诊日 <= 上海今天或明确过号;尚无承诺日或承诺日 <= 今天(本模块明确含承诺当日;不改旧复诊弹窗规则)。未来承诺日不新纳入。缺药量/无复诊日且非过号不猜到期。
|
||||
- `action`:人工采纳且**明确勾选需联系患者**的服务动作,截止时间 < 次日 00:00,未取消且未在今天前完成。新增 `assistant_service_action.contact_required` 默认 0;旧泛化动作/自由文本待办不自动纳入。无需修改通知 status。
|
||||
3. 同日已入计划的来源不因新增承诺日而消失;计划保留纳入原因、来源和首次生成时间。诊单删除/换绑、转医助、周期更新、来源关闭/取消等作豁免并保留原因,不算完成;页面单独显示豁免数。今日新增来源可增补。初次开启之前无快照的历史任务不可伪装为完整重建的历史日报。
|
||||
4. 统计按当前可见的 `(医助, patient_id)` 合并,patient_id=0 则按诊单区分,不按姓名猜身份;同患者多条到期理由只算一位。总览汇总单位为人次;同医助行单位为患者数。
|
||||
5. 完成核对用上海 `[00:00, 次日00:00)` 且不晚于现在的真实事件:
|
||||
- `contacted`:可靠配对、非空的当天已归档 IM 文字,from=`doctor_{该医助}`、to=`patient_{该患者}`、patient_id 相同。只证明该账号已发出,文案“有联系记录/已联系”,不声称人工发送、对方回复或服务质量已达标。
|
||||
- `reported`:无上述 IM,但同周期复诊 event=2 日志由该医助本人操作,或明确 contact_required=1 的动作今日被登记 completed(不是 cancelled)。保留人工登记性质,计待核实,不计可验证的联系完成。主管代操作不能冒充医助本人;可显示辅助说明但不能由别人的 IM/按钮把该医助清零。
|
||||
- `pending`:以上均无,文案“待维护 / 未发现今日联系记录”。外部电话/企微未接入,不能断言从未联系。普通 tracking_note、手动转写、生活记录、通知发送、AI ready/met 均不计完成。
|
||||
6. required = contacted + reported + pending;outstanding = reported + pending。无任务显示“今日暂无应维护患者”,不能显示 100% 完成。只要来源不可读/扫描未生成/过期则不可显示全员完成。
|
||||
7. 默认近期质量仍 30 天;今日执行日期来自服务端 Asia/Shanghai,与客户端时区/DB CURDATE 无关。午夜刷新须切换新业务日,不接受迟到旧日名单覆盖。
|
||||
|
||||
## 持久化与调度(planner 代理所有)
|
||||
|
||||
新增服务 `AssistantServiceDailyContact`(可拆内部类)、命令 `assistant-service:daily --sleep=60 [--once]`、新版本 SQL `server/sql/1.9.20261110/01_assistant_service_daily_contact.sql`,同文件幂等加 action.contact_required。
|
||||
|
||||
建议计划表 `assistant_service_daily_contact` 每日期/医助/来源唯一(可按 source_type+source_id),字段至少 business_date,assistant_id,diagnosis_id,patient_id,source_type,source_id,source_order_id,reason,due_at,state(active/exempt),exempt_reason,created_at,updated_at。同患者多来源由读取聚合。计划不能保存为无权限过滤的患者全量文件。
|
||||
|
||||
使用真实单机 flock + runtime 心跳(统一 root_path('runtime'),CLI/Web 相同)。显式配置 `daily_contact_enabled` 默认 false、`daily_contact_actor_id` 默认 0、interval=60;主代理后续在本地绑定已授权主管1启用。每轮重检主管角色、模块 view 以及真实员工域/患者域交集。无有效 actor 不扫描。单轮有界处理且游标公平,不因第一批旧计划卡死;断点/多次扫描幂等、滚动到次日生成新日期,不自动触发模型。
|
||||
|
||||
公开方法冻结:
|
||||
|
||||
```
|
||||
AssistantServiceDailyContact::team(array $staff, int $adminId, array $actor): array
|
||||
// 返回 ['meta'=>DailyMeta,'summary'=>DailyCounts,'by_staff'=>[staffId=>DailyCounts]]
|
||||
AssistantServiceDailyContact::patients(array $p, int $adminId): array
|
||||
// 参数 assistant_id 必填, status=all|pending|reported|contacted|exempt 默认 pending,page_no/page_size
|
||||
// 返回 {staff, daily:DailyMeta, summary:DailyCounts, lists:DailyPatient[],count,page_no,page_size}
|
||||
```
|
||||
|
||||
DailyCounts:
|
||||
```
|
||||
{required:number|null,contacted:number|null,reported:number|null,pending:number|null,
|
||||
outstanding:number|null,exempt:number|null,state:'no_tasks'|'pending'|'reported'|'done'|'unavailable'}
|
||||
```
|
||||
DailyMeta:
|
||||
```
|
||||
{business_date:'YYYY-MM-DD',timezone:'Asia/Shanghai',as_of:number,
|
||||
state:'ready'|'waiting'|'partial'|'unavailable',reason:string,last_scan_at:number,
|
||||
rule_label:string,coverage:[{source:string,status:'available'|'empty'|'unavailable'|'not_connected',note:string}]}
|
||||
```
|
||||
DailyPatient:
|
||||
```
|
||||
{key:string,patient_id:number,patient_name:string,diagnosis_id:number,diagnosis_ids:number[],
|
||||
status:'pending'|'reported'|'contacted'|'exempt',
|
||||
reasons:[{type:'revisit'|'action',label:string,due_at:number,source_id:number}],
|
||||
last_contact_at:number,evidence:[{type:'im'|'revisit_contact'|'action_completed',id:number,at:number,label:string}],
|
||||
exempt_reason:string}
|
||||
```
|
||||
|
||||
不得将超出当前权限的旧计划算入任何数字/明细;实时重查诊单绑定、账号、来源周期/取消,等待下轮扫描时也不能显示无权患者。缺表/缺列/来源异常/今日无扫描元数据要有明确 unavailable/waiting/null,不能吞成空名单。只显示历史已有且可见的辅助事实。IM 批量查询避免每患者一次查询。明细分页前汇总/去重;筛选不缩减 summary。统计期间不得连接模型。预计几千计划规模可读,限制明细50。
|
||||
|
||||
planner 所有文件:新服务/命令/SQL、server/config/assistant_service.php、server/config/console.php、独立 DailyContactTest/迁移测试及其报告。禁止 .env/业务DB/模型/启停服务。与 API 代理约定 contact_required 列名为整数0/1。
|
||||
|
||||
## API 集成(api 代理所有)
|
||||
|
||||
在现有 teamOverview 加 `daily:DailyMeta`、`daily_summary:DailyCounts`;每行加 `today_contact:DailyCounts`,保持旧 summary/metrics/days=30 不变。
|
||||
- 所有 keyword 医助传给 DailyContact::team,filter/page 前汇总。
|
||||
- 新 filter 值 `today_pending` (outstanding>0)、`today_done` (required>0,state=done);旧过滤含义不变。优先今日待维护/待核实再沿用旧排序。
|
||||
- 新 GET `staffDailyContacts`,调用上述 patients;Validate/Controller/Access 显式复用 view,assistant_id>0,status枚举、页码/页长严格验证。
|
||||
- `adoptAction` 加可选布尔 contact_required 默认 false;插入整数。旧schema未升级时 false 仍兼容旧功能,true 明确要求升级;不得 SQL错误吞掉,实际模型知识/权限链不放松。
|
||||
- actions 返回 contact_required 字段供前端标记;旧schema可返false。不可把通知status=1算完成。
|
||||
- 全部单测用内存fixture,既有缺新表的旧夹具应断言新功能 unavailable 而旧30天仍正确,不用假0伪装。
|
||||
|
||||
API代理拥有 Logic/Validate/Controller/Access/Team 以及相应API/Team/Staff测试,不能改planner服务/config/SQL/admin。写 daily-contact-api-implementation.md。
|
||||
|
||||
## 前端(frontend 代理所有)
|
||||
|
||||
首页上方优先今日应维护、已联系、待维护、人工登记待核实;下方紧凑保留30天质检指标/自动模型状态,不能只是再堆4张卡。日期服务端返回。
|
||||
行优先今日数及执行状态;未维护/待核实数可点击直达该医助名单;默认打开医助为今日名单,另有清楚“服务质检”直达旧issues。804px核心数/按钮保持可用。
|
||||
现有 StaffDetail 中新增独立 DailyContacts 视图,不因质量overview失败隐藏它。明细列患者、应维护原因/日期、联系状态/证据时间、查看记录(现有 CaseDetail,只读自动分析模式)。返回保留今日过滤页码;支持查看全部/待维护/人工登记/已联系/豁免。
|
||||
沿用30秒静默刷新/visibility/abort/revision;同一天不重置打开抽屉、筛选、正在输入的表单;跨午夜更新server date并重置日名单页码,拒绝旧日响应。
|
||||
采纳跟进建议表单增加“需要联系患者,计入到期联系任务”checkbox默认false,发送 contact_required。只显式采纳产生任务,无自动代采纳/完成/发消息。
|
||||
类型/API 与两套合成夹具同步;主代理维护 artifacts/staff-ui-fixture.mjs,frontend 维护 admin/tests。测试不需模型。仅直接 Vite 构建,不用带release的npm run build。写 daily-contact-frontend-implementation.md。
|
||||
|
||||
## 验收
|
||||
|
||||
代理仅合成内存/本地源代码,终态报告后主代理统一集成、复核、幂等迁移隔离验证、按用户授权应用本地增量迁移、启用独立计划任务和浏览器验收。未完成所有派生代理前不可最终交付。保持已有AI扫描/worker运行,不重置失败任务、不改真实患者业务状态。
|
||||
|
||||
接口协调补充:action 同时新增 completed_by INT DEFAULT 0。completeAction 仅真实状态改变时记录当前操作者;幂等重发不改历史。只有 completed_by=assignee 的今日 completed 可记 reported,旧0和主管代操作不能推断为医助本人完成。
|
||||
@@ -0,0 +1,34 @@
|
||||
# 今日维护前端实现记录
|
||||
|
||||
日期:2026-11-10。已按 `daily-contact-contract.md` 冻结契约完成前端实现。已读取 AGENTS.md / CLAUDE.md 和 UI 研究,应用项目 `redesign-existing-projects` 技能;当前 checkout 未提供 `.trellis/`,无法读取其附加规范。没有派生代理。
|
||||
|
||||
## 已实现
|
||||
|
||||
- `admin/src/api/assistantService.ts`:增加 DailyMeta / DailyCounts / DailyPatient / StaffDailyContacts、team.daily / daily_summary / today_contact、today_pending / today_done 筛选、带 AbortSignal 的 `assistantStaffDailyContacts` GET;采纳动作支持可选布尔 `contact_required`,事项类型返回该字段。
|
||||
- `workbench/index.vue`:首页优先展示今日应维护、已联系、待维护、人工登记待核实,统一横向指标区;近 30 天质检与自动分析仍保留为紧凑可展开摘要。AI 未配置不会阻止今日数据读取。表格突出今日人数,待维护和人工登记按钮直接定位对应名单;“服务质检”直接进入原 issues 页。同医助多入口通过 entryKey 显式切换。
|
||||
- `components/DailyContacts.vue`:独立今日名单和错误边界,支持 pending / reported / contacted / all / exempt;展示服务端患者合并行、全部到期理由、联系或登记证据时间、豁免理由,以及每个授权诊单的“查看记录”。显示服务端汇总,不通过当前页推算总数。无任务、全部有联系记录、来源不完整、未生成、读取失败分别表达;null 不转成 0。
|
||||
- `components/StaffDetail.vue`:今日维护成为默认入口,与 30 天质量 overview 独立。今日名单进入现有 automatic CaseDetail;同一天的后台刷新保留当前记录、过滤、页码与表单。质量 overview 单独失败不会隐藏今日名单或从今日进入的记录;名单读取失败仍会关闭该来源的记录以防残留无权内容。复用已有更新通知链,不增加轮询计时器。
|
||||
- 日期与请求保护:只接受上海业务日期;主页面维护当前服务端日期,不接受倒退。名单日期较新时通知首页更新;日期变更立即清空旧名单、重置名单页码并取消旧请求。revision 丢弃旧医助、旧日、旧筛选响应。权限撤销清空数据;名单在页面隐藏/停用时取消在途读取,暂停后续刷新。恢复后沿用首页刷新链。
|
||||
- `components/JobResult.vue`:新增默认未勾选的“需要联系患者,计入到期联系任务”,每次新采纳重置为 false,仅明确提交发送 true。
|
||||
- `components/ServiceActions.vue`:明确标记需联系患者的事项,原业务完成/通知状态逻辑保留。
|
||||
- `shared.ts`:新增上海时区展示函数,今日生成时间、到期时间和证据时间不受客户端时区影响。
|
||||
|
||||
## 布局与设计处理
|
||||
|
||||
原首页六项近期指标和较多表格列会压低今日任务优先级;原抽屉又由 quality overview 成功与否控制全部内容。本次直接调整现有 Vue / Element Plus 组件:以一组四项今日指标替换堆叠卡片,近期质量摘要收拢;窄屏只保留医助、应维护、已联系、待维护/核实与质检入口。今日患者列表使用响应式行,700px 以下改为双列布局。保留项目字体、主题色、数字等宽、焦点样式、加载/空态/错误态,不引入依赖、远程字体或装饰图。
|
||||
|
||||
## 验证结果
|
||||
|
||||
执行 `cd admin; node --test tests/assistant-service.test.cjs`:**40 / 40 通过**,包括原有 29 项和新增 11 项。测试编译真实 SFC script/template/scoped style,并运行真实 setup / Vue 响应,不绕过未知 import。
|
||||
|
||||
新增回归覆盖:冻结只读 API 参数和取消信号;模型未配置仍读今日数据;待维护/人工登记/质检直接入口;名单分页和筛选不缩减后端小计;只能打开当前返回的诊单引用;医助切换和权限撤销;无任务/已联系完/不可用/部分覆盖/读取失败;同日刷新与证据变化;跨日页码重置、旧日/错时区响应拒绝;首页日期不倒退;独立质量错误边界及同员工入口切换;显式采纳联系任务;页面隐藏/停用取消与恢复刷新。
|
||||
|
||||
执行本地 `node node_modules/vue-tsc/bin/vue-tsc.js --noEmit --pretty false`:全量退出码 2,共 110 行诊断;其中未出现 `assistantService` 或 `assistant_service` 路径的诊断,不能将全量类型检查报告为通过。之后仅增加名单可见性生命周期、将 activeTab 显式声明为 string,并再次跑过全部 40 项 SFC/setup 测试。
|
||||
|
||||
未运行 npm run build / release;未启动浏览器、服务或模型,未访问网络、`.env` 或业务数据库;未修改 PHP / config / SQL 或主代理维护的浏览器 fixture。全量直接 Vite 构建、804px 实际浏览器视觉与交互验收交由主代理统一执行。
|
||||
|
||||
## 集成提示
|
||||
|
||||
浏览器合成夹具应返回完整 team.daily / daily_summary / row.today_contact,并实现 `staffDailyContacts`。它与 Node 测试夹具是不同来源,前端测试已独立更新。状态枚举严格使用 `all | pending | reported | contacted | exempt`,没有增加日期查询参数或新的模型调用。
|
||||
|
||||
当前仓库的医助服务前端目录和 API / 测试原本均为未跟踪文件;本次没有 git add 或提交。`vue-tsc --noEmit` 自动更新了已跟踪的 `admin/tsconfig.tsbuildinfo` 缓存(运行前文件长度 713688,运行后 757651);因无法确认该缓存开始时是否已有未提交修改,未擅自恢复 HEAD,已通知主代理按初始状态处理。没有手工改动其他模块。
|
||||
@@ -0,0 +1,47 @@
|
||||
# 今日联系功能独立集成复核
|
||||
|
||||
复核日期:2026-11-10。只读业务源码;已阅读 AGENTS.md、CLAUDE.md、冻结契约,以及 planner / API / frontend 三份实现记录。当前 checkout 没有 `.trellis/workflow.md`。没有派生代理,没有读取 `.env`、连接业务数据库、访问网络或模型、启停服务。仅新增本报告和隔离复现脚本。
|
||||
|
||||
## 结论
|
||||
|
||||
发现 **1 个可复现的 P2 边界问题**:IM 发件账号的严格配对依赖数据库比较规则,实际归档表使用大小写不敏感排序规则时,大小写异名账号也可能使医助从待维护变为全部已联系。其余本次检查的关键口径未发现可复现问题。
|
||||
|
||||
## P2:IM 发件账号缺少逐字节复核,非严格配对消息会清零待维护
|
||||
|
||||
- 位置:`server/app/common/service/assistantservice/AssistantServiceDailyContact.php:190-199`,尤其 195-196 行。
|
||||
- 相关 schema:`server/sql/1.9.20260507/add_tcm_im_chat_message_table.sql:10,28`,`from_account` 是继承 `utf8mb4_unicode_ci` 的 varchar。
|
||||
- 触发条件:医助 11 有一位今日计划患者,归档内存在 `from_account='DOCTOR_11'`、`to_account='patient_1901'`、`patient_id=1901` 的当天非空文字。它并不逐字等于契约要求的 `doctor_11`。
|
||||
- 根因:SQL `whereIn('from_account', ['doctor_11'])` 在该排序规则下会命中大小写异名。PHP 仅严格检查 `to_account`,随后对发件账号直接 `substr(..., 7)` 并转整数,得到 11,于是记为该医助的联系证据。普通 SQLite TEXT 比较区分大小写,现有测试无法暴露差异。
|
||||
- 实际结果:在只读真实服务、SQLite 内存归档列设为 `COLLATE NOCASE` 的隔离夹具中,读前为 `required=1, contacted=0, pending=1, outstanding=1, state=pending`;加入上述记录后变为 `required=1, contacted=1, pending=0, outstanding=0, state=done`。此夹具只模拟本问题涉及的 ASCII 大小写比较,不声称等价模拟所有 MySQL collation 行为。
|
||||
- 复现:在仓库根目录运行 `php -d extension=php_pdo_sqlite.dll artifacts/medical-assistant-feature-plan/daily-contact-review-repro.php`。脚本从现有隔离测试复用内存准备代码,调用真实 `tick()` / `teamReport()`,输出 `REPRODUCED` 及前后计数,并清理唯一临时 runtime。
|
||||
- 修正边界:取出消息后再次要求 `from_account` 严格等于 `doctor_` 加当前目标医助整数 ID,并确认 ID 在目标集合中,再允许建立证据;不要把最终身份校验交给 SQL collation。加入大小写异名账号的回归即可。
|
||||
- 范围说明:当前 `DiagnosisLogic::isPatientDoctorImPair()` 已对新写入的正常回调/同步做小写账号校验,因此本次没有证明正常回调能写入该异常记录,也没有检查真实库是否存在此类记录。问题在日报读取对既有/异常归档未实现契约要求的严格配对,不应将其夸大为已发生的业务误报或可利用的发送入口。
|
||||
|
||||
## 已验证的关键路径
|
||||
|
||||
| 路径 | 复核结果 |
|
||||
| --- | --- |
|
||||
| 固化分母 | 已入计划后新增未来承诺日或延迟不移出计划;关闭、取消、转交、真实订单周期变化走豁免,不计联系完成。 |
|
||||
| 聚合及周期 | 同医助同 patient_id 多来源/多诊单合为一位;patient_id=0 分诊单;旧周期登记不混入当前周期;有效来源与豁免来源并存不重复加人。 |
|
||||
| 当前权限 | GET 重查员工域、患者域、启用账号;删除/换绑旧患者不进入明细;跨域医助、失权账号不能通过名单入口获取对象。 |
|
||||
| 联系证据 | 入站、别的医助、错误收件人、空白 ASCII 文字、图片、昨天/明天/未来消息排除;本人复诊登记和本人明确联系动作仅计 reported;主管代录不计本人。发件账号 collation 例外见上。 |
|
||||
| 数据完整性 | 未扫描、首轮未覆盖、心跳过期、范围变化、缺表缺字段返回 waiting/partial/unavailable 与 null;真实空集合为 no_tasks。 |
|
||||
| 汇总及列表 | keyword 后全量医助范围先计算今日汇总,再进行 today_pending/today_done 筛选、排序和分页;名单状态筛选和分页不缩减 summary。 |
|
||||
| 前端刷新 | 真实 SFC/setup 测试验证同日保留筛选、页码、搜索草稿、已打开记录和表单;上海日期推进重置名单页码并拒绝迟到旧日;隐藏/停用取消在途请求;质量 overview 单独失败不隐藏今日入口。 |
|
||||
| 副作用 | 日报 GET 不写计划、发消息或创建模型任务;计划运行不受 AI 开关关闭影响。 |
|
||||
|
||||
## 本次实际执行
|
||||
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceDailyContactTest.php`:54 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceTeamTest.php`:76 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceApiTest.php`:124 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceStaffTest.php`:93 断言通过。
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceTeamCoverageTest.php`:24 断言通过。
|
||||
- `cd admin; node --test tests/assistant-service.test.cjs`:40 / 40 通过。
|
||||
- 独立 collation 复现脚本:问题复现成功,输出从 `pending` 变为 `done`。
|
||||
|
||||
本代理未执行 MySQL 迁移、真实浏览器、直接 Vite 构建或服务运行验证;这些由主代理并行负责。这里的所有患者、账号和计数均为合成内存数据,不是业务患者的联系结果。
|
||||
|
||||
## 主代理修复与复测
|
||||
|
||||
2026-11-10 已在 IM 证据读取处增加规范发件账号的严格相等检查,并确认医助 ID 属于当前目标集合。核心隔离测试改用 `from_account TEXT COLLATE NOCASE`,新增大小写异名和非规范前导零账号回归。核心测试 55 项、Team 集成 76 项通过;独立复现脚本输出 `NOT_REPRODUCED`,异常发件账号不再将待维护变为已联系。此修复未改归档数据或发送流程。
|
||||
|
After Width: | Height: | Size: 67 KiB |
|
After Width: | Height: | Size: 88 KiB |
|
After Width: | Height: | Size: 63 KiB |
@@ -0,0 +1,50 @@
|
||||
# 今日联系计划与核查实现交付
|
||||
|
||||
日期:2026-11-10。实现遵循 `daily-contact-contract.md` 和来源研究;未读取 `.env`,未连接业务库、模型、消息服务,未启停服务。
|
||||
|
||||
## 实现文件
|
||||
|
||||
- `server/app/common/service/assistantservice/AssistantServiceDailyContact.php`:冻结的 `team()` / `patients()`,只读核查、持久计划生成与状态重检。
|
||||
- `server/app/command/AssistantServiceDaily.php`:`assistant-service:daily --sleep=60 [--once]`,无模型/消息副作用。
|
||||
- `server/config/console.php`:登记命令。
|
||||
- `server/config/assistant_service.php`:独立 `daily_contact_enabled=false`、`daily_contact_actor_id=0`、轮询60秒、每来源批量500(可设1至1000)。
|
||||
- `server/sql/1.9.20261110/01_assistant_service_daily_contact.sql`:计划表及 action 新列,MySQL 5.7 幂等语法。
|
||||
- `server/tests/AssistantServiceDailyContactTest.php`:SQLite 内存、真实 ORM/Access、隔离 runtime 与时钟。
|
||||
- `server/tests/AssistantServiceDailyContactMigrationTest.php`:显式15339隔离 MySQL 指纹门禁,供主代理统一执行。
|
||||
|
||||
## 关键口径
|
||||
|
||||
计划仅来自复诊到期/承诺当日/过号,及 `contact_required=1` 的到期人工采纳动作。复诊除当前快照外还批量核验最新有效业务订单,剔除订单状态4/9/10、软删除、旧周期与快照医助错配。未来承诺、无日期且未过号、旧泛化动作不自动纳入。
|
||||
|
||||
当日计划保存首次来源、原因、时间、原医助/患者/订单周期。入计划后新增承诺或延期不缩小分母;关闭、取消、换绑、转医助或周期更新独立豁免。当前周期责任重新有效且再次到期时复用原计划,保留上次豁免原因和首次纳入时间。新周期、新日期、新医助责任独立入计划。数据库唯一键与单机锁共同保护重扫和重启幂等。
|
||||
|
||||
统计按 `(assistant_id, patient_id)` 去重;patient_id=0按诊单区分。多理由患者只计一次,有有效理由时不另计一名豁免患者。状态筛选和分页均在全量去重汇总之后执行,明细最多50条。
|
||||
|
||||
- `contacted`:上海当日、不晚于现在、非空且账号严格配对的医助出站归档文字,只证明账号发出。
|
||||
- `reported`:无上述记录但有本人同真实订单周期的复诊event=2登记,或本人今日登记明确联系动作completed;仍计outstanding。
|
||||
- `pending`:未发现上述证据,不断言从未联系。
|
||||
- 普通备注/转写/生活记录/通知状态/AI结果从未进入完成判断;主管代录和旧未知操作者不冒充本人。
|
||||
|
||||
已与主代理和API代理协商同加 `completed_by INT UNSIGNED DEFAULT 0`。API仅真实状态变化时记录当前操作者,重放终态不重写;日报必须 `completed_by=assignee_id` 才将动作记为reported。迁移不回填猜测旧操作者。
|
||||
|
||||
## 权限、缺数据和调度
|
||||
|
||||
每次GET和每轮调度重查启用账号、有效角色、view权限、员工域与患者域。读取时以当前有权诊单重新JOIN计划,并核验patient_id一致,已换绑/删除/不可见对象不会进入任何人数或明细。旧责任在当前仍可见诊单上的转移可显示豁免。所有IM/日志/来源按计划诊单或患者分块读取,无逐患者Access调用。
|
||||
|
||||
扫描主管必须为显式授权root或角色3/7/8。读取范围超出当前扫描主管域时返回partial和null计数。缺表/缺列/读取失败/无今日扫描/心跳超过max(180秒,3倍interval)/过期全量扫描均不显示完整人数或全员完成。电话及外部企微明确not_connected。AI配置关闭不影响此服务。
|
||||
|
||||
CLI/Web统一使用 `root_path('runtime')/assistant_service_daily_contact`。真实flock串行扫描,运行文件只有日界、操作者、游标、时间、状态和域指纹,不保存患者全量清单或消息正文。来源发现和已有计划核查各自独立keyset游标;每来源每轮最多batch条,计划核查亦最多batch条。域变化失效完整性但保留游标前进,扫完尾部再完整扫新域,避免不断新增患者令第一页饿死。首次完整扫完两个来源之前保持partial/null。权限域指纹通过当前可见诊单ID/归属的内存批量查询计算,不写无权限患者文件。
|
||||
|
||||
日期与证据边界均由显式Asia/Shanghai产生,不使用DB CURDATE或PHP默认时区。午夜立即切换新日期,旧心跳不能使新日ready;没有历史快照的日期不提供伪重建日报。
|
||||
|
||||
## 验证
|
||||
|
||||
已执行,无网络/模型/业务库连接:
|
||||
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceDailyContactTest.php`:54断言通过。含来源边界、去重、patient_id=0、分页、真实空集合、权限、承诺变化分母稳定、主管代录、IM匹配与日界、人工待核实、关闭/恢复/换绑/转移/新周期、GET只读、过期/缺表、重启游标、持续新增域不饿死、真实flock、上海跨日。
|
||||
- `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceTeamTest.php`:76断言通过,包含API代理新增的真实日报正向集成。
|
||||
- PHP lint:新服务、命令、两个测试、两个配置均通过。
|
||||
|
||||
MySQL迁移测试尚未由本代理执行,按父任务约束交由主代理在全部实现代理终态后统一运行。测试须同时设置 `ASSISTANT_SERVICE_TEST_ALLOW_DISPOSABLE=1`、`ASSISTANT_SERVICE_TEST_PORT=15339`、`ASSISTANT_SERVICE_TEST_DATADIR=实际隔离数据目录`,先核对 `@@datadir` 再创建随机测试库;10项断言覆盖三次迁移、默认0、旧记录/提醒不变、保留新字段真实值、来源唯一约束及新周期/新日期/新责任独立性。测试仅清理其随机创建的库。
|
||||
|
||||
`.trellis/workflow.md` 和 `.trellis/spec/backend/*` 在当前工作树不存在,已向主代理说明;遵循实际AGENTS.md、CLAUDE.md及已冻结契约。未修改其他代理拥有的API或前端文件。
|
||||
@@ -0,0 +1,34 @@
|
||||
<?php
|
||||
declare(strict_types=1);
|
||||
|
||||
// 只复用内存测试的准备部分,不加载 .env、不初始化业务应用、不访问网络或业务库。
|
||||
$repository = dirname(__DIR__, 2);
|
||||
$fixture = str_replace("\r\n", "\n", file_get_contents($repository . '/server/tests/AssistantServiceDailyContactTest.php'));
|
||||
$marker = "\ntry {\n \$ok(\$team()";
|
||||
$offset = strpos($fixture, $marker);
|
||||
if ($offset === false) { throw new RuntimeException('隔离测试准备边界已变化,请重新检查夹具'); }
|
||||
$bootstrap = substr($fixture, 0, $offset);
|
||||
$bootstrap = str_replace("dirname(__DIR__) . '/vendor/", var_export($repository . '/server', true) . " . '/vendor/", $bootstrap);
|
||||
// MySQL 实际归档表使用 utf8mb4_unicode_ci;NOCASE 只模拟此处需要的 ASCII 大小写比较行为。
|
||||
$bootstrap = str_replace('from_account TEXT,to_account TEXT', 'from_account TEXT COLLATE NOCASE,to_account TEXT', $bootstrap);
|
||||
eval(substr($bootstrap, strlen('<?php')));
|
||||
|
||||
try {
|
||||
$diagnosis(901);
|
||||
$revisit(901);
|
||||
$daily->tick();
|
||||
$before = $team()['summary'];
|
||||
$im(901, 1901, $clock, 'DOCTOR_11');
|
||||
$after = $team()['summary'];
|
||||
echo json_encode(['scenario' => 'case_insensitive_archive_sender', 'from_account' => 'DOCTOR_11',
|
||||
'expected_exact_sender' => 'doctor_11', 'before' => $before, 'after' => $after], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . PHP_EOL;
|
||||
if ($before['pending'] !== 1) { throw new RuntimeException('初始待维护夹具未建立'); }
|
||||
if ($after['contacted'] !== 0) { echo 'REPRODUCED: 非严格配对发件账号被计为已联系' . PHP_EOL; }
|
||||
else { echo 'NOT_REPRODUCED: 严格配对检查已经修复' . PHP_EOL; }
|
||||
} finally {
|
||||
foreach (['scan.json', 'scan.lock'] as $name) {
|
||||
$file = $temporary . '/' . $name;
|
||||
if (is_file($file)) { unlink($file); }
|
||||
}
|
||||
if (is_dir($temporary)) { rmdir($temporary); }
|
||||
}
|
||||
@@ -0,0 +1,161 @@
|
||||
# 今日联系任务规则研究
|
||||
|
||||
研究日期:2026-11-10。范围:只读仓库内 PHP、SQL、Vue/TS;已读根目录 AGENTS.md、CLAUDE.md;未读取 `.env`,未访问业务数据库、网络或模型,未启停服务,未改业务源码。SQL 文件存在不代表线上已经迁移;下述均是代码能力,不能推断真实患者数或生产运行状况。
|
||||
|
||||
## 结论
|
||||
|
||||
系统目前没有覆盖所有医助、所有患者的统一“今天必须联系”规则,也没有可直接复用的“今日应维护/已维护/未维护人数”统计。现有规则分别是复诊到期提醒、人工定时待办、人工采纳的服务跟进;旧团队面板是最近 30 天的来源/任务统计。
|
||||
|
||||
建议新增一个**不调用模型的今日联系核查**:先按明确业务规则形成今日应联系患者集合,再以独立、可追溯的联系记录判断完成,主管从人数下钻到未完成患者。保留“系统记录/人工确认/尚无记录”的证据区别。AI 结果、企微提醒已发送、随访资料有更新,都不能单独证明医助今天联系过患者。
|
||||
|
||||
## 现有规则与字段
|
||||
|
||||
### 1. DiagnosisTodo 是提醒,不是执行任务
|
||||
|
||||
- `server/sql/1.9.20260505/add_tcm_diagnosis_todo.sql:9` 建表:`diagnosis_id/patient_id/content/remind_time/creator_id/status/notified_at/cancelled_at/cancelled_by`。没有业务完成、实际联系人、联系渠道、联系结果。
|
||||
- `server/app/common/model/tcm/DiagnosisTodo.php:40`:状态 0=待执行、1=已发送、2=已取消、3=发送失败。`STATUS_SENT` 指通知发送。
|
||||
- `server/app/adminapi/logic/tcm/DiagnosisTodoLogic.php:50`:创建只要求诊单存在、提醒时间晚于现在、保存创建人;内容是自由文本,不能通过模型/关键词断定所有待办都是联系任务。
|
||||
- `server/app/command/DiagnosisTodoNotify.php:61`:扫描 `status=0 AND remind_time<=now`;第 81 行先抢占写 `status=1/notified_at`,再发企微,失败再写 3。进程中断还可能留下“已发送”中间状态,更不能用它判业务完成。
|
||||
- `server/app/common/service/assistantservice/AssistantServiceReminderRecipient.php:13`:普通待办收件人为创建人;若关联服务动作则按动作执行人发送并重检访问权限。故 `creator_id` 不等于患者当前医助,也不总等于执行人。
|
||||
|
||||
可复用:明确标记为联系任务后的 `remind_time` 与诊单关联;不可复用:`status=1/notified_at` 作为联系完成。旧待办应显示“未分类提醒”,不能默认为每日任务来源。
|
||||
|
||||
### 2. RevisitDue 已有“到期需要跟进”规则,但不是每天联系义务
|
||||
|
||||
- `server/sql/1.9.20261012/02_add_tcm_diagnosis_revisit_due.sql:8`:一诊单一行、仅当前订单周期;保存 `assistant_id/source_order_id/due_date/closed_state/appointment_state/promised_date/contacted_at/contact_count/computed_at`。
|
||||
- `server/app/common/service/tcm/RevisitDueCalculator.php:145` 的 `computeFacts()`:有效订单+有医助+诊单启用才有效;预计复诊日按签收→发货→下单回退锚点,增加开药天数和宽限天数;天数取订单、再处方、再配置。没有天数则 `due_date=null`,不能断定未到期。
|
||||
- `server/app/adminapi/logic/tcm/RevisitDueLogic.php:852` 的 `applyDueWhere()`:`assistant_id=本人 AND closed_state=0 AND (appointment_state=4 OR due_date<=CURDATE()) AND (promised_date IS NULL OR promised_date<CURDATE())`。
|
||||
- `server/app/adminapi/lists/tcm/RevisitDueLists.php:178` 的 `state=due` 同口径;默认只排除失效 5,使用者必须明确选 `due`,否则也有已约/已面诊/人工关闭记录。
|
||||
- 弹窗另限 `next_remind_at<=now`、条数和开关,并会写首次/末次展示、执行实时刷新(`RevisitDueLogic.php:212`)。日报不能用弹窗条目数当应维护数,也不能调用 `pending()` 当只读查询。
|
||||
- 默认预警窗口 3 天、深红超期 7 天、扫描范围二中心(`RevisitDueCalculator.php:57`、`server/config/project.php:169`);这些是复诊预警配置,不是所有患者维护频次。
|
||||
|
||||
重要边界:
|
||||
|
||||
1. `deriveState()` 的 `contacted` 由 `promised_date>=today` 推出(`RevisitDueCalculator.php:300`),患者上周联系、承诺明天复诊,今天仍是 contacted。不能计入今日已联系。
|
||||
2. 到期条件排除承诺日等于今天,但 `promisedRemindAt()` 又把下次提醒设为承诺日工作时段开始(`RevisitDueLogic.php:137,469,852`)。若新需求要“承诺当天再联系”,需要显式新增业务口径,不能声称已被旧规则覆盖。
|
||||
3. 已过期的已约行在 `deriveState()` 可显示 missed,但到期 SQL 直接识别的是 `appointment_state=4` 或药尽日;依赖刷新/挂号状态更新,快照可能滞后。
|
||||
4. 新订单周期或转医助会重置 `promised_date/contacted_at/contact_count`(`RevisitDueService.php:42,64,869`)。快照无法重建过去某天的完成率。
|
||||
5. 当前到期行在联系后因为设置承诺日而退出 due 集合;若实时将 due_total 当分母,会出现完成越多、应联系人数越少的问题。
|
||||
|
||||
### 3. 复诊“已联系”是有身份的人工确认,证据仍有限
|
||||
|
||||
- `server/app/adminapi/logic/tcm/RevisitDueLogic.php:437` 的 `contact()`:只对进行中周期,需承诺日,填写备注可为空;落 `contacted_at=time()` 并写 `EVENT_CONTACT=2` 日志。
|
||||
- `server/sql/1.9.20261012/03_add_tcm_diagnosis_revisit_due_log.sql:3`:日志有 `diagnosis_id/assistant_id/source_order_id/event/operator_id/create_time/payload`。其中 `assistant_id` 为事件时持有医助,`operator_id` 为实际按钮操作者;后者可能是超管(`RevisitDueLogic.php:778`)。
|
||||
- `server/app/common/service/tcm/RevisitDueService.php:493` 的 `writeLog()` 捕获异常仅 warning;contact 更新与写日志并非同一个原子事务。日志缺失不能断言没人联系;快照有时间也不能恢复被重置的历史。
|
||||
|
||||
建议:可作为“人工确认已联系”的既有来源,按 event=2、当天时间区间和实际操作者归因;主管代确认必须保留“代录人”和“实际联系人”区别,不把持有医助直接当实际服务者。event=8 企微推送、event=1 延迟、event=3 关闭、event=4/5 已挂号/已面诊均不能冒充医助联系。
|
||||
|
||||
### 4. tracking_note 是每日合并备注,不能可靠归因多次联系
|
||||
|
||||
- `server/sql/1.9.20260505/add_tracking_note_table.sql:3`:唯一键 `(diagnosis_id,note_date)`,单个 `admin_id`,自由文本 `content`。
|
||||
- `server/app/adminapi/logic/tcm/TrackingNoteLogic.php:26` 的旧入口强制上海当天,不接纳客户端 note_date;`appendForDate()` 第 70 行允许受信服务补历史日期。
|
||||
- 同日追加只改 content,不改变最初 `admin_id`(第 113 行);多人同日追加无法按这张表的 admin_id 还原每个人的操作。文本 `[HH:MM]` 不带操作者,也不是可靠审计字段。
|
||||
- `server/app/common/service/followupaudio/FollowupAudioApply.php:108` 会把经人工审核的音频提取内容按指定历史日期追加到该表。今天录入不代表今天联系;历史 record_date 也不代表录入人在那天服务过。
|
||||
- `getByDiagnosis()` 出错返回空数组(`TrackingNoteLogic.php:138`),读取不到与确实无备注目前不区分。
|
||||
|
||||
可作为待核对的辅助记录,展示日期和来源。不能用“今天有一条备注”自动判完成,更不能从文本中的“已联系”判断真实完成。
|
||||
|
||||
### 5. unserved_days 不是未联系天数
|
||||
|
||||
- `server/app/adminapi/lists/tcm/DiagnosisLists.php:452`:取血糖、饮食、运动未删除记录的最大 `record_date`;第 482 行 `floor((now-last)/86400)`,没有记录则 null;不含 IM、电话、跟踪备注。
|
||||
- `server/app/adminapi/logic/tcm/DiagnosisLogic.php:4323` 的详情同类计算。
|
||||
- `BloodRecordLogic.php:23`、`DietRecordLogic.php:10`、`ExerciseRecordLogic.php:10` 接受并转换记录日期;`FollowupAudioApply.php:112` 也可补历史数据。
|
||||
|
||||
它只说明“多久没有这三类生活/测量记录”,不证明哪个医助何时与患者联系,且不是显式自然日任务规则。不能把 null 当 0 或全部未维护,也不能凭空设为超过 N 天就今日必须联系;N 天、适用患者与节假日规则需业务定义。
|
||||
|
||||
### 6. 已有服务动作可复用执行状态,但不是专门的联系任务
|
||||
|
||||
- `server/sql/1.9.20261109/01_assistant_service_tables.sql:63` 的 `assistant_service_action` 有 `diagnosis_id/job_id/action_key/todo_id/assignee_id/content/due_at/business_state/completion_note/completed_at`。
|
||||
- `server/app/adminapi/logic/tcm/AssistantServiceLogic.php:278` 的 `adoptAction()`:用户采纳 AI 建议后才生成动作与待办,负责人来自明确的分析目标或操作者;限制旧负责人不能再被分派当前患者。AI 建议本身不是已存在任务。
|
||||
- 第 341 行 `completeAction()`:执行人或有 reviewQuality 权限的主管人工修改状态;完成和取消都要求说明,**两者都填写 completed_at**。必须同时检查 `business_state='completed'`,不能仅判断 `completed_at>0`。
|
||||
- 完成会取消仍待发送的提醒,不把已发送当完成(第 364 行)。通知状态与执行状态已经分离,应该沿用。
|
||||
- 表中尚无 `action_type/contact_outcome/contacted_by/evidence_type/evidence_id`;任意服务动作完成不必然等于联系患者,且实际完成操作者未单独存字段。
|
||||
- `AssistantServiceTeam.php:126` 汇总待办存量、逾期存量和近 30 天完成**动作数**,不是今日应联系**患者人数**。`assigned_cases` 也按诊单计数(第 34 行)。
|
||||
|
||||
本次检索 `server/app`、`server/sql`、`admin/src`、`docs`,没有找到名为 `scheduled_followup` / `scheduled followup` 的独立领域表或实现;“计划随访”目前最接近上述 `due_at` 人工采纳动作和 `remind_time` 普通提醒。不能在方案里把 scheduled_followup 写成现有实体。
|
||||
|
||||
## 联系证据的可靠层级
|
||||
|
||||
| 来源 | 能证明什么 | 是否可直接计完成 |
|
||||
| --- | --- | --- |
|
||||
| IM 已归档、账户对可靠的医助出站消息 | 某账户在某时给该患者发过文字 | 若业务明确“一条有效出站人工消息即完成”,可作为系统记录;不能声称患者已读/已成功沟通 |
|
||||
| 患者单方面入站消息 | 患者发过消息 | 否 |
|
||||
| 明确人工联系登记/复诊 contact 事件 | 操作者确认联系及时间 | 可标记人工确认,需保留真实联系人、代录人和来源 |
|
||||
| 普通人工 service_note/verified_transcript | 某人录入了一份记录/核对转写 | 否;录入人不等于实际服务人员 |
|
||||
| tracking_note、测量/饮食/运动记录 | 有业务资料更新 | 否 |
|
||||
| action.completed | 某项服务动作人工确认完成 | 仅当动作被明确标为联系任务且记录联系结果;现有泛化动作不自动等同 |
|
||||
| 模型结论、AI 质检 met、建议动作、自动分析任务 ready | 分析结果或建议 | 否 |
|
||||
| 提醒已发送、延迟、自动挂号/面诊关闭 | 通知状态或其它业务事实 | 否 |
|
||||
|
||||
IM 复用位置:`AssistantServiceContext.php:60` 同时核验 `patient_id`、`patient_{id}`、`doctor_{adminId}` 的双向配对,并把出站标为 service;`AssistantServiceStaff.php:47` 已有出站聚合。`AssistantServiceContext.php:122` 明示仅已归档文字,不代表完整历史,企微存档和音频未接入。不要把“未查到”说成“确定没有联系”;页面应解释“未发现符合口径的联系记录”。模型生成回复不算,只有实际发送并归档的消息才可进入候选证据。
|
||||
|
||||
`server/app/api/controller/ImController.php:20` 接收腾讯 `C2C.CallbackAfterSendMsg`,第 32 行起校验签名。该回调可支持“已发送”的事实,但账号归属本身不足以证明一定是人手动发送;`server/sql/1.9.20260507/add_tcm_im_chat_message_table.sql:5` 的基础表没有专门的人工/自动发送分类。若规则要求人工主动维护,需要补充发送来源标识或人工确认,不能把未知来源的账号消息全部自动判完成。
|
||||
|
||||
## 最小建议方案
|
||||
|
||||
### A. 明确首版业务口径
|
||||
|
||||
建议首版默认候选范围为“当前可见有效患者中,明确标记的今日计划联系任务 + 复诊到期未挂号/过号患者”。同时显示每条纳入原因。不要把所有在管患者都设为每日一次;不要静默将所有自由文本提醒、所有服务动作纳入。
|
||||
|
||||
需要在产品规则中明确以下选择,代码无法推断:
|
||||
|
||||
1. 日常维护频次与人群:每天所有在管患者,还是按计划/复诊节点;预警提前 3 天是否也需要联系。
|
||||
2. 超期任务是否每日继续纳入;承诺复诊日当天是否需要联系(与旧 `<today` 口径不同)。
|
||||
3. “联系完成”是已发出、患者回复、接通、完成某项服务,还是尝试联系即可;无人接听、拒绝、失联应分别记录,不能默认完成。
|
||||
4. 同一患者有多个诊单/多个医助时,以患者去重还是服务关系计数;主管代联系如何归属;中途转移患者责任如何处理。
|
||||
|
||||
方案可以先把上述建议默认值写入规则版本供评审,实施前不伪装为已有共识。
|
||||
|
||||
### B. 新增最小的当日任务与联系证据,而不是修改通知状态
|
||||
|
||||
推荐新增轻量日任务/证据记录,避免扩展 `DiagnosisTodo.status` 语义:
|
||||
|
||||
- 日任务:`task_date`、`diagnosis_id`、`patient_id`、`assignee_id`、`rule_version`、纳入原因及来源 ID、`created_at`、当前任务状态、变更原因/归属变更轨迹。按日期+服务对象+执行人做幂等唯一键;同一条任务可关联多个到期原因。
|
||||
- 联系证据:实际 `contacted_at`、实际 `contacted_by`、代录 `recorded_by/recorded_at`、渠道、结构化结果、`source_type/source_id`、补记标志、与任务关联。系统 IM 证据幂等,人工登记可复核。最小方案可合并存储,但不能丢实际联系人/代录人/来源。
|
||||
- 若首版只采用已有人工 service action,也要加明确联系类型和完成证据字段;不能直接把旧 completed 动作批量当联系完成。旧已联系复诊事件作为兼容来源,标记其人工确认与日志覆盖限制。
|
||||
- 生成/刷新任务由独立定时/明确刷新动作处理;主管 GET 查询只读,不调用 AI,不触发推送。不要复用有写副作用的复诊 `pending()` 或默认 `self_heal=true` 的列表方法。
|
||||
|
||||
固定当日责任集合,再计算完成,避免联系后设置 promised_date 导致分母消失。新增患者/日内改期/转医助只做有记录的增补或转移;取消/失效单列“已豁免”,不要直接删历史或当完成。若只做实时看板、不建快照,必须标为实时待处理而不能称稳定的今日完成率/历史日报。
|
||||
|
||||
### C. 人数和下钻采用同一规则
|
||||
|
||||
以 `Asia/Shanghai` 的 `[当天00:00, 次日00:00)` 做所有时间戳查询;`task_date/note_date` 显式传同一个日期。现有 PHP 默认是上海(`server/config/app.php:16`),复诊 SQL 用 MySQL CURDATE;新接口不要假设数据库 session timezone 与 PHP 恒相同。
|
||||
|
||||
- `今日应维护`:当日有效责任集合中按约定患者键去重数。
|
||||
- `今日已维护`:应维护集合内,存在符合规则、当天发生且归属正确的联系证据的患者数;其他临时联系单列“额外联系”,不要扩大分子。
|
||||
- `今日未维护 = 今日应维护 - 今日已维护`;若是“每个联系任务都完成”口径,则同患者多任务需全部满足后才计已维护,不能让一条无关出站消息清掉全部服务要求。
|
||||
- 同一患者多诊单须明确合并。`patient_id>0` 可作真实患者键;缺映射时以 diagnosis_id 做待核实服务对象,不能把所有 patient_id=0 合成一个患者;更不能用姓名/电话猜测合并。
|
||||
- 未维护下钻返回诊单链接、患者名、责任医助、应联系原因、到期时刻、最近联系证据及状态、规则日期与数据更新时间。按风险/超期排序;点击必须重校验患者域,不能仅信前端 assistant_id。
|
||||
- 今日无任务显示 0/0/0、“今日暂无应联系患者”,完成率显示 `—`,不显示 100% 或“全部完成”。
|
||||
|
||||
### D. 权限沿用医助服务模块的双重范围
|
||||
|
||||
- `AssistantServiceAccess.php:32` 重新读取启用账号、有效角色、菜单权限;第 67 行 `assistantRows()` 取有效医助角色且排除管理角色;第 151 行 `visibleStaffIds()` 一线固定本人、主管按 DataScope、root 可全部。
|
||||
- `AssistantServiceAccess.php:121` 的 `patientQuery()` 只取未删除启用诊单并应用 MyPatientLogic 范围。应使用“员工可见集合 ∩ 患者可见集合”,汇总、明细、证据读取、导出均一致。
|
||||
- 不能照搬 `RevisitDueLists.php:127` 仅按快照持有人过滤而忽视实时诊单范围;不能照搬旧 `DiagnosisTodoLogic::detail()` 的宽松读取;旧 `RevisitDueLogic::canViewRow()` 在 DataScope 未启用时不收窄,医助服务的新规则更严格。
|
||||
- 当前归属 `tcm_diagnosis.assistant_id` 与任务责任 `assignee_id`、历史真实服务者不同。转移后重新核验当前访问权;历史统计保留当日责任及实际联系人,不以今天的负责人改写昨日服务归属。
|
||||
|
||||
## 空数据、缺表、异常
|
||||
|
||||
现状:`AssistantServiceLogic.php:572` 检查模块五张表字段,不就绪抛“请先执行模块迁移”;`capabilities()` 的 ready 同时受模型配置影响。复诊 `buildListPayload()` 在缺表/异常时降级 none(`RevisitDueService.php:352`),`buildSummary()` 异常保留零(`RevisitDueLogic.php:1036`);复诊主管列表本身没有统一缺表兜底。旧行为适合部分展示,不足以支撑完成考核。
|
||||
|
||||
新增今日核查应区分:
|
||||
|
||||
- **可读且确实空**:数字为 0、列表空,显示没有任务/记录。
|
||||
- **未接入/缺表缺字段/查询失败/快照未生成**:状态为 unavailable/not_ready,关键数字为 null 或整体暂不可用;显示来源说明,不能回落 0 造成“人人完成”。
|
||||
- **部分来源可用**:可以展示确定的人工计划结果,但标记 coverage/incomplete;不能宣布全队“全部完成”或自动认定未记录人员失职。
|
||||
- **无数据权限/无可见医助**:正常空视图,不泄露范围外总数、名字或候选 patient_id。
|
||||
- **AI 未配置或不可用**:不影响确定性今日核查。拆出 `daily_contact_ready`/来源覆盖状态,不能沿用 `capabilities.ready=false` 把无模型的联系统计禁用。
|
||||
|
||||
## 回归要点(实施阶段)
|
||||
|
||||
1. 时间:上海午夜前后、结束时刻排除、MySQL 时区不同、历史补录、未来日期、今日任务提前完成是否计入。
|
||||
2. 状态:通知成功/失败/未绑定均不改业务完成;completed_at 非零但 state=cancelled 不计;人工关闭/延迟/挂号不计联系;旧 AI met/ready 永远不直接计完成。
|
||||
3. 复诊:到期/超期/过号、承诺日今天与未来、无天数、人工关闭、失效、新订单、快照过时;联系后分母不下降。
|
||||
4. 证据:重复 IM 回调只计一次、患者入站不计、账户不配对不计、空消息不计、代理操作者与真实联系人区分、无记录与来源不可读区分。
|
||||
5. 归属:同日转医助、主管代录、旧执行人失去患者权限、多医助同患者、多诊单、patient_id=0、患者停用/删除。
|
||||
6. 权限:跨部门 assistant_id/diagnosis_id 篡改、汇总/分页/下钻一致、管理员禁用/角色变化、普通医生不能扩大到全员、来源详情权限重新检查。
|
||||
7. 数据:每人应维护=已维护+未维护(按同一有效集合),患者重复不多计、0 分母不为 100%、缺表不报 0、增量刷新幂等、取消/改期可审计。
|
||||
8. 性能与副作用:批量聚合避免按患者 N+1;大列表分页不改变汇总;GET 不发模型/企微、不创建任务、不自愈写表;新计数不依赖最近 30 天或 UI 的 20 条弹窗限制。
|
||||
|
||||
仓库实际已有测试文件,可在后续实现时扩展:`server/tests/AssistantServiceTeamTest.php`、`AssistantServiceStaffTest.php`、`AssistantServiceApiTest.php`、`AssistantServiceReminderRecipientTest.php`、`RevisitDueCalculatorTest.php`、`RevisitDueLogicTest.php`、`RevisitDueNotifyTest.php`。本次仅研究,未运行依赖数据库或服务的测试。
|
||||
@@ -0,0 +1,182 @@
|
||||
# 今日联系执行:UI / API / 权限集成研究
|
||||
|
||||
日期:2026-11-10。研究范围为现有医助服务模块,不决定“今日应联系”及“完成维护”的业务来源与规则;这些规则须采用主代理的业务来源核查结果。本文未改源码,未运行测试、访问业务数据库、读写 `.env`、调用模型、联网或启停服务。
|
||||
|
||||
已读项目 `AGENTS.md`、`CLAUDE.md`、`automatic-team-contract.md` 及当前 UI / API / Access / Team / Staff / 测试代码。当前 checkout 没有 `.trellis/workflow.md` / `.trellis/`,无法读取该处附加规范。
|
||||
|
||||
## 建议结论
|
||||
|
||||
最小集成路径是:保留一个“医助团队总览”,把“今日应联系、今日已完成、今日未维护”放到每名医助行的主要位置;点击“未维护 N 人”或医助行,直接在现有右侧抽屉展示该医助的今日未维护患者。继续在同一抽屉查看近 30 天质检、跟进和原文,不增加逐人选择器,不要求主管手动分析。
|
||||
|
||||
今日执行使用已确认业务规则的确定性查询。现有 AI 自动分析仍负责近 30 天服务质量。两者有各自清楚的时间与状态,不用模型任务完成状态替代联系完成状态。
|
||||
|
||||
当前没有可直接改名成这三个指标的字段:
|
||||
|
||||
| 现有字段 / 接口 | 当前实际口径 | 不能直接复用的原因 |
|
||||
| --- | --- | --- |
|
||||
| `metrics.assigned_cases` | 当前可见、当前负责的诊单存量 | 不是今日应联系患者数,且单位是诊单 |
|
||||
| `metrics.im_messages` | 近 30 天可靠账号配对的本人已归档文字发言数 | 是消息条数,不是今天完成联系的人数;结构未接入返回 `null` |
|
||||
| `metrics.analyzed_cases` | 同一 30 天范围内来源有效的已分析诊单 | 表示模型质检完成,不表示医助今天已维护 |
|
||||
| `pending_actions` / `overdue_actions` | 已采纳服务跟进中的全部未结存量 / 已过截止时间 | 是事项数,可能同一患者多项,也不是全部今日应联系集合 |
|
||||
| `completed_actions` | 所选期间完成的服务跟进事项数 | 既不是患者去重数,也不是当天完成联系的统一凭据 |
|
||||
| `staffCases` | 当前负责,或期间有本人可靠对话 / 登记的关联诊单 | 可能含无任何新来源的当前负责诊单;无法作为今日应联系名单 |
|
||||
| `staffIssues` | 有效质检中未复核或确认的疑似遗漏 | 未维护不等于质检遗漏 |
|
||||
|
||||
主要依据:`AssistantServiceStaff.php:32,88,115,132`;`AssistantServiceTeam.php:13,81,126,143`。
|
||||
|
||||
## UI 复用位置与具体行为
|
||||
|
||||
现有工作台位于 `admin/src/views/assistant_service/workbench/index.vue`。页面已采用团队表格、医助搜索、筛选、分页、侧边详情;抽屉组件是 `StaffDetail.vue`,详情内嵌 `CaseDetail.vue`,无需新页面 / 新路由 / 新菜单。
|
||||
|
||||
建议首页调整:
|
||||
|
||||
1. 页首改为“医助团队总览”,下方明确“今日执行 · YYYY-MM-DD”,日期使用服务端业务日期。顶部 3 个主要指标为应联系 / 已完成 / 未维护;原 30 天自动分析状态和质量指标作为清楚标注的次级区域保留。
|
||||
2. 每名医助行优先列出今日 3 个数,未维护数是可聚焦、可点击的按钮;缺数据用“暂不可用 / 口径待接入”,不能默认为 0。保留“近 30 天待复核”等少量次要提示及“服务质检”入口;避免把所有旧列与新列全部平铺造成横向拥挤。
|
||||
3. 默认全部医助,新增“今日有未维护”筛选。旧 `issues / overdue / attention` 的含义不要暗中改变;这些仍属于原质检/跟进筛选。若需要减少筛选项,可在标注清楚的次级区展示旧筛选。
|
||||
4. 点击未维护数,现有抽屉直接定位“今日未维护”视图,不先要求点选另一个医助或诊单。患者行展示姓名、必要的脱敏识别信息、今日应联系原因、当前执行状态,以及可追溯的相关记录入口。仅显示业务核查确认存在且可信的“最后联系时间”等字段。
|
||||
5. 抽屉保留今日应联系 / 已完成 / 未维护三个小计;默认未维护名单,可在需要核对时切换状态。此处名单按患者展示,不能直接以 `diagnosis_id` 为行键把同一患者重复显示。具体去重规则、未映射患者处理及跨医助责任规则须先由业务研究确定。
|
||||
6. “服务质检”入口可将同一抽屉定位到原 `issues` 页;原“跟进执行”“关联沟通记录”“服务质检汇总与资料说明”继续可用。点击患者记录继续嵌入 `CaseDetail`,返回后保留今日名单筛选、页码、滚动位置。
|
||||
7. 无应联系任务时显示“今日无需联系患者”;应联系集合全部完成时显示“今日应联系患者已全部完成”。来源缺失 / 规则不可用 / 接口失败各用明确文案,不能合并成“全部完成”。
|
||||
|
||||
现有窄屏断点是 `<=1100px`(`index.vue:317`),抽屉窄屏为 100% 宽。今天的 3 列须优先保留,旧质量细项进入同一抽屉或次级区域;需复测约 804px 宽度,避免固定左右列挤掉未维护按钮。
|
||||
|
||||
`StaffDetail.vue:250,271,283` 当前只有 `staff / capabilities / refreshKey` 三个 props,且每次医助改变都会重置 `activeTab='issues'`。建议补一个显式初始视图参数,如 `initialView: 'daily' | 'issues'`,开抽屉时决定入口,静默刷新不可重置该值。同一医助已打开时从另一入口进入,应显式切换视图,不能只依赖 `:key=staff.id` 触发重建。
|
||||
|
||||
注意当前整个详情主体放在 `overview && !overviewError` 下,`loadOverview()` 失败还会清空正在查看的病例。今日名单应有独立加载 / 错误边界,不能因 30 天质检接口暂时失败而隐藏今日执行数据。可新增一个小的 `DailyContacts.vue` 放到现有抽屉/StaffDetail;这比把今日逻辑塞入 CaseDetail 更清楚。
|
||||
|
||||
## 最小 API 方案(待业务来源确认后冻结字段)
|
||||
|
||||
推荐沿用 `GET teamOverview`,给响应增加独立的 `daily` 元数据、汇总和每医助小计;保留顶层 `days:30` 与原 `summary / automation / metrics` 的原含义。这样首页仍是一轮请求,也不破坏旧代码对 `days===30` 的验证。
|
||||
|
||||
示意结构仅是集成契约提案,不代表已有业务规则:
|
||||
|
||||
```ts
|
||||
interface DailyCounts {
|
||||
due_patients: number | null
|
||||
completed_patients: number | null
|
||||
pending_patients: number | null
|
||||
}
|
||||
|
||||
interface DailyScope {
|
||||
business_date: string
|
||||
timezone: string
|
||||
as_of: number
|
||||
state: 'ready' | 'unavailable'
|
||||
reason: string
|
||||
// 仅在业务来源和完成口径已经确定、完整可用时返回 ready。
|
||||
}
|
||||
|
||||
// teamOverview 的新增字段:
|
||||
daily: DailyScope & { summary: DailyCounts }
|
||||
// lists[i] 的新增字段:
|
||||
daily: DailyCounts
|
||||
```
|
||||
|
||||
如果来源只部分可靠,应补显式 `partial/unknown` 状态或未确认数量,不能一方面标 `ready`,另一方面把“尚未找到完成证据”无条件计为员工未维护。是否需要这种状态,取决于业务来源核查。
|
||||
|
||||
新增一个按医助读取明细的 GET,例如 `staffDailyContacts`:
|
||||
|
||||
- 参数:必填 `assistant_id`;可选 `status= pending|completed|all`(默认 pending)、患者 `keyword`、`page_no`、`page_size`,页大小沿用上限 50。MVP 固定服务端“今天”,不引入日期区间或历史筛选需求。
|
||||
- 返回:`staff`、`daily`(包含业务日期、截止时刻、可用状态)、当前该医助全部今日小计、标准分页 `lists/count/page_no/page_size`。`count` 是当前状态/搜索条件下匹配患者数,不能拿它代替该医助总应联系人数。
|
||||
- 每行至少包含稳定的患者责任键、`patient_id`、`patient_name`、必要的脱敏信息、当前 `state`、可核验的应联系原因以及用于原文核查的授权诊单引用。若一名患者有多个触发依据,可合并在该患者行内;不把每项触发依据当作一个患者。
|
||||
- 统计与明细必须复用一个业务集合 / 计算服务,保证同一医助、同一日期、同一权限范围的小计与名单一致。分页前去重,不能只在单页去重。
|
||||
- `completed` 只从“今日应联系集合”中产生;今天额外联系的其他患者不应让完成数大于应联系数。是否允许其他医助代维护、转派如何归属等必须用已确认规则。
|
||||
- 团队总计继续对应 keyword 下全部授权医助,不受列表筛选或分页缩小,沿用当前 `Team::overview()` 汇总先于 filter/page 的约定。若同一患者可归属多个医助,总计究竟按责任对求和还是全团队去重,需要业务契约明确,不能前端偷偷决定。
|
||||
|
||||
实现位置建议:
|
||||
|
||||
| 文件 | 最小改动 |
|
||||
| --- | --- |
|
||||
| `AssistantServiceTeam.php` | 使用已授权 staff 与可见患者范围聚合今日计数,再附到每行;不要对每名员工重复跑一次全量明细查询 |
|
||||
| 新 `AssistantServiceDailyContact.php`(命名可调整) | 封装今日业务日期、应联系集合、完成证据、患者级去重、聚合和明细,共用一个定义 |
|
||||
| `AssistantServiceLogic.php` | 薄入口接入团队统计与新明细;全部只读 |
|
||||
| `AssistantServiceController.php` | 补新 GET action,沿用 `handle()` |
|
||||
| `AssistantServiceValidate.php` | 新 action 参数白名单、必填正整数 assistant、状态枚举、搜索长度与分页上限;若新增团队筛选,一并显式允许 |
|
||||
| `AssistantServiceAccess.php` | 新 action 小写映射到 `view`;不创建新权限、不扩大角色或员工域 |
|
||||
| `admin/src/api/assistantService.ts` | 补类型及带 `AbortSignal` 的 GET 包装,使用现有统一 request |
|
||||
| `workbench/index.vue` | 增加今日指标/列/筛选与抽屉入口 |
|
||||
| `StaffDetail.vue` / 小型新组件 | 今日名单、独立状态和请求取消;复用原 CaseDetail 核查路径 |
|
||||
|
||||
当前 API 的严格参数验证会拒绝未知字段,不能只让前端先传 `date/status/filter` 而不调整验证器。新 action 必须登记 `Access::permissionForAction()`,不能依赖全站对未登记路由的兼容行为。
|
||||
|
||||
此方案只是展示与读取,可以复用 `view`,原则上不需要新菜单迁移。只有业务研究证实必须新增存储时才判断新表;不能为了报表先新增一套人工维护任务源。
|
||||
|
||||
## 权限与安全边界
|
||||
|
||||
`AssistantServiceAccess.php` 的规则应原样复用:
|
||||
|
||||
- `actor()` 每次读取当前启用账号、有效角色、启用菜单;非 root 同时要有模块 `view` 及目标操作权限。角色已删除留下的旧菜单授权不生效。
|
||||
- `assistantRows()` 的目标是有效医助角色:role ID 2 或角色名为“医助”,并剔除同时拥有现存管理角色 3/7/8 的账号、root、停用或已删除账号。目标医助不必持有模块菜单;这是主管查看自己的员工,不是借目标账号权限执行请求。
|
||||
- root 的员工域不限;管理角色 3/7/8 使用当前 `DataScopeService`;一线非管理人员固定只能看自己,不能利用普通医生的 ALL 范围看到其他医助。
|
||||
- 每个统计 / 明细同时与操作者 `patientQuery()/applyScope()` 的患者域相交。当前实现要求诊单 `status=1` 且未删除,并委托已有 `MyPatientLogic` 应用角色患者规则。不能只验证医助归属就返回其全部患者。
|
||||
- 员工、患者权限变化必须立即生效;`assertRoleSnapshot()` 与部门快照检查在旧事务快照不可信时会拒绝并要求重试。新服务不能跨请求缓存 actor、授权员工或患者域。
|
||||
- 点开未维护患者仍应由服务端重新检验患者和医助;不能把前一刻团队名单作为永久授权。新接口回复应带医助与日期,前端拒绝不一致的旧/错误响应。
|
||||
- 当前医助归属与历史来源作者是两个概念;不能以现在的 `assistant_id` 推断过去谁发过消息、谁完成了维护。既有质检已坚持来源作者归因,今日完成判定同样需要明确证据规则。
|
||||
|
||||
参考行:`AssistantServiceAccess.php:20,33,69,91,123,137`;新明细必须走这条链路,不能使用全量 `Db::name('tcm_diagnosis')` 绕过患者域。
|
||||
|
||||
## 自动更新与模型边界
|
||||
|
||||
当前主页 `index.vue:377,408,469,480`:每次请求结束后安排 30 秒静默刷新;窗口隐藏或组件停用暂停;重新显示立即刷新。请求使用 `AbortController` 与递增 revision,丢弃旧搜索 / 旧分页响应。搜索输入草稿与已提交关键字分开,静默刷新保留分页、筛选、抽屉和输入。
|
||||
|
||||
当前明细 `StaffDetail.vue:283,309,414,463`:医助改变时先取消所有请求并同步清空上个医助的数据;独立 overview/cases/issues revision;父级成功刷新后 `refreshKey` 驱动详情静默刷新,并保留当前 CaseDetail / 标签 / 搜索草稿 / 页码。今日名单应接入这一刷新路径,使用独立请求 token,不另加无限轮询计时器。
|
||||
|
||||
主页数据读取失败会清空团队数据和抽屉,因为可能是权限变化;今日数据不能在这种失败后继续保留敏感旧名单。若只是一块业务来源不可用,应通过响应中的该块 `state` 明确表达,避免把质量服务故障与整个账号失去权限混为一谈。
|
||||
|
||||
业务日期、时区、`as_of` 必须由服务端返回。跨午夜刷新时,总览和名单必须换到相同新日期;迟到的昨天响应不能覆盖今天。当前 `updatedAt` 只是浏览器收到响应的时间,不能充当统计日期或数据截止时刻。
|
||||
|
||||
独立自动分析当前按近 30 天来源、60 秒扫描、5 分钟安静期执行,跟页面 30 秒刷新不是同一机制。新增今日统计不需要等模型完成,也不调用 `analyzeStaff` / `analyze`,不产生 job,不在 GET 内远程同步聊天。当前 `capabilities.ready=false` 时只提示 AI 配置问题;只要 `view` 与 `schema_ready` 就会加载团队。今日确定性统计也不应额外受 `ready/modelReady` 限制。
|
||||
|
||||
## 测试与夹具约束
|
||||
|
||||
仓库文档 `CLAUDE.md` 的“没有单测框架”已落后于此模块实际情况:当前存在独立 PHP 测试脚本与 Node 内置 test 行为测试,应复用现有测试,不新建 Jest/Vitest/PHPUnit 框架。
|
||||
|
||||
PHP 测试:`server/tests/AssistantServiceTeamTest.php`、`AssistantServiceStaffTest.php`、`AssistantServiceTeamCoverageTest.php`、`AssistantServiceApiTest.php` 均使用真实 ORM / 业务 / Access,创建 SQLite `:memory:`,不初始化正式应用配置、不读 `.env`、不联网。测试直接声明最小表结构,当前 `tcm_diagnosis` 只有 id/patient_id/assistant_id/patient_name/phone/status/delete_time;没有任何已证明的今日排期字段。若今日规则使用别表或新字段,必须补到所有会执行新统计查询的夹具。不能为了让旧夹具过关把缺列吞掉返回 0,也不能把真实权限实现换成 stub。
|
||||
|
||||
现有 PHP 关键断言需保留:
|
||||
|
||||
- 授权员工域、患者域同时收敛;普通医助只见本人;普通医生不收到团队行;root 只见有效医助;命名医助角色、无目标菜单、删除/停用账号正确处理。
|
||||
- keyword 作用于整体汇总;filter/page 不缩减整体汇总;空的后续页仍有准确总计。
|
||||
- 同患者多诊单不会重复计 IM;患者换绑、跨诊单动作绑定、跨团队 subject 不混入数据。
|
||||
- GET 不入队;队列、来源变更、最新复核、质检去重等旧 30 天行为不回归。
|
||||
|
||||
前端测试 `admin/tests/assistant-service.test.cjs` 用 `@vue/compiler-sfc` 编译真实 SFC 并运行 setup,API 返回合成值,测试实际的 revision、取消请求和 Vue 响应;不是浏览器截图测试,也不是完整 DOM 挂载。新增 API 必须补 `workspaceApi()` mock(约 705 行)、`teamStaff/teamOverview` 夹具(约 647/663 行)及专用今日明细夹具;否则会因新增依赖未提供而失败。`setup()` 对未知 import 会报错,若新建 composable 必须同步补依赖路由,不能改成放行所有未知 import。
|
||||
|
||||
建议新增的有意义回归:
|
||||
|
||||
1. 今日 3 个数来自同一患者集合:多诊单、多条消息、多条触发记录不会重复;非应联系患者的额外联系不会抬高完成数。具体有效来源组合依业务研究。
|
||||
2. 未维护名单总数与相同日期/权限/筛选口径的统计对应;统计分页前去重;分页不缩减小计。
|
||||
3. 零应联系、全部完成、来源不可用、来源部分不可确认、读取失败等状态不混淆。
|
||||
4. 旧员工响应不能覆盖新员工;错误医助/日期响应被拒;权限撤销立即隐藏旧数据。
|
||||
5. 跨午夜切换;迟到的旧日期响应被丢弃;当前搜索草稿、名单分页、抽屉和原文输入在同一天静默刷新后保留。
|
||||
6. 点击未维护直接到目标名单;“质检”直达原 issues;从 CaseDetail 返回保留未维护上下文。
|
||||
7. 首页、今日名单和自动刷新均不调用模型或创建任务;AI 未配置时仍能读取确定性今日数据。
|
||||
8. 完成依据发生变化时下一次刷新更新总数和名单;不自动替主管提交质检决定、手工标完成或发送消息。
|
||||
|
||||
可沿用的验证命令(本次研究未执行):
|
||||
|
||||
```text
|
||||
cd admin
|
||||
node --test tests/assistant-service.test.cjs
|
||||
|
||||
cd server
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceTeamCoverageTest.php
|
||||
php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php
|
||||
```
|
||||
|
||||
新建今日业务测试应沿用同样内存隔离,并测试日期边界和实际业务规则,不连接业务库。必要时使用可注入的 `now` 或明确构造服务端日期窗口;不要让测试随着执行时间随机跨日失败。
|
||||
|
||||
浏览器已有隔离预览:`artifacts/medical-assistant-feature-plan/ui-preview.mjs` 将真实 `@/utils/request` 替换为 `staff-ui-fixture.mjs`,UI 明确标识“合成资料,不连接业务接口或模型”。如主代理后续进行浏览器验收,应同时补该夹具的 teamOverview 和新明细 action;它不会自动使用 Node 测试夹具。此次研究未启动预览。
|
||||
|
||||
已有 `automatic-validation.md` 记录过前端 29 项、Staff 90、Team 58、TeamCoverage 24、API 76 断言通过;这是历史记录,本次没有重跑,不当作当前新需求已验收。既有类型检查报告存在其他模块错误;实施后只可据实际输出报告全量状态。`npm run build` 包含 `scripts/release.mjs`,普通验证不要误触发布步骤;如需构建,用已有主代理安排的直接 Vite 构建路径。
|
||||
|
||||
## 实施前必须由业务研究明确的窄边界
|
||||
|
||||
- 哪些可核查字段 / 规则确定“今天应联系”,哪些记录确定“已完成维护”;资料缺失时能否判未维护。
|
||||
- 业务日的时区与开始/结束边界,以及今天前已逾期是否进入今日应联系。
|
||||
- 计数按患者还是诊单;同患者多诊单、未映射 patient_id、重复任务如何归并。
|
||||
- 当前负责人、当日计划责任人、实际完成者的关系;代维护和当日转派如何处理。
|
||||
|
||||
这些定义一旦确定,UI/API 可按上面的路径接入;不能借现有 30 天统计名称替代业务定义。
|
||||
@@ -0,0 +1,61 @@
|
||||
# 医助今日联系任务验收
|
||||
|
||||
2026-11-10,D:/web/zyt 本地工作区。新增功能面向主管按医助核查当天应维护患者、联系记录及未完成名单;保留原自动 AI 服务分析。
|
||||
|
||||
## 实现结果
|
||||
|
||||
- 团队页优先显示今日应维护、已联系、待维护、人工登记待核实;点击医助的待维护/待核实人数直接打开对应名单。近 30 天质检收拢为可展开摘要,仍可直达原质检界面。
|
||||
- 当天责任按医助和患者合并;采用既有有效复诊到期、过号、承诺当日,以及明确需联系的到期服务动作。此前到期仍未关闭的任务会继续纳入,不假设所有患者必须每日联系。
|
||||
- 独立计划进程保留当日分母,联系后改约未来日期不会让已纳入任务消失;真实取消、转交、周期失效保留豁免原因。无任务、部分扫描、资料缺失和全部已有记录分别展示。
|
||||
- 自动判定联系依赖严格账号配对的当日已归档发出文字;本人手动登记单列待核实,主管代操作不冒充医助本人。电话、外部企微未接入,未发现系统记录不能证明从未联系。
|
||||
- 日报 GET 只读;不生成模型任务、不发送消息、不改变既有诊单通知状态。模型分析与今日联系计划独立运行。
|
||||
|
||||
## 自动化验证
|
||||
|
||||
| 验证 | 结果 |
|
||||
| --- | --- |
|
||||
| DailyContact 核心内存测试 | 修复后 55 断言通过,使用真实 ThinkPHP ORM、权限服务、文件锁 |
|
||||
| Team / API / Staff / TeamCoverage | 76 / 124 / 93 / 24 断言通过,Team 在最终修复后再通过一次 |
|
||||
| 前端真实 SFC/setup 测试 | 40 / 40 通过,覆盖跨日、请求取消、筛选分页、权限清理、质量接口独立失败 |
|
||||
| MySQL 5.7 增量迁移 | 独立 15339 端口、指定可丢弃目录,10 断言通过;迁移重复运行 3 次 |
|
||||
| MySQL 流程/并发回归 | 46 断言通过,2 个并发进程,无模型调用 |
|
||||
| PHP 语法 | 变更文件检查通过;最终证据读取修复后再次检查通过 |
|
||||
| 直接 Vite 构建 | 成功,3 分 52 秒,输出 `.spool/assistant-daily-build`,没有运行 release |
|
||||
| 全量 vue-tsc | 退出码 2,110 行诊断位于其他模块,未出现本模块路径;不宣称全项目类型检查通过 |
|
||||
|
||||
独立复核发现 IM 发件账号比较依赖数据库不区分大小写排序规则的问题,已增加 PHP 严格账号匹配和目标医助集合检查。新增 NOCASE 回归后通过;原复现脚本输出 NOT_REPRODUCED。详细见 `daily-contact-integration-review.md`。
|
||||
|
||||
## 真实本地库与后台
|
||||
|
||||
审核 SQL:`server/sql/1.9.20261110/01_assistant_service_daily_contact.sql`。
|
||||
|
||||
SHA256:`d97dd55b36536db8af8697baf3c7c2ad9a37e73cbdecc3a7b2f5cf431dafae45`。
|
||||
|
||||
在明确核对目标为本地 `127.0.0.1:3306/zyt` 后执行,仅新增日计划表及 action 的 `contact_required`、`completed_by`。迁移前后原五张模块表记录数一致:job=15,action=0,review=0,record=0,knowledge=0。没有变更账号、角色权限、原患者或订单记录,没有重试既有失败模型任务。
|
||||
|
||||
本地日计划开关启用、扫描主管 id=1、间隔 60 秒。隐藏进程 PID=3780,2026-11-10 10:15:22 启动。原 PHP、Vite、AI worker、自动分析扫描仍运行,进程信息位于 `.spool/assistant-local-processes.json`。
|
||||
|
||||
首轮扫描 500 + 500 + 199 条后于上海时间 10:17:23 进入 ready;下一轮扫描 500 条、创建 0,验证重复运行没有重复计划。
|
||||
|
||||
10:17:30 只读接口验收快照:
|
||||
|
||||
- 可见医助 64 名;今日应维护 1199 人次,已联系 0,人工登记待核实 0,待维护 1199,豁免 0。
|
||||
- 该数字包含此前到期未关闭的计划,且仅反映当前本地数据与接入渠道。它不是对医助未联系行为的最终认定。
|
||||
- 抽样医助待维护 75 人,列表总数、summary 与团队行一致,业务日期一致;API 页大小 20 时返回 20 行。
|
||||
- GET 前后 jobs=15、plans=1199 均不变;主汇总调用约 0.596 秒,峰值内存 24 MB。此为本机单次观测,不是容量承诺。
|
||||
- 自动 AI 分析状态 running;当前已有 12 个完成分析,3 个既有失败任务保留未重试。
|
||||
|
||||
## 浏览器验收
|
||||
|
||||
通过 CUA 在本机浏览器操作真实 Vue 页面:
|
||||
|
||||
1. 隔离合成夹具展示 4 名医助:待维护、人工登记、全部已联系、无任务和豁免状态;总计不被医助筛选缩小。
|
||||
2. 点击待维护人数直达相应患者名单;查看记录进入既有自动分析结果;返回保留今日名单筛选。
|
||||
3. 人工登记直达待核实名单,豁免筛选显示具体原因。
|
||||
4. 804px 窗口下 documentWidth=789、viewport=804,无页面水平溢出;临时尺寸已恢复。
|
||||
5. 真实已登录 admin 工作台从 partial/人数为空自动过渡到 ready/1199;自动分析仍显示已运行。
|
||||
6. 真实医助的待维护 75 人入口展示相同 75 人小计及 10 行第一页;翻至第 2 页仍保持 75 人汇总。
|
||||
|
||||
真实页面入口:`http://127.0.0.1:5560/admin/assistant_service/workbench`,已保留为浏览器交付页。截图 `daily-contact-live-overview.jpg` 为真实汇总;`daily-contact-overview.jpg`、`daily-contact-patients.jpg` 明确使用合成患者,不是业务结果。
|
||||
|
||||
已关闭本次隔离预览服务和经过目录校验的 15339 MySQL 测试实例,保留业务服务。构建生成的声明文件恢复到本轮开始备份,原本干净的 tsconfig.tsbuildinfo 已恢复;没有提交或发布远程。
|
||||
@@ -0,0 +1,47 @@
|
||||
# 医助服务模块前端实现报告
|
||||
|
||||
日期:2026-11-09。实现范围:独立管理后台模块,沿用 Vue 3、TypeScript、Element Plus、现有 request 与 feedback。未修改旧患者巨型页面、动态路由实现、全站样式或全局组件声明。入口由 root 提供的菜单迁移注册。
|
||||
|
||||
## 交付
|
||||
|
||||
- `admin/src/api/assistantService.ts`:全部契约接口及类型;保留业务错误消息和错误码;显式关闭请求自动重试和 URL 级重复请求取消。异步生成提交不随患者切换取消,返回结果按患者会话版本隔离。
|
||||
- `admin/src/views/assistant_service/workbench/index.vue`:授权患者搜索/分页、患者与时间范围选择、来源覆盖、人工录入、场景选择、分析/回复双队列、历史任务查看、待办和复核入口。
|
||||
- `workbench/jobTracker.ts`:每类任务独立状态与 3 秒串行轮询;6 分钟等待上限;隐藏/停用页面暂停;卸载清理;旧患者请求结果丢弃;任务读取失败时隐藏旧可采纳结果。
|
||||
- `components/PatientPicker.vue`:搜索结果分页与请求版本隔离。
|
||||
- `components/SourceTimeline.vue`:原文、来源渠道、时间、员工归因、质检适用性和覆盖缺口。
|
||||
- `components/RecordDialog.vue`:人工服务记录 / 已核对转写、发生时间、显式核对复选框、提交防重。与后端统一采用保守归因,上传者不自动作为历史服务员工。
|
||||
- `components/JobResult.vue`:患者诉求/摘要/待解决事项/标签候选,员工六维服务质检,生成时来源快照定位;版本化采纳到我的待办、未来截止时间、500 字待办内容上限;人工复核及记录;回复编辑与复制,不产生发送状态。
|
||||
- `components/ServiceActions.vue`:执行状态筛选/分页,负责人限制,进行中/完成/取消,终态不可回开,完成/取消必填备注,独立显示提醒发送状态。
|
||||
- `knowledge/index.vue`:权限门禁、问题/分类搜索、状态筛选、分页、创建/修改、保存草稿、显式确认发布/停用。版本冲突保留本地内容,支持复制本地编辑与加载实际最新版本;不会猜测版本号或覆盖其他人的更新。
|
||||
- `admin/tests/assistant-service.test.cjs`:本地 Node 测试,直接编译并执行实际 Vue SFC setup,以合成数据模拟接口交互;不使用生产 fallback。
|
||||
|
||||
## 状态与并发处理
|
||||
|
||||
未配置、未迁移、无权限、空来源、加载、提交失败、排队/运行、生成失败、调用待核实、轮询超时、结果过期均有独立提示。生成提交不盲重试,连接中断后要求查询已提交任务。`needs_reconciliation` 不开放重复生成按钮。
|
||||
|
||||
切换患者、刷新来源时清除旧分析、原文抽屉和历史请求。API 返回结果必须匹配当前诊单;轮询读失败时清空旧结果,过期/查询中结果不可采纳或复制。来源加载失败时不挂载旧待办组件。响应式布局在窄屏下将患者列表与工作区纵向排列,表格保留自身横向滚动。
|
||||
|
||||
## 已执行验证
|
||||
|
||||
在 `D:\web\zyt\admin` 执行 `node --test tests/assistant-service.test.cjs`,11 项通过:
|
||||
|
||||
1. 全部模块 SFC 的脚本、模板和 scoped CSS 编译。
|
||||
2. API 保留业务错误码/原因,关闭自动重试和 URL 级取消。
|
||||
3. 患者切换后的旧轮询响应不能覆盖新任务,卸载删除计时器。
|
||||
4. 轮询超时暂停、页面可见性暂停/恢复、撤权错误隐藏旧结果。
|
||||
5. 实际工作台 setup 的旧 context/提交响应隔离与重复生成防护。
|
||||
6. 实际录入弹窗要求转写确认,重复点击只提交一次。
|
||||
7. 实际结果组件的证据快照定位、未来截止时间检查、过期禁采纳。
|
||||
8. 实际待办组件的负责人/终态判断、提醒与业务完成分离、完成备注必填。
|
||||
9. 实际知识页的版本冲突保留编辑、复制、读取新版本与显式发布。
|
||||
10. 实际回复编辑复制人工修改后的草稿,过期后禁止复制,未触发任何发送事件。
|
||||
11. 实际人工质检复核必填说明,并使用原任务版本与 item_key。
|
||||
|
||||
全量 vue-tsc 基线/新增差异和 Vite 构建由 root 统一执行;本代理未运行 npm run build、发布脚本、全局声明生成、真实模型、生产数据库或消息发送。未完成浏览器视觉验收,最终集成结果以 root 验证报告为准。
|
||||
|
||||
## 接口补充约束
|
||||
|
||||
- 后端说明旧提醒内容上限 500 字,采纳弹窗与提交验证同步限制;过长建议要求人工精简。
|
||||
- `actions.notification_status` 接受旧提醒整数 0/1/2/3 或 null,分别显示待发送/已发送/已取消/发送失败/未安排。
|
||||
- 契约没有 knowledge detail 接口,冲突恢复通过管理知识列表分页定位条目,读取实际版本。正常编辑使用当前列表完整字段。
|
||||
- 只做模块内 UI 权限提示,实际患者域、员工域、采纳和任务更新权限仍由服务端逐次判定。
|
||||
@@ -0,0 +1,76 @@
|
||||
# 医助服务模块首期实现契约
|
||||
|
||||
用户 2026-11-09 已同意方案并要求后台新增独立模块。实现 P0 可用闭环与其必须的知识维护,不实现后续完整培训平台。遵守既有 Vue/ThinkPHP 风格;不访问生产数据库、不调用真实模型/患者发送、不执行发布脚本。所有代理仅读根 AGENTS 与相关源码,.trellis 不存在;不要再派子代理。
|
||||
|
||||
## 所有权
|
||||
|
||||
- backend_api:controller/logic/validate,common/service/assistantservice/AssistantServiceAccess.php、AssistantServiceContext.php,API与数据权限测试。
|
||||
- ai_engine:common/service/assistantservice/AssistantServiceEngine.php、AssistantServiceWorker.php,app/command/AssistantServiceWork.php,引擎与worker测试;不改console/config。
|
||||
- frontend:admin/src/api/assistantService.ts,admin/src/views/assistant_service/ 下全部组件、工作台与知识页、局部测试。不要改现有大页面或路由;模块走动态菜单。
|
||||
- root:SQL迁移、server/config/assistant_service.php、console注册、集成与验收、部署说明。需要改契约先联系root,不能自行改共享接口。
|
||||
|
||||
## 模块和接口
|
||||
|
||||
菜单根路径 assistant_service,子页面 workbench(component assistant_service/workbench/index)、knowledge(component assistant_service/knowledge/index)。独立标题“医助服务”。API controller tcm.AssistantServiceController,url `/tcm.assistantService/ACTION`。后端标准 envelope 经 request 工具转成 data。所有action独立鉴权(旧middleware未登记路由可能放行,不能依赖它)。权限以当前DB的root/角色菜单为准,不信token旧root。
|
||||
|
||||
权限点:view, analyze, draftReply, record, adoptAction, completeAction, reviewQuality, manageKnowledge。所有GET基础数据需要view;管理知识页另需manageKnowledge。read不是临床编辑权。
|
||||
|
||||
- GET capabilities → {enabled:boolean, ready:boolean, reason:string, permissions:string[], scenarios:[{value,label}], limits:{max_manual_chars,max_source_chars}, schema_ready:boolean}。permissions为上述短action名。无需暴露模型凭据。未迁移/模型不可用可读说明,不假成功。
|
||||
- GET patients?keyword&page_no&page_size → {lists:[{diagnosis_id,patient_id,patient_name,phone_masked,assistant_id}],count,page_no,page_size},MyPatientLogic当前数据域。
|
||||
- GET context?diagnosis_id&days(7|30|90 default30) → {patient:{diagnosis_id,patient_id,patient_name,assistant_id},sources:Source[],coverage:[{channel,status,count,note}],source_hash,scope_hash,days,latest_job:Job|null}。
|
||||
- POST record {diagnosis_id,content,occurred_at(int seconds),record_type:'service_note'|'verified_transcript',speaker_confirmed:boolean} → {id}。个人人工录入服务记录;转写需显式确认。记录用于来源,不写病历。
|
||||
- POST analyze {diagnosis_id,days,scenario:'initial'|'followup'|'revisit'} → Job。source_hash/type/scenario/question/knowledge版本/actor组成幂等键,若内容没变复用既有job。无来源拒绝,超限明确要求缩小时间范围。
|
||||
- POST draftReply {diagnosis_id,days,scenario,question} → Job(type reply),与analysis同样异步队列。空知识时返回可解释待补充错误,不能编造院内FAQ。
|
||||
- GET job?id → Job,重新校验当前患者权限,来源版本变化标stale,结果只读。
|
||||
- GET jobs?diagnosis_id(optional)&status(optional)&page_no&page_size → 列表envelope,同患者权限;可供主管最近质检列表,默认可见范围。
|
||||
- POST reviewQuality {job_id,item_key,decision:'confirmed'|'dismissed'|'not_applicable',note,version} → {id};只reviewQuality权限、当前患者域;item_key必须是结果已有quality_checks.key。
|
||||
- POST adoptAction {job_id,action_key,version,due_at(int seconds),content(optional)} → {id,todo_id};首期负责人就是当前操作者,不开放跨人指派。来源动作key唯一,重复返回原action。锁job和诊单,拒绝过期结果;创建关联现有tcm_diagnosis_todo(status=0,creator=当前人)。
|
||||
- GET actions?diagnosis_id(optional)&state(optional)&page_no&page_size → {lists:[{id,diagnosis_id,patient_name,content,due_at,business_state:'pending'|'in_progress'|'completed'|'cancelled',completed_at,completion_note,assignee_id,notification_status}],count,page_no,page_size};看授权患者域但只有负责人或reviewQuality权限可更新,撤权不能更新。
|
||||
- POST completeAction {id,state:'in_progress'|'completed'|'cancelled',note} → {id};完成/取消必须note;终态不可无声回开;若提醒还没发送,完成/取消事务中取消旧提醒。旧status与business_state严格分离。
|
||||
- GET knowledge?keyword&status(optional)&page_no&page_size → {lists:[{id,question,answer,category,status:'draft'|'published'|'disabled',version,source_note,updated_at}],count,page_no,page_size};view只读published,manageKnowledge可看全部。
|
||||
- POST saveKnowledge {id?(0新增),version?(更新必填),question,answer,category,source_note} → {id,version};需要manageKnowledge;新增draft,改正文自动回draft,乐观锁;不预置未经审核的事实知识。
|
||||
- POST publishKnowledge {id,version,status:'published'|'disabled'} → {id,version};manageKnowledge;版本严格校验并记录published_by。
|
||||
|
||||
Source = {id:string('manual:1','im:2','tracking:3'),channel:string,text:string,occurred_at:number,speaker:'patient'|'service'|'unknown',actor_admin_id:number,quality_eligible:boolean}。
|
||||
首期来源:本模块人工服务记录 + 当前有权诊单tracking_note + 有可靠patient_ / doctor_账号对、且员工权限明确的腾讯IM纯文字。企微和未经核验音频标需独立接入,不拉全量临床上下文。来源文本可用PatientAiReportLogic::redactClinicalSource方法脱敏。患者身份不明不合并,IM doctor_也可能医助。对于非本人医助的IM必须按DataScope可见员工过滤;当前患者域+员工域双重检查。tracking笔记非逐字对话 quality_eligible=false;人工verified_transcript明确speaker_confirmed也仅标素材可评估,细节仍人工复核。
|
||||
|
||||
Job = {id,type:'analysis'|'reply',diagnosis_id,scenario,status:'queued'|'running'|'ready'|'failed'|'needs_reconciliation'|'stale',version:1,created_at,updated_at,error_code,error_message,result:object|null,coverage:array,sources:Source[],reviews:array,stale:boolean}。只返回白名单,不返回上游原响应、payload_json、凭据或全模型配置。
|
||||
|
||||
Analysis result = {summary:Claim[],needs:Claim[],unresolved:Claim[],tags:Claim[],suggested_actions:[{key,text,evidence_ids:string[]}],quality_checks:[{key,label,status:'met'|'missed'|'not_applicable'|'insufficient',reason,evidence_ids:string[],actor_admin_id:number}]}。
|
||||
Claim = {text,evidence_ids:string[]}。key稳定、有限长;quality_checks六项key为identity,needs,explanation,next_step,followup,escalation。标签为候选,在UI显示,不写企微/正式病历。每个事实/动作必须有合法证据;没有quality_eligible来源时全部insufficient。employee attribution不能使用当前assignee猜测历史员工,unknown actor不能输出met/missed。
|
||||
Reply result = {reply:string,knowledge_refs:[{id,version}],evidence_ids:string[],needs_confirmation:boolean,reason:string}。需已发布知识支持,未引用知识则拒绝产出院内答复;草稿可复制,永远不发送。
|
||||
|
||||
## 共享类签名
|
||||
|
||||
namespace app\common\service\assistantservice。
|
||||
- Access::actor(int $adminId,string $permission='view'):array fresh actor(id,admin_id,root,name,role_id,permissions短名),throw DomainException。
|
||||
- Access::diagnosis(int $diagnosisId,int $adminId,string $permission='view',bool $lock=false):array 原诊单行;内部actor+MyPatientLogic。
|
||||
- Access::hasPermission(array $actor,string $permission):bool。
|
||||
- Context::build(int $diagnosisId,int $adminId,int $days=30):array,返回context不含latest_job;确定性的hash不能含当前秒/as_of;只计算实际来源与授权identity(含当前assistant_id)的hash。返回coverage包含未接入,不静默丢超限来源。Worker与读取结果都使用此方法复核。
|
||||
- Engine::generate(string $type,string $scenario,array $context,array $knowledge,string $question='',?callable $transport=null):array → {ok,result?,error_code?,error_message?,message_id?}。transport可注入,单元测试不得网络。真实调用DifyChatService::chat(config profile,...,files=[],options knowledge_mode='evidence'禁临床古籍注入,timeout配置)。不改既有DifyChatService。未知超时/连接中断需要needs_reconciliation,不盲重试。
|
||||
- Engine::validateResult(string $type,array $result,array $context,array $knowledge):array throws DomainException,用于直接规则测试。
|
||||
- Worker::runOnce(?callable $generator=null):bool 领取一次任务并处理;return false无任务。使用claim_token + lease_until,只有本token能落结果;超时running转needs_reconciliation不自动再调上游。提交前再次检查当前权限/患者关系/源版本/知识版本。默认调用Engine::generate。
|
||||
- Worker::work(?callable $generator=null)可选循环,command支持 --once、--sleep=3,输出只计数和任务ID,不能记录来源正文。
|
||||
|
||||
## root负责的数据库定义(按字段严格实现)
|
||||
|
||||
Db::name后以下不含前缀。MySQL InnoDB utf8mb4,所有时间unix int,create/update为created_at/updated_at;无需model自动时间戳,Db显式写。
|
||||
|
||||
assistant_service_record: id unsigned bigint PK, diagnosis_id int, patient_id int default0, actor_id int, content text, record_type varchar32, speaker_confirmed tinyint0, occurred_at int, created_at int, delete_time int null。
|
||||
|
||||
assistant_service_job: id bigint PK, diagnosis_id int, patient_id int default0, actor_id int, type varchar16, scenario varchar16, days int30, status varchar32='queued', version int1, dedupe_key char64 UNIQUE, source_hash char64, scope_hash char64, payload_json mediumtext, result_json mediumtext nullable, claim_token varchar64='', lease_until int0, error_code varchar64='', error_message varchar255='', upstream_id varchar191='', created_at int, updated_at int, finished_at int0。
|
||||
payload_json = {context: Context::build结果,knowledge:已发布条目数组,question:string}。job中已存source/scope_hash,knowledge需存id,version,question,answer,category,source_note。
|
||||
|
||||
assistant_service_review: id bigint PK, job_id bigint, item_key varchar64, reviewer_id int, decision varchar32, note varchar1000, created_at int。保留复核历史,当前项取最新。
|
||||
|
||||
assistant_service_action: id bigint PK, diagnosis_id int, job_id bigint, action_key varchar64, todo_id bigint, assignee_id int, content varchar1000, due_at int, business_state varchar20='pending', completion_note varchar1000='', completed_at int0, created_at int, updated_at int。UNIQUE(job_id,action_key)。pending/in_progress可进入completed/cancelled;终态幂等重放同状态允许,不同状态拒绝。
|
||||
|
||||
assistant_service_knowledge: id bigint PK, question varchar300, answer text, category varchar64, source_note varchar1000, status varchar16='draft', version int1, created_by int, published_by int0, created_at int, updated_at int。
|
||||
|
||||
## config('assistant_service')
|
||||
|
||||
enabled(bool默认false),profile('qwen'),timeout(120),lease_seconds(300),max_source_rows(200),max_source_chars(30000),max_manual_chars(10000),max_question_chars(1000),max_knowledge_rows(40),daily_job_limit(100)。需schema_ready判别后给迁移提示。禁真实模型调用测试;代码需实际网络适配,不能用规则结果冒充模型成功。
|
||||
|
||||
## 验证要求
|
||||
|
||||
用合成夹具做 meaningful 单测:引用伪造拒绝、错误/未知说话人不扣分、非服务领域输出约束、知识版本改变拒绝采纳、跨患者和撤权、重复动作幂等、终态转换、worker失租。测试使用临时SQLite或隔离fake DB,自行探测PHP驱动,不加载真实.env数据库。前端构建用 vite build,禁止npm run build(带release脚本)。局部vue-tsc差异与实际组件mock交互更有价值;不要堆源码字符串断言。
|
||||
@@ -0,0 +1,67 @@
|
||||
# 医助服务模块集成只读审查
|
||||
|
||||
> 收尾状态(主代理补充):以下四项均已修复并回归。前三项见后端实施报告;建议动作的提示与服务端校验统一为 500 字,新增 500/501 字边界测试。最终结果见 [validation.md](validation.md),下文保留审查当时的发现和复现证据。
|
||||
|
||||
审查日期:2026-11-09。本轮按主代理要求,重点独立检查 API、Access、Context 与 Engine/Worker、迁移、菜单和配置的衔接。未修改业务代码、未启动或连接业务 MySQL、未读 `.env`、未调用模型、未派生代理。以下行号为本轮检查时的位置;backend_api 正在并行进行自己的 MySQL 验证,后续修改应再复核。
|
||||
|
||||
## 需要处理的发现
|
||||
|
||||
### P2:带有已删除角色遗留关系的正常员工会永久失去患者入口
|
||||
|
||||
位置:`server/app/common/service/assistantservice/AssistantServiceAccess.php:125` 的 `assertRoleSnapshot()`,以及同文件 `actor()` 对已删除角色的过滤;既有 `server/app/adminapi/logic/auth/RoleLogic.php:131` 的删除流程只删除角色,没有删除 `admin_role` 关系。
|
||||
|
||||
实际复现:加载 `AssistantServiceApiTest.php` 的隔离内存 SQLite 环境,保留员工 11 的有效医助角色 2,再插入已软删除角色 99 及该员工对应的 `admin_role` 关系。`Access::actor(11)` 正常返回 `role_id=[2]`,随后 `patients` 却必定抛出“数据权限已变化,请刷新后重试”。重新调用仍失败;这不是并发变化。
|
||||
|
||||
原因:当前 actor 快照已经过滤 deleted role,而 `assertRoleSnapshot()` 比较的是未过滤的原始关系 `[2,99]`。正常删除一个兼任角色会令另一个有效角色的所有患者操作被错误拒绝。
|
||||
|
||||
建议:比较相同的有效角色集合,并保证后续复用 MyPatientLogic 时也不让遗留的删除角色参与数据域判断。不能只删除这项保护,否则旧 RR 快照和旧 MyPatientLogic 的角色读取可能重新扩大数据域。
|
||||
|
||||
### P2:已知失败在配置修复后仍永久命中失败任务,没有安全恢复路径
|
||||
|
||||
位置:`server/app/adminapi/logic/tcm/AssistantServiceLogic.php:104`—`105`。所有相同 dedupe_key 的任务,无论 queued、ready、failed、needs_reconciliation,都直接返回旧行;API 没有显式重试或恢复动作。
|
||||
|
||||
实际复现:以正常可分析来源创建 revisit 分析,模拟其进入 `failed/CONFIG_INVALID`,再把模型配置中的 name 和 api_key 改为新的合成有效值,然后重发完全相同的 analyze 请求。输出为:
|
||||
|
||||
```text
|
||||
first_id=3 after_fix_id=3 status=failed count=1
|
||||
```
|
||||
|
||||
配置已修好且任务已知未发送成功,用户仍只能通过无关地改变场景或来源来绕过幂等键;原任务不会再执行。worker 不重试不确定任务的行为正确,但不能把这种隔离不加区分地当作已知失败的永久恢复策略。
|
||||
|
||||
建议:明确区分已知未提交/已确认结束的失败与 `needs_reconciliation`;提供受权限、患者域、最新来源和知识复核保护的显式恢复流程,或至少提供准确的操作说明。不得自动重发 `needs_reconciliation`。
|
||||
|
||||
### P2:任务状态筛选与实际返回状态不一致,过期任务无法可靠筛选
|
||||
|
||||
位置:`server/app/adminapi/logic/tcm/AssistantServiceLogic.php:137` 的 DB 状态过滤,及 `formatJob()` 对状态的动态 stale 映射。
|
||||
|
||||
实际复现:ready 任务生成后修改其 tracking 来源,调用 `jobs?status=ready`。返回三条记录的 `status` 全部是 `stale`;反过来 `status=stale` 只查询数据库原状态,也不会包含这些动态过期记录。
|
||||
|
||||
原因:筛选/count/分页发生在动态复核之前。接口承诺的状态筛选与返回值使用不同口径,主管按“完成/过期”筛选时看到错误集合和数量。
|
||||
|
||||
建议:统一查询、count、分页和最终返回状态的口径。不能仅在当前页内过滤 stale,否则页数和总数继续不正确。
|
||||
|
||||
### P2:Engine 接受的长动作无法直接采纳到既有提醒表
|
||||
|
||||
位置:`server/app/common/service/assistantservice/AssistantServiceEngine.php:131` 允许动作 text 1000 字;`server/app/adminapi/logic/tcm/AssistantServiceLogic.php:171`—`172` 及旧 `tcm_diagnosis_todo.content varchar(500)` 只接受 500 字。
|
||||
|
||||
实际复现:生成 600 字纯服务动作、有效来源引文和完整六项质检,经 `Engine::validateResult()` 成功校验,保存 ready 后调用 `adoptAction` 不传自定义 content,报“采纳后的跟进内容须为 1 至 500 字”。因此合法 ready 结果可能无法按默认流程采纳。
|
||||
|
||||
建议:保持现有提醒表的 500 字边界,将 Engine 的动作长度和提示要求统一到 500;不要扩旧表字段或静默截断建议。
|
||||
|
||||
以上四项已分别发给主代理和 backend_api。此审查没有代改业务代码。
|
||||
|
||||
## 已确认匹配的边界
|
||||
|
||||
- `Source` 的字段类型与 Engine 校验匹配。Context 对人工转写保留 unknown/actor=0,不把录入人当成历史说话人;IM 同时验证 patient/doctor 账号对与可见员工域。
|
||||
- 所有 Controller action 通过 Validate 与对应 Logic;Access 每次重读当前 root、角色菜单、账号状态和患者关系,不相信 token 中旧 root。模型生成权限与一般 view 分开。
|
||||
- Worker 在调用前、提交事务内重新核对权限、患者关系及 source_hash/scope_hash;对知识逐条比较 published、version、question/answer/category/source_note。API `isStale()` 与采纳/复核使用同样知识口径;新增无关知识不会使旧快照失效。
|
||||
- 读取 job 时重新核对患者映射和当前可见来源。查看者缺少某条历史来源时,结果和复核记录不会返回;完整授权者可读取标记 stale 的历史结果,但不能采纳或复核。
|
||||
- 动作采纳关联旧提醒和新业务行在同一事务;重复 key 返回既有动作;只有负责人或带 reviewQuality 权限者且仍有 completeAction/患者权限可变更。终态不能改为其他状态,完成/取消会取消尚未发送的旧提醒,不会把旧 status=1 当作业务完成。
|
||||
- 五张新增表字段、worker 的 claim_token/lease_until 和 API 字段一致;菜单路径、组件路径、八个权限点及 console `assistant-service:work` 注册一致。没有发现读取凭据到前端或生产 mock 成功分支。
|
||||
- 入队有每人每日配额、actor 行锁和数据库唯一键;worker 的 running 超时转 needs_reconciliation,不抢占后重新调用模型。没有发现无限自动重试路径。queued 没有自动到期清理,消费者未运行时会一直排队,需依赖部署监控与命令正常运行。
|
||||
|
||||
## 执行的验证与范围限制
|
||||
|
||||
独立执行 `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceApiTest.php`,62 项既有断言通过。在同一真实 ORM/Access/Context/Logic 的隔离内存环境额外执行上述四种场景,均观察到报告中的行为;没有写入长期测试文件或真实数据库。新增审查夹具全部为合成资料。
|
||||
|
||||
本轮没有重复主代理的前端构建/浏览器验收,也没有替代 backend_api 正在进行的隔离 MySQL 锁竞争验证。未声称所有竞态已覆盖,未把规则校验视为真实模型语义质量验收。
|
||||
|
After Width: | Height: | Size: 42 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 32 KiB |
@@ -0,0 +1,43 @@
|
||||
# 本地登录测试入口
|
||||
|
||||
2026-11-09 已按用户要求启动并保留后台服务。
|
||||
|
||||
- 登录:http://127.0.0.1:5560/admin/login
|
||||
- 医助工作台:http://127.0.0.1:5560/admin/assistant_service/workbench
|
||||
- PHP:`127.0.0.1:8080`,PHP 8.2.9,使用项目原有 `server/public/router.php`。
|
||||
- 数据库:项目已有的本地 `127.0.0.1:3306/zyt`,沿用本机账号,不创建或修改账号。
|
||||
- 前端:当前工作区源码,独立 Vite 缓存;API 同源代理到本机 PHP,避免使用默认开发域名。前端启动不改现有 Nginx 或既有 5555/5556 服务;后续按用户授权在 `server/.env` 开启本模块 AI 与自动分析。
|
||||
- PHP/Vite 以隐藏窗口后台进程运行,进程编号和启动时间记录在 `.spool/assistant-local-processes.json`;输出写入 `.spool/assistant-local-*.log`。
|
||||
|
||||
初次启动检查:五张 `zyt_assistant_service_*` 表均存在,九条模块菜单及正确组件路径存在;配置 API 返回成功,未登录的模块 API 保持 token 校验;最新工作台 Vue 组件可加载;浏览器显示账号/密码登录表单。初次启动时只验收到登录表单。此后用户已登录 admin,浏览器已验证登录后的团队总览;未修改账号或权限、未重新执行迁移。
|
||||
|
||||
用户使用现有主管或管理员账号登录,进入“医助服务 → 服务工作台”。2026-11-09 17:31 已按用户追加要求开启本地 `assistant_service.ENABLED`,使用现有 qwen 模型配置,并启动独立 worker(每 3 秒轮询)。网页已刷新可用状态,原“AI 未启用”提示消失。真实模型的合成分析和回复草稿均通过;该阶段仅做合成模型测试。后续自动版本已按用户要求扫描真实有效来源并入队;未代用户复核或采纳跟进任务。详见 [AI 启用验收](ai-local-enabled.md)。
|
||||
|
||||
本地当前已发布服务知识为 0 条;回复草稿需先发布实际审核的服务 FAQ。分析不要求先有 FAQ,但必须有该医助可访问的有效服务来源。
|
||||
|
||||
当前工作台已升级为团队总览和独立自动分析,不再要求逐人选择和手动勾选诊单。扫描绑定本地主管 id=1,每分钟检查近 30 天来源,沟通安静 5 分钟后入队;每批最多 10 条、默认每日上限 100。页面每 30 秒读取更新,侧边详情保留核查上下文。运行记录见 [本轮验收](automatic-validation.md)。
|
||||
|
||||
2026-11-10 新增“今日维护”:按每个医助展示应维护、已联系、待维护和人工登记待核实;点击人数直接展开患者名单。默认使用已有到期复诊、过号、承诺当日和明确联系动作,不把所有在管患者自动设为每日维护。电话、外部企微暂未接入,缺少系统记录不等于已经证明从未联系。
|
||||
|
||||
已在本地库应用 `1.9.20261110/01_assistant_service_daily_contact.sql` 增量迁移;新增独立日计划表和动作类型/实际完成操作者字段,原五张模块表记录数保持不变。本地 `.env` 开启 `DAILY_CONTACT_ENABLED=true`、`DAILY_CONTACT_ACTOR_ID=1`、`DAILY_CONTACT_INTERVAL_SECONDS=60`。独立计划进程每分钟扫描,首次扫描完成前明确显示生成中;它不依赖模型、不发送消息。详情见 [今日联系验收](daily-contact-validation.md)。
|
||||
|
||||
后台已保留 PHP、Vite、AI worker、自动分析扫描和今日联系计划五个隐藏进程。关机或进程退出后,可在分别独立的终端恢复:
|
||||
|
||||
```powershell
|
||||
# 后端;在 D:\web\zyt\server 执行
|
||||
php think run --host 127.0.0.1 --port 8080
|
||||
|
||||
# 前端;在 D:\web\zyt 执行
|
||||
node .spool/start-assistant-local.mjs
|
||||
|
||||
# AI 后台任务;在 D:\web\zyt\server 执行,勿重复启动已有 worker
|
||||
php think assistant-service:work --sleep=3
|
||||
|
||||
# 自动发现任务;在 D:\web\zyt\server 执行,勿重复启动已有扫描进程
|
||||
php think assistant-service:auto --sleep=60
|
||||
|
||||
# 今日联系计划;在 D:\web\zyt\server 执行,勿重复启动已有日计划进程
|
||||
php think assistant-service:daily --sleep=60
|
||||
```
|
||||
|
||||

|
||||
@@ -0,0 +1,91 @@
|
||||
# 医助主管版本本地启动与路由核对
|
||||
|
||||
> 主任务实际启动结果(2026-11-09):本地入口为 **http://127.0.0.1:5560/admin/login**,PHP 为 `127.0.0.1:8080`。使用单独的同源代理启动脚本,把 API 转发到本机 PHP;保留既有 5555/5556 服务。经具备系统进程可见性的检查,既有端口确实在监听,下面子任务的空端口结果仅反映受限环境。已只读确认本地 `zyt` 中五张模块表和九条菜单存在,登录表单与配置 API 正常显示,最新工作台组件由 Vite 提供。之后按用户追加要求已开启 AI 并启动后台消费者。详情见 [本地运行记录](local-running.md)。
|
||||
|
||||
核对日期:2026-11-09。范围为源码、公开配置及依赖文件的只读检查;未启动服务、未连接业务数据库、未验证账号登录、未执行迁移、未读取密码或模型密钥、未修改权限。唯一新增文件为本报告。
|
||||
|
||||
## 建议入口与启动命令
|
||||
|
||||
优先使用当前源码的 Vite 开发服务,登录地址为 `http://127.0.0.1:5555/admin/login`。医助工作台完整地址为 `http://127.0.0.1:5555/admin/assistant_service/workbench`,服务知识为 `http://127.0.0.1:5555/admin/assistant_service/knowledge`。页面是否可进入仍由登录账号的菜单和后端数据权限决定。
|
||||
|
||||
本地 PHP 后端建议监听 `127.0.0.1:8080`,前端进程显式覆盖 API 地址为该端口,避免误连开发配置里的远端域名。以下命令仅供主任务执行,本核对没有运行它们。
|
||||
|
||||
后端(独立 PowerShell,先由主任务确认该实例应使用的数据库环境):
|
||||
|
||||
```powershell
|
||||
Set-Location -LiteralPath 'D:\web\zyt\server'
|
||||
php think run --host 127.0.0.1 --port 8080
|
||||
```
|
||||
|
||||
前端(另一 PowerShell;环境变量仅作用于当前进程及其子进程,不改 `.env`):
|
||||
|
||||
```powershell
|
||||
Set-Location -LiteralPath 'D:\web\zyt\admin'
|
||||
$env:VITE_APP_BASE_URL = 'http://127.0.0.1:8080'
|
||||
npm.cmd run dev -- --host 127.0.0.1 --port 5555 --strictPort
|
||||
```
|
||||
|
||||
本机已存在 PHP CLI、Node、npm,`admin/node_modules/.bin/vite.cmd` 和 `server/vendor/autoload.php` 存在,不需要为这次启动先重复安装依赖。PHP 命令解析到 `D:\phpstudy_pro\Extensions\php\php8.2.9nts\php.exe`。只读端口检查时,80、8080、5555、4173 未返回监听项;启动时仍应处理端口竞争。`--strictPort` 避免 Vite 静默换端口。
|
||||
|
||||
`php think run` 已通过本仓库 vendor 的 `RunServer.php` 确认存在,内部使用 PHP 内置服务器、`server/public` 文档根目录和 `server/public/router.php`。没有执行 `php think`,避免本核对子任务加载业务环境。
|
||||
|
||||
## 当前配置的实际指向
|
||||
|
||||
| 配置/路径 | 只读核对结果 | 对本地测试的影响 |
|
||||
|---|---|---|
|
||||
| `admin/vite.config.ts` | `base: '/admin/'`;默认端口 5555、host `0.0.0.0`、自动打开浏览器 | 使用 `/admin/` 前缀;推荐启动参数收敛到回环地址 |
|
||||
| `admin/.env.development` | `VITE_APP_BASE_URL='https://css.zhenyangtang.com.cn/'`;请求超时 60000 | 默认 `npm run dev` 仍请求远端 API,不是本地 PHP |
|
||||
| `admin/.env.production` | `VITE_APP_BASE_URL='https://admin.zhenyangtang.com.cn/'`;请求超时 60000 | 普通生产构建也不会自动变成本地 API |
|
||||
| `admin/src/config/index.ts` | API base 为环境变量加 `/`;默认前缀 `adminapi` | 覆盖值建议不带尾部 `/`,最终请求例如 `http://127.0.0.1:8080/adminapi/tcm.assistantService/capabilities` |
|
||||
| Vite `/uploads` 代理 | 优先取 API base 的 HTTP(S) 地址,否则退回 `http://127.0.0.1:8080` | 显式本地 API 覆盖后,上传资源也指向本地后端 |
|
||||
| Vite `/api-proxy` 代理 | 固定指向 `https://admin.zhenyangtang.com.cn`,去掉 `/api-proxy` 前缀 | 不是本地代理,不能把 API base 改为 `/api-proxy` 来实现本地测试 |
|
||||
| Vite `/adminapi` | 当前没有这个代理规则 | API base 留空会让请求发到 Vite 端口,不能据此期待自动转发到 PHP |
|
||||
|
||||
只提取了 `.env` 中上述公开 URL/超时项,没有读取服务端数据库凭据或模型密钥。已核对当前安装的 Vite 源码支持进程环境变量优先于 `.env` 值。
|
||||
|
||||
## 静态 `/admin` 与开发服务的差异
|
||||
|
||||
- `admin/src/router/index.ts` 使用 `createWebHistory(import.meta.env.BASE_URL)`,所以完整浏览器地址包含 `/admin/`;数据库菜单内的 `paths` 不带此前缀。
|
||||
- `server/route/app.php` 注册 `admin/:any`,返回 `server/public/admin/index.html`;`server/public/router.php` 放行真实静态文件,其他请求进入 PHP。当前路由配置 `route_complete_match=false`。嵌套路由直接打开/刷新是否在实际服务器下正常,应在启动后实测,不能仅凭首页可访问宣称通过。
|
||||
- `npm run build` 会执行 `scripts/release.mjs`,删除并重建 `server/public/admin`。本地源码登录测试不需要执行此发布脚本。
|
||||
- 只读快照中 `server/public/admin/index.html` 最后写入时间为 15:00:56,而当前工作台 Vue 源码最后写入为 16:04:59、知识页为 15:24:52。已有静态包时间早于当前页面源码,不能用于宣称当前主管版本已加载。Vite 会直接提供当前源码。
|
||||
- 如确需静态方式,必须显式配置本地 API 并重新构建到受控目录,再验证该静态包;不能直接使用现有 `/admin` 包当作本次验证结果。
|
||||
|
||||
## 已安装环境下如何核验医助菜单
|
||||
|
||||
`server/config/install.lock` 已存在,系统安装标识在这里,不在 `server/public/install/`。该标识只说明通过安装检测,并不证明医助模块迁移已成功。不要为本次启动重新运行安装器。
|
||||
|
||||
模块迁移为:
|
||||
|
||||
1. `server/sql/1.9.20261109/01_assistant_service_tables.sql`
|
||||
2. `server/sql/1.9.20261109/02_assistant_service_menus.sql`
|
||||
|
||||
此前两份 SQL 已成功执行时,主管维度改版复用原有五张表,无需删表重建。SQL 明确使用 `zyt_` 前缀。菜单 SQL 通过 `NOT EXISTS` / `INSERT IGNORE` 增补记录,可重复执行,但已有同权限记录不会被它修正到新的路径或组件;因此应核对现存菜单内容,而非盲目重复迁移。
|
||||
|
||||
无需改权限的浏览器核验步骤:
|
||||
|
||||
1. 用户用现有账号登录,确认登录请求发往选定本地 API。不要复制或输出登录响应里的 token。
|
||||
2. 查看前端自动发出的 `/adminapi/auth.admin/mySelf` 响应,仅核对 `menu` 与权限项:根目录 `assistant_service`;工作台子路径 `workbench`、组件 `assistant_service/workbench/index`、权限 `tcm.assistantService/view`;知识页子路径 `knowledge`、组件 `assistant_service/knowledge/index`、权限 `tcm.assistantService/manageKnowledge`。
|
||||
3. 从侧栏“医助服务 → 服务工作台”进入;确认出现医助选择与 7/30/90 天范围,而不是旧版以患者为主入口的布局。
|
||||
4. 检查页面自动请求的 `/adminapi/tcm.assistantService/capabilities`:`schema_ready=true` 表明五张模块表的必需字段可查询;`permissions` 体现该账号当前模块权限。`ready=false` 可能只是 AI 未启用或模型配置不完整,不等于菜单/人工服务功能失败。该接口不会返回模型凭据。
|
||||
5. 确认 `staff`、`staffOverview`、`staffCases` 等接口由当前源码提供,主管仅看到现有部门范围的有效医助;若医助列表为空,先核对当前角色/部门及数据范围,不生成账号或扩大授权。
|
||||
6. 硬刷新工作台完整 URL,确认 history 路由能恢复;再以实际权限允许的账号核验知识页。
|
||||
|
||||
五张表为 `zyt_assistant_service_record`、`zyt_assistant_service_job`、`zyt_assistant_service_review`、`zyt_assistant_service_action`、`zyt_assistant_service_knowledge`。这里仅列出预期结构,本核对没有查数据库。
|
||||
|
||||
菜单默认授予名称为“医助、经理、诊室组长、管理员”的有效角色,复核与知识发布只给后三种管理角色;自定义名称不会自动匹配。后端团队视角还使用现存管理角色 ID 3/7/8 和 DataScope,root 以数据库身份字段识别。因此“菜单可见”与“主管团队数据可见”需要分别核验。
|
||||
|
||||
菜单由 `MenuLogic::getMenuByAdminId()` 从数据库读取,再经 `mySelf` 返回,前端以 `import.meta.glob('/src/views/**/*.vue')` 加载组件。通用 URL 授权有 `AdminAuthCache`,账号权限缓存最长 3600 秒;全局权限集合变化会按摘要清理缓存,角色编辑也会清理缓存。单纯重新登录不能保证清掉所有既有服务器授权缓存。若菜单已迁移但权限异常,按现有管理流程刷新授权缓存并重新登录;不要通过反复保存无关角色或修改 root 来“修复”。模块 `AssistantServiceAccess` 本身会重新核对当前角色、菜单和数据范围。
|
||||
|
||||
## 登录及运行中需要关注的边界
|
||||
|
||||
- 绑定本地 HTTP 端口并不保证底层数据库也是本地。本报告未检查服务端数据库目标;主任务在启动前应依既有授权确认所用环境,不能把“本地页面”写成“隔离测试库”。
|
||||
- 常规账号登录采用 token 请求头,现有跨域中间件放行 `token`、`version` 和 JSON 所需请求头,可支持 Vite 与本地 PHP 分端口的常规登录路径。统一账号 IAM 的兑换接口显式 `withCredentials:true`,而跨域中间件返回 `Access-Control-Allow-Origin: *`,这个组合可能被浏览器拦截。若当前站点强制 IAM,优先采用经过核对的同源方案;不要绕过既有认证或绑定策略。
|
||||
- 非 root 可能被要求绑定企微;授权回跳域名可能仍与线上配置关联。本核对未读取 OAuth 凭据,未验证回跳。遇到该限制应保留原有登录规则并向主任务说明实际阻点。
|
||||
- 通用权限中间件会比较登录 IP;测试应始终使用一致的回环主机名与后端入口,出现 IP 变化提示时重新登录,不复用旧会话。
|
||||
- 仅打开页面和人工资料操作不要求启动 AI worker。若用户要验证真实分析任务,须使用已确认的配置和新版 worker,命令为 `php think assistant-service:work --sleep=3`;任务提交会写入所连接的数据库并可能触发模型调用。本子任务没有启动 worker,也没有触发任务。
|
||||
- `.trellis/` 在当前工作区不存在,已读取根目录 `AGENTS.md`、`CLAUDE.md` 及现有部署/主管维度说明,未凭空创建 Trellis 工作流目录。
|
||||
|
||||
## 本次结论
|
||||
|
||||
具备直接启动当前源码的依赖条件。推荐 Vite `127.0.0.1:5555` + 显式本地 API `127.0.0.1:8080`,由用户在 `/admin/login` 使用现有账号验证。主要已见风险是默认 API 仍指向远端、当前静态包早于最新源码,以及已安装标识不能代替模块表/菜单/账号权限核验。实际服务启动、数据库目标、迁移状态、登录和真实模型链路均留给主任务继续验证。
|
||||
@@ -0,0 +1,115 @@
|
||||
# 医助 AI 患者服务与质检工作台:项目现状审查
|
||||
|
||||
审查日期:2026-11-09。范围:仓库源码、依赖清单、迁移与已有发布说明。只读审查业务代码;本报告是唯一新增交付物。未访问业务数据库、患者文件、凭证或 `.env`;没有执行模型调用、消息发送、迁移或部署。下述“已有”表示源码中存在,不代表生产已启用。
|
||||
|
||||
## 1. 结论与真实客户端定位
|
||||
|
||||
建议把新功能落在 **`admin/` 的医助工作流程中**,复用患者、诊单、沟通留痕、预约和复诊能力,新增“服务分析 / 回复草稿 / 服务质检 / 训练”业务层。不要另造患者主档、预约系统或医助桌面客户端。
|
||||
|
||||
| 客户端 | 源码证据 | 本次定位 |
|
||||
|---|---|---|
|
||||
| `admin/` | [package.json](/D:/web/zyt/admin/package.json:14);[我的患者菜单](/D:/web/zyt/server/sql/1.9.20260804/add_first_visit_my_patients_menu.sql:99)明确授予医生、医助、经理、组长、管理员 | **确实供医助使用的主要 Web 端**。Vue 3、Vite 6、TypeScript、Element Plus、Pinia、ECharts;沿用现有后台登录、菜单和权限 |
|
||||
| `admin/` 移动页面 | [routes.ts](/D:/web/zyt/admin/src/router/routes.ts:83)注册 `/tcm/diagnosis/h5`;[index_h5.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/index_h5.vue:110)有医助筛选和归属展示 | 现有医助移动适配入口。可后续提供摘要、待处理和查看原文,首期不宜同时重建完整移动工作台 |
|
||||
| `app/` | [README.md](/D:/web/zyt/app/README.md:1)明确为 Python + PySide6 医生桌面工作站 | **医生端**,不是已存在的医助客户端;有临床 AI、视频、转写基础,可在服务端复用能力,不能把医生操作流直接授予医助 |
|
||||
| `pc/`、`uniapp/`、`wx/` | [CLAUDE.md](/D:/web/zyt/CLAUDE.md:11)标注公开 PC 站、多端客户端、TRTC 小程序;[uniapp pages.json](/D:/web/zyt/uniapp/src/pages.json:4)主要为首页、资讯、个人中心等 | 未发现这些目录中成型的医助工作台;不作为本期主入口 |
|
||||
| `TongjiUniApp/` | [pages.json](/D:/web/zyt/TongjiUniApp/pages.json:4)健康周记录;[pages.json](/D:/web/zyt/TongjiUniApp/pages.json:104)握力环等运动训练页 | 健康记录与运动客户端。目录中的 `training` 不是员工培训 / AI 对练系统 |
|
||||
|
||||
后端是 ThinkPHP 8、PHP ≥8.0,依赖 Think ORM、EasyWeChat 和腾讯云 TRTC:[composer.json](/D:/web/zyt/server/composer.json:24)。根说明仅列旧的四类客户端,`app/` 与 `TongjiUniApp/` 已使实际仓库超出该说明,架构判断以当前目录与源码为准。
|
||||
|
||||
已读取根 [AGENTS.md](/D:/web/zyt/AGENTS.md:1) 与 [CLAUDE.md](/D:/web/zyt/CLAUDE.md:1)。本次实际检查 `.trellis/workflow.md`、`.trellis/spec/`、`.trellis/tasks/` 均不存在;没有伪造这些文件或创建 Trellis 任务。
|
||||
|
||||
## 2. 入口、角色与数据域
|
||||
|
||||
- **路由来自后端菜单**:`getUserInfo()` 写入 `permissions` 和 `menu`,[user.ts](/D:/web/zyt/admin/src/stores/modules/user.ts:96);前端通过 `import.meta.glob` 和菜单 `component` 动态加载视图,[router/index.ts](/D:/web/zyt/admin/src/router/index.ts:10)。新增独立工作台必须同时准备页面、API 权限和菜单 SQL,不能只加 Vue 路由。
|
||||
- **适合新增入口的位置**:`我的患者` 已有“患者列表 / 订单管理 / 面诊进度 / 医生排班”四个工作区,[my_patients/index.vue](/D:/web/zyt/admin/src/views/first_visit/my_patients/index.vue:16);`诊单列表` 已有复诊节点、归属医助、视频旁观及查看操作,[diagnosis/index.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:322)。可新增全局“医助服务工作台”,并从这两处携带 `diagnosis_id` 打开患者服务侧栏。
|
||||
- **主要数据域规则**:`MyPatientLogic` 明确医生角色 ID 1、医助 ID 2、团队角色 3/7/8,root 全部;医助只看本人归属,医生只看本人接诊,团队按 DataScope:[MyPatientLogic.php](/D:/web/zyt/server/app/adminapi/logic/firstvisit/MyPatientLogic.php:14)。新增患者服务分析和 AI 上下文应复用 `applyScope()` / `canAccessDiagnosis()`,不能依赖前端隐藏按钮。
|
||||
- **不要把旧诊单列表的例外复制到 AI**:诊单普通列表限制医助本人,但“待分配”及其宽搜有明确放宽行为,[DiagnosisLists.php](/D:/web/zyt/server/app/adminapi/lists/tcm/DiagnosisLists.php:77)。AI 汇总涉及更多信息,建议使用更严格的 `MyPatientLogic` 数据域。
|
||||
- **角色语义存在历史差异**:`DiagnosisTodoLogic::isSuperAdmin()` 把 role ID 1 当超管,[DiagnosisTodoLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisTodoLogic.php:156),而 `MyPatientLogic` 把 1 当医生。这里只记录静态冲突,不宣称已复现越权;新增服务任务应以当前 `root`、权限点和统一数据域判定,复用旧待办前须核实这个差异。
|
||||
- **ID 含义需显式映射**:`tcm_diagnosis.id` 是诊单 ID,`tcm_diagnosis.patient_id` 是患者关联 ID;预约的 `patient_id` 在现有范围查询中对照 `d.id`,[MyPatientLogic.php](/D:/web/zyt/server/app/adminapi/logic/firstvisit/MyPatientLogic.php:60)。企微客户另有 `external_userid`,不能用字段同名推定身份一致。
|
||||
- **员工身份映射**:`diagnosis.assistant_id` 对应后台 `admin.id`,当前归属判断直接比较 `assistant_id = adminId`,[MyPatientLogic.php](/D:/web/zyt/server/app/adminapi/logic/firstvisit/MyPatientLogic.php:73);后台账号通过 `admin.work_wechat_userid` 关联企微员工,[MessageLogic.php](/D:/web/zyt/server/app/adminapi/logic/qywx/MessageLogic.php:161)。IM 中当前员工会话使用 `doctor_<adminId>`,此命名前缀也用于医生/医助账号,[DiagnosisLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1076)。不能把 `doctor_` 前缀等同医生岗位,也不能把当前患者归属医助当成历史所有对话的说话人。
|
||||
|
||||
## 3. 可复用业务能力
|
||||
|
||||
| 能力 | 已有实现 / 证据 | 复用方式与限制 |
|
||||
|---|---|---|
|
||||
| 患者与归属 | 我的患者列表、订单、面诊进度、排班;指派医助、补身份资料、挂号。[first_visit.ts](/D:/web/zyt/admin/src/api/first_visit.ts:12)、[first_visit.ts](/D:/web/zyt/admin/src/api/first_visit.ts:120) | 沿用患者/诊单实体和归属,不另建 CRM 患者表。服务画像是附加的可核实信息,不覆盖临床病历 |
|
||||
| 患者上下文 | 详情页已有基础资料、病情、日常记录、医生备注/舌照/检查报告、订单、手机录音、视频、聊天、归属及挂号记录。[readonly.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:49) | 患者服务侧栏可并入此页或复用组件;按原有权限逐项取数据,避免只因有服务入口就展示全部病历 |
|
||||
| 血糖/饮食/运动 | 三类增删改查和趋势 API。[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:114) | 回复草稿可引用已记录的健康打卡和医生意见;新增“服务总结”与临床数值写入分开 |
|
||||
| 跟踪备注 | `trackingWindow/addTrackingNote/trackingNotes`。[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:14) | 可将人工采纳的服务总结写为跟踪记录;编辑页旧“跟踪备注”Tab 当前被注释,[edit.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:644),不能说已有显著的完整入口 |
|
||||
| 回访记录 | 粉丝管理已有回访类型、内容、结果、下次回访、操作人。[fans/index.vue](/D:/web/zyt/admin/src/views/fans/index.vue:156) | 这是另一个客户管理域。需要设计与诊单/患者映射,不能直接合并计数 |
|
||||
| 排班与预约 | 可查询可预约时段、创建/取消/修改挂号、完成面诊。[doctor.ts](/D:/web/zyt/admin/src/api/doctor.ts:50) | 服务分析产生“建议预约”后打开现有预约弹窗;不让模型绕过时段和权限直接写预约 |
|
||||
| 复诊到期 | 本人待提醒、计数、延迟、已联系承诺日、人工关闭、主管列表与事件流水。[revisitDue.ts](/D:/web/zyt/admin/src/api/revisitDue.ts:79);全局挂载 [App.vue](/D:/web/zyt/admin/src/App.vue:61) | 服务工作台可直接聚合“到期未挂号 / 过号 / 承诺日”;建议复用规则计算,AI 负责解释和沟通建议 |
|
||||
| 旧诊单待办 | 新增提醒、列表、取消、详情。[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:899);到点企微推送创建人,[DiagnosisTodoNotify.php](/D:/web/zyt/server/app/command/DiagnosisTodoNotify.php:27) | **属于提醒工具**:状态为待发送/已发送/取消/失败,失败为终态,不是完整的指派、执行、验收闭环。新服务任务不能把“已发送”当“已完成” |
|
||||
|
||||
## 4. 沟通数据、音频和渠道限制
|
||||
|
||||
### 已有沟通来源
|
||||
|
||||
1. **腾讯 IM**:按诊单读取历史和触发归档同步,已有 `ImChatRecordPanel`;接口见 [tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:332)。它与企微会话是不同来源,不应只按显示姓名合并。
|
||||
2. **企微存档与企业群发**:会话列表、历史、未读、素材、发送任务、送达结果、员工客户列表,[MessageController.php](/D:/web/zyt/server/app/adminapi/controller/qywx/MessageController.php:18);Web 三栏聊天视图已存在,[chat/index.vue](/D:/web/zyt/admin/src/views/chat/index.vue:12)。诊单也有企微记录及联系人查询,[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:350)。
|
||||
3. **视频面诊原文**:服务端已有开始转写、上传分段、保存本地转写、结束转写,[DiagnosisController.php](/D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:373);编辑页有“面诊文字对话”与回放页,[edit.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:732)。医助列表还可在权限允许时旁观视频,不能等同医助默认具有医生全部操作能力。
|
||||
4. **安卓手机录音关联**:已支持按诊单列出上传状态、播放录音、查看转写,[MobileRecordingPanel.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/components/MobileRecordingPanel.vue:4);未上传内容仍在原手机;接口有 `source_platform=android_bcr`,[mobileRecording.ts](/D:/web/zyt/admin/src/api/mobileRecording.ts:8)。服务端复用 `MyPatientLogic` 范围,[MobileRecordingLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/MobileRecordingLogic.php:157)。本次未发现此仓库包含该安卓录音工具完整实现,不能承诺网页自动录制所有电话。
|
||||
5. **回访录音提炼**:编辑页已有“回访录音”Tab和 capabilities 门禁,[edit.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:674);分片上传、创建异步任务、审阅草稿、人工采纳、重提炼、删除、重试和音频读取 API 均存在,[followupAudio.ts](/D:/web/zyt/admin/src/api/followupAudio.ts:127)。
|
||||
|
||||
### 对新方案有直接影响的限制
|
||||
|
||||
- **企微绑定不等于会话存档**:登录绑定检查的是 `admin.work_wechat_userid`,[LoginLogic.php](/D:/web/zyt/server/app/adminapi/logic/LoginLogic.php:74);会话存档单独检查 `msgaudit_enabled`、SDK 是否可用及密钥配置,[MessageLogic.php](/D:/web/zyt/server/app/adminapi/logic/qywx/MessageLogic.php:216),诊单界面还单独展示存档开通和同意状态,[index.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:676)。仅从“员工已绑企微”不能推出能读取历史聊天;方案需把绑定、存档授权/可用、同步覆盖分别显示。
|
||||
- **IM 的患者绑定比按姓名匹配更可靠,但诊次归因有边界**:读取先由控制器检查诊单可见范围,[DiagnosisController.php](/D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:468);随后使用真实 `patient_id` 合并历次诊单,账号要求 `patient_<patientId>` 与 `doctor_<adminId>` 成对,[DiagnosisLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1051)。受验证回调仅接收成功发送的消息,并按患者归入最新诊单,[DiagnosisLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1249);返回时又将展示用 `diagnosis_id` 设为当前入口诊单,[DiagnosisLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1241)。所以适合做患者纵向沟通时间线,但不能把返回的诊单 ID 当作消息当时属于该诊次的证据;员工质检要按原始对端账号和时间归因,来源覆盖也不等于全部聊天历史已获取。
|
||||
- **企微发送不是任意即时私聊代理**:当前 `send` 创建企业群发任务,响应明确“员工手机端确认后将发出”,[MessageController.php](/D:/web/zyt/server/app/adminapi/controller/qywx/MessageController.php:55)。因此“AI 回复助手”首期应交付可编辑草稿/复制/转现有发送流程,不能写成“AI 自动实时回复所有企微私聊”。这里仅描述当前代码契约;外部平台能力与配额需实施前再核验。
|
||||
- **会话数据权限需要接入前收紧**:现有 `MsgSessionLists` 主要按请求传入的员工/客户过滤,[MsgSessionLists.php](/D:/web/zyt/server/app/adminapi/lists/qywx/MsgSessionLists.php:31);`MsgArchiveLists` 根据 `session_id` 或员工/客户参数确定会话,[MsgArchiveLists.php](/D:/web/zyt/server/app/adminapi/lists/qywx/MsgArchiveLists.php:32)。在这些类中未见按当前医助强制收窄;基础类仅初始化身份,[BaseAdminDataLists.php](/D:/web/zyt/server/app/adminapi/lists/BaseAdminDataLists.php:26)。这不是端到端安全验证,但足以要求新增聚合器独立校验员工会话归属和患者权限,不能因为原接口可调用就全量喂给 AI。
|
||||
- **回访录音已有强证据设计可借鉴**:引用原文、声道、片段时间和回听按钮,[FollowupAudioReview.vue](/D:/web/zyt/admin/src/views/tcm/diagnosis/components/FollowupAudioReview.vue:39);候选默认不选,主体/否定/时间等风险要求复核,[FollowupAudioPolicy.php](/D:/web/zyt/server/app/common/service/followupaudio/FollowupAudioPolicy.php:118)。新质检问题和患者标签也应定位到原文,不只给一个分数或结论。
|
||||
- **不能宣称音频 AI 已验收上线**:已有发布记录明确 ASR→LLM 链路跑通过,但语义准确度仍失败,生产开关保持关闭,[followup-audio-deployment.md](/D:/web/zyt/docs/plans/followup-audio-deployment.md:18)。本次未读取运行配置,也未做线上验证。建议首期优先采用已有人审确认的文字与录音转写,音频扩面列为独立质量门槛。
|
||||
- **回访提炼的写权限更严**:需要 edit、followupAudio,涉及日常记录还要 dailyRecord,并重新检查当前账号和患者归属,[FollowupAudioAccess.php](/D:/web/zyt/server/app/common/service/followupaudio/FollowupAudioAccess.php:43)。新增只读沟通分析应单设权限,不能要求医助为了看服务总结获得临床编辑权。
|
||||
|
||||
## 5. 已有 AI 与知识基础
|
||||
|
||||
| 基础 | 已有内容 | 与医助服务的差距 |
|
||||
|---|---|---|
|
||||
| 授权患者上下文聚合 | `contextForAuthorizedDiagnosis()` 再次按我的患者收窄、验证诊单与患者关联、脱敏;覆盖日常记录、跟踪、待办、处方、IM、企微、通话等。[PatientAiReportLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/PatientAiReportLogic.php:301)、[PatientAiReportLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/PatientAiReportLogic.php:530) | 可作为最重要复用点,但应做“服务任务所需字段”视图。现有聚合是临床报告上下文,不等同已具备服务画像、质检或自动跟进 |
|
||||
| AI 任务与流式调用 | 分析病历、血糖趋势、问诊小结、用药复核、健康建议、自定义问题、本次通话辅助/复盘等,[DiagnosisAiLogic.php](/D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisAiLogic.php:100);后端有 `aiAssistantStream`,[DiagnosisController.php](/D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:972) | 复用服务调用、取消、超时、来源和权限框架;新增医助服务任务枚举与独立输出契约。现有任务多数是临床医生任务,不能只改名称直接交医助 |
|
||||
| 医助 Web 中的 AI 可见程度 | Web API 有诊单双模型报告读取/重生/编辑,[tcm.ts](/D:/web/zyt/admin/src/api/tcm.ts:857);明确的完整 AI 咨询界面主要在医生工作站 | 未发现 admin 中完整的“医助 AI 回复/服务分析工作台”。已有后端 AI 能力不等于医助已经有该产品 |
|
||||
| 中医参考来源 | `ClinicalKnowledgeReference` 统一注入临床约束/参考;`TcmAncientBooksReference` 使用本地版本固定的古籍索引。[ClinicalKnowledgeReference.php](/D:/web/zyt/server/app/common/service/ClinicalKnowledgeReference.php:8)、[TcmAncientBooksReference.php](/D:/web/zyt/server/app/common/service/TcmAncientBooksReference.php:43) | 属于临床知识来源,不是企业 FAQ 发布系统。可复用引用规范;预约、物流、费用、退款、随访流程应建设独立、版本化、已审核服务知识 |
|
||||
| 饮食 GI 表 | 代码内置分级食物词表,[GiKnowledge.php](/D:/web/zyt/server/app/api/logic/tcm/GiKnowledge.php:6) | 患者饮食辅助基础;不是可运营维护的 FAQ,更不应拿它生成患者事实 |
|
||||
| 外部 AI 只读授权 | MCP 授权页明确 AI 按员工自身权限和数据范围查询,撤销即时失效,[grant/index.vue](/D:/web/zyt/admin/src/views/ai_mcp/grant/index.vue:36) | 可作为未来外部助手查询通道;不是已完成的客服分析、培训或外发执行系统 |
|
||||
|
||||
**未发现已成型的企业 FAQ 管理、知识审批/版本/生效失效、服务话术知识库、服务维度模板、自动服务标签、医助 AI 对练、逐题评分、训练任务与考核闭环。** 该结论来自 `admin/src`、`server/app`、`server/sql` 相关文件名与内容检索,不是对外部 Dify 已配置知识库的断言;本次未连接模型管理后台。
|
||||
|
||||
已有企微标签同步与标签统计:[qywx.ts](/D:/web/zyt/admin/src/api/qywx.ts:24)。这可以作为“人工确认后同步服务标签”的映射基础,但没有证据证明已经具备基于沟通内容自动打标签、标签来源解释和过期复核。
|
||||
|
||||
## 6. 服务质检、员工训练与统计基础
|
||||
|
||||
- **已有业务统计**:首页业绩看板包含业绩、加粉、预约、挂号、接诊、面诊和七天趋势,并明确医助本人/组长小组/经理部门/管理员范围,[PerformanceDashboardLogic.php](/D:/web/zyt/server/app/adminapi/logic/stats/PerformanceDashboardLogic.php:19)。可以复用筛选、图表、范围与指标口径,不能把成交/接诊指标直接当服务质量得分。
|
||||
- **已有个人业绩和复诊接诊率**:个人页展示业绩、有效订单数、复诊接诊率,含继承归属口径,[assistant-performance/index.vue](/D:/web/zyt/admin/src/views/stats/assistant-performance/index.vue:60);后端按本人取数,[AssistantPerformanceLogic.php](/D:/web/zyt/server/app/adminapi/logic/stats/AssistantPerformanceLogic.php:14)。可新增质量覆盖率、复核率、跟进执行率与训练完成情况,保持业务结果与服务质量分列。
|
||||
- **已有主管跟进过程记录**:复诊到期页展示逾期、延迟次数、联系次数、承诺日、过号、关闭原因及事件流水,[revisit_due/index.vue](/D:/web/zyt/admin/src/views/stats/revisit_due/index.vue:176)。它可以提供执行行为证据,但不是基于聊天原文的服务质检引擎。
|
||||
- **未发现员工训练/服务质检完整领域模型**:需要新增场景脚本、训练任务、对练会话、评分维度、证据、参考回答、人工复核/申诉和版本。不能以 `TongjiUniApp/training`、患者运动视频或医生 AI 问诊话术当作已有员工培训模块。
|
||||
- **团队日报/周报/月报有数字基础,没有已确认的服务诊断产品**:可读取上述权威聚合并附服务分析,但应新增报告批次、统计窗口、来源、规则版本和人工发布状态。报告中的“员工问题”必须来自可核查的沟通证据;语音识别不确定或资料缺失应记为不可评价。
|
||||
|
||||
## 7. 视频功能到本项目的接入建议
|
||||
|
||||
以下为给主方案的技术输入,均为建议,不是已实施能力。
|
||||
|
||||
| 视频对应目标 | 最合适复用点 | 必须新增的最小能力 |
|
||||
|---|---|---|
|
||||
| 多渠道原文与录音留痕 | IM 归档、企微存档、手机录音、回访提炼、面诊转写 | 服务沟通统一索引:渠道、源记录 ID、患者/诊单映射、员工、时间、数据完整性;保留原来源,不复制成第二份可任意修改原文 |
|
||||
| 沟通总结与患者画像 | 授权上下文聚合、来源快照、跟踪备注 | 服务诉求、顾虑、已承诺事项、未解决问题、建议下次动作;每项引用来源、有效时间、人工确认;临床诊断与服务标签分离 |
|
||||
| 双视角分析 | 现有 AI 调用框架、录音证据审核组件 | 患者视角“诉求/信息缺口/障碍”,员工视角“是否回应/解释是否准确/跟进承诺/需升级医生”;输出来源与不确定性,不能从语气推断疾病或做人格判断 |
|
||||
| 可配置维度与阶段 | 系统角色、字典、菜单基础 | 服务阶段模板、维度版本、适用渠道、规则/提示词版本、试运行和人工校准;首期固定少量模板,避免先建通用低代码平台 |
|
||||
| 跟进思路与回复助手 | 我的患者、复诊规则、预约、AI 服务、企微发送面板 | 当前会话上下文、服务 FAQ 检索、三到五条简洁建议和可编辑回复草稿;人工选择后走现有动作 |
|
||||
| 企业 FAQ 知识库 | 临床引用规范、现有编辑器/文件上传基础 | 服务条目、部门/场景、权威答案、来源附件、审核人、版本、生效/失效、检索引用;从就诊流程/物流/费用问题起步 |
|
||||
| 服务任务闭环 | 旧提醒、复诊事件和企微通知 | 责任人、截止时间、实际执行结果、复核/取消原因、来源分析 ID;提醒发送状态与业务完成状态分开 |
|
||||
| AI 对练与评分 | AI 调用、后台账号/部门、通用图表 | 合成/脱敏案例脚本、任务、角色扮演、逐题评分/参考答案、复核与训练进度;不能使用真实患者身份作为训练素材默认值 |
|
||||
| 管理看板及周期报告 | PerformanceDashboardScope、个人业绩、复诊主管页 | 质检覆盖率、问题类型、人工确认率、整改闭环、训练改善;同时展示样本量与分析失败/资料不足,避免用少量样本排行 |
|
||||
|
||||
## 8. 首期边界与实施前核对
|
||||
|
||||
最有复用价值的首期是:**医助待服务列表 → 患者沟通时间线 → 双视角服务分析 → 已审核 FAQ 支持的回复草稿 → 人工登记跟进结果 → 主管抽检**。可以直接复用患者/预约/复诊,不必首期同时建设复杂自动标签同步、全渠道自动回复、员工培训平台和定时经营报告。
|
||||
|
||||
实施前应完成五项具体核对:
|
||||
|
||||
1. 用医助/组长/经理测试账号确认菜单、患者域及企微会话归属;新聚合服务以严格范围为准。
|
||||
2. 核对每个实际渠道的可读数据、历史覆盖、录音/转写是否已上传,以及患者关联是否可靠;首页展示覆盖状态。
|
||||
3. 复核回访录音生产启用与语义质量状态;已有文档失败项必须以新验收取代,不能因代码存在就默认开放。
|
||||
4. 从已审核的企业服务 FAQ 和真实工作规范定义质量维度;医疗判断、诊断、处方与改药继续交医生。
|
||||
5. 明确任务“已发送/已联系/已完成/已验收”分别代表什么;统计沿用现有权威口径,新增质量指标单独定义。
|
||||
|
||||
本次没有运行构建或自动测试:未修改可执行代码,结论属于静态产品/架构审查。没有验证生产菜单、数据库结构、模型配置、企微授权、部署状态或真实用户体验。
|
||||
@@ -0,0 +1,49 @@
|
||||
# 主管医助维度后端实施
|
||||
|
||||
完成时间:2026-11-09。依据 `staff-dimension-contract.md` 及主管采纳动作归目标医助的补充要求。复用现有表,无新增 SQL、迁移或生产模拟数据。
|
||||
|
||||
## 实现范围
|
||||
|
||||
- 新增 `staff / staffOverview / staffCases / staffIssues / analyzeStaff` 控制器与校验入口,复用原模块 `view / analyze` 等权限。
|
||||
- `AssistantServiceAccess` 每次读取有效账号、角色和员工域;仅有效医助角色(既有角色 2 或名称为“医助”)成为目标。管理角色和 root 不作为医助候选,普通医助仅本人,主管取数据域交集。目标无需拥有模块菜单权限;操作者仍必须拥有当前操作权限。
|
||||
- `AssistantServiceStaff` 按当前负责诊单、本人可靠 IM 配对和本人登记记录生成医助关联诊单;与操作者患者域交集。跨诊单重复映射的同一患者 IM 在概览只计一次。IM 只计本人发言;登记数不作为说话人归因。待执行/逾期为存量,完成数为所选期间。
|
||||
- 质检仅纳入 `payload.context.subject_admin_id` 等于目标、`days` 等于选定范围、期间创建且仍为有效 ready 的 analysis。动态重建来源、授权和知识版本;同诊单同 key 选最新有效结果,最新人工复核控制 confirmed/dismissed/unreviewed。问题列表排除人工 dismissed/not_applicable。无个人归因的 insufficient 仅在 `coverage_notes` 提示,不计医助失败或绩效。无目标旧分析不强行归因进入医助汇总。
|
||||
- `context / analyze / draftReply / jobs` 支持可选 `assistant_id`;`actions` 按目标 assignee 跨患者筛选。Context 返回 `subject_admin_id`,目标来源只含与其可靠配对的 IM、其登记记录、其作者跟踪备注;人工记录仍为 unknown 说话人。
|
||||
- 新目标写入旧 job 的 payload;哈希和去重键包含目标。未指定目标的旧 source/scope 哈希算法保持不变。Worker、读取、复核、采纳重建始终保留目标;任务返回 `subject_admin_id`。同团队转派不改历史目标归因,操作者患者域和目标员工域仍每次校验。
|
||||
- `analyzeStaff` 要求显式 1–10 个不重复诊单;外层事务验证整批医助关联及当前 Context,逐条复用旧异步队列。缺来源、跨域或超日额度时整批回滚;重复请求复用任务。HTTP 不调用模型。
|
||||
- 主管从目标任务采纳时,`action.assignee_id` 为可信 payload 的目标医助,旧 `todo.creator_id/name` 仍为实际操作者。跨人分配额外要求 `reviewQuality`;目标必须仍当前负责该患者。历史问题仍可复核,但不能将已失去患者访问权的待办分给历史医助。未指定目标的旧采纳行为不变。
|
||||
|
||||
## 修改文件
|
||||
|
||||
- `server/app/adminapi/controller/tcm/AssistantServiceController.php`
|
||||
- `server/app/adminapi/validate/tcm/AssistantServiceValidate.php`
|
||||
- `server/app/adminapi/logic/tcm/AssistantServiceLogic.php`
|
||||
- `server/app/common/service/assistantservice/AssistantServiceAccess.php`
|
||||
- `server/app/common/service/assistantservice/AssistantServiceContext.php`
|
||||
- `server/app/common/service/assistantservice/AssistantServiceStaff.php`(新增)
|
||||
- `server/app/common/service/assistantservice/AssistantServiceWorker.php`
|
||||
- `server/app/common/service/assistantservice/AssistantServiceEngine.php`(仅增加目标说明)
|
||||
- `server/tests/AssistantServiceStaffTest.php`(新增,真实 Access/Context/Worker + SQLite)
|
||||
- `server/tests/AssistantServiceMysqlFlowTest.php`(新增目标链路验证)
|
||||
|
||||
## 已执行验证
|
||||
|
||||
在 `server/` 直接执行脚本,未运行 `php think`,未 initialize 应用,未读取 `.env`,未连接业务数据库,未调用真实模型。
|
||||
|
||||
| 检查 | 结果 |
|
||||
| --- | --- |
|
||||
| `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceApiTest.php` | 76 assertions PASS |
|
||||
| `php tests/AssistantServiceEngineTest.php` | 63 assertions PASS |
|
||||
| `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceWorkerTest.php` | 66 assertions PASS |
|
||||
| `php -d extension=php_pdo_sqlite.dll tests/AssistantServiceStaffTest.php` | 80 assertions PASS |
|
||||
| 以上所有修改 PHP 文件 `php -l` | 全部通过 |
|
||||
|
||||
新增 80 项覆盖:真实医助列表/账号/角色/部门撤权、普通员工隔离、同患者两个医助来源隔离、有效命名医助角色、无目标旧哈希兼容、IM 跨诊单去重、时间窗口、批量缺来源/越权/配额回滚与去重、主管 actor 与医助 subject 分离、真实 Worker 生成前后重新校验目标、最新分析/人工复核去重、证据不足覆盖说明、跨患者待办与主管采纳责任归属、转派后历史归因和新待办限制、过期来源不入汇总。
|
||||
|
||||
MySQL 流程脚本已追加真实库聚合、目标批量原子回滚/去重、目标 Worker、同患者医助隔离、assignee/creator 分离等断言。该脚本继续要求显式端口 `15339` 与目录指纹 `D:/web/zyt/.spool/assistant-service-mysql`;本子任务未执行连接,留给主任务统一运行。
|
||||
|
||||
## 集成注意
|
||||
|
||||
- 提醒发送端改用 action assignee 的解析器与测试由主任务负责,本次未修改通知命令。
|
||||
- 所有报表动态计算,无新增持久汇总。质量任务以每批 100 条扫描、来源活动以每批 200 个 ID 聚合;不会静默截断。但全量关联诊单和有效结果复核会随历史规模增加成本,当前未添加缓存或新索引。
|
||||
- `quality[].insufficient` 保留接口字段;无法可靠个人归因的不足项记入覆盖说明,避免被误读成员工失败次数。
|
||||
@@ -0,0 +1,39 @@
|
||||
# 主管按医助分析与管理:纠偏实施契约
|
||||
|
||||
用户于 2026-11-09 明确指出患者维度是错误实现,并确认“主要供主管分析和管理医助”。本文件替代上一版以患者为主入口的工作台设计。沿用现有安全边界和异步任务,不执行业务库迁移或真实模型调用。
|
||||
|
||||
## 产品主线
|
||||
|
||||
医助列表 → 选择医助与 7/30/90 天 → 工作概览、服务质检汇总、沟通记录、待办执行 → 具体记录核查。患者是关联明细,不作为主页主导航。主管仅看其员工域内有效医助;普通医助仅能看本人。默认展示主管可见医助中的第一位或保持清晰的选择提示;不默认把主管当医助。
|
||||
|
||||
统计分清:当前负责诊单、该医助真实 IM 发言、由该医助登记的记录、明确归因该医助的质检项、该医助负责的待办。患者当前归属不能用于猜历史服务员工。质检显示已覆盖/疑似遗漏/证据不足与人工确认结果,不生成绩效分或排名。
|
||||
|
||||
## API 契约(同一 /tcm.assistantService/ 前缀)
|
||||
|
||||
1. GET staff `{keyword?,page_no?,page_size?}` → Page<Staff>;Staff `{id:number,name:string,is_self:boolean}`。仅有效医助角色(角色名医助及既有医助 role 2 按当前合法角色处理);root/管理身份也不冒充医助。其他员工 ID 不返回、不授权。
|
||||
2. GET staffOverview `{assistant_id:number,days:7|30|90}` → `{staff:Staff,days,metrics:{assigned_cases:number,im_messages:number,manual_records:number,analyzed_cases:number,pending_actions:number,overdue_actions:number,completed_actions:number},quality:Array<{key,label,met:number,missed:number,insufficient:number,not_applicable:number,confirmed:number,dismissed:number,unreviewed:number}>,coverage_notes:string[]}`。
|
||||
- assigned_cases 为当前负责诊单数;im_messages 为期间可靠 IM 配对中医助发言条数;manual_records 为期间登记数(不证明发言);待办 pending/in_progress 当前存量、overdue 为其中已逾期,completed 为期间完成数。文案清楚区分时间口径。
|
||||
- 质检仅来自最新、仍有效、证据可见、可明确归因目标医助的 analysis;同诊单同质检 key 按最新有效结果去重,不因重复生成膨胀。confirmed/dismissed 用最新人工复核,unreviewed 仅 missed 且未复核。无可靠个人归因的 insufficient 可单独提示覆盖不足,不能计为该医助服务失败。
|
||||
3. GET staffCases `{assistant_id,days,keyword?,page_no?,page_size?}` → Page<StaffCase>;StaffCase extends 既有 Patient:`{im_messages:number,manual_records:number,last_activity_at:number}`。列表包含当前负责或期间存在该医助可靠 IM/登记记录的诊单,与操作者现有患者域取交集;不是全员患者列表。
|
||||
4. GET staffIssues `{assistant_id,days,page_no?,page_size?}` → Page<StaffIssue>;StaffIssue `{job_id:number,version:number,diagnosis_id:number,patient_name:string,item_key:string,label:string,status:string,reason:string,decision:string,created_at:number}`;只列该医助可归因 missed,排除人工 dismissed/not_applicable;decision 空或 confirmed。来源过期不计,禁止读取不可见结果。
|
||||
5. 既有 GET actions 扩展可选 `assistant_id`(目标 assignee),不传保持旧行为。页面以这个接口展示跨患者跟进,不要求先选患者。仍校验当前员工域与患者域;患者列需显示。
|
||||
6. 既有 context/analyze/draftReply/jobs 支持可选 `assistant_id`,不传保持旧行为。给定目标后,服务端校验目标医助域;Context 的来源限定该医助与患者的可靠 IM、该医助登记的人工记录及该医助作者的跟踪备注,不能把另一位医助资料混入。context 回传 `subject_admin_id`,写入现有 job.payload_json.context;dedupe/source/scope hash 包含目标,Worker 与读取/采纳/复核重建时都保留目标。不借用目标账号登录/授权,不假定目标有当前模块权限。
|
||||
7. POST analyzeStaff `{assistant_id,days,scenario,diagnosis_ids:number[]}` → `{jobs:Job[],count:number}`;显式勾选最多 10 条沟通记录,逐条以目标 Context 创建已有异步分析任务(实际操作者为主管,质检对象是所选医助)。全部入队事务原子化;重复请求复用原任务,遵守既有额度,不在 HTTP 内调用模型。缺少来源/跨医助或越权诊单明确拒绝并回滚。该功能让主管从医助页批量分析其服务,不强制逐个打开患者页。
|
||||
|
||||
可选 assistant_id 缺省 0;非 0 必须正整数。staff 与所有目标端点均重复读取当前角色/部门/账号状态,不信前端选择。日配额、人工权限与原模块保持一致。
|
||||
|
||||
补充:Job 返回 `subject_admin_id:number`(旧无目标为 0)。采纳目标医助任务时由可信 payload 推导 action.assignee_id=该医助,跨人分配额外要求 reviewQuality 并核对目标当前员工/患者范围;旧无目标任务维持当前人。旧 todo.creator_id 保留真实操作者,提醒进程针对模块关联任务按 action.assignee_id 取收件人。主管查看其他医助时不显示人工登记入口,避免把主管上传当成医助原始服务留痕。
|
||||
|
||||
## 前端结构
|
||||
|
||||
主管主页上方“医助服务分析”,左侧/上方医助列表或选择器;主体选择时间范围与刷新。工作量和待办指标、六项质检汇总作为默认概览;页签“沟通记录 / 质检问题 / 跟进执行”。沟通记录可勾选最多 10 条并“分析所选记录”,有批量提交防重和排队说明;轮询现有 job 状态,在就绪时刷新 overview/issues。患者详情仅为关联沟通核查抽屉/独立子组件,有显式“返回医助总览”,默认员工服务视角。
|
||||
|
||||
旧 workbench 的安全轮询、证据、草稿、记录、采纳/复核和完成流程保留成明细子组件;传目标 assistant_id,禁止在明细重新浏览无关患者。切换医助/时间范围立刻清空旧概览、问题、任务与打开的明细;旧异步响应不能污染新选择。没有数据显示缺少记录/尚未分析,不显示虚构数据。管理文案不以“我的患者”开场。
|
||||
|
||||
## 文件所有权
|
||||
|
||||
- backend agent:Controller/Validate/Logic、新增 Staff service、Access/Context、Worker 的目标上下文衔接,以及后端相关测试。尽量不改 Engine 通用结果结构;需明确 prompt 质检目标可加读取 context.subject_admin_id 的一行。不改前端、SQL、部署文档。
|
||||
- frontend agent:admin/src/api/assistantService.ts、admin/src/views/assistant_service/**、admin/tests/assistant-service*.cjs。不改后台、全局 router、自动声明文件。
|
||||
- root:部署与方案文档、隔离预览夹具、提醒收件人解析器与 DiagnosisTodoNotify 的衔接、集成验收和截图。已执行过的建表脚本无需重建;此次维度调整优先复用已存在表和权限。
|
||||
|
||||
验证重点:医助主入口且无需选患者能看概览/执行;跨员工和跨部门拒绝;同患者两医助不混算;转派不改历史归因;重复分析不重复统计;主管提交仍评价目标医助;切换医助/时间的竞态;旧 API 行为兼容。新端点禁止生产 mock 或伪造成功。
|
||||
@@ -0,0 +1,37 @@
|
||||
# 医助维度前端实施交付
|
||||
|
||||
2026-11-09。按 `staff-dimension-contract.md` 实施,前端入口已改为主管按医助分析与管理。
|
||||
|
||||
## 已实施
|
||||
|
||||
- `admin/src/api/assistantService.ts`:增加 Staff、StaffCase、StaffOverview、StaffQuality、StaffIssue 完整类型;实现 staff / staffOverview / staffCases / staffIssues / analyzeStaff;context、jobs、actions、analyze、draftReply 支持 assistant_id;Context 与 Job 显式返回 subject_admin_id。旧调用不传目标时保持原行为,所有请求仍禁用自动重试和同 URL 取消。
|
||||
- `admin/src/views/assistant_service/workbench/index.vue`:真实医助选择、服务端可见医助清单、搜索与加载更多、7/30/90 天范围、7 项工作与执行指标、质检汇总、沟通记录 / 质检问题 / 跟进执行。首页不使用 PatientPicker;默认选后端清单第一位,不把登录主管作为默认医助。
|
||||
- 沟通记录最多勾选 10 条,批量提交目标医助与明确诊单 ID;双击与处理中重复提交受保护。批量任务使用已有 JobTracker 轮询,就绪后刷新概览和质检问题;连接中断等提交状态不确定时须先查询已提交任务,明确业务拒绝可以修正后重新提交。
|
||||
- `components/CaseDetail.vue`:由原工作台安全明细拆分保留来源、分析、证据、回复编辑、人工记录、复核、采纳、执行与历史。仅由关联记录进入,显示“返回医助总览”,所有来源/生成/历史请求携带目标 assistant_id;验证返回 Context / Job 的主体匹配。主管核查其他医助时不提供人工录入按钮,避免把主管登记错记为目标医助。
|
||||
- `components/JobResult.vue`:员工服务视角置首并默认选中,患者内容作为“关联患者诉求”。目标任务采纳文案为“分配给该医助”,弹窗显示医助 ID;为他人分配必须具有 adoptAction 和 reviewQuality,实际登录人为目标本人则沿用本人采纳权限,服务端仍为最终权限来源。
|
||||
- `components/ServiceActions.vue`:诊单参数可选、支持 assistant_id,可直接展示医助跨患者待办及患者/诊单列。保留负责人/主管更新权限、终态说明、通知与业务状态分离。更新后刷新医助汇总。
|
||||
- 切换医助或时间时立即清空概览、记录、问题、选中项、批量状态与明细;AbortController 与版本号同时防止旧响应回写。JobTracker 额外校验返回任务的医助主体,页面不可见时暂停,卸载释放计时器。
|
||||
|
||||
## 验证
|
||||
|
||||
`node --test admin/tests/assistant-service.test.cjs`:21 项全部通过。原 11 项覆盖完整保留,其中旧 workbench 安全行为测试适配为 CaseDetail 路径。新增覆盖:
|
||||
|
||||
1. staff API 目标参数与旧接口不传目标兼容。
|
||||
2. 默认医助来自授权清单,不默认为登录主管。
|
||||
3. 医助与时间切换同时发生时,旧概览/记录/问题响应不可回写。
|
||||
4. 最多勾选 10 条、批量双击、旧范围提交响应不可污染新范围。
|
||||
5. 批量就绪自动刷新汇总、轮询计时器释放。
|
||||
6. 明确业务拒绝与不确定网络结果的不同重试行为。
|
||||
7. 按医助加载跨患者待办、切员工清空、旧列表响应丢弃。
|
||||
8. 明细 context / jobs / analyze / draftReply 均带目标及适用时间。
|
||||
9. 错误医助 Context 被拒绝,切换医助不复用旧来源。
|
||||
10. 员工视角默认、主管为其他医助分配需复核权限。
|
||||
|
||||
所有模块 Vue SFC 脚本、模板、scoped styles 编译通过;修改文件使用项目 Prettier 格式化。执行过 `vue-tsc --noEmit --pretty false` 并按本模块路径过滤,未产生本模块错误输出,但全仓退出 1,未采集全仓错误来源,因此不宣称全仓类型检查通过。主代理负责完整构建与浏览器验收。
|
||||
|
||||
## 集成注意
|
||||
|
||||
- 新目标任务必须返回 `subject_admin_id`,预览夹具同样需要该字段;缺少或对象不匹配时明细/批量会拒绝展示。
|
||||
- 质检覆盖不足与缺数据均显示真实空态,不推导绩效分或默认达标。前端不猜测患者历史归属;统计与授权按后端返回执行。
|
||||
- 对不确定批次的恢复查询只展示目标医助在这些诊单的最近分析任务,并明确要求核对任务时间与结果,不宣称这些一定是刚提交的批次。
|
||||
- 本子任务没有调用真实模型、执行迁移、修改后端/SQL/router/自动声明文件或运行发布构建脚本。
|
||||
@@ -0,0 +1,68 @@
|
||||
# 医助维度纠偏:独立集成审查
|
||||
|
||||
> 修复闭环(2026-11-09,主代理):以下两项 P2 已修复。新目标提醒按可信分析目标、有效医助身份、当前负责关系与任务绑定核验;缺失 IM 表/必要字段时保留其他数据并返回 `im_messages=null`,页面显示“不可用”,真实空表仍返回 0。移除恒为 0 的“证据不足”列,保留独立覆盖说明。Staff 84 项、提醒收件人 17 项、隔离 MySQL 46 项及前端 21 项通过,最终构建通过。下文保留审查当时的发现和复现,不代表问题仍未解决。详见 [最新验收记录](staff-validation.md)。
|
||||
|
||||
审查日期:2026-11-09。结论:发现 2 项可复现的 P2 问题,分别涉及新目标任务的提醒授权口径、未接入 IM 时的主管主入口可用性。医助主入口、操作者与评价对象分离、员工/患者域交集、同患者多医助来源隔离、批量事务及质量去重的已检查路径未发现其他阻断问题。
|
||||
|
||||
本轮只读业务代码,仅新增本报告及 `.spool/staff-integration-review-probes.php` 独立合成复现脚本。未读取业务 `.env`,未连接业务数据库,未调用模型、发送提醒或发布;未派生子代理。已读根 `AGENTS.md` 和三份医助维度契约/实施报告;当前工作区没有 `.trellis/`,因此无法读取其中的 workflow/spec。以下行号对应审查时的文件,主代理修复后需更新验收结论。
|
||||
|
||||
## P2:新目标任务把提醒收件人当作模块登录操作者核权,合法医助的提醒会失败
|
||||
|
||||
位置:`server/app/common/service/assistantservice/AssistantServiceReminderRecipient.php:32`—`38`,尤其第 33 行调用 `AssistantServiceAccess::diagnosis(..., $assigneeId, 'view', true)`;`server/app/command/DiagnosisTodoNotify.php` 在 `resolve()` 抛异常后会将提醒写为失败终态,不自动重试。
|
||||
|
||||
契约明确允许主管管理有效医助,目标无需具备医助服务模块菜单权限。`assistant()`、目标 Context、批量分析、Worker 和采纳均遵循这一约定;提醒却使用要求 `view` 菜单授权的 `actor()` 路径,把收件人重新当作登录操作者。
|
||||
|
||||
复现使用真实 Access/Context/Logic/Worker 和内存 SQLite,生成器只返回合成结构,不联网:
|
||||
|
||||
1. 保留医助 11 的有效医助角色、账号及当前诊单归属;删除其角色的本模块菜单授权。主管 13 保留完整操作权限。
|
||||
2. `Access::assistant(11, 13)` 正常返回 11。主管 `analyzeStaff`、注入生成器的 Worker、`adoptAction` 都成功。
|
||||
3. 生成的 action 为 `assignee_id=11`,todo 为 `creator_id=13`,身份分离正确。
|
||||
4. 对该 todo 调用 `AssistantServiceReminderRecipient::resolve()`,必定抛出 `DomainException: 无权执行此医助服务操作`。实际通知命令会因此终态失败,用户此前看到的成功分配不能产生应有的提醒。
|
||||
|
||||
同一授权口径还漏掉了“仍是有效医助”的检查:把 11 改为只有医生角色,并保留其对此患者的有效预约关系后,`Access::assistant(11, 13)` 已拒绝该对象,`resolve()` 却仍返回 11。这里没有证明新的患者越权泄露,因为该合成医生仍有患者访问权;它证明提醒路径与新目标身份约束不一致。
|
||||
|
||||
建议:新目标任务从可信 `job.payload_json.context.subject_admin_id` 识别目标,验证其与 action assignee 一致、账号/有效医助角色仍成立、诊单仍由该医助负责,以及 job/todo/diagnosis 的患者绑定一致。此路径不要要求目标拥有模块菜单权限,也不要借用目标登录身份。旧无目标模块任务可以保留原 Access 行为,普通提醒仍使用 creator。分别补充“从未授予模块 view”和“已不再是有效医助”的回归。
|
||||
|
||||
## P2:IM 来源未接入时,医助列表下的概览与沟通记录整体不可用
|
||||
|
||||
位置:`server/app/common/service/assistantservice/AssistantServiceStaff.php:46`—`57`,其中 `caseRows()` 无条件查询 `tcm_im_chat_message`;`overview()` 直接依赖 `caseRows()`。对照 `AssistantServiceContext.php` 的 IM 分支已经支持来源不可读时保留人工记录/跟踪备注并返回 `coverage.status=unavailable`。
|
||||
|
||||
医助服务模块的五张表 readiness 检查不要求 IM 表;IM 也是独立接入来源。当前实现导致这些环境通过 capabilities/schema_ready、存在合法医助和当前负责诊单,却无法正常使用新主页。
|
||||
|
||||
复现:在上述合成环境保留当前诊单、该医助人工记录和跟踪备注,删除纯内存表 `test_tcm_im_chat_message`:
|
||||
|
||||
```text
|
||||
context: sources=[tracking:1, manual:1], im.status=unavailable
|
||||
staffCases: PDOException ... no such table: test_tcm_im_chat_message
|
||||
staffOverview: PDOException ... no such table: test_tcm_im_chat_message
|
||||
```
|
||||
|
||||
重新建立缺少 `from_account` 的旧结构合成 IM 表后,`staffOverview` 同样抛 `no such column: from_account`。控制器会将这些异常包装为通用“医助服务暂不可用”,当前归属、人工登记以及待办指标也无法展示。此问题不依赖模型或真实 IM 内容。
|
||||
|
||||
建议:检查 IM 所需表及字段是否可用;对明确未接入/结构未就绪的情况保留当前归属与人工记录路径,并在 API 覆盖信息和主页明确标识“IM 不可用/未接入”。不能把不可用静默显示为“真实 0 条发言”,也不要吞掉所有数据库异常。应覆盖缺表、缺字段、真正空表和非预期数据库故障的不同结果。
|
||||
|
||||
## 已检查通过的范围
|
||||
|
||||
- 医助清单以有效医助角色和操作者员工域为边界,排除 root/主管冒充目标;一线医助仅能访问本人。目标端点重复检查角色、账号、部门和患者域。
|
||||
- `assistant_id` 进入 Context、source/scope hash、去重键和可信 payload。主管仍为 job actor,Worker 的前后核验保留目标,同患者的其他医助 IM/登记/作者备注不会混入。
|
||||
- 主管目标结果可按自己的员工/患者域读取、采纳和复核;来源隐藏时结果不披露。来源、权限、知识变化使结果过期,过期结果不进入质量汇总。
|
||||
- 质量按同一 days、当前有效 ready 分析、目标身份、可见证据筛选;同诊单同 quality key 取最新有效结果,最新人工复核控制 confirmed/dismissed/unreviewed,排除已驳回/不适用的问题。
|
||||
- 无个人归因的 insufficient 用独立覆盖说明呈现,不记成该医助服务失败。当前 UI 的“证据不足”表格列始终显示 0,而覆盖说明可能显示 N 项不足;说明本身解释了不作个人归责,但表头容易误读。建议显示“—(不作个人归责)”或调整列名并保留独立覆盖数;此项作为展示改进,未列为阻断问题。
|
||||
- assigned 为当前归属存量,IM/人工登记为所选期间,待办/逾期为未结存量,完成为期间完成。概览中的 IM 按 patient 去重,未从当前归属推断历史发言人。
|
||||
- 批量要求明确 1—10 个不重复诊单,缺来源、跨域或日额度不足整批回滚,重复请求复用任务;HTTP 内不运行模型。
|
||||
- 采纳新目标任务时 assignee 为目标医助、creator 为真实主管;跨人分配需 reviewQuality,当前已转派的历史医助不能获得新跟进。待办列表按 assignee 过滤,业务完成与通知状态分离。
|
||||
- 前端主页以医助选择和 7/30/90 天为主线;选中医助/时间切换清空明细和列表,并用版本号/AbortController 丢弃旧响应;明细和轮询校验 subject,主管核查他人时不展示人工登记入口。未在本轮重复主代理的构建与浏览器验收。
|
||||
|
||||
## 执行证据与限制
|
||||
|
||||
实际运行:
|
||||
|
||||
| 命令 | 结果 |
|
||||
| --- | --- |
|
||||
| `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceStaffTest.php` | 80 assertions PASS,真实 Access/Context/Worker,内存 SQLite |
|
||||
| `php -d extension=php_pdo_sqlite.dll server/tests/AssistantServiceReminderRecipientTest.php` | 12 assertions PASS,真实 Access/ORM,不发送消息 |
|
||||
| `php -d extension=php_pdo_sqlite.dll .spool/staff-integration-review-probes.php` | 输出两项问题及身份检查分歧,均为合成资料 |
|
||||
|
||||
现有提醒测试明确把撤销 view 后拒绝通知当作通过,因此它不能证明新目标“无需模块菜单”的契约成立;需要区分新目标与旧无目标任务后更新断言。
|
||||
|
||||
本审查没有运行 MySQL 竞争测试、浏览器或构建,没有覆盖所有数据规模/并发时序,也没有将结构校验当作模型语义质量验收。上述两项问题留给主代理修复并回归;本报告记录审查时状态。
|
||||
@@ -0,0 +1,132 @@
|
||||
// 仅供隔离页面验收的合成内存数据,不进入产品构建。
|
||||
const now = Math.floor(Date.now() / 1000)
|
||||
const staff = [{ id: 2, name: '林医助(合成)', is_self: false }, { id: 3, name: '周医助(合成)', is_self: false }, { id: 4, name: '陈医助(合成)', is_self: false }, { id: 5, name: '赵医助(合成)', is_self: false }]
|
||||
const patients = [
|
||||
{ diagnosis_id: 101, patient_id: 1001, patient_name: '测试患者甲', phone_masked: '138****0001', assistant_id: 2 },
|
||||
{ diagnosis_id: 102, patient_id: 1002, patient_name: '测试患者乙', phone_masked: '138****0002', assistant_id: 2 },
|
||||
{ diagnosis_id: 103, patient_id: 1003, patient_name: '测试患者丙', phone_masked: '138****0003', assistant_id: 3 },
|
||||
{ diagnosis_id: 104, patient_id: 1004, patient_name: '测试患者丁', phone_masked: '138****0004', assistant_id: 3 },
|
||||
{ diagnosis_id: 105, patient_id: 1005, patient_name: '测试患者戊', phone_masked: '138****0005', assistant_id: 3 },
|
||||
{ diagnosis_id: 106, patient_id: 1006, patient_name: '测试患者己', phone_masked: '138****0006', assistant_id: 4 }
|
||||
]
|
||||
|
||||
const dailyDate = new Intl.DateTimeFormat('sv-SE', { timeZone: 'Asia/Shanghai' }).format(new Date())
|
||||
const dailyStart = Date.parse(dailyDate + 'T00:00:00+08:00') / 1000
|
||||
const dailyMeta = () => ({ business_date: dailyDate, timezone: 'Asia/Shanghai', as_of: Math.floor(Date.now()/1000), state: 'ready', reason: '', last_scan_at: now, rule_label: '到期联系任务、复诊到期及承诺当日;按医助和患者去重', coverage: [{source:'plan', status:'available',note:'合成当日计划快照'}, {source:'im',status:'available',note:'已归档的账号出站文字'}, {source:'wecom',status:'not_connected',note:'外部电话和企微需另行核对'}] })
|
||||
const dailyPlans = patients.map((p,i) => ({ ...p, key: 'p:' + p.patient_id, diagnosis_ids:[p.diagnosis_id], status:['pending','contacted','reported','pending','exempt','contacted'][i], reasons:[{type: i === 0 ? 'action' : 'revisit', label: i === 0 ? '今日到期联系任务' : '复诊维护到期', due_at: dailyStart - (i === 3 ? 86400 : 0), source_id: 200+i}], last_contact_at: [1,5].includes(i) ? now-1200 : 0, evidence: i===2 ? [{type:'revisit_contact',id:301,at:now-1800,label:'该医助人工登记已联系,待核实'}] : [1,5].includes(i) ? [{type:'im',id:400+i,at:now-1200,label:'医助账号今日已发出文字'}] : [], exempt_reason:i===4?'当日转交,保留豁免记录':'' }))
|
||||
function dailyCounts(items) {
|
||||
const n = state => items.filter(p => p.status === state).length
|
||||
const contacted=n('contacted'), reported=n('reported'), pending=n('pending'), exempt=n('exempt')
|
||||
const required=contacted+reported+pending
|
||||
return {required,contacted,reported,pending,outstanding:pending+reported,exempt,state:!required?'no_tasks':pending?'pending':reported?'reported':'done'}
|
||||
}
|
||||
|
||||
const keys = ['identity', 'needs', 'explanation', 'next_step', 'followup', 'escalation']
|
||||
const labels = ['身份与背景', '需求收集', '解释与答疑', '下一步约定', '记录与跟进', '问题升级']
|
||||
const coverage = [{ channel: 'im', status: 'available', count: 2, note: '合成 IM 文字来源,仅展示所选医助沟通' }, { channel: 'wecom', status: 'not_connected', count: 0, note: '首期未自动接入企微存档' }]
|
||||
const sourcesFor = (id) => {
|
||||
const person = patients.find(p => p.diagnosis_id === id)
|
||||
return [
|
||||
{ id: `im:${id * 10}`, channel: 'im', text: '患者:之前承诺的资料我还没有收到,请明确什么时候回复我。', occurred_at: now - 3600, speaker: 'patient', actor_admin_id: 0, quality_eligible: true },
|
||||
{ id: `im:${id * 10 + 1}`, channel: 'im', text: '医助:资料发送情况我会查,但我不提供具体回复时间。', occurred_at: now - 3500, speaker: 'service', actor_admin_id: person.assistant_id, quality_eligible: true }
|
||||
]
|
||||
}
|
||||
const resultFor = (id) => {
|
||||
const sources = sourcesFor(id)
|
||||
return {
|
||||
summary: [{ text: '医助回应了资料核实诉求,尚需核对回复安排。', evidence_ids: sources.map(s => s.id) }],
|
||||
needs: [{ text: '核实资料发送并明确回复时间。', evidence_ids: [sources[0].id] }], unresolved: [], tags: [],
|
||||
suggested_actions: [{ key: 'verify_material', text: '核实资料发送情况,与患者明确约定反馈时间。', evidence_ids: sources.map(s => s.id) }],
|
||||
quality_checks: keys.map((key, i) => ({ key, label: labels[i], status: i === 3 ? 'missed' : i === 1 ? 'met' : 'insufficient', reason: i === 3 ? '医助明确拒绝提供具体回复时间,需主管核查并协调。' : i === 1 ? '医助已回应资料核实诉求。' : '当前留痕不足以评价此项。', evidence_ids: i === 1 || i === 3 ? [sources[1].id] : [], actor_admin_id: i === 1 || i === 3 ? sources[1].actor_admin_id : 0 }))
|
||||
}
|
||||
}
|
||||
const jobs = []
|
||||
const polls = new Map()
|
||||
function makeJob(type, p, ready = false) {
|
||||
const job = { id: jobs.length + 1, type, diagnosis_id: Number(p.diagnosis_id), subject_admin_id: Number(p.assistant_id || 0), scenario: p.scenario || 'followup', days: Number(p.days || 30), status: ready ? 'ready' : 'queued', version: 1, created_at: now, updated_at: now, error_code: '', error_message: '', result: ready ? resultFor(Number(p.diagnosis_id)) : null, coverage, sources: sourcesFor(Number(p.diagnosis_id)), reviews: [], stale: false }
|
||||
jobs.push(job)
|
||||
return job
|
||||
}
|
||||
makeJob('analysis', { diagnosis_id: 101, assistant_id: 2, days: 30 }, true)
|
||||
makeJob('analysis', { diagnosis_id: 102, assistant_id: 2, days: 30 }, true)
|
||||
const automaticJob = makeJob('analysis', { diagnosis_id: 103, assistant_id: 3, days: 30 })
|
||||
let automaticScans = 0
|
||||
const actions = [{ id: 1, todo_id: 901, job_id: 1, action_key: 'verify_material', diagnosis_id: 101, patient_name: '测试患者甲', content: '核实资料发送情况,与患者约定反馈时间。', due_at: now - 3600, business_state: 'pending', completed_at: 0, completion_note: '', assignee_id: 2, contact_required: true, completed_by: 0, notification_status: 0 }]
|
||||
const knowledge = [{ id: 1, question: '如何协助患者安排复诊?', answer: '先确认患者方便联系的时间,再查看可预约时段,与患者确认后办理。', category: '预约服务', source_note: '隔离验收的合成流程', status: 'published', version: 1, updated_at: now }]
|
||||
const page = (lists, p = {}) => ({ lists: lists.slice(((p.page_no || 1) - 1) * (p.page_size || 20), (p.page_no || 1) * (p.page_size || 20)), count: lists.length, page_no: p.page_no || 1, page_size: p.page_size || 20 })
|
||||
const selectedJobs = p => [...jobs].reverse().filter(j => j.type === 'analysis' && j.status === 'ready' && j.subject_admin_id === Number(p.assistant_id) && j.days === Number(p.days)).filter((j, i, all) => all.findIndex(other => other.diagnosis_id === j.diagnosis_id) === i)
|
||||
const reviewFor = (job, key) => [...job.reviews].reverse().find(r => r.item_key === key)
|
||||
function makeContext(p) {
|
||||
const id = Number(p.diagnosis_id)
|
||||
return { patient: patients.find(x => x.diagnosis_id === id), subject_admin_id: Number(p.assistant_id || 0), sources: sourcesFor(id), coverage, source_hash: 'synthetic-source', scope_hash: 'synthetic-scope', days: p.days, latest_analysis_job: jobs.filter(j => j.type === 'analysis' && j.diagnosis_id === id && j.subject_admin_id === Number(p.assistant_id || 0)).at(-1) || null, latest_job: jobs.filter(j => j.diagnosis_id === id && j.subject_admin_id === Number(p.assistant_id || 0)).at(-1) || null }
|
||||
}
|
||||
async function invoke(name, p) {
|
||||
if (name === 'capabilities') return { enabled: true, ready: true, reason: '', schema_ready: true, permissions: ['view', 'analyze', 'draftReply', 'record', 'adoptAction', 'completeAction', 'reviewQuality', 'manageKnowledge'], scenarios: [{ value: 'initial', label: '初诊接待' }, { value: 'followup', label: '诊后随访' }, { value: 'revisit', label: '复诊协调' }], limits: { max_manual_chars: 10000, max_source_chars: 30000 } }
|
||||
if (name === 'staff') return page(staff.filter(s => !p.keyword || s.name.includes(p.keyword)), p)
|
||||
if (name === 'teamOverview') {
|
||||
automaticScans++
|
||||
if (automaticJob.status !== 'ready') {
|
||||
automaticJob.status = automaticScans > 1 ? 'ready' : 'running'
|
||||
if (automaticJob.status === 'ready') automaticJob.result = resultFor(103)
|
||||
}
|
||||
const visible = staff.filter(s => !p.keyword || s.name.includes(p.keyword))
|
||||
const rows = await Promise.all(visible.map(async (person) => {
|
||||
const overview = await invoke('staffOverview', { assistant_id: person.id, days: 30 })
|
||||
const mine = jobs.filter(j => j.subject_admin_id === person.id)
|
||||
const queued_jobs = mine.filter(j => j.status === 'queued').length
|
||||
const running_jobs = mine.filter(j => j.status === 'running').length
|
||||
const attention_jobs = mine.filter(j => ['failed', 'needs_reconciliation'].includes(j.status)).length
|
||||
return { staff: person, today_contact: dailyCounts(dailyPlans.filter(p=>p.assistant_id===person.id)), metrics: overview.metrics, unreviewed_issues: overview.quality.reduce((n, q) => n + q.unreviewed, 0), last_analyzed_at: Math.max(0, ...mine.filter(j => j.status === 'ready').map(j => j.updated_at)), analysis_state: attention_jobs ? 'attention' : running_jobs ? 'running' : queued_jobs ? 'queued' : overview.metrics.analyzed_cases ? 'ready' : 'pending', queued_jobs, running_jobs, attention_jobs }
|
||||
}))
|
||||
const sum = (read) => rows.reduce((n, row) => n + read(row), 0)
|
||||
const summary = { staff_count: rows.length, active_staff: rows.filter(r => r.metrics.im_messages || r.metrics.manual_records).length, analyzed_cases: sum(r => r.metrics.analyzed_cases), unreviewed_issues: sum(r => r.unreviewed_issues), pending_actions: sum(r => r.metrics.pending_actions), overdue_actions: sum(r => r.metrics.overdue_actions), queued_jobs: sum(r => r.queued_jobs), running_jobs: sum(r => r.running_jobs), attention_jobs: sum(r => r.attention_jobs) }
|
||||
const filtered = rows.filter(r => !p.filter || p.filter === 'all' || (p.filter === 'issues' && r.unreviewed_issues) || (p.filter === 'overdue' && r.metrics.overdue_actions) || (p.filter === 'attention' && (r.attention_jobs || r.unreviewed_issues || r.metrics.pending_actions)) || (p.filter === 'today_pending' && r.today_contact.outstanding > 0) || (p.filter === 'today_done' && r.today_contact.state === 'done'))
|
||||
const timestamp = Math.floor(Date.now() / 1000)
|
||||
return { days: 30, daily: dailyMeta(), daily_summary: dailyCounts(dailyPlans.filter(p=>visible.some(s=>s.id===p.assistant_id))), summary, automation: { enabled: true, state: 'running', last_scan_at: timestamp, next_scan_at: timestamp + 60, interval_seconds: 60, quiet_seconds: 300, days: 30, reason: '' }, ...page(filtered, p) }
|
||||
}
|
||||
if (name === 'staffDailyContacts') { const mine=dailyPlans.filter(row=>row.assistant_id===Number(p.assistant_id)); const lists=mine.filter(row=>!p.status || p.status==='all' || row.status===p.status); return {staff:staff.find(s=>s.id===Number(p.assistant_id)),daily:dailyMeta(),summary:dailyCounts(mine),...page(lists,p)} }
|
||||
if (name === 'staffCases') return page(patients.filter(x => x.assistant_id === Number(p.assistant_id) && (!p.keyword || x.patient_name.includes(p.keyword))).map(x => ({ ...x, im_messages: 1, manual_records: 0, last_activity_at: now - 3500 })), p)
|
||||
if (name === 'staffOverview') {
|
||||
const mine = actions.filter(a => a.assignee_id === Number(p.assistant_id))
|
||||
const results = selectedJobs(p)
|
||||
return { staff: staff.find(s => s.id === Number(p.assistant_id)), days: Number(p.days), metrics: { assigned_cases: patients.filter(x => x.assistant_id === Number(p.assistant_id)).length, im_messages: patients.filter(x => x.assistant_id === Number(p.assistant_id)).length, manual_records: 0, analyzed_cases: results.length, pending_actions: mine.filter(a => ['pending', 'in_progress'].includes(a.business_state)).length, overdue_actions: mine.filter(a => ['pending', 'in_progress'].includes(a.business_state) && a.due_at < now).length, completed_actions: mine.filter(a => a.business_state === 'completed').length }, quality: keys.map((key, i) => {
|
||||
const checks = results.map(job => ({ job, check: job.result.quality_checks.find(c => c.key === key) })).filter(x => x.check.actor_admin_id === Number(p.assistant_id))
|
||||
return { key, label: labels[i], met: checks.filter(x => x.check.status === 'met').length, missed: checks.filter(x => x.check.status === 'missed').length, insufficient: 0, not_applicable: 0, confirmed: checks.filter(x => reviewFor(x.job, key)?.decision === 'confirmed').length, dismissed: checks.filter(x => ['dismissed', 'not_applicable'].includes(reviewFor(x.job, key)?.decision)).length, unreviewed: checks.filter(x => x.check.status === 'missed' && !reviewFor(x.job, key)).length }
|
||||
}), coverage_notes: ['IM 发言和登记按所选期间统计;当前负责诊单与待执行任务为当前存量。', '质检只统计已完成且可归因该医助的结果;资料不足不等于服务未完成。'] }
|
||||
}
|
||||
if (name === 'staffIssues') return page(selectedJobs(p).flatMap(job => job.result.quality_checks.filter(check => check.status === 'missed' && check.actor_admin_id === Number(p.assistant_id) && !['dismissed', 'not_applicable'].includes(reviewFor(job, check.key)?.decision)).map(check => ({ job_id: job.id, version: job.version, diagnosis_id: job.diagnosis_id, patient_name: patients.find(x => x.diagnosis_id === job.diagnosis_id).patient_name, item_key: check.key, label: check.label, status: check.status, reason: check.reason, decision: reviewFor(job, check.key)?.decision || '', created_at: job.created_at }))), p)
|
||||
if (name === 'analyzeStaff') return { jobs: p.diagnosis_ids.map(id => makeJob('analysis', { ...p, diagnosis_id: id })), count: p.diagnosis_ids.length }
|
||||
if (name === 'patients') return page(patients, p)
|
||||
if (name === 'context') return makeContext(p)
|
||||
if (name === 'record') return { id: 99 }
|
||||
if (name === 'analyze') return makeJob('analysis', p)
|
||||
if (name === 'draftReply') return makeJob('reply', p)
|
||||
if (name === 'job') {
|
||||
const j = jobs.find(x => x.id === Number(p.id)); if (!j) throw Error('任务不存在')
|
||||
if (j.status === 'ready') return j
|
||||
const count = (polls.get(j.id) || 0) + 1; polls.set(j.id, count)
|
||||
if (count > 1) { j.status = 'ready'; j.result = j.type === 'analysis' ? resultFor(j.diagnosis_id) : { reply: '我会核实资料发送情况,并与您约定反馈时间。', knowledge_refs: [{ id: 1, version: 1 }], evidence_ids: [j.sources[0].id], needs_confirmation: true, reason: '请核对实际处理情况后使用。' } } else j.status = 'running'
|
||||
return j
|
||||
}
|
||||
if (name === 'jobs') return page(jobs.filter(j => (!p.diagnosis_id || j.diagnosis_id === Number(p.diagnosis_id)) && (!p.assistant_id || j.subject_admin_id === Number(p.assistant_id))).reverse(), p)
|
||||
if (name === 'reviewQuality') { const j = jobs.find(x => x.id === p.job_id); j.reviews.push({ ...p, id: j.reviews.length + 1, created_at: now }); return { id: j.reviews.length } }
|
||||
if (name === 'adoptAction') {
|
||||
let a = actions.find(x => x.job_id === p.job_id && x.action_key === p.action_key)
|
||||
if (!a) { const j = jobs.find(x => x.id === p.job_id); a = { id: actions.length + 1, todo_id: 901 + actions.length, job_id: p.job_id, action_key: p.action_key, diagnosis_id: j.diagnosis_id, patient_name: patients.find(x => x.diagnosis_id === j.diagnosis_id).patient_name, content: p.content || resultFor(j.diagnosis_id).suggested_actions[0].text, due_at: p.due_at, business_state: 'pending', completed_at: 0, completion_note: '', assignee_id: j.subject_admin_id || 9, contact_required: !!p.contact_required, completed_by: 0, notification_status: 0 }; actions.push(a) }
|
||||
return { id: a.id, todo_id: a.todo_id }
|
||||
}
|
||||
if (name === 'actions') return page(actions.filter(a => (!p.diagnosis_id || a.diagnosis_id === Number(p.diagnosis_id)) && (!p.assistant_id || a.assignee_id === Number(p.assistant_id)) && (!p.state || a.business_state === p.state)), p)
|
||||
if (name === 'completeAction') { const a = actions.find(x => x.id === p.id); Object.assign(a, { business_state: p.state, completion_note: p.note, completed_at: now, completed_by: 9, notification_status: 2 }); return { id: a.id } }
|
||||
if (name === 'knowledge') return page(knowledge, p)
|
||||
if (name === 'saveKnowledge') { const k = { ...p, id: knowledge.length + 1, version: 1, status: 'draft', updated_at: now }; knowledge.push(k); return { id: k.id, version: 1 } }
|
||||
if (name === 'publishKnowledge') { const k = knowledge.find(k => k.id === p.id); k.version++; k.status = p.status; return { id: k.id, version: k.version } }
|
||||
throw Error('隔离夹具不支持操作 ' + name)
|
||||
}
|
||||
async function request(config, options) {
|
||||
const name = config.url.split('/').pop(), p = config.data || config.params || {}
|
||||
if (config.signal?.aborted) throw new DOMException('Aborted', 'AbortError')
|
||||
let data
|
||||
try { data = structuredClone(await invoke(name, p)) } catch (e) { return { code: 0, msg: e.message, data: { code: 'FIXTURE_ERROR' } } }
|
||||
return options?.isTransformResponse === false ? { code: 1, show: 0, msg: '', data } : data
|
||||
}
|
||||
export default { get: request, post: request }
|
||||
@@ -0,0 +1,47 @@
|
||||
# 主管管理医助:纠偏验收
|
||||
|
||||
日期:2026-11-09。按用户确认的“主要供主管分析和管理医助”完成本地代码纠偏。未部署业务环境、修改业务数据库、启用真实模型或发送消息。
|
||||
|
||||
## 交付行为
|
||||
|
||||
- 主入口为医助选择和 7/30/90 天,直接查看工作概览、质检汇总、沟通记录与跟进执行;患者仅作为关联记录明细。
|
||||
- 主管可对所选医助的最多 10 条关联诊单批量分析,结果保留评价对象与实际操作者,服务质量依据可靠来源归因。
|
||||
- 人工驳回/不适用从待核查问题中移除;采纳建议分配给目标医助,主管保留为操作人,提醒收件人为执行人。
|
||||
- 目标没有模块菜单仍可由有权主管管理并接收其合法任务提醒;已转派、身份失效或任务绑定不一致时拒绝提醒。
|
||||
- IM 未接入或必要字段缺失显示“不可用”,保留当前负责诊单、人工记录与任务。真实空表才显示 0;资料不足单独说明,不计为医助服务失败。
|
||||
- 本次没有改变五张新增表的结构;已成功执行的 SQL 无需重建。上线需同步前后端并重启新版本 worker。
|
||||
|
||||
## 自动验证
|
||||
|
||||
| 验证 | 结果 | 范围 |
|
||||
|---|---|---|
|
||||
| API | 76 项通过 | 当前角色、患者域、菜单授权、来源范围、人工操作与去重 |
|
||||
| Engine | 63 项通过 | 注入响应、结构、引用、归因与服务边界 |
|
||||
| Worker | 66 项通过 | 持久任务、租约、过期、失败与未知上游处理 |
|
||||
| Staff | 84 项通过 | 目标医助权限、历史来源归属、汇总去重、复核、批量事务、IM 缺表/缺字段/空表 |
|
||||
| ReminderRecipient | 17 项通过 | 真实 ORM、目标与操作者分离、无模块菜单目标、角色失效、转派、绑定及旧提醒兼容;不发消息 |
|
||||
| MySQL 完整链路 | 46 项通过 | 独立 MySQL 5.7、真实业务服务、并发入队/采纳、事务授权、目标快照和分配 |
|
||||
| 前端行为 | 21 项通过 | 真实 SFC/setup、切换竞态、批量提交与轮询、目标匹配、明细与跨患者执行 |
|
||||
| 最终前端构建 | 通过,2 分 42 秒 | 直接调用 Vite,无发布脚本;输出至 `.spool/assistant-staff-build`,存在既有大包提示 |
|
||||
| PHP 语法 | 通过 | 新增及改动 PHP 文件 |
|
||||
| 类型检查 | 未全量通过 | vue-tsc 退出 1,模块路径无诊断;本轮未重新核对全仓基线 |
|
||||
|
||||
原隔离迁移测试 18 项已通过,本轮 SQL 未变更。MySQL 数据目录位于工作区 `.spool/assistant-service-mysql`、端口 15339;测试检查实际数据目录,不读取业务 `.env`。模型使用注入合成响应,不能由这些断言推断真实语义准确率。
|
||||
|
||||
## 浏览器验收
|
||||
|
||||
使用 `ui-preview.mjs` 挂载实际 Vue 页面、`staff-ui-fixture.mjs` 提供合成内存 API。页面横幅标识隔离验收,不连接业务接口或模型。
|
||||
|
||||
实际观察并验证:
|
||||
|
||||
1. 首屏直接选择合成林医助并显示工作与质检概览,无需先选患者。
|
||||
2. 勾选两条关联诊单,批量入队后轮询完成,概览刷新且同诊单质检不重复计数。
|
||||
3. 从质检问题进入关联记录,默认“员工服务视角”;人工驳回后,返回总览的问题列表减少一项,驳回计数增加。
|
||||
4. 采纳另一项跟进时显示“分配给该医助”,成功后该医助待跟进增加,跨患者执行表显示目标医助为负责人。
|
||||
5. 切换合成周医助,仅显示其指标和关联诊单;旧选择、明细与列表不残留。
|
||||
6. 从 30 天切为 7 天,分析和质量按相应范围重新汇总;当前负责诊单及未结任务维持当前存量口径。
|
||||
7. 回到 30 天保存最终页面。截图为合成验收资料,不代表业务环境已上线。
|
||||
|
||||

|
||||
|
||||
独立复核发现的两项 P2 已修复并增加回归,详见 [审查及修复记录](staff-integration-review.md)。旧首期验收保留为历史记录;当前产品口径以 [纠偏方案](../../docs/plans/assistant-supervisor-dimension-plan-2026-11-09.md) 为准。
|
||||
|
After Width: | Height: | Size: 115 KiB |
@@ -0,0 +1,41 @@
|
||||
// 隔离浏览器验收:挂载真实新增组件,所有 API 由合成内存夹具接管。
|
||||
import { createServer } from '../../admin/node_modules/vite/dist/node/index.js'
|
||||
import vue from '../../admin/node_modules/@vitejs/plugin-vue/dist/index.mjs'
|
||||
import { fileURLToPath } from 'node:url'
|
||||
import { readFile } from 'node:fs/promises'
|
||||
|
||||
const root = fileURLToPath(new URL('../../admin/', import.meta.url)).replaceAll('\\', '/')
|
||||
const fixture = await readFile(new URL('./staff-ui-fixture.mjs', import.meta.url), 'utf8')
|
||||
const server = await createServer({
|
||||
configFile: false,
|
||||
root,
|
||||
base: '/',
|
||||
cacheDir: fileURLToPath(new URL('../../.spool/assistant-service-vite/', import.meta.url)),
|
||||
resolve: { alias: { '@': `${root}src` } },
|
||||
optimizeDeps: { entries: [], include: ['vue', 'vue-router', 'element-plus', '@element-plus/icons-vue'] },
|
||||
plugins: [{
|
||||
name: 'assistant-service-isolated-preview',
|
||||
enforce: 'pre',
|
||||
resolveId(id) {
|
||||
if (id === '@/stores/modules/user' || id.endsWith('/src/stores/modules/user')) return '\0assistant-service-user'
|
||||
if (id === '@/utils/request' || id.endsWith('/src/utils/request') || id.endsWith('/src/utils/request/index.ts')) return '\0assistant-service-fixture'
|
||||
if (id === '/__assistant-service-entry.js') return '\0assistant-service-entry'
|
||||
},
|
||||
load(id) {
|
||||
if (id === '\0assistant-service-user') return `export default function(){return {userInfo:{id:9,admin_id:9,name:'合成主管',root:0},permissions:['*']}}`
|
||||
if (id === '\0assistant-service-fixture') return fixture
|
||||
if (id === '\0assistant-service-entry') return `import {createApp,h} from 'vue';import {createRouter,createWebHistory,RouterView} from 'vue-router';import ElementPlus from 'element-plus';import 'element-plus/dist/index.css';import Workbench from '/src/views/assistant_service/workbench/index.vue';import Knowledge from '/src/views/assistant_service/knowledge/index.vue';const router=createRouter({history:createWebHistory(),routes:[{path:'/__assistant-service-check',component:Workbench},{path:'/__assistant-service-check/knowledge',component:Knowledge}]});const app=createApp({render:()=>h(RouterView)});app.use(router).use(ElementPlus).mount('#app');`
|
||||
},
|
||||
configureServer(dev) {
|
||||
dev.middlewares.use((req, res, next) => {
|
||||
if (!req.url?.startsWith('/__assistant-service-check')) return next()
|
||||
res.setHeader('Content-Type', 'text/html;charset=utf-8')
|
||||
res.end('<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>医助服务模块隔离验收</title><style>body{margin:0;background:#f4f6f8;font-family:Arial,"Microsoft YaHei",sans-serif;color:#303133}#fixture-note{padding:10px 20px;background:#fff3d6;font-size:13px}#fixture-note a{margin-left:16px;color:#315f91}#app{padding:20px;max-width:1600px;margin:auto}*{box-sizing:border-box}</style></head><body><nav id="fixture-note">隔离验收:合成资料,不连接业务接口或模型<a href="/__assistant-service-check">服务工作台</a><a href="/__assistant-service-check/knowledge">服务知识</a></nav><div id="app"></div><script type="module" src="/__assistant-service-entry.js"></script></body></html>')
|
||||
})
|
||||
}
|
||||
}, vue()],
|
||||
server: { host: '127.0.0.1', port: 5589, strictPort: true, open: false }
|
||||
})
|
||||
await server.listen()
|
||||
console.log('Isolated preview http://127.0.0.1:5589/__assistant-service-check')
|
||||
for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, async () => { await server.close(); process.exit(0) })
|
||||
@@ -0,0 +1,44 @@
|
||||
# 医助服务首期集成验收
|
||||
|
||||
> 历史验收记录:下文为纠偏前的首期版本。当前主流程已改为主管按医助分析与管理,最新结果和页面见 [医助维度验收记录](staff-validation.md)。
|
||||
|
||||
日期:2026-11-09。完成独立后台模块的本地开发与隔离测试,未部署业务环境。
|
||||
|
||||
## 验证结果
|
||||
|
||||
| 验证 | 结果 | 实际范围 |
|
||||
|---|---|---|
|
||||
| Engine | 63 项通过 | 模型适配、严格结构、来源与知识引用、员工归因、服务边界、动作 500/501 字;注入合成模型响应 |
|
||||
| Worker | 66 项通过 | 真实 SQLite ORM、持久队列、租约/CAS、来源过期、未知上游不重发;授权上下文使用受控适配器 |
|
||||
| API | 76 项通过 | 真实 Access/Context/Logic、患者域、菜单撤权、来源范围、知识版本、重复采纳、执行状态、AI 关闭后人工处理可用 |
|
||||
| MySQL 迁移 | 18 项通过 | 临时 MySQL 5.7,真实 SQL 重复执行,菜单/权限与历史提醒不变,唯一键有效 |
|
||||
| MySQL 完整链路 | 34 项通过 | 真实 Access/Context/Logic/Worker、两进程并发入队/采纳、RR 撤权、医生预约撤销、源/知识变化及事务回滚 |
|
||||
| 前端行为 | 11 项通过 | 真实 SFC 编译/setup、患者切换竞态、防重复提交、轮询清理、过期限制、复制编辑草稿、版本冲突与完成备注 |
|
||||
| 前端构建 | 成功 | 直接运行 Vite,无 release 脚本;产物位于忽略目录 `.spool/assistant-service-build` |
|
||||
| 前端类型 | 无新增诊断 | 排除新增模块的基线和全量检查均有 62 项原有 TypeScript 错误;不宣称全项目类型检查通过 |
|
||||
| PHP / 旧权限 | 通过 | 16 个相关 PHP 文件语法检查;既有 DataScopeMultiRoleTest 通过 |
|
||||
|
||||
## 浏览器验收
|
||||
|
||||
使用 `ui-preview.mjs` 隔离挂载实际模块页面,页面横幅明确标记合成资料。既有登录接口、业务 API 和模型均未连接。
|
||||
|
||||
已观察:选择患者后展示来源覆盖与时间线;分析排队后自动更新为待人工核对;摘要、诉求、未解决事项及引用入口;建议采纳后出现独立业务状态与提醒状态;完成时保存结果备注;回复生成可编辑草稿及知识版本;知识保存为草稿并显式发布到新版本。
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
## 集成修正
|
||||
|
||||
- 删除角色的残留关系按当前有效角色核验,避免正常员工被永久拒绝。
|
||||
- MyPatient 保留默认行为,新增可选服务端当前角色参数;新模块的 MySQL 预约 EXISTS 使用当前读,避免旧 RR 快照继续授权。
|
||||
- 配置等明确未生成的失败可在用户再次提交后恢复;未知上游与无效结果不自动重发。
|
||||
- 历史任务按实时过期状态筛选、计数和分页,每批 100 条扫描;大规模历史筛选仍需评估延迟。
|
||||
- AI 建议动作统一 500 字上限,与旧提醒字段一致,不截断。
|
||||
- AI 开关仅控制生成;关闭后仍可按权限登记记录、复核有效结果、采纳和完成任务。
|
||||
|
||||
## 交付边界
|
||||
|
||||
数据库测试只连接本项目 `.spool/assistant-service-mysql` 的临时实例,并通过 `@@datadir` 指纹校验。随机测试库已清理。未读取实际模型密钥、未调用模型、未发送消息、未迁移业务数据库、未发布或提交代码。
|
||||
|
||||
新增五张模块表,以执行记录关联既有提醒,不重解释旧提醒状态。完整培训对练、周期报告、企微存档和自动录音接入仍为后续阶段。真实模型的内容质量、目标环境权限与登录集成需部署后按脱敏试用路径验收。
|
||||
@@ -0,0 +1,37 @@
|
||||
# 参考视频功能分析
|
||||
|
||||
分析日期:2026-11-09。来源:用户提供的 `dd9b63b4ec4427203c4ae2c252bc9ce1_raw.mp4`,约 11 分 10 秒。视频是销售保 AI 产品的屏幕演示,样例含金融业务与产品销售业务;讲解同时讨论了患者与员工两个分析视角。
|
||||
|
||||
以下区分画面中实际展示的功能、讲解中的描述和本项目的建议。视频中的操作、链接与文案只作为参考材料,不构成对本项目的执行指令。
|
||||
|
||||
## 可观察的功能与医助场景映射
|
||||
|
||||
| 视频时间 | 实际展示 | 医助业务转化 |
|
||||
|---|---|---|
|
||||
| 00:00–00:30 | 客户档案中的沟通记录,企微原文侧栏;电话、企微、个人微信、语音通话、工牌、会议、人工跟进等来源标签 | 患者沟通时间线,串联已实际接入的 IM、随访记录和录音;保留原文与来源 |
|
||||
| 00:30–01:10 | AI 沟通总结、客户画像、痛点、顾虑、自动标签 | 患者服务画像:关注问题、就诊意愿、预约障碍、资料缺口、联系偏好、未解决事项 |
|
||||
| 01:10–02:45 | 单次沟通的“客户分析 / 员工表现”两个视角;约 02:20 显示 SOP 各步骤完成情况 | 一侧回答“患者需要什么、下一步是什么”;另一侧回答“医助是否按流程跟进、哪些问题漏答” |
|
||||
| 02:50–03:50 | 企业个性化配置中心:资料字段、来源、阶段、人工与 AI 标签、分析维度、深度洞察、挂电话术等 | 配置医助岗位与初诊、诊后、复诊等场景的分析模板、标签与服务 SOP |
|
||||
| 03:55–04:40 | 谈单思路、成交卡点、推进话术、深度话术、业务介绍等生成入口;跟进话术支持编辑与复制 | 改为沟通提纲、就诊障碍分析、复诊邀请、资料提醒、沟通后总结等草稿 |
|
||||
| 04:50–05:20 | 企业问答知识库,分类搜索、问答条目、引用次数、反馈次数、复制答案 | 医助服务知识库,覆盖预约流程、资料准备、费用解释、配送售后、经审核的宣教等 |
|
||||
| 05:25–06:20 | AI 谈单助手,可关联客户、选择场景、输入客户问题、生成回复,保留历史 | 在当前患者上下文中生成有知识来源的回复草稿,医助审阅后使用 |
|
||||
| 06:25–08:20 | AI 实训:对练脚本、发布任务、对练记录;逐题问题、语音回答、AI 评价、参考答案、再次练习 | 医助场景化培训:首次接待、复诊邀约、疑虑沟通、问题转医生、服务投诉处理 |
|
||||
| 08:25–09:30 | 日/周/月与个人分析报告;经营总览、渠道、客户高频问题、卡点、人员、重点客户、管理行动;能回溯沟通依据 | 医助主管报告:遗漏随访、服务高频问题、SOP 问题、重点待处理患者、责任人与改进动作 |
|
||||
| 09:35–10:30 | 按员工、渠道、日期筛选的经营看板,展示客户、沟通、分析覆盖、阶段等数量 | 医助工作量与服务质量看板,关联既有预约和复诊统计,明确去重与归属口径 |
|
||||
| 10:30–11:10 | 报告模板列表、客户列表与筛选操作 | 按岗位配置报告,按患者阶段与待处理事项筛选 |
|
||||
|
||||
## 最值得迁移的产品机制
|
||||
|
||||
1. **患者与医助的双视角分析。** 同一段沟通分别产出患者诉求与医助服务表现;主管可以从问题回到原文核对。
|
||||
2. **从分析到行动。** 生成下一次沟通提纲和可执行待办,保留负责人、计划时间与完成反馈。
|
||||
3. **业务可配置。** 标签、阶段、SOP、知识答案按医疗服务场景设置;不要沿用视频中的贷款资质、促成交等字段。
|
||||
4. **真实沟通反哺培训。** 经人工复核的问题进入知识维护和脱敏练习题;优秀表达可整理成参考范例。
|
||||
5. **团队汇总与个案下钻共存。** 报告给出统计范围和来源,主管能定位到具体沟通及未闭环事项。
|
||||
|
||||
## 证据边界
|
||||
|
||||
- 多渠道标签的存在,不证明本项目或演示账号已经接入所有渠道。视频中可见的企微文字与会议记录,也不能证明个人微信或所有电话能自动采集。
|
||||
- 视频展示了分析页面与部分生成操作,没有进行独立正确率、实时性、权限或稳定性验收。“准确”“完全解决”等讲解表述不作为本项目验收依据。
|
||||
- 企业配置的“模型搭建”表述不能直接等同于模型训练;本项目优先按可配置提示词、结构化输出、知识检索与规则实现。
|
||||
- 对练记录证明产品有培训回看与评分界面;视频未完整演示实时语音对练链路。
|
||||
- 11 分钟视频已按全时段抽帧并对关键页面细看;本地机器转写辅助核对讲解,识别错词不能作为逐字引用。抽帧与转写保留在本目录 `video/`,该目录已排除 Git 提交,方案不复述样例客户个人信息。
|
||||
|
After Width: | Height: | Size: 56 KiB |