邹进
94cbf2adab
feat: 采集记录成功失败分表并保存网关原始数据，到期归档 csv.gz，新增记录分页查询接口
...
- 网关客户端新增原始数据收集器，记录最后一次尝试的明文请求、HTTP 状态、响应体与 code/msg/trace_id
- tb_card_traffic_collection 只写成功读数，新增 carrier_id 与原始数据列；新增 tb_card_traffic_collection_failure，失败不判断有无套餐并带错误详情
- 采集记录在线保留当月加最近 2 个整月，到期分区摘出、导出 csv.gz、校验行数与 SHA-256 后删除，本地保留 3 个月
- 新增采集成功/失败、卡日流量、套餐日流量详单、冲正流水、退款后处理尝试列表接口：可查单个也可查全部，分页与条件筛选
- 停复机记录支持资产标识、场景、原因、指令号筛选；单卡历史支持动作、结果、来源筛选
- 单卡采集记录支持筛选与合并失败记录；套餐日流量详单支持分页；退款列表支持后处理状态筛选
- 测试环境 api、worker 日志分目录，保留 40 个压缩备份；worker 挂载 archive 目录
- 迁移 000272、000273 需维护者在测试库执行后再部署
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com >
2026-11-05 18:47:00 +09:00
邹进
9c3c258f16
feat: 卡流量读数先过采集队列再入账，扣减按采集时刻确定套餐
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m27s
- 每卡 Redis 采集队列（默认 N=3、跨天清空、回退容差 1 MB），攒满且不下降才写最后一个点
- 测试环境全量切换日快照计量，下线灰度名单、切换水位与卡表基线扣费；全部卡置待建起点
- 读数区分没给值与 0；有套餐的卡读数 0 也写快照与日用量 0 行；重置日比较基准为 0 照常防旧值
- 新增采集记录（按月分区保留 90 天）、人工冲正流水与后台接口、采集告警
- 扣减按采集时刻有效套餐查找，只对生效中套餐做状态迁移，查不到套餐按成功跳过
- 换货新卡（新设备下的卡）打待建起点；采集间隔上限只校验启用中的轮询配置
Change: add-card-traffic-queue-and-observed-deduction
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com >
2026-10-29 12:18:47 +09:00
邹进
62ec94adec
refactor: 出库时间更名为首次购买套餐时间，换货新资产不再按换货完成时间记录
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 38s
- 字段 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: 实名即生效套餐沉默期、延期办理与资产出库时间
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 8m39s
- 迁移 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
邹进
d2b0d2f534
fix: 排队激活未评估停复机、孤儿套餐重复激活与微信查单订单不存在反复重查
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m26s
- 排队激活与首次实名激活任务的处理器注入停复机服务：原来传 nil，激活后不重新评估停复机，付款或实名后要等下一轮轮询才复机（生产同样存在）
- 孤儿套餐扫描跳过载体未实名的"实名即生效"套餐：激活服务会直接跳过，原来每 10 秒重复提交一次激活任务
- 微信 v2 查单返回 ORDERNOTEXIST 时按"渠道无此订单"处理：代理充值支付单过期后关闭，不再当作结果未知每几分钟重查
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com >
2026-10-27 11:07:17 +09:00
邹进
d4fde99cc3
fix: 停复机成功后上游状态滞后导致暂停轮询的卡到期或退款漏停
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m29s
- 停复机成功后保护窗口内（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
邹进
7ddb9312e3
feat: 不轮询清单与批量开关轮询
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m35s
- 新增不轮询清单 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
邹进
af8249158d
feat: 停复机规则演练与终态自动关闭轮询
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m26s
统一停复机规则转正的第一次发布：总开关仍关闭，现有停复机行为不变。
- 新增停复机规则演练：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: 下线设备保护期
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m30s
- 后台设备停复机不再设置 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
邹进
98017ac053
feat: 分层轮询、重置日前加密与激活前流量结算
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m37s
- 轮询配置新增套餐状态、资产状态、重置日前窗口与窗口内流量间隔（迁移 248），间隔三态：正数按间隔、0 不检查、空继承
- 配置按 priority, id 排序合并；在库与已销售无套餐未匹配时告警不入队
- 新增优先级整体重排、匹配预览、立即重算到期时间（异步只提前）、分层统计与重置日前加密统计接口
- 已切换日快照计量的卡流量按观测时间归属，激活前用量只记已结算
- 订单购买与实名激活补齐资产级激活锁，激活前对已切换卡结算一次流量，失败只告警不阻塞，结算不触发通道阈值判定
2026-10-24 17:06:38 +09:00
邹进
9e45097aa2
fix: 富友订单支持退款，0 元退款不强制客户收款材料映射
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
- 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: 卡流量改为日快照计量并统一停复机规则
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
卡流量计量（按名单灰度，默认 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
邹进
08a7a00cd9
fix: 微信授权配置公众号必填、小程序选填
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m25s
商户池变更把授权完整性实现为公众号与小程序四项凭证都必填，
生产只用公众号 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
邹进
bcb1ce0653
fix: 退款审批退款凭证误取客户收款凭证导致非客户收款方式提交失败
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m40s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com >
2026-10-14 16:57:58 +09:00
邹进
713045a657
fix: 第1批 M9 H5 进入资产的临期个人通知写入即已读
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 12m9s
H5 进入资产时已同步弹窗展示临期提醒，通知中心再记未读会重复提醒；
通知按剩余天数每天新增一条，保持未读会持续累积红点。
直发通知载荷新增可选 mark_read，仅临期个人通知设置，其他直发通知与店铺临期通知仍为未读。
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com >
2026-10-14 10:45:20 +09:00
邹进
0f1ea5bc3e
fix: 第1批 M9 套餐临期提醒按资产、扫码进入时触发
...
构建并部署到测试环境（无 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 端到端验证与每日扫描验证待测试部署后完成
2026-10-12 00:15:27 +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 导入与展示类缺陷
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 8h37m36s
- 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 登录密码统一规则与三类导出补列
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
- 七个设置登录密码入口统一 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: 恢复退款审批场景可选业务字段「资产标识」
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m54s
提交 622e99b5noreply@anthropic.com >
2026-09-27 12:07:32 +09:00
9959168e22
完成支付失败商户轮换禁用
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 5h7m21s
2026-09-22 15:58:03 +08:00
622e99b543
移除退款审批重复资产类型字段
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m56s
2026-09-22 14:22:51 +08:00
4330b8a40c
新增设备类型选项接口
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
2026-09-22 12:35:26 +08:00
22c3e7cc1a
实施业务用户组成员管理
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m42s
2026-09-21 21:20:38 +08:00
4a16eb0b1e
新增代理注册申请管理
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m41s
2026-09-21 16:51:37 +08:00
b063617153
完善退款审批材料与恢复流程
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m35s
2026-09-20 17:59:52 +08:00
5ed6b39deb
feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
- 新增六对成对迁移 000232–000237：H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕
- 退款：原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败
- 优先轮询：人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影
- 通道阈值：命中事实同事务留痕与命中记录查询；员工账单：列表筛选与详情投影；商户池：列表投影与统计周期语义；H5：弹窗类型与类别排序
- 手机号：有效关联数量与最近解绑人、短信验证码失败次数限制；导出：佣金明细十五列与报表序号列
- 时间筛选：三处新增筛选纳入统一严格解析契约，员工账单产生时间参数改名
- 同步 12 份主 Spec 需求、两端点与异步任务证据链，门禁 context-health 与 OpenSpec 校验通过
2026-09-18 15:34:29 +08:00
5e78809b93
feat(运营报表): AUG26-015 设备激活与套餐续费日报快照、查询趋势与受控导出
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 15m33s
- 新增成对迁移 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
6333f4ad13
fix(代理分销注册): 校验手机号/用户名/店铺编号唯一性并支持驳回后重注册
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m57s
- 提交写事务内先取事务级 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
e8ab1f471e
fix(代理分销注册): 验证码改为落库成功后消费并细化失败原因
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 12m54s
公开扫码注册原先在审批准备前就消费短信验证码，落库前的任何失败都会烧掉验证码，
客户重试只能得到统一的“分销码不可用”，掩盖了真实失败原因。
- 验证码校验与消费拆分为 CheckCode 与 ConsumeCode，注册记录与审批实例落库成功后才原子消费；
校验不消费、消费一次性，落库前失败时同一验证码可直接重试
- 分销码无效、所属店铺已停用、上级店铺缺少启用的主账号、验证码错误分别返回各自错误码与提示
- 注册必填字段缺失与请求参数校验失败提示定位到具体字段
- 同步公开接口描述与 agent-distribution-withdrawal 主 Spec 行为契约
2026-09-17 18:01:47 +08:00
d52be16802
feat(资产钱包自动续费): 新增全局配置、每日扫描续购与可靠复机
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m15s
- 新增单行配置表 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
70e6b186df
fix(退款): 修复创建退款申请插入审批尝试记录失败
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m23s
创建路径把审批尝试记录在事务外预构造后原样插入，缺失只能在事务内生成的
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
aab56a6998
feat(轮询优先队列): AUG26-016 卡轮询优先队列、人工入队与读侧接口，归档并同步主 Spec 与证据矩阵
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 14m13s
新增 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
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
ef4d3696d4
fix(通道流量阈值): AUG26-011 修复周期处理连接池自锁并补齐根池句柄验证与文档
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
2026-09-16 16:59:32 +08:00
15bbb953db
fix(通道流量阈值): AUG26-011 修复失败/未知结果收敛、锁定 carrier 缺失出路与审计回归
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 13m29s
2026-09-16 16:41:25 +08:00
59b3df868a
feat(通道流量阈值): AUG26-011 运营商通道流量阈值达量停机与周期复机
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 12m59s
2026-09-16 15:54:49 +08:00
333ba4b647
feat(H5弹窗): AUG26-007 风险换卡与运营弹窗投放通知
...
构建并部署到测试环境（无 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）与参数校验中文提示共用实现。
2026-09-15 15:23:52 +08:00
70e680eb0a
feat(手机号资产关联): AUG26-009 手机号—资产关联、十项上限与后台解绑
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m2s
- 新增成对迁移 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
c7f9e005af
feat(业务用户组): AUG26-003 业务用户组与店铺负责人分组导入
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 1h43m42s
- 迁移 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
ba0855d9eb
feat(退款): AUG26-006 退款方式选择与原路退款
...
按 PRD 2.3/2.4/2.5 落地套餐退款的方式矩阵与原路渠道退款：
- 退款申请派生并冻结权威实收金额（线上取原成功支付记录，钱包/线下取订单实际收款），
提交人不可填写或修改；按来源支付方式生成可选方式矩阵并在创建、提交、执行前重复校验。
- 审批切换为「每次提交一条不可变审批尝试记录 + 独立企业微信审批实例」，业务标识取尝试
记录主键；终态消费按尝试记录优先、退款申请兜底双读，兼容存量无实例与已关联实例申请。
新增活动退款部分唯一索引 (order_id) WHERE status IN (1,5,6)。
- 本地人工终审保持既有开关，补齐通过入口的 approval_instance_id IS NULL 守卫，使三个
入口一致拒绝已关联审批实例的申请；重提按尝试模式重写（仅已拒绝/已退回/原路失败且无异常）。
- 权益时点：企微通过事务写退款终态、按方式确定的订单态、钱包回款、员工账单冲销与可靠
失效事实；套餐失效/接续/停机仍由既有可靠机制最终一致执行，不把外部调用放入资金事务。
订单支付状态按方式置位：凭证退款与退回原钱包在企微通过时置已退款，原路须渠道明确成功。
- 按官方契约实现微信直连 v3、微信 v2（双向证书）、富友（/commonRefund 与 /refundQuery）、
支付宝四类原路退款；能力只由服务商类型与退款必需凭证完整性决定，无人工开关。
渠道请求号在提交时冻结到尝试记录，并以 channel_submitted_at 条件认领保证资金动作至多
提交一次（重复投递只查询不二次提交）；不向任何渠道传递退款结果通知地址。
- 新增 refund:channel:recovery 恢复任务只查询回填；本地查询窗口超期（富友 72 小时、
微信 v2 7 天）转原路退款失败、渠道状态已失败、分类超时未知并置异常转人工，不放行自动
重提以避免重复退款。
- 同步退款 DTO/导出/审计资源与审计查询关联、商户凭证文档，并修正 fuiou 集成契约文档。
迁移 000218（退款尝试与渠道退款事实）、000219（微信 v2 客户端证书凭证）成对提供，
未修改既有迁移；测试库 junhong_cmp_test 完成 up/down/up 与行为核对，未调用真实渠道。
2026-09-14 11:55:16 +08:00
575d056f54
feat(代理分销提现): 落地扫码注册、提现资料资格与企微终审提现
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
AUG26-008。
- 迁移 000214–000217：tb_shop 全局唯一且不可修改的随机分销码（含存量回填）、
tb_agent_distribution_registration 待审批注册记录、tb_withdrawal_qualification 资料版本、
tb_commission_withdrawal_request_attempt 审批尝试记录，以及提现申请的 latest_*/异常标记列；
不修改既有迁移，down 在存在本 Change 业务事实或新类型场景行时拒绝破坏性回滚。
- 公开接口 POST /api/c/v1/agent-distribution-registrations：无认证，复用既有短信验证码校验、
消费与限流；无效分销码、停用上级、验证码无效或已消费统一返回「分销码不可用」且不落库，
审批通过前不创建店铺、账号或钱包。
- 审批通过才在同一事务内建启用店铺、代理主账号、钱包、上级层级与业务员快照，驳回不建实体，
重复回调不重复建实体，提交后清理上级下级缓存。
- 提现资料资格按不可变版本保存，替换合同或法人身份证即新增版本并同事务失效旧有效版本；
超管作废原因必填；代理停用与店铺删除联动失效。
- 提现每次提交或重提新增不可变审批尝试记录并冻结金额；企业微信通过仅一次从冻结扣减、
保持状态 2 并写 paid_at（不使用状态 4），驳回/cancelled/deleted 仅一次释放，
通过后撤销不回滚、不重新冻结、只写正交异常标记；加锁顺序统一为申请→尝试→钱包。
- 本地人工终审对已关联审批实例的申请返回状态冲突，approval_instance_id 为空的存量申请保持既有行为，
不新增任何配置开关。
- 补齐审批业务类型注册点全集：业务类型与场景字段常量、场景 DTO 两处枚举与中文描述、
场景字段白名单/合法类型/中文名、数据库 CHECK、Worker 决策消费者与装配、审批审计资源映射，
以及三个新审计资源与 13 个审计动作；失败/拒绝审计改为必达。
- 新增后台路由与 OpenAPI：资格提交/查询/作废、提现申请/重提/详情、店铺详情返回只读分销码。
- 归档本 Change：主 Spec 新增 agent-distribution-withdrawal 能力（5 个 Requirement）。
验证（junhong_cmp_test + Redis DB 6，显式 DB_*，未重置整库）：
- 迁移 up → version 217 且 dirty=false → down 3 → up 回 217，fixture 复核残留为 0。
- 受控状态机脚手架 227 项通过 / 0 项失败，覆盖 18 组场景（幂等与乱序回调、资金冻结/释放/重提、
退款回扣 × 在途提现并发、负向场景拒绝审计与 14 个动作码审计真实落库）。
- gofmt 空、go build/go vet 通过、gendocs 与工作区逐字节一致、context-health 通过、
openspec validate --strict 通过、doctor healthy；自动化测试按项目决策为 N/A。
运行期前置（未完成，非代码交付物）：由超管经 PUT /api/admin/wecom/scenes/{business_type} 为
agent_distribution_approval、withdrawal_qualification_approval、commission_withdrawal_approval
配置启用场景与模板控件映射；未配置时相应提交失败关闭。
2026-09-14 09:45:13 +08:00
7891189712
feat(代理自充): AUG26-017 代理自充收款方式与线下预存款审批字段
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m52s
- 受控配置新增代理在线自充允许范围（仅微信/仅支付宝/同时支持），读侧与创建侧取允许范围与可用商户池交集，两侧失败关闭
- 新增允许范围查询与修改端点，读限代理与平台账号、写限超级管理员，复用受控配置写服务留痕
- tb_agent_recharge_record 新增交易流水号、线下收款方式三列快照与其他凭证列（成对迁移 000213）
- 线下申请校验启用的收款方式字典项与必填交易流水号，交易流水号独立于在线渠道交易号、不参与去重
- 扩展 offline_recharge_approval 场景可映射字段白名单与字典引用保护
- 新增付款凭证识别能力与交易流水号预填接口，识别不落库、日志不记录载荷
2026-09-11 15:21:23 +08:00
ce24d5612e
feat(员工代收款): 新增员工代收款账单闭环
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
- 新增 6 张表与成对迁移 000212，扩展企业微信审批场景业务类型白名单
- 后台线下套餐订单与两条代理线下充值入账路径在来源成功事务内建账，来源唯一键幂等
- 核销申请、审批尝试记录、账单分摊预占与驳回重提，审批业务类型 employee_collection_approval
- 企业微信终态消费幂等：通过转已核销、驳回释放预占、通过后撤销不回滚并转异常终态
- 退款成功事务内按 bill_id+refund_id 幂等冲销账单或仅写退款关联提示
- 线下收款方式字典、账单查询/统计/关闭、申请查询与代办权限，均写入事务内审计
OpenSpec Change: add-employee-collection-bills
2026-09-10 18:24:05 +08:00
98c145fe70
实现支付商户池与微信授权配置
...
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 3m55s
新增收款商户、商户池轮询、微信授权配置独立管理；三类新支付
（C端套餐购买、C端资产钱包充值、代理在线预存款充值）无条件
经商户池选择并冻结路由，无旧综合配置回退。merchant_id 为空
历史支付继续按 payment_config_id 双读。凭证版本化加载与
ID+版本缓存保证轮换一致性。删除商户池新支付创建开关及全部
引用。
2026-09-09 18:13:04 +08:00
dbfeeee253
缓解io压力
2026-09-02 16:14:27 +08:00
62f3d25e81
修复批量订购
2026-08-26 14:54:26 +08:00
22b95db2f9
每日清理
2026-08-20 12:03:17 +08:00
656a921ff0
富友支付支持
2026-08-18 17:13:20 +08:00
