2026-07-13 取餐上传策略常量注释

变更目的

为 PickMealUploadPolicy 中的全部业务常量逐项补充中文注释，使维护人员无需追踪调用链即可理解数值单位、状态含义和触发来源。

本次仅增加注释，不修改任何常量值或运行逻辑。

注释内容

策略参数

• BATCH_LIMIT：单个周期最多处理 20 条，避免积压数据长时间占用线程。
• MAX_FAILURE_COUNT：累计失败达到 10 次后进入 FAILED_FINAL。
• REALTIME_MAX_ATTEMPTS：实时上传最多请求 3 次，包含首次请求。
• MIN_UPLOAD_WEIGHT_GRAM：最小上传重量为 5g，不足时进入 IGNORED。
• RETRY_INTERVAL_MILLIS：周期补传检查间隔为 3 分钟，单位为毫秒。
• UPLOADING_TIMEOUT_MILLIS：上传占用超过 10 分钟后恢复为 FAILED，单位为毫秒。

状态常量

补充 PENDING、UPLOADING、UPLOADED、FAILED、FAILED_FINAL、REJECTED、IGNORED 的业务语义及是否允许继续补传。

触发来源

补充 REALTIME、PERIODIC、STALE_RECOVERY 分别代表实时上传、周期补传和超时占用恢复。

验证记录

执行：

git diff --check
JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash ./gradlew -q :app:testDebugUnitTest :app:compileDebugJavaWithJavac --no-daemon

结果：命令退出码为 0，10 项单元测试及 Debug Java 编译通过。构建输出仍包含项目原有的 Java 主版本、过时 API 和未检查操作警告，本次没有新增编译错误。

影响范围

• 仅修改 PickMealUploadPolicy.java 的注释。
• 不修改 Android 端补传策略和状态迁移。
• 不修改服务端接口。