DishManagementActivity 菜谱识别切换同步变更方案

1. 目标

• 不打开：页面和 AI SDK 使用服务端全部学习记录。
• 打开：页面和 AI SDK 只使用当前餐次菜谱内的学习记录。

2. 当前实现与问题

2.1 当前进入页面的同步链路

1. 调用 DishCatalogRepository.syncAllAsync()，分页拉取全部菜品基础目录。
2. 菜品目录成功后才进入学习记录同步。
3. 根据菜谱识别开关决定是否拉取当前菜谱。
4. 拉取学习图片、重建 SDK 特征、替换本地学习目录。
5. 最后刷新页面列表。

2.2 当前开关切换逻辑

DishMenuStore.setMenuRecognitionEnabled(enabled);

当前只保存配置，不同步本地学习目录和 SDK 特征，也不刷新页面列表。 因此开关显示、页面内容和设备实际识别范围可能不一致。

2.3 名称和价格数据

• /p/api/getMeal 返回完整 DishBean，包括编码、名称、价格、单位和图片。
• /api/consume/dishesRecognizeImgList 只返回学习图片 ID、菜品编码、图片地址和特征。
• 当前 DishMenuStore.saveCurrentMenu() 只保存编码集合，完整菜品信息没有用于管理页展示。

打开模式应保留本次菜谱响应中的完整 DishBean 供页面展示， 不需要为名称和价格再次拉取全部菜品目录。

3. 变更范围

计划修改

• app/src/main/java/com/cpt/aidishrecognition/activity/DishManagementActivity.java
• app/src/main/res/values/strings.xml（仅在新增切换提示时修改）

计划复用

• AiReadinessGuard
• DishLearningStore.FullSyncSession
• DishMenuStore
• DishCatalogRepository 的本地查询能力
• 现有菜谱、学习记录和 SDK 修正接口

非目标

• 不修改服务端接口，不删除全局 DishCatalogRepository。
• 不修改首页和识别页的公共菜品目录同步策略。
• 不修改识别页“未排菜”的判定和支付规则。
• 不改变打开模式下空菜谱形成空学习数据的现有语义。
• 不重构整个菜品学习模块。

4. 目标处理逻辑

4.1 页面进入

1. 初始化页面后立即读取本地学习目录并展示。
2. 读取已经生效的模式并设置开关初始状态。
3. AI SDK 就绪后，按当前模式同步学习记录。
4. 成功后刷新列表；失败时保留进入页面前的数据。

4.2 点击“同步记录”

按当前已经生效的模式执行学习记录同步。成功刷新列表；失败保留原本地目录、 原 SDK 特征和原开关配置。

4.3 切换为“打开”

1. 暂时显示目标选项，并禁用重复点击。
2. 请求当前餐次菜谱，保留完整 DishBean。
3. 分页拉取学习记录，只下载命中当前菜谱的图片。
4. staging 准备完成后调用 SDK 重建特征。
5. SDK 和目录提交均成功后，保存“打开”配置。
6. 页面只显示菜谱内已有学习记录的菜品。

4.4 切换为“不打开”

关闭模式重新下载全部学习记录，恢复完整本地学习目录和全部 SDK 特征， 清除当前页面的菜谱展示缓存，最终显示全部已学习菜品。

4.5 切换失败

• 不保存目标模式配置。
• 静默恢复原 RadioGroup 选项，避免再次触发监听器。
• 回滚 staging，正式目录和原 SDK 数据保持不变。
• 页面继续展示原模式列表，恢复所有控件。
• SDK 返回 NOT_ACTIVE 时继续交给 AiReadinessGuard。

5. 设计决策

建议同步接口

syncLearningDataForMode(
    boolean targetMenuRecognitionEnabled,
    SyncReason reason
);

同步原因至少区分页面初始同步、手动同步和用户切换模式。 三种入口共用数据同步内核，只在配置提交、失败回退和提示语上区分。

6. 建议代码结构

onCreate
  ├─ initViews
  ├─ fetchDishList                 # 立即展示本地数据
  └─ runAfterAiReady
       └─ syncCurrentMode

menu switch listener
  └─ requestModeSwitch(targetMode)
       ├─ disable controls
       ├─ syncLearningDataForMode(targetMode)
       ├─ success: persist + refresh
       └─ failure: restore switch + keep old data

manual sync
  └─ syncLearningDataForMode(appliedMode)

建议增加的 Activity 内部状态：

• 已经生效的模式 appliedMenuRecognitionEnabled
• 静默修改开关标记 suppressMenuSwitchCallback
• 同步中标记 learningSyncInProgress
• 本次成功菜谱的 Map<String, DishBean>
• 同步结果回调或内部结果对象

7. 实施任务拆分

./gradlew :app:testDebugUnitTest
./gradlew :app:assembleDebug

8. 验收场景

9. 风险与控制

回退方案

1. 恢复开关只保存配置的旧监听逻辑。
2. 恢复 syncDishList() 中原有同步入口。
3. 保留 staging、commit、rollback 的原子目录保护。
4. 回退后重新执行一次完整学习记录同步，确保 SDK 与正式目录一致。

10. 人工评审清单

• 同意移除当前页面的全部菜品基础目录强制同步。
• 同意页面进入后先展示本地数据。
• 同意切换成功后才保存配置。
• 同意切换失败自动恢复原选项。
• 同意打开模式直接使用最新菜谱中的名称和价格。
• 空菜谱沿用现有业务规则：打开模式下形成空学习数据。
• 切换过程不增加额外二次确认弹窗。
• 已进入代码实施并完成自动化验证。
• 待指定目标设备后完成打开、关闭、失败回退和空菜谱真机验证。

人工评审状态：用户已确认并授权实施。

接受的经验：模式配置必须在数据与 SDK 提交成功后再写入。

拒绝的反模式：只切换开关配置，不同步页面列表和实际识别数据。

待决问题：指定真机回归目标。

12. 实施结果

已完成

• 页面进入后先绑定现有本地学习记录。
• 移除当前页 DishCatalogRepository.syncAllAsync() 强制前置同步。
• 打开模式先拉取最新菜谱并按编码过滤；关闭模式恢复全部学习记录。
• 模式切换成功后才写入配置，失败时静默恢复原选项。
• 同步期间禁用开关和同步入口，避免重复 full-sync。
• 打开模式列表优先使用本次菜谱返回的完整 DishBean。
• SDK 未激活时保留目标模式请求，激活成功后可继续原同步流程。
• 新增纯逻辑策略和单元测试，覆盖全量、过滤、空菜谱和菜品映射。

自动化验证