更新
This commit is contained in:
Your Name
@@ -0,0 +1,565 @@
|
||||
# 诊单详情 / 编辑 / 预约视觉规格（后台源码基准）
|
||||
|
||||
## 1. 范围与判读原则
|
||||
|
||||
本规格只以 `D:/web/zyt/admin` 当前源码为事实源，覆盖：
|
||||
|
||||
- 三个主视图：`src/views/tcm/diagnosis/edit.vue`、`readonly.vue`、`appointment.vue`。
|
||||
- 三个主视图直接渲染的诊单组件：患者摘要、病例、日常记录、医生备注、处方/病例记录、业务订单、视频、聊天、医助指派历史、挂号历史、待办。
|
||||
- 备注视图直接引用的 `src/views/patient/reception/components/NoteTimeline.vue`。
|
||||
- 直接生效的全局样式入口、Element Plus 变量和 Tailwind 尺寸映射。
|
||||
|
||||
颜色、尺寸若由当前文件明确声明，标为“显式”；若控件仅沿用 Element Plus，则标为“继承”。项目使用 Element Plus `^2.9.4` 与 Tailwind CSS `^3.4.17`（`package.json:27,64`）。全局样式入口为 `main.ts:1-3`，依次加载 `element.scss`、`dark.css`、`var.css`、`tailwind.css`、`public.scss`（`src/styles/index.scss:1-5`）。因此不能把浏览器/Element 默认值误写成某个业务组件的局部规格。
|
||||
|
||||
> 关键结论：系统实际上有两种“只读详情”。`readonly.vue` 是独立、卡片化、纵向详情页；`edit.vue` 在 `viewOnly` 模式下则仍是右侧抽屉和 Tab 结构，只禁用编辑控件。两者不能用同一个线框替代。
|
||||
|
||||
---
|
||||
|
||||
## 2. 全局视觉基础
|
||||
|
||||
### 2.1 字体与字号
|
||||
|
||||
字体栈由 Tailwind 配置明确为 `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei, sans-serif`（`tailwind.config.js:79-80`），并赋给 `--el-font-family`（`src/styles/var.css:1-3`）。基础字号如下（`src/styles/var.css:11-18`）：
|
||||
|
||||
| 语义 | 实际字号 |
|
||||
|---|---:|
|
||||
| extra large | 18 px |
|
||||
| large | 16 px |
|
||||
| medium | 15 px |
|
||||
| base | 14 px |
|
||||
| small | 13 px |
|
||||
| extra small | 12 px |
|
||||
|
||||
业务层进一步压缩：编辑抽屉根节点和表单文字为 12 px（`edit.vue:1476-1504,1532-1556`）；只读病例键值为 12.5 px（`components/PatientCaseCard.vue:307-341`）；聊天气泡为 14 px（`components/ImChatRecordPanel.vue:260-286`）。
|
||||
|
||||
### 2.2 全局颜色与表面
|
||||
|
||||
以下均为项目显式变量（`src/styles/var.css:20-40`）：
|
||||
|
||||
| 用途 | 色值 |
|
||||
|---|---|
|
||||
| 页面底 | `#f6f6f6` |
|
||||
| 普通/浮层底 | `#ffffff` |
|
||||
| 主文字 | `#333333` |
|
||||
| 常规文字 | `#666666` |
|
||||
| 次要文字 | `#999999` |
|
||||
| placeholder | `#a8abb2` |
|
||||
| disabled | `#c0c4cc` |
|
||||
| border / light / lighter | `#dcdfe6` / `#e4e7ed` / `#ebeef5` |
|
||||
| extra-light border | `#f2f2f2` |
|
||||
| fill / light / lighter | `#f0f2f5` / `#f8f8f8` / `#fafafa` |
|
||||
| extra-light fill | `#fafcff` |
|
||||
|
||||
Element 语义主色未在这些诊单文件中改写，局部引用 `var(--el-color-primary)` 或显式 `#409eff`。继承的 Element Plus 2.9.4 常规控件高度为 32 px（small 24 px、large 40 px）；但编辑抽屉底部按钮被局部覆盖为最小 40 px，移动端最小 44 px（`edit.vue:1732-1740,1905-1913`）。
|
||||
|
||||
### 2.3 间距基线和全局行为
|
||||
|
||||
Tailwind 间距映射是 4 px 基线：`1=4`、`2=8`、`2.5=10`、`3=12`、`3.5=14`、`4=16`、`5=20`、`6=24`（`tailwind.config.js:103-125`）。业务文件里的 8/10/12/14/16/18/20/24 px 与该节奏一致。
|
||||
|
||||
直接影响这些页面的全局规则：
|
||||
|
||||
- Dialog 居中，最大宽 `calc(100vw - 30px)`，圆角 5 px（`src/styles/element.scss:11-27`）。
|
||||
- 全局 Drawer 主内边距变量为 16 px，Header 内边距 `13px 16px`、下边框 1 px lighter；预约 Drawer 没有重写这些值，编辑 Drawer 则只额外重写背景与边框（`src/styles/element.scss:46-56`）。
|
||||
- 全局表格字号 14 px、表头主文字色、表头字重 400、表头底 `#f8f8f8`（`src/styles/element.scss:58-68`; `src/styles/var.css:10`）。因此编辑根节点的 12 px 不应错误地传成所有表格单元字号。
|
||||
- Input、Select、Textarea 聚焦时出现 2 px primary-light 外环，radio/checkbox active 也有 2 px 外环；校验错误时切换 danger-light 外环（`src/styles/element.scss:140-175`）。
|
||||
- Tabs 底线全局压至 1 px（`src/styles/element.scss:131-133`）。
|
||||
- 消息与通知层级为 9999（`src/styles/element.scss:1-9`）。
|
||||
- 小于等于 768 px 时分页隐藏页码跳转与 page-size 选择器（`src/styles/element.scss:177-183`）。
|
||||
- Tailwind 会导入 base/components/utilities（`src/styles/tailwind.css:1-3`），但 Element 按钮背景、focus、hover 被重新还原为 Element 变量，避免被 Tailwind reset 覆盖（`src/styles/element.scss:186-200`）。
|
||||
- `body` 为 14 px 主文字、`overflow:hidden`、最小宽 375 px；页面/Drawer 自己承担滚动（`src/styles/public.scss:1-3`）。全局 `.form-tips` 为 12 px secondary、行高 24 px、上间距 4 px（`src/styles/public.scss:4-6`）。
|
||||
|
||||
暗色主题另有一套直接全局变量：页面/表面为 `#0a0a0a / #1d2124 / #1d1e1f`，主/常规/次要文字为 `#e5eaf3 / #cfd3dc / #a3a6ad`，边框从 `#636466` 到 `#2b2b2c`，遮罩为 `rgba(0,0,0,.8)`（`src/styles/dark.css:1-31`）。不过三个诊单主视图及卡片大量显式写入白底、浅蓝渐变和 slate 色，不能完整随暗色变量切换；本规格后续均按源码默认浅色态记录，暗色不能视为已完整适配。
|
||||
|
||||
---
|
||||
|
||||
## 3. 独立只读详情页 `readonly.vue`
|
||||
|
||||
### 3.1 页面骨架
|
||||
|
||||
源码结构是单列滚动页，不使用 Tabs（`readonly.vue:1-149`）：
|
||||
|
||||
```text
|
||||
┌─────────────────────────────────────────────────────────────────────┐
|
||||
│ ← 返回 诊单只读详情 张三 男 · 42岁 [未服务 3天] │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [患者信息摘要 PatientInfoCard] │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [患者病例 PatientCaseCard] │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [日常记录 DailyMatrix] 按权限可见 │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [医生备注/舌象/报告 NoteTimeline] │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [业务订单 PatientOrderList] 按权限可见 │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [视频录制回放 CallRecordPanel] 按权限可见 │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [聊天 ImChatRecordPanel] 按权限可见 │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [指派医助记录 AssignLogPanel] 按权限可见 │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ [挂号记录 AppointmentRecordPanel] 按权限可见 │
|
||||
└─────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
渲染顺序严格来自 `readonly.vue:39-146`；异常时在 hero 下方显示错误空态（`readonly.vue:31-36`）。页面根容器垂直间距 16 px、内边距 16 px（`readonly.vue:269-273`）。
|
||||
|
||||
### 3.2 顶部 Hero
|
||||
|
||||
Hero 是可换行的左右布局：`display:flex; justify-content:space-between; flex-wrap:wrap; gap:12px`，内边距 `12px 16px`，圆角 12 px，边框 `#dde7ff`，背景为 `#f5f8ff → #eef3ff` 的浅蓝渐变（`readonly.vue:275-285`）。
|
||||
|
||||
- 页面标题：16 px / 700（`readonly.vue:286-303`）。
|
||||
- 患者姓名：18 px / 700；性别年龄 13 px（`readonly.vue:305-320`）。
|
||||
- 未服务状态胶囊：12 px / 600，内边距 `4px 10px`，999 px 全圆角（`readonly.vue:323-330`）。
|
||||
- 状态色：正常绿 `#16a34a` / 边框 `#bbf7d0`；提醒橙 `#ea580c` / `#fed7aa`；严重红 `#dc2626` / `#fecaca`（`readonly.vue:332-355`）。从未记录时使用 Element placeholder 灰。
|
||||
|
||||
### 3.3 卡片规格
|
||||
|
||||
通用详情卡为白底、1 px `#e6ebf2` 边框、14 px 圆角、18 px 内边距、14 px 内部纵向间距和轻阴影（`readonly.vue:364-373`）。卡片标题 15 px / 700，标题前为 `3 × 16 px` 蓝色标记（`readonly.vue:375-396`）。DailyMatrix 外层额外 16 px 内边距以对齐矩阵（`readonly.vue:398-405`）。错误空态卡保持 14 px 圆角并有 40 px 纵向内边距（`readonly.vue:357-362`）。
|
||||
|
||||
患者摘要内部是浅蓝 Hero 卡：圆角 12 px，内边距 `16px 18px`，行距 6 px；患者名 22 px / 700，其余信息 13 px、行高 1.7（`components/PatientInfoCard.vue:78-123`）。字段顺序是：
|
||||
|
||||
1. 姓名。
|
||||
2. 脱敏手机 · 性别 · 年龄。
|
||||
3. 身高 / 体重 · 地区。
|
||||
4. 预约日期时间 · 时段。
|
||||
5. 医生 / 医助。
|
||||
6. 预约状态 · 是否已开方。
|
||||
7. 备注（有值才显示）。
|
||||
|
||||
顺序由 `components/PatientInfoCard.vue:6-25` 确定。
|
||||
|
||||
### 3.4 病例字段顺序与网格
|
||||
|
||||
病例卡以分组标题 + 网格键值展示；组间 `gap:10px`，除首组外顶部 12 px 内边距并有 dashed 分隔线（`components/PatientCaseCard.vue:258-269`）。分组标题 13 px / 600、蓝色，前有 4 px 圆点（`components/PatientCaseCard.vue:271-287`）。网格横向间距 16 px、纵向 8 px，并提供 1/2/3/4 等分列（`components/PatientCaseCard.vue:289-305`）。键值字号 12.5 px、行高 1.55，label 最小宽 58 px；label 为 `#6b7280`，value 为 `#1f2937` / 500，空值为 `#c0c4cc`（`components/PatientCaseCard.vue:307-341`）。
|
||||
|
||||
只读病例的真实字段顺序（`components/PatientCaseCard.vue:8-124`）：
|
||||
|
||||
| 分组 | 列数 | 顺序 |
|
||||
|---|---:|---|
|
||||
| 基本信息 | 4 | 诊单ID、姓名、身份证、手机、性别、年龄、婚姻、地区 |
|
||||
| 生命体征 | 4 | 身高、体重、高压、低压、诊断类型、空腹血糖、在用药物（多行） |
|
||||
| 主诉 | 4 | 当地诊断日期、糖尿病病史、当地医院、当地医院诊断结果 |
|
||||
| 现病史 | 3 | 口腔、饮水、体重变化、脂肪肝、饮食（跨2列）、肢体、睡眠、眼、头、出汗、皮肤、小便、大便、腰肾、其他补充（跨3列、多行） |
|
||||
| 既往史 | 1 | 既往史（整行） |
|
||||
| 其他病史 | 混合 | 外伤、手术、过敏、家族、妊娠 |
|
||||
| 补充与意见 | 1 | 病史补充（有值才显示）、处方意见 |
|
||||
|
||||
超标指标采用 `#dc2626`、700 字重并带上箭头（`components/PatientCaseCard.vue:343-358`）。处方意见为 13 px、`12px 14px` 内边距、8 px 圆角、左侧 3 px 蓝条（`components/PatientCaseCard.vue:360-368`）。
|
||||
|
||||
### 3.5 响应式事实
|
||||
|
||||
`readonly.vue` 自身没有 media query；Hero 仅通过 `flex-wrap` 避免左右信息互相挤压。`PatientCaseCard.vue` 也没有窄屏降列规则，所以 4 列病例网格不会自动变成 1 列。实现 PySide 时不能把“可换行 Hero”误判为整页已经完整响应式。
|
||||
|
||||
---
|
||||
|
||||
## 4. 编辑 / 抽屉只读 `edit.vue`
|
||||
|
||||
### 4.1 框架与模式
|
||||
|
||||
右侧 Drawer 宽度固定为视口的 60%，方向 RTL；只读时 z-index 4000，编辑/新增时 1500（`edit.vue:2-10`）。抽屉有三种标识：只读 `info`、新建 `success`、编辑 `warning`，标题下显示“患者名 · 诊单ID”（`edit.vue:11-54,859-863`）。
|
||||
|
||||
```text
|
||||
桌面（右侧 60% Drawer）
|
||||
┌───────────────────────────────────────────────────────────────┐
|
||||
│ 编辑诊单 [编辑] 患者名 · #123 │ Header
|
||||
├───────────────────────────────────────────────────────────────┤
|
||||
│ 病历 │ 医生备注 │ 日常记录 │ 处方 │ 业务订单 │ 视频 │ ... → │ Tabs
|
||||
├───────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ [锁定提示 / 隐私提示，按条件] │
|
||||
│ 诊单ID [_____________________________] │
|
||||
│ 姓名 [____________] 身份证 [____________] │
|
||||
│ │
|
||||
│ ──────────────── 生命体征 ──────────────── │
|
||||
│ 婚姻 [____] 身高 [____] 体重 [____] │ Scroll body
|
||||
│ ... │
|
||||
│ ──────────────── 现病史 ───────────────── │
|
||||
│ [可换行 radio / checkbox 组] │
|
||||
│ │
|
||||
├───────────────────────────────────────────────────────────────┤
|
||||
│ [取消/关闭] [保存] │ Footer slot
|
||||
└───────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
`viewOnly` 模式没有切换到独立详情卡，而是给病历 `fieldset` 禁用输入，并隐藏保存；锁定患者信息时显示 warning alert（`edit.vue:57-84,766-781`）。
|
||||
|
||||
### 4.2 Header、Tabs、Footer
|
||||
|
||||
- Header 背景 `#fff → #f8fafc`，底边 1 px `#e2e8f0`（`edit.vue:1776-1785`）。标题 18 px / 600 / `#0f172a`，行高 1.3；副标题 13 px（`edit.vue:1670-1717`）。
|
||||
- Body 背景 `#f8fafc`（`edit.vue:1787-1790`）。
|
||||
- Tabs 横向滚动，滚动条 4 px；nav 使用 `max-content` 且最小宽 100%，tab 水平内边距 14 px，常态 `#64748b` / 500，激活态为 Element primary / 600，激活条 3 px（`edit.vue:1798-1858`）。
|
||||
- Footer 最终生效样式为白底、上边框 1 px `#e2e8f0`，内容右对齐、gap 12 px、内边距 `14px 20px 18px`（`edit.vue:1719-1730,1860-1864`）。按钮最小高 40 px、水平内边距 20 px、600 字重、圆角 10 px（`edit.vue:1732-1740`）。
|
||||
|
||||
这里没有 CSS `position: sticky`。底部操作之所以视觉上固定，是因为它使用 Element Drawer 的独立 footer slot，位于可滚动 body 之外（模板 `edit.vue:766-781`；结构样式 `edit.vue:1792-1796`）。PySide 应以固定底栏实现，而不是在滚动内容末尾放按钮。
|
||||
|
||||
### 4.3 Tab 顺序、权限与内容
|
||||
|
||||
Tab 的准确顺序和门槛（`edit.vue:55-759`）：
|
||||
|
||||
| 序号 | Tab | 条件 | 内容组件 |
|
||||
|---:|---|---|---|
|
||||
| 1 | 病历 | 始终 | 内联表单 |
|
||||
| 2 | 医生备注 | 始终 | `NoteTimeline` |
|
||||
| — | 跟踪备注 | **已注释，不渲染** | 原拟 `TrackingNoteTimeline`（`edit.vue:644-654`） |
|
||||
| 3 | 日常记录 | `tcm.diagnosis/dailyRecord` | `DailyMatrix` |
|
||||
| 4 | 处方 | `tcm.diagnosis/chufang` | `CaseRecordList` |
|
||||
| 5 | 业务订单 | `tcm.diagnosis/patientOrders` | `PatientOrderList` |
|
||||
| 6 | 视频录制回放 | `tcm.diagnosis/huifang` | `CallRecordPanel` |
|
||||
| 7 | 聊天 | `tcm.diagnosis/chat` | `ImChatRecordPanel` |
|
||||
| 8 | 指派医助记录 | `tcm.diagnosis/assign` 或 `tcm.diagnosis/detail` | `AssignLogPanel` |
|
||||
| 9 | 挂号记录 | `doctor.appointment/lists` | `AppointmentRecordPanel` |
|
||||
|
||||
权限变化后若当前 Tab 失权，代码会主动回到 `basic`（`edit.vue:883-913`）。除病历外的大部分 Tab 为 lazy 内容，首次选中才加载。
|
||||
|
||||
### 4.4 病历表单布局、标签和控件
|
||||
|
||||
桌面表单 label width 为 160 px（`edit.vue:61-63`）。根字号、label、输入/textarea/radio/checkbox/button 均显式为 12 px；label 为 500 / `#606266`（`edit.vue:1476-1504,1532-1556`）。表单项底部间距 18 px（`edit.vue:1528-1530`）。输入、选择、日期、数字框圆角 10 px（`edit.vue:1645-1667`）；普通输入高度沿用 Element 32 px。
|
||||
|
||||
分组标题的上/下外边距为 28/22 px；中间文字 14 px / 600 / `#0f172a`、`7px 16px` 内边距、999 px 胶囊圆角，两侧 1 px `#e2e8f0` 横线（`edit.vue:1506-1525`）。单选紧凑组换行、gap 12 px；复选组 gap `12px 16px`；普通 radio/checkbox 右、下间距分别 16/8 px（`edit.vue:1558-1604`）。帮助文本 12 px、`#909399`、行高 1.5、顶部 4 px（`edit.vue:1606-1611`）。
|
||||
|
||||
### 4.5 编辑表单的真实字段顺序
|
||||
|
||||
以下只列实际渲染字段，不把 `formData` 中未渲染的属性当作 UI（模板 `edit.vue:57-632`）：
|
||||
|
||||
| 区段 | 栅格 | 字段顺序与控件 |
|
||||
|---|---|---|
|
||||
| 顶部 | 24 | 诊单ID（只读） |
|
||||
| 基本身份 | 12 + 12 | 姓名；身份证 |
|
||||
| 联系信息 | 12 + 12 | 手机；性别 |
|
||||
| 年龄 | 12 | 年龄 |
|
||||
| **生命体征** | 8 + 8 + 8 | 婚姻；身高；体重 |
|
||||
| | 8 + 8 + 8 | 地区；高压；低压 |
|
||||
| | 8 | 空腹血糖 |
|
||||
| | 12 | 诊断类型 |
|
||||
| | 12 + 12 | 状态；渠道 |
|
||||
| | 12 | 统计端就诊卡 |
|
||||
| | 12 | 在用药物，textarea，3 行，maxlength 2000 |
|
||||
| **主诉** | 12 + 12 | 当地诊断日期；糖尿病病史 |
|
||||
| | 24 | 当地医院诊断结果（check buttons） |
|
||||
| | 24 | 当地医院名称 |
|
||||
| **现病史** | 24 | 口腔感觉（check buttons） |
|
||||
| | 24 | 每日饮水量（radio buttons） |
|
||||
| | 24 | 近月体重变化（radio buttons） |
|
||||
| | 24 | 脂肪肝（radio buttons） |
|
||||
| | 24 | 饮食（check buttons） |
|
||||
| | 24 × 9 | 肢体、睡眠、眼睛、头部、出汗、皮肤、小便、大便、腰肾 |
|
||||
| | 24 | 其他补充，textarea，3 行 |
|
||||
| **既往史** | 24 | 既往史（check buttons） |
|
||||
| **其他病史** | 8 + 8 + 8 | 外伤；手术；过敏 |
|
||||
| | 12 + 12 | 家族；妊娠 |
|
||||
| **诊断信息** | 24 | 病史补充，textarea，2 行 |
|
||||
|
||||
具体模板行：顶部/身份 `edit.vue:86-194`；生命体征 `edit.vue:199-368`；主诉 `edit.vue:369-412`；现病史 `edit.vue:414-549`；既往史 `edit.vue:552-564`；其他病史 `edit.vue:567-613`；诊断信息 `edit.vue:616-629`。
|
||||
|
||||
当前模板没有显示 `syndrome_type`、`diabetes_type`、舌象、脉象、治则、医嘱等字段，即便脚本模型中存在，也不应擅自加入视觉复刻。
|
||||
|
||||
### 4.6 移动端
|
||||
|
||||
小于等于 768 px 时（`edit.vue:1876-2004`）：
|
||||
|
||||
- Drawer 变为 100vw；header `12px 14px`，body `10px 12px`。
|
||||
- Footer 改为纵向、按钮全宽，gap 10 px，内边距 `12px 14px + safe-area`，按钮最小 44 px。
|
||||
- 标题 17 px；Tab 高/行高 44 px、字号 13 px、水平内边距 12 px。
|
||||
- label 改到控件上方：100% 宽、左对齐、下间距 6 px；表单项底部 14 px。
|
||||
- 所有 `el-col` 强制 100%，数字框 100%；radio gap `8px 16px`，checkbox `8px 10px`。
|
||||
- 分组标题外边距 18/14 px，文字 13 px、水平内边距 10 px。
|
||||
|
||||
```text
|
||||
移动端（<=768）
|
||||
┌──────────────────────┐
|
||||
│ 标题 [状态] × │
|
||||
│ 患者 · 诊单ID │
|
||||
├──────────────────────┤
|
||||
│ ← 可横向滚动 Tabs → │
|
||||
├──────────────────────┤
|
||||
│ 姓名 │
|
||||
│ [__________________] │
|
||||
│ 身份证 │
|
||||
│ [__________________] │
|
||||
│ ... 全部单列 ... │
|
||||
├──────────────────────┤
|
||||
│ [取消/关闭 全宽] │
|
||||
│ [保存 全宽，44px+] │
|
||||
└──────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 预约抽屉 `appointment.vue`
|
||||
|
||||
### 5.1 骨架与字段顺序
|
||||
|
||||
预约同样是 RTL 右侧 Drawer，宽 60%，z-index 2000，且点击遮罩不能关闭（`appointment.vue:2-9`）。表单 label width 为 100 px（`appointment.vue:19`）。
|
||||
|
||||
```text
|
||||
┌───────────────────────────────────────────────────────────────┐
|
||||
│ 预约面诊 × │
|
||||
├───────────────────────────────────────────────────────────────┤
|
||||
│ [今日重复预约警告 / 其他日期提示，条件显示] │
|
||||
│ 上次面诊 2026-08-01 10:30 │
|
||||
│ 预约方式 (●) 按时间预约 │
|
||||
│ 预约类型 (●) 视频面诊 │
|
||||
│ 预约患者 (●) 当前患者 │
|
||||
│ 渠道来源 [请选择 ▼] │
|
||||
│ 自媒体详情 [请选择 ▼] ← 仅自媒体渠道 │
|
||||
│ 预约医生 ( ) 医生A ( ) 医生B ... │
|
||||
│ 预约时间 [08月10日 周一] [08月11日 周二] ... │
|
||||
│ ┌───────────────────────────────────────────┐ │
|
||||
│ │ 可预约时段 [刷新] │ │
|
||||
│ │ [09:00 可约] [09:30 已满] [10:00 可约] ...│ │
|
||||
│ └───────────────────────────────────────────┘ │
|
||||
│ 备注 [_________________________________________] │
|
||||
├───────────────────────────────────────────────────────────────┤
|
||||
│ [取消] [确认预约] │
|
||||
└───────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
字段顺序严格为（`appointment.vue:21-181`）：
|
||||
|
||||
1. 上次面诊（文本）。
|
||||
2. 预约方式（当前只呈现按时间预约）。
|
||||
3. 预约类型（视频）。
|
||||
4. 预约患者（当前患者）。
|
||||
5. 渠道来源（必填 select）。
|
||||
6. 自媒体详情（渠道命中自媒体白名单时必填）。
|
||||
7. 预约医生（radio 列表）。
|
||||
8. 预约时间：先日期按钮，后可预约时段矩阵。
|
||||
9. 备注（textarea，2 行）。
|
||||
10. Footer：取消、确认预约。
|
||||
|
||||
### 5.2 尺寸、颜色与交互状态
|
||||
|
||||
- 渠道控件宽 100%、最大宽 360 px（`appointment.vue:741-750`）。
|
||||
- 医生/单选组可换行，gap 12 px（`appointment.vue:752-765,911-921`）。
|
||||
- 日期按钮 flex-wrap、gap 10 px、最小宽 130 px、高 40 px、字号 14 px、圆角 8 px；hover 上移 2 px并加阴影（`appointment.vue:771-789`）。
|
||||
- 时段容器底 `#f8f9fa`、圆角 8 px、内边距 16 px；标题 15 px / 600 / `#303133`（`appointment.vue:791-808`）。
|
||||
- 时段网格 `auto-fill minmax(110px,1fr)`、gap 10 px、最大高 450 px并滚动，滚动条宽 6 px（`appointment.vue:810-830`）。
|
||||
- 时段卡白底，2 px `#e4e7ed` 边框、8 px 圆角、最小高 70 px、水平内边距 8 px；时间 15 px / 600 / `#303133`，状态 12 px / `#909399`（`appointment.vue:831-862`）。
|
||||
- 可约 hover：`#409eff` 边框、`#ecf5ff` 底、上移并加阴影（`appointment.vue:864-873`）。
|
||||
- 不可约：`#f5f7fa` 底、opacity 0.6、文字 `#c0c4cc`（`appointment.vue:875-894`）。
|
||||
- 选中：`#409eff → #66b1ff` 渐变、白字和阴影（`appointment.vue:896-909`）。
|
||||
- Footer 右对齐、gap 12 px、上下内边距 12 px（`appointment.vue:923-928`）。
|
||||
|
||||
状态逻辑是视觉的一部分：未选医生时显示“请先选择医生”，无排班显示空态；日期只来自当前及未来有效排班（`appointment.vue:299-326`）；当天过去时段禁用（`appointment.vue:328-357`）；当天已有预约显示 warning，其他日期重复信息为 info（`appointment.vue:359-375`）。提交按钮只有医生、日期、时间、渠道以及条件性渠道详情齐全，且不存在当天冲突时才可用（`appointment.vue:377-386`）。
|
||||
|
||||
### 5.3 响应式事实
|
||||
|
||||
`appointment.vue` 没有移动端 media query。内部医生、日期和 slot 网格会换行，但 Drawer 在窄屏仍保持 60% 视口宽。这是后台源码的真实缺口；PySide 若要求窗口缩小时可用，应保留桌面 60% 的视觉比例，同时设置合理最小内容宽并在不足时切到全宽/单列，而不声称这是 Vue 原实现已有行为。
|
||||
|
||||
---
|
||||
|
||||
## 6. 备注、日常记录、处方/订单与历史关联区
|
||||
|
||||
### 6.1 医生备注 / 舌象 / 报告
|
||||
|
||||
编辑 Drawer 和独立只读页均使用 `NoteTimeline`（`edit.vue:633-643`; `readonly.vue:56-72`）。编辑态顶部按权限显示“新增备注、选择舌象、选择报告”；只读态隐藏这些操作（`src/views/patient/reception/components/NoteTimeline.vue:1-123`）。
|
||||
|
||||
视觉规格（`NoteTimeline.vue:272-436`）：
|
||||
|
||||
- 顶部动作行 gap 12 px、底部分隔线。
|
||||
- 时间轴左内边距 22 px，轴线 2 px `#ebeef5`；节点 10 px、`#409eff`，外圈 `#ecf5ff`。
|
||||
- 日期 13 px / 600 / `#303133`，等宽数字；正文 12.5 px / `#606266` / 1.6 行高。
|
||||
- 舌象缩略图 `64 × 64 px`、圆角 6 px、带边框；删除为红色动作。
|
||||
- 报告文件 chip 为 `6px 10px`、圆角 6 px、12 px primary 字，最大宽 180 px。
|
||||
- 上传格 `90 × 90 px`、1 px dashed `#dcdfe6`、圆角 6 px、12 px；hover 转 primary。
|
||||
- 新增备注 Dialog 宽 480 px，textarea 4 行、maxlength 500。
|
||||
|
||||
`TrackingNoteTimeline` 当前并未进入可见 Tab：`edit.vue:644-654` 将整段注释。不能在复刻中把它当作现存“跟踪备注”页签。
|
||||
|
||||
### 6.2 日常记录、趋势与待办
|
||||
|
||||
DailyMatrix 顶部提供最近 7 天 / 30 天 / 自定义日期和日期范围；右侧有本人记录图例、编辑动作与血糖血压/饮食/运动/备注/刷新按钮，readonly 仅保留刷新（`components/DailyMatrix.vue:1-129`）。矩阵的指标顺序为：空腹、餐后2小时、其他血糖、血压、西药、胰岛素、早餐、午餐、晚餐、运动、跟踪备注（`components/DailyMatrix.vue:410-485`）。固定指标列 120 px，日期列最小 100 px。
|
||||
|
||||
- 根内边距 16 px；toolbar 换行、gap 12 px、下间距 12 px（`DailyMatrix.vue:1090-1105`）。
|
||||
- 趋势卡上间距 16 px、内边距 `16px 18px`、圆角 10 px，图表高 280 px（`DailyMatrix.vue:1124-1158`）。
|
||||
- 超标红 `#dc2626` / 700；本人记录用紫色浅底，徽章 `#6d28d9 / #ede9fe / #ddd6fe`（`DailyMatrix.vue:1182-1225`）。
|
||||
- <=768 px 时根内边距 12 px，图表内边距 12 px、高 240 px（`DailyMatrix.vue:1240-1260`）。
|
||||
|
||||
待办区域位于 DailyMatrix 下方，标题 14 px / 600。表格字段依次为提醒时间、内容、状态、创建人、推送时间、错误信息、操作；toolbar 可筛全部/待推送/已推送/失败/已取消（`components/DiagnosisTodoList.vue:1-112`）。新增 Dialog 宽 520 px、label 100 px，字段顺序为提醒时间、内容（4 行/500 字）、提醒人；toolbar 换行、gap 8 px、下间距 12 px，分页右对齐（`DiagnosisTodoList.vue:291-319`）。
|
||||
|
||||
### 6.3 处方 / 病例历史
|
||||
|
||||
`CaseRecordList` 顶部编辑态显示小号 primary“开方”，只读时隐藏。表格字段顺序：就诊日期（120）、就诊编号（120）、诊断（min 160）、处方摘要（min 180）、医生（90）、状态（140）、操作（120 固定右侧）；根内边距 20 px（`components/CaseRecordList.vue:1-39,103-106`）。
|
||||
|
||||
点击“开方”进入直接依赖的全局 `@/components/tcm-prescription/index.vue`，不是在诊单 Tab 内原地编辑：它另开 1200 px Drawer、禁止点遮罩关闭，表单 label 100 px（`src/components/tcm-prescription/index.vue:1-10`）。编辑态顺序为：
|
||||
|
||||
1. 患者信息：姓名 / 性别 / 年龄三等分，电话 / 门诊号两等分。
|
||||
2. 诊断信息：面象 / 舌象两等分，临床诊断整行 2 行 textarea；舌象详情和脉象详情在模板中被注释（`index.vue:11-76`）。
|
||||
3. 中药处方 RP：药材总数与锁定提示；添加主方、添加辅方、处方库导入、粘贴导入；处方价格；主方卡片网格；辅方卡片网格（`index.vue:78-216`）。
|
||||
4. 用法信息：处方类型、主方用法、条件性辅方用法、剂数、剂量单位、用法、服用时间、服用方式、忌口、其他说明、医师、是否共享、医师签名（`index.vue:217-531`）。
|
||||
|
||||
信息分区间距 20 px、内边距 16 px、底 `#f5f7fa`、圆角 6 px；标题 15 px / 600 / `#303133`（`index.vue:2500-2516`）。RP toolbar 可换行，gap `12px 20px`、内边距 `14px 16px`、圆角 10 px、lighter 边框；标题 16 px、说明/锁定文字 12 px。药材编辑区桌面固定 4 列、gap 12 px，卡片白底、10 px 内边距、6 px 圆角；仅在 <=960 px 时让操作按钮行占满，**没有**把 4 列药材网格降列（`index.vue:2522-2690`）。签名区最大宽 600 px、1 px `#dcdfe6`、圆角 4 px（`index.vue:2694-2711`）。
|
||||
|
||||
保存后同一 Drawer 切换为处方预览：Tab 为“药房联 / 处方联”，上方工具条与作废/审核驳回状态，主体是 A4 `210 × 297 mm` 白纸，`8mm 10mm` 内边距、13 px 字号、28 px / 700 标题（`index.vue:536-754,2714-2782`）。患者信息是 4 列表格，药材是 2 列，底部医师/类型/天数/剂量为网格（`index.vue:2807-2966,2990-3035`）。未保存编辑态才提供 Drawer footer（`index.vue:899-905`）。
|
||||
|
||||
### 6.4 业务订单
|
||||
|
||||
订单 Tab/卡片顶部先显示“全局就诊序号偏移”工具条：label、tooltip、0–20 数字框（宽 120 px）、保存按钮（`components/PatientOrderList.vue:7-42`）。工具条换行、`12px 14px` 内边距、1 px lighter 边框、8 px 圆角、light fill（`PatientOrderList.vue:252-276`）。
|
||||
|
||||
订单表为 bordered + striped，字段顺序和列宽来自 `PatientOrderList.vue:44-106`：
|
||||
|
||||
1. 订单号，min 200。
|
||||
2. 全局就诊序号，96。
|
||||
3. 数量统计，96，Tag。
|
||||
4. 金额，120，右对齐红字。
|
||||
5. 医生，110。
|
||||
6. 医助，110。
|
||||
7. 履约状态，110，Tag。
|
||||
8. 创建时间，min 170。
|
||||
9. 详情，100，固定右侧。
|
||||
|
||||
默认 page size 为 10，底部带分页，点击详情打开只读订单详情（`PatientOrderList.vue:108-148`）。
|
||||
|
||||
订单详情复用 `PrescriptionOrderDetailDrawer` 的 readonly 受限版，而不是订单页内展开（`PatientOrderList.vue:113-124`）。该共享 Drawer 宽 80%，Header `16px 24px`，标题 18 px / 600，订单号与药房单号用圆角 Tag；加载态为 12 行 skeleton，body 水平内边距 24 px并独立纵向滚动（`src/views/consumer/prescription/components/PrescriptionOrderDetailDrawer.vue:13-50,1752-1757`）。内容顺序为：
|
||||
|
||||
1. 金额概览：总金额、已付总额、退款金额、需代收、已付笔数；响应式 2 / 3 / 5 列（`PrescriptionOrderDetailDrawer.vue:154-197`）。
|
||||
2. 两栏主区：左侧处方详情，右侧未关联收款与关联收款；收款表顺序为 ID、单号、类型、金额、状态、方式（readonly 隐藏）、创建人、创建时间（`PrescriptionOrderDetailDrawer.vue:200-545`）。
|
||||
3. 履约与收货信息：3 列 descriptions，label 宽 120 px（`PrescriptionOrderDetailDrawer.vue:551-680,1782-1785`）。
|
||||
4. 物流轨迹与操作日志（有数据/开启附加加载时）（`PrescriptionOrderDetailDrawer.vue:683-824`）。
|
||||
|
||||
readonly 明确隐藏顶部告警、流程步骤、挂号关联、内部成本、药材明细、收款方式和外部物流更新等完整版内容，但金额概览、主辅方用量/服法和基础详情仍共享（`PrescriptionOrderDetailDrawer.vue:2-11`）。面板统一 8 px 圆角，Header `14px 16px`、Body 16 px（`PrescriptionOrderDetailDrawer.vue:1759-1780`）。
|
||||
|
||||
### 6.5 视频、聊天与历史表
|
||||
|
||||
**视频录制回放。** CallRecordPanel 编辑态有上传 toolbar；字段为播放（min 320）、开始时间 170、结束时间 170、通话类型 100、房间 180、时长 110、状态 90、录制 100、上传 180（仅编辑）（`components/CallRecordPanel.vue:1-74`）。空态内边距 `28px 12px`，标题 14 px、说明 12 px / 1.6（`CallRecordPanel.vue:188-214`）。内嵌视频最大高 180 px、圆角 4 px、黑底；播放覆盖层为 `rgba(0,0,0,.62)`、白色 12 px（`components/RecordingVideoPlayer.vue:322-359`）。
|
||||
|
||||
**聊天。** 顶部 info alert + 同步/刷新 toolbar，消息区最大高 `min(60vh,520px)`、gap 16 px。单条最大宽 88%；患者消息靠左、灰底，医生消息靠右、primary 浅底；meta 12 px，气泡 14 px、1.5 行高、`10px 12px` 内边距、8 px 圆角；图片最大 `240 × 200 px`（`components/ImChatRecordPanel.vue:1-70,200-293`）。
|
||||
|
||||
**医助指派历史。** 字段依次为时间 175、原医助 min 120、新医助 min 120、继承 72 Tag、快照订单创建人 min 130、快照创建时间 190、操作人 110、账号 120、IP 130（`components/AssignLogPanel.vue:1-43`）。
|
||||
|
||||
**挂号历史。** 字段依次为 ID 72、状态 100 Tag、患者 min 150（姓名+手机堆叠）、医生 110、医助 110、预约时间 min 130（日期+时段堆叠）、预约类型 100、渠道 110、确认 92、处方 80、备注 min 100、创建时间 165（`components/AppointmentRecordPanel.vue:1-75`）。堆叠单元垂直 gap 2 px、行高 1.35（`AppointmentRecordPanel.vue:172-178`）。
|
||||
|
||||
### 6.6 `components/` 全目录的可达性边界
|
||||
|
||||
三主视图的实际 import 清单见 `edit.vue:787-805` 与 `readonly.vue:151-167`。为避免把目录中保留组件误认成当前详情功能，本次也核了其余文件：
|
||||
|
||||
| 组件 | 三主视图当前可达性 | 结论 |
|
||||
|---|---|---|
|
||||
| `PatientInfoCard`、`PatientCaseCard` | readonly 直接使用 | 当前只读摘要/病例 |
|
||||
| `DailyMatrix`、`CaseRecordList`、`PatientOrderList`、`CallRecordPanel`、`ImChatRecordPanel`、`AssignLogPanel`、`AppointmentRecordPanel` | edit/readonly 直接使用（依页面和权限而异） | 当前主链 |
|
||||
| `RecordingPlaybackBlock` → `RecordingVideoPlayer` | CallRecordPanel 间接使用 | 当前视频主链（`CallRecordPanel.vue:32,78`; `RecordingPlaybackBlock.vue:5,35`） |
|
||||
| `DiagnosisTodoList` | DailyMatrix 间接使用 | 当前日常记录主链 |
|
||||
| `TrackingNoteTimeline` | edit 有 import，但模板区整段注释 | 当前不可见（`edit.vue:644-654,803`） |
|
||||
| `BloodRecordList` | 未被三主视图 import | 旧/独立颗粒列表；其能力已由 DailyMatrix 内置 600 px 血糖血压 Dialog 承接（`BloodRecordList.vue:1-170`; `DailyMatrix.vue:131-185`） |
|
||||
| `DietRecordList` | 未被三主视图 import | 旧/独立列表；当前 DailyMatrix 内置 800 px 饮食 Dialog（`DietRecordList.vue:1-112`; `DailyMatrix.vue:187-227`） |
|
||||
| `ExerciseRecordList` | 未被三主视图 import | 旧/独立列表；当前 DailyMatrix 内置 600 px 运动 Dialog（`ExerciseRecordList.vue:1-86`; `DailyMatrix.vue:229-260`） |
|
||||
| `TrackingMatrix` | 未被三主视图 import | 非当前矩阵；当前入口明确 import `DailyMatrix`（`edit.vue:796`; `readonly.vue:161`） |
|
||||
| `AssistantWatchCallDialog` | 未被三主视图 import | 旁路观看 Dialog，不属于诊单详情/编辑/预约；自身是 auto-fill、最小 280 px 的观看网格，gap 12 px（`AssistantWatchCallDialog.vue:1-19,242-282`） |
|
||||
|
||||
因此 PySide 对齐应以“当前可达主链”为实现范围，不能因为同目录存在旧颗粒列表而重复增加血糖、饮食、运动 Tab，也不能把观看 Dialog 或 TrackingMatrix 插入诊单详情。
|
||||
|
||||
---
|
||||
|
||||
## 7. 加载、空态、错误和权限状态
|
||||
|
||||
| 场景 | 后台表现 | 源码 |
|
||||
|---|---|---|
|
||||
| 独立详情加载 | 页面级 loading | `readonly.vue:1-2` |
|
||||
| 独立详情失败 | Hero 下方错误空态卡 | `readonly.vue:31-36` |
|
||||
| 无未服务记录 | Hero 灰色“从未记录”状态 | `readonly.vue:323-355` |
|
||||
| 抽屉只读 | 状态 badge + disabled fieldset + 无保存 | `edit.vue:11-54,57-84,766-781` |
|
||||
| 患者隐私锁定 | warning Alert，身份字段不可改 | `edit.vue:71-84` |
|
||||
| Tab 失权 | 隐藏 Tab；当前失权时回 basic | `edit.vue:655-759,883-913` |
|
||||
| 预约未选医生 | 时间区提示先选医生 | `appointment.vue:100-171` |
|
||||
| 无排班/无时段 | 时间区空态 | `appointment.vue:100-171` |
|
||||
| 当天已有预约 | warning 且禁止确认 | `appointment.vue:10-18,359-386` |
|
||||
| 其他日期已有预约 | info 提示，不等同当天阻断 | `appointment.vue:359-375` |
|
||||
| 表格无数据 | 各组件 Element empty/自定义空态 | `PatientOrderList.vue:1-6`; `CallRecordPanel.vue:55-74` |
|
||||
|
||||
操作权限应控制“是否渲染/是否可编辑”，而不是只把无权按钮做成 disabled；这正是 Tab 通过 `v-if` 实现的模式。
|
||||
|
||||
---
|
||||
|
||||
## 8. PySide6 组件映射
|
||||
|
||||
### 8.1 结构映射
|
||||
|
||||
| Vue / Element 结构 | PySide6 建议 | 必须保留的视觉行为 |
|
||||
|---|---|---|
|
||||
| `el-drawer` 右侧抽屉 | 模态 `QDialog` + 右侧面板，或主窗口上的遮罩 `QFrame` + 固定宽面板 | 桌面约 60% 宽；edit 在窄屏切全宽；Header/Body/Footer 三段分离 |
|
||||
| Drawer body | `QScrollArea` + body widget | 只让 body 滚动，footer 不随滚动 |
|
||||
| Drawer footer slot | 独立 `QFrame` + `QHBoxLayout` | 上边框、白底、固定在底部；不要放进 ScrollArea |
|
||||
| `el-tabs` | `QTabWidget` / 自定义 `QTabBar + QStackedWidget` | 可横向滚动、3 px active indicator、按 canonical permission 移除页签 |
|
||||
| `el-form` + `el-row/el-col` | `QFormLayout` 套 `QGridLayout` | 桌面 160 px 编辑标签 / 100 px 预约标签；窄屏改上标签单列 |
|
||||
| input/select/date/input-number | `QLineEdit`、`QComboBox`、`QDateEdit`、`QSpinBox/QDoubleSpinBox` | 常规高 32 px、圆角 10 px；footer 按钮 40/44 px |
|
||||
| radio/checkbox button groups | `QButtonGroup` + 可换行 FlowLayout | 12 px 字号，组间 12–16 px；小窗必须换行 |
|
||||
| textarea | `QTextEdit/QPlainTextEdit` | 2/3/4 行按源码用途设置 minimumHeight，而非无限增高 |
|
||||
| alert / empty | `QFrame + QLabel` / 统一 EmptyState | warning/info/error 色语义与文案位置一致 |
|
||||
| card | `QFrame` | 白底、1 px `#e6ebf2`、14 px radius、18 px padding |
|
||||
| table | `QTableView + QAbstractTableModel` | stripe、固定/最小列宽、状态 `QStyledItemDelegate` tag、右侧动作列 |
|
||||
| timeline | `QListView` 或纵向 QWidget 列表 + paintEvent 轴线 | 22 px 左缩进、2 px 轴、10 px node，图片缩略图 64 px |
|
||||
| appointment slot grid | `QScrollArea + FlowLayout` / `QGridLayout` 动态列 | cell min 110 × 70；选中/禁用/可用状态显式 |
|
||||
| loading | overlay `QFrame` + spinner/文字 | 遮住当前内容但保留布局尺寸，异步返回后解除 |
|
||||
|
||||
### 8.2 推荐常量（来自源码，不是重新设计）
|
||||
|
||||
```text
|
||||
FONT_FAMILY = "PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei"
|
||||
FONT_BASE = 14
|
||||
FONT_FORM = 12
|
||||
CONTROL_HEIGHT = 32
|
||||
FOOTER_BUTTON_HEIGHT = 40 # <=768 对应布局时 44
|
||||
CARD_RADIUS = 14
|
||||
CARD_PADDING = 18
|
||||
CONTROL_RADIUS = 10
|
||||
PANEL_GAP = 16
|
||||
BORDER = #e6ebf2
|
||||
BODY_BG = #f8fafc
|
||||
PAGE_BG = #f6f6f6
|
||||
TEXT_PRIMARY = #333333
|
||||
TEXT_REGULAR = #666666
|
||||
TEXT_MUTED = #999999
|
||||
PRIMARY = #409eff # 继承 Element 语义主色
|
||||
READONLY_ACCENT = #2563eb
|
||||
READONLY_ACCENT_STRONG = #1d4ed8
|
||||
```
|
||||
|
||||
### 8.3 PySide 字段装配顺序
|
||||
|
||||
为避免实现时按数据模型字母序排字段，应按以下 UI 顺序装配：
|
||||
|
||||
```text
|
||||
编辑病历：
|
||||
诊单ID
|
||||
→ 姓名 / 身份证
|
||||
→ 手机 / 性别
|
||||
→ 年龄
|
||||
→ [生命体征] 婚姻 / 身高 / 体重
|
||||
→ 地区 / 高压 / 低压
|
||||
→ 空腹血糖
|
||||
→ 诊断类型
|
||||
→ 状态 / 渠道
|
||||
→ 统计端就诊卡
|
||||
→ 在用药物
|
||||
→ [主诉] 当地诊断日期 / 糖尿病病史
|
||||
→ 当地医院诊断结果
|
||||
→ 当地医院名称
|
||||
→ [现病史] 口腔 → 饮水 → 体重变化 → 脂肪肝 → 饮食
|
||||
→ 肢体 → 睡眠 → 眼睛 → 头部 → 出汗 → 皮肤 → 小便 → 大便 → 腰肾
|
||||
→ 其他补充
|
||||
→ [既往史] 既往史
|
||||
→ [其他病史] 外伤 / 手术 / 过敏 → 家族 / 妊娠
|
||||
→ [诊断信息] 病史补充
|
||||
|
||||
预约：
|
||||
上次面诊 → 预约方式 → 预约类型 → 预约患者 → 渠道来源
|
||||
→ [条件] 自媒体详情 → 预约医生 → 日期 → 时段 → 备注
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. 验收清单
|
||||
|
||||
1. 独立 readonly 是纵向卡片流，不出现 Tabs；抽屉 viewOnly 才是 Tabs + disabled 表单。
|
||||
2. 编辑 Drawer 桌面 60%，<=768 等效状态下全宽；预约 Drawer 源码没有该响应式覆盖，需明确属于适配增强。
|
||||
3. 编辑桌面 label 160 px，预约 label 100 px；编辑移动端 label 在控件上方。
|
||||
4. 编辑的 body 独立滚动，footer 始终可见；实现中没有把按钮放到滚动区末尾。
|
||||
5. Tab 顺序与 canonical permission 一致；“跟踪备注”不渲染。
|
||||
6. 编辑病历字段严格按 §4.5；不把脚本中未渲染字段自行加入。
|
||||
7. 只读病例按 4/3 列网格及 §3.4 顺序；小窗若做降列，需视为桌面端增强而非源码既有行为。
|
||||
8. 预约状态至少覆盖：未选医生、无排班、可约、不可约、选中、当天冲突、其他日期提示、loading。
|
||||
9. 订单、备注、视频、聊天、指派历史、挂号历史的列顺序/动作显隐与 §6 一致。
|
||||
10. 所有表格提供 loading、empty、error；权限失去时移除入口并将当前页回退到可见页。
|
||||
|
||||
以上规格记录的是当前后台源码的可见事实；PySide 可为桌面小窗增加降列和全宽适配，但不得改变字段顺序、权限门槛、状态语义或主操作位置。
|
||||
@@ -0,0 +1,31 @@
|
||||
# Diagnosis 详情二次终验报告
|
||||
|
||||
日期：2026-08-10
|
||||
|
||||
## CLOSED
|
||||
|
||||
- 统计端就诊卡：使用原生自绘二态 `DiagnosisSwitch`，保存值严格为 `0/1`。
|
||||
- 日常记录：提供 `+ 血糖 / + 饮食 / + 运动 / + 备注`，以及待办新增、仅待执行且 `can_cancel` 的精确取消；Remote/Demo/Protocol 均接真实方法，包含权限、DTO 校验和 generation 失效保护。
|
||||
- 诊疗笔记：接入新增/当日追加、舌象与报告上传、单附件删除；所有动作均调用现有真实 endpoint。
|
||||
- 处方与订单：处方按钮进入完整 `PrescriptionEditorDialog` 并调用 `tcm.prescription/add`；诊次偏移写入 `setRevisitSlotStartOffset`；订单详情调用真实详情方法。
|
||||
- 视频回放：列表、视频上传、手工通话记录创建、附件绑定均接真实 endpoint；播放仅允许合法 `HTTP(S)` 外链。
|
||||
- IM：固定 `only_archived=1`，支持异步同步与重新加载，并显示文本、图片、文件消息。
|
||||
- 视觉：tab 使用 4px 横向滚动条并隐藏原生左右箭头框；footer 有向上阴影；保存按钮自绘 loading spinner、成功勾、失败叉；readonly 摘要禁止拆字；表格状态改为 pill/tag。
|
||||
- Shell owner：每次 `open_for` / `showEvent` 从 `parentWidget().window()` 重新绑定，按 Shell 宽度 60% 计算抽屉，move/resize 立即同步，关闭后全部请求 generation 失效。
|
||||
- 列表补充合同：QR、挂号日志、通用订单与 exact `doctor.appointment/cancel` 均有 Protocol/Remote/Demo 方法。
|
||||
|
||||
## OPEN（服务端合同不存在，fail-closed）
|
||||
|
||||
- 诊疗笔记“任意改写既有正文”与“删除整条笔记”没有后端 endpoint，因此桌面端没有伪造动作。现有合同只允许“当天追加”和“删除单个附件”：
|
||||
- `server/app/adminapi/controller/doctor/AppointmentController.php:168-192` 仅公开 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`。
|
||||
- `server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-67` 的 `addOrAppend` 按 `diagnosis_id + 当天` 追加正文/附件，不是任意正文覆盖。
|
||||
- `server/app/adminapi/logic/doctor/DoctorNoteLogic.php:114-141` 仅实现单个附件删除。
|
||||
- `admin/src/api/patient.ts:20-40` 同样只有上述三个客户端 API。
|
||||
|
||||
## 验证
|
||||
|
||||
- 定向详情与合同：`28 passed`。
|
||||
- 相关 repository/reception/video：`57 passed`。
|
||||
- 全量：`226 passed`。
|
||||
- `ruff check .`：exit 0（仅工作区不可访问缓存目录的扫描 warning）。
|
||||
- 视觉产物：`artifacts/diagnosis_visual/` 中 6 张模式图与 14 张详情状态图，共 20 张本轮详情 PNG。
|
||||
@@ -0,0 +1,155 @@
|
||||
# Diagnosis 最终视觉发布门禁
|
||||
|
||||
审计日期：2026-08-11
|
||||
审计性质：第四次独立、只读、最终视觉发布门禁；除更新本报告外，未修改业务源码、测试或 PNG。
|
||||
基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/` 及其主链直接依赖组件。
|
||||
当前截图：`D:/web/zyt/app/artifacts/diagnosis_visual/`。
|
||||
Trellis：`D:/web/zyt/app/.trellis` 不存在（`Test-Path` 为 `False`），因此无可补读的 Trellis workflow/spec。
|
||||
审计口径：只有与基准达到同型才记 PASS；Qt 与浏览器字体栅格化造成的轻微像素差不算结构问题。
|
||||
|
||||
## 最终结论
|
||||
|
||||
**PASS。**
|
||||
|
||||
- 共逐张按原始像素尺寸检查 **57 张 PNG**。
|
||||
- 逐图判定：**57 PASS / 0 PARTIAL / 0 不可读 / 0 硬裁切到窗口外**。
|
||||
- 严重度：**P0 = 0，P1 = 0，P2 = 0**。
|
||||
- 旧审计中的 Notes 真实缩略图、Chat 图片缩略图、Daily 局部工具栏、1200 px 连续处方 Drawer、订单 80% 详情 Drawer、订单 offset、Shell 与预约均已闭合或保持通过。
|
||||
- 上轮唯一 P1——视频表内播放器被压成 16 px 黑条——已关闭。`diagnosis_video_inline_player_1200x560.png` 与 `diagnosis_state_video_replay_1024x640.png` 均显示完整加载遮罩、播放按钮、进度条、时间、外部打开、独立窗口和备用地址；播放器本体运行时高度为 158 px，未超过基准 180 px 上限。
|
||||
|
||||
尺寸分布（按 PNG 实际像素而非文件名）：`1024x640` 24 张、`1024x768` 1 张、`1200x560` 1 张、`1200x900` 4 张、`1280x800` 11 张、`1440x900` 13 张、`650x620` 1 张、`820x560` 1 张、`920x780` 1 张。
|
||||
|
||||
第四次增量完整性：目录仍为 57 张；相对上一门禁仅 3 张视频 PNG 更新（`diagnosis_video_inline_player_1200x560.png`、`diagnosis_state_video_replay_1024x640.png`、`diagnosis_state_video_upload_action_1024x640.png`）。本轮已对这 3 张全部按原始尺寸复核，并原尺寸抽查 Notes、Chat、Daily、处方四段连续态、订单 80% Drawer/offset、Shell、预约及 1024/1440 主列表；其余非视频 PNG 时间戳未变化，沿用上一轮全量逐图结论。
|
||||
|
||||
## 此前 OPEN 逐项复核
|
||||
|
||||
| 旧 OPEN | 终态 | 视觉与结构证据 |
|
||||
|---|---|---|
|
||||
| Notes 舌象真实缩略图 | **CLOSED** | `diagnosis_state_notes_actions_1024x640.png` 已显示实际 64x64 舌象位图，并有右上删除入口；当前 `_RemoteImageButton` 以 cover 方式加载到 `QSize(64, 64)`：`src/doctor_workstation/ui/diagnosis_drawer.py:2364-2404`。基准为真实 `el-image` 64x64 cover：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69`。 |
|
||||
| Chat 图片消息缩略图 | **CLOSED** | `diagnosis_state_chat_archive_1024x640.png` 的患者图片消息直接显示实际图像缩略图，不再是“查看图片”文字链接；当前最大 `240x200`：`diagnosis_drawer.py:2553-2573`。基准：`ImChatRecordPanel.vue:39-50`。 |
|
||||
| Daily 待办局部工具栏 | **CLOSED** | `diagnosis_state_daily_lower_1024x640.png` 同时显示 `+ 新增待办`、全部/待执行/已发送/失败/已取消及局部“刷新”，无遮挡；当前：`diagnosis_drawer.py:1725-1761`，基准：`DiagnosisTodoList.vue:3-20`。顶部动作行也继续在 `diagnosis_state_daily_1024x640.png` 完整换行。 |
|
||||
| 处方 1200 px 连续 Drawer | **CLOSED** | `diagnosis_state_prescription_editor_1200x900.png`、`..._herbs_1200x900.png`、`..._usage_1200x900.png`、`..._signature_1200x900.png` 连续证明患者、诊断、RP 药材、用法、签名处于同一纵向滚动流，固定 footer 稳定；1024/920 窄宽度采用可用宽度而非截断。当前 `DRAWER_WIDTH = 1200` 且五段连续加入同一 `QScrollArea`：`src/doctor_workstation/ui/dialogs/prescription.py:1467,1491-1556,1902-1914`。基准：`D:/web/zyt/admin/src/components/tcm-prescription/index.vue:2-216,217-531`。旧 4-tab modal 结构已消失。 |
|
||||
| 订单 80% 详情 Drawer | **CLOSED** | `diagnosis_order_detail_drawer_1440x900.png` 的 panel 从 x=288 开始、宽 1152（80%）；`diagnosis_state_order_detail_640x540.png` 与 `diagnosis_state_order_detail_drawer_1024x640.png` 的实际像素均为 1024x640，panel 从 x=205 开始、宽 819（约 80%）。金额概览、处方详情、关联收款在首屏可见；当前连续构建收款、履约与收货、物流轨迹、操作日志：`src/doctor_workstation/ui/dialogs/diagnosis.py:669-710,3623-4065`。基准共享 readonly Drawer：`PrescriptionOrderDetailDrawer.vue:13-20,154-220,433-545,550-824`。旧 `640x540` 仅是遗留文件名，不是当前截图尺寸。 |
|
||||
| 订单 offset 文案与解释层级 | **CLOSED** | `diagnosis_state_order_offset_1024x640.png` 已为“复诊统计起始偏移”+ 问号帮助 +“第 1 笔实单计为三诊”+“保存”，与基准同型；当前：`diagnosis.py:1384-1416,3001-3058`，基准：`PatientOrderList.vue:7-41`。 |
|
||||
| 视频多地址与逐条上传 | **CLOSED（能力/动作）** | `diagnosis_state_video_upload_action_1024x640.png` 的行级“追加回放”可见；当前每行绑定精确 `call_record_id`：`diagnosis.py:3304-3342`。备用地址结构存在于 `diagnosis_media.py:358-442`。 |
|
||||
| 视频表内播放器 | **CLOSED** | 两张终态图均显示完整可操作的表内播放器与备用地址；第四次运行时复核在 1200x560、1024x640 宿主中均测得 row 243 px、cell 242 px、player 158 px，controls 全部可见。详见下节。 |
|
||||
| Shell | **CLOSED / 无回归** | `diagnosis_shell_1024x640.png` 与 `diagnosis_shell_1440x900.png` 均保持 183 px sidebar、50 px topbar、40 px tabs，操作区及固定列无错位。 |
|
||||
| 预约 Drawer | **CLOSED / 无回归** | 8 张预约 PNG 的 60% Drawer、固定 footer、时段网格、empty/error/loading/refreshing/focus 状态均完整。 |
|
||||
|
||||
## P0 / P1 / P2
|
||||
|
||||
### P0
|
||||
|
||||
**0 项。** 未发现窗口级硬裁切、核心信息完全不可见、Drawer 比例失效、footer 滚走、二维码不可辨识、Shell 壳层错位或预约主流程不可操作的发布阻断。
|
||||
|
||||
### P1
|
||||
|
||||
**0 项。** 上轮唯一 P1“视频表内播放器被裁成 16 px 黑条”已关闭。
|
||||
|
||||
#### 视频表内播放器关闭证据
|
||||
|
||||
精确截图：
|
||||
|
||||
- `D:/web/zyt/app/artifacts/diagnosis_visual/diagnosis_video_inline_player_1200x560.png`
|
||||
- `D:/web/zyt/app/artifacts/diagnosis_visual/diagnosis_state_video_replay_1024x640.png`
|
||||
|
||||
两张图在原始尺寸中均呈现完整播放器：黑色视频 surface 内有“预览待加载 / 点击播放开始加载”，下方可见“播放”、进度条、`00:00 / 00:00`、“外部打开”和“独立窗口”；播放器下方继续显示“备用地址”及 `COS HLS 1`、`链接 2`，第二条无回放记录也保持独立普通行。1200 与 1024 宿主均无裁切、重叠或 controls 遗失。
|
||||
|
||||
第四次运行时几何复核（使用与最终截图相同的 `RenderRepository` 与两行 fixture，未写 PNG）在 1200x560 和 1024x640 两种宿主下得到一致结果：
|
||||
|
||||
- table row 0：243 px；可视 cell rect：242 px；`RecordingPlaybackCell`：242 px。
|
||||
- `InlineRecordingPlayer`：158 px，满足实现的 158–180 px 约束，也满足基准 `max-height: 180px`。
|
||||
- 播放按钮、slider、时间标签及整个 player 均 `visible=True`。
|
||||
- 备用地址使外层 cell 高于 180 px 是正确行为；180 px 上限只约束播放器本体，不约束播放器 + 备用地址的整行总高。
|
||||
|
||||
当前源码的闭环点：
|
||||
|
||||
- `src/doctor_workstation/ui/diagnosis_media.py:179-278` 构建 158–180 px 内嵌 player、视频 surface 与完整控制栏。
|
||||
- `diagnosis_media.py:359-457` 将 player、备用地址组成定高 cell，并由 `required_table_row_height()` 返回真实所需高度。
|
||||
- `src/doctor_workstation/ui/dialogs/diagnosis.py:3304-3367` 在 Qt 的 `resizeRowsToContents()` 后，以 cell 实际 hint 恢复 row 高度并写入 item size hint，避免另一列固定高按钮再次压扁整行。
|
||||
|
||||
基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/RecordingPlaybackBlock.vue:1-30` 在“录制回放”单元格内直接放置 `RecordingVideoPlayer`；`RecordingVideoPlayer.vue:2-13,320-329` 显示 controls、16:9、最大高 180 px 的完整播放器。当前终态在结构、信息层级和可操作性上已同型，因此关闭 P1。
|
||||
|
||||
### P2
|
||||
|
||||
**0 项。** 上一轮两项 P2 已闭合：Daily 待办已具精确 `+ 新增待办` 与局部刷新；订单 offset 已具精确标题、帮助入口、动态解释与“保存”文案。
|
||||
|
||||
## 57 张 PNG 逐张判定
|
||||
|
||||
### 预约 Drawer（8/8 PASS）
|
||||
|
||||
| PNG | 判定 | 原始尺寸下目检结论 |
|
||||
|---|---|---|
|
||||
| `appointment_drawer_1024x640.png` | PASS | 60% Drawer、body 滚动、时段状态与固定 footer 完整。 |
|
||||
| `appointment_drawer_1440x900.png` | PASS | 医生、日期、时段网格、备注与 footer 对齐。 |
|
||||
| `appointment_drawer_empty_doctors_1440x900.png` | PASS | warning、空医生状态与禁用确认完整。 |
|
||||
| `appointment_drawer_empty_roster_1440x900.png` | PASS | 无排班 warning、医生选择与空态完整。 |
|
||||
| `appointment_drawer_error_1440x900.png` | PASS | 号源错误 banner、刷新入口、空态与禁用确认完整。 |
|
||||
| `appointment_drawer_keyboard_focus_1440x900.png` | PASS | 日期按钮 focus ring 清晰，不挤压布局。 |
|
||||
| `appointment_drawer_loading_1440x900.png` | PASS | 初始 loading overlay、spinner、文案与 footer 完整。 |
|
||||
| `appointment_drawer_refreshing_1440x900.png` | PASS | 刷新 overlay、spinner、文案与 footer 完整。 |
|
||||
|
||||
### 诊单列表、壳层与主 Drawer（23/23 PASS）
|
||||
|
||||
| PNG | 判定 | 原始尺寸下目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_1024x640.png` | PASS | 窄屏筛选换行、横向滚动、右 460 px 固定区与行语义完整。 |
|
||||
| `diagnosis_1440x900.png` | PASS | 宽屏列密度、复合挂号格、业务色与固定操作区成立。 |
|
||||
| `diagnosis_advanced_filters_1280x800.png` | PASS | 高级筛选全量展开，无控件裁切。 |
|
||||
| `diagnosis_double_appointment_cancel_1280x800.png` | PASS | 同诊单双挂号各有取消入口。 |
|
||||
| `diagnosis_edit_1024x640.png` | PASS | 60% Drawer、tab、独立滚动与固定 footer 成立。 |
|
||||
| `diagnosis_edit_1440x900.png` | PASS | 864 px Drawer 与宽屏字段比例稳定。 |
|
||||
| `diagnosis_empty_1280x800.png` | PASS | 表头、空态、横向滚动与 0 条分页保留。 |
|
||||
| `diagnosis_error_1280x800.png` | PASS | 错误态清晰，无旧数据穿透。 |
|
||||
| `diagnosis_focus_1280x800.png` | PASS | 搜索 focus ring 清晰且不挤压布局。 |
|
||||
| `diagnosis_full_menu_1280x800.png` | PASS | 8 项菜单、图标、danger 删除与“二维码”均完整。 |
|
||||
| `diagnosis_horizontal_scroll_1024x640.png` | PASS | 主表横移时右 460 px 固定区不动。 |
|
||||
| `diagnosis_hover_warning_1280x800.png` | PASS | warning 行 hover 与左侧强调条连续。 |
|
||||
| `diagnosis_loading_1280x800.png` | PASS | 表内 spinner 与淡化内容完整。 |
|
||||
| `diagnosis_order_detail_drawer_1440x900.png` | PASS | 80% Drawer、金额概览、处方详情、收款记录与固定 footer 成立。 |
|
||||
| `diagnosis_order_qrcode_1280x800.png` | PASS | QR 可辨、订单号、状态、只读 URL 与动作完整。 |
|
||||
| `diagnosis_pending_assign_1280x800.png` | PASS | 待分配医助、月份与搜索处于同一流式区域。 |
|
||||
| `diagnosis_permissions_cropped_1280x800.png` | PASS | 权限收口后只保留查看，无敏感动作残留。 |
|
||||
| `diagnosis_readonly_1024x640.png` | PASS | 独立只读页 hero、病例卡与窄屏字段无拆字。 |
|
||||
| `diagnosis_readonly_1440x900.png` | PASS | 4 列病例密度、异常指标与长页滚动成立。 |
|
||||
| `diagnosis_shell_1024x640.png` | PASS | 183/50/40 壳层、tabs、固定列及分页成立。 |
|
||||
| `diagnosis_shell_1440x900.png` | PASS | 宽屏壳层比例及顶栏图标/中文稳定。 |
|
||||
| `diagnosis_viewonly_1024x640.png` | PASS | 60% 只读 Drawer、警告、disabled 表单与仅关闭 footer 成立。 |
|
||||
| `diagnosis_viewonly_1440x900.png` | PASS | 宽屏只读栅格、全 tabs 与固定 footer 成立。 |
|
||||
|
||||
### 详情状态与子流程（26/26 PASS）
|
||||
|
||||
| PNG | 判定 | 原始尺寸下目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_state_chat_archive_1024x640.png` | PASS | info、归档同步、左右气泡与真实图片缩略图成立。 |
|
||||
| `diagnosis_state_daily_1024x640.png` | PASS | Daily 动作完整换行，无裁切。 |
|
||||
| `diagnosis_state_daily_blood_edit_650x620.png` | PASS | 血糖/血压字段、单位、必填说明与固定动作完整。 |
|
||||
| `diagnosis_state_daily_lower_1024x640.png` | PASS | `+ 新增待办`、filters、局部刷新、状态与横向滚动完整。 |
|
||||
| `diagnosis_state_empty_1024x640.png` | PASS | 处方空态与 primary“开方”成立。 |
|
||||
| `diagnosis_state_error_1024x640.png` | PASS | danger banner、重试、空表单与禁用保存完整。 |
|
||||
| `diagnosis_state_focus_1024x640.png` | PASS | 姓名 focus ring、close 与固定 footer 完整。 |
|
||||
| `diagnosis_state_loading_1024x640.png` | PASS | loading overlay、spinner 与文案完整。 |
|
||||
| `diagnosis_state_notes_actions_1024x640.png` | PASS | 新增/上传动作、实际舌象缩略图、报告 chip 与单附件删除完整。 |
|
||||
| `diagnosis_state_order_detail_640x540.png` | PASS | 实际为 1024x640 的 80% Drawer；金额与处方首屏、滚动与 footer 成立。 |
|
||||
| `diagnosis_state_order_detail_drawer_1024x640.png` | PASS | 80% Drawer 窄屏终态与上一张一致且无结构裁切。 |
|
||||
| `diagnosis_state_order_offset_1024x640.png` | PASS | 精确标题、帮助、动态解释、“保存”、列表与分页成立。 |
|
||||
| `diagnosis_state_permission_1024x640.png` | PASS | 获权 tabs、敏感字段掩码与仅关闭 footer 成立。 |
|
||||
| `diagnosis_state_prescription_editor_1024x768.png` | PASS | 窄屏连续 Drawer 首段、RP 工具栏、滚动与固定 footer 成立。 |
|
||||
| `diagnosis_state_prescription_editor_1200x900.png` | PASS | 1200 px 连续 Drawer 患者/诊断/RP 起始结构成立。 |
|
||||
| `diagnosis_state_prescription_editor_920x780.png` | PASS | 窄宿主按可用宽度适配，旧 tabbed modal 已消失。 |
|
||||
| `diagnosis_state_prescription_editor_herbs_1200x900.png` | PASS | 主方/辅方网格、剂量与删除入口处于同一滚动流。 |
|
||||
| `diagnosis_state_prescription_editor_signature_1200x900.png` | PASS | 辅方用法、医生签名板及固定 footer 成立。 |
|
||||
| `diagnosis_state_prescription_editor_usage_1200x900.png` | PASS | 主/辅方用法层级、说明字段与连续滚动成立。 |
|
||||
| `diagnosis_state_save_failure_1024x640.png` | PASS | 红色失败态与文案完整。 |
|
||||
| `diagnosis_state_save_loading_1024x640.png` | PASS | 按钮内 spinner 与“正在保存”完整。 |
|
||||
| `diagnosis_state_save_success_1024x640.png` | PASS | 绿色成功态与文案完整。 |
|
||||
| `diagnosis_state_video_player_820x560.png` | PASS | 独立播放器作为兼容兜底本身完整；不替代表内播放器要求。 |
|
||||
| `diagnosis_state_video_replay_1024x640.png` | PASS | 158 px 表内 player、加载态、完整 controls 与备用地址均可见，第二条普通行未受高行影响。 |
|
||||
| `diagnosis_state_video_upload_action_1024x640.png` | PASS | 横移后 243 px 高视频行仍保持状态、录制与“追加回放”垂直居中，第二条普通行未被错误拉高。 |
|
||||
| `diagnosis_video_inline_player_1200x560.png` | PASS | 宽屏完整显示 158 px 表内 player、controls、备用地址及相邻列，无裁切。 |
|
||||
|
||||
## 发布判定
|
||||
|
||||
- 旧审计的 Notes、Chat、Daily、处方、订单、视频、Shell、预约问题已经全部闭合或保持通过。
|
||||
- 两张重新录制的视频原始尺寸 PNG 与运行时实际控件几何相互印证，旧唯一 P1 已关闭。
|
||||
- 当前最终门禁：**PASS（57 PASS / 0 PARTIAL，共检查 57 张 PNG；P0=0，P1=0，P2=0）。**
|
||||
@@ -0,0 +1,373 @@
|
||||
# 管理端“诊单列表”视觉规格（源码基准）
|
||||
|
||||
> 审计日期：2026-08-10
|
||||
> 唯一业务页面基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue`
|
||||
> 方法：只读检查 Vue 模板、同文件 scoped SCSS、直接挂载组件、全局样式、主题生成逻辑和当前锁定的 Element Plus 源码；未启动浏览器、未改业务源码。
|
||||
|
||||
## 1. 结论摘要
|
||||
|
||||
1. 该页面**没有页面内标题、说明文案或独立标题栏**。路由内容从一张无边框、无阴影的筛选卡直接开始；“新增诊单”等主操作位于第二张列表卡顶部，而不是页面标题旁。证据：`index.vue:2-154`。
|
||||
2. 页面是“浅灰页面底 + 两张白卡”的高密度后台列表。外层路由容器提供左右 `8px`、上下 `16px` 的留白；筛选卡和列表卡之间为 `12px`。证据：`D:/web/zyt/admin/src/layout/default/components/main.vue:2-10`、`index.vue:154`、`D:/web/zyt/admin/tailwind.config.js:103-113`。
|
||||
3. 顶部不是常规 tabs，而是可换行的圆角文字 chip：6 个日期入口，再接“待预约 / 已完成 / 待分配医助”，计数是文字后面的普通半透明数字，不是独立 badge。当天默认选中。证据：`index.vue:6-70,964-976,2174-2182,2222-2317`。
|
||||
4. 表格声明列的最小总宽约为 **1403px**；右侧固定“视频旁观” `120px` 与“操作” `340px`，合计 `460px`。窄于该宽度时由 Element Table 横向滚动，右侧两列保持 fixed。证据：`index.vue:191-342`。
|
||||
5. 表格使用斑马纹；普通偶数行是 `#FAFAFA`，普通悬停是 `#F8F8F8`。未确认、未挂号行还声明了左侧语义色和横向渐变，但静态渐变写在 `tr`，斑马纹及 fixed cell 的 `td` 背景可能遮住它；两类行的 hover 渐变直接写在 `td`，表现更稳定。证据：`index.vue:2723-2735`、Element Plus `table.scss:560-588,665-668`。
|
||||
6. 空态不是 `el-empty` 插画，而是表格默认的 **60px 高“暂无数据”文本区**；加载态是覆盖表格的半透明蒙层和 `42px` 主色环。证据：Element Plus `table.scss:52-70`、`loading.scss:19-73`、中文 locale `zh-cn.mjs:137`。
|
||||
|
||||
## 2. 源码证据层级
|
||||
|
||||
| 层级 | 文件 | 本规格使用内容 |
|
||||
|---|---|---|
|
||||
| 页面模板与局部样式 | `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1-2766` | DOM 次序、列宽、状态类、局部尺寸和颜色 |
|
||||
| 路由内容容器 | `D:/web/zyt/admin/src/layout/default/components/main.vue:1-12` | 页面底色、外层滚动、`px-2 py-4` |
|
||||
| 共享组件 | `D:/web/zyt/admin/src/components/pagination/index.vue:1-50`；`D:/web/zyt/admin/src/components/daterange-picker/index.vue:1-49` | 分页布局、页容量、日期范围控件行为 |
|
||||
| 项目全局样式 | `D:/web/zyt/admin/src/styles/index.scss:1-5`、`var.css:1-49`、`element.scss:58-68,106-115,140-151,177-201`、`public.scss:1-3` | 全局字体、颜色、表格、输入焦点、移动分页 |
|
||||
| 项目主题 | `D:/web/zyt/admin/src/config/setting.ts:1-15`、`src/utils/theme.ts:3-75`、`src/App.vue:25-34` | 默认主色、明暗主题色派生、运行时覆盖 |
|
||||
| Tailwind token | `D:/web/zyt/admin/tailwind.config.js:5-155` | 字体族、颜色映射、间距值 |
|
||||
| UI 框架 | `D:/web/zyt/admin/pnpm-lock.yaml:47-49,2412-2415`；`node_modules/element-plus/theme-chalk/src/**` | 当前锁定 Element Plus 2.13.7 的默认组件尺寸 |
|
||||
|
||||
`package.json:27` 写的是兼容范围 `^2.9.4`，当前 lock 与已安装源码均为 **2.13.7**；本规格的框架默认尺寸以锁文件和当前安装源码为准。
|
||||
|
||||
## 3. 页面骨架与 ASCII wireframe
|
||||
|
||||
### 3.1 宽屏主态
|
||||
|
||||
```text
|
||||
主内容滚动区，#F6F6F6；左右 8，上下 16
|
||||
┌────────────────────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 筛选卡 #FFF / r4 / 无边框无阴影；内边距 12V × 16H │
|
||||
│ [昨天挂号 n] [前天挂号 n] [当天挂号 n] [明天挂号 n] [后天挂号 n] [全部 n] │
|
||||
│ [待预约 n] [已完成 n] [待分配医助 n] [患者姓名 / 手机号 160] [查询 32h] │
|
||||
│ ──────────────────────────────────────────────────────────────────────────────────────── │
|
||||
│ 挂号：[全部] [已挂号] [未挂号] │ 确认：[全部] [已确认] [未确认] 更多筛选⌄ │
|
||||
│ · · · 展开时：诊断类型 / 证型 / 医助 / 最近挂号日期 / 最近指派日期 / 渠道 / 重置 · · · │
|
||||
└────────────────────────────────────────────────────────────────────────────────────────────┘
|
||||
12px
|
||||
┌────────────────────────────────────────────────────────────────────────────────────────────┐
|
||||
│ [新增诊单] [批量指派医助] [批量取消指派] 已选 n 条（按需显示） │
|
||||
├────┬──────┬──────┬───────────┬──────────────┬──────┬────────┬──────┬──────┬──────────┬──────┬────────────────────┤
|
||||
│ □ │ ID │ 患者 │ 性别/年龄 │ 挂号 │ 确认 │ 复诊 │ 助理 │ 开方 │未服务天数│旁观* │ 操作* │
|
||||
├────┼──────┼──────┼───────────┼──────────────┼──────┼────────┼──────┼──────┼──────────┼──────┼────────────────────┤
|
||||
│ □ │123 NEW│张三 │ 男 · 42岁 │[待问诊] 医生 │未确认│日期/医生│医助 │已开方│ 8 │进入 │查看 诊单 开方 … 更多│
|
||||
│ │ │ │ │时间 / 渠道 │ │ │ │ │ │ │ │
|
||||
├────┴──────┴──────┴───────────┴──────────────┴──────┴────────┴──────┴──────┴──────────┴──────┴────────────────────┤
|
||||
│ 共 n 条 [15条/页] [<] 1 2 … [>] 前往 [ ] 页 │
|
||||
└────────────────────────────────────────────────────────────────────────────────────────────┘
|
||||
* 右侧固定列，共 460px
|
||||
```
|
||||
|
||||
### 3.2 结构说明
|
||||
|
||||
- 外层 `main` 是整页垂直滚动容器；诊单表没有本页固定高度或纵向虚拟滚动，15 条数据会把页面自然撑高。证据：`layout/default/components/main.vue:2-11`、`index.vue:179-190`。
|
||||
- 两张卡都使用 `shadow="never"` 与 `!border-none`；保留 Element Card 的白底、裁切和 `4px` 圆角。框架默认：Element Plus `card.scss:9-17`、`common/var.scss:1226-1235`。
|
||||
- 页面根节点只设 `min-height:100%`、页面底色和水平居中；不设自身宽度、最大宽度或 padding。证据：`index.vue:2200-2206`。
|
||||
- 顶部全局 header、面包屑和多页签属于应用壳，不在 `index.vue` 中；它们是否出现受全局 setting 控制，不能当作本页标题复刻。
|
||||
|
||||
## 4. 可复刻的基础 token
|
||||
|
||||
### 4.1 字体与基础尺寸
|
||||
|
||||
| 项 | 源码确定值 | 证据 |
|
||||
|---|---:|---|
|
||||
| 字体族 | `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei, sans-serif` | `tailwind.config.js:79-81`、`var.css:2` |
|
||||
| body / Element base | `14px` | `public.scss:1-3`、`var.css:16` |
|
||||
| small / extra-small | `13px / 12px` | `var.css:17-18` |
|
||||
| 默认控件高度 | `32px` | Element Plus `common/var.scss:233-241` |
|
||||
| small 控件高度 | `24px` | 同上 |
|
||||
| 默认圆角 | `4px` | Element Plus `base.css:1` |
|
||||
| 卡片圆角 | `4px` | Element Plus `common/var.scss:1227-1234` |
|
||||
|
||||
字体栅格的真实像素高度仍受 Windows 缩放、浏览器 DPR 与首个可用字体影响；页面 chip 没有固定 `height`/`line-height`，只能精确复刻 padding，不能仅凭源码承诺最终外框高度。
|
||||
|
||||
### 4.2 亮色主题
|
||||
|
||||
项目在 `App.vue` mount 时用 setting 重写 Element 语义色。默认主色不是 Element 原生蓝，而是 `#4A5DFF`。主题派生算法见 `src/utils/theme.ts:3-18,29-37,55-74`。
|
||||
|
||||
| token | 默认运行值 | 使用处 |
|
||||
|---|---|---|
|
||||
| `--el-color-primary` | `#4A5DFF` | active chip、主按钮、链接、loading |
|
||||
| primary light-3 / 5 / 7 / 8 / 9 | `#808EFF / #A5AEFF / #C9CEFF / #DBDFFF / #EDEFFF` | hover、focus、轻底色 |
|
||||
| primary dark-2 | `#3B4ACC` | active 状态；页面另有硬编码近似值 `#3A4ACC` |
|
||||
| success | `#67C23A` | 已完成 chip、已确认、成功按钮 |
|
||||
| warning | `#E6A23C` | 待分配、未确认、警示行 |
|
||||
| danger | `#F56C6C` | NEW、删除/取消 |
|
||||
| info | `#909399` | 待预约、完成预约、次要态 |
|
||||
| page / card | `#F6F6F6 / #FFFFFF` | 页面底 / 卡片与普通行 |
|
||||
| primary / regular / secondary text | `#333333 / #666666 / #999999` | 标题信息 / 常规 / 辅助 |
|
||||
| placeholder / disabled | `#A8ABB2 / #C0C4CC` | 空值、禁用 |
|
||||
| border / light / lighter | `#DCDFE6 / #E4E7ED / #EBEEF5` | 控件、卡线、行分隔 |
|
||||
| fill / light / lighter | `#F0F2F5 / #F8F8F8 / #FAFAFA` | hover、表头、斑马纹 |
|
||||
| loading mask | `rgba(255,255,255,.5)` | 表格加载蒙层 |
|
||||
|
||||
证据：`src/config/setting.ts:9-14`、`src/styles/var.css:9-43`。主色的派生结果使用项目同一 `css-color-function` 算法计算；不是页面硬编码。warning/info 的页面渐变使用 `--el-color-*-rgb`，其当前框架默认分别为 `230,162,60` 和 `144,147,153`（Element Plus `base.css:1`）。
|
||||
|
||||
### 4.3 暗色与运行时主题边界
|
||||
|
||||
- `.dark` 下页面底为 `#0A0A0A`、普通背景 `#1D2124`、overlay `#1D1E1F`，主/常规/次要文字为 `#E5EAF3 / #CFD3DC / #A3A6AD`，lighter border 为 `#363637`。证据：`src/styles/dark.css:1-31`。
|
||||
- `App.vue` 根据 `useDark()` 调用主题生成器，主色仍可保持 `#4A5DFF`，但 light-* 在暗色下改用 shade 算法。证据：`src/App.vue:29-34`、`src/utils/theme.ts:12-18,55-77`。
|
||||
- setting 会从本地缓存覆盖默认颜色，因此**某个真实账号的主色/语义色可能不同**。证据：`src/stores/modules/setting.ts:12-50,65-77`。上表是无用户自定义时的确定基线。
|
||||
- 页面内硬编码的 `#4A5DFF`、`#3A4ACC` 与 `rgba(74,93,255,...)` 不会随自定义主题变化，因而自定义主题下会出现两套蓝色。证据：`index.vue:2522-2529,2556-2559,2596-2599`。
|
||||
|
||||
## 5. 顶部筛选卡
|
||||
|
||||
### 5.1 卡与第一行
|
||||
|
||||
筛选卡 body padding 为 `12px 16px`。第一行 `.filter-main` 是单行 flex：垂直居中、两端对齐、组间 `16px`、下边距 `8px`；**自身没有 `flex-wrap`**。左侧 `.date-chips` 才可换行，chip 间距 `6px`。证据：`index.vue:3-76,2208-2225`。
|
||||
|
||||
| 元素 | 几何/排版 | 默认/交互颜色 | 证据 |
|
||||
|---|---|---|---|
|
||||
| 普通日期 chip | padding `6px 12px`；14px/500；r6；transition `.2s` | 常规 `#666` + `#F8F8F8`；hover `#F0F2F5`；active 白字 + 主色 | `index.vue:2227-2250` |
|
||||
| chip 计数 | 与标题相隔 `4px`；normal style；opacity `.8` | 跟随父 chip | `index.vue:23-24,2237-2241` |
|
||||
| 待预约 | 普通 chip 外再有左 margin `8px` | info / info-light-9；active info 实色 | `index.vue:26-32,2253-2265` |
|
||||
| 已完成 | 左 margin `8px` | success / success-light-9；active success 实色 | `index.vue:33-39,2268-2280` |
|
||||
| 待分配医助 | 权限控制；外容器可换行、gap `8px`、左 margin `8px` | warning / warning-light-9；active warning 实色 | `index.vue:40-70,2283-2308` |
|
||||
| 待分配月份 | default 月选择器；宽 `128px` | Element 默认输入态 | `index.vue:51-60,2310-2312` |
|
||||
| 待分配宽搜索 | default 输入；宽 `220px`，最大 `42vw` | Element 默认输入态 | `index.vue:61-69,2314-2317` |
|
||||
| 主搜索 | default 输入宽 `160px` | placeholder“患者姓名 / 手机号” | `index.vue:72-75,2320-2326` |
|
||||
| 查询 | primary default button；高 `32px`，14px，r4 | 白字/主色底 | `index.vue:74`、Element Plus `button.scss:22-43,76-82` |
|
||||
|
||||
日期 chip 的实际顺序是：**昨天、前天、当天、明天、后天、全部**，不是按自然日期升序；随后才是 3 个业务 chip。证据：`index.vue:964-976`。页面挂载时直接选中当天并请求列表；各 chip 计数延后到 idle（不支持时延后约 `120ms`）获取，所以首帧可能只有标签、稍后才出现数字。证据：`index.vue:1046-1095,2174-2182`。
|
||||
|
||||
### 5.2 第二行快捷筛选
|
||||
|
||||
- 第二行上方有 `1px solid #EBEEF5`；自身 `padding-top:8px`、`margin-top:8px`、水平 gap `6px`、垂直居中。证据：`index.vue:78-102,2329-2335`。
|
||||
- “挂号：”“确认：”为 `13px #999`，label 后额外 `2px`。每组都是“全部 / 已… / 未…”。证据：`index.vue:79-97,2337-2341`。
|
||||
- 小 chip 最终 padding 是 `.chip-sm` 的 `4px 10px`，13px、r4、透明底；hover/active 用主色文字与 primary-light-9，active 权重 500。证据：`index.vue:2343-2366`。
|
||||
- 两组之间为 `1×14px` 的 lighter 分隔线，左右 margin `4px`。证据：`index.vue:2368-2373`。
|
||||
- “更多筛选”是 primary/link/small 按钮，左 margin `8px`；展开时 ArrowDown 旋转 `180°`，文字变“收起”。源码没有为该旋转指定独立 transition。证据：`index.vue:98-101,2375-2380`。
|
||||
|
||||
### 5.3 展开筛选区
|
||||
|
||||
展开区使用 `v-show`，所以是即时显隐而非折叠动画。它为可换行 flex，gap `10px`，上 margin/padding 各 `8px`，顶部是 `1px dashed #EBEEF5`。证据：`index.vue:104-151,2384-2391`。
|
||||
|
||||
控件从左到右：
|
||||
|
||||
1. 诊断类型 select（small，`24px` 高）；
|
||||
2. 证型 select（small）；
|
||||
3. 医助 select（small，可搜索）；
|
||||
4. 最近挂号日期范围（共享 `DaterangePicker`，`260px` 宽、最大 100%，未传 size，故 default `32px` 高）；
|
||||
5. 最近指派日期范围（同上）；
|
||||
6. 最近挂号渠道（small，可搜索，宽 `170px`）；
|
||||
7. 重置（small button，`24px` 高）。
|
||||
|
||||
证据：`index.vue:104-150,2393-2405`；共享日期组件只是透传一个 `el-date-picker`，见 `components/daterange-picker/index.vue:1-11,15-31`。因此展开区客观上混有 `24px` 与 `32px` 两种控件高度。前三个 select 没有本页固定宽度；Element Select 自身是 `width:100%` 的可收缩 flex item，最终每行宽度依赖可用空间与浏览器 flex 计算，源码不能给出一个稳定像素值。
|
||||
|
||||
## 6. 列表卡操作栏
|
||||
|
||||
- 列表卡距筛选卡 `12px`，body padding 清零。证据：`index.vue:154,2408-2412`、Tailwind spacing `tailwind.config.js:103-113`。
|
||||
- 操作栏为左右两端布局，padding `10px 16px`，底边 `1px #EBEEF5`；未固定高度。default button 高 `32px`，故无换行时栏高至少约 `52px`。证据：`index.vue:155-177,2414-2429`。
|
||||
- 左侧依权限显示：primary“新增诊单”、success“批量指派医助”、warning/plain“批量取消指派”。后两者按选中状态禁用。右侧仅在选中数量大于 0 时显示 `13px #999` 的“已选 n 条”。证据：`index.vue:157-176`。
|
||||
- `.list-actions` 声明 `gap:8px`，但 Element 默认还有 `.el-button + .el-button { margin-left:12px }`，此处没有清零。因此相邻按钮的实际起点间空白通常是 **20px（8+12）**，而不是设计者表面写下的 8px。证据：`index.vue:2421-2424`、Element Plus `button.scss:72-74`。
|
||||
|
||||
## 7. 表格规格
|
||||
|
||||
### 7.1 外框与表头
|
||||
|
||||
- 表格外围 padding `10px 16px 0`；表格宽度 100%，默认 fixed layout、无竖边框；行之间由 `1px #EBEEF5` 底边分隔。证据：`index.vue:178-190,2432-2434`、Element Plus `table.scss:11-20,188-195,217-235`。
|
||||
- 表头底 `#F8F8F8`、13px/600、文字 `#666`。默认 cell 水平 padding `12px`，行高 `23px`，纵向 padding `8px`，所以单行表头的理论最小高度约 **39px**（23+16，不含亚像素/边线差异）。证据：`index.vue:2710-2716`、Element Plus `table.scss:156-195`、`common/var.scss:1014-1031`。
|
||||
- 表头“未服务天数”有双态排序箭头，顺序只允许 descending → ascending；激活箭头使用主色。证据：`index.vue:297-304`、Element Plus `table.scss:548-552`。
|
||||
|
||||
### 7.2 列宽与内容
|
||||
|
||||
| 次序 | 列 | 声明宽度 | 对齐/固定 | 主要视觉内容 |
|
||||
|---:|---|---:|---|---|
|
||||
| 1 | 选择 | `48px` | center | header 全选 + 行 checkbox |
|
||||
| 2 | ID | `min 70px` | left | ID 为 14px/600；未读指派时附 small/dark/danger `NEW` |
|
||||
| 3 | 患者 | `min 60px` | left | 患者名 14px/600；头像模板已注释，不显示 |
|
||||
| 4 | 性别 / 年龄 | `100px` | left | `男 · 42岁`，继承表格 14px |
|
||||
| 5 | 挂号 | `min 175px` | left | 预约状态 badge、医生、时间、可取消链接、最近渠道；无则“未挂号” |
|
||||
| 6 | 确认 | `88px` | center | 13px 已确认/未确认文字 |
|
||||
| 7 | 复诊 | `min 120px` | left | 时间、医生、可选“处方已作废” tag；无则“无” |
|
||||
| 8 | 助理 | `100px` | left | 13px 次要文字，溢出 tooltip |
|
||||
| 9 | 开方 | `72px` | center | 13px 已开方/未开方 |
|
||||
| 10 | 未服务天数 | `110px` | center | 13px/600 tabular number，按天数绿/橙/红；可有健康打卡 tooltip |
|
||||
| 11 | 视频旁观 | `120px` | center / right fixed | small link 或 12px 次要状态 |
|
||||
| 12 | 操作 | `340px` | left / right fixed | 5 个 small/link 主动作 + click dropdown |
|
||||
|
||||
证据：`index.vue:191-406`。声明宽度/最小宽度合计约 `1403px`；`min-width` 列在更宽窗口可继续分配余量。右固定区域为 `120+340=460px`，Element 会在滚动边缘加 fixed-column 阴影；阴影值来自框架 `common/var.scss:981-1000`。
|
||||
|
||||
### 7.3 行高与密度
|
||||
|
||||
- 本页再次把 body cell 设为 `padding:8px 0`，cell 内层保留 Element 的水平 `12px` 与 `23px` line-height。纯单行内容的最小行高约 **39px**。证据：`index.vue:2720-2722`、Element Plus `table.scss:188-195`。
|
||||
- 挂号 cell 有 `min-height:36px`、内 padding `4px 8px`、r6，所以含该列的常规数据行通常至少约 **52px**（cell 36 + table 上下 16）；实际由内容较高者决定。证据：`index.vue:2485-2489`。
|
||||
- 同一诊单多条预约时，每一后续预约额外带 `8px` top margin、`8px` top padding 和 `1px dashed #EBEEF5`，行高会显著增加，不是固定行高。证据：`index.vue:227-247,2490-2494`。
|
||||
- 操作区允许换行；链接数量受权限与记录状态影响，所以操作列也可能增高整行。证据：`index.vue:344-403,2683-2688`。
|
||||
|
||||
### 7.4 斑马、hover 与业务高亮
|
||||
|
||||
| 状态 | 静态 | hover | 判定优先级 |
|
||||
|---|---|---|---|
|
||||
| 普通奇数行 | 白 `#FFF` | `#F8F8F8` | 无业务类 |
|
||||
| 普通偶数行 | `#FAFAFA` | `#F8F8F8` | `stripe` |
|
||||
| 未确认 | 预期左侧 `3px #E6A23C`；从左到右 warning RGB `.06 → transparent` | warning RGB `.10 → transparent`，直接覆盖 `td` | 第一优先 |
|
||||
| 已确认但未挂号 | 预期左侧 `3px #909399`；info RGB `.04 → transparent` | info RGB `.08 → transparent`，直接覆盖 `td` | 第二优先 |
|
||||
|
||||
判定函数先检查“是否确认”，只有已确认才检查“是否挂号”，所以一行不会同时得到两个业务类。证据：`index.vue:1313-1337`。页面声明见 `index.vue:2723-2735`；斑马和 hover 框架规则见 Element Plus `table.scss:560-588,665-668`。
|
||||
|
||||
实现时必须区分“源码意图”和“浏览器可见结果”：
|
||||
|
||||
- 静态业务渐变在 `tr`，而偶数斑马行和 fixed cell 的背景落在 `td`；不透明 `td` 会遮住下面的 `tr` 渐变。
|
||||
- 业务 hover 选择器直接命中 `td` 且带 `!important`，因此 hover 更可靠。
|
||||
- `border-left` 施加在 `tr`，在 `border-collapse:separate` 的 table 中具体像素绘制还受浏览器表格格式化上下文影响。
|
||||
|
||||
PySide 复刻应按“意图”直接给每个可见 cell/row delegate 绘背景和 3px 左条，避免复现 CSS 遮挡缺陷；若目标是截图逐像素一致，则需先用指定 Chromium、固定数据测一张运行态截图。
|
||||
|
||||
### 7.5 单元格内部视觉
|
||||
|
||||
#### 患者与 ID
|
||||
|
||||
- `.patient-name` 为 14px/600、`#333`、line-height `1.3`。ID 与患者列都复用该样式。证据：`index.vue:194-212,2461-2470`。
|
||||
- 32×32、r8、主色渐变的头像 CSS 存在，但患者模板已注释，不参与实际页面。证据：`index.vue:207,2447-2459`。
|
||||
- `NEW` 是 small (`20px` 高)、danger、dark tag：白字、danger 实色底；字体 12px、r4。证据：`index.vue:198`、Element Plus `tag.scss:66-87,142-165`、`common/var.scss:1110-1138`。
|
||||
|
||||
#### 挂号块
|
||||
|
||||
- 每个预约 badge：11px/600、padding `2px 6px`、r4、下 margin `2px`；医生 14px/600 `#333`；时间 12px、上 margin `2px`。证据：`index.vue:2496-2519`。
|
||||
- 活跃预约 badge 为 `#3A4ACC` / `rgba(74,93,255,.15)`，时间硬编码 `#4A5DFF`；整块为 135° 蓝色渐变 `.12 → .06`，边 `rgba(74,93,255,.3)`。证据：`index.vue:2522-2531,2556-2559`。
|
||||
- 已完成预约用 info-dark-2 / info-light-7；爽约用 warning-dark-2 / warning-light-7。整块也分别换成 info 或 warning 透明渐变。证据：`index.vue:2533-2569`。
|
||||
- 最近渠道为上 margin `6px`、12px、line-height `1.35`、`#999`；未挂号为 13px `#A8ABB2`。证据：`index.vue:2571-2581`。
|
||||
|
||||
#### 语义文字与 tag
|
||||
|
||||
- 已确认：13px/500 success；未确认：13px/600 warning。证据：`index.vue:2584-2594`。
|
||||
- 已开方：13px/500、硬编码 `#4A5DFF`；未开方：13px `#A8ABB2`。证据：`index.vue:2596-2605`。
|
||||
- 复诊时间 13px/500 `#333`，医生 12px `#999`，纵向 gap `4px`、line-height `1.35`；“处方已作废”是 small/plain/info tag。证据：`index.vue:268-285,2651-2676`。
|
||||
- 未服务天数：最小 `28px`、13px/600、等宽数字；空值灰 `#A8ABB2`/400，`<=2` 绿 `#16A34A`，`3-6` 橙 `#EA580C`，`>=7` 红 `#DC2626`。证据：`index.vue:305-316,1319-1329,2607-2632`。
|
||||
- 视频旁观为 12px、line-height `1.4`，左右 padding `2px`；不可进入时是 `#999`。证据：`index.vue:318-341,2690-2704`。
|
||||
|
||||
## 8. 按钮、dropdown、tooltip
|
||||
|
||||
### 8.1 操作列链接
|
||||
|
||||
直接动作依次为：查看（primary）、诊单（primary）、开方/查看处方（primary）、预约（success）、补全身份证（warning），最后是 info“更多”。权限会移除部分按钮。证据：`index.vue:345-403`。
|
||||
|
||||
- 均为 `size="small"`、`link`：12px，透明边/底，padding `2px`，高度 auto；hover 使用各语义色的 light-3。证据：Element Plus `button.scss:223-248`、`element.scss:113-127`。
|
||||
- `.action-cell` 设 flex-wrap + `gap:4px`；但相邻 `.el-button + .el-button` 仍有 `12px` 左 margin，因此连续按钮间通常是 **16px（4+12）**。dropdown 外壳与前一按钮之间只有 flex gap `4px`。证据：`index.vue:2683-2688`、Element Plus `button.scss:72-74`。
|
||||
- 340px 操作列不足时允许链接换行；没有强制单行或省略号。
|
||||
|
||||
### 8.2 “更多”菜单
|
||||
|
||||
- click 触发、`bottom-end` 对齐。菜单项按权限/状态可包含：指派、取消指派、视频二维码、二维码、取消挂号、挂号日志、创建订单、删除。证据：`index.vue:379-403`。
|
||||
- Element 默认 dropdown item 为 14px、line-height `22px`、padding `5px 16px`，故普通项约 `32px` 高；菜单上下净 padding 约 `5px`，r4、overlay 白底，popper 有 light border 与 shadow。hover 为 fill-light + primary。证据：Element Plus `dropdown.scss:7-24,42-70,137-176`。
|
||||
- 删除项有 divided 顶线，文字由 `.text-danger` 强制为 danger。证据：`index.vue:400,2706-2708`。
|
||||
- tooltip 使用 Element 默认 popper：12px、line-height `20px`、padding `5px 11px`；实际位置由视口碰撞计算，不能从源码固定。
|
||||
|
||||
## 9. 分页、空态与加载态
|
||||
|
||||
### 9.1 分页
|
||||
|
||||
- 列表默认 `page=1, size=15`；共享组件页容量选项为 `[15,20,30,40]`。证据：`src/hooks/usePaging.ts:14-34`、`components/pagination/index.vue:18-28`。
|
||||
- 布局固定为 `total, sizes, prev, pager, next, jumper`，最多显示 5 个 pager，单页也不隐藏。证据：`components/pagination/index.vue:3-14,24-28`。
|
||||
- 容器右对齐，padding `10px 16px 16px`。默认分页按钮 `32×32px`（最小宽），14px，r2，项组间 gap token `16px`；active 仅主色文字 + bold，并未启用 background 模式。证据：`index.vue:408-410,2436-2440`、Element Plus `common/var.scss:1034-1057`、`pagination.scss:5-67`。
|
||||
- page-size select 框架宽 `128px`，jumper 输入 `56px`。证据：Element Plus `pagination.scss:73-75,118-150`。
|
||||
- 视口 `<=768px` 时，全局 CSS 隐藏 size selector 与 jumper，仍保留 total、prev、pager、next。证据：`src/styles/element.scss:177-184`。
|
||||
|
||||
### 9.2 空态
|
||||
|
||||
页面没有提供 table `#empty` slot，也没有在主列表使用 `el-empty`。因此空列表为：
|
||||
|
||||
- sticky empty block，min-height `60px`；
|
||||
- 居中纯文本“暂无数据”；
|
||||
- 文字 `#999`，line-height `60px`，宽 50%；
|
||||
- 表头、底线和分页仍存在。
|
||||
|
||||
证据：`index.vue:179-190`、Element Plus `table.scss:52-70`、`src/App.vue:5,25-28`、Element 中文 locale `zh-cn.mjs:137`。
|
||||
|
||||
### 9.3 加载
|
||||
|
||||
- `v-loading="pager.loading"` 直接挂表格；普通请求开始时 loading=true，完成后 false。证据：`index.vue:179-184`、`src/hooks/usePaging.ts:35-72`。
|
||||
- 蒙层绝对覆盖 table，z-index 2000，亮色为 `rgba(255,255,255,.5)`；中央环 `42px`，主色描边 `2px`，2 秒旋转、1.5 秒 dash 动画。证据：`src/styles/var.css:41-43`、Element Plus `loading.scss:19-73,85-103`、`common/var.scss:1340-1349`。
|
||||
- 页面每 20 秒静默刷新列表和计数；标签页不可见时跳过，静默刷新不打开 loading，因此不会周期性白闪。证据：`index.vue:1098-1105,2182-2195`、`src/hooks/usePaging.ts:36-42,64-71`。
|
||||
- 首次 `pager.loading` 初值是 false，但 mount 后立即调用 `getLists()`，正常网络下会很快进入蒙层；能否肉眼看到取决于响应时长。
|
||||
|
||||
## 10. 响应式与滚动行为
|
||||
|
||||
1. `index.vue` 的 scoped 样式**没有 media query**。页面级响应式主要来自 flex-wrap、宽度上限、Element Table 横向滚动及全局分页规则。
|
||||
2. body 被全局设为 `min-width:375px`、`overflow:hidden`；应用主内容通过 `el-scrollbar` 承担页面滚动。证据：`src/styles/public.scss:1-3`、`layout/default/components/main.vue:2-11`。
|
||||
3. 第一筛选行本身不换行。左侧日期 chip 可换行，但右侧 160px 搜索 + 32px 查询按钮仍与左侧同一 flex 行；在极窄内容宽度下可能压缩、增高左侧或溢出，源码没有把搜索行堆到下一行的断点。
|
||||
4. 待分配容器可换行，宽搜索最多 `42vw`；展开筛选区可换行，两个日期范围各为 `260px` 且 `max-width:100%`。证据：`index.vue:2298-2317,2384-2405`。
|
||||
5. 表格 min 总宽约 1403px。Element Table 内部提供横向 scrollbar；右侧 460px fixed 区保持可见，导致很窄时可见的左侧业务列空间进一步减少。
|
||||
6. 外层应用在窄屏会折叠侧栏，但那是壳层行为，不改变本页筛选/表格 DOM。证据：`src/App.vue:36-53`。
|
||||
7. dark mode 有完整全局变量，但页面的硬编码蓝/绿/橙/红不会自适应；其亮度对比应另做暗色运行态验收。
|
||||
|
||||
## 11. 直接挂载的覆盖层（不占主页面静态布局）
|
||||
|
||||
主列表下方常驻挂载多个异步组件或 dialog/drawer；关闭时不占主页面空间，操作后覆盖在页面之上：
|
||||
|
||||
| 入口 | 覆盖层 | 关键尺寸 | 证据 |
|
||||
|---|---|---:|---|
|
||||
| 新增/诊单 | `edit.vue` 诊单 drawer | `60%` | `index.vue:414`、`edit.vue:1-10` |
|
||||
| 详情组件 | `detail.vue` popup | `800px` | `index.vue:415`、`detail.vue:1-10` |
|
||||
| 开方/处方 | `tcm-prescription` drawer | `1200px` | `index.vue:416`、`components/tcm-prescription/index.vue:1-8` |
|
||||
| 预约 | `appointment.vue` drawer | `60%` | `index.vue:417`、`appointment.vue:1-10` |
|
||||
| 视频旁观 | AssistantWatchCall dialog | `760px`；视频 grid min `220px` | `index.vue:418-422`、`AssistantWatchCallDialog.vue:1-19,242-284` |
|
||||
| 挂号日志 | drawer | `460px` | `index.vue:424-447` |
|
||||
| 小程序二维码 | dialog | `400px`；二维码 `256×256` | `index.vue:449-481` |
|
||||
| 指派医助 | dialog | `500px` | `index.vue:483-531` |
|
||||
| 创建订单 | dialog | `600px` | `index.vue:533-587` |
|
||||
| 补全身份证 | dialog | `400px` | `index.vue:589-615` |
|
||||
| 企微记录 | drawer | `600px` | `index.vue:617-722` |
|
||||
|
||||
这些覆盖层说明“操作按钮点击后”的页面层级，但其完整内部视觉不应混入诊单 index 主页面的静态复刻范围。
|
||||
|
||||
## 12. PySide 映射建议
|
||||
|
||||
### 12.1 页面与筛选
|
||||
|
||||
| Vue/CSS 意图 | PySide 建议 | 复刻要点 |
|
||||
|---|---|---|
|
||||
| 外层 `el-scrollbar` + 两张 card | `QScrollArea` → 单一 `QWidget/QVBoxLayout`；卡用 `QFrame` | viewport `#F6F6F6`；外 margin `16V/8H`；卡 r4、白底、无 border/shadow；卡间 12 |
|
||||
| date chips | 自定义 `FlowLayout` + checkable `QToolButton` | padding 6×12、r6、gap6；计数拼接为同一 label，保持源码顺序 |
|
||||
| 业务色 chip | 同一 button class 加 dynamic property | `pending_booking/info`、`completed/success`、`pending/warning`；active 白字实底 |
|
||||
| 第一行搜索 | `QHBoxLayout` 右侧固定 `QLineEdit(160)` + `QPushButton` | 高 32、gap8；若追求源码一致，不自行添加窄屏 stack |
|
||||
| 第二行筛选 | `QHBoxLayout`/FlowLayout + `QToolButton` | top line、上下 8；13px；active primary-light-9 |
|
||||
| 更多筛选 | 可显隐 `QWidget` + FlowLayout | 无动画；top dashed border；gap10；small 控件 24，日期范围 32 |
|
||||
|
||||
Qt 没有内建通用 FlowLayout，建议采用 Qt 示例式 `FlowLayout`，并把 chip 的 `sizeHint()` 包含字体宽度、左右 12/10px padding；不要用固定总宽，否则计数从一位变三位时会截断。
|
||||
|
||||
### 12.2 表格
|
||||
|
||||
- 使用 `QTableView + QAbstractTableModel`，不要堆 15 行 QWidget。列的 initial/min widths 按本规格表设置；表头高建议从 `39px` 起，常规 row 从 `52px` 起，并由 delegate `sizeHint()` 为多预约/操作换行增高。
|
||||
- 选择列用 check-state delegate；ID/患者、确认、复诊、开方、未服务天数分别用专用 delegate 绘文字和 tag，避免嵌套控件带来的滚动性能问题。
|
||||
- 挂号列用一个复合 delegate：r6 的状态背景、11px badge、14px/600 医生、12px 时间、多预约虚线分隔。可点击“取消挂号”若必须嵌入，可在命中区域处理 mouse event，而不是每格常驻 QPushButton。
|
||||
- 两个右固定列可用**同步滚动的双 `QTableView`**：主表隐藏最后两列，右表只显示 120/340 两列，共宽 460；共享 model、selection model、vertical scrollbar 与 row height。单一 QTableView 无 Element 的 sticky fixed-column 等价物。
|
||||
- 行背景应在 delegate 对每个 cell 绘制：普通白/`#FAFAFA`，hover `#F8F8F8`；业务行覆盖渐变并在第一可见 cell 绘 3px 语义条。不要把渐变只画在 viewport 底层，否则会重现 HTML `td` 遮挡问题。
|
||||
- 操作列优先使用 delegate + 命中区域或常驻 `QWidget` 行容器；若用按钮，链接样式为 12px、2px padding、无背景/边框，并预留源码实际的较大按钮间距。
|
||||
- 横向滚动时保持右表固定；表头与 body 必须共用列宽。多预约行要同步两张表的 row height。
|
||||
|
||||
### 12.3 dropdown、分页、空态、加载
|
||||
|
||||
- “更多”使用 `QMenu`，item 高约 32、左右 padding16、14px；按权限/状态动态构建，删除项前 `addSeparator()` 且 danger 文本。
|
||||
- 分页建议自定义 `PaginationBar`：total、15/20/30/40 combo、prev、最多 5 页、next、jump；高度32，容器右对齐并保留 `10T/16H/16B`。窗口内容宽度 <=768 时隐藏 combo 与 jump。
|
||||
- 空态在 `QTableView.viewport()` 中央放一个透明 `QLabel("暂无数据")`，有效高度 60；不要用大插画。仍显示 header 和分页。
|
||||
- 加载态用覆盖 table rect 的半透明 widget：亮色 `rgba(255,255,255,.5)`，中央约 42px 主色 spinner。新请求显示；20 秒静默刷新不显示。
|
||||
- 用 generation/request id 丢弃过期异步响应，并只在当前请求结束时关闭 overlay；这不是 Vue 当前 `latestOnly:false` 的视觉保证，但能避免 PySide 快速筛选时旧响应造成闪回。
|
||||
|
||||
### 12.4 主题与字体
|
||||
|
||||
- 定义集中 token，而不是把 `#4A5DFF` 散落在 QSS；但为了忠实，挂号块与“已开方”目前应保留硬编码蓝，或在设计确认后统一为 theme primary。
|
||||
- Windows 上首选“Microsoft YaHei UI”还是源码的“Microsoft YaHei”会改变字宽；逐像素复刻应显式用 `Microsoft YaHei`，14px CSS 大致映射为 Qt pixelSize 14，而不是 pointSize 14。
|
||||
- Qt 的 devicePixelRatio 与 CSS px 不同。截图验收需固定 Windows 缩放（建议 100%）、字体、窗口内容宽度和主题。
|
||||
|
||||
## 13. 能从源码确定 / 不能从源码确定
|
||||
|
||||
### 可以确定
|
||||
|
||||
- DOM 顺序、无页面内标题、两张卡、每个筛选和操作入口；
|
||||
- 页面局部 padding/gap/宽度、列声明宽度、固定列、颜色、字体大小/字重；
|
||||
- 日期 chip 的顺序与当天默认态；
|
||||
- 表格 stripe、业务类判定优先级、语义文本与预约块状态；
|
||||
- 共享分页的页容量、布局、空态文案、loading 结构；
|
||||
- 默认亮/暗 token 及运行时主题派生方式；
|
||||
- 权限或数据条件控制哪些按钮/tag 出现。
|
||||
|
||||
### 仅运行态可最终确定
|
||||
|
||||
1. **最终换行和行高**：取决于 viewport、数据长度、按钮权限、预约条数、字体回退、DPR；chip 和多数 row 都没有固定 height。
|
||||
2. **实际主题色**：setting 存在本地缓存，账号可改主色及语义色；dark 状态也来自浏览器存储/系统偏好。
|
||||
3. **业务行静态渐变是否完整可见**：受 `tr` 背景、striped/fixed `td` 背景与 Chromium table paint 顺序影响；源码只能确定规则叠加关系。
|
||||
4. **fixed-column 阴影和 scrollbar 尺寸**：由 Chromium/Element 的滚动状态、平台 scrollbar 策略决定。
|
||||
5. **tooltip/dropdown 的最终坐标**：popper 会做视口碰撞与翻转。
|
||||
6. **加载态停留时间和计数出现时间**：由 API 延迟、idle callback 调度决定；静默轮询通常无蒙层。
|
||||
7. **应用壳标题/面包屑/多页签**：由路由菜单、setting 和权限生成，不是 `index.vue` 的页面内视觉。
|
||||
|
||||
若后续要求“像素级截图一致”，应在固定 `Element Plus 2.13.7 + Chromium 版本 + 100% Windows 缩放 + 默认亮色主题 + 固定权限/样本数据` 下补一轮运行态测量；本文件已经给出源码能够保证的全部静态约束与明确边界。
|
||||
@@ -0,0 +1,153 @@
|
||||
# 诊单视觉重构最终业务回归审计（三次终验）
|
||||
|
||||
- 终验日期：2026-08-10
|
||||
- 范围：生产视频/IM、医生备注与日常记录 mutation、处方/订单、多挂号精确取消、诊单 Shell owner、列表 QR/日志/订单；并复核上一版已关闭的权限、DTO、隐私与 generation 项。
|
||||
- 基准：当前最新 Python 源码与测试，以及 `D:/web/zyt/admin`、`D:/web/zyt/server` 的实际 admin 行为和服务端控制器/Logic。
|
||||
- 约束：只读业务终验；未安装依赖、未打包、未访问线上接口。除更新本报告外，未修改业务源码或测试。
|
||||
|
||||
## 最终结论
|
||||
|
||||
第三次终验后的剩余项为：
|
||||
|
||||
- **P0：0，明确无 P0。**
|
||||
- **P1：1 项 OPEN。** 诊单列表“创建订单”已调用真实 `order.order/create`，但没有消费返回的 `order_no` 并调用现成的 `generate_order_qrcode`，admin 的付款二维码闭环仍中断。
|
||||
- **P2：2 项 OPEN。** 一是日常矩阵不能编辑已有血糖/饮食/运动记录；二是视频回放只显示每条记录的第一个 URL，且没有 admin 的“向具体通话记录追加回放”入口。
|
||||
- **服务端不可实现限制：不计入 P0/P1/P2。** 医生备注与跟踪备注的服务端契约只支持按当天追加；服务端没有任意旧正文覆盖或整条删除 endpoint，桌面端无法在不扩展后端的前提下实现这些动作。
|
||||
- 其余本轮复核项均 **CLOSED**：生产视频/IM 取数与同步、备注追加/附件、日常新增与待办、处方动作、订单详情/偏移、精确挂号取消、列表视频/确认 QR 与日志、真实 Shell 60%/move-resize/close generation。
|
||||
- 定向离线回归：**128/128 passed**。
|
||||
|
||||
| 复核项 | 三次终验状态 | 最终等级 | 摘要 |
|
||||
|---|---|---:|---|
|
||||
| 生产视频/IM `only_archived`、sync、上传、回放 | **OPEN（主体 CLOSED）** | **P2** | 生产接口、同步、工具栏上传和首个回放可用；多 URL 与指定 call-record 追加入口缺失 |
|
||||
| 医生备注 mutation | **CLOSED** | — | 追加正文、上传舌象/报告、删除单附件均走真实合同；正文覆盖/整条删除属后端无 endpoint 限制 |
|
||||
| 日常记录 mutation | **OPEN（新增 CLOSED）** | **P2** | 新增血糖/饮食/运动/跟踪备注及待办新增/取消可用；已有三类记录不能编辑 |
|
||||
| 处方/详情订单动作 | **CLOSED** | — | 开方、处方查看、业务订单列表/详情与诊次偏移均真实落库/取数 |
|
||||
| 多挂号精确取消 | **CLOSED** | — | 每个挂号卡携带精确 ID，最终调用 `doctor.appointment/cancel` |
|
||||
| 诊单 owner、60%、move-resize、generation | **CLOSED** | — | 每次打开重绑真实 Shell，宽度为 Shell 60%，移动/缩放/关闭同步且所有异步代次失效 |
|
||||
| 列表 QR / 日志 / 创建订单 | **OPEN（QR/日志/创建主体 CLOSED）** | **P1** | 视频/确认 QR、日志、创建订单均真实调用；创建成功后的支付 QR 未接入 UI |
|
||||
|
||||
上一版已关闭的 `phonePlain`、canonical `diagnosis_type`、`viewOnly` endpoint 分流、detail 失败禁存、身份证 15/18 位校验、权限 Tab 裁剪与隐私脱敏，本轮定向回归均未发现反弹。
|
||||
|
||||
## 逐项证据
|
||||
|
||||
### 1. 生产视频/IM：`[OPEN / P2，主体 CLOSED]`
|
||||
|
||||
已关闭部分：
|
||||
|
||||
- `RemoteDoctorRepository` 已实现生产 `getCallRecords`、手工 call record、附件关联及“上传 → 创建记录 → 关联”顺序：`src/doctor_workstation/services/repository.py:1875-1943`。这与 admin `CallRecordPanel` 的真实流程一致：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:109-180`。
|
||||
- IM 首次读取明确发 `only_archived=1`，同步走 `triggerImChatSync`：`src/doctor_workstation/services/repository.py:1945-1965`；dialog 的 lazy 查询也固定 `only_archived=True`：`src/doctor_workstation/ui/dialogs/diagnosis.py:2016-2038`。admin 对照为 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:148-185`。
|
||||
- edit 态视频工具栏调用真实上传，成功后按 media generation 重新加载；聊天同步成功后延时重新读取归档：`src/doctor_workstation/ui/dialogs/diagnosis.py:2541-2611`。聊天图片/文件只能通过 HTTP(S) 安全打开：`:2652-2658`。
|
||||
- production/server 合同存在：`D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:397-438`、`:505-538`；归档快路径在 `D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1015-1045`。
|
||||
|
||||
仍 OPEN 的 P2：
|
||||
|
||||
- 服务端返回 `recording_urls_list` 数组：`D:/web/zyt/server/app/adminapi/logic/tcm/DiagnosisLogic.php:1810-1833`；admin 把完整数组交给播放器，并在每个具体 call row 提供上传入口：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:30-72`。
|
||||
- Python `_fill_video` 只取 `raw_urls[0]`，其余回放不可见，且视频表没有指定 `call_record_id` 的上传操作列：`src/doctor_workstation/ui/dialogs/diagnosis.py:1126-1135`、`:2844-2881`。虽然 repository 已支持 `call_record_id`（`src/doctor_workstation/services/repository.py:1894-1913`），UI 没有把它接出来。
|
||||
|
||||
该问题不造成错误写入，且工具栏上传与一个回放可用，故按 **P2** 而非 P1 计。
|
||||
|
||||
### 2. 医生备注：`[CLOSED；后端限制已明确]`
|
||||
|
||||
- NotesTimeline 已暴露新增、上传、删除单附件与打开附件信号：`src/doctor_workstation/ui/diagnosis_drawer.py:1804-1810`、`:1820-1851`、`:1887-1961`；dialog 绑定真实方法：`src/doctor_workstation/ui/dialogs/diagnosis.py:989-997`、`:2376-2487`。
|
||||
- production DTO 分别走 `doctor.appointment/addDoctorNote`、`doctor.appointment/doctorNotes`、`doctor.appointment/deleteDoctorNoteImage`：`src/doctor_workstation/services/repository.py:935-985`。权限分别按新增与删除附件 endpoint 裁剪：`src/doctor_workstation/ui/dialogs/diagnosis.py:478-483`、`:1233-1241`。
|
||||
- admin 自身也只有追加、上传、删除单附件动作：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:195-268`；API 定义仅三条：`D:/web/zyt/admin/src/api/patient.ts:19-40`。
|
||||
|
||||
服务端不可实现边界：
|
||||
|
||||
- controller 仅暴露 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`，随后类即结束：`D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-198`。
|
||||
- `DoctorNoteLogic::addOrAppend` 对当天正文使用换行追加，不支持任意旧正文覆盖：`D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:12-76`；唯一删除逻辑只删除附件数组中的单项：`:111-136`。
|
||||
|
||||
因此“任意旧笔记正文覆盖/整条删除”不是桌面端漏接已有合同，而是服务端没有 endpoint；本报告将其列为**后端限制，不计客户端 P0/P1/P2**。
|
||||
|
||||
### 3. 日常记录：`[OPEN / P2，新增 CLOSED]`
|
||||
|
||||
已关闭部分：
|
||||
|
||||
- edit 态已提供血糖、饮食、运动、跟踪备注新增按钮和待办新增/取消；只读态/无权限态隐藏：`src/doctor_workstation/ui/diagnosis_drawer.py:1363-1371`、`:1431-1450`、`:1481-1511`、`:1760-1791`。
|
||||
- dialog 将 signal 接到真实 add/todo repository，并为每次 mutation 使用 diagnosis-id + generation 校验后强制刷新：`src/doctor_workstation/ui/dialogs/diagnosis.py:1089-1101`、`:2175-2358`。
|
||||
- production 合同为 `tcm.bloodRecord/add`、`tcm.dietRecord/add`、`tcm.exerciseRecord/add`、`tcm.diagnosis/addTrackingNote`、todo add/cancel：`src/doctor_workstation/services/repository.py:1745-1765`、`:1778-1805`、`:1847-1873`。
|
||||
|
||||
仍 OPEN 的 P2：
|
||||
|
||||
- admin 点击已有单元格时会把记录（含 `id`）放入表单，保存时分别调用 blood/diet/exercise edit：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:921-1013`。
|
||||
- Python matrix 明确 `NoEditTriggers`、`NoSelection`，只有 `daily_add_requested`，没有已有记录 edit signal：`src/doctor_workstation/ui/diagnosis_drawer.py:1366-1371`、`:1455-1463`。dialog 也只选择 `add_*`：`src/doctor_workstation/ui/dialogs/diagnosis.py:2260-2284`。
|
||||
- 这不是后端限制：production repository 已实现三类 edit：`src/doctor_workstation/services/repository.py:1767-1776`、`:1787-1796`、`:1807-1818`。
|
||||
|
||||
跟踪备注例外：server 设计就是“仅给今天追加”。controller 仅有 add/list：`D:/web/zyt/server/app/adminapi/controller/tcm/DiagnosisController.php:180-214`；`TrackingNoteLogic` 只有 `addOrAppend/getByDiagnosis`，类在第 95 行结束：`D:/web/zyt/server/app/adminapi/logic/tcm/TrackingNoteLogic.php:8-95`。其任意旧正文覆盖/整条删除同样属于后端无 endpoint 限制，不计客户端问题。
|
||||
|
||||
### 4. 处方与详情订单动作：`[CLOSED]`
|
||||
|
||||
- “开具处方”打开真实 `PrescriptionEditorDialog`，accepted 后调用 `create_prescription`，并携带 diagnosis/appointment/case snapshot：`src/doctor_workstation/ui/dialogs/diagnosis.py:2489-2539`。
|
||||
- 历史处方的“查看”打开真实 `PrescriptionDetailDialog`：`:2791-2842`。
|
||||
- 业务订单 lazy 列表、详情权限/真实 repository 门禁、异步 order generation 及详情 dialog 均已接通：`:1998-2000`、`:2069-2074`、`:2883-2991`。
|
||||
- 全局诊次偏移调用真实 `setRevisitSlotStartOffset`，并有独立 generation：`:2613-2650`。
|
||||
|
||||
未发现处方或详情订单的假动作/越权入口，本项 **CLOSED**。
|
||||
|
||||
### 5. 多挂号精确取消：`[CLOSED]`
|
||||
|
||||
- 每个可取消挂号卡按精确 primary key 生成按钮，signal 携带原 record 与该 appointment-id：`src/doctor_workstation/ui/diagnosis_index_widgets.py:150-163`、`:1121-1148`。歧义的行级“取消挂号”仍只在唯一挂号时出现：`:1403-1410`。
|
||||
- handler 选择当前诊单后再次按 ID 和状态校验，确认前后都防 stale，最终仅调用 exact capability：`src/doctor_workstation/ui/pages/consultations.py:1868-1921`。
|
||||
- production 方法明确走 `doctor.appointment/cancel`，不再误用患者工作区 endpoint：`src/doctor_workstation/services/repository.py:1545-1555`。
|
||||
- 新测试覆盖两个挂号、超 32 位 appointment-id、错误诊单、状态刷新、权限/能力缺失与 canonical endpoint：`tests/test_diagnosis_index_visual.py:340-379`、`tests/test_consultations_parity_ui.py:610-774`、`tests/test_diagnosis_detail_contract.py:90-105`。
|
||||
|
||||
本项 **CLOSED**。
|
||||
|
||||
### 6. 真实 Shell owner / 60% / move-resize / generation：`[CLOSED]`
|
||||
|
||||
- `_owner` 不再在 page 构造期缓存；每次 `open_for/showEvent` 都从当前 `parent.window()` 重绑真实 Shell：`src/doctor_workstation/ui/dialogs/diagnosis.py:526-527`、`:1314-1349`、`:1398-1408`。
|
||||
- overlay 与 owner 同位置/尺寸，宽屏 drawer 固定为 owner 宽度 60%；监听 owner 的 Resize/Move/Show/Close：`:1283-1299`、`:1351-1371`。
|
||||
- `reject/done` 及 owner Close 会使 detail/save/orders/order-detail/daily/notes/media/offset/所有 lazy-tab generation 全部失效：`:1373-1383`、`:1681-1700`。
|
||||
|
||||
真实 `ShellWindow -> QStackedWidget -> ConsultationsPage -> cached DiagnosisDialog` offscreen 探针结果：
|
||||
|
||||
```text
|
||||
OPEN owner_shell=True shell=(1200,760) dialog=(1200,760) panel=720 expected=720 pos=(80,60)
|
||||
MOVED shell=(1024,650) dialog=(1024,650) panel=614 expected=614 pos=(190,140)
|
||||
CLOSE visible=False generation=True media=True
|
||||
```
|
||||
|
||||
本项 **CLOSED**。现有 `tests/test_diagnosis_drawer_visual.py:837-861` 仍只用直接顶层 owner；本次额外真实 Shell 探针补足了业务终验，但建议后续把该探针固化成回归测试。
|
||||
|
||||
### 7. 列表 QR / 日志 / 订单：`[OPEN / P1，主体 CLOSED]`
|
||||
|
||||
已关闭部分：
|
||||
|
||||
- 页面只在 canonical 权限与真实 repository 方法同时存在时展示视频 QR、确认 QR、日志、订单入口：`src/doctor_workstation/ui/pages/consultations.py:704-715`、`:1005-1030`。
|
||||
- QR DTO 校验 patient/doctor/share-user/diagnosis，日志使用 diagnosis-id，所有菜单请求均受 selection generation 保护：`:1972-2091`。
|
||||
- production repository 真实调用 `generateMiniProgramQrcode`、`guahaoLogList`、`order.order/create`：`src/doctor_workstation/services/repository.py:1967-2060`。测试验证 exact DTO、权限裁剪与 stale callback：`tests/test_diagnosis_detail_contract.py:85-127`、`tests/test_consultations_parity_ui.py:777-958`。
|
||||
|
||||
仍 OPEN 的 P1：
|
||||
|
||||
- admin 创建订单成功后读取 `order_no`，立即调用 `generateOrderQrcode` 并展示付款 QR：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1474-1509`。
|
||||
- Python `_create_diagnosis_order` 把真实 create 放进通用 `_run_mutation`；该 helper 丢弃 `_result`，只 toast + refresh，因此永远不会生成付款 QR：`src/doctor_workstation/ui/pages/consultations.py:2093-2128`、`:2460-2479`。
|
||||
- repository 明明已有 `generate_order_qrcode`：`src/doctor_workstation/services/repository.py:2062-2076`，但 UI 源码没有任何调用。现有测试也只分别测试“UI 创建订单”和“repository 可生成 QR”，未覆盖两者串联：`tests/test_consultations_parity_ui.py:777-872`、`tests/test_diagnosis_detail_contract.py:88-89`。
|
||||
|
||||
订单已实际创建却不展示付款入口，用户容易停在半完成状态或重复建单；这是主流程闭环缺失，按 **P1 OPEN** 计。
|
||||
|
||||
## 离线验证记录
|
||||
|
||||
使用项目现有 `.venv`，设置 `QT_QPA_PLATFORM=offscreen`、`PYTHONDONTWRITEBYTECODE=1`，禁用 pytest cache，并把 basetemp 放在系统临时目录；未安装任何依赖：
|
||||
|
||||
```text
|
||||
pytest -q -p no:cacheprovider \
|
||||
tests/test_diagnosis_detail_contract.py \
|
||||
tests/test_diagnosis_index_visual.py \
|
||||
tests/test_diagnosis_drawer_visual.py \
|
||||
tests/test_appointment_drawer_visual.py \
|
||||
tests/test_consultations_parity_ui.py \
|
||||
tests/test_prescription_security_ui.py \
|
||||
tests/test_patients_ui.py \
|
||||
tests/test_repository_parity.py \
|
||||
tests/test_permissions.py
|
||||
|
||||
128 passed
|
||||
```
|
||||
|
||||
测试退出码为 0；`--collect-only -q` 分文件计数合计 128。另执行了上述真实 Shell owner 探针，退出码为 0。
|
||||
|
||||
## 发布判断
|
||||
|
||||
当前不存在错误 endpoint、歧义挂号取消、权限泄漏、隐私明文回流或关闭后旧异步回调落地等 P0 风险。生产视频/IM、备注追加、日常新增、处方、订单详情及列表主要动作均已从“假动作/未接入”进展为真实 repository 行为。
|
||||
|
||||
但若发布标准是“完整保留 admin 的订单支付闭环与所有已存在的数据编辑/回放能力”，当前仍不满足：**剩余 P0 0 / P1 1 / P2 2**。其中任意旧医生/跟踪笔记正文覆盖或整条删除必须先扩展 server endpoint，不能作为桌面端单独修复项。
|
||||
@@ -0,0 +1,113 @@
|
||||
# 诊疗工作台第三次、最终只读视觉同型审计
|
||||
|
||||
审计日期：2026-08-10
|
||||
审计性质：最终只读终验；除更新本报告外，未修改任何业务代码、测试、renderer 或 PNG。
|
||||
事实源：当前 Python 源码、D:/web/zyt/admin/src/views/tcm/diagnosis/ 下 Vue 基准、三份既有视觉规格，以及 artifacts/diagnosis_visual/ 当前 43 张 PNG。
|
||||
判定方法：43 张 PNG 均按原始尺寸逐张目检；源码只用于解释可见结果与确认真实能力。测试通过数不作为任何视觉结论的依据，本轮也未以测试替代目检。
|
||||
|
||||
## 最终结论
|
||||
|
||||
**PARTIAL，不是 PASS。**
|
||||
|
||||
- P0：**0 OPEN**。语义表单、1024 栅格、右固定列、双尺寸 60% 抽屉、固定 footer、核心 loading/empty/error/focus/permission 状态均未回退。
|
||||
- 上一版 12 项 P1：**8 项 CLOSED / EXACT，4 项仍 OPEN / PARTIAL**。
|
||||
- 43 张当前 PNG：**36 张 EXACT（其中两张 edit 仅指入镜区域）、7 张 PARTIAL、0 张乱码或不可读**。
|
||||
- 列表、详情、预约与 Shell 的所有 loading 图均为真实圆弧 spinner；没有字符型 spinner、方框箭头、中文乱码或缺字。
|
||||
- 当前不能判 PASS 的原因是：1024 Daily 动作行裁切及按钮语义态被压平；完整菜单仍缺 Vue 图标、danger 删除色和精确文案；备注附件视觉仍未命中预期样式；处方/订单/视频/聊天仍有可见简化或缺少关键截图证据。
|
||||
- “既有笔记整条正文覆盖 / 删除整条笔记”另列为服务端合同限制，不计作伪造桌面能力，也不用于掩盖上述视觉 P1。
|
||||
|
||||
## 上一版 12 项 OPEN 逐项终验
|
||||
|
||||
| # | 上一版问题 | 状态 | 同型分类 | 最新精确证据与目检结论 |
|
||||
|---:|---|---|---|---|
|
||||
| 1 | 统计端就诊卡仍非 switch | **CLOSED** | **EXACT（组件）** | 当前已使用自绘二态 DiagnosisSwitch，44×24 轨道、圆形滑块、0/1 文本合同：src/doctor_workstation/ui/diagnosis_drawer.py:643-675；表单 show_card 分支：src/doctor_workstation/ui/dialogs/diagnosis.py:924-925；Vue 基准：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:341-348。现有 edit PNG 没有滚到该字段，因此本项是源码级确定结论，不引用测试，也不声称有单独的 switch 截图。 |
|
||||
| 2 | Daily 编辑动作不完整 | **OPEN** | **PARTIAL** | + 血糖 / + 饮食 / + 运动 / + 备注、刷新、新增待办和精确可取消动作均已接入：src/doctor_workstation/ui/diagnosis_drawer.py:1431-1450、:1486-1512、:1764-1784；真实处理：src/doctor_workstation/ui/dialogs/diagnosis.py:2175-2356。可是 diagnosis_state_daily_1024x640.png 中最右“刷新”被抽屉右缘裁掉；原因是单个 QHBoxLayout 不换行（diagnosis_drawer.py:1398-1451），而 Vue 明确 flex-wrap（D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1094-1109）。同时“最近7天”的 checked 态、+血糖 与新增待办的 primary 态均被 scoped 基础按钮规则压平；Vue 的主动作在 DailyMatrix.vue:25-35、DiagnosisTodoList.vue:3-19。 |
|
||||
| 3 | “更多”菜单动作被关闭 | **OPEN** | **PARTIAL** | 能力缺口已补齐：权限/真实方法策略在 src/doctor_workstation/ui/pages/consultations.py:1002-1031，handler 在 :1672-1692；diagnosis_full_menu_1280x800.png 已出现指派、取消指派、视频二维码、确认二维码、取消挂号、挂号日志、创建订单、删除。仍不同型：Python 只创建纯文字 QAction（src/doctor_workstation/ui/diagnosis_index_widgets.py:1381-1431），Vue 每项有图标，删除为 divided + danger 红，并使用“二维码”而不是“确认二维码”（D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400）。QMenu 白底、边框、hover 与分隔线样式已生效（diagnosis_index_widgets.py:1371-1380），但未覆盖这些剩余语义。 |
|
||||
| 4 | Tab 溢出仍用左右箭头 | **CLOSED** | **EXACT** | 原生左右工具按钮宽度归零，额外 4 px 横向滚动条可见并驱动选中 Tab：src/doctor_workstation/ui/diagnosis_drawer.py:194-242、:749-792；Vue 基准：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1798-1828。所有 1024 详情状态图均无盒状左右箭头，蓝色细滚动条连续可见。 |
|
||||
| 5 | footer 缺上投影 | **CLOSED** | **EXACT** | footer 使用 blur 18、offset 0/-4、半透明深色 QGraphicsDropShadowEffect：src/doctor_workstation/ui/dialogs/diagnosis.py:784-803；Vue 为 0 -4px 24px / 7%：D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1792-1796。edit/viewOnly/daily/save 状态图均可见 footer 上缘阴影，且 footer 始终在滚动体外。 |
|
||||
| 6 | 保存中无按钮 spinner / 结果态 | **CLOSED** | **EXACT** | SaveStateButton 以 QTimer + QPainter 画 loading 圆弧、成功勾和失败叉：src/doctor_workstation/ui/diagnosis_drawer.py:678-746；只在 editable/basic 显示：src/doctor_workstation/ui/dialogs/diagnosis.py:1652-1661；真实保存状态切换：:3044-3163。diagnosis_state_save_loading/success/failure_1024x640.png 分别完整显示“正在保存 / 保存成功 / 保存失败”，无缺字。 |
|
||||
| 7 | readonly 摘要拆“客服” | **CLOSED** | **EXACT** | 摘要值禁止换行并使用 MinimumExpanding：src/doctor_workstation/ui/dialogs/diagnosis.py:681-712；“客服：…”赋值：:1767-1770。diagnosis_readonly_1024x640.png 与 diagnosis_readonly_1440x900.png 均完整显示“客服：赵医助”，不再拆字。 |
|
||||
| 8 | Notes 缺新增、上传、删除动作 | **OPEN** | **PARTIAL** | 动作和真实端点已存在：NotesTimeline 信号/工具栏/单附件删除在 src/doctor_workstation/ui/diagnosis_drawer.py:1804-1962；处理在 src/doctor_workstation/ui/dialogs/diagnosis.py:2376-2478；远端合同在 src/doctor_workstation/services/repository.py:935-985。diagnosis_state_notes_actions_1024x640.png 已显示新增/追加、上传舌象、上传报告、打开与单附件删除。但视觉仍不同型：QSS 写的是 QLabel#DiagnosisTongueThumb 与 QLabel#DiagnosisAttachmentChip（diagnosis_drawer.py:486-500），运行时却创建 QPushButton（:1897-1900、:1932-1937），所以截图中的“舌象/查看”和报告附件退化为普通白按钮，而非 Vue 的真实缩略图、文件 chip 与叠加 CircleClose（D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:42-100）。 |
|
||||
| 9 | 处方、订单、视频、聊天仍为简化实现 | **OPEN** | **PARTIAL / MISSING** | 处方已接完整 PrescriptionEditorDialog 和真实 create_prescription（src/doctor_workstation/ui/dialogs/diagnosis.py:2489-2539），订单偏移及详情入口已接真实方法（:2613-2650、:2883-2941），视频上传/回放和聊天归档同步也已接真实方法（:2541-2611、:2844-2881）。但视觉仍未闭合：处方按钮在 diagnosis_state_empty_1024x640.png 中为普通白色“开具处方”，而 Vue 是 primary 小号“开方”（D:/web/zyt/admin/src/views/tcm/diagnosis/components/CaseRecordList.vue:1-5）；当前证据集没有处方编辑器或订单详情抽屉 PNG。diagnosis_state_video_replay_1024x640.png 只有外链“播放回放”，代码通过 QDesktopServices 打开 HTTP(S)（diagnosis.py:2652-2658、:2874-2881），而 Vue 是表格内 RecordingPlaybackBlock（D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:17-34）。diagnosis_state_chat_archive_1024x640.png 有气泡、文件和同步/重载，但省略 Vue 的完整 info alert 和详细归档说明（D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:1-20）。订单偏移可见部分本身为 EXACT。 |
|
||||
| 10 | 表格状态仍整格着色而非 pill | **CLOSED** | **EXACT** | set_status_tag 以 QLabel pill 放入 cell widget，不再染整格：src/doctor_workstation/ui/diagnosis_drawer.py:2366-2384；所有状态列经 semanticize 转换：src/doctor_workstation/ui/dialogs/diagnosis.py:1900-1921、:2752-2754、:2822-2825、:2870-2874、:2898-2902。diagnosis_state_daily_lower_1024x640.png 的“待执行”蓝色 pill 是直接视觉证据。 |
|
||||
| 11 | Shell 仍为 216/68 且无 40 px tabs | **CLOSED** | **EXACT** | 侧栏 183：src/doctor_workstation/ui/shell.py:537-540；topbar 50：:599-603；multiple-tabs 40：:683-687。diagnosis_shell_1024x640.png 与 diagnosis_shell_1440x900.png 均可直接量出 183/50/40 三段，比例一致。 |
|
||||
| 12 | Shell 颜色偏离且箭头缺字 | **CLOSED** | **EXACT（本项范围）** | 侧栏为 #1D2124：src/doctor_workstation/ui/shell.py:541-569；方向、刷新、全屏、下拉、关闭图形均由 QPainter 自绘，不依赖字体 glyph：:257-395；topbar/tab QMenu 样式：:599-628、:683-723。两张最新 Shell PNG 中“更多筛选”、行“更多”、用户菜单和 tabs 菜单箭头均正常，没有方框或乱码。 |
|
||||
|
||||
## 最后增加的三个专项检查
|
||||
|
||||
| 专项 | 状态 | 结论 |
|
||||
|---|---|---|
|
||||
| scoped panel 按钮 | **OPEN / PARTIAL** | src/doctor_workstation/ui/diagnosis_drawer.py:112-136 的 QDialog#DiagnosisDialogRoot QPushButton 规则确实把详情按钮从全局暖灰绿主题隔离出来；但它的 ID 选择器优先级高于全局 QPushButton[variant="primary/ghost"]（src/doctor_workstation/ui/theme.py:87-118），而局部 QSS 没有补 primary、ghost、dangerGhost、diagnosisRange:checked 规则。结果在 daily/处方/视频/待办 PNG 中所有动作都被压成同一白色按钮，选中态也不清楚。这是实图结果，不是测试推断。 |
|
||||
| QMenu | **OPEN / PARTIAL** | diagnosis_full_menu_1280x800.png 证明局部白底、细边框、32 px 左右行高、分隔线和菜单宽度已生效；但与 Vue 相比仍缺每项图标、danger 删除色，且“确认二维码”文案不精确。证据：src/doctor_workstation/ui/diagnosis_index_widgets.py:1371-1431 对照 D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400、:2706-2708。 |
|
||||
| 紧凑 close | **CLOSED / EXACT** | Header close 被限定 32×32、透明常态、蓝色 hover/focus：src/doctor_workstation/ui/diagnosis_drawer.py:137-154；创建位置：src/doctor_workstation/ui/dialogs/diagnosis.py:754-782。diagnosis_state_focus_1024x640.png 显示紧凑透明常态，默认 edit/viewOnly 图显示蓝色 focus/hover 外观，没有被全局 40 px footer 按钮规则放大。 |
|
||||
|
||||
## 43 张 PNG 原尺寸目检矩阵
|
||||
|
||||
下表的 EXACT 只针对该张 PNG 实际入镜内容；不以不可见的滚动下方内容作证明。
|
||||
|
||||
| PNG | 分类 | 原尺寸目检结论 |
|
||||
|---|---|---|
|
||||
| diagnosis_1024x640.png | **EXACT** | 窄屏筛选换行、表格内部横向溢出、右固定列和阴影稳定，无硬裁切。 |
|
||||
| diagnosis_1440x900.png | **EXACT** | 宽屏列密度、复合挂号卡、斑马/业务语义色和固定操作区成立。 |
|
||||
| diagnosis_advanced_filters_1280x800.png | **EXACT** | 高级筛选即时展开，日期范围、控件顺序和重置入口完整。 |
|
||||
| diagnosis_double_appointment_cancel_1280x800.png | **EXACT** | 同一诊单两条预约均有各自取消入口，虚线层级和固定列正常。 |
|
||||
| diagnosis_empty_1280x800.png | **EXACT** | 表头、内部空态、横向滚动和 0 条分页均保留。 |
|
||||
| diagnosis_error_1280x800.png | **EXACT** | 错误文本居中可读，无旧数据穿透。 |
|
||||
| diagnosis_focus_1280x800.png | **EXACT** | 搜索框蓝色 focus ring 清楚且不挤压布局。 |
|
||||
| diagnosis_full_menu_1280x800.png | **PARTIAL** | 8 项动作与分隔线齐全；缺 Vue 图标、danger 删除色，二维码文案不同。 |
|
||||
| diagnosis_horizontal_scroll_1024x640.png | **EXACT** | 主表横移、右 460 px 固定区不动，左缘阴影连续。 |
|
||||
| diagnosis_hover_warning_1280x800.png | **EXACT** | warning 行 hover 渐变、3 px 左条和固定区同步。 |
|
||||
| diagnosis_loading_1280x800.png | **EXACT** | 表内真实圆弧 spinner，内容淡化，无字符缺字。 |
|
||||
| diagnosis_pending_assign_1280x800.png | **EXACT** | 待分配 chip、月份与宽搜索保持同一流式区。 |
|
||||
| diagnosis_permissions_cropped_1280x800.png | **EXACT** | 权限裁掉 toolbar 与敏感动作，仅保留查看。 |
|
||||
| diagnosis_edit_1024x640.png | **EXACT（可见区）** | 60% 抽屉、2/3 列语义表单、细 tab 条、固定 footer 无裁切；switch 未入镜。 |
|
||||
| diagnosis_edit_1440x900.png | **EXACT（可见区）** | 宽屏密度、字段比例和 footer 稳定；switch 未入镜。 |
|
||||
| diagnosis_readonly_1024x640.png | **EXACT** | 独立只读页、hero、病例卡完整，“客服”不拆字。 |
|
||||
| diagnosis_readonly_1440x900.png | **EXACT** | 4 列病例密度和异常指标层级完整，无不必要换行。 |
|
||||
| diagnosis_viewonly_1024x640.png | **EXACT** | 60% 只读抽屉、权限提示、禁用表单与仅关闭 footer 成立。 |
|
||||
| diagnosis_viewonly_1440x900.png | **EXACT** | 宽屏只读栅格、全 Tab 条和固定 footer 成立。 |
|
||||
| diagnosis_state_daily_1024x640.png | **PARTIAL** | DailyMatrix、异常/自录内容和新增动作出现；最右“刷新”被裁，range/primary 语义态被压平。 |
|
||||
| diagnosis_state_daily_lower_1024x640.png | **PARTIAL** | 趋势、待办筛选、表格与 pill 出现；“新增待办”不是 Vue primary，toolbar 语义层级不足。 |
|
||||
| diagnosis_state_empty_1024x640.png | **PARTIAL** | 处方空态和仅取消 footer 正确；“开具处方”按钮文案/primary 样式不同，且未覆盖真实处方编辑器。 |
|
||||
| diagnosis_state_error_1024x640.png | **EXACT** | danger banner、重试、空表单、禁用保存完整。 |
|
||||
| diagnosis_state_focus_1024x640.png | **EXACT** | 姓名 focus ring、紧凑 close 常态和固定 footer 清晰。 |
|
||||
| diagnosis_state_loading_1024x640.png | **EXACT** | 圆弧 spinner 与“正在加载诊单...”完整，无旧 seed 或缺字。 |
|
||||
| diagnosis_state_permission_1024x640.png | **EXACT** | 只保留病历/医生备注，手机号与身份证掩码，footer 仅关闭。 |
|
||||
| diagnosis_state_notes_actions_1024x640.png | **PARTIAL** | 增加/上传/打开/单附件删除均出现；舌象与报告未呈现为 Vue 缩略图/chip。 |
|
||||
| diagnosis_state_order_offset_1024x640.png | **EXACT（可见区）** | 偏移数值框、保存、订单表、分页与横向滚动完整；订单详情未入镜。 |
|
||||
| diagnosis_state_save_failure_1024x640.png | **EXACT** | 红色叉与“保存失败”完整。 |
|
||||
| diagnosis_state_save_loading_1024x640.png | **EXACT** | 白色圆弧 spinner 与“正在保存”完整。 |
|
||||
| diagnosis_state_save_success_1024x640.png | **EXACT** | 绿色勾与“保存成功”完整。 |
|
||||
| diagnosis_state_video_replay_1024x640.png | **PARTIAL** | 回放动作可见且文案完整；仍是外链按钮，不是 Vue 表内播放器。 |
|
||||
| diagnosis_state_chat_archive_1024x640.png | **PARTIAL** | 左右气泡、图片/文件入口、同步/重载可见；完整 info alert 与原文案缺失。 |
|
||||
| diagnosis_shell_1024x640.png | **EXACT（本项范围）** | 183/50/40，深色侧栏、分页、三角箭头和中文均无缺字。 |
|
||||
| diagnosis_shell_1440x900.png | **EXACT（本项范围）** | 同一 Shell 比例在宽屏保持，固定列阴影和 horizontal scroll 清楚。 |
|
||||
| appointment_drawer_1024x640.png | **EXACT** | 60% 右抽屉、日期/时段、body 滚动与固定 footer 无裁切。 |
|
||||
| appointment_drawer_1440x900.png | **EXACT** | 医生 radio、四个 130×40 日期按钮、时段网格、备注与 footer 对齐。 |
|
||||
| appointment_drawer_empty_doctors_1440x900.png | **EXACT** | warning、80 px 空态插图、“暂无可预约医生”和禁用确认完整。 |
|
||||
| appointment_drawer_empty_roster_1440x900.png | **EXACT** | 无排班 warning、空态插图和“该医生暂无排班”可读。 |
|
||||
| appointment_drawer_error_1440x900.png | **EXACT** | “号源加载失败：号源服务暂时不可用”、刷新入口与空态并存。 |
|
||||
| appointment_drawer_keyboard_focus_1440x900.png | **EXACT** | 130×40 日期按钮的蓝色键盘 focus 边界清楚。 |
|
||||
| appointment_drawer_loading_1440x900.png | **EXACT** | “正在加载医生、渠道与挂号状态...”与真实圆弧 spinner 完整，无缺字。 |
|
||||
| appointment_drawer_refreshing_1440x900.png | **EXACT** | “正在刷新可用号源...”与 overlay spinner 完整，确认禁用。 |
|
||||
|
||||
## 服务端合同限制：不归入视觉 P1
|
||||
|
||||
当前服务端只提供“当日追加 / 查询 / 删除单个附件”，没有“任意覆盖既有正文”或“删除整条笔记”端点：
|
||||
|
||||
- D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-196 只公开 addDoctorNote、doctorNotes、deleteDoctorNoteImage。
|
||||
- D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-69 按 diagnosis_id + 当天 find-or-create，并把新正文追加为新行，不是任意覆盖。
|
||||
- D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:114-136 只删除 tongue_images / report_files 中的单个路径。
|
||||
- D:/web/zyt/admin/src/api/patient.ts:19-40 同样只有上述三个客户端 API。
|
||||
- Python 远端仓库与该合同一致：src/doctor_workstation/services/repository.py:935-985。
|
||||
|
||||
因此桌面端没有伪造“覆盖旧正文 / 删除整条笔记”按钮是正确的 fail-closed 行为。该限制不能被当作视觉 PASS 的理由，也不应混入上面 4 个仍可修的 UI P1。
|
||||
|
||||
## 最终判定
|
||||
|
||||
- **P0：0 OPEN。**
|
||||
- **P1：4 OPEN / PARTIAL**：Daily 动作行与 scoped 按钮语义；完整菜单图标/删除色/文案；Notes 附件视觉；处方/订单/视频/聊天视觉与证据覆盖。
|
||||
- **MISSING 视觉证据**：当前 diagnosis_visual 没有滚动到 switch 的截图，也没有完整处方编辑器和订单详情抽屉截图；源码能力存在，但不能用测试代替这些像素证据。
|
||||
- **乱码 / 缺字：0。** 43 张图中的中文、圆弧 loading、箭头、保存勾叉均完整。
|
||||
- **最终：PARTIAL。** 只有消除上述 4 组可见差异并补齐处方编辑器、订单详情与 switch 的当前截图后，才可给视觉同型 PASS。
|
||||
|
||||
@@ -0,0 +1,547 @@
|
||||
# Python 医生工作站诊单视觉 / 交互差异审计
|
||||
|
||||
> 审计日期：2026-08-10
|
||||
> 结论：**OPEN — 当前实现不具备与管理端诊单主链做截图级验收的条件。** 主要差异不是局部颜色或间距，而是索引页层级、表格固定列、只读/编辑形态和预约选择器的组件架构不同。
|
||||
> 约束：本轮只读检查业务源码；只新增本审计文档，未修改 Python、Vue、接口、payload、权限、状态门槛或业务流程。
|
||||
> 环境说明：项目提示的 `D:/web/zyt/app/.trellis/` 当前不存在，因此没有可补读的 Trellis 工作流或包级规格。
|
||||
|
||||
## 1. 范围与事实源
|
||||
|
||||
当前 Python 审计范围：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py` 中 `_AppointmentDialog` 及其入口
|
||||
|
||||
管理端唯一视觉事实源：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue`
|
||||
- 上述页面直接渲染的 diagnosis components、`NoteTimeline.vue` 以及直接生效的全局样式
|
||||
|
||||
研究基线：
|
||||
|
||||
- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:1-373`
|
||||
- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:1-565`
|
||||
|
||||
明确排除：其他角色页面、小程序、企微运营、二维码、视频观看弹窗、未被三主视图引用的旧 Blood/Diet/Exercise/Tracking 组件，以及任何业务接口改造。本报告提到权限时，只描述入口或 Tab 的可见状态，不重新设计权限规则。
|
||||
|
||||
## 2. 总体判定
|
||||
|
||||
| 领域 | 当前状态 | 阻断截图复刻的根因 |
|
||||
|---|---|---|
|
||||
| 全局主题与密度 | OPEN | Qt 是暖灰绿、13 px、36 px 控件；管理端诊单基线是冷灰白、14 px、32 px 控件，索引主色为 `#4A5DFF` |
|
||||
| 诊单索引 | OPEN | 多出页面标题；筛选永久四行；单表无右固定列；行操作、复合单元格、分页、空态和 loading 架构不同 |
|
||||
| 诊单只读 / 编辑 | OPEN | 独立 readonly 与 drawer viewOnly 被合并成同一个居中 `QDialog`；Tabs、字段布局和内容主链大量不等价 |
|
||||
| 预约 | OPEN | 60% 右 Drawer 被固定 540×560 Dialog 取代；医生、日期、时段网格全部降级为 ComboBox |
|
||||
| 1024×640 | OPEN | 880×680 诊单 Dialog 请求高度超过外窗；索引页无页面级滚动且高级筛选常驻，表格可见高度过低 |
|
||||
| 1440×900 | OPEN | 索引仍缺固定 460 px 右区；详情/预约保持固定宽度，无法随视口保持 60% 比例 |
|
||||
|
||||
必须先完成四项结构改造，再做颜色和像素微调：
|
||||
|
||||
1. 诊单索引改回“无页面标题 + 两张平卡 + 折叠筛选”。
|
||||
2. 诊单表使用专用 model/delegate，并实现右侧 `120 + 340 = 460 px` 固定区域。
|
||||
3. 将独立 readonly 页面与 edit/viewOnly Drawer 拆成两个视觉形态。
|
||||
4. 将预约恢复为右侧 Drawer，并恢复医生 radio、日期按钮、时段卡片网格及完整状态。
|
||||
|
||||
## 3. 基础 token 与壳层差异
|
||||
|
||||
### G-01 [阻断] 字体、颜色、控件与圆角是另一套设计系统
|
||||
|
||||
管理端诊单索引基线为 `PingFang SC, Arial, Hiragino Sans GB, Microsoft YaHei`、基础 14 px、页面 `#F6F6F6`、卡片 `#FFFFFF`、主/常规/次要文字 `#333/#666/#999`、默认控件 32 px、small 24 px、索引主色 `#4A5DFF`、卡片 r4。证据：
|
||||
|
||||
- `D:/web/zyt/admin/src/config/setting.ts:1-14`
|
||||
- `D:/web/zyt/admin/src/styles/var.css:1-43`
|
||||
- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:65-101`
|
||||
|
||||
当前 Qt 为 Microsoft YaHei UI 优先、基础 13 px、画布/表面 `#F4F3EF/#FCFBF8`、墨绿/青绿 `#17382F/#168579`、按钮和输入最小 36 px/r9、卡片 r16。状态色也全部偏成低饱和绿褐色。证据：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-33`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:36-84`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-175`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:233-250`
|
||||
|
||||
可见后果：同一页面的字宽、首屏密度、按钮高度、卡片轮廓、语义色和表格行数均不同；仅替换主色不能修复。
|
||||
|
||||
建议边界：在 `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-275` 增加以 `#DiagnosisIndex`、`#DiagnosisDrawer`、`#DiagnosisReadonly`、`#AppointmentDrawer` 为根的局部 token/QSS。除非另立全工作站换肤任务，不应直接改写共享 `Card`、`QPushButton`、`QTableWidget` 的全局规则。
|
||||
|
||||
### G-02 [高] 壳层占宽与页面滚动模型不同
|
||||
|
||||
当前 Shell 最小 1024×640，侧栏固定 216 px、顶栏固定 68 px，workspace 的 `QStackedWidget` 本身没有页面滚动容器：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:306-325`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:329-423`
|
||||
|
||||
管理端默认侧栏宽 183 px，navbar 50 px，默认还可显示 40 px multiple tabs；路由内容由 `el-scrollbar` 承担整页纵向滚动，页面外留白为 8 px 水平 / 16 px 垂直：
|
||||
|
||||
- `D:/web/zyt/admin/src/config/setting.ts:1-6`
|
||||
- `D:/web/zyt/admin/src/styles/var.css:4-10`
|
||||
- `D:/web/zyt/admin/src/layout/default/components/header/multiple-tabs.vue:65`
|
||||
- `D:/web/zyt/admin/src/layout/default/components/main.vue:2-11`
|
||||
|
||||
当前诊单页又额外使用 24 px 水平边距，因此两档窗口下的静态内容宽约为：
|
||||
|
||||
| 外窗 | 当前 workspace | 当前页面内容宽 | 管理端默认路由内容宽（约） | 差值 |
|
||||
|---|---:|---:|---:|---:|
|
||||
| 1024×640 | 808 | 760 | 824 | -64 px |
|
||||
| 1440×900 | 1224 | 1176 | 1240 | -64 px |
|
||||
|
||||
建议边界：索引页自行增加页面级滚动及 8/16 外留白；不要为了修诊单页直接改变全工作站 216/68 壳。若最终验收要求连管理端壳一起复刻，应另行冻结侧栏、navbar、multiple tabs 的 setting 后再改 `ShellWindow`。
|
||||
|
||||
### G-03 [高] hover、checked、focus、read-only 状态不完整
|
||||
|
||||
- 日期和业务入口都是 checkable ghost `QPushButton`，但 QSS 没有 `QPushButton[variant="ghost"]:checked`；active 态没有确定的可见反馈。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-118`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:495-528,776-799`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2227-2308`。
|
||||
- Qt 输入 focus 直接把 1 px 边改为 2 px 青绿实线，存在内部尺寸跳动；管理端是 primary-light 的 2 px 外环。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-154`；基准：`D:/web/zyt/admin/src/styles/element.scss:140-175`。
|
||||
- 按钮、Tab、radio、checkbox 没有统一的键盘 focus ring；表格还显式 `outline:0`。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:87-138,164-186,208-220`。
|
||||
- read-only `QPlainTextEdit` 没有独立 QSS，仍呈白底可编辑外观；只定义了部分 `:disabled`。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-155`、`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:685-689`。
|
||||
- 表格没有显式 item hover 规则；管理端普通 hover 是 `#F8F8F8`，业务行还有语义渐变。当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:177-197`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2723-2735`。
|
||||
|
||||
建议边界：为诊单专用 chip、输入、Tab、表格 delegate 增加状态规则；保留键盘可达性，不必复刻 HTML `span` 不可聚焦的缺陷。focus 不应通过改变边框占位宽度实现。
|
||||
|
||||
### G-04 [中] 共享组件的视觉契约与诊单基线不同
|
||||
|
||||
- `PageHeader` 固定生成标题/副标题层级：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:331-365`。
|
||||
- `EmptyState` 是 30 px 圆圈 + 16 px 标题 + 说明 + 44 px 垂直留白：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:388-420`。
|
||||
- `BusyOverlay` 是文字 + 140 px 横向 progress，非 42 px 环形 spinner：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:489-514`、`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:230-231,271`。
|
||||
- `SortableTable` 是单选、全列本地排序、纯文本 item、末列 stretch：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:535-575`。
|
||||
- `Pager` 只有 total、上一页、页码分数、下一页：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:585-627`。
|
||||
|
||||
建议边界：新增诊单专用组件，不要破坏性修改这些被患者、订单、接诊页共享的类。
|
||||
|
||||
## 4. 诊单索引页差异
|
||||
|
||||
### I-01 [阻断] 页面层级、留白和卡片形态错误
|
||||
|
||||
管理端页面内没有标题或说明；路由内容直接从无边框、无阴影、r4 的筛选白卡开始，第二张列表卡相距 12 px。新增诊单在列表卡工具栏：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2-177`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2200-2211,2408-2434`
|
||||
|
||||
当前页面先放 25 px `PageHeader("问诊列表", …)`，并把新增按钮放在标题右侧；外边距 24/20/24、间距 14。两张卡是有边框的暖白 r16，表格自身再加 r12，形成“卡中卡”：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:464-587`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:590-674`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:54-84,177-197`
|
||||
|
||||
建议边界：只在 `ConsultationsPage.__init__` 移除页面内 `PageHeader`，将 add 入口移入列表工具栏；保留 Shell topbar。诊单两卡使用局部 objectName/QSS。
|
||||
|
||||
### I-02 [阻断] 日期 / 业务 chip 顺序、文案、换行和语义态不同
|
||||
|
||||
管理端顺序严格是“昨天挂号、前天挂号、当天挂号、明天挂号、后天挂号、全部”，随后是待预约/已完成/待分配医助；左侧 chips 可换行，计数是同行半透明文字。三种业务 chip 分别用 info/success/warning：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:6-70`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:964-970`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2222-2317`
|
||||
|
||||
当前顺序是“前天、昨天、今天、明天、后天、全部”，缺“挂号”文案；九个按钮放在不可换行的 `QHBoxLayout`，全部是通用 ghost，无业务色和明确 checked 态：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:483-530`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:776-799`
|
||||
|
||||
在 1024 档，按钮加入两三位计数后可能在约 760 px 内容宽内被挤压或裁字。
|
||||
|
||||
建议边界：增加诊单局部 `FlowLayout` 和带 dynamic property 的 chip；沿用现有 `_choose_*` 与 `_update_quick_buttons()`，只换视图装配和文案。
|
||||
|
||||
### I-03 [阻断] 筛选的两层结构被永久四行网格取代
|
||||
|
||||
管理端：第一行右侧是固定 160 px 搜索 + 32 px primary 查询；第二行是“挂号/确认”小 chips 和“更多筛选”；高级区默认隐藏，点击后即时显隐，使用虚线上边界和可换行布局：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:72-151`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2320-2405`
|
||||
|
||||
当前：关键词、挂号、确认和所有高级条件永久铺成四行等宽 `QGridLayout`；查询/重置在最后一行。挂号/确认变成 ComboBox；最近日期范围被拆成四个独立 `QDateEdit`；还常驻一个管理端通过表头表达的“未服务排序”下拉：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:532-586`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:683-721`
|
||||
|
||||
当前还缺待分配模式选中后显示的月份 128 px 和宽搜索 220 px / max 42vw；管理端证据为 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:40-70,2298-2317`。
|
||||
|
||||
建议边界：重建筛选视图，但保留 `_search()`、`_filters()`、日期校验和现有请求字段。是否补待分配月份/宽搜索涉及现有请求参数，超出本视觉报告授权；在业务层确认前先预留容器，不自行发明接口字段。
|
||||
|
||||
### I-04 [阻断] 列表工具栏与选择模型不等价
|
||||
|
||||
管理端列表栏无“诊单记录”标题；左侧是新增、批量指派、批量取消指派，右侧按需显示“已选 n 条”。表格首列为 48 px checkbox 多选：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:154-191`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2414-2429`
|
||||
|
||||
当前工具栏是标题 + 总数摘要 + 查看/诊单/开方/作废/视频/删除/刷新等全局按钮；表格无 checkbox，使用整行单选，加载后自动选第一行并出现青绿选择底：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:590-640`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:938-946`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:1085-1112`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:541-549`
|
||||
|
||||
建议边界：视图层改为 checkbox check-state；不要用整行 selection 代替多选。批量动作若当前业务方法不存在，本轮只应建立视觉容器和禁用态，不得伪造 mutation。
|
||||
|
||||
### I-05 [阻断] 表格列、固定区、排序和行操作架构不同
|
||||
|
||||
管理端列顺序与宽度为：选择 48、ID min70、患者 min60、性别年龄 100、挂号 min175、确认 88、复诊 min120、助理 100、开方 72、未服务 110、视频旁观 120 fixed、操作 340 fixed。声明最小总宽约 1403 px，右固定区共 460 px：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:191-406`
|
||||
- `D:/web/zyt/app/research/diagnosis_index_visual_spec.md:169-186`
|
||||
|
||||
当前列约 1392 px，但无选择/操作列，额外有医生 90、作废 74；挂号 300、未服务 180、视频 90。所有列随单一 `QTableWidget` 一起滚动，末列还会 stretch：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:646-663`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:535-552`
|
||||
|
||||
管理端只允许“未服务天数”走 descending → ascending 的自定义排序；当前全部表头都可做客户端排序，并另设排序 ComboBox：
|
||||
|
||||
- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:297-304`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:543-549`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:560-570`
|
||||
|
||||
管理端每行右侧有查看、诊单、开方/查看处方、预约、补全身份证和“更多”菜单；当前把少量动作集中在列表栏，行内没有动作命中区：
|
||||
|
||||
- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:342-403`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:605-639`
|
||||
|
||||
建议边界：新增 `DiagnosisTableModel`、专用 delegates 和同步的双 `QTableView`；右表只显示 120/340 两列，共享 model、selection、垂直滚动与 row height。不要把固定列能力硬塞进通用 `SortableTable`。
|
||||
|
||||
### I-06 [阻断] 复合单元格、语义色、hover 和密度全部降级为纯文本
|
||||
|
||||
当前 `SortableTable.set_rows()` 只创建 `QTableWidgetItem(text)`；格式化函数也只拼接字符串：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:554-575`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:233-322`
|
||||
|
||||
由此缺失：
|
||||
|
||||
- ID/患者 14 px/600；`NEW` 20 px danger tag。
|
||||
- 挂号块的 11 px badge、14 px/600 医生、12 px 时间、状态渐变、多预约虚线、取消挂号链接和最近渠道。
|
||||
- 已确认/未确认、已开方/未开方、处方作废 tag。
|
||||
- 未服务 null/`<=2`/`3–6`/`>=7` 的灰/绿/橙/红，以及健康打卡 tooltip。
|
||||
- 普通白/#FAFAFA 斑马、#F8F8F8 hover、未确认/未挂号的 3 px 左条和渐变。
|
||||
- 行级视频入口和 340 px 动作链接区。
|
||||
|
||||
管理端证据：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:193-406`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:2442-2735`
|
||||
|
||||
当前表格头是 12 px/700、`#EEF1EE`，alternate 为暖灰 `#F6F7F4`；基准表头为 13 px/600、`#F8F8F8`，普通预约行约 52 px。当前只调用 `resizeRowsToContents()`，无 39/52 px 基线：
|
||||
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:177-197`、`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:938-940`
|
||||
- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:163-212`
|
||||
|
||||
建议边界：复合绘制与 `sizeHint()` 均放在诊单 delegates；不要给每格常驻 QWidget。行样本必须覆盖多预约和动作换行，且双表 row height 同步。
|
||||
|
||||
### I-07 [高] 分页、空态、loading、error 的布局契约不同
|
||||
|
||||
分页基线为 total、15/20/30/40 size、prev、最多 5 个数字页、next、jumper，按钮 32 px；当前只有 total、上一页、`1/N`、下一页，按钮最小 36 px：
|
||||
|
||||
- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:254-262`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:585-627`
|
||||
|
||||
空态基线保留表头和分页，仅在 table body 显示约 60 px 高的“暂无数据”。当前切换整个 `content_stack` 到大型 `EmptyState`，表头与分页同时消失：
|
||||
|
||||
- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:264-273`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:642-673`、`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:388-420`
|
||||
|
||||
loading 基线只覆盖表格，亮色 `rgba(255,255,255,.5)` + 42 px 主色环；20 秒静默刷新不闪。当前普通加载在两卡之间插入 MessageBanner，并禁用刷新，没有 table overlay；共享 `BusyOverlay` 的形态也不匹配：
|
||||
|
||||
- 基准：`D:/web/zyt/app/research/diagnosis_index_visual_spec.md:275-280`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:901-956`、`D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:489-514`
|
||||
|
||||
错误当前只显示全宽 Banner，原表/旧数据仍在；管理端主表没有独立 error 插画。建议保留错误消息但不得让 Banner 插入造成卡片整体跳位。
|
||||
|
||||
建议边界：新增诊单专用 PaginationBar、table viewport empty label 和 table-only overlay；保持现有 generation、silent refresh 与错误传递逻辑不变。
|
||||
|
||||
### I-08 [高] 页面纵向滚动与少量数据高度不同
|
||||
|
||||
管理端表格没有本页固定高度；15 行自然撑高并由路由 `el-scrollbar` 滚整页。当前列表卡以 stretch=1 填满余高，表格内部滚动；一行数据时会留下大块空白，15 行时筛选和工具栏固定在窗口而不是随页面滚动：
|
||||
|
||||
- 基准：`D:/web/zyt/admin/src/layout/default/components/main.vue:2-11`、`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:179-190`
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:642-674`
|
||||
|
||||
建议边界：诊单页使用单一 `QScrollArea` 承载两卡，表格按 header + 实际 rows + pagination 给自然高度；不要改其他页面的内部表滚动策略。
|
||||
|
||||
## 5. 诊单只读 / 编辑差异
|
||||
|
||||
### D-01 [阻断] 两种只读形态被合并为一个居中 Dialog
|
||||
|
||||
管理端有两个不可互换的只读形态：
|
||||
|
||||
1. `readonly.vue`：独立单列页面，无 Tabs，Hero 后按顺序纵向展示摘要、病例、日常记录、备注、订单、视频、聊天、指派、挂号。
|
||||
2. `edit.vue` 的 `viewOnly`：仍是 60% 右 Drawer + Tabs + disabled 表单，只隐藏保存。
|
||||
|
||||
证据：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:1-149`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1-84,766-781`
|
||||
- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:75-152,156-194`
|
||||
|
||||
当前所有查看/编辑都调用同一个 `DiagnosisDialog.open_for()`；只通过 `setReadOnly` 和保存按钮显隐切模式：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:245-288`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:426-464`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:1113-1129`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2142-2151`
|
||||
|
||||
建议边界：保留 `open_for()`、saved signal、现有 load bundle 和数据快照；仅拆视图为 `DiagnosisReadonlyView` 与 `DiagnosisDrawerView`，由入口决定呈现形态。不得通过给现有 QDialog 换皮来声称两种基线都已覆盖。
|
||||
|
||||
### D-02 [阻断] Drawer 几何与 Header/Body/Footer 三段壳缺失
|
||||
|
||||
编辑/viewOnly 基线为 RTL 右 Drawer、宽视口 60%、全高；header 为白到 `#F8FAFC` 渐变和底线，body `#F8FAFC`，footer 独立白底、上边线，按钮右对齐、40 px/r10：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:3-10`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1670-1745`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1776-1864`
|
||||
|
||||
当前是居中系统 `QDialog`，请求 880×680、最小 680×520，统一暖灰画布，四周 20/18；标题 25 px。按钮栏虽在 Tabs 外，能保持不随首 Tab 滚动，但没有 footer frame、边线和确定按钮顺序：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:245-288`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:44-46,54-58,87-104`
|
||||
|
||||
当前 mode 文案/颜色也不同：后台只读 info、编辑 warning、新建 success；当前只读 neutral、可编辑 success，且标题是“患者信息详情/编辑患者病历”：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:256-266,441-447`。
|
||||
|
||||
建议边界：在主窗之上实现遮罩 + 右贴边 panel，按外窗宽度计算 60%；只让 body 滚动，header/footer 固定。保留 QDialog 作为临时承载会继续出现系统标题栏和居中几何差异。
|
||||
|
||||
### D-03 [阻断] Tabs 样式、顺序、权限可见性和内容主链不等价
|
||||
|
||||
管理端顺序：病历、医生备注、日常记录、处方、业务订单、视频录制回放、聊天、指派、挂号；“跟踪备注”已注释，不渲染。Tabs 为可横滚文本导航，4 px scrollbar，active 3 px 底条：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:55-759`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1798-1858`
|
||||
|
||||
当前只有患者与病历、医生备注、挂号记录、指派记录、可选患者订单；挂号先于指派，日常记录/待办、处方、视频、聊天均缺失。除订单外，Tab 没按对应权限移除：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:271-279`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:479-525`
|
||||
|
||||
当前全局 Tab 是青绿填充 pill、r9、36 px，无 3 px active indicator：`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:208-220`。
|
||||
|
||||
建议边界：用诊单局部 `QTabBar + QStackedWidget` 或可横滚 TabBar；按既有 canonical permissions 移除入口，当前 Tab 失权时回病历。不要加入已注释 TrackingNote，也不要重复增加旧 Blood/Diet/Exercise Tabs。
|
||||
|
||||
### D-04 [阻断] 编辑表单被统一成单列大文本框，字段顺序也偏离真实模板
|
||||
|
||||
当前 `_DIAGNOSIS_FIELDS` 将全部字段装成单列 `QFormLayout + QPlainTextEdit`，每项 46–82 px；没有 160 px label、栅格、分组标题或语义控件：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:49-102`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:331-346`
|
||||
|
||||
管理端是 12 px 表单、160 px label、32 px input/select/date/number、radio/check-button、24/12/8 栅格、18 px 项间距，以及横线夹胶囊的分组标题：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:57-632`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1476-1667`
|
||||
|
||||
当前与后台真实模板的具体偏差：
|
||||
|
||||
- 缺少/不等价：诊单ID表单行、状态、渠道、统计端就诊卡、当地诊断日期、糖尿病病史、口腔感觉、其他补充、病史补充。
|
||||
- “当前用药”被放在末尾；后台“在用药物”位于生命体征区。
|
||||
- 当前显示后台模板未渲染的证型、糖尿病类型、自由文本主诉/现病史/症状、食欲、舌象、舌苔、脉象、临床诊断、治则、处方、处方意见、医嘱。
|
||||
- 类别项都变成自由文本，失去 radio/check/select 的密度和状态。
|
||||
|
||||
真实后台字段次序见 `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:221-255`。
|
||||
|
||||
患者基本信息锁定时，当前只设 read-only，没有后台 warning Alert：
|
||||
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:659-689`
|
||||
- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:71-84`
|
||||
|
||||
建议边界：只重建 `DiagnosisDialog` 的表单装配和 scoped QSS，保留字段值转换、校验、保存入口及隐私遮罩。严格按后台实际渲染字段，不把脚本模型中但模板未显示的字段继续呈现。
|
||||
|
||||
### D-05 [阻断] 独立 readonly 的 Hero、卡片流和病例网格完全缺失
|
||||
|
||||
readonly 基线：16 px 页面边距/卡间距；可换行浅蓝 Hero 带返回、患者名、性别年龄、未服务绿橙红 badge；白卡 r14、18 px padding、标题前 3×16 蓝条；患者摘要按确定顺序，病例按 4/3 列分组键值展示：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:1-149`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:257-405`
|
||||
- `D:/web/zyt/app/research/diagnosis_detail_visual_spec.md:75-152`
|
||||
|
||||
当前没有返回、Hero、未服务 badge 或纵向卡片流。摘要是两列九项，额外含身份证/血压/血糖，却缺地区、预约状态、是否开方和备注；病例仍是单列可编辑形态：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:290-349`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:574-700`
|
||||
|
||||
建议边界：单独实现只读卡片 view；不要把 disabled 编辑表单当作独立 readonly。1440 档保留后台 4/3 列；1024 档若主动降列，应在验收中标注为桌面可用性增强，而不是声称 Vue 原实现已有响应式。
|
||||
|
||||
### D-06 [高] 备注、订单、历史表和关联内容被降级或缺失
|
||||
|
||||
- 医生备注：后台是时间轴、64×64 缩略图、文件 chip、编辑动作；当前仅三列“时间/医生/内容”。基准 `D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:1-436`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:351-364`。
|
||||
- 日常记录/待办：后台有日期筛选、矩阵、趋势、toolbar 和待办；当前整个 Tab 缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1-1260`、`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DiagnosisTodoList.vue:1-319`。
|
||||
- 处方历史：后台七列并有编辑态开方入口；当前缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/CaseRecordList.vue:1-106`。
|
||||
- 业务订单：后台有就诊序号工具栏、九列、Tag/红金额、固定详情；当前八列为订单号/处方/收货人/手机/金额/发货/状态/创建，无工具栏和详情动作。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:393-424,764-787`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/PatientOrderList.vue:7-148,252-276`。
|
||||
- 指派历史：后台九列；当前六列且继承只是纯文本。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:378-390,748-762`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/AssignLogPanel.vue:1-43`。
|
||||
- 挂号历史：后台十二列和多个状态 Tag；当前七列。当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:370-390,731-746`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/AppointmentRecordPanel.vue:1-75`。
|
||||
- 视频与聊天：当前完全缺失。基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/components/CallRecordPanel.vue:1-214`、`D:/web/zyt/admin/src/views/tcm/diagnosis/components/ImChatRecordPanel.vue:1-293`。
|
||||
|
||||
当前所有表格最终都只创建纯文本 `QTableWidgetItem`：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:711-716`。
|
||||
|
||||
建议边界：按当前主视图可达组件增加局部 model/delegate；不把不可达旧组件或观看弹窗混入。缺失内容若尚无当前 repository 数据来源，应明确保持 OPEN，不能用静态假数据冒充视觉完成。
|
||||
|
||||
### D-07 [高] loading、empty、error、保存与隐私锁定状态不足
|
||||
|
||||
- 打开详情时只显示 MessageBanner，种子内容继续可见；没有 readonly 页面级 overlay/skeleton：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:452-464`。
|
||||
- 加载失败只改 Banner，后台独立 readonly 应在 Hero 下显示错误 Empty：当前 `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:570-573`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/readonly.vue:31-36`。
|
||||
- 清空表格只是 `setRowCount(0)`，没有“暂无…”状态：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:702-709`。
|
||||
- 订单翻页仍用全局 Banner，未遮住对应 Tab 内容：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:789-827`。
|
||||
- 保存只禁用按钮并显示 Banner，没有按钮 loading 动画或字段级 danger：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:829-917`。
|
||||
- 隐私/业务锁定只有只读控件，无 warning Alert，且 read-only 控件视觉仍像可编辑白框：`D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:659-689`、`D:/web/zyt/app/src/doctor_workstation/ui/theme.py:140-155`。
|
||||
|
||||
建议边界：为每个内容区域提供局部 overlay/empty/error；保留 seed-first、generation 和异常处理。错误样式不能改变业务成功/失败判定。
|
||||
|
||||
## 6. 预约差异
|
||||
|
||||
### A-01 [阻断] 预约 Drawer 被固定居中 Dialog 取代
|
||||
|
||||
基线为 RTL 右 Drawer、外窗 60% 宽、全高、遮罩点击不能关闭、独立 footer；表单 label 100 px：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:2-19,185-198`
|
||||
|
||||
当前是居中 540×560 模态 QDialog、20/18 内边距、系统标题栏、默认 QFormLayout label 宽；内容顶部还额外放 25 px 患者名和“患者号仅用于视频”说明：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:219-299`
|
||||
|
||||
建议边界：保留 `_AppointmentDialog` 的异步查询、状态字段、`payload()` 和 `accept()`；只把承载层替换为右贴边 panel，并将 Header/Body/Footer 分离。不要改 `PatientsPage._book_appointment()` 的业务调用：`D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2208-2224`。
|
||||
|
||||
### A-02 [阻断] 字段顺序和控件类型不等价
|
||||
|
||||
后台严格顺序是：上次就诊、预约方式、预约类型、当前患者、渠道、条件性自媒体补充、医生 radio、日期按钮、时段矩阵、备注：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:20-181`
|
||||
|
||||
当前缺上次就诊、预约方式和当前患者；预约类型是 ComboBox，医生/日期/号源也全是 ComboBox：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:247-285`
|
||||
|
||||
渠道基线宽 100%、最大 360 px；当前随 QFormLayout 拉伸，没有最大宽。`channel_source_detail` 创建后默认可见，初始化信号又被 `_setting` 拦截，因此首帧/默认渠道可能错误显示“渠道补充”；只有后续用户 change 才显隐：
|
||||
|
||||
- 当前：`D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:260-268,345-402,587-594`
|
||||
- 基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:62-75,741-750`
|
||||
|
||||
建议边界：按真实顺序重建表单控件；沿用当前字段与校验，不改变 payload key。条件控件在初始渲染时就必须正确隐藏。
|
||||
|
||||
### A-03 [阻断] 日期和时段的所有可见状态都被下拉框吞掉
|
||||
|
||||
后台医生为可换行 radio；日期按钮 min 130×40、r8、14 px，hover 上移 2 px并有阴影；时段容器为 `#F8F9FA`、16 px padding，网格 cell min 110×70，显式展示可约、不可约、hover、selected 和刷新 loading：
|
||||
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:77-171`
|
||||
- `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:752-921`
|
||||
|
||||
当前只将医生、日期、可用号源放进 ComboBox；`_apply_slots()` 直接过滤不可约、quota<=0 和当天过去时段，因此不可约卡、状态标签、slot hover、selected 渐变和刷新入口均无法呈现：
|
||||
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:269-280`
|
||||
- `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:534-574`
|
||||
|
||||
建议边界：以服务端原始 slot 列表驱动局部 Flow/Grid；业务上不可提交的时段保留为 disabled card。当前的未来日期限制、过期判定和 submit gate 保持不变。
|
||||
|
||||
### A-04 [高] loading、空态、重复预约、hover/focus 状态不足
|
||||
|
||||
- 后台未选医生/无排班在时间区显示 Empty；当前只是 ComboBox placeholder + Banner：基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:100-171`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:410-493`。
|
||||
- 后台 `v-loading` 覆盖预约 body；当前所有阶段复用表单下方 MessageBanner，没有区域 overlay：基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:10`；当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:286-299,439-448,521-532`。
|
||||
- 当天冲突基线在顶部持续显示 warning，切其他日期显示 info；当前只计算今日 blocking 并通过提交禁用/accept 文案表达，没有持续的 warning/info 双态：当前 `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:319-402,600-643`；基准 `D:/web/zyt/admin/src/views/tcm/diagnosis/appointment.vue:10-18,359-386`。
|
||||
- 后台 available hover、disabled opacity、selected 蓝渐变和 slot refresh loading 当前均不存在。
|
||||
- 当前 generic focus 仍是青绿 2 px 实边，radio/date/slot 的 focus-visible 不存在。
|
||||
|
||||
建议边界：增加预约 body overlay、时间区 empty、顶部冲突 alert、按钮/卡片 hover/pressed/focus；保留现有 `_today_blocking` 与 submit complete 判定。
|
||||
|
||||
### A-05 [高] 预约响应式和滚动安全不足
|
||||
|
||||
基线预约 Drawer 自身没有 <=768 media query，但内部医生、日期、slot 可换行，body 是 Drawer 可滚区域。当前固定 540×560 且无 `QScrollArea`；恢复完整 slot 网格后若继续用当前容器，1024×640 必然裁掉内容或 footer。
|
||||
|
||||
建议边界：桌面保持 60% 比例；当可用内容宽不足时再做全宽/单列增强，并明确这是 PySide 可用性增强。body 独立滚动，footer 永远留在可视区。
|
||||
|
||||
## 7. 两档窗口的确定性差异
|
||||
|
||||
### 1024×640
|
||||
|
||||
| 视图 | 管理端基线 | 当前源码请求 | 必须验收的风险 |
|
||||
|---|---|---|---|
|
||||
| 索引 | 页面内容可整体纵向滚；表宽约1403，右460固定 | 内容约760；高级筛选四行常驻；单表约1392且无固定列 | chip 计数裁字、表格高度仅剩少数行、动作不可见、空/loading移位 |
|
||||
| edit/viewOnly | 右贴边约614 px、全高、固定 footer | 居中880×680，最小680×520 | 请求高度已超过640；系统窗口可能裁剪/强制缩放，footer不可作为稳定截图基线 |
|
||||
| appointment | 右贴边约614 px、全高 | 居中540×560 | 宽度偏小且大量留白；恢复slot后无滚动会裁内容 |
|
||||
| standalone readonly | 页面流、16px边距、无Tabs | 880px模态Tabs | 模式、层级和宽度均不可比较 |
|
||||
|
||||
### 1440×900
|
||||
|
||||
| 视图 | 管理端基线 | 当前 | 必须验收的风险 |
|
||||
|---|---|---|---|
|
||||
| 索引 | 内容宽约1240；仍可能横滚，右460固定 | 内容约1176；横滚约248px且无固定列 | 视频/操作随滚动消失；少量数据时列表卡被拉出大空白 |
|
||||
| edit/viewOnly | 右贴边约864 px | 居中880×680 | 宽度偶然接近，但方向、全高、三段壳仍错误 |
|
||||
| appointment | 右贴边约864 px | 居中540×560 | 明显过窄，无法呈现日期/slot网格密度 |
|
||||
| standalone readonly | 宽页面流，病例4/3列 | 固定880px单列表单 | 信息密度和卡片层级完全不同 |
|
||||
|
||||
注：Element Drawer 的 60% 按外窗 viewport 计算，因此上表为约 614/864 px；不按 Python 扣除侧栏后的 workspace 计算。
|
||||
|
||||
## 8. 建议改动边界（按文件 / 类）
|
||||
|
||||
| 目标 | 允许的视觉改造 | 必须保持不动 |
|
||||
|---|---|---|
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/theme.py:13-275` | 新增诊单局部 token、scoped QSS、checked/focus/read-only/overlay/delegate 状态 | 不全局换肤其他页面；不改变业务状态含义 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/widgets.py:331-627` | 新增 FlowLayout、DiagnosisPaginationBar、局部 loading/empty、专用 model/delegate/固定表辅助 | 不破坏现有 PageHeader、EmptyState、SortableTable、Pager 的调用方 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/shell.py:306-423` | 仅当全壳明确纳入验收时调整；可提供 drawer host/overlay host | 不以改壳宽度掩盖诊单页布局问题 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:464-674` | 重建索引层级、筛选、工具栏、表格绑定、页面滚动 | 保留 repository 调用、过滤语义、权限判断、generation、mutation、视频门槛 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/pages/consultations.py:901-956` | 将普通 loading/error 映射到 table-only overlay/状态层 | 20秒 silent refresh 继续不闪；不改请求时序 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:208-424` | 拆 readonly/drawer 视图，重建 header/tabs/form/cards/tables | 保留 `open_for` 契约、saved signal、隐私可见性和已有数据加载 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/dialogs/diagnosis.py:426-917` | 把加载/错误/锁定/保存映射到局部视觉状态 | 不改 endpoint、payload、字段校验、generation、防过期响应 |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:219-646` | 把预约改成 Drawer、radio/date/slot grid、overlay/empty/alert | 保留排班来源、日期/过期过滤、冲突门槛、submit gate、`payload()` |
|
||||
| `D:/web/zyt/app/src/doctor_workstation/ui/pages/patients.py:2208-2224` | 仅替换打开的视觉容器 | 不改预约保存调用与 mutation reconcile |
|
||||
|
||||
推荐实施顺序：
|
||||
|
||||
1. 建 scoped token 与 drawer/table 基础组件。
|
||||
2. 重建 index 层级、筛选、固定列和 states。
|
||||
3. 拆 readonly 与 edit/viewOnly，先完成壳和病历主 Tab。
|
||||
4. 补当前可达的 notes/orders/histories；数据源不存在的主链保持显式 OPEN。
|
||||
5. 重建 appointment 卡片式选择器。
|
||||
6. 最后做两档截图的字号、间距和颜色微调。
|
||||
|
||||
## 9. 截图验收前置条件
|
||||
|
||||
所有截图固定：Windows 缩放 100%、默认亮色、同一 Qt 字体回退、同一权限集合、相同样本数据、无本地主题覆盖。运行态字体/DPR、tooltip/dropdown 坐标和 scrollbar 像素应记录环境，不应以静态源码推断绝对像素。
|
||||
|
||||
索引样本至少包含：`NEW`、双预约、已完成预约、爽约、未确认、已确认未挂号、处方作废、unserved=`null/2/5/8`、可进入/不可进入视频。
|
||||
|
||||
详情样本至少包含：患者基本信息可编辑/锁定、全部权限/裁减权限、备注含图片和文件、订单有/无数据、挂号/指派有/无数据、加载失败。
|
||||
|
||||
预约样本至少包含：未选医生、无排班、可约、不可约、当天过去时段、选中、今日冲突、其他日期 info、渠道需要/不需要补充、loading/error。
|
||||
|
||||
## 10. 截图验收矩阵
|
||||
|
||||
| ID | 窗口 | 状态 / 操作 | 必须同时看见 | 关键判定 |
|
||||
|---|---|---|---|---|
|
||||
| IDX-01 | 1024×640 | 默认15条、筛选收起、横滚最左 | 无页面内标题；两张平卡；两行筛选；表头、分页 | chips 不裁字；搜索完整；默认当天 active；至少能正常纵向滚整页 |
|
||||
| IDX-02 | 1024×640 | 横滚到最右 | 左表发生横滚；视频120+操作340仍贴右 | 固定区不移动；双表 header/body/row height 无错位 |
|
||||
| IDX-03 | 1024×640 | 更多筛选展开 | 虚线分隔、高级控件可换行、表格仍可达 | 显隐无动画；24/32px混合高度按源码；页面整体可滚 |
|
||||
| IDX-04 | 1024×640 | 四类 chip active + 键盘 focus | 当天/待预约/已完成/待分配各自语义色 | 计数为同行文字；focus清晰且无几何跳动 |
|
||||
| IDX-05 | 1024×640 | 普通、未确认、未挂号 hover | 斑马、#F8F8F8 hover、3px语义条/渐变 | fixed区背景连续；hover不被 selection 色覆盖 |
|
||||
| IDX-06 | 1024×640 | 慢请求 loading | 原表尺寸保持、table-only 半透明层、42px spinner | 筛选/卡位置不跳；无全宽 banner 插入 |
|
||||
| IDX-07 | 1024×640 | 空结果 | 表头、60px“暂无数据”、分页 | 无大圆圈插画；pager不消失 |
|
||||
| IDX-08 | 1440×900 | 默认15条 | 完整两卡、自然表高、完整分页 | 少量数据不拉出大空白；15条由整页滚动承载 |
|
||||
| IDX-09 | 1440×900 | 多预约 + 操作换行 | 预约 badge/渐变/虚线、340px操作链接 | 行高由内容增长；左右固定表同步 |
|
||||
| IDX-10 | 两档 | tooltip / 更多菜单 | 助理溢出、未服务、视频 tooltip；bottom-end菜单 | tooltip只在语义命中区；删除前分隔且danger |
|
||||
| DET-01 | 1024×640 | edit 基本 Tab | 右侧约614px全高 Drawer、header、横滚Tabs、固定footer | body单独滚；footer不裁；label160px；无系统标题栏 |
|
||||
| DET-02 | 1024×640 | viewOnly + 患者锁定 | info badge、disabled表单、warning Alert、关闭按钮 | 无保存；read-only外观不似可编辑；隐私字段无泄漏 |
|
||||
| DET-03 | 1440×900 | edit 全权限 | 右侧约864px、Tab正确顺序、24/12/8栅格 | 无TrackingNote；active底条3px；表单字段顺序与§4.5一致 |
|
||||
| DET-04 | 两档 | 独立 readonly | 无Tabs/模态；返回+Hero+摘要+病例+权限卡片 | 1024可用；1440病例保持4/3列；未服务三色正确 |
|
||||
| DET-05 | 两档 | 详情 loading/error/empty | overlay；Hero下错误Empty；各表局部空态 | 不残留错误seed；error不导致footer/tab位移 |
|
||||
| DET-06 | 1440×900 | 备注/订单/指派/挂号 | 时间轴图片/文件；订单工具栏/详情；完整列/Tag | 表头顺序、状态色、固定动作列与管理端一致 |
|
||||
| APT-01 | 1024×640 | 初始 loading / 未选医生 | 右侧约614px Drawer、body overlay、时间区Empty、固定footer | label100px；footer可见；渠道补充默认正确隐藏 |
|
||||
| APT-02 | 1024×640 | 无排班 | 医生radio、时间区“暂无排班”Empty | 不用ComboBox placeholder冒充空态 |
|
||||
| APT-03 | 1024×640 | 可约/不可约/hover/selected | 日期130×40；slot最小110×70；刷新 | 不可约仍显示但禁用；hover抬升；selected蓝渐变 |
|
||||
| APT-04 | 两档 | 今日冲突 / 其他日期重复 | 顶部warning切info、确认disabled/available | 状态随所选日期切换；不只在点击提交后提示 |
|
||||
| APT-05 | 1440×900 | 完整预约表单 | 右侧约864px、医生和日期自然换行、slot多列 | 不保持540px窄窗；body滚动，footer固定 |
|
||||
| A11Y-01 | 两档 | 仅键盘遍历 | chip/input/select/radio/checkbox/table/button均有focus | 顺序可预测；focus对比足够；无控件尺寸抖动 |
|
||||
|
||||
## 11. 发布门槛
|
||||
|
||||
以下任一项仍存在即不能标记视觉对齐完成：
|
||||
|
||||
- 索引页仍有第二个页面标题，或高级筛选默认常驻。
|
||||
- 表格仍是单个纯文本 `QTableWidget`，右侧 460 px 不固定。
|
||||
- 空态仍替换掉表头/分页，或普通加载仍插入全宽 Banner。
|
||||
- 只读与 viewOnly 仍复用同一个居中 Tabs Dialog。
|
||||
- 编辑/预约仍不是 60% 右贴边、全高、固定 footer 的 Drawer。
|
||||
- 病历仍由一串同形态 `QPlainTextEdit` 组成。
|
||||
- 医生、日期和时段仍以 ComboBox 代替 radio/button/grid。
|
||||
- 1024×640 下任何 footer、搜索、chip 或表格固定区被裁剪。
|
||||
- 1440×900 下预约仍固定 540 px，或详情仍只有固定 880 px 居中模态形态。
|
||||
- hover/focus/loading/empty/error/disabled/selected 任一规定状态没有独立截图证据。
|
||||
|
||||
本报告只定义视觉和交互呈现的修复边界。所有 repository、endpoint、payload、权限 code、状态门槛和 mutation reconcile 均应原样保留，并在实现后另走现有业务回归测试。
|
||||
@@ -0,0 +1,164 @@
|
||||
# 诊单发布后端合同独立终验
|
||||
|
||||
- 终验日期：2026-08-11
|
||||
- 审计对象：`D:/web/zyt/app` 当前工作区终态
|
||||
- 对照基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/`、其直接引用的 API，以及 `D:/web/zyt/server` 当前服务端控制器/Logic
|
||||
- 审计性质：只读业务与后端合同终验；未访问网络、未安装依赖、未调用线上接口；除本报告和 pytest 临时产物外，未修改业务源码或测试
|
||||
|
||||
## 发布结论
|
||||
|
||||
**PASS（限本报告题定范围）。**
|
||||
|
||||
| 等级 | OPEN 数 | 结论 |
|
||||
|---|---:|---|
|
||||
| P0 | **0** | 未发现错误对象写入、越权入口、错误 endpoint、旧异步回调落地或主数据破坏风险 |
|
||||
| P1 | **0** | 题定的所有主流程均已形成真实后端闭环 |
|
||||
| P2 | **0** | 前两轮发现的 Daily 既有记录不可编辑、视频只显示首条 URL/不能逐通话追加等合同缺口均已关闭 |
|
||||
|
||||
**AVAILABLE 后端功能是否全部对齐：是。** 在“admin 诊单页面及其直接组件/API 中、本报告明确列出的可用后端功能”这一范围内，桌面端已经全部对齐：列表查询与分页、权限和菜单、多挂号精确取消、订单创建与付款二维码、三种详情模式、Daily 新增/编辑、真实 Notes 追加与附件、处方/业务订单、视频、归档 IM，以及 Shell owner/异步代次保护均为真实调用，无伪造成功动作。
|
||||
|
||||
这里的 AVAILABLE 不扩张为对 `admin` 全仓所有未枚举页面和无关路由的声明。本报告也不把后端从未提供的功能算成桌面端缺口：**任意旧笔记正文覆盖、删除整条医生笔记，以及旧跟踪备注改写/整条删除，在当前 server 快照中没有 endpoint，属于后端合同限制，不计入 P0/P1/P2。**
|
||||
|
||||
## 合同终验矩阵
|
||||
|
||||
| 题定能力 | 状态 | admin / 后端合同 | 桌面端终态 |
|
||||
|---|---|---|---|
|
||||
| 诊单列表筛选、分页、权限、菜单 | **CLOSED** | `tcm.diagnosis/lists`；canonical 权限；服务端动态菜单 | 筛选字段、待分配宽搜、分页总数/末页回退、统计计数请求、菜单裁剪均对齐 |
|
||||
| 多挂号精确取消 | **CLOSED** | `POST doctor.appointment/cancel {id}` | 每张挂号卡携带精确 appointment id，确认前后重验同一诊单和可取消状态 |
|
||||
| 创建订单后生成付款二维码 | **CLOSED** | `order.order/create` → `order_no` → `tcm.diagnosis/generateOrderQrcode` | 已消费真实 `order_no`，即时请求 QR；缺 order_no / qrcode_url 时 fail-closed，可重试且有 selection/generation 防串单 |
|
||||
| edit / viewOnly / readonly | **CLOSED** | edit、viewOnly 用 `detail`；独立 readonly 用 `readonlyDetail`；保存用 `edit` | mode dispatcher 与 admin 一致，viewOnly 不误打 readonly endpoint |
|
||||
| Daily 新增与既有血糖/饮食/运动编辑 | **CLOSED** | 三类 `add` / `edit` endpoint | 已有单元格解析 record id 并走 update；新增走 add；权限、DTO、owner/generation 校验完整 |
|
||||
| Notes 真实新增与附件 | **CLOSED（AVAILABLE）** | `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage` | 正文真实追加；舌象/报告先上传得到服务端 URI 再新增；单附件真实删除 |
|
||||
| 处方与业务订单 | **CLOSED** | `tcm.prescription/add`、`listByDiagnosis`、`tcm.prescriptionOrder/lists` / `detail` 等 | 真实开方、历史处方查看、诊单上下文订单列表/详情与诊次偏移均接通 |
|
||||
| 视频全量回放与逐通话上传 | **CLOSED** | `getCallRecords`、`createManualCallRecord`、`attachLocalCallRecording` | 完整消费 `recording_urls_list`；工具栏上传可建手工记录；行内上传传精确 `call_record_id` |
|
||||
| IM 归档读取与同步 | **CLOSED** | `only_archived=1`、`triggerImChatSync` | 首次及重载均固定归档读取；真实触发同步并按 media generation 刷新 |
|
||||
| owner resize / generation | **CLOSED** | UI 生命周期合同 | 每次打开重绑真实 Shell；overlay 同步 Move/Resize/Show/Close；宽屏 60%、窄屏全宽；关闭使全部异步代次失效 |
|
||||
|
||||
## 逐项证据
|
||||
|
||||
### 1. 诊单列表：筛选、分页、权限与菜单
|
||||
|
||||
- admin 的筛选模型及待分配宽搜在 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:773-917`；待分配有关键词时只保留分页、`pending_assign=1` 和 `pending_assign_keyword`，没有关键词时带月份。
|
||||
- 桌面端 `src/doctor_workstation/ui/pages/consultations.py:1566-1602` 发送 canonical 字段：`keyword`、`has_appointment`、`diagnosis_confirmed`、`diagnosis_type`、`syndrome_type`、`assistant_id`、最新挂号日期/渠道、最新分配日期、`appointment_date`、`pending_booking`、`completed_appointment`、`pending_assign`、`sort_unserved_days`。待分配宽搜规则与 admin 一致。
|
||||
- `consultations.py:1604-1653` 把 `page/page_size` 传入 repository，消费真实 `total`，超末页时回退并重查；每页仅接受 15/20/30/40。`:1672-1741` 的日期/待挂号/已完成/待分配计数沿用同一筛选语义。
|
||||
- production repository 在 `src/doctor_workstation/services/repository.py:1562-1589` 调用 `GET tcm.diagnosis/lists`，不丢弃当前 canonical 查询字段。
|
||||
- `src/doctor_workstation/ui/shell.py:46-254` 将 `tcm.diagnosis/lists` 作为诊单导航权限，识别 `tcm/diagnosis` 与 `tcm/diagnosis/index`；生产菜单以服务端 visible/enabled/sort/children 为事实源，同时还必须通过精确 slash 权限。空生产菜单不会静默回退出诊单入口，demo 才允许本地回退。
|
||||
- 页面动作同样使用 exact slash 权限并同时检查 repository capability；没有把 dot 形式或相似字符串当成授权。
|
||||
|
||||
结论：查询 DTO、统计 DTO、分页和动态菜单/动作门禁均与 admin 的实际合同对齐。
|
||||
|
||||
### 2. 多挂号精确 `doctor.appointment/cancel`
|
||||
|
||||
- admin 从 `D:/web/zyt/admin/src/api/doctor.ts:60` 调用 `/doctor.appointment/cancel`，诊单列表在 `index.vue:1820`、`:1847` 传具体挂号 `id`。
|
||||
- 桌面端按嵌套挂号数组生成多个操作；歧义的行级“取消挂号”仅在唯一可取消挂号时成立。`consultations.py:2040-2107` 会：
|
||||
1. 按传入的精确 appointment id 查找状态可取消的挂号；
|
||||
2. 绑定当前 diagnosis；
|
||||
3. 用户确认后再次从当前模型按同一 id 重验；
|
||||
4. 最终只把该 id 传给 diagnosis 专用取消方法。
|
||||
- `repository.py:1550-1555` 明确调用 `POST doctor.appointment/cancel {"id": appointment_id}`，没有误走患者工作区的 `firstvisit.myPatient/cancelAppointment`。
|
||||
|
||||
结论：同一诊单有多条挂号时不会取消错行，超 32 位 Python 整数也不会因 UI 转换而截断；本项 CLOSED。
|
||||
|
||||
### 3. 创建订单 → `order_no` → `generateOrderQrcode`
|
||||
|
||||
- admin 的完整链在 `D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:1478-1499`：`orderCreate` 成功后读取 `res.order_no`，随后请求 `generateOrderQrcode({order_no})`。
|
||||
- 桌面端 `consultations.py:2279-2329` 只有在 `tcm.diagnosis/order` 权限以及 create/QR 两个 capability 都存在时开放入口。
|
||||
- `:2331-2479` 已完整串联结果：读取顶层或 `data.order_no`，创建 QR 对话框并立即请求真实 QR；缺少 `order_no` 不会伪造二维码，缺少 `qrcode_url` 显示失败；retry、当前 diagnosis/patient、权限与独立 order generation 均受保护。
|
||||
- `repository.py:2035-2076` 精确调用 `order.order/create`，返回 mapping；再调用 `tcm.diagnosis/generateOrderQrcode {"order_no": ...}`，并强制要求非空 `qrcode_url`。
|
||||
|
||||
结论：此前“订单已创建但付款 QR 闭环中断”的 P1 已关闭。
|
||||
|
||||
### 4. edit、viewOnly、readonly endpoint 分流
|
||||
|
||||
- admin edit 与 viewOnly 共用 `tcmDiagnosisDetail`：`D:/web/zyt/admin/src/views/tcm/diagnosis/edit.vue:1263-1322`；保存调用 `tcmDiagnosisEdit`（`:1367`）。独立 readonly 页调用 `diagnosisReadonlyDetail`：`readonly.vue:155`、`:231`。
|
||||
- API 定义分别是 `GET /tcm.diagnosis/detail`、`POST /tcm.diagnosis/edit`、`GET /tcm.diagnosis/readonlyDetail`：`D:/web/zyt/admin/src/api/tcm.ts:9-11`、`:50-52`、`:60-62`。
|
||||
- 桌面端 mode resolver 在 `src/doctor_workstation/ui/dialogs/diagnosis.py:1427-1544`：edit 与 viewOnly 均调用普通 detail；仅独立 readonly 调用 readonlyDetail。`repository.py:1591-1626` 实现同一分流和 edit 保存。
|
||||
|
||||
结论：viewOnly 不再误用权限感知 readonly endpoint；三种模式 CLOSED。
|
||||
|
||||
### 5. Daily：新增及既有血糖/饮食/运动编辑
|
||||
|
||||
- admin `DailyMatrix.vue:586-648` 按日期聚合记录并保留可编辑 id，`:921-1013` 点击已有单元格时载入记录，提交时按 id 在 add/edit 之间分流。
|
||||
- admin API 的现存合同为：
|
||||
- `tcm.bloodRecord/add` / `edit`：`D:/web/zyt/admin/src/api/tcm.ts:114-120`；
|
||||
- `tcm.dietRecord/add` / `edit`：`:146-152`；
|
||||
- `tcm.exerciseRecord/add` / `edit`：`:173-179`。
|
||||
- 桌面端 Daily matrix 已按同样规则合并同日血糖字段，并给已有血糖、饮食、运动单元格保留 record id；`diagnosis.py:2234-2338` 分别打开新增/编辑器，并按 id 调用 add 或 update。
|
||||
- production repository 在 `repository.py:1758-1818` 精确实现上述六个 endpoint；编辑器保留饮食/运动既有图片，mutation 完成只在 diagnosis/patient 和 daily generation 仍匹配时刷新。
|
||||
|
||||
结论：此前“只能新增、不能编辑已有三类记录”的 P2 已关闭。跟踪备注仍按后端设计只允许当天追加，见后端限制章节。
|
||||
|
||||
### 6. Notes：真实新增、上传与单附件删除
|
||||
|
||||
- admin `D:/web/zyt/admin/src/api/patient.ts:20-40` 只有三条医生笔记 API：`addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`。
|
||||
- 桌面端 `diagnosis.py:2424-2511` 的正文新增真实调用 `add_doctor_note`；舌象/报告先调用 multipart `upload_material`，取得服务端 URI 后再把 URI 交给新增接口；单附件删除携带 note id、附件类别和服务器路径。
|
||||
- production repository 在 `repository.py:906-985` 实现上传以及 `doctor.appointment/addDoctorNote`、`doctor.appointment/doctorNotes`、`doctor.appointment/deleteDoctorNoteImage`，并拒绝把本地路径当成已上传附件提交。
|
||||
- 所有按钮同时受 exact permission 和 capability 裁剪，viewOnly/readonly 不出现可写入口。
|
||||
|
||||
结论：当前后端实际 AVAILABLE 的 Notes 能力全部对齐；没有用本地假数据或“只 toast 不落库”模拟新增/附件操作。
|
||||
|
||||
### 7. 处方与诊单上下文订单
|
||||
|
||||
- 详情页处方 Tab 会查询 `tcm.prescription/listByDiagnosis`，编辑态“开方”打开真实处方编辑器并调用 `tcm.prescription/add`；历史处方查看使用该真实列表返回的处方数据打开详情对话框。
|
||||
- 订单 Tab 使用 `tcm.prescriptionOrder/lists` 并带诊单上下文，详情调用 `tcm.prescriptionOrder/detail`；诊次统计偏移调用真实 `setRevisitSlotStartOffset`。
|
||||
- production endpoint 证据：`repository.py:1131-1149`、`:1220-1265`、`:1633-1645`；UI 调度与 capability 门禁在 `diagnosis.py:2048-2058`、`:2534-2689`、`:2791-3186`。
|
||||
|
||||
结论：题定的处方创建/查看及业务订单列表/详情/偏移均为真实后端行为，未发现伪动作或无权限仍可提交。
|
||||
|
||||
### 8. 视频：全量 `recording_urls_list` 与逐 `call_record_id` 上传
|
||||
|
||||
- admin `CallRecordPanel.vue:32` 把完整 `row.recording_urls_list` 传给播放组件；`:150-177` 支持“上传后新建手工通话记录再绑定”，也支持向指定现有记录追加。
|
||||
- 桌面端 `diagnosis.py:2899-2967` 会归一化并去重 direct URL 与完整 `recording_urls_list`，逐一提供播放入口，不再只取数组第一个元素。每个有正 id 的行提供“追加回放”，闭包携带该行精确 `call_record_id`。
|
||||
- `diagnosis.py:2587-2613` 将可选精确 id 交给 repository。`repository.py:1875-1943` 的顺序与 admin 一致：先上传；无 id 时创建 manual call record；最后调用 `attachLocalCallRecording`。已有 id 时不创建新记录，直接绑定该 id。
|
||||
|
||||
结论：此前“只展示首条 URL、不能逐通话记录追加”的两个 P2 缺口均已关闭。
|
||||
|
||||
### 9. IM：`only_archived` 与 sync
|
||||
|
||||
- admin `ImChatRecordPanel.vue:148-185` 固定 `only_archived: 1` 并调用 `triggerImChatSync`。
|
||||
- 桌面端 lazy query 在 `diagnosis.py:2084-2097` 固定 `only_archived=True`，同步动作在 `:2615-2627` 调用真实 repository，并在当前 media generation 仍有效时重载。
|
||||
- `repository.py:1945-1965` 精确发送 `GET tcm.diagnosis/getImChatMessages {diagnosis_id, only_archived: 1}` 与 `POST tcm.diagnosis/triggerImChatSync`。
|
||||
|
||||
结论：未混入 live merge 默认值，归档读取和同步闭环 CLOSED。
|
||||
|
||||
### 10. Shell owner、resize 与 generation
|
||||
|
||||
- `diagnosis.py:1325-1413` 每次打开/显示都从当前 `parentWidget().window()` 重绑真实 owner；overlay 采用 owner 的全局原点与完整尺寸，drawer 在宽屏取 owner 60%，窄屏取全宽，并响应 owner Move/Resize/Show/Close。
|
||||
- `diagnosis.py:1731-1760` 在 reject/done/owner close 时统一递增 detail、save、orders、order detail、daily、notes、media、offset 及所有 lazy-tab generation，并关闭相关子对话框/播放器。
|
||||
|
||||
结论：移动或缩放真实 Shell 后几何会立即同步；关闭后旧请求结果不能回写到下一次打开的诊单。
|
||||
|
||||
## 后端合同限制：旧笔记不能任意覆盖或整条删除
|
||||
|
||||
本项进行了 admin API、controller、Logic 和 `D:/web/zyt/server` 全仓关键词交叉检索，当前 server 快照的结论明确：
|
||||
|
||||
1. `D:/web/zyt/server/app/adminapi/controller/doctor/AppointmentController.php:168-198` 仅公开 `addDoctorNote`、`doctorNotes`、`deleteDoctorNoteImage`，随后该 controller 结束；不存在医生笔记正文 edit/update 或整条 delete action。
|
||||
2. `D:/web/zyt/server/app/adminapi/logic/doctor/DoctorNoteLogic.php:14-76` 的 `addOrAppend` 按 `diagnosis_id + 当天` find-or-create，并把新正文追加到当日内容，不允许任意覆盖历史正文。
|
||||
3. 同一 Logic 的唯一删除逻辑 `deleteImage`（`:114-136`）只从 `tongue_images` 或 `report_files` 数组中删除一个附件，不删除笔记行。
|
||||
4. admin API `D:/web/zyt/admin/src/api/patient.ts:20-40` 也只有上述三条接口，没有被桌面端漏接的隐藏 edit/delete API。
|
||||
5. 跟踪备注同样只有 `addTrackingNote` 与 `trackingNotes` controller action（`DiagnosisController.php:183-214`）；`TrackingNoteLogic.php:23-95` 只有按当天追加和按诊单读取，没有历史正文覆盖或整条删除。
|
||||
|
||||
因此：
|
||||
|
||||
- “任意覆盖既有医生/跟踪笔记正文”与“删除整条笔记”是**后端合同限制**，不是客户端 P0/P1/P2。
|
||||
- 当前桌面端不展示无法兑现的按钮是正确的 fail-closed 行为。
|
||||
- 若产品必须新增这些能力，应先在 server 增加独立 authenticated endpoint、权限码、归属校验、审计记录、并发/版本策略和删除语义；在此之前不应由客户端通过追加接口模拟覆盖或删除。
|
||||
|
||||
## 离线验证
|
||||
|
||||
在当前 `.venv` 下使用 `QT_QPA_PLATFORM=offscreen`、`PYTHONDONTWRITEBYTECODE=1`，禁用 pytest cache，并把 basetemp 放到 `artifacts/pytest_release_contract_audit/`；未使用网络：
|
||||
|
||||
```text
|
||||
python -m pytest -q -p no:cacheprovider --basetemp artifacts/pytest_release_contract_audit tests/test_diagnosis_detail_contract.py tests/test_consultations_parity_ui.py tests/test_diagnosis_drawer_visual.py tests/test_diagnosis_index_visual.py tests/test_shell_contract.py tests/test_repository_parity.py tests/test_permissions.py
|
||||
|
||||
118 passed
|
||||
```
|
||||
|
||||
退出码为 0。该结果覆盖 endpoint/DTO、权限裁剪、多挂号精确取消、订单 QR 串联、三种详情模式、Daily edit、Notes、视频多 URL/逐 call id、IM 和 owner/generation 的定向回归。测试通过是回归信号；最终 AVAILABLE 判定同时依赖上面的 admin/API/server 静态合同核对，不以 mock 测试单独代替生产合同证据。
|
||||
|
||||
## 发布门槛判断
|
||||
|
||||
- **业务/后端合同门槛：通过。**
|
||||
- **OPEN：P0 0 / P1 0 / P2 0。**
|
||||
- **AVAILABLE：题定范围内全部对齐。**
|
||||
- **唯一保留项：旧医生/跟踪笔记正文覆盖与整条删除需先扩展后端合同；这是明确的 server limitation，不阻断“当前 AVAILABLE 功能”发布。**
|
||||
@@ -0,0 +1,173 @@
|
||||
# Diagnosis 发布视觉终验
|
||||
|
||||
审计日期：2026-08-11
|
||||
审计性质：独立只读终验；除新增本报告外，未修改业务源码、测试、renderer 或 PNG。
|
||||
基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/` 及其当前主链直接依赖组件。
|
||||
当前实现：PySide6 + scoped QSS + QPainter，主要位于 `src/doctor_workstation/ui/`。
|
||||
Trellis：`D:/web/zyt/app/.trellis` 当前不存在（`Test-Path` 为 `False`），因此无可补读的 Trellis workflow/spec。
|
||||
|
||||
## 最终结论
|
||||
|
||||
**PARTIAL，不是 PASS。**
|
||||
|
||||
- 检查了 `artifacts/diagnosis_visual/` 当前全部 **49 张 PNG**，均以原始尺寸逐张目检；尺寸分布为：`1024x640` 22 张、`1280x800` 11 张、`1440x900` 12 张、`640x540` / `650x620` / `820x560` / `920x780` 各 1 张。
|
||||
- PNG 判定：**40 PASS / 9 PARTIAL / 0 不可读 / 0 硬裁切**。
|
||||
- **P0：0 OPEN。** 诊单列表、右固定 460 px 区、付款二维码、edit/viewOnly 的 60% Drawer、独立 readonly、预约 Drawer、固定 footer、loading/error/empty/focus/permission 状态及 Shell 183/50/40 均未发现发布阻断。
|
||||
- 上一轮明确 OPEN 中，Daily 动作行裁切与按钮语义、完整更多菜单的图标/danger/“二维码”文案已经闭合；视频的多回放、逐条追加与应用内播放器能力也已经存在。
|
||||
- 仍不能给 PASS 的原因是 4 组 P1 同型差异：Notes 不渲染真实缩略图；处方编辑器仍是另一种 tabbed modal；订单详情仍是精简 640x540 表单而非共享 80% Drawer；视频仍从表格跳到独立播放器且聊天图片仍降级为文字链接。另有 2 组 P2 文案/局部工具栏差异。
|
||||
|
||||
严重度口径：P0 = 核心流程不可见/不可操作或窗口级裁切；P1 = 本次明确要求的主链组件结构、信息层级或媒体形态未与基准同型；P2 = 功能成立但文案、局部按钮或说明层级未精确对齐。
|
||||
|
||||
## 此前 OPEN 复核
|
||||
|
||||
| 项目 | 当前状态 | 精确证据 |
|
||||
|---|---|---|
|
||||
| Daily 裁切 | **CLOSED** | `diagnosis_state_daily_1024x640.png` 中“刷新”已换到下一行且完整可见；当前用 `FlowLayout`：`src/doctor_workstation/ui/diagnosis_drawer.py:1607-1609`，基准允许换行：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/DailyMatrix.vue:1094-1109`。 |
|
||||
| Daily 按钮语义 | **CLOSED（主问题）** | `+血糖` 为 primary，`+饮食/+运动/+备注` 为 secondary，范围 checked 态可见，`新增待办` 为 primary；实现：`diagnosis_drawer.py:1613-1659,1691-1702`；基准：`DailyMatrix.vue:25-35`、`DiagnosisTodoList.vue:3-19`。仍有下述 P2 文案/局部刷新差异。 |
|
||||
| 完整更多菜单 | **CLOSED** | `diagnosis_full_menu_1280x800.png` 显示 8 项、每项图标、删除分隔线与 danger 红、精确“二维码”。QPainter 图标与 danger 绘制：`src/doctor_workstation/ui/diagnosis_index_widgets.py:74-175`；动作与文案：`:1478-1556`；基准：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:379-400`。 |
|
||||
| Notes 动作与附件 | **PARTIAL** | 新增/追加、舌象/报告上传、打开与单附件删除均已出现；但舌象始终是 64x64 的“舌象/查看”文字按钮（`diagnosis_drawer.py:2153-2183`），没有像基准那样用真实 URL 渲染 `el-image` 缩略图（`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69,370-379`）。 |
|
||||
| 处方入口 | **CLOSED** | `diagnosis_state_empty_1024x640.png` 中按钮已经是 primary “开方”；实现：`src/doctor_workstation/ui/dialogs/diagnosis.py:1012-1031`；基准：`CaseRecordList.vue:1-38`。编辑器结构仍有 P1，见下节。 |
|
||||
| 订单列表/偏移/详情 | **PARTIAL** | 列表、金额色、状态 tag、分页、详情入口均存在（`diagnosis.py:1056-1099,2980-3010`），并补了详情 PNG；但详情结构仍非基准共享 Drawer，偏移文案也未精确。 |
|
||||
| 视频多回放 | **CLOSED（能力）/ PARTIAL（同型）** | `diagnosis_state_video_replay_1024x640.png` 同一记录显示主回放 + 2 个备用回放；实现去重并逐条建链接：`diagnosis.py:2899-2952`。 |
|
||||
| 视频逐条上传 | **CLOSED** | `diagnosis_state_video_upload_action_1024x640.png` 显示行级“追加回放”；绑定精确 `call_record_id`：`diagnosis.py:2953-2967`，上传调用：`:2587-2613`。 |
|
||||
| 视频播放器 | **CLOSED（能力）/ PARTIAL（同型）** | `diagnosis_state_video_player_820x560.png` 显示应用内播放面、播放/进度/时间/安全外开；实现：`src/doctor_workstation/ui/diagnosis_media.py:38-172`。但基准播放器内嵌在表格单元格且最大高 180 px：`RecordingPlaybackBlock.vue:1-30`、`RecordingVideoPlayer.vue:1-38,320-329`。 |
|
||||
| Chat info/归档 | **CLOSED（主体）/ PARTIAL（图片）** | `diagnosis_state_chat_archive_1024x640.png` 已有完整 info、only_archived、同步/重载与左右气泡；实现：`diagnosis_drawer.py:2235-2360`。图片消息仍只创建“查看图片”链接（`:2329-2348`），基准直接渲染图片缩略图（`ImChatRecordPanel.vue:39-50,272-276`）。 |
|
||||
| Shell | **CLOSED** | 两张 Shell PNG 均为 183/50/40；当前源码：`src/doctor_workstation/ui/shell.py:540,602,686`；基准：`D:/web/zyt/admin/src/config/setting.ts:5`、`D:/web/zyt/admin/src/styles/var.css:8`、`D:/web/zyt/admin/src/layout/default/components/header/multiple-tabs.vue:65`。 |
|
||||
|
||||
## P0 / P1 / P2
|
||||
|
||||
### P0
|
||||
|
||||
**0 项。** 49 张图未发现核心信息被窗口边界硬裁、60% Drawer 尺寸失效、footer 随正文滚走、中文/图标缺字、二维码不可辨识或 1024/1440 壳层错位。
|
||||
|
||||
### P1-1 Notes 舌象不是实际缩略图
|
||||
|
||||
- 实图：`diagnosis_state_notes_actions_1024x640.png` 中舌象为蓝色文字卡“舌象 / 查看”，不是图像；报告文件 chip 和两个删除入口可见。
|
||||
- 当前源码明确只创建 `QPushButton("舌象\n查看")`，没有加载 URL 到 pixmap：`src/doctor_workstation/ui/diagnosis_drawer.py:2153-2183`。
|
||||
- 基准用 `el-image :src="getImageUrl(url)"`、64x64 cover 缩略图与叠加 CircleClose：`D:/web/zyt/admin/src/views/patient/reception/components/NoteTimeline.vue:52-69,366-379`。
|
||||
- 建议边界：保留当前安全打开与单附件删除合同，只把可安全下载/解码的图片异步渲染为 64x64 缩略图；失败时再回退为当前文字卡。
|
||||
|
||||
### P1-2 处方编辑器不是基准的 1200 px 连续 Drawer
|
||||
|
||||
- 实图：`diagnosis_state_prescription_editor_920x780.png` 是 920x780 modal，按“患者与诊断 / 药材配方 / 剂型与用法 / 医师签名”拆为 4 个 tabs。
|
||||
- 当前结构：`src/doctor_workstation/ui/dialogs/prescription.py:1017-1037`；诊单入口调用该 dialog：`src/doctor_workstation/ui/dialogs/diagnosis.py:2533-2585`。
|
||||
- 基准入口直接打开 `tcm-prescription`，其根是 `size="1200px"` Drawer，并在同一滚动流中依次呈现患者信息、诊断信息、RP 药材工具栏/网格、用法和签名：`D:/web/zyt/admin/src/views/tcm/diagnosis/index.vue:416,744`；`D:/web/zyt/admin/src/components/tcm-prescription/index.vue:2-216,217-531`。
|
||||
- 当前 DTO/真实提交能力存在，本项是视觉结构 P1，不是功能缺失。
|
||||
|
||||
### P1-3 订单详情仍是精简 modal
|
||||
|
||||
- 实图：`diagnosis_state_order_detail_640x540.png` 只有 hero、状态 tag 和 10 行键值信息。
|
||||
- 当前源码固定 `640x540`，用单个 `QFormLayout` 罗列患者、金额、医护、地址、物流、备注：`src/doctor_workstation/ui/dialogs/diagnosis.py:3060-3135`。
|
||||
- 基准 `PatientOrderList` 打开共享 readonly `PrescriptionOrderDetailDrawer`：`D:/web/zyt/admin/src/views/tcm/diagnosis/components/PatientOrderList.vue:96-124`；共享组件宽 `80%`，readonly 仍保留金额概览、处方详情、未关联/关联收款、履约收货、物流轨迹与操作日志：`D:/web/zyt/admin/src/views/consumer/prescription/components/PrescriptionOrderDetailDrawer.vue:13-16,154-197,200-545,551-824`。
|
||||
- 因结构和信息密度均明显不同，新增截图只能证明“有详情”，不能证明“同型”。
|
||||
|
||||
### P1-4 视频与聊天媒体形态仍非基准同型
|
||||
|
||||
- 视频：多地址、逐条追加和 QtMultimedia 播放能力均真实存在，但表格只显示文字链接，点击后打开 820x560 独立播放器（`diagnosis.py:2934-2978`；`diagnosis_media.py:38-116`）。基准在“录制回放”单元格内直接嵌入最大高 180 px 的播放器，并把其他地址放在其下：`CallRecordPanel.vue:17-34`、`RecordingPlaybackBlock.vue:1-30`、`RecordingVideoPlayer.vue:320-329`。
|
||||
- 聊天：文字/文件气泡和 info alert 已同型；图片仍为“查看图片”文字链接（`diagnosis_drawer.py:2329-2348`），基准为最大 `240x200` 的可预览图片（`ImChatRecordPanel.vue:39-50,272-276`）。
|
||||
- 两者均可安全使用，但尚未达到这轮明确要求的媒体视觉同型。
|
||||
|
||||
### P2-1 Daily 待办局部工具栏文案仍未精确
|
||||
|
||||
- `diagnosis_state_daily_lower_1024x640.png` 的 primary 按钮为“新增待办”，基准为“+ 新增待办”；当前待办卡内也没有基准同一工具栏上的局部“刷新”（全 Daily 顶部已有刷新）。
|
||||
- 当前：`diagnosis_drawer.py:1691-1702`；基准：`DiagnosisTodoList.vue:3-19`。
|
||||
- 这不再造成裁切或语义压平，故降为 P2。
|
||||
|
||||
### P2-2 订单偏移栏文案与解释层级未精确
|
||||
|
||||
- `diagnosis_state_order_offset_1024x640.png` 显示“全局就诊序号偏移 / 0 / 个序号 / 保存偏移”。
|
||||
- 基准是“复诊统计起始偏移”+ tooltip +“第 1 笔实单计为…”+“保存”：`PatientOrderList.vue:7-41`。
|
||||
- 当前：`src/doctor_workstation/ui/dialogs/diagnosis.py:1056-1083`。数值范围与保存入口成立，本项为文案/说明层级 P2。
|
||||
|
||||
## 尺寸与壳层精确证据
|
||||
|
||||
| 核对项 | 1024x640 | 1440x900 | 源码/基准 |
|
||||
|---|---|---|---|
|
||||
| edit/viewOnly Drawer 60% | panel 从 x=410 开始，宽 614；x=409 仍为 overlay | panel 从 x=576 开始，宽 864 | `diagnosis.py:1336-1340`；基准 `edit.vue:3-9` |
|
||||
| appointment Drawer 60% | panel 从 x=410 开始，宽 614 | panel 从 x=576 开始，宽 864 | `appointment_drawer.py:1716-1719`；基准 `appointment.vue:2-6` |
|
||||
| Shell sidebar | x=0..182 为侧栏，x=183 进入内容；抽样 x182=`#25292D`、x183=`#F6F6F6` | 同一 183 px 边界 | `shell.py:540-543`；基准 `setting.ts:5` |
|
||||
| Shell topbar/tabs | x=200 处 y49 为 topbar 底边，y50 进入 tabs；y89 为 tabs 底边，y90 进入内容，即 50 + 40 | 同一分段 | `shell.py:602,686`；基准 `var.css:8`、`multiple-tabs.vue:65` |
|
||||
|
||||
## 49 张 PNG 逐张判定
|
||||
|
||||
下列 PASS 只证明该张图实际入镜内容；不会拿截图外的滚动内容代替证据。
|
||||
|
||||
### 诊单列表与二维码（14）
|
||||
|
||||
| PNG | 判定 | 目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_1024x640.png` | PASS | 窄屏筛选换行、内部横向溢出、右固定区与行语义完整，无硬裁切。 |
|
||||
| `diagnosis_1440x900.png` | PASS | 宽屏列密度、挂号复合单元格、斑马/业务色与固定操作区成立。 |
|
||||
| `diagnosis_advanced_filters_1280x800.png` | PASS | 高级筛选完整展开，日期范围、控件顺序与重置可见。 |
|
||||
| `diagnosis_double_appointment_cancel_1280x800.png` | PASS | 同诊单两条挂号各有取消入口，虚线层级正常。 |
|
||||
| `diagnosis_empty_1280x800.png` | PASS | 表头、内部空态、横向滚动与 0 条分页均保留。 |
|
||||
| `diagnosis_error_1280x800.png` | PASS | 错误态居中可读，无旧数据穿透。 |
|
||||
| `diagnosis_focus_1280x800.png` | PASS | 搜索框 focus ring 清楚且不挤压布局。 |
|
||||
| `diagnosis_full_menu_1280x800.png` | PASS | 8 项、8 个图标、删除分隔/danger 与精确“二维码”全部可见。 |
|
||||
| `diagnosis_horizontal_scroll_1024x640.png` | PASS | 主表横移时右 460 px 固定区不动，阴影连续。 |
|
||||
| `diagnosis_hover_warning_1280x800.png` | PASS | warning 行 hover 渐变、3 px 左条和固定区同步。 |
|
||||
| `diagnosis_loading_1280x800.png` | PASS | 表内真实圆弧 spinner，内容淡化，无字符 spinner。 |
|
||||
| `diagnosis_pending_assign_1280x800.png` | PASS | 待分配 chip、月份和宽搜索在同一流式区。 |
|
||||
| `diagnosis_permissions_cropped_1280x800.png` | PASS | 权限裁掉批量工具栏和敏感动作，仅留查看。 |
|
||||
| `diagnosis_order_qrcode_1280x800.png` | PASS | 订单号、可辨识 QR、成功态、只读 URL、打开/重试/关闭均完整。 |
|
||||
|
||||
### edit / viewOnly / readonly（6）
|
||||
|
||||
| PNG | 判定 | 目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_edit_1024x640.png` | PASS | 60% Drawer、2/3 列语义表单、横向 tabs、独立滚动体与固定 footer 成立。 |
|
||||
| `diagnosis_edit_1440x900.png` | PASS | 864 px Drawer、宽屏字段比例和 footer 稳定。 |
|
||||
| `diagnosis_viewonly_1024x640.png` | PASS | 60% 只读 Drawer、待配药警告、disabled 表单与仅关闭 footer 成立。 |
|
||||
| `diagnosis_viewonly_1440x900.png` | PASS | 宽屏只读栅格、全 tabs 与固定 footer 成立。 |
|
||||
| `diagnosis_readonly_1024x640.png` | PASS | 独立只读页、hero、病例卡和“客服：赵医助”不拆字。 |
|
||||
| `diagnosis_readonly_1440x900.png` | PASS | 4 列病例密度、异常指标层级及长页面滚动成立。 |
|
||||
|
||||
### 详情状态与子流程（19）
|
||||
|
||||
| PNG | 判定 | 目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_state_loading_1024x640.png` | PASS | 圆弧 spinner 与“正在加载诊单...”完整，无旧 seed 穿透。 |
|
||||
| `diagnosis_state_error_1024x640.png` | PASS | danger banner、重试、空表单和禁用保存完整。 |
|
||||
| `diagnosis_state_empty_1024x640.png` | PASS | 处方空态与 primary “开方”已对齐；编辑器另见 PARTIAL。 |
|
||||
| `diagnosis_state_permission_1024x640.png` | PASS | 仅保留获权 tabs，手机号/身份证掩码，footer 仅关闭。 |
|
||||
| `diagnosis_state_daily_1024x640.png` | PASS | Daily 动作全部可见；刷新换行而未裁切，range/primary/secondary 层级清楚。 |
|
||||
| `diagnosis_state_daily_lower_1024x640.png` | PARTIAL（P2） | 趋势、待办 filters、状态 pill 与 primary 新增成立；缺“+”及待办局部刷新。 |
|
||||
| `diagnosis_state_daily_blood_edit_650x620.png` | PASS | 血糖/血压编辑字段、单位、必填说明、备注和固定动作完整。 |
|
||||
| `diagnosis_state_focus_1024x640.png` | PASS | 姓名 focus ring、紧凑 close 和固定 footer 清楚。 |
|
||||
| `diagnosis_state_save_loading_1024x640.png` | PASS | 按钮内圆弧 spinner 与“正在保存”完整。 |
|
||||
| `diagnosis_state_save_success_1024x640.png` | PASS | 绿色勾与“保存成功”完整。 |
|
||||
| `diagnosis_state_save_failure_1024x640.png` | PASS | 红色叉与“保存失败”完整。 |
|
||||
| `diagnosis_state_notes_actions_1024x640.png` | PARTIAL（P1） | 动作、chip 和单附件删除存在；舌象仍为文字按钮而非真实缩略图。 |
|
||||
| `diagnosis_state_prescription_editor_920x780.png` | PARTIAL（P1） | 完整可用的 4-tab 编辑器已入镜；但不是基准 1200 px 连续 Drawer。 |
|
||||
| `diagnosis_state_order_offset_1024x640.png` | PARTIAL（P2） | 数值、保存、订单表与分页成立；偏移文案/tooltip/解释层级未精确。 |
|
||||
| `diagnosis_state_order_detail_640x540.png` | PARTIAL（P1） | 详情 modal 可用；缺基准 80% Drawer 的金额/支付/履约/物流/日志结构。 |
|
||||
| `diagnosis_state_video_replay_1024x640.png` | PARTIAL（P1） | 主回放 + 2 个备用回放成立；仍是链接列表，不是表内播放器。 |
|
||||
| `diagnosis_state_video_upload_action_1024x640.png` | PARTIAL（P1） | 指定行“追加回放”成立；媒体单元格结构仍未同型。 |
|
||||
| `diagnosis_state_video_player_820x560.png` | PARTIAL（P1） | 应用内播放器和安全外开成立；形态是独立 dialog，不是 180 px 表内播放器。 |
|
||||
| `diagnosis_state_chat_archive_1024x640.png` | PARTIAL（P1） | 完整 info、归档、同步/重载及左右气泡成立；图片消息退化为文字链接。 |
|
||||
|
||||
### 预约 Drawer（8）
|
||||
|
||||
| PNG | 判定 | 目检结论 |
|
||||
|---|---|---|
|
||||
| `appointment_drawer_1024x640.png` | PASS | 60% Drawer、body 滚动、时段状态和固定 footer 无硬裁切。 |
|
||||
| `appointment_drawer_1440x900.png` | PASS | 医生 radio、四个日期按钮、时段网格、备注和 footer 对齐。 |
|
||||
| `appointment_drawer_empty_doctors_1440x900.png` | PASS | warning、空态插图、暂无医生与禁用确认完整。 |
|
||||
| `appointment_drawer_empty_roster_1440x900.png` | PASS | 无排班 warning、空态和“该医生暂无排班”可读。 |
|
||||
| `appointment_drawer_error_1440x900.png` | PASS | 号源错误 banner、刷新入口和空态并存。 |
|
||||
| `appointment_drawer_keyboard_focus_1440x900.png` | PASS | 日期按钮蓝色键盘 focus 边界清楚。 |
|
||||
| `appointment_drawer_loading_1440x900.png` | PASS | 初始加载 overlay、圆弧 spinner、文案与禁用确认完整。 |
|
||||
| `appointment_drawer_refreshing_1440x900.png` | PASS | 刷新 overlay、圆弧 spinner、文案与禁用确认完整。 |
|
||||
|
||||
### Shell（2）
|
||||
|
||||
| PNG | 判定 | 目检结论 |
|
||||
|---|---|---|
|
||||
| `diagnosis_shell_1024x640.png` | PASS | 183/50/40、深色侧栏、tabs、固定列与分页均成立；无 glyph 方框。 |
|
||||
| `diagnosis_shell_1440x900.png` | PASS | 同一壳层比例在宽屏保持，箭头/刷新/全屏/关闭图形和中文完整。 |
|
||||
|
||||
## 发布判定
|
||||
|
||||
- **可以确认无 P0，且此前 Daily、更多菜单、Shell 的明确 OPEN 已关闭。**
|
||||
- **不能给视觉同型 PASS。** 需至少关闭 P1-1 至 P1-4，并补录对应终态 PNG；P2 可在同一轮顺手精确。
|
||||
- 本轮最终：**PARTIAL（40 PASS / 9 PARTIAL，共检查 49 张 PNG）**。
|
||||
@@ -0,0 +1,329 @@
|
||||
# DoctorWorkstation 发布打包就绪审计
|
||||
|
||||
审计日期：2026-08-11（Asia/Shanghai）
|
||||
审计主机：Windows 10/11 工作区 `D:\web\zyt\app`
|
||||
审计边界：只检查入口、脚本、PyInstaller spec、冻结依赖、伴随页、文档和既有产物；未执行完整 PyInstaller，未改业务/打包源码。
|
||||
|
||||
## 结论
|
||||
|
||||
**当前状态：不可直接发布既有 `dist`，也不应立即从当前 Git 状态制作正式发布包。**
|
||||
|
||||
构建流水线的主体是完整的：Windows/macOS 均有根目录中英文入口，能从锁文件准备 Python/Node 依赖，能构建 TRTC Web companion，PyInstaller 使用 onedir/.app，构建后会检查 QtWebEngine 与 companion，并在隔离目录中运行冻结入口 `--smoke-test`。Windows 既有 ZIP 的命名和 SHA-256 也正确。
|
||||
|
||||
但发布前有三个 P0：macOS 入口在 Git 中没有可执行位；新增 QtMultimedia 业务文件仍未纳入版本控制且工作树存在大量未提交发布输入；当前 Windows 成品早于新增媒体代码，缺少 QtMultimedia Python 模块、Widgets 库及媒体插件。另有 P1：当前冻结烟测会在媒体能力缺失时仍通过，生产级签名/公证也尚未进入一键流水线。
|
||||
|
||||
**macOS 特别说明：PyInstaller 不能从 Windows 交叉产出或验收 `.app`。本审计只能检查 macOS 脚本和合同；最终 `.app`、原生 Qt/媒体插件、签名、摄像头/麦克风权限及 TRTC 实通必须在原生 macOS（对应 arm64 或 x86_64）上构建和验证。**
|
||||
|
||||
严重度定义：
|
||||
|
||||
- P0：在任何正式构建/分发前必须解决。
|
||||
- P1：可做内部技术构建，但生产发布前必须解决或由发布负责人书面接受风险。
|
||||
- P2：不阻断本次内部构建，建议纳入发布工程改进。
|
||||
|
||||
## 构建前阻断
|
||||
|
||||
### P0-1：macOS Finder/命令行入口在 Git 索引中全部为 `100644`
|
||||
|
||||
`git ls-files --stage -- '*.command' 'scripts/*.sh'` 显示以下文件均为 `100644`，不是 `100755`：
|
||||
|
||||
- `run_macos.command`
|
||||
- `package_macos.command`
|
||||
- `一键运行.command`
|
||||
- `一键打包.command`
|
||||
- `scripts/build_macos.sh`
|
||||
- `scripts/package_macos.sh`
|
||||
- `scripts/run_macos.sh`
|
||||
- `scripts/macos_helpers.sh`
|
||||
- `scripts/check_macos_entrypoints.sh`
|
||||
|
||||
影响：新的 macOS clone 中，Finder 双击 `.command` 和 README 中的 `./scripts/build_macos.sh` 不能满足“一键运行/一键打包”；`scripts/check_macos_entrypoints.sh` 自己也要求这些入口 `-x`。Windows/NTFS 下 Git Bash 把文件视为可执行，因此当前合同检查通过并不能覆盖 Git 模式错误。
|
||||
|
||||
发布前处理：
|
||||
|
||||
```powershell
|
||||
git update-index --chmod=+x run_macos.command package_macos.command `
|
||||
"一键运行.command" "一键打包.command" `
|
||||
scripts/build_macos.sh scripts/package_macos.sh scripts/run_macos.sh `
|
||||
scripts/macos_helpers.sh scripts/check_macos_entrypoints.sh
|
||||
git ls-files --stage -- '*.command' 'scripts/*.sh'
|
||||
```
|
||||
|
||||
第二条命令的每一行都必须以 `100755` 开头，并将模式变化提交到发布 commit。
|
||||
|
||||
### P0-2：当前发布输入不在可复现的 Git 状态
|
||||
|
||||
审计时工作树含多处已修改和大量未跟踪代码；与本次媒体发布直接相关的 `src/doctor_workstation/ui/diagnosis_media.py` 及对应测试仍是未跟踪文件。若从当前目录构建，PyInstaller 会把这些本地文件打入包；若从当前 HEAD/干净 CI clone 构建，则不会包含它们。两者结果不一致。
|
||||
|
||||
发布前必须由负责人审阅 `git status --short`，只纳入确认属于本次版本的源码、测试、脚本和文档，并从确定的 commit/tag 构建。不要用 `git add -A` 掩盖当前大量测试产物和临时目录。
|
||||
|
||||
### P0-3：既有 Windows ZIP/onedir 早于新增 QtMultimedia 代码，禁止分发
|
||||
|
||||
证据：
|
||||
|
||||
- `dist/DoctorWorkstation/DoctorWorkstation.exe`：2026-08-10 17:07。
|
||||
- `dist/DoctorWorkstation-Windows-x64-0.1.0.zip`：2026-08-10 17:08。
|
||||
- `src/doctor_workstation/ui/diagnosis_media.py`：2026-08-11 01:05。
|
||||
- 既有成品只有 `Qt6Multimedia.dll`/QML 辅助文件，缺少：
|
||||
- `PySide6/QtMultimedia.pyd`
|
||||
- `PySide6/QtMultimediaWidgets.pyd`
|
||||
- `PySide6/Qt6MultimediaWidgets.dll`
|
||||
- `PySide6/plugins/multimedia/ffmpegmediaplugin.dll`
|
||||
- `PySide6/plugins/multimedia/windowsmediaplugin.dll`
|
||||
|
||||
既有 ZIP 也缺少同一组文件。它的 SHA-256 文件本身有效，但只证明旧 ZIP 未损坏，不证明它对应当前源码。
|
||||
|
||||
此外，根目录“一键运行”优先启动既有 `dist`，所以当前直接双击会运行旧代码，不会验证当前工作树。正式验收前必须完成干净重建，并以新 ZIP 的时间戳、文件清单和哈希替换旧证据。
|
||||
|
||||
## P1：生产发布前必须闭环
|
||||
|
||||
### P1-1：QtMultimedia 依赖可用，但冻结收集没有独立门禁
|
||||
|
||||
通过项：
|
||||
|
||||
- `pyproject.toml` 依赖 `PySide6>=6.8.2,<7`；`uv.lock` 当前锁定 PySide6/PySide6 Addons/Essentials 6.11.1，Addons 提供 QtMultimedia。
|
||||
- 当前 `.venv` 和 `.venv-build` 均有 `QtMultimedia.pyd`、`QtMultimediaWidgets.pyd`、`Qt6MultimediaWidgets.dll` 以及 Windows `plugins/multimedia` 下的 FFmpeg/Windows Media 插件。
|
||||
- 当前 PyInstaller 6.22 的官方 `hook-PySide6.QtMultimedia.py` 会追加 `PySide6.QtMultimediaWidgets`，Qt 模块映射会收集 Qt 6 的 `multimedia` 插件。当前源码中的静态 import 理论上会触发该 hook。
|
||||
|
||||
缺口：
|
||||
|
||||
- `packaging/doctor_workstation.spec` 的显式 hidden imports 只有 QtWebEngine 相关模块，没有显式列出 `PySide6.QtMultimedia`/`PySide6.QtMultimediaWidgets`。
|
||||
- Windows/macOS 构建脚本只检查 QtWebEngine helper、Chromium `.pak` 和 `video_companion_dist/index.html`，不检查 QtMultimedia Python 扩展、Widgets 库或媒体后端插件。
|
||||
- `diagnosis_media.py` 捕获 `ImportError` 并降级到外部打开，因此媒体模块缺失不会让应用启动失败。
|
||||
- 实测旧冻结包缺少上述模块/插件，但隔离执行 `DoctorWorkstation.exe --smoke-test` 仍返回 0。这证明现有烟测不是 QtMultimedia 发布门禁。
|
||||
|
||||
发布前至少应做到以下二者之一，建议二者都做：
|
||||
|
||||
1. 在 spec 中显式纳入 `PySide6.QtMultimedia` 和 `PySide6.QtMultimediaWidgets`，继续使用 PyInstaller 官方 hooks 收集平台插件。
|
||||
2. 在两个构建脚本中增加平台化的成品断言；Windows 检查两个 `.pyd`、`Qt6MultimediaWidgets.dll` 和 `plugins/multimedia`，macOS 检查两个 Python 扩展、Qt multimedia framework/dylib 和 `plugins/multimedia`。
|
||||
|
||||
最终验收还要用一个获准分发的 MP4（以及产品真实需要时的 HLS）实际播放，不能只看文件存在。
|
||||
|
||||
### P1-2：`--smoke-test` 只证明冻结启动，不证明 WebRTC/媒体可用
|
||||
|
||||
当前烟测的隔离、30 秒超时、非零退出码和未捕获异常日志检查设计良好；Windows/macOS 都不会访问真实后端。它会启动 composition root，并在约 1.2 秒后退出。
|
||||
|
||||
它不执行以下能力：
|
||||
|
||||
- 创建 `QMediaPlayer` 并确认媒体 backend 被发现；
|
||||
- 播放音视频并检查解码/渲染；
|
||||
- 打开 `QWebEngineView` 的 companion 主文档；
|
||||
- 执行 `TRTC.isSupported()`、请求摄像头/麦克风或加入真实测试房间；
|
||||
- 验证设备插拔、休眠恢复、弱网、屏幕共享或录播 codec。
|
||||
|
||||
因此冻结烟测应保留为启动门禁，同时新增“冻结媒体插件合同”和原生机器上的手工/自动媒体准入。README 已提示首发要做真实 TRTC/设备验收，这项不能被 `--smoke-test` 替代。
|
||||
|
||||
### P1-3：生产分发签名链未纳入一键打包
|
||||
|
||||
Windows：当前流水线生成 ZIP 与 SHA-256，但没有 Authenticode 签名步骤。SHA-256 提供完整性，不提供发布者身份；对外分发前应在压缩前签名并验证最终可执行文件。
|
||||
|
||||
macOS：spec 接受可选的 `MACOS_CODESIGN_IDENTITY`，构建脚本只运行 `codesign --verify --deep --strict`。未提供 Developer ID 时，PyInstaller 的临时/ad-hoc 签名也可能通过这一完整性检查；脚本不执行 notarization/stapling，也没有验证嵌套 `QtWebEngineProcess.app` 的实际 entitlements/运行能力。当前 README 仅把签名、公证作为人工说明。
|
||||
|
||||
若本次只是内部 QA 包，应明确标注“未签名/未公证内部构建”。若是生产或院外分发，应先把 Windows 签名，以及 macOS Developer ID → nested code 检查 → notarization → stapling → 重新生成最终 ZIP/哈希，纳入发布流水线。注意：staple 会改变 `.app`，所以不能继续分发公证前生成的 ZIP。
|
||||
|
||||
### P1-4：macOS 成品尚无原生验证证据
|
||||
|
||||
Windows 上的 `bash -n` 和合同脚本只能证明 shell 文本结构。以下证据必须在 macOS 构建机补齐：
|
||||
|
||||
- `.app` 原生架构与最低系统版本；
|
||||
- `QtWebEngineProcess.app`、Qt framework、QtMultimedia 插件实际存在并签名有效；
|
||||
- `NSCameraUsageDescription`/`NSMicrophoneUsageDescription` 能触发正确权限流程；
|
||||
- companion 的本地 `file:`/qrc 资源、WebChannel 和 TRTC 能在打包态工作；
|
||||
- arm64/x64 输出名与实际二进制架构一致；
|
||||
- 最终 ZIP 的 Gatekeeper/notary 结果。
|
||||
|
||||
这不是 Windows 端可以规避的检查；必须安排一台原生 macOS runner/构建机。
|
||||
|
||||
## P2：建议改进
|
||||
|
||||
1. 仓库没有 `.gitattributes`，而本机 `core.autocrlf=true`。当前 macOS shell 文件实际是无 BOM 的 LF，`bash -n` 通过，但建议用 `.gitattributes` 固定 `*.sh`/`*.command` 为 LF，并固定批处理/PowerShell 的预期行尾。
|
||||
2. Windows 使用 `uv sync --frozen`，macOS 使用 `uv sync --locked`。当前 `uv.lock` 包含所需依赖，但 `--frozen` 不承担 lock 新鲜度检查；发布前可增加 `uv lock --check`，或统一为能拒绝 pyproject/lock 漂移的策略。
|
||||
3. `packaging/windows/version_info.txt` 的 `0.1.0.0` 与 `pyproject.toml` 的 `0.1.0` 当前一致，但它是手工同步；脚本没有发布前一致性检查。升级版本时可能出现 ZIP 名与 EXE 版本资源不一致。
|
||||
4. README 顶部的一键入口描述正确，但“测试与打包”段落调用 `build_*`，只产生 onedir/.app，不产生版本化 ZIP/哈希。建议明确区分“构建”与“发布打包”，并把 `package_*`/根入口列为正式发布命令。
|
||||
5. `.env.example` 对 demo/生产、SSL、TRTC secret 禁止项说明清楚，未包含长期凭据；但发布 ZIP 不包含 README 或 `.env.example`，README 也没有明确冻结包从哪里查找 `.env`。若企业部署依赖环境文件，应说明冻结态放置/注入方式；若只允许登录页保存非敏感配置，也应明确说明无需随包放 `.env`。
|
||||
6. Windows 用固定 `dist/SHA256SUMS.txt`，macOS 用相邻的 `<zip>.sha256`；两者都可校验，但发布自动化和用户说明可以统一。`dist` 还可能保留旧版本 ZIP，根打包入口成功后打开整个目录，建议在发布清单中明确唯一应交付的文件。
|
||||
7. `Build_DoctorWorkstation.bat -ValidateOnly` 会打印 `Package ready in: ...`，即使它只做了入口预检；不影响退出码，但容易被误认作已生成新包。
|
||||
8. spec 没有设置 Windows EXE/macOS bundle 的原生应用图标；窗口内 SVG 正常，但系统文件/Finder 图标仍是默认值。若品牌发布有要求，应在最终签名前补齐 `.ico`/`.icns`。
|
||||
9. AGENTS.md 指向的 `.trellis/workflow.md` 与 `.trellis/spec/` 在本工作区不存在；本次无法执行项目内 Trellis 规范审查。这不影响二进制启动，但属于发布治理缺口。
|
||||
|
||||
## 已通过的检查
|
||||
|
||||
| 检查项 | 结果 | 备注 |
|
||||
|---|---:|---|
|
||||
| Windows 根英文入口 `Build_DoctorWorkstation.bat -ValidateOnly` | PASS | Node/uv/必需文件预检通过 |
|
||||
| Windows 根英文入口 `Run_DoctorWorkstation.bat -ValidateOnly` | PASS | 当前命中既有冻结 EXE；不代表源码新鲜 |
|
||||
| Windows 两个中文别名 `-ValidateOnly` | PASS | 正确转发参数和退出码 |
|
||||
| PowerShell parser | PASS | `build_windows.ps1`、`package_windows.ps1`、`run_windows.ps1` 均无解析错误 |
|
||||
| macOS `bash -n` | PASS | helpers、run/package/build/check 与四个 `.command` 均通过 |
|
||||
| `scripts/check_macos_entrypoints.sh` | PASS（有限） | Git Bash 下合同通过；不能覆盖 Git `100644` 问题 |
|
||||
| 入口/冻结异常合同 pytest | PASS | `tests/test_one_click_entrypoints.py` + `tests/test_entrypoint.py`，4 passed |
|
||||
| 当前 source QtMultimedia import | PASS | `QMediaPlayer`、`QAudioOutput`、`QVideoWidget` 均可导入；两个 Windows multimedia plugin 可见 |
|
||||
| TRTC companion 工作树 | PASS | `video_companion` 无 Git 变更；dist 新于源码 |
|
||||
| companion 相对资源 | PASS | `base: './'`；index 引用的 JS/CSS 均存在 |
|
||||
| companion 打包副本 | PASS（旧包） | source dist 与旧 frozen 副本的 `index.html` SHA-256 相同 |
|
||||
| spec companion/resources 映射 | PASS | `video_companion/dist -> video_companion_dist`、`resources -> resources` 与运行时查找一致 |
|
||||
| QtWebEngine 收集策略 | PASS | 显式 imports 触发官方 hooks，构建脚本检查 helper 与 `.pak` |
|
||||
| 冻结启动烟测机制 | PASS（范围有限） | 旧 EXE 在隔离 demo/offscreen 环境中 `--smoke-test` 退出 0；同时暴露媒体缺口未被检测 |
|
||||
| Windows 输出名 | PASS（旧包） | `DoctorWorkstation-Windows-x64-0.1.0.zip` |
|
||||
| Windows SHA-256 | PASS（旧包） | `SHA256SUMS.txt` 与实际 ZIP hash 一致 |
|
||||
| 版本号一致性 | PASS | pyproject `0.1.0`；Windows resource `0.1.0.0` |
|
||||
|
||||
## 入口、spec 和输出合同摘要
|
||||
|
||||
### Windows
|
||||
|
||||
- 根入口：中文别名 → 英文 `.bat` → `scripts/package_windows.ps1`/`run_windows.ps1`。
|
||||
- 运行：优先 `dist/DoctorWorkstation/DoctorWorkstation.exe`，否则使用 `.venv` 或 `uv sync --frozen` 后运行源码。
|
||||
- 发布打包：Node 20+ → `uv sync --frozen --extra build` → `npm ci` → companion build → PyInstaller `--clean` → 静态成品检查 → 隔离冻结烟测 → ZIP → SHA-256。
|
||||
- 产物：
|
||||
- onedir：`dist/DoctorWorkstation/`
|
||||
- 启动器：`dist/Start_DoctorWorkstation.bat`
|
||||
- ZIP：`dist/DoctorWorkstation-Windows-x64-<version>.zip`
|
||||
- 校验：`dist/SHA256SUMS.txt`
|
||||
|
||||
### macOS
|
||||
|
||||
- 根入口：四个 `.command` 解析自身目录后用 `/bin/bash` 调用 `scripts/run_macos.sh` 或 `scripts/package_macos.sh`。
|
||||
- 运行：优先 `/usr/bin/open dist/DoctorWorkstation.app`，否则确保 uv、同步锁定依赖并运行源码。
|
||||
- 发布打包：原生 Darwin 检查 → uv/Node 20+（必要时下载）→ `npm ci` → companion build → PyInstaller `.app` → QtWebEngine/companion 检查 → codesign verify → 隔离冻结烟测 → `ditto` ZIP → SHA-256。
|
||||
- 产物：
|
||||
- bundle：`dist/DoctorWorkstation.app`
|
||||
- ZIP：`dist/DoctorWorkstation-macOS-{arm64|x64}-<version>.zip`
|
||||
- 校验：同路径 `<zip>.sha256`
|
||||
|
||||
## 主代理最终构建与验证命令
|
||||
|
||||
以下命令应在 P0 修复、发布输入已审阅并固定到 commit/tag 后执行。不要把当前旧 `dist` 当成成功证据。
|
||||
|
||||
### 1. 通用发布前门禁
|
||||
|
||||
```powershell
|
||||
git status --short
|
||||
git diff --check
|
||||
git ls-files --stage -- '*.command' 'scripts/*.sh'
|
||||
```
|
||||
|
||||
要求：无意外修改/未跟踪发布输入；macOS 操作文件均为 `100755`。研究报告或明确允许的生成物可以存在，但不得混入发布源清单。
|
||||
|
||||
### 2. Windows：在 Windows x64 原生主机执行
|
||||
|
||||
轻量预检：
|
||||
|
||||
```powershell
|
||||
.\Build_DoctorWorkstation.bat -ValidateOnly
|
||||
.\.venv\Scripts\python.exe -m pytest -p no:cacheprovider `
|
||||
tests\test_one_click_entrypoints.py tests\test_entrypoint.py
|
||||
```
|
||||
|
||||
正式构建（该入口内部已经执行 locked dependency preparation、companion build、PyInstaller、冻结烟测、ZIP 和哈希）：
|
||||
|
||||
```powershell
|
||||
.\Build_DoctorWorkstation.bat
|
||||
```
|
||||
|
||||
构建后强制文件门禁：
|
||||
|
||||
```powershell
|
||||
$artifact = Resolve-Path 'dist\DoctorWorkstation'
|
||||
$qt = Join-Path $artifact '_internal\PySide6'
|
||||
$required = @(
|
||||
(Join-Path $artifact 'DoctorWorkstation.exe'),
|
||||
(Join-Path $qt 'QtMultimedia.pyd'),
|
||||
(Join-Path $qt 'QtMultimediaWidgets.pyd'),
|
||||
(Join-Path $qt 'Qt6Multimedia.dll'),
|
||||
(Join-Path $qt 'Qt6MultimediaWidgets.dll'),
|
||||
(Join-Path $qt 'plugins\multimedia\ffmpegmediaplugin.dll'),
|
||||
(Join-Path $qt 'plugins\multimedia\windowsmediaplugin.dll'),
|
||||
(Join-Path $artifact '_internal\video_companion_dist\index.html')
|
||||
)
|
||||
$missing = $required | Where-Object { -not (Test-Path -LiteralPath $_ -PathType Leaf) }
|
||||
if ($missing) { throw "Missing frozen release files:`n$($missing -join "`n")" }
|
||||
if (-not (Get-ChildItem -LiteralPath $artifact -Recurse -File `
|
||||
-Filter 'QtWebEngineProcess.exe' | Select-Object -First 1)) {
|
||||
throw 'QtWebEngineProcess.exe missing'
|
||||
}
|
||||
if (-not (Get-ChildItem -LiteralPath $artifact -Recurse -File `
|
||||
-Filter 'qtwebengine_resources*.pak' | Select-Object -First 1)) {
|
||||
throw 'QtWebEngine resources missing'
|
||||
}
|
||||
```
|
||||
|
||||
版本化 ZIP 与哈希复核：
|
||||
|
||||
```powershell
|
||||
$version = ([regex]::Match(
|
||||
[IO.File]::ReadAllText((Resolve-Path 'pyproject.toml')),
|
||||
'(?m)^version\s*=\s*"([^"]+)"'
|
||||
)).Groups[1].Value
|
||||
$zip = Resolve-Path "dist\DoctorWorkstation-Windows-x64-$version.zip"
|
||||
$actual = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
|
||||
$expected = ((Get-Content -Raw -Encoding UTF8 'dist\SHA256SUMS.txt').Trim() -split '\s+')[0]
|
||||
if ($actual -ne $expected) { throw 'Windows release checksum mismatch' }
|
||||
Write-Host "Verified: $zip`nSHA-256: $actual"
|
||||
```
|
||||
|
||||
最后在一台无开发环境的 Windows 10/11 x64 机器解压 ZIP，双击 `Start_DoctorWorkstation.bat`，完成登录/demo、内嵌 companion、获准 MP4/HLS 回放、摄像头/麦克风与一次真实测试房间验收。若为生产外发，必须先完成 Authenticode，再重新生成 ZIP 和 SHA-256。
|
||||
|
||||
### 3. macOS：只能在原生 macOS 主机执行
|
||||
|
||||
模式、语法和入口合同：
|
||||
|
||||
```bash
|
||||
git ls-files --stage -- '*.command' 'scripts/*.sh'
|
||||
test "$(git ls-files --stage -- '*.command' 'scripts/*.sh' | \
|
||||
awk '$1 != "100755" { bad++ } END { print bad + 0 }')" = 0
|
||||
bash -n scripts/macos_helpers.sh scripts/run_macos.sh \
|
||||
scripts/package_macos.sh scripts/build_macos.sh \
|
||||
scripts/check_macos_entrypoints.sh \
|
||||
run_macos.command package_macos.command \
|
||||
一键运行.command 一键打包.command
|
||||
CI=1 DOCTOR_NONINTERACTIVE=1 bash scripts/check_macos_entrypoints.sh
|
||||
```
|
||||
|
||||
内部 QA 构建可直接运行；生产构建应先提供真实 Developer ID：
|
||||
|
||||
```bash
|
||||
export MACOS_CODESIGN_IDENTITY='Developer ID Application: <组织名称> (<TEAMID>)'
|
||||
./一键打包.command
|
||||
```
|
||||
|
||||
构建后检查：
|
||||
|
||||
```bash
|
||||
app='dist/DoctorWorkstation.app'
|
||||
test -x "$app/Contents/MacOS/DoctorWorkstation"
|
||||
test -n "$(find "$app" -type f \( -name 'QtMultimedia.so' -o -name 'QtMultimedia.*.so' \) -print -quit)"
|
||||
test -n "$(find "$app" -type f \( -name 'QtMultimediaWidgets.so' -o -name 'QtMultimediaWidgets.*.so' \) -print -quit)"
|
||||
test -n "$(find "$app" -type f -path '*/plugins/multimedia/*' -print -quit)"
|
||||
test -n "$(find "$app" -type f -name 'QtWebEngineProcess' -print -quit)"
|
||||
test -n "$(find "$app" -type f -name 'qtwebengine_resources*.pak' -print -quit)"
|
||||
test -n "$(find "$app" -type f -path '*video_companion_dist/index.html' -print -quit)"
|
||||
codesign --verify --deep --strict --verbose=2 "$app"
|
||||
codesign -d --entitlements :- "$app/Contents/MacOS/DoctorWorkstation"
|
||||
file "$app/Contents/MacOS/DoctorWorkstation"
|
||||
```
|
||||
|
||||
版本化 ZIP 与哈希复核：
|
||||
|
||||
```bash
|
||||
version="$(awk -F '"' '/^version = "/ { print $2; exit }' pyproject.toml)"
|
||||
case "$(uname -m)" in
|
||||
arm64) arch='arm64' ;;
|
||||
x86_64) arch='x64' ;;
|
||||
*) echo 'Unsupported macOS architecture' >&2; exit 1 ;;
|
||||
esac
|
||||
zip="DoctorWorkstation-macOS-$arch-$version.zip"
|
||||
(cd dist && shasum -a 256 -c "$zip.sha256")
|
||||
```
|
||||
|
||||
生产外发还需用 `xcrun notarytool` 提交、等待成功并 `xcrun stapler staple`。staple 后要用 `ditto --keepParent` 重新生成最终 ZIP 并重算 `.sha256`，再以 `spctl --assess --type execute --verbose=4` 和一台干净 macOS 13+ 机器验收。最终必须实测摄像头、麦克风、扬声器切换、QtMultimedia 回放、QtWebEngine companion 和 TRTC 测试房间。
|
||||
|
||||
## 发布准入判定
|
||||
|
||||
满足以下条件才可把状态改为“可发布”：
|
||||
|
||||
1. macOS 操作文件的 Git 模式全部为 `100755`。
|
||||
2. intended release source 已纳入确定 commit/tag，构建工作树无意外输入。
|
||||
3. Windows 从该 commit 完整重建；新 ZIP 含 QtMultimedia Python/Widgets/插件、QtWebEngine 和当前 companion，哈希通过。
|
||||
4. 原生 macOS 从同一 commit 完整重建；`.app` 含对应媒体/QtWebEngine 组件，架构、签名、权限、ZIP 哈希通过。
|
||||
5. 两个平台冻结 `--smoke-test` 通过，且独立媒体/companion/TRTC 验收通过。
|
||||
6. 若为生产外发，Windows Authenticode 与 macOS Developer ID/notarization/stapling 均在最终归档前完成。
|
||||
@@ -0,0 +1,230 @@
|
||||
# 发布打包最终只读复审
|
||||
|
||||
日期：2026-08-11（Asia/Shanghai）
|
||||
目标：判断是否可以**从当前工作树**重建 DoctorWorkstation 发布包。
|
||||
边界：未执行完整 PyInstaller，未修改应用/打包源码；仅新增本复审报告。
|
||||
|
||||
## 最终结论
|
||||
|
||||
**结论：当前工作树已具备启动原生完整重建的条件，未发现构建前 packaging 代码级 P0。**
|
||||
|
||||
- Windows 当前工作树可进入 `Build_DoctorWorkstation.bat` 完整重建；根发布入口的 `-ValidateOnly` 已通过。
|
||||
- macOS 的 9 个操作入口在 Git index 中现已全部为 `100755`，入口合同会同时检查文件系统 `-x` 和 Git index mode，不再被 Windows/NTFS 的可执行位模拟掩盖。
|
||||
- spec 已显式收集 `PySide6.QtMultimedia`/`QtMultimediaWidgets`，并安装独立 PyInstaller runtime hook。
|
||||
- Windows/macOS build 均先检查冻结媒体文件，再依次执行 `--media-smoke-test` 与 `--smoke-test`；package 仅在 build 成功后归档和计算哈希。
|
||||
- README、packaging README 与 `.env.example` 已说明 build/package 区别、双媒体门禁、macOS mode 以及 `.env` 不进入发布包的部署策略。
|
||||
|
||||
本结论只表示“可以开始原生重建”，不表示两个平台产物已经生成或可以立即对外发布。旧 `dist` 仍是修复前成品，必须由新构建替换；macOS `.app` 仍只能在原生 macOS 上产出和验收。
|
||||
|
||||
## P0：无
|
||||
|
||||
按本轮定义——是否能从**当前本地工作树**发起完整重建——未发现 P0。
|
||||
|
||||
特别澄清：`src/doctor_workstation/ui/diagnosis_media.py`、`packaging/runtime_media_smoke.py`、`tests/test_packaging_media_gate.py` 等文件目前未跟踪，但它们真实存在于当前工作树，spec/测试/发布入口都能读取，因此**不是本地工作树构建阻断**。它们的未提交状态属于跨机和后续复现风险，列为 P1，而不是本轮 P0。
|
||||
|
||||
## P1：完整发布前仍须完成
|
||||
|
||||
### P1-1：必须运行新的原生完整构建，旧 `dist` 不得作为验收证据
|
||||
|
||||
当前 `dist/DoctorWorkstation` 和版本 ZIP 早于 QtMultimedia 修复，仍缺少新媒体模块/插件。根“一键运行”会优先启动这个旧 EXE，所以完整重建前不要用它判断当前代码。
|
||||
|
||||
Windows 必须重新运行：
|
||||
|
||||
```powershell
|
||||
.\Build_DoctorWorkstation.bat
|
||||
```
|
||||
|
||||
只有控制台依次报告以下门禁通过，且随后生成新 ZIP/哈希，才算 Windows 重建成功：
|
||||
|
||||
1. QtWebEngine helper/resources 与 TRTC companion 文件检查；
|
||||
2. `Frozen Qt multimedia file gate passed`；
|
||||
3. `Frozen Qt multimedia smoke gate passed (--media-smoke-test, ...)`；
|
||||
4. `Frozen application entry smoke gate passed (--smoke-test, ...)`；
|
||||
5. `Windows package complete`。
|
||||
|
||||
本复审按约束未运行完整 PyInstaller，因此不能提前宣称这些冻结态门禁已经在新产物上通过。
|
||||
|
||||
### P1-2：macOS 必须在原生目标架构主机完成构建
|
||||
|
||||
Windows 只能验证 shell 语法和合同，不能交叉产生 `.app`、macOS framework、媒体插件或有效签名。必须在 arm64 或 x86_64 macOS 构建机执行：
|
||||
|
||||
```bash
|
||||
CI=1 DOCTOR_NONINTERACTIVE=1 bash scripts/check_macos_entrypoints.sh
|
||||
./一键打包.command
|
||||
```
|
||||
|
||||
成功证据必须包括媒体文件 gate、两个冻结 smoke gate、`codesign --verify`、实际架构、版本 ZIP 与 `.sha256`。这是一项平台执行门禁，不是当前脚本缺陷。
|
||||
|
||||
### P1-3：当前工作树尚未形成可跨机复现的发布 commit/tag
|
||||
|
||||
当前本机直接构建会包含未跟踪媒体源码和 runtime hook，因此可以构建；但新的 clone、CI runner 或另一台 macOS 机器不会从当前 HEAD 获得这些文件。当前还有多处修改、staged mode 变化和大量测试产物。
|
||||
|
||||
因此：
|
||||
|
||||
- 内部本机技术构建可以现在开始；
|
||||
- 跨机 macOS 构建或正式发布前，发布负责人仍应审阅 intended source，提交必要文件及 9 个 mode 变化，并从确定的 commit/tag 构建；
|
||||
- 不应使用 `git add -A` 把 `.pytest-tmp-*`、`artifacts/` 等临时产物一并纳入。
|
||||
|
||||
这是正式发布的可复现性 P1，但按根任务要求不作为“当前工作树本地重建”P0。
|
||||
|
||||
### P1-4：生产签名、公证链仍是发布策略门禁
|
||||
|
||||
- Windows package 生成 ZIP 与 SHA-256，但没有集成 Authenticode。
|
||||
- macOS 接受可选 `MACOS_CODESIGN_IDENTITY` 并运行 `codesign --verify`，但不自动 notarize/staple；ad-hoc 签名也可能通过完整性验证。
|
||||
|
||||
内部 QA 包可以明确标记为内部构建。生产/院外分发则必须在归档前完成 Windows 签名；macOS 必须完成 Developer ID、嵌套 QtWebEngine helper 检查、notarization 和 stapling。staple 会改变 `.app`，之后要重新生成最终 ZIP 与 SHA-256。
|
||||
|
||||
### P1-5：媒体 gate 不替代真实播放和 TRTC 准入
|
||||
|
||||
新 `--media-smoke-test` 已真实创建 Qt 媒体对象并检查 decoder backend，但没有加载具体 MP4/HLS，也不请求摄像头/麦克风或加入 TRTC 房间。正式验收仍需在最终冻结包上覆盖：
|
||||
|
||||
- 获准分发的 MP4，产品要求时再覆盖 HLS；
|
||||
- 画面渲染与音频输出；
|
||||
- QtWebEngine companion/WebChannel；
|
||||
- 摄像头、麦克风、扬声器切换；
|
||||
- TRTC 测试房间、弱网、设备插拔和休眠恢复。
|
||||
|
||||
## P2：建议改进
|
||||
|
||||
1. 仓库仍无 `.gitattributes`，本机 `core.autocrlf=true`；当前 shell 文件是 LF 且 `bash -n` 通过，但建议固定 `*.sh`/`*.command` 为 LF。
|
||||
2. Windows 使用 `uv sync --frozen`，macOS 使用 `uv sync --locked`；建议补 `uv lock --check` 或统一 lock 新鲜度策略。
|
||||
3. Windows `version_info.txt` 的 `0.1.0.0` 与 pyproject `0.1.0` 当前一致，但仍是人工同步，建议增加版本一致性门禁。
|
||||
4. `Build_DoctorWorkstation.bat -ValidateOnly` 仍输出 `Package ready in: ...`，容易让人误以为已经生成新包；退出码和行为本身正确。
|
||||
5. Windows/macOS 的哈希文件命名分别为 `SHA256SUMS.txt` 与 `<zip>.sha256`，可统一以简化发布自动化。
|
||||
6. spec 尚未设置原生 `.ico`/`.icns`；不影响构建或媒体能力，但正式品牌发布可补齐。
|
||||
7. `research/release_packaging_audit.md` 与 `release_packaging_gate_fixed.md` 是阶段性历史记录，其中关于旧 mode/旧产物的描述不能替代本最终复审。
|
||||
8. AGENTS.md 引用的 `.trellis/workflow.md` 和 `.trellis/spec/` 在当前工作区仍不存在；属于治理缺口，不是本地构建阻断。
|
||||
|
||||
## 独立复审结果
|
||||
|
||||
### 1. PyInstaller spec：PASS
|
||||
|
||||
`packaging/doctor_workstation.spec` 现在：
|
||||
|
||||
- 显式 hidden import：
|
||||
- `PySide6.QtMultimedia`
|
||||
- `PySide6.QtMultimediaWidgets`
|
||||
- 继续显式收集 QtWebEngine 模块；
|
||||
- 将 `video_companion/dist` 放入 `video_companion_dist`；
|
||||
- 要求 `packaging/runtime_media_smoke.py` 必须存在；
|
||||
- 以 `runtime_hooks=[str(MEDIA_SMOKE_HOOK)]` 安装媒体 gate。
|
||||
|
||||
当前 PyInstaller 6.22 的官方 `hook-PySide6.QtMultimedia.py` 会追加 Widgets 模块，Qt6 module mapping 会收集 `plugins/multimedia`，与本 spec 的显式 imports 一致。
|
||||
|
||||
### 2. `--media-smoke-test`：PASS
|
||||
|
||||
`packaging/runtime_media_smoke.py` 作为 runtime hook，在普通启动时无副作用；仅当 argv 含 `--media-smoke-test` 时才在应用入口前执行：
|
||||
|
||||
- 导入 `QMediaPlayer`、`QAudioOutput`、`QMediaFormat`、`QVideoWidget`；
|
||||
- 创建并连接 player/audio/video 对象；
|
||||
- `player.isAvailable()` 必须为真；
|
||||
- Decode 模式至少暴露一种支持格式；
|
||||
- 显示 16×16 offscreen video widget，并完成一次 Qt event loop；
|
||||
- 任一错误固定返回 70，成功返回 0。
|
||||
|
||||
独立测试验证了三种状态：普通 argv 惰性退出 0；隔离掉 site-packages 后媒体 argv 返回 70；当前 PySide6 环境 offscreen 实例化返回 0。
|
||||
|
||||
### 3. Windows build/package：PASS（静态与轻量合同）
|
||||
|
||||
`scripts/build_windows.ps1` 在 PyInstaller 后要求以下文件：
|
||||
|
||||
- `QtMultimedia.pyd`
|
||||
- `QtMultimediaWidgets.pyd`
|
||||
- `Qt6Multimedia.dll`
|
||||
- `Qt6MultimediaWidgets.dll`
|
||||
- `plugins/multimedia/ffmpegmediaplugin.dll`
|
||||
- `plugins/multimedia/windowsmediaplugin.dll`
|
||||
|
||||
随后先运行 `--media-smoke-test`，再运行原 `--smoke-test`；两者均沿用隔离配置目录、loopback-only proxy、offscreen、30 秒超时、退出码和未捕获异常日志检查。
|
||||
|
||||
`scripts/package_windows.ps1` 把 runtime hook 加入 required files，调用 build 之后才复制 release launcher、压缩 ZIP 和生成 SHA-256。`Build_DoctorWorkstation.bat -ValidateOnly` 本轮通过。
|
||||
|
||||
### 4. macOS build/package：PASS（静态与轻量合同）
|
||||
|
||||
`scripts/build_macos.sh` 在成功前要求：
|
||||
|
||||
- `PySide6.QtMultimedia` 与 `QtMultimediaWidgets` Python `.so`；
|
||||
- 对应 framework，或适配 dylib 布局的后备检查；
|
||||
- `plugins/multimedia` 目录；
|
||||
- 至少一个 `*mediaplugin*.dylib/.so` backend；
|
||||
- QtWebEngine helper/resources、companion 与主可执行文件。
|
||||
|
||||
之后执行 `codesign --verify`，再顺序运行媒体 smoke 和应用 smoke。`scripts/package_macos.sh` 在准备依赖前先运行入口合同，并只在 build 全部成功后用 `ditto` 归档和计算哈希。
|
||||
|
||||
这些路径模式与当前 PySide6/PyInstaller 的 macOS framework/plugin 布局相容；最终仍需原生构建确认。
|
||||
|
||||
### 5. macOS Git executable mode：PASS
|
||||
|
||||
以下 9 个文件的 index mode 本轮均为 `100755`：
|
||||
|
||||
1. `package_macos.command`
|
||||
2. `run_macos.command`
|
||||
3. `一键打包.command`
|
||||
4. `一键运行.command`
|
||||
5. `scripts/build_macos.sh`
|
||||
6. `scripts/check_macos_entrypoints.sh`
|
||||
7. `scripts/macos_helpers.sh`
|
||||
8. `scripts/package_macos.sh`
|
||||
9. `scripts/run_macos.sh`
|
||||
|
||||
`scripts/check_macos_entrypoints.sh` 已将自身纳入 operational files，逐个执行 `bash -n`、检查实际 `-x`，在 Git 工作树中还读取 index mode 并要求 `100755`。本轮 Git Bash 合同执行通过。
|
||||
|
||||
### 6. README 与 `.env`：PASS
|
||||
|
||||
- 根 README 正确区分 `build_*`（只生成/验证 onedir 或 `.app`）和根/package 入口（生成版本 ZIP 与哈希）。
|
||||
- Windows/macOS 一键打包描述已包含 QtWebEngine/QtMultimedia 文件门禁与两个冻结 smoke。
|
||||
- README 明确 macOS 操作文件必须以 mode `100755` 跟踪。
|
||||
- `.env.example` 与 README 明确该文件不进入 ZIP/`.app`；生产配置应由受控 launcher/MDM/进程环境注入。
|
||||
- 文档明确禁止把密码、token、UserSig、TRTC SecretKey 等凭据放进 `.env` 或发布包。
|
||||
|
||||
### 7. 输出合同：PASS（待新构建兑现）
|
||||
|
||||
输出命名未被修复破坏：
|
||||
|
||||
- Windows onedir：`dist/DoctorWorkstation/`
|
||||
- Windows ZIP：`dist/DoctorWorkstation-Windows-x64-<version>.zip`
|
||||
- Windows checksum：`dist/SHA256SUMS.txt`
|
||||
- macOS bundle：`dist/DoctorWorkstation.app`
|
||||
- macOS ZIP：`dist/DoctorWorkstation-macOS-{arm64|x64}-<version>.zip`
|
||||
- macOS checksum：`<zip>.sha256`
|
||||
|
||||
两个 package 流程都位于 build/gate 之后，失败不会进入新的归档步骤。
|
||||
|
||||
## 本轮实际执行的轻量检查
|
||||
|
||||
| 检查 | 结果 |
|
||||
|---|---:|
|
||||
| Windows 三份 PowerShell parser | PASS |
|
||||
| `Build_DoctorWorkstation.bat -ValidateOnly` | PASS |
|
||||
| 全部 macOS shell/command `bash -n` | PASS |
|
||||
| `scripts/check_macos_entrypoints.sh`（含 index mode） | PASS |
|
||||
| packaging media gate + one-click + entrypoint pytest | **10 passed** |
|
||||
| runtime hook/packaging test Ruff | PASS |
|
||||
| relevant tracked diff whitespace check | PASS |
|
||||
|
||||
pytest 首次执行曾因沙箱无权枚举系统 `pytest-of-pc` 临时目录而产生 1 个 setup error；改用工作区内独立临时目录重跑后 10 项全部通过，并已安全清理该目录。该环境错误不是代码失败。
|
||||
|
||||
## 主代理下一步
|
||||
|
||||
### 当前 Windows 工作树
|
||||
|
||||
```powershell
|
||||
.\Build_DoctorWorkstation.bat -ValidateOnly
|
||||
.\Build_DoctorWorkstation.bat
|
||||
```
|
||||
|
||||
完成后不要只看退出码；确认新 onedir/ZIP 时间戳、媒体文件、两个 smoke gate 日志及 SHA-256，并在无开发环境机器上做真实媒体/TRTC 验收。
|
||||
|
||||
### 原生 macOS
|
||||
|
||||
先确保目标机器拿到与当前工作树等价的全部 intended files（正式发布推荐先形成 commit/tag），然后：
|
||||
|
||||
```bash
|
||||
git ls-files --stage -- '*.command' 'scripts/*.sh'
|
||||
CI=1 DOCTOR_NONINTERACTIVE=1 bash scripts/check_macos_entrypoints.sh
|
||||
export MACOS_CODESIGN_IDENTITY='Developer ID Application: <组织名称> (<TEAMID>)'
|
||||
./一键打包.command
|
||||
```
|
||||
|
||||
随后验证 `.app` 架构、媒体 framework/plugin、两个 smoke gate、签名、公证/staple、最终 ZIP 哈希和真实设备/TRTC 流程。
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
# 发布打包门禁修复报告
|
||||
|
||||
日期：2026-08-11（Asia/Shanghai）
|
||||
范围：仅 PyInstaller spec、打包/构建/入口检查脚本、发布说明、环境示例与打包专属测试；未修改 UI、core 或 repository，未执行完整 PyInstaller。
|
||||
|
||||
## 结论
|
||||
|
||||
`release_packaging_audit.md` 中除 Git 工作树/提交状态和 macOS Git executable mode 本身之外的 QtMultimedia 发布门禁已经落到代码与合同测试中：
|
||||
|
||||
- spec 显式列出 `PySide6.QtMultimedia`、`PySide6.QtMultimediaWidgets`，从而强制触发 PyInstaller 官方 PySide6 hooks，收集对应 Python 扩展、`Qt6Multimedia`/`Qt6MultimediaWidgets` DLL、dylib/framework、`plugins/multimedia` 以及平台媒体后端。
|
||||
- 新增 PyInstaller runtime hook：冻结程序收到 `--media-smoke-test` 时，在进入正常应用入口前真实导入两个媒体模块，实例化 `QMediaPlayer`、`QAudioOutput`、`QVideoWidget`，连接音视频输出，确认媒体 backend 可用且至少暴露一种解码格式，并在 `offscreen` Qt 事件循环中退出。任一导入、链接、backend 或事件循环失败均返回非零（固定失败码 70）。
|
||||
- Windows 构建在成功前要求 `QtMultimedia.pyd`、`QtMultimediaWidgets.pyd`、`Qt6Multimedia.dll`、`Qt6MultimediaWidgets.dll`、`plugins/multimedia/ffmpegmediaplugin.dll` 和 `windowsmediaplugin.dll`，随后依次运行冻结媒体门禁与原应用 `--smoke-test`。
|
||||
- macOS 构建在成功前要求两个 Python 扩展、两个对应 framework/dylib、`plugins/multimedia` 与至少一个 `*mediaplugin*` backend，随后依次运行相同两项冻结门禁。
|
||||
- 两个平台的一键 package 入口仍先调用 build；只有 build 的文件门禁和两项冻结 smoke gate 全部通过后才归档 ZIP/生成 SHA-256。
|
||||
- `.env.example` 和 README 已明确：环境示例不会进入发布包，生产配置应由受控启动器/设备管理/进程环境注入，发布包不得包含密码、token、UserSig、TRTC SecretKey 等凭据。
|
||||
|
||||
## 主要文件
|
||||
|
||||
- `packaging/doctor_workstation.spec`
|
||||
- `packaging/runtime_media_smoke.py`
|
||||
- `scripts/build_windows.ps1`
|
||||
- `scripts/package_windows.ps1`
|
||||
- `scripts/build_macos.sh`
|
||||
- `scripts/package_macos.sh`
|
||||
- `scripts/check_macos_entrypoints.sh`
|
||||
- `packaging/README.md`
|
||||
- `README.md`
|
||||
- `.env.example`
|
||||
- `tests/test_packaging_media_gate.py`
|
||||
|
||||
## macOS executable mode：必须由根代理完成
|
||||
|
||||
本任务遵守约束，没有执行 `git add`、`git update-index` 或 `git commit`。当前 Git index 仍把下列 9 个入口记为 `100644`；根代理必须把每个文件的 index mode 精确改为 `100755`，并把 mode 变化纳入最终发布提交：
|
||||
|
||||
1. `run_macos.command` → `100755`
|
||||
2. `package_macos.command` → `100755`
|
||||
3. `一键运行.command` → `100755`
|
||||
4. `一键打包.command` → `100755`
|
||||
5. `scripts/build_macos.sh` → `100755`
|
||||
6. `scripts/package_macos.sh` → `100755`
|
||||
7. `scripts/run_macos.sh` → `100755`
|
||||
8. `scripts/macos_helpers.sh` → `100755`
|
||||
9. `scripts/check_macos_entrypoints.sh` → `100755`
|
||||
|
||||
根代理可从项目根目录执行以下精确操作（本代理未执行）：
|
||||
|
||||
```powershell
|
||||
git update-index --chmod=+x -- run_macos.command package_macos.command `
|
||||
"一键运行.command" "一键打包.command" `
|
||||
scripts/build_macos.sh scripts/package_macos.sh scripts/run_macos.sh `
|
||||
scripts/macos_helpers.sh scripts/check_macos_entrypoints.sh
|
||||
git ls-files --stage -- '*.command' 'scripts/*.sh'
|
||||
```
|
||||
|
||||
第二条命令对上述 9 个文件必须全部显示 `100755`。`scripts/check_macos_entrypoints.sh` 现在同时检查实际 `-x` 与 Git index mode，因此 Windows/Git Bash 将文件视为可执行也不能再掩盖 `100644`。
|
||||
|
||||
## 已执行的轻量验证
|
||||
|
||||
- 源环境媒体门禁（`QT_QPA_PLATFORM=offscreen`）：PASS；实际播放器、音频输出、VideoWidget 和 decoder backend 均成功创建。
|
||||
- 缺少 site-packages 的隔离进程：PASS；`--media-smoke-test` 返回 70，证明缺组件不会误报成功。
|
||||
- PowerShell parser：`build_windows.ps1`、`package_windows.ps1`、`run_windows.ps1` PASS。
|
||||
- Git Bash `bash -n`：所有 macOS build/package/run/check/helper 与四个 `.command` PASS。
|
||||
- 打包合同测试：`tests/test_packaging_media_gate.py`、`tests/test_one_click_entrypoints.py`、`tests/test_entrypoint.py`，10 passed。
|
||||
- Ruff：新增 runtime hook 与打包测试 PASS。
|
||||
- `git diff --check`：PASS。
|
||||
|
||||
## 仍需原生构建机完成的发布验收
|
||||
|
||||
按任务约束，本次没有运行完整 PyInstaller。最终发布仍必须：
|
||||
|
||||
- 在 Windows x64 原生构建机运行一键打包，确认新 onedir/ZIP 的文件门禁和冻结 `--media-smoke-test` 均通过，替换旧 `dist` 证据；
|
||||
- 在目标架构 macOS 原生构建机运行一键打包，确认 `.app` framework/plugin 布局、codesign、摄像头/麦克风权限、notarization/stapling；
|
||||
- 使用批准分发的 MP4（产品需要时再加 HLS）完成实际解码、画面渲染和音频输出验收；媒体 smoke gate 是 backend 准入，不替代真实播放；
|
||||
- 由发布负责人审阅工作树，只从确定的 commit/tag 构建。Git 输入/提交状态属于本任务明确排除项。
|
||||
|
||||
补充：仓库指令引用的 `.trellis/workflow.md` 与 `.trellis/spec/` 在当前工作区不存在，因此本次无法执行 Trellis 规范审查；这不影响上述脚本合同结果。
|
||||
Reference in New Issue
Block a user