核心亮点
四个工程级实现，把堂食扫码点餐
做到能交付
每张卡都对应一篇核心实现文档，配论文里同款的手绘流程图。
- 01 同桌多人实时一致性
桌台多人协同购物车
WebSocket 桌台共享购物车 +
cart.version乐观并发 +opId幂等键，弱网与同桌并发写入不会重复扣减或丢失变更。- 进程内 Map<tableId, Set<Client>> + Redis Pub/Sub 跨进程广播
- opId 幂等键去重 / cart.version 乐观锁解决并发覆盖
- 订单广播 ORDER_CREATED / 维护态 MAINTENANCE_CHANGED 分别覆盖不同时序
- 02 电商类目级的复杂规格
规格 / 价格 / 库存三层商品模型
库存规格组按笛卡尔积自动生成 SKU；非库存规格通过
priceItemKey在购物车与订单中独立计费、合并同款，支持电商级规格组合。- 库存规格组 → SKU 笛卡尔积 + 行级悲观写锁防超卖
- 非库存规格 → priceItemKey 合并同款，免膨胀
- 价格全链路存 cents (bigint) + priceTransform 中间件双向转换
- 03 独立门店与连锁经营统一抽象
平台 / 租户 / 门店三层多租户
AdminScope多对多授权 + 角色 rank 比较 +canManageSharedCatalog动态计算位，实现「角色层级 + 共享菜单写权限」语义；连锁租户共享菜单、分店独立维护库存。- SUPER_ADMIN / TENANT_ADMIN / STORE_ADMIN 三级角色层级
- SINGLE 与 CHAIN 两类租户共用同一套授权模型
- 客户端 X-Tenant-Id / X-Store-Id / X-Board 仅声明意图，服务端实时核对 AdminScope
- 04 五层缓存 + 推拉结合
分层缓存与梯度实时性
浏览器 / CDN / 进程内 / Redis / WebSocket 五层缓存按数据热度与时效性分级；读多写少走
ETag协商缓存，必须即时感知的购物车与维护态改走 WS 主动推送，绕开缓存滞后。- 静态资源 COS + CDN + 浏览器
Cache-Control三层联动，命中即免回源 - 微信
access_token/ 维护态走进程内 Map + Redis 双层，分布式锁防击穿 - 桌台购物车 / 订单 / 维护态变化以 WS 推代拉，绕开 ETag 与 CDN 滞后
- 静态资源 COS + CDN + 浏览器
