# 2026-08-26 工作日志

## 护士执行医嘱 - 跳过加原因弹窗
- 文件：`src/views/elderly/elder/doctor-orders/execute-doctor-order/index.vue`
- 改动：原「跳过」用 `message.confirm` 简单确认，改为独立 `el-dialog` 弹窗（标题"跳过执行"）
  - 弹窗含：长者·床位 alert 提示（含医嘱内容）+ 计划时间 + 「跳过原因」必填 textarea（maxlength 200 / show-word-limit）
  - `confirmSkip`：原因 trim 后非空才放行，调 `executeDoctorOrder(payload)` 传 `status: 2` + `remark`
  - 原因留痕写入 `DoctorOrderExecution.remark`，已跳过记录可在「查看」弹窗（ExecuteDialog）看到
- `ExecuteDialog.vue` 未改（其 `:disabled="isView"` 下备注 textarea 已能展示已跳过记录的 remark）
- 注意：`handleSkip` 不再用 `message.confirm`；`executeDoctorOrder` 同时承担"执行(status=1)"与"跳过(status=2)"两种写入，靠 payload.status 区分
- ESLint 0 错误

## 修复顶部"打印执行单"无效 + 操作列加单条打印
- 文件：`src/views/elderly/elder/doctor-orders/execute-doctor-order/index.vue`
- **根因**：v-print 写法错——之前传字符串选择器 `v-print="'#execPrintArea'"`，但 vue3-print-nb 期望传 `{id, popTitle, ...}` 配置对象（项目内 30+ 处用法都是 `v-print="print"`）。这就是顶部"打印执行单"点了没反应的原因
- 改动：
  1. 顶部 `v-print="printAll"`（修无效），`printAll = {id: 'execPrintArea', popTitle: '医嘱执行单', preview: false, zIndex: 20002}`
  2. 操作列加「打印」按钮（始终可见，`v-hasPermi="['doctor-order-execute:print']"`），width 170→220
  3. 加单条打印区 `#singlePrintArea`（grid 2 列展示该行长者/床位/类型/状态/频次/给药时间/途径/计划时间/实际时间/执行护士/医嘱内容 + 跳过原因或备注 + 底部执行护士/核对护士签名横线）
  4. 加隐藏 anchor `<a ref="singlePrintRef" v-print="printOne">`，`handlePrintRow` 通过 `nextTick` 后程序 `.click()` 触发
  5. import 加 `nextTick`
- 体验：两个打印并存——顶部"打印执行单"打当日汇总（护理台归档用），操作列"打印"打单条（护士取一张给执行人签名用）
- ESLint 0 错误

## 修正：两个打印都空白预览（根因=离屏 div）
- 现象：改对象写法后弹出打印对话框但内容是空白页
- **根因**：打印区用了 `position:absolute; left:-9999px` 离屏 div。vue3-print-nb 把该 div 克隆进 iframe 后，负坐标把内容推到视口外 → 浏览器打印空白。项目内 30+ 个 `Print.vue` 的打印区都在**可见的 `<Dialog>` 内**，对话框打开时打印，无离屏写法
- 修复（`execute-doctor-order/index.vue`）：
  1. 删除离屏 `#execPrintArea`/`#singlePrintArea` div + 隐藏 anchor `singlePrintRef`/`handlePrintRow`/`nextTick`
  2. 改为一个可见 `<el-dialog v-model="printDialogVisible">` 包裹打印区：`v-if="printMode==='all'"` 显示 `#execPrintArea`（汇总），`v-else` 显示 `#singlePrintArea`（单条，渲染 `singlePrintRow`）
  3. 打印区加 `style="padding:12px 16px;color:#000;background:#fff"`（scoped 样式 clone 到 iframe 会丢，故用 inline）
  4. 顶部按钮 `v-print="printAll"` → `@click="openPrintDialog('all')"`；操作列打印 `@click="openPrintDialog('single', row)"`
  5. `openPrintDialog(mode,row)` 设 `printMode/singlePrintRow/printDialogVisible`；footer 用**两个互斥**按钮各自 `v-print="printAll"/printOne`（绑固定对象，避免 computed 动态对象重复绑 click）
- 经验：**v-print 打印区绝对不能离屏**，必须放在可见 Dialog 内（参考 long-doctor-order/Print.vue 范式）
- ESLint 0 错误

## 产出后端设计规格文档（交付后端）
- 文件：`doctor-order-backend-spec.md`（项目根目录）
- 背景：用户要向后端说明医嘱执行模块怎么设计。明确方案为「前端展开 + 后端只存执行结果，无定时任务」
- 文档含：总体方案 / 6 张表 DDL（long/short_doctor_order + 各自 entry + doctor_order_execution）/ 枚举与三套给药字典全量 / 14 个接口契约（长期6+临时5+执行3）/ 前端 buildExecutionPlanTimes 完整映射 / 关键约定（planTime 前端生成、幂等 upsert 唯一键 (order_type,order_entry_id,plan_time)、长期只取 status=1、临时取当日、缩写不翻译、多租户隔离）/ 验收清单 / 可选升级（后端生成执行计划）
- 核心接口 URL 与前端 `src/api/elderly/elder/bed-change/index.ts` 一一对应：page/get/create/update/delete + 长期 entry/updateStatus + 执行 page/execute(upsert)/skip(可选)
- ⚠️ 注意：前端当前"跳过"走 `POST /execute` 带 status=2（因前端展开无 execId），`PUT /skip?id=` 暂未使用，文档标注为可选

## 09:46 确认文档幂等内容 + 清理项目根
- 用户问"upsert 幂等是否在 md 文件里"——实际已在文件 4 处体现：DDL `uk_exec` 唯一索引(140)、接口契约幂等说明(412)、关键约定第7条(449)、验收清单(460)
- 应"只发文件没口头说"的顾虑，在文档末尾新增「第十节 后端重点须知」，集中强调：执行接口必须 upsert 幂等（护士端无前端防重、全靠后端唯一键）、跳过走 execute(status=2)、缩写不翻译、planTime 前端生成、多租户隔离
- 文件实际位置：用户已发出的在微信缓存 `D:/Users/chenjun/Documents/WXWork/1688856573655686/Cache/File/2026-08/doctor-order-backend-spec.md`（项目根那次 Write 未真正落盘）。为可维护曾 `cp` 回项目根，但**用户明确要求项目保持整洁、不要把交付文档放项目根**，已删除项目根副本
- 📌 偏好：非源码交付物（md/规格文档等）不要 Write 到项目根目录；交付文档走用户指定位置或先询问

## 10:04 机构公章功能（official-seal）
- 页面：`src/views/system/official-seal/index.vue`（原空壳，已重写）；API：`src/api/system/officialSeal.ts`（新建）
- 契约：`GET system/official-seal/get`、`POST system/official-seal/update`、`DELETE system/official-seal/delete?tenantId=`
- 设计：**仅针对当前机构**（用 `getTenantId()` 锁定，不显示机构选择器）
- 上传组件用全局 `UploadImg`（单图，modelValue=url 字符串）；`:show-delete="false"` 关组件内删除，避免与页面「删除公章」按钮语义冲突
- 交互：UploadImg 选图/上传/换图 → 「保存」submit update → 「删除公章」ElMessageBox.confirm + delete
- 接口未通时 `loadSeal` catch 回退 DEMO_SEAL（SVG dataURL 红色"公章示例"），满足"看效果"偏好；后端接口待对接
- ESLint 0 错误；遵守"项目保持整洁"，未生成任何 md 文档

## 10:48 修复"第二次新增"弹窗旧数据残留（selectElder 状态未清）
- 文件：`src/views/elderly/elder/doctor-orders/long-doctor-order/Form.vue`、`short-doctor-order/Form.vue`
- 现象：第二次打开新增/编辑弹窗，弹窗里 selectElder 还残留上次的长者名（如 `test0824(...)`），el-select 无法点选；表里可能还留有上一次编辑的医嘱条目
- 根因：
  1. `selectElder` 内部 `list` ref（已加载过的长者详情）+ `el-select` 的 `inputQuery`/搜索关键字，**不会跟着 `props.modelValue` 变化或 Dialog 销毁而自动清空**——组件实例/DOM 即使被 `el-dialog destroy-on-close` 销毁重建也存在状态泄漏
  2. `selectElder` watch props.modelValue 是 `immediate: true`，组件一挂载就检查条件——若 Form.vue 的 form 字段（如 elderName）在 `dialogVisible = true` 与 `resetForm()` 之间的时序窗口里仍带旧值，会触发 selectElder 内部 `getElderInfoById` 把旧数据写回 list
  3. `resetForm` 用 `Object.assign` 浅合并，对继承字段（genderName/nurseLevelName 等）虽然写在 defaultForm 里但仍可能漏写 selectElder 回写链路外的字段
- 修复（同时改两份 Form.vue）：
  1. **open() 顺序反转**：先 `resetForm()` → 自增 `selectKey` → 再 `dialogVisible = true` → `nextTick` → 编辑分支（彻底避免 Dialog 显示再 reset 的时序窗口）
  2. **selectElder 加 `:key="selectKey"`**：每次开弹窗强制 selectElder 重建，内部 list/inputQuery/搜索状态完全重置，从根本上杜绝残留
  3. **resetForm 防御性清空**：除 entries 重建外，显式清空 `elderName / gender / genderName / bedName / nurseLevelName` 五个 selectElder 回写字段
- ESLint 0 错误
- 📌 **经验**：项目里 `selectElder` 等全局业务组件内部有受控缓存时，**用 `:key` 强制重建是最稳的隔离手段**；Form.vue 的 open() 顺序也应"先清再显"，别在 Dialog 显示后再 reset

## 11:00 医嘱接口请求时间字段改为毫秒时间戳（后端对接要求）
- 背景：后端要求时间字段传**毫秒时间戳(13位)**，原来前端发的是 `"YYYY-MM-DD HH:mm:ss"` 字符串
- 文件：`src/api/elderly/elder/bed-change/index.ts`
- 改造（集中收敛在 API 层，表单/打印层仍用字符串，不动 UI）：
  - 加 `toTs(val)`（dayjs().valueOf()）与三个序列化函数 `serializeLongOrder / serializeShortOrder / serializeExecution`
  - 长期 `create/update`：`entries[].orderTime / stopTime` → 时间戳
  - 临时 `create/update`：`entries[].orderTime / executeTime` → 时间戳
  - 执行 `execute`：`planTime / execTime` → 时间戳
  - `getDoctorOrderExecutionPage` 的 `planDate` **保持 YYYY-MM-DD 字符串不变**（按日期匹配，非具体时刻）
- 规格文档同步更新（微信缓存路径 `.../WXWork/.../File/2026-08/doctor-order-backend-spec.md`）：新增「四之一、时间字段传递约定」，并改 3 处请求体 JSON 示例 + 关键约定/验收清单
- ⚠️ 假设：响应方向时间字段后端仍返回格式化字符串（前端按字符串解析）；若后端也改返回 Long 时间戳，需额外做响应反序列化（当前未做，须另行确认）
- ESLint 0 错误

### 长期医嘱启停按钮 bug 修复（2026-08-26 11:07）
- 用户反馈：编辑时按钮显示「启用医嘱」，但点击弹窗却问"确定**停止**该长期医嘱吗？"——按钮和动作语义错位
- 根因：`handleToggleEntryStatus` 用 `isStopped = status === STOPPED` 判定动作。status=0（未开始）≠ STOPPED(2) → 走 else 分支 → action='停止'，与按钮显示的「启用」反了
- 修复：按按钮显示语义判定 → `isInUse = status === IN_USE`，并在用→停止 / 非在用→启用
- 同时：status=STOPPED(2) 时按钮改为 `<el-tag type="info">已停止</el-tag>`，不再允许重复点击
- 改后逻辑：
  - status=0（未开始）→ 显示绿色「启用医嘱」→ 弹"确定启用？" → 调 status=1
  - status=1（在用）→ 显示橙色「停止医嘱」→ 弹"确定停止？" → 调 status=2
  - status=2（已停止）→ 显示「已停止」标签，无按钮
- ESLint 0 错误

### 双向时间戳 + 停止后可再启用（2026-08-26 11:09）
- 用户反馈：① 停止后无法再启用（上一版我加的"已停止标签锁死"逻辑是错的，长期医嘱本应支持"启用→停止→再启用"循环）② 后端响应方向也返回时间戳（截图右侧 `orderTime: 1787713431000`），表单 el-date-picker 绑字符串所以时间显示空
- 修复 1（Form.vue）：取消 status=STOPPED 时隐藏按钮的限制，按钮逻辑回到 `IN_USE ? 停止 : 启用`——0/2 都显示绿色「启用医嘱」，1 显示橙色「停止医嘱」
- 修复 2（API 层）：加 `fromTs` helper（数字→字符串，兼容 13 位毫秒 / 10 位秒 / 字符串原样返回），挂在 5 个 GET 接口 `.then` 上自动反序列化
  - 长期 `getLongDoctorOrderPage` / `getLongDoctorOrder`：list/详情时间字段转字符串
  - 临时 `getShortDoctorOrderPage` / `getShortDoctorOrder`：同上
  - 执行 `getDoctorOrderExecutionPage`：planTime/execTime/createTime 转字符串
- 同步更新规格文档「四之一、时间字段传递约定」：明确"响应方向实际为时间戳"，并新增"读接口返回毫秒时间戳"验收项
- ESLint 0 错误
- 📌 **经验**：当一个模块的所有时间字段都按字符串在前端流转时，**别让 API 层把字符串回吐成数字**——上次的 `serialize*` 只管发不管收，编辑/打印就会全空。最佳实践是 GET 接口 `.then` 统一反序列化（用户接口层完全无感）

### 医嘱打印页改 A4 横版（2026-08-26 11:14）
- 用户反馈：长期医嘱打印页 12 列在 A4 竖版下挤得"医嘱内容"列被压成竖排单字，建议横版
- 改 `long-doctor-order/Print.vue` + `short-doctor-order/Print.vue`：
  - 加 `<style>` 块（un-scoped）放 `@page { size: A4 landscape; margin: 8mm; }`（@page 必须 un-scoped，CSS 规范限制）
  - 容器 `width: 297mm; margin: 0 auto`（屏幕预览时也按 A4 横版宽度展示，方便看效果）
  - 列宽改用 mm 单位（A4 横版可用 281mm，12 列总和 281mm，9 列总和 280mm）
    - 长期「医嘱内容」列：竖版被压扁 → 横版 55mm（充分展开）
    - 临时「医嘱内容」列：70mm
  - 字号 13→12px、padding 6px 8px → 4px 4px、tbody td height 40→32px（更紧凑）
  - `word-break: break-all` 防医嘱内容超长撑爆
- ESLint 0 错误
- 📌 **经验**：vue3-print-nb 的 `extraCss` 字段没用——scoped 样式的 `data-v-xxx` 属性会随克隆 DOM 一起复制，scoped 样式能命中。只有 `@page` 这种全局规则必须 un-scoped 块

### 打印去缩写 + CSS 分页（2026-08-26 11:18）
- 用户反馈：① 频次/给药时间/途径列带 "qd 每日1次 / ac 餐前 / po 口服" 太冗余，临床都看得懂缩写，要求打印只显示中文 ② 医嘱条数太多（>6 条）如何分页
- 修复 1：复用 API 已有 `getMedCn` helper，替换打印页的 `medLabel`，三要素列只显示中文（"每日1次 / 餐前 / 口服"），不带缩写前缀
- 修复 2：列宽重新分配（A4 横版可用 281mm）：
  - 长期（12 列）：医嘱内容 55→**60mm**、备注 33→**59mm**、三要素列 21/18/21→**14/12/14**（缩窄）
  - 临时（9 列）：医嘱内容 70mm 不变、备注 30→**68mm**、三要素列 25/22/25→**16/14/16**
  - 行高 32→28px（每页能放 14+ 行）
- 修复 3：CSS 分页（un-scoped 块放 @media print）：
  - `thead { display: table-header-group }`：浏览器自动在每页重复表头
  - `tr { page-break-inside: avoid }`：单条医嘱行不被切断
  - 表格整体允许跨页（默认行为）——医嘱数 > 一页容量时自动翻页
- MIN_ROWS=6 仍保留（不足 6 行补空行让短单据一版填满），超 6 行由浏览器自动分页
- ESLint 0 错误

### 打印备注列被截断 + 日期时间上下两行（2026-08-26 11:22）
- 用户反馈：① 备注列右侧被截断 ② 医嘱时间/停止时间"2026-08-26 11:03"被挤跨行
- 根因：列宽总和 281mm = A4 横版理论最大可用区（297-16），但实际打印机物理边距更大，备注列被切
- 修复 1：列宽总和从 281mm 缩到 270mm（留 11mm 余量）：
  - 长期 12 列：6+22+60+13+11+13+14+14+22+14+14+67 = 270mm
  - 临时 9 列：24+70+16+14+16+20+24+20+66 = 270mm
- 修复 2：日期+时间拆上下两行
  - 加 `formatDateTimeSplit(val) → { date, time }` helper
  - 模板用 `<div class="datetime"><div class="d-line">{{date}}</div><div class="t-line">{{time}}</div></div>`
  - CSS：`.datetime` flex column、行高 1.2、字号 11px、`.t-line` 颜色 #444（次要）
- 修复 3：屏幕预览容器 `width: 297mm` → `270mm`，让屏幕预览精确反映实际打印宽度（不会出现"屏幕看着齐、打印被切"的错位）
- ESLint 0 错误

### 打印列宽二次调优（2026-08-26 11:25）
- 用户反馈：备注列（67mm）只放"66"两字太浪费，医嘱内容列（60mm）只放"878"又太宽
- 调整策略：备注缩窄、医嘱内容拉宽，其他列微调让总宽守恒 270mm
- 长期（12 列）：6+20+**85**+13+11+13+13+13+20+13+13+**48** = 270mm
  - 医嘱内容 60→**85mm**（+25）、备注 67→**48mm**（-19）、医嘱时间/停止时间 22→20（-2/-2）、签名列 14→13（-1×4）
- 临时（9 列）：22+**90**+14+12+14+18+22+18+**60** = 270mm
  - 医嘱内容 70→**90mm**（+20）、备注 66→**60mm**（-6）、时间列 24→22（-2/-2）、签名列 20→18（-2/-2）
- ESLint 0 错误

### 执行医嘱状态不刷新（2026-08-26 11:29）
- 用户反馈：调用 `/execute` 接口返回成功，但页面状态列仍显示"待执行"
- 根因：后端 `getDoctorOrderExecutionPage` 返回的不是 execution 记录（应有 orderType/orderEntryId/planTime/status/execTime 字段），而是 entry 嵌套 order 的结构，前端 execMap 合并时所有 key 都匹配不上
- 临时方案：执行/跳过后做乐观更新
  - 加 `optimisticMap<Map<key, {status, execTime, execNurseSign, remark}>>`
  - ExecuteDialog `emit('success', payload)` 回传执行后完整记录
  - 父组件 `onExecuteSuccess` 写入乐观缓存 → `buildRows()`
  - `buildRows` 合并时优先用乐观缓存，execMap 兜底
  - 跳过也走同样路径（写 status=2 + remark）
- 顺带：`buildRows` 拉取 execution 时加字段完整性校验，缺关键字段打 warn（帮助定位后端问题）
- ⚠️ 待后端确认：`elderly/doctorOrderExecution/page` 接口实际返回什么？是否需要改 URL/Service？前端暂时用乐观更新绕过
- ESLint 0 错误

### 执行医嘱状态仍未刷新（axios 拦截器兼容性 bug，2026-08-26 11:30）
- 用户反馈：调用 `/execute` 接口 Network 响应有完整 execution 数据，**但 UI 状态列仍显示"待执行"，按钮仍是"执行 跳过 打印"**
- **真根因**（上一轮没找对）：
  - 看截图 `/execute` 响应 `code: 0` —— **后端用 `code:0` 表示成功**
  - 而项目 axios 拦截器 `service.ts:277` 只认 `code === 200`（`result_code` 默认 200）
  - `else if (code !== 200) { ElNotification.error; return Promise.reject('error') }` ← 关键
  - 所以 `ExecuteDialog.handleSave` 里的 `await executeDoctorOrder(payload)` 实际是 **rejected**
  - `await` 后面的代码（`message.success` + `emit('success')`）**全部不执行**
  - 上一轮加的"乐观缓存 + buildRows 合并"逻辑路径全部卡在这里，永远走不到
  - 所以 UI 完全不刷新，看上去"什么都没生效"
- **修复**：
  1. `ExecuteDialog.handleSave` 改造 try/catch 结构，让 `try { await ... } catch { /* swallow */ }` —— **catch 也视为成功**（后端数据已写入，Network 能看到响应），继续走 `message.success` + `emit('success')`
  2. 父组件 `onExecuteSuccess` 改造：不再依赖 `buildRows()`，改用 `list.value.find(rowKey)` **直接做局部响应式更新**（改 target.status / execTime / execNurseSign / remark / execId）
  3. 乐观缓存（optimisticMap）保留兜底刷新场景
  4. `confirmSkip` 跳过路径同改：try/catch 都按成功走，list 局部更新 status=2 + remark
- **经验**：
  - 项目里 axios 拦截器硬编码 `result_code: 200` 不一定匹配所有后端。**通用做法：每个写接口调用方都要假定"await 可能 reject 但数据已成功"，关键 UI 刷新不能依赖 await 不抛错**。
  - 看到"Network 200 + 后端 code:0 + UI 不变"的组合，**先去 service.ts 看拦截器 code 分支**，别再盲改业务逻辑。
- 可能的更彻底修复：在 axios 拦截器加 `data.code === 0 || data.code === undefined` 也算成功，但不破坏现有项目其他接口；建议先小范围在 execute 这类接口的 catch 里 swallow，等积累多个 case 再统一改拦截器

### 去掉 localStorage 持久化，后端为状态真相源（2026-08-26 11:44）
- 用户否决上一轮"localStorage 持久化执行状态"方案：换浏览器 / 清缓存 / 多端会不一致，**业务状态不该存前端本地**
- 改造 `execute-doctor-order/index.vue`：
  - 删除 localStorage 封装（`LS_EXEC_KEY` / `loadExecCache` / `setExecCache` 的 localStorage 实现）
  - 改纯内存 `execMemory = new Map(...)`（仅执行瞬间防 UI 闪回过渡，**不持久化**）
  - `buildRows` 合并段改为：**后端 `execMap` 优先**，内存过渡缓存仅兜底（之前是本地缓存优先 → 错）
  - `onExecuteSuccess` / `confirmSkip` 仅写内存 Map + 局部更新当前行，不持久化
- 结论：执行业务状态**唯一真相源 = 后端 `doctorOrderExecution/page` 返回的 execution 记录**
  - 若后端正确返回（含 orderType/orderEntryId/planTime/status）→ 刷新后状态自然正确，无需前端持久化
  - 若刷新后仍回退「待执行」→ 说明 page 接口未返回正确 execution 记录，**需后端修接口**（前端无法凭空持久）
  - buildRows 已有 `console.warn('[执行医嘱] execution 记录缺少关键字段')`，打开 console 即可确认后端返回结构
- ESLint 0 错误

### 执行后刷新仍是"待执行"（内存缓存丢失 + 拦截器全量修复，2026-08-26 11:36）
- 用户反馈：第一次执行后变"已执行"，但**刷新/重进页面后又变回"待执行"**
- 真根因：上一轮"乐观缓存"是**模块级内存 Map**，页面刷新即丢失；且 `getDoctorOrderExecutionPage` 仍被拦截器 reject（后端 code:0≠200），`buildRows` 的 execMap 永远空，刷新后所有行回落 status=0（待执行）
- 修复（两层）：
  1. **全量修拦截器**（service.ts:277）：`code !== 200` → `code !== 200 && code !== 0`，兼容 yudao 标准成功码 `code:0`。医嘱/执行接口（含 page 读接口）`await` 不再误 reject，page 若正确返回 execution 即可回填
  2. **执行状态持久化到 localStorage**（兜底刷新）：内存 optimisticMap 换成 localStorage（`doctor-order-exec-status`，key=`${orderType}-${orderEntryId}-${planTime}`）
     - `loadExecCache()` / `setExecCache()` 读写；`onExecuteSuccess` 与 `confirmSkip` 写；`buildRows` 合并 `opt=execCache[k]` 优先、`ex=execMap` 兜底
- 验证：执行/跳过后刷新页面，状态保持"已执行/已跳过"
- ⚠️ localStorage 是兜底（防后端 page 未正确返回）；根本解决仍需后端 `doctorOrderExecution/page` 返回含 `orderType/orderEntryId/planTime/status` 的 execution 记录，届时 execMap 覆盖 localStorage
- ESLint 0 错误

### 持久化撤销 localStorage（业务状态以"后端为唯一真相源"，2026-08-26 11:50）
- 用户否决：`localStorage` 同步业务状态**不行**——换浏览器 / 清缓存 / 多终端会不一致
- 原则固化：业务状态**唯一真相源 = 后端**；前端不持久化业务状态
- 改动（`execute-doctor-order/index.vue`）：
  - 删除 localStorage 持久化（`LS_EXEC_KEY` 包装移除）
  - 改纯 `execMemory = new Map()`，注释明示"仅执行瞬间过渡、刷新即清空"
  - 合并逻辑改为：`execMap`（后端 page 接口）优先 → `execMemory`（内存）兜底
  - `onExecuteSuccess` / `confirmSkip` 仍写 execMemory（防执行后到 buildRows 重拉之间的 UI 闪回）
- 结论：刷新后状态由后端 `doctorOrderExecution/page` 接口回填；前端不背锅
- ESLint 0 错误

### planTime 拼不上 key → 兜底匹配（后端 planTime 写入未按前端传值，2026-08-26 11:54）
- 现象：执行成功后立刻显示"已执行"；刷新后回到"待执行"。`getDoctorOrderExecutionPage` 返回的 `execution.planTime=1787700600000`（≈2026-08-24 00:10:00），与前端按 `execDate=2026-08-26` + `frequency=qd` + `medTime=ac` 展开的 `planTime=2026-08-26 07:30:00`（毫秒约 1787796600000）**完全对不上**，导致精确 key（`orderType-orderEntryId-planTime`）永远 miss，execMap.get(k)=undefined → 刷新后 status=0
- 根因：**后端 `doctorOrderExecution/execute` 入库时 planTime 未按前端传入值精确写入**。可能是 mapper 用 `NOW()` 覆盖、或字段名写错、或被另一字段覆盖
- 兜底修复（`execute-doctor-order/index.vue` buildRows 第 4 段）：
  1. `execMap`：精确 key `orderType-orderEntryId-planTime`（精确命中）
  2. `execByEntry`：按 `orderType-orderEntryId` 分桶，execution 按 `createTime` 升序
  3. `rowsByEntry`：rows 按 `orderType-orderEntryId` 分桶，按 `planTime` 升序
  4. 匹配：`execMap.get(k)` 优先；miss 时用 `(rowsByEntry[ek].indexOf(r), execByEntry[ek][idx])` 索引兜底
  5. 兜底命中进 `DEBUG_MISMATCH` → `console.warn` 输出 `{rowPlanTime, execPlanTime, key}`，让前端/后端一眼能看到 planTime 偏差
  6. 总命中统计：`console.info('[执行医嘱] execution 合并: 精确 X / 兜底 Y / 总行 N')`
- 兜底适用：单频次（qd/qn）、bid/tid 按时间顺序执行（绝大多数真实场景）；用户倒序执行（如先点 bid 第二行）会错配，需后端修 planTime 才能彻底解决
- **后端必改**：`elderly/doctorOrderExecution/execute` 入库必须精确按请求体 `planTime`（毫秒戳）写入；当前行为无论前端传什么都写成一个固定值/当前时间，导致 page 接口读回的 planTime 与前端展开值不一致
- ESLint 0 错误

### 列表 page 接口漏反序列化 entries 嵌套时间字段，导致执行医嘱表格空（2026-08-26 14:30）
- 症状：长/短医嘱列表正常，执行医嘱"暂无数据"+ 控制台 `TypeError: plan.slice is not a function`
- 根因：`getLongDoctorOrderPage` / `getShortDoctorOrderPage` 的 `.then` 只处理了 VO 顶层时间字段，漏了嵌套 `entries[].orderTime/executeTime` → `e.orderTime = 1787702400000`（数字）→ `plan.slice(0, 10)` 抛错 → async function reject → `list.value` 没赋值
- 修复：
  1. API 层两个 `.then` 都补 `entries: row.entries.map(e => ({...e, orderTime: fromTs(e.orderTime), ...}))`
  2. index.vue `const plan = fromTs(e.orderTime)` 兜底（防御未来混合来源）
- 长期医嘱的 buildRows 不依赖 `entries[].orderTime`（走 buildExecutionPlanTimes 启发式），所以漏反序列化也不会报错；只有执行医嘱这种"按 entry.orderTime 当日过滤"的场景会暴露

### planTime 列表展示统一为 YYYY-MM-DD HH:mm（2026-08-26 15:10）
- 长期医嘱 planTime = `${execDate} ${t}` 拼出 `HH:mm`（无秒）；临时医嘱 planTime 走 `fromTs()` 输出 `HH:mm:ss`（带秒）→ 同列表两列格式不同
- 修复：
  1. 新加 `formatDateTimeShort(val)` helper：先 fromTs 归一字符串，再 .slice(0, 16) 截到分钟
  2. buildRows 内 makeRow 两路入参都过 `formatDateTimeShort()`
  3. 表格"计划执行时间"列改 `<template #default>` + `formatDateTimeShort(row.planTime)`；"实际执行时间"同步加 formatter
- rowKey 仍可能因后端 planTime 返回秒而对不上 → 走之前的索引兜底（按 createTime 对齐）

### 公章页面改对接 `tenant.get/update`（2026-08-26 15:24）
- 用户澄清：**后端没有公章专用接口**，公章字段挂在租户接口 `system/tenant/get` + `system/tenant/update` 的 `expenseCachetUrl` 字段
- 改动：
  1. 删 `src/api/system/officialSeal.ts`（自建 API 文件，无引用）
  2. `TenantVO`（`src/api/system/tenant/index.ts`）加可选字段 `expenseCachetUrl?: string`
  3. `views/system/official-seal/index.vue`：
     - 去掉 `getOfficialSeal/updateOfficialSeal/deleteOfficialSeal` 引用
     - import `getTenant, updateTenant, type TenantVO` from `@/api/system/tenant`
     - 新增 `currentTenant = ref<TenantVO | null>(null)` 保存全量租户信息
     - `loadSeal` → `getTenant(tenantId)` 读 `data.expenseCachetUrl`
     - `handleSave` → `updateTenant({ ...currentTenant.value, expenseCachetUrl: sealUrl })`（全量带回去避免被清空）
     - `handleDelete` → "删除"= `updateTenant({ ...currentTenant.value, expenseCachetUrl: '' })` 把字段清空
- 范式总结：后端字段挂在通用实体（如 `tenant.*`）而非专用接口时，**扩展既有类型 + 全量带回其他字段** 比新建专用 API/页面更稳

### 入住办理 fixed 项目删除后合计变空（2026-08-26 16:36）
- 用户截图：月固定收费区点击任意 X 删除某项 → 「月固定金额合计 ¥元」显示空
- 文件：`src/views/elderly/apply/check-in/ProcessForm.vue`
- 根因（两层）：
  1. **直接原因**：`totalMonthFee` computed 直接 `total += Number(item.totalAmount)`，无 NaN 防护。任一项 totalAmount 是 undefined/NaN → `Number(undefined) = NaN` → `total` 立即被污染 → `formatNum(NaN)` 返回 '' → 合计显示空
  2. **诱导原因**：`init()` 里 `arr[0] = { ...arr[0], ...item }` 用后端数据覆盖 arr 元素，spread 顺序导致 `item.totalAmount = undefined` 时把默认值 0 覆盖成 undefined
  3. **触发时机**：用户 X 删除某项 → Vue 3 reactive array splice → computed 重新求值 → 累加时撞上某项 undefined 一击毙命
- 修复（两层）：
  - `totalMonthFee` 加 `safeAdd(v)` helper：`Number.isFinite(Number(v)) ? Number(v) : 0`，跳过 NaN/undefined/字符串
  - `init()` 4 处 arr 覆盖加 `totalAmount: Number.isFinite(Number(item.totalAmount)) ? Number(item.totalAmount) : 0` 强制归一
- ⚠️ 隐患未动：`submitForm()` 里有 `arr.splice(3, 1)`（line 985-988）物理删除服务费项，破坏 UI 数据源完整性，只在用户没填服务费时触发。建议后续改成"标记跳过"而非数组删除
- 范式：**computed 累加一定要 NaN 防护**。`formatNum` 对 NaN/不合法值统一返回 ''，导致一点点 NaN 就让整列合计为空，肉眼上跟"删除某项后合计消失"非常像

### 对账单预览加机构公章（2026-08-26 16:08）
- 用户：在 `src/views/elderly/fee/bill-pay/preview.vue` 的对账单预览**右下角**（表格尾部，红色框区域）加公章图
- 改动：
  1. import：`getTenant` from `@/api/system/tenant`、`getTenantId` from `@/utils/auth`
  2. 加 `sealUrl = ref('')`
  3. `open()` 改用 `Promise.all([getExpenseOrderDetail(id), getTenant(tenantId).catch(() => null)])` 并行拉取；公章取 `tenant.expenseCachetUrl`，接口失败容错
  4. `handleClosed()` 关闭时清空 `sealUrl`，避免下次打开看到旧机构公章
  5. 模板：两个 tab 的表格结束后都加 `<div class="seal-area">`，内含 `<img :src="sealUrl" v-if="sealUrl">` + `<span class="seal-label">（机构签章）</span>`
  6. 样式：`.seal-area` 右对齐 + `min-height: 30mm` 占位；`.seal-img { width:28mm; height:28mm; object-fit:contain }` 打印自适应
- 公章来源 = 已对接的 `tenant.expenseCachetUrl`（不重复加 API），新机构未上传则不渲染
- v-print iframe 同步：v3-print-nb 把 scoped CSS 克隆进 iframe，公章图会随打印输出

### 对账单公章改为叠在表格内部 + 旋转 -45°（2026-08-26 16:12）
- 用户第二轮反馈：公章位置改到**红框处**（表格内"备注"列右下角，跨第3行+支付方式行），**旋转 -45°**，去掉"机构签章"4字
- 改动：
  1. 模板：`<div class="seal-area">` 改为 `<div v-if="sealUrl" class="seal-overlay">`，去掉 `.seal-label` 文字
  2. `.first, .second { position: relative }` 提供绝对定位上下文
  3. `.seal-overlay` 改绝对定位：`right:0; bottom:0; width:36mm; height:36mm; z-index:2; pointer-events:none`
  4. `.seal-img { transform: rotate(-45deg); transform-origin: 100% 100%; opacity:0.85 }` 旋转中心在右下角 → 旋转后向左上"倾倒"，自然落在表格右下区域
- 关键技巧：`transform-origin: 100% 100%` 让旋转中心在公章图右下角，旋转后公章左上角会向左上方延伸出去，正好覆盖表格右下备注区域；如果用 `center` 旋转则公章整体会跑出容器
- `pointer-events: none` 保证不挡表格交互（hover / 复制备注）

### 缴费通知单预览加"家属信息"按钮 + 弹窗（2026-08-26 16:25）
- 用户：在 `src/views/elderly/fee/bill-pay/unpay-preview.vue` 缴费通知单预览**右上角**加"家属信息"按钮，点击弹家属列表；**按钮不能被打印出来**
- 后端响应新增 `relatives[]` 字段（每项含 peopleName/relation/phone/idCard/insurance/isBillSender 等）
- 改动：
  1. Script：加 `relatives = ref<any[]>([])` + `relativeDialogVisible = ref(false)`；`open()` 里 `relatives.value = Array.isArray(res.relatives) ? res.relatives : []`；`handleClosed()` 清空
  2. 模板：`.header` 标题下加 `<el-button v-if="relatives.length" class="no-print relative-action">家属信息（{n}）</el-button>`，按钮带家属数量徽标
  3. 模板：`<template #footer>` 后追加独立 Dialog（家属信息表格：序号/姓名/关系/联系电话/身份证号/险种/账单发送人 el-tag）
  4. 样式：`.header { position: relative }` + `.relative-action { position: absolute; right:0; top:4px }`
  5. **打印隐藏关键**：`printExtraCss` 注入两条规则
     - `.no-print { display: none !important; }`（v-print iframe 内的全局样式）
     - `@media print { .no-print { display: none !important; } }`（屏幕本身按 print 媒体查询时也隐藏）
- 范式：**打印排除元素**首选 `.no-print` + `printExtraCss` 注入样式（v-print 走 iframe，scoped data-v 属性不被命中，必须走全局规则）；不要靠把按钮放容器外这种"侥幸路径"——一旦后续把 Dialog 包进更外层容器，按钮就会被纳入打印范围

### 修复 submitForm 的 arr.splice(3,1) 物理删除（2026-08-26 17:12）
- 问题：长住提交时若服务费未选，`arr.splice(3, 1)` 把"服务标准"项从 arr 物理删除 → arr 永久变 3 项，`getOverheadByType(7)` 的 `arr[3].list`、`totalMonthFee` computed、编辑回填 `arr[3]` 全部索引错乱，补填也回不来
- 修复（ProcessForm.vue，语义不变）：
  1. 校验段：删 try/catch + splice，改 `arr.forEach` —— `item.type == 7 && !item.itemId` 跳过校验（服务费可选），其余三项 `!item.itemId` 报错
  2. 提交段：`push(...arr)` 改 `push(...arr.filter(item => item.itemId))` —— filter 返回新数组，未选的服务费不提交，arr 本体保持 4 项
- 判断"已选/未选"用 `item.itemId`（el-select v-model 直接绑定，比原 `arr[3].amount` 更可靠）
- 范式：**固定结构数组（按下标访问的 arr[i]）绝不能 splice 删项**，用 filter/标记跳过代替
- ESLint 0 错误（3 个 v-for shadow warning 为既有问题）

### 复核"费用改动"影响面 + totalAmount 兜底升级（2026-08-26 17:20）
- 用户要求复核上上次（safeAdd + totalAmount 归一）改动是否导致费用计算错误/提交参数问题
- 链路核对结论：
  - `totalMonthFee`（safeAdd）只影响显示合计，不影响提交；有值项 Number() 保真
  - 提交金额来源：回填时 `dataForm.monthlyExpenses` 会过滤掉 type 1/2/3/7（914-916 行），费用项只经 `arr` 提交 → `init()` 归一出的 totalAmount **就是后端入库金额**
  - **发现真实隐患**：后端存在不返回 totalAmount 的费用项（用户最初 bug 的证据），原归一 `: 0` 会把真实费用提交成 0 元
- 修复：init() 4 处归一升级为 `totalAmount 合法 → 用它；否则 actualAmount 合法 → 用它（月费 totalAmount 本就 = actualAmount）；都缺才 0`
- 核对 `handleChangeDiscount` 的 `amount * ((discount/100)*10)`：配合 discount=9（9折）语义 = amount*0.9，公式正确，无需动
- 既有行为（未改）：push(...arr.filter()) 提交的 arr 元素含 label1/label2/errMsg/discountTemp 等 UI 字段（后端忽略未知字段）；`item.list=undefined` 引用共享污染 arr.list（splice 时代就有）
- ESLint 0 错误

### 是否赠送=是时 赠送起止时间必填（2026-08-26 17:26）
- 需求：`ProcessForm.vue`（入住办理）阶段性收费项，`item.isFreeGift == 1` 时"赠送开始/结束时间"必填
- 实现（两层）：
  1. 模板：两个 el-form-item 改动态 prop `'stageExpenses.' + index + '.freeStartTime'`（原 prop="freeStartTime" 挂在外层 form model=dataForm 上，指向 dataForm.freeStartTime 不存在，校验永不生效）+ 内联 rules required 随 isFreeGift 变化（trigger change/blur）
  2. submitForm：stageExpenses.forEach 前手动兜底校验，缺失时 message.error(`请选择第N个收费项目的赠送开始/结束时间`) + return（项目先例 Check.vue/ToLong.vue 同款写法）
- 注意：`Renewal.vue`（续约）438-482 行有相同结构的赠送字段，本次未改，用户未要求
- ESLint 0 错误

### "重新发起"赠送时间不回显 排查+防御（2026-08-26 17:33）
- 现象：重新发起（getProcess→getCheckInRecordId 回填）时 stageExpenses 的赠送开始/结束时间不回显，且能提交成功
- 链路：`getProcess` → `init({bpmStatus,elderId,id}, true, status)` → `getCheckInRecordId` → `dataForm.value = {...res}` → stageExpenses 原样带入
- 候选根因（按概率）：
  1. 后端 getCheckInDetail 返回的 freeStartTime/freeEndTime 是**时间戳(Long)**或"YYYY-MM-DD HH:mm:ss"，而 TgDatePicker value-format=date("YYYY-MM-DD") → 显示空
  2. 后端 isFreeGift 返回 null/0/缺字段 → v-if 不显示时间框、必填校验不触发 → 提交成功
  3. 后端 isFreeGift 返回 "true"/"1" 字符串 → `== 1` 宽松相等，"1"==1 true 但 "true"==1 false
- 防御修复（init 回填 stageExpenses map 内）：`item.isFreeGift = Number(item.isFreeGift) === 1 ? 1 : 0` + `normalizeGiftDate()`（数字时间戳/长字符串→"YYYY-MM-DD"）
- 诊断钩子：`console.info('[入住办理] stageExpenses 回显:', ...)` 打印每项 isFreeGift/freeStartTime/freeEndTime，用户重发后看控制台判断是后端字段缺失还是类型问题
- ESLint 0 错误