智能排菜系统用户手册
1. 系统用途
智能排菜系统是运行在 Android Pad 上的食堂排菜终端，用于维护档口菜谱，并把菜品排到称重台的左称、右称等称位上。
系统主要包含两个业务入口：
- 排菜：管理称重台当前菜品。
- 设置菜谱：按日期、餐次、档口维护菜谱。
系统需要横屏使用。首次使用或更换设备后，需要先完成配置链接、配对码和设备编号配置。
2. 登录
- 打开应用，进入“智能排菜系统”登录页。
- 输入账号和密码。
- 点击“登录”进入功能首页。
默认账号：
| 项目 | 默认值 |
|---|---|
| 账号 | admin |
| 密码 | 123456 |
登录页支持：
- 记住密码：勾选后，下次打开应用自动带出已保存密码。
- 显示/隐藏密码：点击密码框右侧图标切换。
- 忘记密码：提示联系管理员或实施人员重置密码。
注意事项：
- 本地登录密码只保存在当前设备。
- 如果管理员在系统设置中修改过密码，请使用修改后的密码登录。
3. 功能首页
登录成功后进入“功能首页”。
首页包含：
- 当前日期和星期。
- 排菜入口。
- 设置菜谱入口。
- 健康提示轮播。
- 顶部用户名菜单。
- 系统设置入口。
点击顶部用户名，可选择“退出登录”。退出后会回到登录页。
进入“排菜”或“设置菜谱”前，系统会检查关键配置。如果配置链接、配对码或设备编号缺失，会自动弹出系统设置，要求先完成配置。
4. 首次配置
4.1 打开系统设置
- 在首页点击系统设置入口。
- 输入管理员密码。
- 验证通过后进入“系统设置”。
| 项目 | 默认值 |
|---|---|
| 管理员密码 | cpt123 |
管理员密码用于保护本机设置入口，避免误改终端配置。
4.2 配置服务地址
- 在系统设置中点击“配置链接”。
- 输入服务地址。
- 点击保存。
默认配置链接：
https://zhctdev.yyangpt.cn保存配置链接后，后续配对和业务接口会使用新的服务地址。
4.3 配置配对码
- 在系统设置中点击“配对码”。
- 输入实施人员提供的配对码。
- 点击保存，等待系统校验。
- 提示“配对成功”后，系统会自动保存配对码、设备编号、餐厅 ID 和餐厅名称。
注意事项：
- 设备编号由服务端返回，不能手动直接编辑。
- 如果提示配对失败、配对码错误或设备编号为空，请确认服务地址、网络和配对码是否正确。
- 未完成配对时，业务页无法正常加载档口、设备和菜谱数据。
4.4 主题和字号
系统设置支持：
- 主题颜色：橙色、蓝色、绿色。
- 字号大小：小、中、大。
选择后点击“保存”，页面会按新的主题和字号刷新。
4.5 修改本地登录密码
- 在系统设置中点击“修改密码”。
- 输入旧密码。
- 输入新密码。
- 点击“确认修改”。
修改成功后，新密码立即生效。下次登录需要使用新密码。
5. 排菜操作
“排菜”用于管理称重台当前菜品。
5.1 进入排菜页
- 在首页点击“排菜”。
- 如果尚未完成配置，系统会先弹出系统设置。
- 配置完整后进入排菜页。
进入排菜页后，系统会根据设备编码加载区域、餐厅、档口树，并加载当前供餐餐段。
5.2 选择档口
- 首次进入或未选择档口时，系统会弹出档口选择。
- 按区域、餐厅、档口层级选择最终档口。
- 选择后系统加载该档口下的称重台设备。
档口列表为空或加载失败时，请检查配对信息、服务地址和网络状态。
5.3 查看设备列表
排菜页会展示称重台设备列表。每台设备包含：
- 设备名称或编号。
- 在线、离线或未知状态。
- 左称、右称当前菜品。
- 菜品图片和排菜状态。
设备列表支持下拉刷新。页面筛选项包括：全部、在线、离线、未排菜。
5.4 给称位排菜
- 点击某台设备的称位，例如左称或右称。
- 右侧会打开“选择菜品”抽屉。
- 在抽屉中选择菜品来源：菜谱库或菜品库。
- 可输入关键字搜索菜品。
- 可按分类筛选菜品，例如主食、素菜、荤菜、蛋奶坚果、水果、汤饮。
- 点击要排的菜品。
- 如果该称位已有菜品，系统会弹出替换确认。
- 确认后保存排菜。
保存成功后提示“排菜完成”。
5.5 清空称位菜品
- 在已排菜称位上点击删除菜品按钮。
- 系统弹出清空确认。
- 点击确认后清空该称位菜品。
清空成功后提示“已清空排菜”。
5.6 离线设备说明
离线设备也允许保存排菜。页面会提示：
设备离线，保存后将在设备在线时自动下发。如果需要立即确认下发结果，请等待设备恢复在线后刷新设备列表。
6. 设置菜谱
“设置菜谱”用于按日期、餐次、档口维护菜谱。
6.1 进入设置菜谱页
- 在首页点击“设置菜谱”。
- 如果尚未完成配置，系统会先弹出系统设置。
- 配置完整后进入设置菜谱页。
页面会按当前日期、餐次和档口加载菜谱。
6.2 切换日期
顶部日期条一次展示 7 天。可使用左右箭头切换上一组或下一组日期，也可点击具体日期查看当天菜谱。
今天以前的菜谱为只读状态，页面会显示“不可改”。只读日期只允许查看，不能新增、移除或复制菜谱。
6.3 选择餐次
点击餐次选择，可在早餐、午餐、晚餐、夜宵之间切换。切换后系统会重新加载当前日期、餐次、档口对应的菜谱。
6.4 选择档口
点击档口选择入口，按层级选择档口。选择档口后，系统会保存当前选择并加载该档口菜谱。
6.5 查看菜谱
菜谱以网格方式展示，每个菜品卡片包含菜品名称、菜品图片、价格信息和可编辑日期下的“移除”操作。接口未提供真实价格时不显示价格。
如果当前日期暂无菜谱，页面会显示空状态提示。
6.6 新增菜品到菜谱
- 确认当前日期不是过去日期。
- 选择正确的餐次和档口。
- 点击“新增菜品”。
- 在右侧抽屉中搜索或按分类筛选菜品。
- 勾选需要加入的菜品。
- 点击“添加菜品到菜谱”。
系统会逐个提交所选菜品，并返回新增、已存在、失败数量。
常见提示：
- 菜品已在当前菜谱中：该菜品无需重复添加。
- 菜品缺少 UUID：该菜品数据不完整，无法添加。
- 今天以前的菜谱仅支持查看，不能修改：请选择今天或未来日期。
6.7 移除菜谱菜品
- 在可编辑日期中找到要移除的菜品。
- 点击“移除”。
- 系统提交删除请求。
移除成功后提示“菜品已移除”，并刷新当前菜谱。
6.8 复制菜谱
复制菜谱支持按天复制和按周复制。
- 确认当前日期不是过去日期。
- 选择目标档口。
- 点击“复制菜谱”。
- 选择复制方式：按天复制或按周复制。
- 选择来源日期或来源周。
- 选择目标日期或目标周。
- 选择包含餐次：全部、早餐、午餐、晚餐、夜宵。
- 点击“保存当前设置”。
限制说明：
- 按天复制时，目标日期必须晚于来源日期。
- 按周复制按自然周周一到周日处理，目标周必须晚于来源周。
- 未选择档口时不能复制菜谱。
- 复制成功后系统会刷新当前菜谱。
7. 常见提示和处理办法
| 提示 | 可能原因 | 处理办法 |
|---|---|---|
| 请先补全配置链接、配对码和设备编号 | 首次使用或配置被清空 | 打开系统设置，完成服务地址和配对码配置 |
| 配对失败 | 服务地址错误、网络异常或配对码无效 | 检查网络、服务地址和配对码 |
| 配对失败，设备编号为空 | 后端未返回终端编号 | 联系实施或后台人员检查配对数据 |
| 档口获取失败 | 配对信息、接口或网络异常 | 检查配置并重试 |
| 设备获取失败 | 档口下设备接口异常或网络异常 | 下拉刷新或联系后台排查 |
| 菜谱获取失败 | 当前档口、日期、餐次查询失败 | 确认档口和餐次后重试 |
| 当前操作处理时间较长，请稍后查看结果或重试 | 接口处理时间较长，常见于复制菜谱 | 稍后刷新结果，必要时重试 |
| 今天以前的菜谱仅支持查看，不能修改 | 选择了过去日期 | 切换到今天或未来日期 |
| 账号或密码错误，请重新输入 | 登录账号或密码不正确 | 使用 admin 和当前本地密码登录 |
8. 现场使用建议
- 首次部署时，先确认 Pad 网络可访问服务地址，再输入配对码。
- 排菜前先确认当前档口和餐段是否正确。
- 批量维护未来菜谱时，优先使用“复制菜谱”，再少量调整差异菜品。
- 离线设备可先保存排菜，但需要在设备恢复在线后刷新确认。
- 修改系统设置后，建议返回首页再进入业务页，确认主题、字号和业务数据刷新正常。
9. 管理员信息
| 类型 | 默认值 | 说明 |
|---|---|---|
| 登录账号 | admin | 本机固定账号 |
| 登录密码 | 123456 | 可在系统设置中修改 |
| 管理员密码 | cpt123 | 用于进入系统设置 |
| 默认服务地址 | https://zhctdev.yyangpt.cn | 可在系统设置中修改 |
如现场账号、密码或服务地址已经由实施人员调整，请以实际交付配置为准。