34 Commits

Author	SHA1	Message	Date
邹进	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
邹进	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
邹进	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
邹进	98017ac053	feat: 分层轮询、重置日前加密与激活前流量结算 ... - 轮询配置新增套餐状态、资产状态、重置日前窗口与窗口内流量间隔（迁移 248），间隔三态：正数按间隔、0 不检查、空继承 - 配置按 priority, id 排序合并；在库与已销售无套餐未匹配时告警不入队 - 新增优先级整体重排、匹配预览、立即重算到期时间（异步只提前）、分层统计与重置日前加密统计接口 - 已切换日快照计量的卡流量按观测时间归属，激活前用量只记已结算 - 订单购买与实名激活补齐资产级激活锁，激活前对已切换卡结算一次流量，失败只告警不阻塞，结算不触发通道阈值判定	2026-10-24 17:06:38 +09:00
邹进	42e881576d	feat: 卡网关按运营商账户限流并记录停复机调用 ... - 新增网关限流：按本系统运营商账户（卡 carrier_id）→ 限流组 → 操作限制每秒请求数，每次 HTTP 尝试计量，默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免；支持只统计与拦截两种模式，默认只统计 - Asynq 遇限流不计失败、固定短延迟重试；轮询任务与停复机业务重试遇限流短延迟重排 - 停机、复机不再使用网关内部重试，只发一次请求 - 网关返回结构化错误；新增上游错误分类规则表与测试接口 - 新增按月分区的停复机记录表：系统自动停复机只写记录，不再写统一审计与集成日志；普通轮询查询不再写集成日志 - 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口 - 迁移 000243~000246；同步 OpenSpec 提案（含后续 6 个 change）与技术方案、工程约束	2026-10-24 15:06:41 +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
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	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	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	c64f3d8b80	全局审计完成	2026-08-07 11:02:52 +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	9fdfad369f	确保批量购包能够写入观测事件 ... Constraint: 批量订购复用 Worker 内独立构造的订单服务\nRejected: 跳过购包观测 | 会破坏业务事务与观测事件的一致性\nConfidence: high\nScope-risk: narrow\nDirective: 新增订单服务构造入口时同步注入购包观测 Writer\nTested: 未运行测试，按用户要求仅检查目标文件差异\nNot-tested: 未执行自动化测试	2026-07-30 15:37:16 +08:00
break	73f5125d3d	七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西	2026-07-25 17:06:58 +08:00
break	5c4d17e9fc	收口七月卡状态回调与系列授权兼容契约 ... 完成运营商实名回调、业务事件观测序列与受控配置装配，同时恢复 UR43 已交付的 packages[].remove 字段及旧响应兼容，统一更新 OpenSpec、OpenAPI 和交付文档。 Constraint: 七月测试环境里程碑不新增或运行自动化测试 Rejected: 以必填 operation_type 替换 packages[].remove | 会破坏已交付前端契约 Confidence: high Scope-risk: broad Directive: 后续修改系列套餐管理接口必须保持 packages[].remove 和 ShopSeriesGrantResponse 兼容 Tested: go run ./cmd/gendocs；go build -buildvcs=false ./...；openspec validate complete-july-iteration-test-release --strict；git diff --check Not-tested: 按本 Change 约定未运行 go test，真实运营商与 Gateway 联调延期	2026-07-24 19:59:24 +08:00
break	a18ed8bc8d	暂存一下,防止丢失	2026-07-24 16:07:18 +08:00
huang	bb33232b1b	日志记录不全	2026-04-27 15:32:17 +08:00
huang	cb75b5668b	操作日志	2026-04-27 12:16:38 +08:00
huang	b972a776d9	重构充值订单模块：用 tb_recharge_order + tb_payment 替换 tb_asset_recharge_record ... - 新增 RechargeOrder 和 Payment 模型及对应 Store - 新增 ClientRechargeOrderHandler 提供充值订单列表/详情接口 - 修改 client_wallet.go 使用新表读写充值数据 - 修改 callback/payment.go 将 CRCH 订单路由到 rechargeOrderService - 修改 client_order/service.go 的强充流程使用新表 - 修改 auto_purchase.go 从 tb_recharge_order 读取 linked_package_ids - 修改 order/service.go 的 WalletPay 使用 tb_payment 记录 - 修改 wechat_config_store.go 从 tb_recharge_order 统计待支付充值数 - 移除 AssetRechargeStore 和 AssetRechargeRecord 的注册引用 - 修复文档生成器缺失 ClientRechargeOrder handler - 状态枚举改为 0-based: Pending=0, Paid=1, Closed=2, Refunded=3	2026-04-15 11:00:32 +08:00
huang	42c5ec912f	feat: 技术债务清理（支付配置动态化、API文档补全、轮询常量提取、废弃代码清理）	2026-04-14 11:11:15 +08:00
huang	5496cb58aa	feat: 订单创建时快照买家手机号/昵称和套餐类型 ... 新增字段： - tb_order: buyer_phone, buyer_nickname（个人客户下单时快照） - tb_order_item: package_type（套餐类型快照） 后台订单列表支持按 buyer_phone 精确过滤查询。 OpenSpec: order-buyer-snapshot	2026-04-10 17:12:56 +08:00
huang	80c6f6c756	feat: 资产标识符标准化、资产历史订单查询及导入虚拟号强制验证 ... 主要变更： - 新增 AssetIdentifier 模型及 Store，统一管理资产标识符（ICCID/IMEI/SN 等） - 新增迁移：asset_identifier 表、order 表新增 asset_identifier 字段、iot_card.virtual_no NOT NULL 约束 - 资产 Handler/Service/Route 全面重构，支持标识符路由查询与解析 - 新增资产历史订单查询接口，支持跨设备/卡/钱包维度的订单聚合 - 设备与物联卡导入任务强制校验虚拟号，缺失时直接拒绝 - Excel 工具函数优化，前端导入指引文档同步更新 - 归档三个 OpenSpec 提案：asset-identifier-standardization、asset-historical-orders、import-mandatory-virtual-no - 更新 OpenAPI 文档及相关 DTO Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-07 17:39:36 +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	8227ab2f20	fix: Bootstrap 注入复机回调至 orderService 和 resetService ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-31 18:12:32 +08:00
huang	65e461eff7	fix: 代码质量清理 — 统一C端支付枚举、修复静默错误、注入Worker回调、移除废弃同步代码 ... - C端订单支付状态直接使用管理端统一枚举(1/2/3/4)，移除冗余映射函数 - 资产查询绑定卡/套餐查询失败时记录Warn日志而非静默忽略 - Worker bootstrap注入停复机回调（流量耗尽停机、套餐激活复机） - 删除废弃的SIM状态同步服务和任务处理器 - 新增开发环境数据清理脚本（full/soft/table三种模式）	2026-03-28 15:27:59 +08:00
huang	429edf0d19	refactor: 注册微信配置和代理充值模块到 Bootstrap 和 OpenAPI 文档生成器 ... - bootstrap/types.go: 新增 WechatConfigStore/WechatConfigService/WechatConfigHandler/AgentRechargeService/AgentRechargeHandler 字段 - bootstrap/stores.go: 初始化 WechatConfigStore - bootstrap/services.go: 初始化 WechatConfigService（注入 AuditService）和 AgentRechargeService - bootstrap/handlers.go: 初始化 WechatConfigHandler 和 AgentRechargeHandler；PaymentHandler 新增 agentRechargeService 参数 - bootstrap/worker_services.go: 补充 WechatConfigService 注入 - routes/admin.go: 注册 WechatConfig 和 AgentRecharge 路由组 - openapi/handlers.go: 注册 WechatConfigHandler 和 AgentRechargeHandler 到文档生成器 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-16 23:30:30 +08:00
huang	fe77d9ca72	refactor: 注册 AssetWallet 组件到 Bootstrap ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-16 15:43:49 +08:00
huang	e661b59bb9	feat: 实现订单超时自动取消功能，支持钱包余额解冻和 Asynq Scheduler 统一调度 ... - 新增 expires_at 字段和复合索引，待支付订单 30 分钟超时自动取消 - 实现 cancelOrder/unfreezeWalletForCancel 钱包余额解冻逻辑 - 创建 Asynq 定时任务（order_expire/alert_check/data_cleanup） - 将原有 time.Ticker 轮询迁移至 Asynq Scheduler 统一调度 - 同步 delta specs 到 main specs 并归档变更	2026-02-28 17:16:15 +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	c665f32976	feat: 套餐系统升级 - Worker 重构、流量重置、文档与规范更新 ... - 重构 Worker 启动流程，引入 bootstrap 模块统一管理依赖注入 - 实现套餐流量重置服务（日/月/年周期重置） - 新增套餐激活排队、加油包绑定、囤货待实名激活逻辑 - 新增订单创建幂等性防重（Redis 业务键 + 分布式锁） - 更新 AGENTS.md/CLAUDE.md：新增注释规范、幂等性规范，移除测试要求 - 添加套餐系统升级完整文档（API文档、使用指南、功能总结、运维指南） - 归档 OpenSpec package-system-upgrade 变更，同步 specs 到主目录 - 新增 queue types 抽象和 Redis 常量定义	2026-02-12 14:24:15 +08:00