diff --git a/.claude/memory/MEMORY.md b/.claude/memory/MEMORY.md index 7f6eb62..bc896f7 100644 --- a/.claude/memory/MEMORY.md +++ b/.claude/memory/MEMORY.md @@ -1,4 +1,4 @@ -_Last synced: 2026-08-10 | Base commit: `deb4752`_ +_Last synced: 2026-08-10 | Base commit: `32bd018`_ # 记忆索引 | 文件 | 描述 | 类型 | 最后更新 | diff --git a/.claude/memory/decisions.md b/.claude/memory/decisions.md index be2fbbc..fe6dfec 100644 --- a/.claude/memory/decisions.md +++ b/.claude/memory/decisions.md @@ -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 diff --git a/.claude/memory/lint_report.md b/.claude/memory/lint_report.md index e21ebdf..d433432 100644 --- a/.claude/memory/lint_report.md +++ b/.claude/memory/lint_report.md @@ -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 同步建立) diff --git a/.claude/memory/project_progress.md b/.claude/memory/project_progress.md index ea53617..b67d587 100644 --- a/.claude/memory/project_progress.md +++ b/.claude/memory/project_progress.md @@ -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() 兜底逻辑、菜品展示与单屏取餐页样式微调。 diff --git a/CLAUDE.md b/CLAUDE.md index 2536059..10343be 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,4 +1,4 @@ - + # 项目约束 本项目所有工作必须严格遵守 `项目背景.md` 中定义的全部规范,包括: diff --git a/other-module/canteen-device/checkout-device/02-standby.html b/other-module/canteen-device/checkout-device/02-standby.html index 83e4667..2b274a1 100644 --- a/other-module/canteen-device/checkout-device/02-standby.html +++ b/other-module/canteen-device/checkout-device/02-standby.html @@ -585,11 +585,11 @@
今日数据可视化
- +
🍽️
-
用餐管理
-
用餐记录/餐次管理
+
餐次管理
+
开餐/结束用餐/历史记录
diff --git a/other-module/canteen-device/checkout-device/10-meal-center.html b/other-module/canteen-device/checkout-device/10-meal-center.html new file mode 100644 index 0000000..efee42b --- /dev/null +++ b/other-module/canteen-device/checkout-device/10-meal-center.html @@ -0,0 +1,343 @@ + + + + + + 结算设备 - 餐次管理 | 蚁熊智能餐养平台 + + + + +
+ + +
+ ◀ 返回待机 + 餐次管理 + 2026-08-10 周一 +
+ + +
余量处置已提交 ✓
+ + +
+ + +
+
🥪
+
+
当前餐次 · 午餐
+
数味餐厅 · 一楼 | 共 3 条餐线 · 28 道菜
+
+
12:30:45
+
+ + + + +
+ +
+ + + + + diff --git a/other-module/canteen-device/checkout-device/11-meal-active.html b/other-module/canteen-device/checkout-device/11-meal-active.html new file mode 100644 index 0000000..31b776c --- /dev/null +++ b/other-module/canteen-device/checkout-device/11-meal-active.html @@ -0,0 +1,714 @@ + + + + + + 结算设备 - 开餐中详情 | 蚁熊智能餐养平台 + + + + +
+ + +
+ ◀ 返回餐次管理 + 开餐中 · 午餐 + 2026-08-10 周一 +
+ + +
已通知后厨补做宫保鸡丁 📢
+ + +
+ + +
+
🔊
+
+
+ 操作人 + 张三 · CS001 +
+
+
+ 餐厅 + 数味餐厅 · 一楼 +
+
+
+ 开餐时间 + 11:00:23 +
+
+
+ 已开餐 + 32 分 +
+
+
+ 本餐次订单 + 96 单 +
+
+ 开餐中 +
+ + +
+ A 区中餐线 12 + B 区中餐线 9 + C 区快餐线 7 +
+ + +
+
+ +
+
+ + + + +
+ + + + +
+ + + + + diff --git a/other-module/canteen-device/checkout-device/12-meal-end-surplus.html b/other-module/canteen-device/checkout-device/12-meal-end-surplus.html new file mode 100644 index 0000000..f139a9f --- /dev/null +++ b/other-module/canteen-device/checkout-device/12-meal-end-surplus.html @@ -0,0 +1,876 @@ + + + + + + 结算设备 - 余量处置 | 蚁熊智能餐养平台 + + + + +
+ + +
+ ◀ 返回开餐详情 + 余量处置 · 午餐 + 2026-08-10 周一 +
+ + +
余量处置已提交 ✓
+ + +
+ + +
+
+
+
午餐已结束 · 请处置各餐线餐品余量
+
参考后台余量处置规则:每道菜需选择处置方式(员工福利/捐赠/废弃/加工再利用/存入智能货柜)
+
+
+ 开餐 - 结束 + 11:00:23 - 14:02:15 +
+
+ + +
+ +
+ 批量处置方式: + + +
+ 已选 0 项 +
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
餐品名称餐线实际制作(kg)已售(kg)余量(kg)余量率处置方式处置量(kg)备注
+
+ + +
+
+ 总余量 + 0.0 kg +
+
+ 已处置 + 0.0 kg +
+
+ 待处置 + 0.0 kg +
+
+
+ 处置方式分布 + +
+
+ + + + +
+ + + + +
+ + + + + diff --git a/other-module/canteen-device/checkout-device/13-meal-history.html b/other-module/canteen-device/checkout-device/13-meal-history.html new file mode 100644 index 0000000..5286b69 --- /dev/null +++ b/other-module/canteen-device/checkout-device/13-meal-history.html @@ -0,0 +1,1606 @@ + + + + + + 结算设备 - 餐次历史记录 | 蚁熊智能餐养平台 + + + + +
+ + +
+ ◀ 返回餐次管理 + 餐次历史记录 + 2026-08-10 周一 +
+ + +
+ + +
+
+ 餐次列表 + 5 餐次 +
+
+ +
+
+ + +
+
+ +
+ +
+ ◀ 返回时间轴 + + + +
+
+
+ +
+
+ +
+ +
+ +
+ + + + + diff --git a/other-module/canteen-device/checkout-device/doc/CHANGELOG.md b/other-module/canteen-device/checkout-device/doc/CHANGELOG.md index 4e2a321..5f37c47 100644 --- a/other-module/canteen-device/checkout-device/doc/CHANGELOG.md +++ b/other-module/canteen-device/checkout-device/doc/CHANGELOG.md @@ -1,5 +1,44 @@ # 结算设备 CHANGELOG +## 2026-08-10 | 餐次管理模块新增(10-13 四页联动) + +### 业务背景 +原 `02-standby.html` 待机页底部「餐次管理」按钮(commit 32bd018 中由"小票打印"改名而来)一直为 `javascript:void(0)` 占位状态,功能未实现。本次落地完整的餐次管理业务闭环:开餐 → 上餐/加餐/闭餐 → 结束用餐 → 余量处置 → 历史回溯。 + +### 变更清单 +- **入口改名**(`02-standby.html`):底部第 3 张入口卡片文案由「用餐管理 - 用餐记录/餐次管理」改为「餐次管理 - 开餐/结束用餐/历史记录」,跳转目标由占位改为 `10-meal-center.html` +- **新增 4 个页面**: + - `10-meal-center.html` 餐次管理入口页:左右两个大卡(左餐次开关 + 右历史记录),含当前餐次状态摘要条与实时时钟;URL 参数 `?toast=submitted` 驱动提交成功的 Toast 提示 + - `11-meal-active.html` 开餐中详情页:开餐信息条(操作人/餐厅/开餐时间/已开时长/订单数) + 餐线 Tab(A/B/C 三区切换) + 餐品图文卡(余量进度条/余量阈值配色/已售份数) + 「通知补餐」按钮(含 toast 反馈 + 按钮态切换) + 底部「结束用餐」按钮(二次确认弹窗 → 跳余量处置页) + - `12-meal-end-surplus.html` 余量处置引导页:顶部信息条 + 批量操作工具栏(全选/批量处置方式下拉/应用到选中项) + 表格化余量列表(餐品/餐线/实制/已售/余量/余量率/处置方式/处置量/备注) + 汇总栏(总余量/已处置/待处置/处置方式分布) + 提交二次确认弹窗 + - `13-meal-history.html` 历史记录页:左 30% 餐次列表(按日期分组 + 状态徽标) + 右 70% 流程时间轴(开餐→上餐→加餐→闭餐→结束→余量处置六类节点,色编码 + 节点卡片 + 处置明细) + 底部统计(订单/营收/客单价/余量) +- **导航页同步**(`index.html`):收银员屏区追加 4 张卡片(10-13),其中 10 标记「新」核心徽标 + +### 业务路径 +``` +02-standby.html (待机页,入口改名 + 跳转) + └─ 10-meal-center.html (二级入口:左开餐开关 + 右历史记录) + ├─ 11-meal-active.html?meal=lunch (开餐中:餐线 Tab + 餐品列表 + 通知补餐 + 结束用餐) + │ └─ 12-meal-end-surplus.html?meal=lunch (余量处置:批量处置 + 提交跳回 10) + └─ 13-meal-history.html (历史:左餐次列表 + 右时间轴) +``` + +### 设计要点 +- **余量处置四选项**(员工福利/捐赠/废弃/加工再利用)严格对齐后台 `web-admin/nutrition/prod-proc-surplus.html` 的处置方式体系,确保前后台业务语义一致 +- **余量阈值三态**:≤10% 红色(紧急补餐)/ ≤25% 金色(预警)/ >25% 绿色(正常),通过 `stock-bar__fill--{ok|mid|low}` 修饰符联动配色 +- **餐次状态三态**:进行中(绿色脉冲)/ 已结束(灰色)/ 未开餐(占位) +- **时间轴节点六类**:开餐(绿▶)/ 上餐(蓝🍽)/ 加餐(金➕)/ 闭餐(灰✕)/ 结束(红⏹)/ 处置(紫♻),通过渐变竖线串联 +- **URL 参数驱动**:`?meal=lunch|breakfast|dinner` 切换餐次上下文,`?toast=submitted` 触发提交成功 Toast,`?date=2026-08-09&meal=lunch` 跳转历史指定餐次 +- **批量处置交互**:复选框 + 顶部下拉"批量应用处置方式",处置方式变更联动下拉配色(福利蓝/捐赠绿/废弃红/再利用紫) +- **二次确认**:结束用餐(弹窗 → 跳余量处置)、提交处置(弹窗 → 显示处置汇总 → 跳餐次管理并触发 Toast) + +### 不变更 +- 现有 9 个收银员屏页面(01-09)与 4 个用户屏页面(user-01~04)结构与样式保持不变 +- 用户类型徽标体系、支付方式徽标体系保持不变 +- 副屏人脸识别监控区三态轮播逻辑保持不变 + +--- + ## 2026-08-10 | 待机页(02)新增副屏人脸识别监控区 + 入口改名 ### 业务背景 diff --git a/other-module/canteen-device/checkout-device/index.html b/other-module/canteen-device/checkout-device/index.html index 1389623..bce940c 100644 --- a/other-module/canteen-device/checkout-device/index.html +++ b/other-module/canteen-device/checkout-device/index.html @@ -311,6 +311,38 @@
餐后小票预览与打印
+ + 10 新 +
🍽️
+
+
餐次管理
+
开餐开关 / 历史记录入口
+
+
+ + 11 +
🔊
+
+
开餐中详情
+
开餐信息 + 餐线餐品 + 补餐 + 结束
+
+
+ + 12 +
+
+
余量处置
+
结束用餐引导 · 批量处置
+
+
+ + 13 +
📜
+
+
餐次历史记录
+
开餐/补餐/闭餐/余量处置 · 点击查看明细
+
+