429 Commits

Author	SHA1	Message	Date
邹进	af57de0d4d	fix: 店铺分配覆盖为实名即生效的套餐纳入沉默期配置口径 ... 存量中套餐本身购买即生效、店铺分配覆盖为实名即生效的正式套餐，购买后同样等实名， 但原口径只看套餐本身：无法配置默认沉默期、不进未配置清单与打开前检查， 待实名记录无法回填导致总开关打不开，新购买也绕过沉默期。 - 未配置清单与打开前检查纳入存在实名即生效分配覆盖的套餐 - 购买即生效正式套餐允许选填默认沉默期，加油包仍禁止 - 分配覆盖购买即生效 → 实名即生效在套餐已配置默认沉默期时放行 - 同步 OpenSpec design D11、spec、tasks 3.4/3.5 与前端说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 17:56:29 +09:00
邹进	69ec98aa5f	fix: 后台平台自营与赠送套餐订单不再按 C 端购买跳过实名门槛 ... isCEndPurchase 只看 buyer_type=personal，后台平台自营资产与赠送套餐线下订单 买家也记为 personal，导致未实名资产的实名即生效套餐下单即生效、不进沉默期。 增加订单来源为 client 的条件，与同文件其他 C 端判定保持一致。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 17:30:53 +09:00
邹进	62ec94adec	refactor: 出库时间更名为首次购买套餐时间，换货新资产不再按换货完成时间记录 ... - 字段 outbound_at → first_purchase_at，记录表 tb_asset_outbound_record → tb_asset_first_purchase_record，接口 /outbound-records → /first-purchase-records，筛选参数与导出列同步更名 - 换货后的新资产不因换货写入，在当前世代真正支付套餐订单时才记录；记录来源只保留 order / backfill，去掉换货单字段 - 迁移 000266 重命名列、表、索引与约束；同步 Spec、设计、任务与前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 16:47:02 +09:00
邹进	909f4d0ec2	feat: 实名即生效套餐沉默期、延期办理与资产出库时间 ... - 迁移 000259～000265：套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置（总开关默认关闭）、企微审批白名单、卡与设备出库时间及出库记录 - 沉默期设置（订单发放、自动购包、钱包续费）、后台购买时调整（超默认值按政策免审或企微审批）、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描 - 总开关专用接口与打开前 4 项检查；延期政策；延期资格与计费；H5 自助与后台二维码在线支付（商户池路由）、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款；沉默期审批场景与终态处理 - 换货沉默期流水与出库时间；卡/设备列表、详情、导出与出库记录接口；延期订单与即将过期套餐列表及导出；财务流水纳入延期支付 - 沉默期与出库时间回填工具 cmd/silence-backfill；前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 16:32:58 +09:00
邹进	82a2fcc306	fix: 企业账号只能访问授权给本企业的资产 ... /assets/:identifier/* 共用 AssetService.Resolve 解析资产，而店铺数据范围 ApplyShopFilter 对企业账号不加条件， 企业账号可以查询并操作任意卡或设备（资产详情、订单、套餐、停复机、停用、改套餐有效期与已用量、开关轮询、改实名状态）。 - Resolve 对企业账号校验卡或设备当前授权给本企业，未授权与不存在同样返回未找到 - 改套餐有效期、改已用量、停用、开关轮询、改实名状态对企业账号返回无权限；停复机按授权范围放行 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 15:05:05 +09:00
邹进	eb9f12d160	feat: 后台订单按平台、代理商、在线支付拆分列表与导出 ... - 新增 GET /orders/platform、/orders/agent、/orders/online，类别由路径固定，参数、响应、权限同原订单列表 - 新增导出场景 order_platform、order_agent、order_online，筛选与表头同 order - 类别按钱从哪来划分：客户端下单为在线支付；后台代理钱包扣款（含平台代扣）为代理商；其余后台订单为平台 - 列表与导出共用 internal/query/ordercategory 的类别条件 - 企业账号访问订单列表、详情、购买预检改为无权限，修复其可看到全部订单的问题 - 原订单列表与 order 导出场景保留不变 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 12:53:24 +09:00
邹进	d4fde99cc3	fix: 停复机成功后上游状态滞后导致暂停轮询的卡到期或退款漏停 ... - 停复机成功后保护窗口内（polling.stop_resume.status_grace_seconds，默认 300 秒）查卡状态返回操作前的状态视为上游滞后，不回写网络状态 - 套餐到期、退款场景不看库里的开停状态，资产无可用主套餐即停机，上游已停时按已是目标状态结束 - 迁移 000257 插入保护窗口配置 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 10:41:45 +09:00
邹进	0769db8cc8	fix: 设备列表返回是否轮询 ... 设备列表已支持按是否轮询筛选，但返回中没有该字段，前端无法展示开关状态与批量开关。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 10:05:26 +09:00
邹进	f35d2a8196	fix: 改有效期到过去时不自动恢复轮询 ... 把套餐有效期改到过去时，到期扫描前套餐仍为生效中，原逻辑会误恢复轮询；改为只认未到期的生效中主套餐。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 09:45:36 +09:00
邹进	ef5274864f	fix: 改有效期自动恢复轮询识别 card 资产类型 ... 资产解析返回的卡类型为 card，恢复轮询按 iot_card 匹配，导致改有效期后关闭轮询的卡不恢复。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 03:33:01 +09:00
邹进	4139732719	fix: 不轮询清单审查问题 ... - 写清单 ON CONFLICT 的部分索引谓词改为字面量：预编译语句的通用执行计划下参数化谓词匹配不到部分唯一索引，第 6 次起关闭轮询全部失败 - 轮询开关审计允许 Worker、开放接口、C 端与支付回调来源；导入与自动恢复补审计操作者 - 文件导入按 19/20 位 ICCID 匹配 - 钱包重复支付不再恢复轮询 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 03:18:54 +09:00
邹进	7ddb9312e3	feat: 不轮询清单与批量开关轮询 ... - 新增不轮询清单 tb_card_polling_pause（迁移 000256 补写存量），所有改 enable_polling 的入口同事务写清单 - 卡、设备勾选批量开关轮询（单次 500，逐项结果，开启跳过风险停机与已销户）与 CSV 文件导入 - 订单套餐生效、改有效期后自动恢复轮询并按规则评估复机 - 不轮询清单查询与导出；卡、设备列表与导出增加是否轮询 - 失败告警停机被拒视图、导出与批量关闭轮询；开关轮询影响说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 03:07:20 +09:00
邹进	a4e3fe4d8f	fix: 停复机指令队列审查问题 ... - 开关开启但分发器心跳缺失时回退为当场执行，避免指令无人消费 - 待确认指令先查上游状态再判断；执行期间被覆盖时把待确认带到新指令 - 同方向失败退避中重复写入不提前执行时间 - 领取容量把执行上限与本秒剩余 QPS 分开计算 - 队列复机共用单卡复机锁；执行上下文取消后按结果未知确认 - 消费者并行停止；读取最近调用时间失败时不覆盖；成功但终结日志失败按成功处理 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 00:43:58 +09:00
邹进	934a3a27a1	feat: 停复机指令队列与设备维度判断 ... 自动停复机统一经停复机指令队列执行（全局开关 polling.stop_resume.queue_enabled，默认关闭）： - 统一判断函数 decideCard，新旧路径共用；暂停轮询的卡在套餐到期、退款场景照常停机 - 同卡一条指令、版本号覆盖；领取校验单卡最小重试间隔；先于卡任务领取，不受 scheduler_mode 限制 - 执行器只调用一次网关，按错误分类退避与告警，结果未知在队列内确认 - 设备维度判断合并请求与场景，版本变化再判断，旧路径持设备锁时推后 - 套餐激活、重置、订单、流量扣减、套餐到期、退款、实名管控修改改为请求评估 - 监控增加停复机队列与近 1 小时执行计数，单卡轮询状态返回当前指令 - 迁移 000255 插入开关与告警、退避参数 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-26 00:36:26 +09:00
邹进	466cb1f9e8	fix: 修复保存限流组与错误分类规则后缓存失效函数无限递归导致 API 栈溢出崩溃 ... invalidateGroups、invalidateRules 误写为调用自身，任何限流组或错误分类规则保存成功后 API 进程栈溢出退出；改为调用限流组与分类器的 Invalidate	2026-10-25 23:11:58 +09:00
邹进	c741f1751d	feat: 按运营商账户调度的后台接口与重算到期 ... - /polling-carrier-params 列表（含默认标记与消费能力）、详情、保存（执行上限不得大于订阅进程 max_in_flight 之和）、删除；/polling-check-scenes 列表与修改（检查类型、递增的确认延迟、冷却）；/polling-failure-alerts 列表、按账户与错误类别汇总、详情、标记已处理；GET /iot-cards/:id/polling-state 单卡轮询状态；GET /polling-stats/carrier-queues 按账户队列与执行监控 - 读取仅超级管理员与平台账号，修改仅超级管理员（告警处理平台账号可用），均写统一审计；新增审计动作与资源 - carrier 模式下重算到期时间写入卡到期信息与账户队列，只提前不推后	2026-10-25 18:56:32 +09:00
邹进	f49baff7c2	feat: 停复机新规则转正，删除总开关与旧口径 ... - 删除总开关 stop_resume.unified_rule_enabled（配置、加载、部署工作流与 docker-compose.prod.yml 环境变量） - 复机不看停机原因：删除只对轮询停因复机的旧分支与 ListByDeviceIDAndPollingStopReasons；设备复机取全部停机卡 - 实名门槛只按卡所属通道实名管控判断，删除行业卡与卡/设备实名策略放行；暂停轮询的卡不自动停复机无条件生效 - 通道阈值新周期解锁后的复机条件固定为新规则复机条件 - 资产自动续费复机同步新规则：不看停因、暂停轮询不复机、设备取全部停机卡、复机成功清除停因 - 实名轮询不再按行业卡跳过；所属运营商账户未开启实名管控时跳过查询，但卡未实名且所在资产有等待实名激活的套餐时照常查询，避免囤货套餐无法激活	2026-10-25 18:13:51 +09:00
邹进	af8249158d	feat: 停复机规则演练与终态自动关闭轮询 ... 统一停复机规则转正的第一次发布：总开关仍关闭，现有停复机行为不变。 - 新增停复机规则演练：GET /stop-resume-rule/dry-run 按新规则对开机与停机卡只判断不执行，返回运营商账户 × 停机原因 × 判断结果汇总与分页明细，可假设通道实名管控配置；POST /stop-resume-rule/dry-run/export 导出明细（场景 stop_resume_rule_dry_run）；仅超级管理员与平台账号 - 风险停机、已销户关闭轮询不再限于独立卡，只关该卡自身轮询，不级联设备 - 错误分类规则增加 auto_disable_polling，仅终态类别可勾选；停复机（含设备停复机）命中该规则时不重试、关闭该卡轮询、回写网关扩展状态并写审计 iot_card.terminal_disable_polling - 迁移 000250 加列与约束，并为"已销户""仅支持风险复机"置位	2026-10-25 17:52:40 +09:00
邹进	79b7580554	feat: 下线设备保护期 ... - 后台设备停复机不再设置 1 小时保护期，也不再因保护期拒绝相反操作；单卡手动停复机去掉保护期检查 - 删除保护期一致性轮询（polling:protect）及其强制停复机方法；调度、初始化、监控、匹配预览不再包含保护期；已入队的旧任务由空处理函数直接确认，下一次发布移除 - 轮询配置接口不再接受与返回 protect_check_interval；并发配置不再返回 protect，查询、更新、重置该类型时拒绝 - 资产详情 device_protect_status 固定返回 none 并标记废弃，兼容老版本客户端 - 删除保护期 Redis key 与时长常量；停机原因 protect_period 保留供历史数据与开放接口映射 - 迁移 000249 只把 protect_check_interval、last_protect_check_at 列注释标记为已废弃，不删列不改数据	2026-10-25 17:19:10 +09:00
邹进	2ddaffe373	docs: 轮询配置接口文档与实际行为对齐 ... - 匹配预览 GET 只收 query iccid，POST 只收请求体，去掉 POST 文档中多余的 query 参数 - 预览草稿 overrides 改为独立结构，字段全部可选，最多 20 条 - clear_fields 用具名类型生成数组元素枚举；ordered_ids 说明须为正整数且不重复	2026-10-24 17:41:52 +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
邹进	b434eda5c7	fix: 退款审批通过时仅原路退款校验收款商户凭证 ... 线上支付订单选择客户收款信息退款时，审批通过处理仍无条件校验收款商户的原路退款凭证， 商户凭证不完整（如微信 v2 缺 API 客户端证书）即阻断，导致企微已通过的退款无法完成。 将凭证校验移入原路退款分支，旧人工审批入口同步按退款方式判定。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-15 16:51:28 +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
邹进	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
break	b09275a0d0	修复待处理换货资产归属	2026-09-24 12:30:33 +08:00
break	34f91f129f	修复加油包独立有效期和流量重置	2026-09-22 16:36:42 +08:00
break	9959168e22	完成支付失败商户轮换禁用	2026-09-22 15:58:03 +08:00
break	4330b8a40c	新增设备类型选项接口	2026-09-22 12:35:26 +08:00
break	b063617153	完善退款审批材料与恢复流程	2026-09-20 17:59:52 +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	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	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	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	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
break	1aa4eacee2	feat(退款分佣): 佣金回溯明细替换全额失效并补齐读侧与导出 ... 用 PRD 2.14 语义整体替换退款佣金「整单全额失效」实现：原佣金保持已发放不变， 回溯事实落在新表 tb_commission_clawback_record 的负数、不可提现明细上。 - 新增成对迁移 000220 建 tb_commission_clawback_record，唯一约束 (refund_id, original_commission_id) 为权威幂等键，附店铺+时间/原佣金/订单索引。 - 回溯用例（internal/service/refund/clawback.go）：准入仅由退款申请状态、审批异常 标记与退款方式决定；金额按分整数计算，分母取冻结实收（缺失回落审批尝试）、 分子原路取渠道成功金额，乘法用 math/big 中间量，舍入差自末条起向前补差； 终态判据要求订单佣金已离开待计算且不存在 status IN (1,2,99) 的记录。 - 三层幂等：唯一约束兜底、佣金行行锁 + 钱包乐观锁、commission_deducted 仅作投影 并带 WHERE commission_deducted = false 条件置位；闭合三结果为已回溯、无需回溯、 审批异常转人工。 - 事务内顺序固定：锁提现申请行 → 锁尝试行 → 解冻冻结 → 置驳回 → 插回溯明细 → 扣 balance（允许为负）→ 写负数流水 → 审计；删除旧全额失效写入与其两个审计调用点， refund.invalidate_commission 仅保留常量与注册供历史审计读取。 - 读侧：佣金明细列表 status 筛选透传，两表 UNION ALL 合并分页并以 source ASC 作 末位次序键；新增佣金明细详情接口并同步路由与 OpenAPI 装配。 - 导出：新增 commission_record 场景（白名单、exporter 注册、DTO oneof、DataSource 与列定义），粒度为佣金记录，原佣金与回溯各一行，金额保持分且可为负。 - 新增退款佣金回溯周期补偿任务（@every 1m / MaxRetry(3) / Timeout(10m) / Unique(10m)，独立队列），保留启动时补偿扫描，判据与既有实现一致。 Refs: AUG26-012	2026-09-14 13:40:34 +08:00