All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 10m17s
- 每日扫描不再给个人客户写临期通知,店铺通知不变 - H5 资产信息在当前资产剩余 0~15 天且当天首次进入时返回 expiry_reminder,并为该客户、该资产写一条临期通知(Redis 去重,失败不占键) - 个人通知列表、未读数、全部已读中临期提醒只处理当前资产(按 ref_key) - OpenSpec Change scope-expiry-reminder-to-current-asset:6/9,临期 fixture 端到端验证与每日扫描验证待测试部署后完成
2.9 KiB
2.9 KiB
Context
承接《第1批-8-9月迭代缺陷修复技术方案》第 4 节。packageexpiry 的 Publish 在每日扫描中给店铺接收人(appendShopNotification)和所有绑定客户(loadRecipients)批量写通知;个人通知列表(PersonalNotificationListRequest,internal/model/dto/notification_dto.go:94)无资产过滤。H5 令牌带当前资产(middleware.GetCurrentAsset),资产信息接口为 GET /api/c/v1/asset/info。Outbox 写入按 event_id 冲突忽略(internal/infrastructure/messaging/outbox/repository.go:103)。
Goals / Non-Goals
Goals: 临期提醒只在客户进入该资产时出现,每天一次;通知中心只显示当前资产的临期提醒。
Non-Goals: 不改到期推算、提醒窗口与等级、店铺通知;不新增接口入参;无迁移。
Decisions
- 进入时判定,复用最终到期推算。 在资产信息接口内按当前资产调用
packageexpiry的推算,与每日扫描同口径。 - 去重顺序:先查键 → 写通知 →
SET NX→ 抢到才返回字段。 方案原顺序是“先写通知再SET NX”,当天每次进入都会写一次 Outbox(虽冲突忽略,仍是无效写)。评审确认先用 RedisEXISTS/GET检查,键存在直接返回,只有未提醒时才写通知。写通知成功后才占键,写失败不占键、不返回字段,避免“当天已去重但通知没发出”。两个并发请求都通过检查时,通知由事件号幂等,只有抢到键的一方返回字段。键定义放pkg/constants/redis.go,TTL 到当天上海时间结束再加缓冲。 - Redis 不可用按未提醒处理。 字段可能当天多次返回,通知由事件号兜底不重复;接受该降级,不因 Redis 故障让资产信息接口失败。
- 只用
ref_key过滤,列表、未读数、全部已读同一口径。ref_id不带资产类型,卡 5 与设备 5 冲突。过滤只作用于type = package.expiring AND ref_type = asset。“全部已读”(PUT /notifications/read-all)也加同样的条件,否则会把客户在其他资产才能看到的临期提醒一并标为已读。 - 停用个人客户预发布。 去掉
Publish里给绑定客户批量写通知的循环,店铺通知不变。
Risks / Trade-offs
- [GET 接口产生写副作用] → 只在当天首次命中时写一次通知,其余请求只读 Redis。
- [设备补虚拟号后历史提醒匹配不上] → 影响可接受,已在 spec 中写明。
- [资产信息接口延迟增加] → 推算与 Redis 检查各一次;推算结果为非临期时不访问 Redis。
Migration Plan
无迁移。测试环境部署后,每日扫描不再产生个人客户临期通知;已有个人通知按过滤规则展示。
Open Questions
- 资产信息响应中提醒字段的具体命名在实现时确定,并写入接口文档。