45 Commits

Author	SHA1	Message	Date
邹进	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
邹进	d2b0d2f534	fix: 排队激活未评估停复机、孤儿套餐重复激活与微信查单订单不存在反复重查 ... - 排队激活与首次实名激活任务的处理器注入停复机服务：原来传 nil，激活后不重新评估停复机，付款或实名后要等下一轮轮询才复机（生产同样存在） - 孤儿套餐扫描跳过载体未实名的"实名即生效"套餐：激活服务会直接跳过，原来每 10 秒重复提交一次激活任务 - 微信 v2 查单返回 ORDERNOTEXIST 时按"渠道无此订单"处理：代理充值支付单过期后关闭，不再当作结果未知每几分钟重查 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	2026-10-27 11:07:17 +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
邹进	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
邹进	1369fed642	fix: 账户限流预算小于单卡调用数时卡永远领不到 ... 领取脚本在一张卡同组到期调用数大于剩余预算时停止领取，账户 QPS 很小或长期接近上限时，同时到期多项的卡会一直排不上，整个账户停止轮询。改为本轮该组尚未占用且预算大于 0 时至少放行一张，超出部分由网关限流等待模式排队；预算为 0 时仍不领取。	2026-10-25 23:39:25 +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
邹进	0d966249b8	feat: 业务事件与读入口在按运营商账户调度时改为请求检查 ... - 请求检查器按场景配置（tb_polling_check_scene，缓存 30 秒）把卡的检查类型设为立即到期放入账户优先队列，同卡合并、冷却期内不请求、按场景追加延迟确认；设备按有效绑定卡展开 - 业务事件仍在原事务中写 Outbox（提交安全），carrier 模式下 Outbox 消费者把订单支付、套餐激活、自动续费购包、停复机成功事件转为请求检查，不再起三连查观测序列 - 读入口（C 端资产详情、后台资产实时状态、实名链接、设备操作）经模式接缝改为请求检查；设备信息同步保持原观测；OpenAPI 查询仍不触发 - legacy 模式下全部沿用原观测序列	2026-10-25 18:49:36 +09:00
邹进	2fe7c1f8ac	feat: 按运营商账户调度的分发器、卡任务执行器与模式切换 ... - 四个轮询处理器拆为步骤函数 Step（返回结果分类），旧 Asynq Handle 只做并发控制与原有重入队映射，行为不变；carrier 模式下旧 handler 直接结束 - 网关限流增加等待模式（ctx 标记），NSQ 消费者等名额到单步超时，超时按限流处理不计失败；记录限流等待次数 - 卡任务执行器：核对 token 并抢执行权，按配置步骤顺序串行执行到期检查（单步超时、总超时、panic 恢复、流量已触发评估时跳过套餐），执行中续期并 Touch，续期失败立即停止；收尾写回到期、连续失败、退避、延迟确认与告警 - 分发器：每秒按账户抢分发锁领取（执行上限按消费能力收紧、优先占比、按限流组剩余 QPS 估算），发布到 polling.card.{账户}，发布失败释放；消费旧优先提示与手动触发；心跳与处理中标记到期计数 - NSQ 生产者与按账户动态订阅的消费者管理器，优雅退出宽限期 - 失败告警异步写 tb_polling_failure_alert（同卡同类型一条未处理，成功转已恢复），账户窗口内告警数超阈值产生账户级告警 - 模式监听：切 carrier 时旧分片调度停止出队，加锁初始化新结构后开始领取并订阅；回 legacy 时停止消费、重建旧分片队列；生命周期（API 与 Worker）在 carrier 模式写账户队列	2026-10-25 18:44:23 +09:00
邹进	dae44bed30	feat: 按运营商账户调度的迁移、配置与账户队列 Lua ... - 迁移 000251~000254：运营商账户调度参数、请求检查场景（预置 8 个）、卡轮询失败告警表，以及调度模式、步骤、退避、告警等受控系统配置（默认 legacy，行为不变）；并发配置表注释标记废弃 - 受控系统配置注册与 JSON 结构校验：步骤只能是 4 种检查类型且不重复、退避序列递增 - yaml 增加 NSQ 地址、msg_timeout、租约、续期间隔、分发间隔、默认执行上限与 max_in_flight；引入 go-nsq - 测试环境 docker-compose 增加 nsqlookupd 与 nsqd，Worker 注入 NSQ 地址 - 账户队列 Redis 结构与 Lua：领取（执行上限、优先占比、按限流组剩余 QPS 估算）、抢执行权、续期、收尾、请求检查（合并、冷却、执行中打优先标记）、移出、发布失败释放	2026-10-25 18:28:42 +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
邹进	ec5c1996a7	fix: 重算到期时间不抵消失败退避，重置日前统计只计有生效套餐的卡 ... - 上次检查时间只在查询成功时更新，按"上次检查 + 新间隔"会把失败或限流延后的卡拉到立即执行； 过期或从未检查时候选改为"现在 + 新间隔"，只提前排队超过一个新间隔的成员 - 重置日前加密统计只记录有生效套餐的卡，与"有生效套餐但窗口内未查到"口径一致	2026-10-24 17:28:18 +09:00
邹进	98017ac053	feat: 分层轮询、重置日前加密与激活前流量结算 ... - 轮询配置新增套餐状态、资产状态、重置日前窗口与窗口内流量间隔（迁移 248），间隔三态：正数按间隔、0 不检查、空继承 - 配置按 priority, id 排序合并；在库与已销售无套餐未匹配时告警不入队 - 新增优先级整体重排、匹配预览、立即重算到期时间（异步只提前）、分层统计与重置日前加密统计接口 - 已切换日快照计量的卡流量按观测时间归属，激活前用量只记已结算 - 订单购买与实名激活补齐资产级激活锁，激活前对已切换卡结算一次流量，失败只告警不阻塞，结算不触发通道阈值判定	2026-10-24 17:06:38 +09:00
break	34f91f129f	修复加油包独立有效期和流量重置	2026-09-22 16:36:42 +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	395e5fb47c	修复套餐接续停机竞态与轮询兜底	2026-08-29 16:27:48 +08:00
break	d256f6d176	合并七月迭代分支	2026-08-18 14:53:29 +08:00
break	88cc5e96ec	暂存	2026-08-06 09:35:00 +08:00
break	5e552d99bc	收口审计治理与套餐任务进展 ... Constraint: 在线热修前必须保存当前迭代分支全部有效代码进展 Confidence: medium Scope-risk: broad Directive: 后续修改需保持审计事件与业务事务边界一致 Tested: git diff --cached --check Not-tested: 未运行全量测试，提交用于切换分支前保存既有工作	2026-08-05 14:30:54 +08:00
break	a0de08d789	避免套餐过期后排队权益永久失联 ... 线上保持现有纯 Asynq 架构，以公平孤儿扫描和提交后投递消除永久饥饿及事务可见性竞态。 Constraint: 线上保持现有纯 Asynq 架构，不引入 Outbox、迁移或新任务基础设施。 Rejected: 事务内投递或扩大扫描 LIMIT | 无法消除竞态和永久饥饿。 Confidence: high Scope-risk: narrow Directive: 后续分支整合时按目标分支的套餐接续架构独立处理，不混用本热修实现。 Tested: go build ./...（退出码 0）；git diff --check；openspec validate fix-main-package-activation-starvation --strict。 Not-tested: 按用户要求未新增、修改或运行自动化测试；线上 SQL、查询计划和日志待部署后核验。	2026-08-03 09:58:05 +08:00
break	76f657c986	1. 套餐过期前再主动同步一次流量 ... 2. 生效套餐逻辑错误的问题	2026-06-30 15:54:55 +09:00
break	8cf921f11c	驳回接口	2026-06-25 17:10:24 +09:00
break	3f21f7a7d6	让超时时间设置成60秒	2026-06-21 17:06:40 +08:00
Break	134021c91e	修复错误的停止	2026-06-11 10:01:35 +08:00
Break	32c9859b38	监控	2026-06-10 01:15:26 +08:00
Break	0d96a94e5f	关于上游流量同步覆盖修复,以及新增redis同步迁移	2026-05-27 10:59:19 +08:00
huang	226474b434	轮训有问题	2026-05-22 16:21:46 +08:00
huang	a5388446d3	新增字段	2026-05-12 14:10:48 +08:00
huang	95fc0b0a1b	修复一些问题,主要是生效套餐	2026-05-12 10:32:38 +08:00
huang	b7369a9c71	修复并发,暂时的,不够完整,后续还是需要重新设计,这个太乱了,傻逼AI	2026-05-11 17:19:40 +08:00
huang	aef20d2ab1	fix: 修复禁用所有轮询配置重启后再启用无法工作的问题 ... - 新增 RedisPollingConfigChangedChannel 常量，用于跨进程配置变更通知 - ConfigService 注入 Redis，Create/Delete/UpdateStatus 后发布 Pub/Sub 事件 - PollingConfigManager 新增 WatchChanges() 方法，收到通知立即刷新内存缓存 - PollingInitializer 新增 Restart() 方法，支持初始化完成后安全重启（CAS 防并发） - Worker 订阅配置变更事件，configs 从空变为非空时触发 Initializer.Restart() 根因：启动时所有配置禁用导致分片队列为空，Initializer 是一次性的， 之后启用配置只更新 DB 但不重建队列，调度器无卡可处理	2026-04-16 17:32:43 +08:00
huang	5d9be1d7e4	fix: 修正轮询配置多匹配逻辑，支持同卡匹配多个配置并按 priority 合并 interval ... 核心变更： - MatchConfig 改为 MatchConfigs，返回所有匹配配置 - MergedTaskIntervals 按 task type 合并各配置，选取最高优先级（非 nil 且最小 priority 值） - hasAnyEnabledInterval 过滤所有 interval 均为 NULL 的配置 - calcInitialDelay 重构为纯函数，接收 interval 参数 - 移除 getEnabledTaskTypes 和 getIntervalByTaskType（被 MergedTaskIntervals 替代） - scheduler.go 新增心跳 key + 顶层 panic recovery + Init 完成守卫 - initializer.go 批量失败日志升级为 Error，逐条检查 Pipeline 命令错误 - 数据迁移：禁用 id=29 的轮询配置（所有 interval 均为 NULL） Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-04-16 14:27:47 +08:00
huang	5065d925ad	fix: 修正套餐激活和时间字段nullable问题 ... 核心变更： 1. Model层时间字段改为*time.Time并设为nullable - PackageUsage.ActivatedAt/ExpiresAt - PersonalCustomerDevice/ICCID/Phone.LastUsedAt/VerifiedAt 2. 数据库迁移： - activated_at/expires_at列移除NOT NULL约束 - 清洗零值记录(status=0且activated_at<'2000-01-01') 3. 新增ActivateSpecificPackage方法：精准激活指定套餐， 修复HandlePackageQueueActivation从"查找过期包"改为直接激活payload指定套餐 4. 新增孤儿套餐恢复扫描：Worker启动或每次套餐检查时， 自动发现并恢复无status=1主套餐的孤儿载体 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-04-16 11:14:39 +08:00
huang	647d78309d	feat: 将卡状态任务类型接入队列管理、生命周期和初始化器 ... queue_manager.go: allTaskTypes 追加 TaskTypePollingCardStatus，注释更正为5个队列 lifecycle_service.go: getEnabledTaskTypes 和 calcInitialDelay 新增 card_status 条件 initializer.go: initBatch 新增 CardStatusCheckInterval 块，以 LastCardStatusCheckAt 为基准写入分片队列 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-15 12:22:42 +08:00
huang	2a7ac3f86e	fix: 修复轮询系统缓存不一致和可观测性问题 ... - OnCardStatusChanged/Enabled/Disabled 添加 InvalidateCardCache， 解决 Refresh API 更新 DB 后 polling 缓存仍为旧值的 bug - AssetResolveResponse 的 enable_polling/network_status 去掉 omitempty，解决 false/0 时字段从响应中消失的问题 - Scheduler/Initializer/PackageHandler 增加 INFO 级别日志， 可通过日志判断轮询是否工作、处理了哪些卡	2026-04-10 15:52:38 +08:00
huang	434a8b0349	feat: 轮询系统重构（分片队列 + 停复机统一 + Handler 拆分） ... 【核心变更】 1. 停复机逻辑统一（StopResumeService） - 新增 EvaluateAndAct 统一入口，封装三条件停复机判断 - 停机条件：无套餐(no_package) / 流量耗尽(traffic_exhausted) / 未实名(not_realname) - 复机条件：stop_reason 合规 + 有套餐且未耗尽 + 已实名或行业卡 - 修复设备套餐 Bug：hasValidPackage 按 device_id 查套餐，而非仅 iot_card_id - 设备维度停复机加幂等锁（Redis SetNX，TTL 30s），防止多卡并发重复调 Gateway 2. Redis 分片队列（PollingQueueManager） - 新建 queue_manager.go，封装所有轮询 Redis 操作 - 16 分片 Sorted Set，Key 格式：polling:shard:{shardID}:queue:{taskType} - Lua 脚本原子出队（ZRANGEBYSCORE + 分批 ZREM），消除竞态窗口 - 新增背压检测：队列深度超 50 万时 Scheduler 跳过该分片 - RemoveFromAllQueues 覆盖 4 种任务类型（含 protect） 3. Handler 拆分（polling_handler.go 1360行 → 5个专注文件） - polling_base.go：共享基类（并发控制/卡缓存/重入队） - polling_realname_handler.go：实名采集，实名 0→1 时立即触发复机 - polling_carddata_handler.go：流量采集，保留跨月边界检测逻辑 - polling_package_handler.go：套餐采集，委托 EvaluateAndAct 决策 - polling_protect_handler.go：保护期一致性检查，保护期内强制修正 4. 配置管理（PollingConfigManager） - 新建 config_manager.go，从 scheduler.go 提取配置职责 - 内存缓存 + 5 分钟定时刷新，刷新失败保留原缓存 - 修复 getCardCondition：停机卡返回 suspended，不再错配 activated 配置 5. 渐进式初始化（CardInitializer） - 新建 initializer.go，分批加载（每批 10 万），批次间 sleep 500ms - 过滤 enable_polling=false 的卡，初始化完成前 Scheduler 不出队 6. 卡生命周期服务（PollingLifecycleService） - 新建 lifecycle_service.go，替代已删除的 callbacks.go 和 api_callback.go - OnCardCreated/OnCardEnabled/OnCardStatusChanged 入队前检查 enable_polling 7. Scheduler 精简（1000+行 → 227行） - 保留纯调度循环：scheduleLoop + processShardSchedule + enqueueBatch - 保留每 10 秒触发套餐过期检测和流量重置 - 移除所有 DB 操作、配置加载、卡初始化逻辑 8. 轮询管控 API（enable_polling） - 新增 PUT /api/admin/assets/:id/polling-status 接口 - 支持对设备/卡维度开关轮询，关闭后从所有分片队列移除 9. 数据库迁移 - 000103：tb_device 新增 enable_polling 字段（boolean, NOT NULL, DEFAULT true） - 000104：新增 suspended 轮询配置，为 activated 配置补全 protect_check_interval 【文件统计】 - 新增：19 个文件（handler × 5、polling 组件 × 4、迁移 × 3 等） - 修改：20 个文件（bootstrap 注入、store 接口、monitoring 适配分片等） - 删除：3 个文件（polling_handler.go、callbacks.go、api_callback.go） Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-07 12:27:04 +08:00
huang	8980e6d999	fix: 补全三处轮询覆盖缺口 ... 问题一：protect 轮询任务从未被调度器初始化入队 PollingConfig 新增 protect_check_interval 字段（NULL=不参与）， 调度器 initCardsBatch/initCardPolling/requeueCard 补全 protect 队列 初始化逻辑，IotCard 新增 last_protect_check_at 记录上次检查时间。 迁移文件：000102_add_polling_protect_fields 问题二：设备套餐流量耗尽时绑定卡未被停机 UsageService.checkAndTriggerSuspension 新增 carrier_type=device 分支， 通过 DeviceSimBindingStore.ListByDeviceID 查询绑定卡，对每张卡异步 触发 CheckAndStopCard，同步注入 Bootstrap 依赖。 问题三：主套餐过期后不立即停机，依赖下次轮询兜底 PackageActivationHandler.processExpiredPackage 在 updateCarrierSuspended Status 后，若载体无后续生效套餐，立即异步调用 CheckAndStopCard（iot_card 类型直接触发，device 类型遍历绑定卡），消除停机延迟窗口。 Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-02 14:36:24 +08:00
huang	950c0bfb8f	fix: 修复已激活在线卡无有效套餐时未被轮询停机的问题 ... - 新增 activated 轮询配置覆盖已实名+在线的卡（此前仅 real_name 配置） - HandleCarddataCheck 添加独立停机/复机检查（不依赖流量增量） - shouldStopCard 对齐 hasAvailablePackage 逻辑，检查待生效+生效中套餐 - 新增复机安全网：流量耗尽停机的卡检测到有效套餐后自动复机 - 卡缓存补充 stop_reason 字段支持复机判断	2026-03-31 20:51:42 +08:00
huang	49e8ebed60	fix: 过期套餐检测扩展覆盖 Depleted 状态（status IN (1,2)） ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-31 18:12:04 +08:00
huang	623a622298	feat: 业务逻辑补全 — 佣金待审记录、C端订单重构、支付抽象、富友支付、卡设备状态联动 ... F-1: 佣金链断裂时创建 status=99 零额待审记录，新增修正接口 POST /commission-records/:id/resolve F-4: C端订单查询从 Handler 迁移至 Service 层，移除 SkipPermissionCtx J-1: 富友支付 JSAPI/MiniApp 预下单实现，回调补全签名验证 J-2: 平台钱包代购支持（buyerType 为空时使用资产所属代理钱包） J-3: 套餐激活后自动更新卡/设备 status=3，最后套餐过期后更新 status=4 支付抽象: 引入 PaymentProvider 接口 + 微信/富友适配器，CreateOrder 支持多支付渠道 修复: 设备/IoT卡响应 DTO 移除 omitempty，空值字段返回 null 而非省略	2026-03-28 16:57:39 +08:00
huang	922a3d0b49	fix(poll): polling:protect 接入调度器 POLL-01 ... - processSchedule 中新增 TaskTypePollingProtect 的 processManualQueue 和 processTimedQueue 调用 - 保护期一致性检查任务现在会被定期调度处理	2026-03-28 10:39:18 +08:00
huang	1fd0072f69	fix(01-01): 统一实名状态常量（CRITICAL-01 核心） ... - polling_handler.go: parseRealnameStatus 不再返回硬编码 2，改为 constants.RealNameStatusVerified(=1) - polling_handler.go: isFirstRealname 判断改用常量比较，不再使用 == 2 - polling_handler.go: HandleProtectConsistencyCheck 注释更正为 real_name_status=1 - iot_card.go: RealNameStatus gorm comment 统一为 0-未实名 1-已实名（去除行业卡说明） - asset_dto.go: RealNameStatus description 更正为 0未实名 1已实名（去除错误的 1实名中 2已实名） - scheduler.go: getCardCondition 改用常量替代硬编码 0/1/2 判断 - iot_card/service.go: parseGatewayRealnameStatus 注释更正，返回值改为常量	2026-03-27 22:53:30 +08:00
huang	18daeae65a	feat: 钱包系统分离 - 代理钱包与卡钱包完全隔离 ... ## 变更概述 将统一钱包系统拆分为代理钱包和卡钱包两个独立系统，实现数据表和代码层面的完全隔离。 ## 数据库变更 - 新增 6 张表：tb_agent_wallet、tb_agent_wallet_transaction、tb_agent_recharge_record、tb_card_wallet、tb_card_wallet_transaction、tb_card_recharge_record - 删除 3 张旧表：tb_wallet、tb_wallet_transaction、tb_recharge_record - 代理钱包：按 (shop_id, wallet_type) 唯一标识，支持主钱包和分佣钱包 - 卡钱包：按 (resource_type, resource_id) 唯一标识，支持物联网卡和设备 ## 代码变更 - Model 层：新增 AgentWallet、AgentWalletTransaction、AgentRechargeRecord、CardWallet、CardWalletTransaction、CardRechargeRecord 模型 - Store 层：新增 6 个独立 Store，支持事务、乐观锁、Redis 缓存 - Service 层：重构 commission_calculation、commission_withdrawal、order、recharge 等 8 个服务 - Bootstrap 层：更新 Store 和 Service 依赖注入 - 常量层：按钱包类型重新组织常量和 Redis Key 生成函数 ## 技术特性 - 乐观锁：使用 version 字段防止并发冲突 - 多租户：支持 shop_id_tag 和 enterprise_id_tag 过滤 - 事务管理：所有余额变动使用事务保证 ACID - 缓存策略：Cache-Aside 模式，余额变动后删除缓存 ## 业务影响 - 代理钱包和卡钱包业务完全隔离，互不影响 - 为独立监控、优化、扩展打下基础 - 提升代理钱包的稳定性和独立性 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-25 09:51:00 +08:00
huang	353621d923	移除所有测试代码和测试要求 ... **变更说明**: - 删除所有 *_test.go 文件（单元测试、集成测试、验收测试、流程测试） - 删除整个 tests/ 目录 - 更新 CLAUDE.md：用"测试禁令"章节替换所有测试要求 - 删除测试生成 Skill (openspec-generate-acceptance-tests) - 删除测试生成命令 (opsx:gen-tests) - 更新 tasks.md：删除所有测试相关任务 **新规范**: - ❌ 禁止编写任何形式的自动化测试 - ❌ 禁止创建 *_test.go 文件 - ❌ 禁止在任务中包含测试相关工作 - ✅ 仅当用户明确要求时才编写测试 **原因**: 业务系统的正确性通过人工验证和生产环境监控保证，测试代码维护成本高于价值。 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-11 17:13:42 +08:00
huang	931e140e8e	feat: 实现 IoT 卡轮询系统（支持千万级卡规模） ... 实现功能： - 实名状态检查轮询（可配置间隔） - 卡流量检查轮询（支持跨月流量追踪） - 套餐检查与超额自动停机 - 分布式并发控制（Redis 信号量） - 手动触发轮询（单卡/批量/条件筛选） - 数据清理配置与执行 - 告警规则与历史记录 - 实时监控统计（队列/性能/并发） 性能优化： - Redis 缓存卡信息，减少 DB 查询 - Pipeline 批量写入 Redis - 异步流量记录写入 - 渐进式初始化（10万卡/批） 压测工具（scripts/benchmark/）： - Mock Gateway 模拟上游服务 - 测试卡生成器 - 配置初始化脚本 - 实时监控脚本 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-05 17:32:44 +08:00