更新
This commit is contained in:
@@ -46,9 +46,9 @@
|
||||
|
||||
| 工具 | 数据来源（以调用账号身份执行后台原接口，口径与页面一致） | 权限（自身未登记时依次回退） |
|
||||
|---|---|---|
|
||||
| `zyt_perf_assistants` 医助业绩排行 | 业绩看板·医助排行榜 `YejiStatsLogic::assistantLeaderboards`：诊金、接诊诊单、接诊单数、预约诊单、被指派数、进线、接诊率；排名、合计、部门小计 | `stats.yejiStats/leaderboard` → `stats.yejiStats/tabLeaderboard` → `fans/yeji` |
|
||||
| `zyt_perf_doctors` 医生业绩排行 | 业绩看板·医生统计 `DoctorDailyStatsLogic::overview`：成交金额、接诊诊单、客单价、总挂号/完成/过号/取消、挂号率、系统/手动开方 | `stats.doctorDailyStats/overview` → `stats.yejiStats/tabDoctor` → `fans/yeji` |
|
||||
| `zyt_stats_performance` 部门业绩看板 | 业绩看板·甄养堂诊金 `YejiStatsLogic::overview`：各部门合计业绩、接诊诊单、接诊单数、预约、进线、被指派、投放成本、ROI | `stats.yejiStats/overview` → `stats.yejiStats/tabZyyt` → `fans/yeji` |
|
||||
| `zyt_perf_assistants` 医助业绩排行 | 业绩看板·医助排行榜 `YejiStatsLogic::assistantLeaderboards`：诊金、成交订单数（后台“接诊诊单”）、面诊完成数（后台“接诊单数”）、预约数、被指派数、进线数、每进线诊金；排名、合计、部门小计；单人时附处方业务订单列表对账 | `stats.yejiStats/leaderboard` → `stats.yejiStats/tabLeaderboard` → `fans/yeji` |
|
||||
| `zyt_perf_doctors` 医生业绩排行 | 业绩看板·医生统计 `DoctorDailyStatsLogic::overview`：成交金额、成交订单数（后台“接诊诊单”）、客单价、挂号总数/面诊完成/过号/取消、挂号成交率、系统/手动开方 | `stats.doctorDailyStats/overview` → `stats.yejiStats/tabDoctor` → `fans/yeji` |
|
||||
| `zyt_stats_performance` 部门业绩看板 | 业绩看板·甄养堂诊金 `YejiStatsLogic::overview`：各部门合计业绩、成交订单数、面诊完成数、预约数、进线数、被指派数、投放成本、ROI | `stats.yejiStats/overview` → `stats.yejiStats/tabZyyt` → `fans/yeji` |
|
||||
| `zyt_perf_trend` 业绩走势 | 一条按日分组的只读聚合 SQL（在同样的只读事务里），按日/周/月归并，可对比最多 4 人。医助口径同排行榜诊金（订单创建人，剔除取消/拒收/退款）；医生口径同医生统计成交金额（开方医生，另剔除发生过退款的订单） | 按医助同医助排行，按医生同医生统计 |
|
||||
|
||||
- 参数：`period`（today / yesterday / this_week / last_week / this_month / last_month / last_7_days / last_30_days，由服务器按当天计算）或 `start_date`/`end_date`；`dept` 可写部门名称（只在账号可见的部门里匹配）；`sort_by`、`top`、`name`/`*_id`；走势另有 `by`、`names`/`ids`、`granularity`、`metric`。
|
||||
@@ -56,6 +56,9 @@
|
||||
- 统计图：结果文字里带一个 ```` ```chart ```` 代码块（JSON：`type` bar/column/line、`title`、`subtitle`、`unit`、`labels`、`series`），行知把它画成统计图（可切换表格）；`structuredContent.chart` 同时提供。只有一行时不画图。
|
||||
- 权限回退（审核文件 `perm_fallback`）：子接口自身已登记时与后台完全一致；未登记时后台对该接口不校验、只靠 Tab/页面权限控制可见，这里改用第一个已登记的 Tab/页面权限，不会比后台页面更宽。同样的回退也加在了业绩看板的部门/渠道下拉和各明细子接口上。
|
||||
- 业绩看板、医生统计、提成结算、综合转化的单条 SQL 超时放宽到 30 秒（审核文件 `timeout`；后台控制器自己放宽到 120 秒）。
|
||||
- **指标命名（同日第二次修正）**：线上有人问“洛阳高坤艳本月才 21 单，为什么显示 96 单”。96 是后台排行榜的“接诊单数”——面诊完成的挂号人次，不是订单；订单数是“接诊诊单”（她的处方业务订单列表共 21 条，顶部业绩 ¥25,212 对应的是扣掉拒收/退款后的订单）。工具原先照搬后台列名还标成“单”，模型就把 96 说成了 96 单。现在输出一律用说清楚“数的是什么”的名称并附后台列名对账：面诊完成数（人次，后台“接诊单数”）、成交订单数（单，后台“接诊诊单”）、预约数（后台“预约诊单”）、每进线诊金（后台“接诊率”）、挂号成交率（后台“挂号率”）等；结果带 `definitions`（每个指标的口径），按非订单指标排名时摘要和图下说明都会提示“不是订单数”。
|
||||
- **单人对账**：`zyt_perf_assistants` 只匹配到一位医助时，同时按“医助（订单创建人）+ 同一时间段”查处方业务订单列表，返回 `order_list`（列表条数含全部状态、金额、其中计入业绩的金额、未计入业绩的条数），摘要写明“列表共 N 条……业绩只算未取消、未拒收、未退款的订单，所以成交订单是 M 单”。医生同理（按开方医生），但只对能看全量业务订单的账号给出，因为非全量角色在列表里按医生筛选只能看到自己创建的订单。
|
||||
- **统计明细翻页**：进线明细、被指派明细等“统计类”资源自己分页，以前 `zyt_query` 的外层 `page`/`page_size` 对它们不生效，模型翻页每次都拿到第一页，看起来像“同一条记录反复出现”；现在外层参数会传给这些接口，结果带 `result.paging`（总数、页码、是否还有下一页）。另外同一页里 ID 重复的行会去重并在结果里说明。
|
||||
- 同时修复：`params` 里写的 `page`/`page_size` 自动当作分页；限流与每日行数计数在缓存读写出错时放行并记日志（文件缓存下并发调用可能读到写了一半的文件，之前会让整次查询变成“内部错误”）；内部错误提示带上异常类型，便于对照服务器日志。
|
||||
- 授权接口：`POST /mcp/auth/grant`、`POST /mcp/auth/revoke`（Bearer）、`GET /mcp/auth/whoami`（Bearer），返回与后台一致的 `{code, show, msg, data}`；失败时 `data.reason` 为 `invalid_credentials / disabled / need_change_password / need_bind_wecom / no_ai_permission / locked / feature_disabled / ip_not_allowed / invalid_request`。
|
||||
|
||||
@@ -107,7 +110,7 @@ php app/mcp/cli/coverage.php
|
||||
|
||||
2026-09-24 本地结果（PHP 8.2.34 + MariaDB 10.11.19，表结构由仓库 SQL 重建）：三个测试全部通过；契约测试覆盖授权门禁与锁定、协议协商、401/403/405、医生/医助/经理/root 各自的数据范围、脱敏与明文权限、扩大范围参数拦截、撤销/改密/停用/闲置/去权限后立即失效、审计记录与后台管理接口。与行知的端到端联调（真实行知后端与任务引擎 + 本模块）通过：两名行知用户分别绑定医生、医助账号，各自任务只拿到自己数据范围内的挂号记录，手机号已脱敏，审计日志记录了行知任务号和返回的记录 ID。
|
||||
|
||||
业绩工具（同日增补）：`AiMcpPerfTest` 通过（医助诊金计入部分退款单、医生成交金额不计；取消单都不计；经理看两名下属医助/医生、医助只看自己；部门名称解析；按日/周/月走势；图表输出；排行榜权限点停用时回退到 Tab 权限）；原有三个测试与探测脚本无回归；行知端到端（真实行知后端 + MCP 客户端 + 本模块）确认模型拿到 4 个业绩工具、图表代码块完整到达并存入回答。上线只需同步 `server/app/mcp/`（新增 `service/PerfTools.php`，改动 `service/{Tools,Catalog,Dispatcher,RateLimiter,Protocol}.php`、`catalog/review/{stats.php,README.md}`），不涉及数据库。
|
||||
业绩工具（同日增补）：`AiMcpPerfTest` 通过（医助诊金计入部分退款单、医生成交金额不计；取消单都不计；经理看两名下属医助/医生、医助只看自己；部门名称解析；按日/周/月走势；图表输出；排行榜权限点停用时回退到 Tab 权限）；原有三个测试与探测脚本无回归；行知端到端（真实行知后端 + MCP 客户端 + 本模块）确认模型拿到 4 个业绩工具、图表代码块完整到达并存入回答。上线只需同步 `server/app/mcp/`（新增 `service/PerfTools.php`，改动 `service/{Tools,Catalog,Dispatcher,RateLimiter,Protocol}.php`、`catalog/review/{stats.php,README.md}`），不涉及数据库。第二次修正（指标命名、单人对账、统计明细翻页）只改 `service/{PerfTools,Tools,Protocol}.php` 与 `tests/AiMcpPerfTest.php`，四个测试全部通过。
|
||||
|
||||
## 7. 回退
|
||||
|
||||
|
||||
Reference in New Issue
Block a user