MultipurposeMachine 本分支页面功能说明

构建验证：已执行 JAVA_HOME=$(/usr/libexec/java_home -v 1.8) sh ./gradlew assembleDebug，结果 BUILD SUCCESSFUL。截图均来自已安装 Debug 包的真实页面；营养报告使用真实人员 11111 的接口数据触发页面渲染后采集。

启动页

StartActivity

入口桌面 Launcher，或 com.zhct.multipurpose/.StartActivity 定位应用初始化、权限检查、接口配置校验、人脸模型/人员库准备。

主要功能

• 检查设备配置、API 地址、配对码、通信密钥等基础条件。
• 申请相机、存储、网络等运行权限。
• 初始化人脸 SDK、模型和本地人员库，同步启动过程日志。
• 初始化完成后跳转到首页。

本分支变化

• 接入统一标题栏与网络状态展示。
• 启动页使用专用主题，降低启动白屏感知。
• 进度文案与 Toast 处理做了细节调整。

首页功能入口

MainActivity

入口启动完成后进入，或 .main.MainActivity 定位一体机主入口，集中承载高频业务页面跳转。

主要功能

• 展示菜谱、我的营养、人员管理等核心入口。
• 底部保留新增/设置等快捷入口。
• 标题栏展示设备 Logo、网络状态和进入设置的长按能力。

本分支变化

• 旧 HomeActivity 和旧绑定/扫码首页流程已移除。
• “打印餐单”入口调整为“餐厅菜谱浏览”。
• 首页视觉改为蓝色背景、深色标题块和 2x2 功能卡片。

餐厅菜谱浏览

FoodListActivity

入口首页“餐厅菜谱” 定位按日期、餐次和分类浏览餐厅菜品。

主要功能

• 默认根据当前时间匹配早餐、午餐、晚餐或夜宵。
• 支持选择日期、切换餐次、按全部/主食/荤菜/素菜/奶类/水果/汤粥分类过滤。
• 点击菜品后打开详情弹窗，展示图片、分类和营养信息。
• 接口为空或未配置时展示空态；有数据时以卡片网格展示菜品。

真实数据状态

• 依赖餐段配置接口、菜品列表接口和菜品详情接口。
• 截图展示真实接口返回的菜品列表，长图覆盖页面下滑后的全部列表区域。

营养报告

NutritionReportActivity

入口首页“我的营养” 定位人员识别后的营养日报和健康周报展示页。

主要功能

• 顶部支持“营养日报 / 健康周报”切换。
• 日报展示当日餐单、膳食摄入、供能比、食物类别、维生素和限制性营养项。
• 周报展示就餐次数、饮食习惯、膳食宝塔、Top5 菜品和周区间导航。
• 状态项统一用上升、正常、下降图标表达。

真实数据状态

• 依赖先识别人员后获得人员 UUID。
• 日报截图展示真实接口返回的当日餐单、摄入分析、食物类别和关键营养素。
• 周报截图展示真实接口返回的本周就餐、膳食宝塔、菜品习惯和饮食提示。

人员管理

FaceManagerActivity

入口首页“人员管理” 定位按部门检索人员，并维护人员人脸照片。

主要功能

• 部门弹窗选择当前部门。
• 支持人员搜索、分页加载、空态展示和列表刷新。
• 长按人员卡片打开拍照/上传人脸流程。
• 上传成功后刷新对应人员状态。

本分支变化

• 部门接口切换为扁平部门列表。
• 列表分页状态和切部门后的旧数据清理更明确。
• 标题栏网络状态由 BaseActivity 统一处理。

设置页

SettingActivity

入口首页底部设置，或标题栏长按入口 定位设备基础配置和高级调试能力入口。

主要功能

• 基础设置：API 地址、配对码、设备编号、人脸检测超时、注册失败切换、播音开关、版本检查。
• 高级设置：串口测试入口、摄像头选择、摄像头预览和保存。
• 返回时保留原有配置校验逻辑。

本分支变化

• 版本项从静态弹窗改为请求最新版本接口，并打开下载链接。
• 新增串口测试页入口和摄像头选择能力。

串口测试

SerialPortTestActivity

入口设置页 - 高级设置 - 串口测试 定位现场验证刷卡、扫码、打印机串口链路。

主要功能

• 刷卡器串口：/dev/ttyS3，波特率 9600。
• 扫码器串口：/dev/ttyS4，波特率 9600。
• 打印机串口：/dev/ttyS5，支持连接、断开、状态查询、测试打印和餐票打印。
• 页面展示最近操作、接收次数、字节数、原始数据和打印机状态。

本分支变化

• 新增 hardware/printer 打印管理封装。
• 接入 autoreplyprint.aar 串口打印能力。

崩溃提示页

CrashActivity

入口未捕获异常后由 CrashHandler 拉起 定位异常兜底、日志落盘和用户确认重启。

主要功能

• 捕获未处理异常后保存 App 信息、设备信息和堆栈日志。
• 进入独立 :crash 进程，避免主进程初始化再次干扰。
• 弹窗提示用户确认重启或取消退出。

本分支变化

• 替换旧的崩溃重启处理，新增显式崩溃提示页面。
• Crash 进程中跳过主应用初始化。