Skip to content

feat(android): WorkManager 后台余额刷新 + 低余额本地通知闭环 #15

Closed

Description

@Qiyuanqiii

Parent: #17

背景

A4 核心功能。前置:#11(依赖准入与 D6 翻转)、#13(两个纯策略)。

方案

WorkManager 调度

BackgroundRefreshWorker 流程

1. 读 lowBalanceAlertsEnabled == false → Result.success()(防御性 early-return)
2. KeystoreTokenStore 读 Token;无 Token → Result.success()
3. PlatformService.fetchSummary(),取 normalWallets.firstOrNull()(与 AppModel 同规则,保证通知币种与 UI 一致)
4. 读上次 alerted 状态 → LowBalancePolicy.evaluate()
5. shouldNotify 且 areNotificationsEnabled() → LowBalanceNotifier.notify()
6. 持久化新的 alerted 状态
7. 错误映射:BackgroundRefreshDecision → RETRY→Result.retry();COMPLETE→Result.success()

Token 严禁进入 WorkManager InputData(会落 WorkManager 数据库),由 Worker 自行从 Keystore 读取。

通知开关闭环

  • OFF→ON:未授权→解释用途并请求;已授权→保存 enabled=true → enqueueUniquePeriodicWork(UPDATE)
  • ON→OFF:保存 enabled=false → cancelUniqueWork(...) → 重置 alerted 状态
  • 双保险:Worker 每次执行先检查开关

通知权限三态(Android 13+ POST_NOTIFICATIONS)

  1. 未请求:设置页开启开关时解释用途并请求
  2. 曾拒绝但仍可请求:以 areNotificationsEnabled() 为事实依据;shouldShowRequestPermissionRationale 仅作提示参考,不自动弹窗骚扰
  3. 永久拒绝:开关保持 disabled + 提示「通知权限已关闭,请在系统设置中允许」+ 提供系统设置入口

拒绝时余额/用量/趋势/登录等所有非通知功能必须完全正常。

币种、阈值与去重

  • 阈值:0 < balance < 1.0,1.0 表示「当前钱包币种的一个单位」(CNY→¥1.00、USD→$1.00)
  • 通知文案用 currencySymbol(currency),不硬编码 ¥
  • alerted 状态持久化于 SharedPreferences(非敏感标志)

NotificationChannel

  • minSdk 26 起创建 Channel;纯本地通知,无任何第三方推送

验收条件

  • 多次进入设置页 / 重启不产生多个后台 Worker
  • 关闭开关后 Unique Work 被 cancel;即使被系统调度也立即 success 不联网
  • 低余额首次出现通知一次;持续低余额不重复;恢复重置;再次跌破再通知
  • Token 失效(40002/40003)→ success 不无限重试;临时断网 → retry
  • 非 CNY 钱包阈值与文案使用实际币种
  • 拒绝/永久拒绝通知权限不影响其他功能;永久拒绝有系统设置入口
  • Token 不出现在 Logcat / WorkManager Data / SharedPreferences 明文

涉及文件

  • android/app/build.gradle.kts(新增 work 依赖)
  • 新增 android/app/src/main/kotlin/com/deepseek/meter/app/background/BackgroundRefreshWorker.kt
  • 新增 android/app/src/main/kotlin/com/deepseek/meter/app/background/BackgroundRefreshScheduler.kt
  • 新增 android/app/src/main/kotlin/com/deepseek/meter/app/notification/LowBalanceNotifier.kt
  • android/app/src/main/kotlin/com/deepseek/meter/app/SettingsScreen.kt(通知开关 + 权限三态 UX)
  • android/app/src/main/AndroidManifest.xml(POST_NOTIFICATIONS)

阻塞关系

非目标

  • ❌ 后台余额快照冷启动复用(独立增强 / A5)
  • ❌ Firebase / 第三方推送

Activity

  1. Qiyuanqiii commented on Aug 16, 2026

    @Qiyuanqiii
    MemberAuthor

    PR 已提交:#23。6 个 commit:Worker / Scheduler / Notifier / gradle 依赖 / manifest 权限 / 设置页开关。阻塞项(#11、#13)已解除。请 review;真机通知矩阵在 #16 QA 阶段执行。

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 平台相关blocked被其他 issue 阻塞

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions