重庆环卫余额模式页面改版变更记录

变更日期

2026-08-27

需求范围

• 页眉替换为重庆环卫新图标，保持原 60dp 显示高度，宽度按图标比例自适应。
• 仅余额模式（MODE_1）启用新的打餐前、打餐时页面；纯营养模式和现金/补贴双余额模式继续使用旧页面。
• 新页面独立放入 fragment/chongqinghuanwei/，不修改原打餐页面实现。
• 新页面金额单位统一为“星”。
• 疾病标签最多展示 4 个，名称和颜色读取现有接口缓存；绿色、红色、黄色分别表示推荐、慎用、适量，未知颜色使用中性样式。
• 建议取用在接口字段提供前固定展示 0g。
• 累计取用按“服务端当前菜品、当前称重台累计值 + 本次取用”展示；服务端字段暂缺时默认从 0 开始累加。

实现内容

1. 新增重庆环卫打餐前和打餐时 Fragment、独立布局、卡片/标签资源及统一展示计算器。
2. 在 GetStaffNutritionDetails 增加未带序列化注解的 currentDishTableCumulativeWeight 字段，默认值为 0；等待接口字段确认后再关联注解。
3. 打餐时页面保留原称重包忽略、小范围波动过滤、扫码结束上传取餐克重及未绑定餐盘语音提示链路。
4. 在 WeightMainActivity 按 HomeDisplayMode 路由余额模式新页面，并让扫码结束逻辑读取新页面的纯数字本次取用值。
5. 新图标由用户提供的 PNG 等比缩放为 984×239 RGBA 资源，ImageView 使用 wrap_content + adjustViewBounds + fitCenter。
6. 新页面视觉尺寸、颜色、文案和业务常量集中定义，避免在 Fragment 内写死疾病名称、金额单位和尺寸。

主要文件

• app/src/main/java/com/zhct/traybinding/fragment/chongqinghuanwei/
• app/src/main/res/layout/fragment_chongqing_huanwei_pick_before.xml
• app/src/main/res/layout/fragment_chongqing_huanwei_pick_ongoing.xml
• app/src/main/res/values/chongqing_huanwei_resources.xml
• app/src/main/res/drawable-nodpi/chongqing_huanwei_header_logo.png
• app/src/main/java/com/zhct/traybinding/main/WeightMainActivity.java
• app/src/main/java/com/zhct/traybinding/network/response/GetStaffNutritionDetails.java
• app/src/test/java/com/zhct/traybinding/fragment/chongqinghuanwei/ChongqingHuanweiDisplayCalculatorTest.java

验证结果

• TDD 红灯：新增计算测试在实现前因缺少计算器和累计字段失败，符合预期。
• TDD 绿灯：目标计算测试通过。
• 完整构建与单测：:app:assembleDebug :app:testDebugUnitTest 通过。
• 新增 XML 已通过 xmllint --noout 校验。
• 静态隔离检查确认：旧打餐 Fragment/Layout 未修改；新页面未出现“元”和固定 900dp 右栏；4 个疾病名称未硬编码。

待真机验收

• 目标分辨率下打餐前/打餐时页面的字体、间距和四标签极限展示。
• 余额模式与模式 2/3 之间的页面路由隔离。
• 服务端累计取用为 0、非 0 两种情况下，本次取用累加展示是否符合现场数据。
• 扫码结束后取餐上传克重与旧页面一致。

本次未自动安装 APK 到已连接设备，避免影响现场状态；未执行 Git 暂存、提交或推送。