Files
zyt/artifacts/medical-assistant-feature-plan/automatic-dashboard-implementation.md
T
2026-11-12 09:07:07 +08:00

5.0 KiB
Raw Blame History

自动分析与团队总览后端交付

已完成本代理负责的后端接口、聚合、权限映射、自动入队入口与合成验证。未读取或修改 .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 或前端文件。