635 Commits

Author	SHA1	Message	Date
邹进	4de67f6dc3	fix: 设备管理接口不再拦截代理与企业账号 ... 设备类型选项接口用 router.Group("/devices", 拦截函数) 限制仅平台访问，Fiber 会把该函数注册为整个 /devices 前缀的中间件，导致代理、企业账号的设备列表、设备下的卡、分配回收等接口全部返回 403。改为在 ListDeviceTypes 内部判断用户类型，其他设备接口恢复原有权限。	2026-10-25 17:11:10 +09:00
邹进	a855742752	fix: 关闭轮询的卡不再重新入队 ... 关闭轮询时会移出队列并清除卡缓存，但执行收尾重入队、卡状态检查补齐套餐任务、限流重入队 都不判断轮询开关，执行中途被关闭的卡会被放回队列并互相补齐，关闭轮询无法生效。 - 卡缓存写入 enable_polling，旧缓存缺字段时从库补读并回写 - 重入队、补齐缺失任务、限流重入队前判断轮询开关，已关闭则不入队	2026-10-24 18:10:58 +09:00
邹进	2ddaffe373	docs: 轮询配置接口文档与实际行为对齐 ... - 匹配预览 GET 只收 query iccid，POST 只收请求体，去掉 POST 文档中多余的 query 参数 - 预览草稿 overrides 改为独立结构，字段全部可选，最多 20 条 - clear_fields 用具名类型生成数组元素枚举；ordered_ids 说明须为正整数且不重复	2026-10-24 17:41:52 +09:00
邹进	8fc3485061	chore: 激活前流量结算记录开始与完成日志	2026-10-24 17:31:32 +09:00
邹进	ec5c1996a7	fix: 重算到期时间不抵消失败退避，重置日前统计只计有生效套餐的卡 ... - 上次检查时间只在查询成功时更新，按"上次检查 + 新间隔"会把失败或限流延后的卡拉到立即执行； 过期或从未检查时候选改为"现在 + 新间隔"，只提前排队超过一个新间隔的成员 - 重置日前加密统计只记录有生效套餐的卡，与"有生效套餐但窗口内未查到"口径一致	2026-10-24 17:28:18 +09:00
邹进	98017ac053	feat: 分层轮询、重置日前加密与激活前流量结算 ... - 轮询配置新增套餐状态、资产状态、重置日前窗口与窗口内流量间隔（迁移 248），间隔三态：正数按间隔、0 不检查、空继承 - 配置按 priority, id 排序合并；在库与已销售无套餐未匹配时告警不入队 - 新增优先级整体重排、匹配预览、立即重算到期时间（异步只提前）、分层统计与重置日前加密统计接口 - 已切换日快照计量的卡流量按观测时间归属，激活前用量只记已结算 - 订单购买与实名激活补齐资产级激活锁，激活前对已切换卡结算一次流量，失败只告警不阻塞，结算不触发通道阈值判定	2026-10-24 17:06:38 +09:00
邹进	78220deb0e	docs: 网关限流接口文档补充操作、类别与状态枚举 ... - 限流组与错误分类的操作数组元素改为具名类型 GatewayOperation，接口文档按元素给出可选值 - 匹配方式、错误类别、状态字段补充 enum 标签；高优先级操作说明补充取值与必填条件	2026-10-24 15:22:17 +09:00
邹进	42e881576d	feat: 卡网关按运营商账户限流并记录停复机调用 ... - 新增网关限流：按本系统运营商账户（卡 carrier_id）→ 限流组 → 操作限制每秒请求数，每次 HTTP 尝试计量，默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免；支持只统计与拦截两种模式，默认只统计 - Asynq 遇限流不计失败、固定短延迟重试；轮询任务与停复机业务重试遇限流短延迟重排 - 停机、复机不再使用网关内部重试，只发一次请求 - 网关返回结构化错误；新增上游错误分类规则表与测试接口 - 新增按月分区的停复机记录表：系统自动停复机只写记录，不再写统一审计与集成日志；普通轮询查询不再写集成日志 - 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口 - 迁移 000243~000246；同步 OpenSpec 提案（含后续 6 个 change）与技术方案、工程约束	2026-10-24 15:06:41 +09:00
邹进	9e45097aa2	fix: 富友订单支持退款，0 元退款不强制客户收款材料映射 ... - decideRefundMethods 将 fuiou 与 wechat、alipay 按线上支付处理，修复富友订单报"该订单的支付方式不支持退款" - 客户收款信息退款仅在金额大于 0 时强制映射并提交客户收款信息与凭证；0 元退款允许客户收款信息为空 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-23 17:00:36 +09:00
邹进	437d1c2c2c	feat: 支持 0 元退款（仅作废权益不退钱） ... Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-22 11:18:24 +09:00
邹进	96771a204f	feat: 卡流量改为日快照计量并统一停复机规则 ... 卡流量计量（按名单灰度，默认 off）： - 新增卡日快照与切换水位表（000241），按通道上游流量重置日换算自然月、重置日防旧值 - 已切换的卡按月对账产生增量，无生效中套餐只结算不发事件；第一次切换写水位 - 已切换卡读数有效即判定通道阈值，卡表本月用量用快照覆盖，日流量读快照 - 配置 JUNHONG_TRAFFIC_CALC_MODE/CARDS、JUNHONG_TRAFFIC_FLOW_SNAPSHOT_ENABLED 停复机规则（总开关 JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED，默认关闭）： - 复机不看停机原因，持通道阈值锁仍拒绝；暂停轮询的卡不自动停复机 - 通道新增实名管控 realname_control_enabled（000242，默认 0），开启后不区分行业卡与实名策略 - 实名管控从 0 改 1 需确认，修改并入通道更新审计 OpenSpec Change: rebuild-card-traffic-metering-and-stop-resume	2026-10-20 17:49:26 +09:00
邹进	4f16eb1834	fix: Worker 订单服务注入员工代收款建账能力 ... 批量订购线下支付在 Worker 内建单时，订单服务缺少员工代收款建账能力， 每行都会以“员工代收款建账能力未配置”失败；与 API 进程保持一致。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-20 15:59:52 +09:00
邹进	08a7a00cd9	fix: 微信授权配置公众号必填、小程序选填 ... 商户池变更把授权完整性实现为公众号与小程序四项凭证都必填， 生产只用公众号 H5、未配置小程序，迁移后授权表为空会导致 C 端微信登录与支付全部失败，后台也无法补建。 - SaveAuthorization 启用时只校验公众号 AppID/AppSecret； 小程序选填，但 AppID 与 AppSecret 须同时填写或同时留空 - 新增迁移 000240：无授权配置且唯一生效综合配置公众号凭证 完整时补建启用授权配置；down 不删除数据 - 新增 OpenSpec Change allow-wechat-authorization-without-miniapp Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-19 23:29:55 +09:00
邹进	b434eda5c7	fix: 退款审批通过时仅原路退款校验收款商户凭证 ... 线上支付订单选择客户收款信息退款时，审批通过处理仍无条件校验收款商户的原路退款凭证， 商户凭证不完整（如微信 v2 缺 API 客户端证书）即阻断，导致企微已通过的退款无法完成。 将凭证校验移入原路退款分支，旧人工审批入口同步按退款方式判定。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 16:51:28 +09:00
邹进	1d6c212d04	feat: 第1批 M5 补充 IoT 卡导出追加使用/剩余流量(GB)列 ... - 新任务在「套餐到期时间」后追加「使用流量(GB)」「剩余流量(GB)」，同行 MB ÷ 1024 两位小数 - 冻结表头按末列识别三版尾列，历史任务行宽不变 - OpenSpec 补充提案、设计、spec 与任务 3.2/5.6 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-14 18:00:44 +09:00
邹进	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
邹进	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
邹进	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	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	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	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	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