# 智慧康养社区助餐可视化系统 模块规划

---

## 1. 模块定位

智慧康养社区助餐可视化系统是以**老年人助餐服务**为核心的 O2O（线上到线下）平台，涵盖老人在线/到店点餐、刷卡/人脸识别结算、配送上门和助餐站可视化大屏管理等功能。

本系统集商业价值（可快速产生可视化效果，用于招商展示）与民生价值（解决独居老人就餐难题）于一体，是平台早期可见成果最显著的模块之一。

---

## 2. 建设目标

1. 支持老人在线点餐（小程序）和到店自助点餐（人脸识别终端）
2. 实现助餐费用管理（政府补贴 + 个人支付混合）
3. 提供配送上门服务（对接骑手配送系统）
4. 构建助餐站可视化大屏（当日就餐人数/菜品销量/补贴使用情况）
5. 与政府监管系统对接，输出助餐运营数据

---

## 3. 核心功能范围

### 3.1 一级模块

- 基本信息申请
- 在线点餐
- 到店自助点餐（人脸识别）
- 配送上门
- 助餐站管理系统
- 可视化大屏

### 3.2 二级模块

- **基本信息申请**：老人助餐资格申请（年龄/失能等级），平台审核后享受补贴
- **在线点餐**：菜品浏览、加购、下单、补贴自动抵扣、支付剩余金额
- **自助点餐**：到店自助点餐机器（iPad/触摸屏），人脸识别身份+自动出餐
- **配送上门**：不方便外出的老人选择配送，骑手接单配送
- **助餐站管理**：菜品管理（每日菜单）、厨师出餐管理、库存管理、补贴核销
- **可视化大屏**：当日就餐实时统计、补贴消耗、配送追踪地图

### 3.3 核心功能说明

| 功能         | 描述                                         | 技术要点                    |
| ------------ | -------------------------------------------- | --------------------------- |
| 人脸识别点餐 | 老人到助餐站刷脸，自动识别身份+弹出菜单      | 人脸识别SDK + 自助终端      |
| 补贴自动抵扣 | 下单时自动计算政府补贴额度，老人只付差价     | 补贴计算引擎                |
| 骑手配送对接 | 配送上门订单对接骑手系统（类 mall 外卖配送） | 参考 mall 骑手模块          |
| 可视化大屏   | 实时展示当日助餐站运营数据                   | ECharts + WebSocket实时刷新 |
| 每日菜单管理 | 助餐站每日上午更新菜品，老人11点前下单       | 定时任务 + 菜品状态         |

---

## 4. 与现有 mall 的关系

**契合度：B（中契合）**

mall 的外卖/餐饮类订单机制与本系统相似度较高：

| 能力               | mall 现状                  | 可复用程度                             |
| ------------------ | -------------------------- | -------------------------------------- |
| 餐品目录管理       | 有商品CRUD，可视为菜品管理 | B - 直接参考，去除库存/物流复杂度      |
| 在线下单支付       | 有完整下单链路             | B - 可直接参考，需加入补贴抵扣逻辑     |
| 骑手配送           | 有骑手端+配送追踪          | **B - 配送上门可直接复用mall骑手模块** |
| 商家管理（助餐站） | 有（类似外卖商家）         | B - 可参考商家端改造为助餐站管理       |
| 支付体系           | 微信/支付宝支付            | B - 可直接对接                         |
| **人脸识别点餐**   | **无**                     | **须独立建设**                         |
| **政府补贴结算**   | **无**                     | **须独立建设**                         |
| **可视化大屏**     | **无**                     | **须独立建设**                         |
| **助餐资格申请**   | **无**                     | **须独立建设**                         |

**建设路径：mall + 独立微服务（以mall为基础，扩展医养特性）**

配送模块可直接复用 mall 骑手配送代码，在线点餐可参考 mall 下单流程；但补贴结算、人脸识别、可视化大屏需独立开发。

---

## 5. 规划判断

**mall + 独立微服务**

- 老人点餐端：uni-app（小程序），复用 mall 下单/支付组件
- 助餐站管理端：uni-app 或 Vue3 Web（兼容平板收银台）
- 骑手配送：**直接复用 mall 骑手模块**（仅需配置助餐专属配送逻辑）
- 独立服务：补贴计算服务、人脸识别接入服务、可视化大屏服务

---

## 6. 需新增业务能力

1. **助餐资格审核**：老人申请助餐资格→机构审核→激活补贴账户
2. **补贴计算与核销**：按老人等级和地区标准计算补贴金额，订单完成后核销
3. **人脸识别点餐终端**：对接助餐站触摸屏/平板的人脸识别硬件
4. **每日菜单管理**：重复性菜品录入简化（复制前日菜单/固定菜库）
5. **可视化大屏**：ECharts实时刷新，数据精确到分钟级
6. **营养建议**：根据老人健康档案（可选），在点餐时展示营养搭配建议

---

## 7. 需新增数据模型

| 模型                  | 关键字段                                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `meal_station`        | id, name, address, district_code, manager_id, status                                                                                  |
| `meal_qualification`  | elder_id, start_date, end_date, daily_subsidy, status                                                                                 |
| `meal_menu`           | id, station_id, date, dishes(JSONB), publish_at, order_deadline                                                                       |
| `meal_dish`           | id, name, image, price, category, allergen_tags                                                                                       |
| `meal_order`          | id, elder_id, station_id, menu_date, order_type(delivery/dine-in/self-service), items(JSONB), total, subsidy_amount, self_pay, status |
| `meal_delivery`       | id, order_id, rider_id, pickup_at, delivered_at, address, status                                                                      |
| `meal_face_record`    | id, elder_id, station_id, recognized_at, order_id                                                                                     |
| `meal_subsidy_ledger` | id, elder_id, month, used_amount, balance, settled_at                                                                                 |

---

## 8. 需新增技术栈 / 第三方能力 / 中间件

| 类别     | 技术选型                        | 用途             |
| -------- | ------------------------------- | ---------------- |
| 人脸识别 | 腾讯云人脸识别 / 海康威视人脸机 | 到店刷脸点餐     |
| 可视化   | ECharts + WebSocket             | 大屏实时数据展示 |
| 骑手配送 | 复用mall骑手模块                | 配送上门         |
| 支付     | 复用mall支付网关                | 自费部分收款     |

---

## 9. 外部系统对接关系

| 对接方           | 内容                           | 方式            |
| ---------------- | ------------------------------ | --------------- |
| mall骑手模块     | 配送上门订单推送给骑手         | 内部API（复用） |
| mall支付         | 自费部分支付                   | mall支付网关    |
| 数据库系统（02） | 老人身份核验、档案关联         | 内部API         |
| 审批系统（04）   | 助餐资格审核（如需政府审批）   | 内部API         |
| 政府监管（01）   | 助餐运营数据上报               | 内部API         |
| 长护险（18）     | 部分助餐费用可能纳入长护险报销 | ⚠️ 待确认       |

---

## 10. 风险与边界

| 风险                   | 说明                                         | 应对                                 |
| ---------------------- | -------------------------------------------- | ------------------------------------ |
| 人脸识别硬件兼容       | 不同助餐站硬件品牌不统一                     | 制定统一的人脸设备入网标准           |
| 补贴结算合规           | 补贴核销需接受民政部门审计                   | 完整留存核销记录，支持导出           |
| 菜品食品安全           | 助餐属于食品服务，有卫生要求                 | 系统记录供餐机构卫生证，定期提醒续期 |
| 边界：不含厨房备餐管理 | 系统不管理厨房内部流程，仅管理菜品目录和订单 | 明确系统边界                         |

---

## 11. 实施优先级与分期建议

**优先级：P1**

| 分期   | 内容                                             | 前置条件                     |
| ------ | ------------------------------------------------ | ---------------------------- |
| 第一期 | 在线点餐 + 到店核销（一卡通/扫码）+ 基础补贴抵扣 | mall支付、老人档案（02）就绪 |
| 第二期 | 骑手配送上门 + 人脸识别终端 + 菜单管理           | mall骑手模块就绪             |
| 第三期 | 可视化大屏 + 补贴核销报表 + 政府对接             | —                            |

---

## 12. 结论

社区助餐系统是平台最具展示价值的民生服务模块，mall 在在线订餐和骑手配送方面具有 B 级可复用能力，尤其是**骑手模块可直接复用**，显著节省开发成本。

建议以 mall 订单/配送能力为基础，独立开发助餐补贴结算、人脸识别点餐和可视化大屏三大核心扩展能力，**快速上线形成招商展示效果**，同时为后续政府补贴审计积累数据基础。
