chore: record session journal - 握力环训练趣味化

2026-05-27 16:53:33 +08:00
parent 261f8315de
commit b9d2541b32
946 changed files with 107438 additions and 0 deletions
@@ -0,0 +1,87 @@
+# T3 · 诊单列表「未服务天数」
+
+> 来源：~/.claude/plans/6-7-fluffy-sunset.md（T3 节）— 拆分版
+> 范围：本 PR 仅完成 **后端字段 + 前端列**；「查看」按钮 + 行双击留到 T1+T2 上线时一并加（避免在 readonly 路由不存在的窗口期产生 404）。
+
+## 用户故事
+
+二中心医助每天开诊单列表时，要一眼看出「这个患者多少天没打卡血糖」，便于优先回访。**口径**：未服务天数 = 当天 − 该患者最近一条血糖记录日期（天，向下取整）。以血糖（`zyt_tcm_blood_record.record_date` MAX）为唯一锚点，不混合其它打卡表。
+
+## 后端改动
+
+文件：`server/app/adminapi/lists/tcm/DiagnosisLists.php`
+
+在 `lists()` 末尾（拼装完所有其它字段之后）：
+
+```php
+$diagIds = array_filter(array_unique(array_column($lists, 'id')));
+$maxRows = [];
+if (!empty($diagIds)) {
+    $maxRows = BloodRecord::whereIn('diagnosis_id', $diagIds)
+        ->whereNull('delete_time')
+        ->group('diagnosis_id')
+        ->column('MAX(record_date)', 'diagnosis_id');
+}
+$now = time();
+foreach ($lists as &$item) {
+    $last = (int) ($maxRows[(int) $item['id']] ?? 0);
+    $item['last_blood_record_at'] = $last > 0 ? date('Y-m-d', $last) : null;
+    $item['unserved_days'] = $last > 0 ? max(0, (int) floor(($now - $last) / 86400)) : null;
+}
+```
+
+字段语义：
+- `last_blood_record_at`：`Y-m-d` 字符串，无打卡 → `null`
+- `unserved_days`：整数，无打卡 → `null`
+
+## 前端改动
+
+文件：`admin/src/views/tcm/diagnosis/index.vue`
+
+在「开方」列后、「视频旁观」列前，新增列：
+
+```html
+<el-table-column label="未服务天数" width="110" align="center">
+  <template #default="{ row }">
+    <span :class="unservedDaysClass(row.unserved_days)">
+      {{ row.unserved_days ?? '—' }}
+    </span>
+  </template>
+</el-table-column>
+```
+
+颜色规则（计划原文）：
+- `null/undefined` → 灰
+- `>=7` → 红
+- `3-6` → 橙
+- `<=2` → 绿
+
+```ts
+const unservedDaysClass = (n: unknown) => {
+    if (n === null || n === undefined) return 'unserved-muted'
+    const num = Number(n)
+    if (!Number.isFinite(num)) return 'unserved-muted'
+    if (num >= 7) return 'unserved-red'
+    if (num >= 3) return 'unserved-orange'
+    return 'unserved-green'
+}
+```
+
+CSS 加 4 个 class（红 #dc2626 / 橙 #ea580c / 绿 #16a34a / 灰 #94a3b8）。
+
+## 不做（边界）
+
+- 不加「查看」按钮（依赖 T1 readonly 页）
+- 不加 `@row-dblclick`（同上）
+- 不加 `?sort=unserved_days&order=desc` 排序白名单（这是计划原文的可选项；当前没有用户反馈需要排序，先简化）
+- 不动 `count()` 函数（仅展示字段，不影响过滤/分页）
+
+## 验收
+
+1. 在诊单列表里能看到「未服务天数」列
+2. 没有任何血糖打卡的诊单 → 显示 `—`（灰）
+3. 7 天前打过卡 → 红色（如 9）
+4. 3-6 天前打过卡 → 橙色
+5. ≤ 2 天打过卡 → 绿色
+6. 列表分页 / 搜索 / Tab 切换不受影响
+7. 性能：单页面查询多一次 `WHERE IN + GROUP BY` 走 `idx_diagnosis_id`，N+1 不会出现