Skip to content

feat(android): 校园卡消费提醒与后台账单检查 - #197

Open
steven42121 wants to merge 1 commit into
HeZeBang:masterfrom
steven42121:codex/spending-alerts
Open

steven42121 wants to merge 1 commit into
HeZeBang:masterfrom
steven42121:codex/spending-alerts

Conversation

@steven42121

Copy link
Copy Markdown
Contributor

Android 用户现在可以在设置中开启校园卡消费提醒。应用刷新或后台检查发现新消费时,通知显示金额、商户/地点与余额;首次成功读取只建立基线,不把旧账单当作新扣费。

  • 默认关闭;需已同意隐私政策、登录主账号、绑定校园卡并允许 Android 通知。
  • 前台付款/账单刷新与 WorkManager 后台检查共用一个原生去重账本,避免多个 Flutter 引擎重复通知。退款、充值、补贴和转账不会被当成消费。
  • 单次最多显示三条,其余折叠,只有第一条可发声;锁屏采用 private visibility。只持久化账号范围哈希、最多 200 条交易 ID 哈希与时间戳,不记录凭证或通知正文。
  • 关闭提醒、退出或切换账号会取消后台任务、清除已显示的消费通知并重置基线;generation 校验丢弃旧请求,包括关闭后又以同一账号开启的情况。
  • 后台任务有网络约束、15 分钟最小调度间隔、60 秒执行上限与有限重试。引擎/通道在 Android 主线程创建和释放,不引入保活或前台服务。

这是账单轮询后的提醒,不是校园卡服务端实时推送,无法保证到达时间。只读取最近至多 50 条账单;迟到且早于保留去重窗口的交易可能不提醒。首次读取、系统限制和真实校园交易仍需设备验收。

与现有 PR 的关系:独立基于上游 master aaefb6a,不依赖 #194/#195/#196。上课前提醒已经在 #195(标题和说明已标清),#194 是课程状态灵动通知。本 PR 只提取消费提醒及必要的后台账单检查。

发行兼容:保留上游应用 ID、最低 Android API 24、1.0.4+26 版本、签名配置、Dart 依赖锁、Apple Watch/iOS 实现及发布工作流。Android 只增加 WorkManager 2.9.1 和原生单元测试依赖;没有带入 RCCE 的测试签名、版本号或更新渠道。

验证:Flutter 静态分析通过;777 项 Flutter 测试通过,其中包含 18 项新增服务/账单集成测试;9 项原生去重单元测试通过;Android debug 及开启压缩的 release APK 构建通过,实际 manifest 为 API 24/1.0.4+26;release 验证仅使用本地测试签名,签名配置未提交修改。代码说明见 docs/spending-alerts.md。

完整 Android lint 的新增代码无错误;仍报告上游已有的两项问题:EcardBindVpnService.kt 的 API-28 私有 DNS 诊断调用,以及基础 manifest 的可选相机声明。未在本 PR 中压制或混入这两项无关修改。本地仅为解决 Git 依赖下载不稳定,使用上游固定提交源码归档;提交的 pubspec/lock 与上游一致,未提交路径覆盖。

Copilot AI balanced review requested due to automatic review settings November 16, 2026 16:57
@github-project-automation github-project-automation Bot moved this to Backlog in TechPie Nov 16, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

This branch has not been deployed

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

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

2 participants