feat: 餐次管理模块新增 — 开餐/补餐/闭餐/余量处置/历史四页联动

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-10 18:36:42 +08:00
parent ae9acce200
commit ff48f38dbf
12 changed files with 3652 additions and 13 deletions
@@ -1,4 +1,4 @@
-_Last synced: 2026-08-10 | Base commit: `deb4752`_
+_Last synced: 2026-08-10 | Base commit: `32bd018`_

 # 记忆索引
 | 文件 | 描述 | 类型 | 最后更新 |
@@ -150,3 +150,28 @@ body {

 - **日期**：2026-08-10
 - **首次落地**：commit deb4752
+
+## 待机页副屏人脸识别监控区(收银员侧实时反馈)
+
+**结论**：收银员屏待机页(`02-standby.html`)左下区域由原「开始结算」按钮改为「副屏人脸识别监控区」,展示副屏识别状态(三态:成功/光线不足/位置不对)+ 模拟副屏画面(人形剪影 + 检测框 + LIVE 实时指示)。结算流程入口由副屏识别事件自动驱动,不再由收银员手动点击触发。
+
+**Why**：
+- 原「开始结算」按钮与"副屏识别→自动加载订单"的实际业务路径重复,容易让收银员误以为需要主动触发结算
+- 副屏识别成功率受光线/站位影响,但收银员屏此前没有对应的实时反馈区,无法主动提示顾客"请正对摄像头""请补光"等引导
+- 收银员是识别失败的最终处理人(决定何时提示顾客调整),必须在收银员屏有显式的状态可视化
+
+**How to apply**：
+- 三态统一用 `face-monitor--{success|warning|info}` 修饰符 + `border-color` + `box-shadow` 联动
+  - `success` 识别成功:绿框 + ✅ 徽标 + 脱敏用户名(如"张*明")+ 会员等级/工号
+  - `warning` 光线不足:黄框 + 💡 徽标 + "环境亮度低于识别阈值,请补光" + `faceWarnBlink` 闪烁动画
+  - `info` 位置不对:蓝框 + 🎯 徽标 + "请顾客正对摄像头并保持 50-80cm 距离" + 扫描线动画(`scanMove` 2.2s 循环)
+- 模拟副屏画面固定 200×140px 黑色摄像头视角块:用 `radial-gradient` 实现人形剪影 + `border-dashed` + 四角 `.face-preview__corner` 强调检测框
+- 原型演示用 4 秒轮播;**后端真实场景下应替换为副屏识别事件驱动**(状态变化由 WebSocket/SDK 推送,而非定时器)
+- 时钟区相应精简:年月日已由右上角 `topMeta` 承担,左下时钟区只显示「时分秒 + 餐次标签」,餐次按当前小时自动切换(早餐 6-10 / 午餐 10-14 / 晚餐 16-21 / 其他时段"欢迎光临")
+- 底部入口区原「🖨️ 小票打印」改为「🍽️ 用餐管理」(功能待开发,占位 `javascript:void(0)`)
+
+**See Also**：
+- [[project_progress.md]] — 2026-08-10 第二批次里程碑条目记录待机页重构范围
+
+- **日期**：2026-08-10
+- **首次落地**：commit 32bd018
@@ -7,7 +7,7 @@ last_updated: 2026-08-10

 # 记忆健康检查报告

-> _执行时间: 2026-08-10 | Base commit: `deb4752` | Last synced: 2026-08-10_
+> _执行时间: 2026-08-10 | Base commit: `32bd018` | Last synced: 2026-08-10_

 ## 健康概览

@@ -16,19 +16,21 @@ last_updated: 2026-08-10
 | 孤儿检测 | ✅ | 0 | — |
 | 幽灵检测 | ✅ | 0 | — |
 | 引用存在性检测（3A） | ✅ | 0 | 0 |
-| 双链对称性检测（3B） | ✅ | 1 | 0 |
+| 双链对称性检测（3B） | ✅ | 0 | 0 |
 | 内容矛盾检测 | ✅ | — | 0 |
 | 过期检测 | ⚠ | — | 3 待处理 |
 | 可推断内容污染 | ⚠ | — | 1 待处理 |
 | frontmatter 完整性 | ⚠ | — | 4 待处理 |

-**AUTO-FIX 已执行 1 项 | NEED-HUMAN 待处理 8 项**
+**AUTO-FIX 已执行 0 项 | NEED-HUMAN 待处理 8 项**
+
+> 本次为 2026-08-10 第二批次 sync 后的复查。新增 1 条决策（待机页副屏人脸识别监控区）+ 1 条里程碑条目，交叉引用闭环验证通过，无 AUTO-FIX 需执行；前期遗留的 8 项 NEED-HUMAN 维持原判定（结构性稳定内容/历史污染/统一性可选）。

 ---

 ## AUTO-FIX 已执行清单

- [x] 双链对称性补全：`project_progress.md` 2026-08-10 里程碑条目末尾追加反向引用 `[[decisions.md#收银设备用户类型徽标三态体系]]` 与 `[[decisions.md#补齐明细页业务路径修正：少记来源 = 未识别取餐记录]]`，闭环 decisions → progress 的两条新增决策引用
+_本次无 AUTO-FIX 执行项（所有结构性检查通过）。_

 ---

@@ -54,7 +56,7 @@ last_updated: 2026-08-10

 - **文件**：`project_progress.md` 第 109~168 行「近期里程碑」区段（历史条目）
 - **问题**：历史里程碑条目仍含大量具体文件路径（如 `din-ingredient.html`、`prod-clean-order`、`canteen-nutrition-scale/02-dish-display.html`）与 commit hash（`445d824`、`d00208a`、`4fd44f1` 等），按 memory-update 规则「Git 历史（可用 git log 查）」不应写入记忆文件
- **本次执行**：新增的 2026-08-10、2026-08-07 两条里程碑仍保留文件名（属变更范围说明，便于跨模块追溯，未全量罗列），历史 110~168 行污染条目未清理
+- **本次执行**：新增的 2026-08-10 两条里程碑仍保留文件名（属变更范围说明，便于跨模块追溯，未全量罗列），历史 110~168 行污染条目未清理
 - **建议**：人工审查 110~168 行历史里程碑，保留结论性描述、删除具体文件路径与 commit hash，让用户能通过 `git log --since=2026-07` 自查细节

 ### [WARN] frontmatter 缺失 — 4 个文件
@@ -74,5 +76,6 @@ last_updated: 2026-08-10
 - `decisions.md#餐厅终端设备 PAD 居中外壳设计模式` → `[[feedback.md#PAD 终端页面内禁止可见滚动条]]` ✅ 目标存在，双向闭环
 - `feedback.md#PAD 终端页面内禁止可见滚动条` → `[[decisions.md#餐厅终端设备 PAD 居中外壳设计模式]]` ✅ 目标存在，双向闭环
 - `decisions.md#规格体系统一化改造（跨设备端 + Web 端 + 辅助页）` → `[[feedback.md]]` ✅ 目标存在（占位引用「暂无直接关联条目」，非对称但属预期）
- `decisions.md#收银设备用户类型徽标三态体系` → `[[project_progress.md]]` ✅ 目标存在，本次 AUTO-FIX 后双向闭环
- `decisions.md#补齐明细页业务路径修正：少记来源 = 未识别取餐记录` → `[[project_progress.md]]` ✅ 目标存在，本次 AUTO-FIX 后双向闭环
+- `decisions.md#收银设备用户类型徽标三态体系` → `[[project_progress.md]]` ✅ 目标存在，双向闭环（前次 AUTO-FIX 完成）
+- `decisions.md#补齐明细页业务路径修正：少记来源 = 未识别取餐记录` → `[[project_progress.md]]` ✅ 目标存在，双向闭环（前次 AUTO-FIX 完成）
+- `decisions.md#待机页副屏人脸识别监控区(收银员侧实时反馈)` → `[[project_progress.md]]` ✅ 目标存在，双向闭环（本次 memory-update 同步建立）
@@ -3,7 +3,7 @@ name: 项目进度
 description: 各模块原型开发进度与里程碑
 type: project
 last_updated: 2026-08-10
-commit: deb4752
+commit: 32bd018
 ---

 # 项目进度
@@ -106,6 +106,7 @@ Web 管理端和员工端 APP 的其余模块（系统管理、运动管理、
 - 覆盖模块：18 个（含三端+其他终端）

 ## 近期里程碑
+- 2026-08-10：结算设备待机页新增副屏人脸识别监控区 + 多页面冗余元素精简（commit 32bd018）——①`02-standby.html` 左下「开始结算」按钮区改为「副屏人脸识别监控区」三态轮播演示（成功/光线不足/位置不对），含模拟副屏画面(人形剪影+检测框+LIVE 指示)与时钟精简、底部「小票打印」入口改名为「用餐管理」(功能待开发占位)；②`03-checkout.html` 删除顶栏「本单应付」、余额信息卡「会员等级」、清空按钮及相关 CSS/JS；③`07-statistics.html` KPI 对比文案统一为「较昨日午餐」、支付方式柱状图标签语义化(余额支付/现金支付/餐券抵扣)；④`08-reconcile.html` 删除差额汇总「企业补贴优惠」行；⑤`user-02-checkout-sync.html` 删除热量环「略少 76%」提示；⑥`user-04-success.html` 删除二维码「今日已有 1,284 人查看」营销文案。（相关决策：[[decisions.md#待机页副屏人脸识别监控区(收银员侧实时反馈)]]）
 - 2026-08-10：收银设备新增用户类型徽标体系 + 补齐明细页重构（commit deb4752）——①主屏(03/04/05/06/07)与副屏(user-02/03/04)统一用户类型徽标三态配色（会员=蓝金渐变金边 / 临时=灰底 / 内部员工=蓝底），订单列表(05)新增「用户类型」列、订单详情(06)新增独立顾客信息卡片并清理语义陈旧的"顾客类型=企业员工"项；②订单详情(06)移除「补齐明细」操作入口（支付后改走退款流程，避免操作歧义）；③补齐明细页(08)重构：左侧订单由卡片堆叠改为表格化(对齐 03-checkout)，「添加商品」Tab 重构为「补齐未识别」从未匹配取餐记录直接加入（业务路径修正：少记来源=未识别记录而非菜品库）；④导航页"结算设备"改名为"结算台"。（相关决策：[[decisions.md#收银设备用户类型徽标三态体系]]、[[decisions.md#补齐明细页业务路径修正：少记来源 = 未识别取餐记录]]）
 - 2026-08-07：体重管理 Web 端新增人员测量记录页 + 多页面同步调整（commit fdeb8a2）——新增 `personnel-measure-record.html`（人员测量记录）；原 `history-personnel-list.html` 重命名为 `personnel-overview-record.html`（人员概览记录）；过程管理多页面（行动记录/总览/总览详情/活动统计）字段与交互调整；档案/设备/异常等多页同步微调。
 - 2026-08-06：结算设备全流程原型补齐 + 餐线营养秤双屏取餐合并（commit 51661ab）——结算设备新增收银员屏与用户屏两组共 13 个页面，覆盖登录→待机→收银→支付→订单/详情/统计/对账/小票 完整业务闭环与对应的用户侧待机/同步/支付/成功状态；导航页重构为左右双屏(用户屏/收银员屏)布局。餐线营养秤将原双屏大屏页与双屏小屏页合并为单页双屏布局(同页左右两区)。营养秤 5 个二级页统一返回按钮 history.back() 兜底逻辑、菜品展示与单屏取餐页样式微调。