feat(H5弹窗): AUG26-007 风险换卡与运营弹窗投放通知
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m23s

新增 000225 迁移:运营弹窗配置表 tb_h5_popup_configuration(页面/范围/优先级/频率/受控动作/启停/有效期/版本)
与 tb_notification 可空 JSONB 列 popup_snapshot。

新增通知直建窄接口 DirectWriter.CreateOrGetPersonal:与 Outbox 消费共用 prepareDelivery 的渲染、
展示期与 CreateIdempotent 规则,冲突时回查返回既有行;同步扩展个人通知查询与已读两处类型白名单,
并按个人客户入口补齐投递审计来源。

新增 H5 候选与风险换卡:GET /api/c/v1/popup-candidates 先判风险资格(广电卡 + 风险停机 +
无活动物流换货单),命中只返回风险候选;未命中再按时间/启停/页面/店铺/设备类型/卡类型范围/频率
匹配运营配置。POST /api/c/v1/risk-exchanges/:asset_id/address 锁资产行后幂等创建待发货物流换货单,
首次地址锁定,不沿用资产级群发通知。

新增后台运营弹窗配置 CRUD 与启停(仅超级管理员与平台账号),更新递增版本并刷新最近更新时间,
标题与正文统一拒绝 URL 与前端路由,全部写操作记录操作者、前后值、版本与时间。

同步 OpenAPI(cmd/gendocs、cmd/api/docs.go、pkg/openapi/handlers.go)与参数校验中文提示共用实现。
This commit is contained in:
2026-09-15 15:23:52 +08:00
parent 70e680eb0a
commit 333ba4b647
39 changed files with 2861 additions and 166 deletions

View File

@@ -192,6 +192,10 @@ const (
CodeEmployeeCollectionBillClosed = 1242 // 账单已关闭
CodeEmployeeCollectionVoucherInvalid = 1243 // 支付凭证数量或内容不符合要求
// H5 弹窗相关错误 (1250-1259)
CodeH5PopupConfigurationNotFound = 1250 // 运营弹窗配置不存在
CodeH5PopupRiskNotEligible = 1251 // 当前资产不满足风险换卡条件
// 服务端错误 (2000-2999) -> 5xx HTTP 状态码
CodeInternalError = 2001 // 内部服务器错误
CodeDatabaseError = 2002 // 数据库错误
@@ -350,6 +354,8 @@ var allErrorCodes = []int{
CodeEmployeeCollectionApplicationPending,
CodeEmployeeCollectionBillClosed,
CodeEmployeeCollectionVoucherInvalid,
CodeH5PopupConfigurationNotFound,
CodeH5PopupRiskNotEligible,
CodeInternalError,
CodeDatabaseError,
CodeRedisError,
@@ -502,6 +508,8 @@ var errorMessages = map[int]string{
CodeEmployeeCollectionApplicationPending: "账单存在审批中核销申请,不能关闭",
CodeEmployeeCollectionBillClosed: "账单已关闭",
CodeEmployeeCollectionVoucherInvalid: "支付凭证数量或内容不符合要求",
CodeH5PopupConfigurationNotFound: "运营弹窗配置不存在",
CodeH5PopupRiskNotEligible: "当前资产不满足风险换卡条件",
CodeInvalidCredentials: "用户名或密码错误",
CodeAccountLocked: "账号已锁定",
CodePasswordExpired: "密码已过期",