更新
This commit is contained in:
Your Name
@@ -0,0 +1,32 @@
|
||||
# 处方 AI 一致度可见范围：后台实现
|
||||
|
||||
日期：2026-10-17。范围仅后台新文件与本报告、验证截图；没有修改 `server/` 或桌面 `app/`，没有提交、发布或连接生产接口。已读根 `AGENTS.md`，当前工作区无 `.trellis/`。
|
||||
|
||||
## 交付文件
|
||||
|
||||
- `admin/src/views/setting/prescription_ai_visibility/index.vue`：独立配置页面，沿用现有 Element Plus 设置表单与底部保存栏。
|
||||
- `admin/src/api/setting/prescription_ai_visibility.ts`：专用 capabilities、配置读取/保存、角色与用户选项接口及类型；对配置响应进行运行时校验。
|
||||
- `admin/tests/prescription-ai-visibility.test.cjs`：8 项 Node 测试，编译真实 Vue SFC、运行真实 setup 状态，并模拟 API；不调用真实后端。
|
||||
- `artifacts/prescription-ai-visibility-admin-local.png`：本地模拟浏览器截图。
|
||||
|
||||
## 行为
|
||||
|
||||
角色多选可搜索名称；用户多选标签包含姓名与账号，因此均可搜索。选项完全来自 `tcm.prescriptionAi/visibilityOptions`，不额外请求角色列表或管理员列表接口。当前已配置但不在活跃选项中的 ID 以明确占位标签保留；只有用户显式移除后保存才取消该项。
|
||||
|
||||
页面明确说明：角色或指定用户任一命中即可；两份名单均为空时所有账号（包括 root）均隐藏一致度、逐味对照与一致度统计；root 可管理策略，但管理权限不自动赋予查看权。AI 报告继续按原有权限开放，已有报告不受影响，原有患者/处方数据范围继续适用。
|
||||
|
||||
先读取 `capabilities.can_manage_visibility`，只有严格为 `true` 才读取配置与选项。两者全部成功后才填入并启用表单；首次失败不展示空表单，重新加载失败保留既有选择并禁用保存。保存期间禁用输入、重载及重复提交；失败保留当前选择并给出重试/重新读取提示；成功应用后端返回的规范化名单。配置响应缺字段、含非数字/非正整数 ID 等异常会拒绝，不会降级成可保存的空策略。
|
||||
|
||||
后端菜单需指向 `setting/prescription_ai_visibility/index`，管理权限为 `tcm.prescriptionAi/manageVisibility`；菜单迁移及服务端自鉴权由后端任务实现。
|
||||
|
||||
## 验证
|
||||
|
||||
1. `node --test tests/prescription-ai-visibility.test.cjs`：8/8 通过。覆盖固定接口契约、配置坏响应、pending/失败禁止保存、选项失败不部分覆盖策略、缺失 ID 保留、姓名账号标签、空名单与规范化回显、防重复提交、保存失败保留、管理与查看能力分离、真实模板编译。
|
||||
2. 对新增 API、Vue 页面、测试执行 Prettier `--check`：通过。
|
||||
3. 针对新增 API 与页面的临时 `vue-tsc` 项目（严格模板，使用真实 Element Plus/Vue 类型，隔离 request/feedback 的外部依赖）：通过，无类型错误。
|
||||
4. 全后台 `vue-tsc --noEmit --pretty false --incremental false --composite false`：退出 2，报告 61 项新文件范围外的错误；没有错误涉及 `prescription_ai_visibility`。完整日志位于 `%TEMP%/zyt-prescription-ai-visibility-vue-tsc.log`。本任务没有扩大修改范围修复这些错误。
|
||||
5. 独立 `127.0.0.1:5568` Vite 浏览器模拟，使用真实新页面、Element Plus、后台样式与 FooterBtns；所有 API 均映射到本地假数据模块，没有加载主应用或真实网络请求。确认成功读取、缺失 ID 标签、账号 `li.assistant` 搜索、保存 pending 禁用、保存成功提示、加载失败禁用保存、保存失败保留修改、空名单警示及无管理权限状态。
|
||||
|
||||
未运行 `npm run build`，避免其自带 release 脚本；实际 Vite 浏览器编译已成功。临时验证 harness 位于忽略的 `admin/node_modules/.cache/prescription-ai-visibility/`，不属于业务交付。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user