Skip to content

feat(android-core): LowBalancePolicy 与 BackgroundRefreshDecision 纯策略 + JVM 测试 #13

Closed

Description

@Qiyuanqiii

Parent: #17

背景

后台刷新与低余额通知需要两个纯决策逻辑。为守住「:core 决定应做什么,:app 决定用 Android 怎么做」的边界,并让它们能被现有 :core:test(JVM、无设备)覆盖,必须放 :core(:app 无测试设施,引入 Robolectric 属新依赖)。

LowBalancePolicy

输入:balance: Double、threshold: Double(默认 1.0)、alerted: Boolean(上次提醒状态,由 App 层持久化)。
输出:LowBalanceDecision(shouldNotify: Boolean, alerted: Boolean)。

条件 shouldNotify alerted
balance <= 0 false 不变
0 < balance < threshold 且 alerted == false true true
0 < balance < threshold 且 alerted == true false true
balance >= threshold false false(恢复重置)
  • 不依赖 NotificationManager / Context / SharedPreferences / androidx.work
  • alerted 持久化由 App 层负责(SharedPreferences 非敏感标志),policy 只返回新状态

BackgroundRefreshDecision

输入:PlatformErrorKind + apiCode(40002/40003 判定复用 PlatformException.isTokenExpired)。
输出:平台无关枚举 RETRY | COMPLETE;App 层 Worker 映射为 Result.retry() / Result.success()。

情况 决策 理由
无 Token COMPLETE 需用户登录,重试无意义
NETWORK RETRY 临时网络异常
40002 / 40003 COMPLETE 避免失效 Token 无限重试
其他 HTTP / API / DECODING COMPLETE 不可恢复,避免无休止重试

测试(:core:test 新增)

  • LowBalancePolicyTest:balance=0 / <threshold / =threshold / >threshold;首次低余额通知;重复低余额不通知;恢复后 alerted 重置;恢复后再次跌破可再通知
  • BackgroundRefreshDecisionTest:NETWORK→RETRY;EMPTY_TOKEN / TokenExpired(40002,40003) / HTTP / API / DECODING→COMPLETE

不得在 Core 测试中直接测试 NotificationManager / WorkManager / Context / Permission Launcher(属 App 层)。

验收条件

  • ./gradlew :core:test 全绿
  • :core 未新增任何 androidx 依赖(返回领域枚举,不引用 ListenableWorker.Result)

涉及文件

  • 新增 android/core/src/main/kotlin/com/deepseek/meter/core/LowBalancePolicy.kt
  • 新增 android/core/src/main/kotlin/com/deepseek/meter/core/BackgroundRefreshDecision.kt
  • 新增对应测试文件

阻塞关系

Activity

  1. Qiyuanqiii commented on Aug 16, 2026

    @Qiyuanqiii
    MemberAuthor

    PR 已提交:#20。四个 commit:两个纯策略(:core,零 androidx 依赖)+ 两个测试类(16 个用例)。合并后解除 #15 的「纯策略」阻塞。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    androidAndroid 平台相关

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions