SubTrack——鸿蒙原生订阅管理应用

1. 订阅列表：围绕下一次续费组织信息#

每条 SubscriptionRecord 包含服务名称、分类、金额、币种、扣费周期、锚定日期、下一次扣费日期、自动续费状态、提醒天数、付款方式、图标、卡片背景和备注等字段。

应用支持周、月、季度、年和自定义天数周期。用户可以新增、编辑、暂停、恢复、取消和删除订阅，也可以按名称搜索，并在列表和网格布局之间切换。

列表排序优先考虑 next_charge_date，这让首页首先回答“最近要发生什么”。周期计算则由 RecurrenceCalculator 负责，数据仓库不需要把每一种周期规则散落在各个页面的点击事件里。

2. 续费日历：把日期和提醒交给系统能力#

日历页面提供周、月、年三种视图。页面显示续费次数、预计总额和最高单笔金额，用户点击某一天后可以查看当天的订阅安排。

ReminderCalendarService 负责把应用中的有效订阅同步到系统日历。同步前会申请读写日历权限，生成或获取应用自己的日历账户，然后删除旧事件、重新计算未来事件并保存应用内的提醒绑定。这样可以避免用户修改订阅日期后，系统里残留过期提醒。

同步策略还会处理“提醒时间已经过去但续费日期还没有到”的情况：如果原定提醒点已经错过，服务会根据距离续费的剩余时间计算一个仍然有效的提醒，而不是直接写入一个已经失效的通知。

3. 消费洞察：从记录生成长期视角#

洞察页把订阅数据转换成几种更容易理解的指标：月度承诺、年度承诺、未来六个月趋势、年度扣费热力图和分类构成。

数据层区分预计金额和实付金额。订阅创建时产生的是预计支出，用户确认下一次扣费后，数据库会写入对应的 charge_occurrences 记录和实际金额。这样既能看到未来计划，也能回顾真实发生过的费用。

从工程角度看，洞察页并不需要另建一套数据源，它只需要读取订阅表和扣费发生表，按日期、分类和状态聚合即可。只要底层记录保持结构化，后续增加新的统计卡片不会破坏订阅编辑流程。

4. 主题与交互：原生材质之外保留可控参数#

SubTrack 在 module.json5 中启用了 ohos.arkui.UIMaterial.state，并在页面中使用 HDS 导航、底部 Tab、系统材质和点光源反馈。主题设置支持跟随系统、浅色和深色模式，也支持多套强调色。

动画设置没有只提供一个“开关”，而是拆成动画强度、动画幅度、阻尼和减少动态效果等选项。用户可以在不改变业务数据的情况下调整交互节奏，这些偏好通过 preferences 持久化。

项目里还保留了沉浸光感和智感握持等 HarmonyOS 原生交互增强能力。它们属于能力受设备和系统版本影响的增强层，核心订阅流程并不依赖这些效果，因此即使设备不支持，账本、日历和备份仍然可以正常运行。

5. 本地数据与加密备份#

SubscriptionRepository 使用 relationalStore 创建 subtrack.db，维护订阅、扣费发生、分类、服务模板、付款方式和提醒绑定等表，并通过数据库版本号执行结构迁移。

导出备份时，应用先把多张表整理成一个 BackupSnapshot，再交给 BackupCryptoService。加密流程包括：

1. 为每次备份生成随机 salt 和 IV。
2. 使用 PBKDF2-SHA256 从用户密码派生 256 bit 密钥。
3. 使用 AES-256-GCM 加密 JSON 载荷，并保存认证标签和 AAD。
4. 将算法、版本、KDF 参数、IV、认证标签和密文封装为备份 envelope。
5. 导入时先校验格式和版本，再按相同参数解密，最后进入覆盖确认流程。

备份文件不是数据库文件的简单复制，而是一个带版本和认证信息的可迁移数据格式。这样可以在未来升级字段时保留兼容判断，也能在密码错误或文件被修改时拒绝恢复。

6. 华为账号与应用服务#

“我的”页面可以通过 Account Kit 授权读取华为账号头像和昵称。HuaweiAccountProfileService 会校验授权请求和响应中的 state，再把头像缓存到应用沙箱中，页面只保存本地可用的展示信息。

应用更新页面使用 AppGallery Kit 检查版本、展示版本详情，并在检测到新版本时引导用户前往应用市场。语言、货币和主题等设置则保存在本地 preferences，支持中文、英文、日语以及多种离线记账币种。