948 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
邹进	7e54fe2ba7	fix: 企微审批选填附件控件为空列表时跳过，避免非客户收款退款提交失败 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-14 17:10:48 +09:00
邹进	bcb1ce0653	fix: 退款审批退款凭证误取客户收款凭证导致非客户收款方式提交失败 ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-14 16:57:58 +09:00
邹进	713045a657	fix: 第1批 M9 H5 进入资产的临期个人通知写入即已读 ... H5 进入资产时已同步弹窗展示临期提醒，通知中心再记未读会重复提醒； 通知按剩余天数每天新增一条，保持未读会持续累积红点。 直发通知载荷新增可选 mark_read，仅临期个人通知设置，其他直发通知与店铺临期通知仍为未读。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-14 10:45:20 +09:00
邹进	eb98478b09	docs: 第1批 ②④ 测试环境验证进度 ... - ② 6.4～6.7 完成：结果未知保持审批中、提交失败决策投递、M13 撤销/拒绝/删除定位、核销提交状态 - ② 6.3 五类业务已验证；佣金提现因测试环境未配置审批场景待补验 - ④ 4.2、4.3 完成：进入资产按资产提醒与通知过滤、每日扫描只写店铺通知 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 09:43:57 +09:00
邹进	465016a333	fix: 第1批 F1、M12 换货清空客户绑定的审计写入失败 ... - 换货清空旧资产绑定写 personal_customer.unbind_asset 时，资产资源带主体摘要却缺省为仅内部可见， 被审计写入拒绝并静默降级（“内部事件不得写入主体投影”）；资产资源改为声明结论可见级别。 后台按虚拟号解除绑定（UnbindByVirtualNo）同样受益 - 设备换货完成审计不再把新设备已有的扫码绑定记为“新设备客户绑定”：换货已不迁移绑定 - 测试环境验证 F1（4.3）与 M12（4.4）完成 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 09:21:46 +09:00
邹进	868d969d8e	fix: 补上第1批 M8 提交失败决策写入（6298a906 遗漏） ... - 企微提交被明确拒绝时，在同一事务内写 submission_failed 决策投递记录与终态事件 - Worker 两处 ApprovalContextRepository 注入决策写入器；未注入时提交失败直接报错，不再静默只改实例状态 - 终态决策消费入口单独放行 submission_failed，渠道回调仍不能推进到提交失败 - 6298a906 的编辑脚本在本文件锚点不唯一处中断，三处改动未落盘；本次补齐 - 第1批 ⑤ 5.4、① 5.2/5.4/5.5 测试环境验证完成 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-12 09:09:58 +09:00
邹进	0f1ea5bc3e	fix: 第1批 M9 套餐临期提醒按资产、扫码进入时触发 ... - 每日扫描不再给个人客户写临期通知，店铺通知不变 - H5 资产信息在当前资产剩余 0～15 天且当天首次进入时返回 expiry_reminder，并为该客户、该资产写一条临期通知（Redis 去重，失败不占键） - 个人通知列表、未读数、全部已读中临期提醒只处理当前资产（按 ref_key） - OpenSpec Change scope-expiry-reminder-to-current-asset：6/9，临期 fixture 端到端验证与每日扫描验证待测试部署后完成	2026-10-12 00:15:27 +09:00
邹进	9ced14fa1b	fix: 第1批 F1、M12 一资产一号与换货按手机号关联校验 ... - F1 一个资产同时只能有一个有效手机号关联，他号绑定返回 1192（不含号码），同号幂等 - 登录 need_bind_phone 改看资产是否已有有效关联，新增 asset_phone_bound、asset_phone_is_own；H5 绑定按客户/资产两侧状态分别写入 - 客户换号不再迁移资产关联 - M12 换货新资产有有效手机号关联即拒绝，号码只在 data.phone；换货完成清空旧资产客户绑定并失效旧资产关联（exchange_completed），均不迁移 - OpenSpec Change enforce-single-phone-per-asset：11/16，H5 短信与换货端到端验证待测试部署后完成	2026-10-12 00:10:41 +09:00
邹进	6298a9061f	fix: 第1批 M8、M13、M14 审批提交失败终态与退款关闭类终态定位 ... - 审批核心在实例进入提交失败的同一事务内写 submission_failed 决策投递与终态事件，消费入口单独放行 - 核销(4)、退款(7)、扫码注册(3)、资料资格(4)、线下充值(7)、佣金提现(5)新增“审批提交失败”终态并释放预占/冻结 - 三处恢复入口不再重放提交失败；退款关闭类终态按审批尝试定位退款单（M13） - 核销列表与详情批量返回审批提交状态；筛选、字段说明、状态名称、退款导出加入新状态 - 迁移 000239 放宽五张业务表状态约束与决策投递取值约束（测试库已执行 up/down/up） - OpenSpec Change fix-approval-submission-failure-terminal：18/26，测试部署后端到端验证与存量补数据待完成	2026-10-12 00:03:46 +09:00
邹进	25c081fe60	fix: 第1批 M2、M3、M16、M23 导入与展示类缺陷 ... - M2 批量换绑表头改为“平台登录账号”，只认手机号，细分格式、不存在、多匹配、非平台、已禁用失败原因 - M3 后台订单列表与详情返回 C 端在线购买的交易流水号、支付渠道、商户名称，详情新增全部支付单 payments - M16 预警规则不再返回 real_data_mb，预警列表/详情新增 threshold_mb，导出末列追加“阈值流量(MB)” - M23 设备导入 IMEI 必填，空 IMEI 行记为失败 - OpenSpec Change fix-august-iteration-follow-up-gaps：13/18，导入任务、导出任务的 Worker 端到端验证与前端/运营通知待部署后完成	2026-10-11 23:49:29 +09:00
邹进	260fec7114	fix: 第1批 M1、M4～M6 登录密码统一规则与三类导出补列 ... - 七个设置登录密码入口统一 8～12 位、四类字符至少三类（1001/1016），修改密码与建店铺返回字段级提示 - 订单导出末列“操作人”、IoT 卡导出末列“套餐到期时间”、设备导出流量标 MB 并新增“设备合计(GB)” - 历史导出任务按冻结表头识别新旧尾列，行宽不变 - OpenSpec Change fix-august-iteration-export-and-password-hints：10/12，5.3 前端同步与 5.4 测试部署导出验证待完成	2026-10-11 23:41:40 +09:00
邹进	f56113ba55	fix: 测试环境开启手机号强制绑定 ... API 服务的 JUNHONG_CLIENT_REQUIRE_PHONE_BINDING 由 false 改为 true， 使 H5 验证手机号后写入资产手机号关联，便于验证后台查看与解绑。 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>	2026-10-07 16:21:26 +09:00
邹进	d5826700d5	fix: 恢复退款审批场景可选业务字段「资产标识」 ... 提交 622e99b5 本意是移除与 refund_asset_type 重复的 asset_type， 但在 sceneBusinessFields 退款分支中把 asset_identifier 一并删除。 后果：保存映射时 allowedSceneBusinessField 依据该清单校验， 包含资产标识控件的映射被拒绝，报「企业微信控件映射包含当前业务不支持的字段」； 而模板中的资产标识控件为必填，不映射又会因未映射必填控件被拒，退款场景无法保存。 审批快照生成处（creation.go）仍写入 asset_identifier，故仅字段清单缺失。 本次仅在退款分支恢复该字段，asset_type 保持删除。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>	2026-09-27 12:07:32 +09:00
break	b09275a0d0	修复待处理换货资产归属	2026-09-24 12:30:33 +08:00
break	390769ab7a	1	2026-09-24 11:48:42 +08:00
break	34f91f129f	修复加油包独立有效期和流量重置	2026-09-22 16:36:42 +08:00
break	89d0a67aad	开放套餐过期时间和用量修改权限	2026-09-22 16:36:42 +08:00
break	9959168e22	完成支付失败商户轮换禁用	2026-09-22 15:58:03 +08:00
break	622e99b543	移除退款审批重复资产类型字段	2026-09-22 14:22:51 +08:00
break	2ba483db18	修复退款审批服务未注入问题	2026-09-22 12:41:29 +08:00
break	4330b8a40c	新增设备类型选项接口	2026-09-22 12:35:26 +08:00
break	22c3e7cc1a	实施业务用户组成员管理	2026-09-21 21:20:38 +08:00
break	4a16eb0b1e	新增代理注册申请管理	2026-09-21 16:51:37 +08:00
break	b063617153	完善退款审批材料与恢复流程	2026-09-20 17:59:52 +08:00
break	4a6cec2730	修复设备导入卡绑定查询映射	2026-09-20 11:39:32 +08:00
break	863607639f	归档	2026-09-20 10:46:34 +08:00
break	1964c12ffa	新增字段	2026-09-20 10:38:10 +08:00
break	98acc51241	修复设备导入卡查询失败后重复重试	2026-09-20 10:10:21 +08:00
break	54c4ec7ba4	fix(设备实名): 无当前卡时按绑定卡实名回退并初始化单槽当前卡 ... - 设备资产解析外层 real_name_status：存在当前使用卡时沿用该卡状态，无任何当前卡时任一有效绑定卡已实名即视为已实名 - 手工绑定与设备导入：设备最大槽位为 1 且有效绑定唯一时，在同一事务内将该绑定初始化为当前使用卡；多卡设备不推断 - 同步 asset-device、personal-customer 主 Spec；归档变更并附存量核对清单（75 条单槽唯一待修复绑定，其中 16 条已实名）	2026-09-18 17:49:12 +08:00
break	d24e777a4c	docs(验证证据): 以占位符替换本地 smoke JWT 字面串（ENG-SECRET-001） ... - 验证说明中的本地 smoke JWT 占位值改为 <SMOKE_JWT_SECRET>，不改动证据语义与其它内容	2026-09-18 15:35:20 +08:00
break	5ed6b39deb	feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链 ... - 新增六对成对迁移 000232–000237：H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕 - 退款：原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败 - 优先轮询：人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影 - 通道阈值：命中事实同事务留痕与命中记录查询；员工账单：列表筛选与详情投影；商户池：列表投影与统计周期语义；H5：弹窗类型与类别排序 - 手机号：有效关联数量与最近解绑人、短信验证码失败次数限制；导出：佣金明细十五列与报表序号列 - 时间筛选：三处新增筛选纳入统一严格解析契约，员工账单产生时间参数改名 - 同步 12 份主 Spec 需求、两端点与异步任务证据链，门禁 context-health 与 OpenSpec 校验通过	2026-09-18 15:34:29 +08:00
break	5e78809b93	feat(运营报表): AUG26-015 设备激活与套餐续费日报快照、查询趋势与受控导出 ... - 新增成对迁移 000231 与三张快照表：日级头行、设备粒度激活行、到期事件粒度续费行，以快照日期为唯一键 - 新增每日 03:30（Asia/Shanghai）日报快照生成任务与幂等整日替换，失败重试沿用同一目标日 - 新增六条受控入口：两张报表的汇总、日/月趋势与受控导出，配套查询层只读快照事实 - 新增 operations_activation 与 operations_renewal 两个导出场景，创建期冻结筛选与可见店铺范围、派发期冻结表头、执行期只按冻结值复核资格 - 采购数量口径按系统内未删除设备数实施并在 PRD 标注，附实测差额依据 - 同步证据链 requirement-evidence.json 与入口能力矩阵、ARCHITECTURE 与验证记录 - 归档 change add-operations-reports 并新建主 Spec openspec/specs/operations-report/spec.md	2026-09-18 09:42:28 +08:00
break	6333f4ad13	fix(代理分销注册): 校验手机号/用户名/店铺编号唯一性并支持驳回后重注册 ... - 提交写事务内先取事务级 advisory lock，再校验既有未删除账号/店铺与其它待审批申请： 手机号 1014、用户名 1013、店铺编号 1031、待审批占用 1007，冲突不落库且不消费短信验证码 - 已驳回（含通过后撤销）与已通过的终态记录不阻塞重新注册，形成新记录与新审批实例 - 并发同关键字段提交串行裁决，同一关键字段至多一条待审批记录 - 审批通过建店建号前复检关键字段，冲突返回可定位错误并整体回滚，不再以裸数据库错误收场 - 归档 Change fix-agent-distribution-registration-duplicate-guard 并同步主 Spec 验证：junhong_cmp_test + Redis DB 6 受控脚手架 37 项通过 / 0 项失败（含 6 路并发仅 1 条落库、 审批冲突回滚与无冲突建店回归），清理后 fixture 残留 0；gofmt/go build/go vet 全绿； openspec validate --all 35 项通过、doctor healthy、context-health 通过	2026-09-17 19:02:14 +08:00
break	62419d4b17	feat(导出时间筛选): AUG26-014 统一时间筛选与临期导出，归档并同步主 Spec 与证据链 ... 统一时间筛选：新增共享严格解析器 pkg/utils/time_range.go，只接受带显式时区的 RFC3339 秒级时间（拒绝小数秒、无时区、date-only、空格分隔、±hhmm、未补零、非法日期与越界偏移），闭区间含两端、归一为 UTC 瞬时，创建期与执行期共用同一份实现。 端点改造（13 个入口）：IoT 卡导入任务、设备导入任务、导出任务列表、订单列表参数名不变仅收紧解析；换货、分配记录、代理充值、临期列表改名 start_time/end_time（旧参数名显式拒绝）；提现记录两处删除解析失败静默跳过，非法参数一律 1001；授权记录由起始闭结束开改为闭区间含两端；临期列表改按当前生效主套餐最终到期时刻比较，保留剩余天数上下限与既有粗放窗口。 临期导出新建：新场景 expiring_asset 与受控入口 POST /api/admin/expiring-assets/export，复用列表候选预筛与最终到期推算，一行一资产、加油包不单独成行，列序与 111 §18.1 逐列一致，店铺/业务员/用户组按执行时当前归属补充且不超出创建时冻结范围。 佣金明细导出新增按创建时间闭区间筛选（原佣金与回溯两条分支各自创建时间列），记录粒度、列定义与余额口径不变。 冻结与遗留任务：创建期把筛选与时间边界规范化为 UTC RFC3339 秒级串写入既有 query_json，无新列无迁移；执行期只按冻结值严格解析，非法冻结值在任何分片与文件动作前落任务失败并写安全摘要，不放行全量；重试沿用原快照。达量预警导出执行期同样纳入严格解析（其入口契约、列定义与触发快照口径不变）。 归档 add-export-time-filter-standards 并新建主 Spec openspec/specs/export-time-filter/spec.md，同步 requirement-evidence.json 与入口能力矩阵，README 导出场景清单更新为 11 个场景。 验证：junhong_cmp_test + 本地隔离 Redis（DB7，测试部署共享队列 DB6 未被占用）实跑 85 PASS / 0 FAIL（接受/拒绝集合、区间与顺序语义、列表与导出同筛选行集一致、代理 HTTP 全链路与范围冻结、遗留旧格式任务安全失败、列与余额口径回归、表头逐字），门禁 gofmt/go build/gendocs 两次一致/openspec validate/doctor/context-health 全绿；无 Schema 变更、无迁移、无运行时开关。	2026-09-17 18:37:02 +08:00
break	e8ab1f471e	fix(代理分销注册): 验证码改为落库成功后消费并细化失败原因 ... 公开扫码注册原先在审批准备前就消费短信验证码，落库前的任何失败都会烧掉验证码， 客户重试只能得到统一的“分销码不可用”，掩盖了真实失败原因。 - 验证码校验与消费拆分为 CheckCode 与 ConsumeCode，注册记录与审批实例落库成功后才原子消费； 校验不消费、消费一次性，落库前失败时同一验证码可直接重试 - 分销码无效、所属店铺已停用、上级店铺缺少启用的主账号、验证码错误分别返回各自错误码与提示 - 注册必填字段缺失与请求参数校验失败提示定位到具体字段 - 同步公开接口描述与 agent-distribution-withdrawal 主 Spec 行为契约	2026-09-17 18:01:47 +08:00
break	398a5e4282	fix(路由): 修正套餐真流量预警与资产自动续费的超管/平台 gate 作用域 ... Fiber 组中间件按路径前缀生效，两处 gate 挂在空路径组上实际落到 /api/admin 前缀， 注册顺序在其之后的后台接口对代理与企业账号一律返回 403（含代理充值、代理自充 支付方式与订单等）。gate 改为挂在各自功能路径组上，代理与企业仅被拒绝这两组功能入口。	2026-09-17 17:49:33 +08:00
break	d52be16802	feat(资产钱包自动续费): 新增全局配置、每日扫描续购与可靠复机 ... - 新增单行配置表 tb_asset_auto_renewal_config 与尝试记录表 tb_asset_auto_renewal_attempt（迁移 000229/000230） - 每日按上海自然日扫描，窗口内以同一资产钱包可用余额续购当前主套餐，资金/订单/套餐/审计同一事务闭合 - 唯一键保证每资产每日至多一次尝试，占位中断由后续扫描收敛，当日不重试 - 四类失败原因向客户与店铺各投递每日至多一条站内通知，并注册通知类型与个人客户白名单 - 续费成功后按条件经 Outbox 可靠投递复机，新增恢复扫描只查询回填，不使用即发即弃调用 - 配置读写仅超级管理员与平台账号，保存记录操作者、前后值快照并登记统一审计 - tasks 7.1–7.15 全部验证通过（本机隔离 PostgreSQL/Redis，零外部渠道调用）	2026-09-17 16:39:26 +08:00
break	70e6b186df	fix(退款): 修复创建退款申请插入审批尝试记录失败 ... 创建路径把审批尝试记录在事务外预构造后原样插入，缺失只能在事务内生成的 attempt_no 与 package_usage_snapshot，触发 NOT NULL 与 CHECK 约束， 接口统一返回 2002 数据库错误（5xx 脱敏掩盖了具体消息）。 - 尝试记录收敛为事务内唯一构造点 buildAttempt，CreateCommand 与 ResubmitCommand 只传按冻结商户派生的渠道退款请求号 - TriggerHistorical 补上缺失的尝试记录插入，此前 attempt.ID 恒为 0， 必然以「关联已变化」冲突收场 - 按「首次接入企业微信审批的实例」语义回写 tb_refund_request.approval_instance_id，恢复本地人工终审的 IS NULL 防重保护与退款导出投影	2026-09-17 15:49:04 +08:00
break	aab56a6998	feat(轮询优先队列): AUG26-016 卡轮询优先队列、人工入队与读侧接口，归档并同步主 Spec 与证据矩阵 ... 新增 000228 成对迁移 tb_polling_priority_item：卡、任务类型、状态、触发类型、来源订单/套餐使用记录、 触发次数与来源集合、尝试次数、失败原因、人工原因与操作者、店铺快照与各时间列；以活动项部分唯一索引 uq_polling_priority_item_active（仅 deleted_at IS NULL AND status IN ('pending','processing') 占键位） 表达「同卡同任务类型至多一条活动项」，另有状态/时间索引与全列注释；down 守卫在存在活动项或未终态行时 拒绝回滚并给出中文原因。 新增优先轮询请求可靠事件 polling.priority.requested（载荷版本 v1、事件键前缀 prio:）与消费者：只在原 业务事务内追加、幂等键稳定；消费者按卡 × 纳入任务类型（realname/carddata/card_status/package）逐条 建项并在提交后下发执行提示，重复投递只合并触发次数、来源集合与最近触发时间，不新建行也不重复调用。 触发点为四类自动场景 purchase_activated / renewal_activated（按同载体更早套餐使用记录判定）/ queue_activated / addon_activated 与「无有效套餐」no_valid_package（仅在普通套餐轮询来源且存在待生效 套餐使用记录时追加；事件通道显式拒绝 manual_trigger）；入队对象恒为卡，绑定设备资产在触发事务内冻结 在用卡快照逐卡建项，不使用设备当前卡槽口径。 轮询共享基类新增认领接缝：四个 Handler（realname/carddata/card_status/package）在并发信号量之后、调用 上游之前探测活动项——待执行条件认领、执行中且 90 秒租约未到期则跳过并延后、无活动项时行为与既有完全 等价；超租约允许相邻执行接管，尝试次数只在真正发起执行后累加，未达上限（3）回到活动态按既有间隔重排， 达上限或业务校验类失败进入失败终态并保留可安全展示原因；执行前校验卡自身与绑定设备的轮询开关。未引入 通用卡级锁与 Redis 活动标记，分片队列的出队、入队与移除路径未改动。 提示通道按任务类型独立键（polling:priority:{taskType}），与既有手动触发队列分离；调度器在同一周期内先 排空优先提示、再排空手动触发队列，提示排空不受分片背压跳过影响；未新建调度设施或异步任务类型。 新增人工优先入队与只读查询三条路由 POST /api/admin/polling-priority-items、 GET /api/admin/polling-priority-items、GET /api/admin/polling-priority-items/:id：人工入队复用既有轮询 权限判定（抽取为同包共享函数），原因必填，不受每日 500 次上限与 24 小时去重约束，重复抑制由活动项合并 承担；读侧按店铺快照下推数据范围，越权与不存在不可区分，不提供优先级分级、有效期或人工重触发入口。 新增 7 个审计动作（enqueue/claim/fail/retry/complete/dequeue/manual_denied）与资源 polling_priority_item，并按（操作者类型，来源）注册，人工侧与 Worker 侧均通过来源校验。 同步 OpenAPI 文档装配三处与路由注册；归档 Change 至 openspec/changes/archive/2026-09-17-add-priority-polling-queue/ 并同步主 Spec（新增 priority-polling-queue、polling-operations 追加单次执行互斥 Requirement 与三条路由索引）与上下文健康 证据（requirement-evidence 150 行、入口矩阵 http 403 / async 56）。 本机验证：junhong_cmp_test 与隔离 Redis DB 15，未连生产、未启动 Worker/API、未调用运营商上游；迁移 up/down/up 与 down 守卫实测（含 dirty=true 记账口径与 force 恢复），A–F 批 94 PASS、接缝 63 PASS、 提示通道 12 PASS、清理零残留 20 PASS。成功路径 Complete、真并发互斥、尝试上限第 3 次判定、HTTP 层权限 矩阵、通道阈值持锁复机边界与三类生效触发点生产集成留待测试部署验证（见 docs/verification/add-priority-polling-queue-verification.md 第 4 节）。自动化测试按项目决策为 N/A， 未新增 *_test.go。	2026-09-17 14:29:56 +08:00
break	e7b93e4634	docs(通道流量阈值): AUG26-011 归档变更并同步 carrier-channel-traffic-threshold 与 package-lifecycle 主 Spec 及证据链	2026-09-16 17:33:11 +08:00
break	33826c3443	feat(套餐真流量预警): AUG26-004 真流量预警规则、达量扫描通知与导出 ... 新增 000226 迁移：规则表 tb_package_traffic_alert_rule（每套餐商品至多一条，无软删除，package_id 非部分唯一约束）、达量预警快照表 tb_package_traffic_alert（以主套餐使用记录 + 阈值快照为唯一键， 触发时冻结用量、额度、比例、阈值、到期时间、归属与资产快照），并为 tb_package_usage 新增扫描 范围部分索引 idx_package_usage_alert_scope；down 在预警表存在数据时阻断回滚。 新增规则维护接口 GET/POST/PUT /api/admin/package-traffic-alert-rules（仅超级管理员与平台账号）： 创建校验套餐存在且真流量额度大于零，阈值为 1%～100% 的两位小数；修改只影响后续扫描，不回填也 不改写既有预警快照；全部写操作记录操作者、前后值与时间。 新增每日 06:00（Asia/Shanghai）扫描任务 package:traffic:alert:scan，与套餐临期扫描共用 data_cleanup 队列：按资产汇总当前有效套餐的真流量，分子取使用记录真已用量、分母取使用记录真总量快照，命中 主套餐规则阈值时在同一事务创建预警与可靠通知事件；重复执行以唯一冲突视为已处理，不重复投递， 不建停机锁、不调用运营商。 新增预警列表、详情与异步导出 GET /api/admin/package-traffic-alerts、GET /api/admin/package-traffic-alerts/:id、 POST /api/admin/package-traffic-alerts/export，列表与详情一律读冻结快照；新增通知类型 package.traffic.alert 与受控目标 package_traffic_alert_detail，目标解析仅对超级管理员与平台账号 返回可跳转，越权与不存在统一按资源不可见处理。 同步 OpenAPI（cmd/gendocs、cmd/api/docs.go、pkg/openapi/handlers.go）、审计动作与资源注册、上下文 健康检查证据；归档变更并同步 package-traffic-alert 主 Spec。	2026-09-16 17:07:34 +08:00
break	d5bcda94fe	feat(套餐真流量预警): AUG26-004 真流量预警规则、达量扫描通知与导出 ... 新增 000228 迁移：规则表 tb_package_traffic_alert_rule（每套餐商品至多一条，无软删除，package_id 非部分唯一约束）、达量预警快照表 tb_package_traffic_alert（以主套餐使用记录 + 阈值快照为唯一键， 触发时冻结用量、额度、比例、阈值、到期时间、归属与资产快照），并为 tb_package_usage 新增扫描 范围部分索引 idx_package_usage_alert_scope；down 在预警表存在数据时阻断回滚。 新增规则维护接口 GET/POST/PUT /api/admin/package-traffic-alert-rules（仅超级管理员与平台账号）： 创建校验套餐存在且真流量额度大于零，阈值为 1%～100% 的两位小数；修改只影响后续扫描，不回填也 不改写既有预警快照；全部写操作记录操作者、前后值与时间。 新增每日 06:00（Asia/Shanghai）扫描任务 package:traffic:alert:scan，与套餐临期扫描共用 data_cleanup 队列：按资产汇总当前有效套餐的真流量，分子取使用记录真已用量、分母取使用记录真总量快照，命中 主套餐规则阈值时在同一事务创建预警与可靠通知事件；重复执行以唯一冲突视为已处理，不重复投递， 不建停机锁、不调用运营商。 新增预警列表、详情与异步导出 GET /api/admin/package-traffic-alerts、GET /api/admin/package-traffic-alerts/:id、 POST /api/admin/package-traffic-alerts/export，列表与详情一律读冻结快照；新增通知类型 package.traffic.alert 与受控目标 package_traffic_alert_detail，目标解析仅对超级管理员与平台账号 返回可跳转，越权与不存在统一按资源不可见处理。 同步 OpenAPI（cmd/gendocs、cmd/api/docs.go、pkg/openapi/handlers.go）、审计动作与资源注册、上下文 健康检查证据；归档变更并同步 package-traffic-alert 主 Spec。	2026-09-16 17:05:55 +08:00
break	ef4d3696d4	fix(通道流量阈值): AUG26-011 修复周期处理连接池自锁并补齐根池句柄验证与文档	2026-09-16 16:59:32 +08:00
break	15bbb953db	fix(通道流量阈值): AUG26-011 修复失败/未知结果收敛、锁定 carrier 缺失出路与审计回归	2026-09-16 16:41:25 +08:00
break	59b3df868a	feat(通道流量阈值): AUG26-011 运营商通道流量阈值达量停机与周期复机	2026-09-16 15:54:49 +08:00
break	41722760b1	docs(H5弹窗): AUG26-007 归档变更并同步 h5-popup-notification 主 Spec 与证据链	2026-09-15 16:29:56 +08:00
break	333ba4b647	feat(H5弹窗): AUG26-007 风险换卡与运营弹窗投放通知 ... 新增 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）与参数校验中文提示共用实现。	2026-09-15 15:23:52 +08:00
break	70e680eb0a	feat(手机号资产关联): AUG26-009 手机号—资产关联、十项上限与后台解绑 ... - 新增成对迁移 000223（tb_phone_asset_association，含有效关系部分唯一索引与 down 守卫）与 000224（解绑导入任务表），不回填历史 - H5：need_bind_phone 三支判定（开关关闭完全短路）；已有主号幂等建联；十项上限按手机号 advisory 串行化（含换绑到全新号的并发场景）；换绑原子迁移与冲突整单回滚；不写遗留列 - 后台：关联列表、单项/批量解绑、CSV 导入解绑（B1–B16），超管/平台 gate + 资产数据范围复核，三态统一文案 - 读侧：卡/设备列表与详情按页一次 IN 聚合；两类导出补「关联手机号」列并保留历史表头反解兼容 - 脱敏：关联审计走独立动作/资源只写脱敏手机号；访问日志手机号类字段脱敏 - 同步主 Spec openspec/specs/phone-asset-association 并归档 AUG26-009，补齐 requirement-evidence 与入口矩阵，context-health 通过	2026-09-15 11:54:56 +08:00
break	93e072e1e2	feat(换货): AUG26-005 换货业务数据迁移状态与失败恢复 ... - 新增成对迁移 000222：tb_exchange_order 增加非空 migration_status 与 migration_failure_reason，按既有 migrate_data/migration_completed 回填历史， 并加四值 CHECK 约束，不新增索引 - 模型与常量定义四种迁移状态及中文名称，保留既有布尔字段兼容语义 - 物流换货创建恒 not_migrated，发货按请求落 pending/not_migrated， 完成成功写 migrated/not_migrated 并清空失败原因、同步兼容字段 - 直接换货创建即完成，任一步失败整体回滚，不持久化换货单、不产生 failed - 迁移失败回滚全部业务修改后，在独立短事务内条件更新 failed 与安全失败原因 并写失败审计，RowsAffected 为 0 时跳过状态写入但仍写审计 - failed 物流单重试仅限超级管理员或平台用户，授权以锁内 FOR UPDATE 判定为准， 重试从钱包余额起整表重跑；非 failed 单沿用既有完成门禁 - 列表与详情返回迁移状态与中文名称，仅 failed 返回失败原因；既有三字段保持兼容 - 换货导出在「状态」列后新增中文「迁移状态」列，不导出失败原因 - 同步 order-refund-exchange 主 spec 与验证证据，归档本 Change - 登记 KNOWN-ISSUE-001：既有标签复制 OnConflict 未声明部分索引谓词（42P10）， 旧资产带标签时迁移最后一步失败，待另立变更修复	2026-09-14 18:32:26 +08:00
break	c7f9e005af	feat(业务用户组): AUG26-003 业务用户组与店铺负责人分组导入 ... - 迁移 000221：新增 tb_business_user_group、tb_business_user_group_member、tb_shop_business_owner_import_task，成员一账号一行由部分唯一索引保证，店铺所属组按当前负责人实时推导，不回填历史分组。 - 用户组 CRUD、成员改组/清空归属、店铺批量交接（原子失败不部分写入）。 - 店铺负责人 CSV 导入任务：逐行独立事务、逐行明细、任务级与行级失败分离。 - 读侧推导与筛选：未分组、业务线、停用组可筛出并带停用标记。 - 补齐操作审计动作与资源、openapi 清单、发布门禁巡检表清单。 - 归档 add-shop-salesperson-groups 变更并同步 openspec/specs/business-user-group，补齐 AUG26-003 验证证据链。	2026-09-14 16:51:44 +08:00