79 Commits

Author	SHA1	Message	Date
huang	42c5ec912f	feat: 技术债务清理（支付配置动态化、API文档补全、轮询常量提取、废弃代码清理）	2026-04-14 11:11:15 +08:00
huang	677d6239ce	fix: 统一佣金状态常量并修复佣金明细关联查询 ... - 删除 model/commission.go 中与 constants 包冲突的旧常量（值=1/2） - 所有服务层改用 constants.CommissionStatusReleased（值=3）写入和查询 - 数据库迁移：status 1→3（已发放），2→4（已失效） - 修复佣金明细列表接口，通过 JOIN 关联返回 order_no、iccid、virtual_no、order_created_at - 新增 seller_shop_id / seller_shop_name 销售来源字段 - 统计接口过滤条件从精确匹配改为排除无效（NOT IN 4,99） - 更新 OpenAPI 文档及 commission-record-query spec	2026-04-11 10:42:37 +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	cd807e58e3	feat: Excel 导入按列位置读取，IoT 卡导入支持卡业务类型 ... - 重写 parseCardRows：移除列名识别，固定跳过第1行表头，按 col0=ICCID、 col1=MSISDN、col2=VirtualNo 取值，VirtualNo 升级为必填字段 - 重写 ParseDeviceExcel：移除 buildDeviceColumnIndex，IMEI 调整至第5列 新增 MaxSimSlots 范围校验 [1,4]，整行为空时不计入 total - 删除 findCardColumns 和 buildDeviceColumnIndex 两个冗余函数 - ImportIotCardRequest 新增 card_category 字段（normal/industry，默认 normal） - IotCardImportTask model 新增 card_category 字段 - 迁移 000111：tb_iot_card_import_task 新增 card_category 列 - CreateImportTask 将 req.CardCategory 写入任务，空串兜底 normal - processBatch 改用 task.CardCategory 替代写死的 CardCategoryNormal - ImportTaskResponse 新增 card_category 字段返回 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-09 17:16:31 +08:00
huang	e9df1e7ded	feat: IoT卡新增绑定设备虚拟号快照字段 ... - tb_iot_card 新增 device_virtual_no 字段，存储绑定设备的虚拟号快照 - 列表/详情接口响应新增 device_virtual_no 字段 - 列表接口 is_standalone 改为可选参数（不传返回全部卡） - 移除列表接口 virtual_no 查询参数 - 绑卡/解绑时同步更新 device_virtual_no 快照 - 设备导入时批量写入 device_virtual_no 快照 - 归档 feat-iot-card-device-virtual-no 变更提案 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-04-09 10:50:46 +08:00
huang	cc56e27c01	feat: 后台线下支付订单强制上传支付凭证 ... 在后台创建订单接口中新增 payment_voucher_key 字段，线下支付方式 下该字段为必填，存储对象存储 file_key，便于后续追溯与审计。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 16:45:06 +08:00
huang	14a8ea5a2c	fix: 单卡导入虚拟号改为可选，非空时保证全局唯一	2026-04-08 10:45:23 +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	950c0bfb8f	fix: 修复已激活在线卡无有效套餐时未被轮询停机的问题 ... - 新增 activated 轮询配置覆盖已实名+在线的卡（此前仅 real_name 配置） - HandleCarddataCheck 添加独立停机/复机检查（不依赖流量增量） - shouldStopCard 对齐 hasAvailablePackage 逻辑，检查待生效+生效中套餐 - 新增复机安全网：流量耗尽停机的卡检测到有效套餐后自动复机 - 卡缓存补充 stop_reason 字段支持复机判断	2026-03-31 20:51:42 +08:00
huang	d7ade821f4	fix: 移除 carrier 表 billing_day 字段（模型 + 数据库迁移） ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-31 18:11:29 +08:00
huang	121462c00f	feat: 给 PackageUsage 添加 package_name 快照字段，修复企业卡列表 carrier_name/package_name 为空问题 ... - 迁移 000099：tb_package_usage 新增 package_name 列，回填历史数据 - PackageUsage model 添加 PackageName 字段（与 DataResetCycle 保持一致的快照设计） - 4 处 PackageUsage 创建点补充 PackageName 快照（order/service.go + auto_purchase.go） - EnterpriseCard ListCards：carrier_name 直接取 card.CarrierName，package_name 通过 DISTINCT ON 批量查当前生效主套餐，单次查询覆盖整页，无 N+1	2026-03-31 12:43:07 +08:00
huang	f339fb1987	fix: 资产钱包自动创建机制 — 修复C端购买时钱包不存在报错 ... - client_order: 新增 getOrCreateWallet 兜底，钱包不存在时自动创建 - device_import: 设备导入事务内同步创建设备钱包 - iot_card_import: IoT卡批量导入后批量创建卡钱包 - queue/handler: 传递 AssetWalletStore 给两个导入 handler - migration 000098: 为存量IoT卡和设备补建资产钱包	2026-03-30 11:37:41 +08:00
huang	cebcada950	refactor: 流量系统重构 — 增量累加算法 + 日粒度缓冲 + 旧详单清理 ... 核心改造： - 增量算法：流量计算从覆盖式改为增量累加（gateway - lastReading），支持上游运营商重置检测 - 日流量缓冲：insertDataUsageRecord 改为 Redis INCRBYFLOAT，每日凌晨落盘到 tb_card_daily_usage - 运营商：新增 data_reset_day 字段（联通=27，其余=1） - IoT卡：新增 last_gateway_reading_mb 字段存储上次网关读数 - 查询层：新建 TrafficQueryService 合并 Redis（今日）+ DB（历史）数据源 - 清理：删除 DataUsageRecord model/store，移除 polling_handler 旧引用 迁移：000094-000097（carrier字段、iot_card字段、数据初始化、日流量表）	2026-03-30 09:59:30 +08:00
huang	02b10f87cf	feat: 新增退款管理模块 — 完整的退款审批流程、佣金回扣和资产重置 ... 新增退款申请全生命周期管理：创建/列表/详情/审批通过/拒绝/退回/重新提交 审批通过后异步执行佣金全额回扣（扣减各代理佣金钱包）和资产重置（套餐失效+停机+世代重置） 新增 tb_refund_request 表（迁移 000093）、RefundRequest Model、8 个 DTO 新增 Store/Service/Handler/路由注册，仅平台用户可访问	2026-03-28 17:57:52 +08:00
huang	15dbf8dc66	feat(03-02): Asset Service 接入 Gateway sync-info（DEVICE-04） ... - Service 结构体新增 gatewayClient 字段，New() 追加 gatewayClient 参数 - Refresh device 分支在绑定卡刷新后调用 SyncDeviceInfo，nil guard + Warn 日志不阻断主流程 - 新增 updateDeviceFromSyncInfo 私有函数：更新 5 个 device 字段 + 调用 UpdateIsCurrentByDeviceID - bootstrap/services.go asset.New() 调用追加 deps.GatewayClient - go build ./... 零新增编译错误	2026-03-28 11:38:14 +08:00
huang	42b884aaf8	feat(03-01): DB 迁移扩展设备字段 + 更新模型 ... - 新增迁移 000090：tb_device 扩展 5 个 Gateway sync-info 字段（online_status / last_online_time / software_version / switch_mode / last_gateway_sync_at） - 新增迁移 000091：tb_device_sim_binding 新增 is_current 字段（当前使用卡标识） - 更新 Device 模型新增对应 5 个字段 - 更新 DeviceSimBinding 模型新增 IsCurrent 字段	2026-03-28 11:31:16 +08:00
huang	344850fe1d	fix(realname): DB 迁移 + Model + Store 清理 REALNAME-01 ... - 新增迁移 000089: 移除 enable_realname_activation，添加 expiry_base 字段 - package.go: 删除 EnableRealnameActivation 字段，新增 ExpiryBase 字段 - package_store.go: 移除两步写入特殊处理，改为直接一步 Create	2026-03-28 10:36:31 +08:00
huang	4d1e714366	fix: 补齐迁移 000076 遗漏的列名重命名（card_wallet_id → asset_wallet_id） ... 迁移 000076 只将表名从 card_wallet 改为 asset_wallet，但遗漏了表内 card_wallet_id 列的重命名，导致 Model 中 column:asset_wallet_id 与数据库 实际列名不匹配，所有涉及该字段的 INSERT/SELECT 均报错 2002。 影响范围： - tb_asset_recharge_record.card_wallet_id → asset_wallet_id - tb_asset_wallet_transaction.card_wallet_id → asset_wallet_id	2026-03-21 14:30:29 +08:00
huang	7dfcf41b41	fix: 修复卡类型资产绑定键错误导致归属校验永远失败 ... resolveAssetBindingKey 对卡类型错误地返回 card.ICCID 作为绑定键， 但归属校验 isCustomerOwnAsset 使用 card.VirtualNo 比对，二者不一致 导致所有卡资产的 C 端接口返回 403 无权限。 修复：卡类型绑定键改为 card.VirtualNo，与设计文档一致。 附带数据迁移修正已有的错误绑定记录。	2026-03-21 11:33:57 +08:00
huang	9bd55a1695	feat: 实现客户端核心业务接口（client-core-business-api） ... 新增客户端资产、钱包、订单、实名、设备管理等核心业务 Handler 与 DTO： - 客户端资产信息查询、套餐列表、套餐历史、资产刷新 - 客户端钱包详情、流水、充值校验、充值订单、充值记录 - 客户端订单创建、列表、详情 - 客户端实名认证链接获取 - 客户端设备卡列表、重启、恢复出厂、WiFi配置、切卡 - 客户端订单服务（含微信/支付宝支付流程） - 强充自动代购异步任务处理 - 数据库迁移 000084：充值记录增加自动代购状态字段	2026-03-19 13:28:04 +08:00
huang	e78f5794b9	feat: 实现客户端换货系统（client-exchange-system） ... 新增完整换货生命周期管理：后台发起 → 客户端填收货信息 → 后台发货 → 确认完成（含可选全量迁移） → 旧资产转新再销售 后台接口（7个）： - POST /api/admin/exchanges（发起换货） - GET /api/admin/exchanges（换货列表） - GET /api/admin/exchanges/:id（换货详情） - POST /api/admin/exchanges/:id/ship（发货） - POST /api/admin/exchanges/:id/complete（确认完成+可选迁移） - POST /api/admin/exchanges/:id/cancel（取消） - POST /api/admin/exchanges/:id/renew（旧资产转新） 客户端接口（2个）： - GET /api/c/v1/exchange/pending（查询换货通知） - POST /api/c/v1/exchange/:id/shipping-info（填写收货信息） 核心能力： - ExchangeOrder 模型与状态机（1待填写→2待发货→3已发货→4已完成，1/2可取消→5） - 全量迁移事务（11张表：钱包、套餐、标签、客户绑定等） - 旧资产转新（generation+1、状态重置、新钱包、历史隔离） - 旧 CardReplacementRecord 表改名为 legacy，is_replaced 过滤改为查新表 - 数据库迁移：000085 新建 tb_exchange_order，000086 旧表改名	2026-03-19 13:26:54 +08:00
huang	df76e33105	feat: 实现 C 端完整认证系统（client-auth-system） ... 实现面向个人客户的 7 个认证接口（A1-A7），覆盖资产验证、 微信公众号/小程序登录、手机号绑定/换绑、退出登录完整流程。 主要变更： - 新增 PersonalCustomerOpenID 模型，支持多 AppID 多 OpenID 管理 - 实现有状态 JWT（JWT + Redis 双重校验），支持服务端主动失效 - 扩展微信 SDK：小程序 Code2Session + 3 个 DB 动态工厂函数 - 实现 A1 资产验证 IP 限流（30/min）和 A4 三层验证码限流 - 新增 7 个错误码（1180-1186）和 6 个 Redis Key 函数 - 注册 /api/c/v1/auth/* 下 7 个端点并更新 OpenAPI 文档 - 数据库迁移 000083：新建 tb_personal_customer_openid 表	2026-03-19 11:33:41 +08:00
huang	ec86dbf463	feat: 客户端接口数据模型基础准备 ... - 新增资产状态、订单来源、操作人类型、实名链接类型常量 - 8个模型新增字段（asset_status/generation/source/retail_price等） - 数据库迁移000082：7张表15+字段，含存量retail_price回填 - BUG-1修复：代理零售价渠道隔离，cost_price分配锁定 - BUG-2修复：一次性佣金仅客户端订单触发 - BUG-4修复：充值回调Store操作纳入事务 - 新增资产手动停用接口（PATCH /iot-cards/:id/deactivate、/devices/:id/deactivate） - Carrier管理新增实名链接配置 - 后台订单generation写时快照 - BatchUpdatePricing支持retail_price调价目标 - 清理全部H5旧接口和个人客户旧登录方法	2026-03-19 10:56:50 +08:00
huang	aa41a5ed5e	feat: 新增支付配置管理相关数据库迁移（000078-000081） ... - 000078: 创建 tb_wechat_config 表（支持微信直连和富友双渠道，含软删除） - 000079: tb_order 新增 payment_config_id 字段（nullable，记录下单时使用的配置） - 000080: tb_asset_recharge_record 新增 payment_config_id 字段 - 000081: tb_agent_recharge_record 新增 payment_config_id 字段 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-16 23:28:57 +08:00
huang	4156bfc9dd	feat: 新增 asset_wallet 和 reference_no 数据库迁移 ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-16 15:42:52 +08:00
huang	b9c3875c08	feat: 新增数据库迁移，重命名 device_no 为 virtual_no，新增 iot_card.virtual_no 和 package.virtual_ratio 字段 ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-14 18:27:28 +08:00
huang	b5147d1acb	设备的部分改造	2026-03-10 10:34:08 +08:00
huang	b52744b149	feat: 新增数据库迁移，重构套餐系列分配佣金和强充字段 ... 迁移编号 000071，在 tb_shop_series_allocation 中新增梯度佣金字段（commission_tiers_json）、代理自设强充字段（enable_force_recharge、force_recharge_amount），删除与 PackageSeries 语义重复的三个冗余字段（enable_one_time_commission、one_time_commission_trigger、one_time_commission_threshold）。 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-03-04 11:34:55 +08:00
huang	61155952a7	feat: 新增代理分配套餐上架状态（shelf_status）功能 ... - 新增数据库迁移：为 shop_package_allocation 表添加 shelf_status 字段 - 更新模型/DTO：ShopPackageAllocation 增加 ShelfStatus 字段及相关枚举 - 更新套餐分配 Service：支持上架/下架状态管理逻辑 - 更新套餐 Store/Service：根据 shelf_status 过滤可售套餐 - 更新购买验证 Service：引入上架状态校验逻辑 - 归档 OpenSpec 变更：2026-03-02-agent-allocation-shelf-status - 同步更新主规范文档：allocation-shelf-status、package-management、purchase-validation Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-03-02 15:38:54 +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	8ed3d9da93	feat: 实现代理钱包订单创建和订单角色追踪功能 ... 新增功能： - 代理在后台使用 wallet 支付时，订单直接完成（扣款 + 激活套餐） - 支持代理自购和代理代购场景 - 新增订单角色追踪字段（operator_id、operator_type、actual_paid_amount、purchase_role） - 订单查询支持 OR 逻辑（buyer_id 或 operator_id） - 钱包流水记录交易子类型和关联店铺 - 佣金逻辑调整：代理代购不产生佣金 数据库变更： - 订单表新增 4 个字段和 2 个索引 - 钱包流水表新增 2 个字段 - 包含迁移脚本和回滚脚本 文档： - 功能总结文档 - 部署指南 - OpenAPI 文档更新 - Specs 同步（新增 agent-order-role-tracking capability） Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-28 14:11:42 +08:00
huang	c5bf85c8de	refactor: 移除 IoT 卡未使用的价格字段 ... - 移除 IotCard 模型的 cost_price 和 distribute_price 字段 - 移除 StandaloneIotCardResponse DTO 中对应的字段 - 添加数据库迁移文件 000066_remove_iot_card_price_fields - 更新 opencode.json 配置 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>	2026-02-27 15:38:33 +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	f32d32cd36	perf: IoT 卡 30M 行分页查询优化（P95 17.9s → <500ms） ... - 新增 is_standalone 物化列 + 触发器自动维护（迁移 056） - 并行查询拆分：多店铺 IN 查询拆为 per-shop goroutine 并行 Index Scan - 两阶段延迟 Join：深度分页（page≥50）走覆盖索引 Index Only Scan 取 ID 再回表 - COUNT 缓存：per-shop 并行 COUNT + Redis 30 分钟 TTL - 索引优化：删除有害全局索引、新增 partial composite indexes（迁移 057/058） - ICCID 模糊搜索路径隔离：trigram GIN 索引走独立查询路径 - 慢查询阈值从 100ms 调整为 500ms - 新增 30M 测试数据种子脚本和 benchmark 工具	2026-02-24 16:23:02 +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
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
huang	b18ecfeb55	refactor: 一次性佣金配置从套餐级别提升到系列级别 ... 主要变更: - 新增 tb_shop_series_allocation 表，存储系列级别的一次性佣金配置 - ShopPackageAllocation 移除 one_time_commission_amount 字段 - PackageSeries 新增 enable_one_time_commission 字段控制是否启用一次性佣金 - 新增 /api/admin/shop-series-allocations CRUD 接口 - 佣金计算逻辑改为从 ShopSeriesAllocation 获取一次性佣金金额 - 删除废弃的 ShopSeriesOneTimeCommissionTier 模型 - OpenAPI Tag '系列分配' 和 '单套餐分配' 合并为 '套餐分配' 迁移脚本: - 000042: 重构佣金套餐模型 - 000043: 简化佣金分配 - 000044: 一次性佣金分配重构 - 000045: PackageSeries 添加 enable_one_time_commission 字段 测试: - 新增验收测试 (shop_series_allocation, commission_calculation) - 新增流程测试 (one_time_commission_chain) - 删除过时的单元测试（已被验收测试覆盖）	2026-02-04 14:28:44 +08:00
huang	fba8e9e76b	refactor(account): 移除卡类型字段、优化账号列表查询和权限检查 ... - 移除 IoT 卡和号卡的 card_type 字段（数据库迁移） - 优化账号列表查询，支持按店铺和企业筛选 - 账号响应增加店铺名称和企业名称字段 - 实现批量加载店铺和企业名称，避免 N+1 查询 - 更新权限检查中间件，完善权限验证逻辑 - 更新相关测试用例，确保功能正确性	2026-02-03 10:59:44 +08:00
huang	5a90caa619	feat(shop-role): 实现店铺角色继承功能和权限检查优化 ... - 新增店铺角色管理 API 和数据模型 - 实现角色继承和权限检查逻辑 - 添加流程测试框架和集成测试 - 更新权限服务和账号管理逻辑 - 添加数据库迁移脚本 - 归档 OpenSpec 变更文档 Ultraworked with Sisyphus	2026-02-03 10:06:13 +08:00
huang	80f560df33	refactor(account): 统一账号管理API、完善权限检查和操作审计 ... - 合并 customer_account 和 shop_account 路由到统一的 account 接口 - 新增统一认证接口 (auth handler) - 实现越权防护中间件和权限检查工具函数 - 新增操作审计日志模型和服务 - 更新数据库迁移 (版本 39: account_operation_log 表) - 补充集成测试覆盖权限检查和审计日志场景	2026-02-02 17:23:20 +08:00
huang	37f43d2e2d	重构: 将卡/设备的套餐系列绑定从分配ID改为系列ID ... - 数据库: 重命名 series_allocation_id → series_id - Model: IotCard 和 Device 字段重命名 - DTO: 所有请求/响应字段统一为 series_id - Store: 方法重命名，新增 GetByShopAndSeries 查询 - Service: 业务逻辑优化，系列验证和权限验证分离 - 测试: 更新所有测试用例，新增 shop_series_allocation_store_test.go - 文档: 更新 API 文档说明参数变更 BREAKING CHANGE: API 参数从 series_allocation_id 改为 series_id	2026-02-02 12:09:53 +08:00
huang	d81bd242a4	fix(force-recharge): 补充强充配置缺失的接口和数据库字段 ... - 订单管理：增加 payment_method 字段支持，合并代购订单逻辑 - 套餐系列分配：增加强充配置字段（enable_force_recharge、force_recharge_amount、force_recharge_trigger_type） - 数据库迁移：添加 force_recharge_trigger_type 字段 - 测试：更新订单服务测试用例 - OpenSpec：归档 fix-force-recharge-missing-interfaces 变更	2026-01-31 15:34:32 +08:00
huang	f6a0f0f39c	feat(migration): 添加代购和强充配置字段迁移	2026-01-31 11:31:42 +08:00
huang	1cf17e8f14	清理冗余的梯度返佣(TierCommission)配置 ... - 移除 Model 层：删除 ShopSeriesCommissionTier 模型及相关字段 - 更新 DTO：删除 TierCommissionConfig、TierEntry 类型及相关请求/响应字段 - 删除 Store 层：移除 ShopSeriesCommissionTierStore 及相关查询逻辑 - 简化 Service 层：删除梯度返佣处理逻辑，统计查询移除 tier_bonus 字段 - 数据库迁移：创建 000034_remove_tier_commission 移除相关表和字段 - 更新测试：移除梯度返佣相关测试用例，更新集成测试 - OpenAPI 文档：删除梯度返佣相关 schema 和枚举值 - 归档变更：归档 remove-tier-commission-redundancy 到 archive/2026-01-30- - 同步规范：更新 4 个主 specs，标记废弃功能并添加迁移指引 原因：梯度返佣功能与一次性梯度佣金功能重复，且从未实现实际计算逻辑 迁移：使用一次性佣金的梯度模式 (OneTimeCommissionConfig.type = "tiered") 替代	2026-01-30 14:57:24 +08:00
huang	1290160728	fix: 修复订单支付幂等性问题,防止重复激活套餐 ... - 使用条件更新实现支付状态原子转换（pending -> paid） - 重复请求返回幂等成功,不再重复激活套餐 - 新增 tb_package_usage 唯一索引（order_id, package_id） - 新增幂等性和异常状态测试,测试覆盖率 71.7% - 归档 OpenSpec 变更 fix-order-activation-idempotency	2026-01-29 16:33:53 +08:00
huang	b02175271a	feat: 实现企业设备授权功能并归档 OpenSpec 变更 ... - 新增企业设备授权模块（Model、DTO、Service、Handler、Store） - 实现设备授权的创建、查询、更新、删除等完整业务逻辑 - 添加企业卡授权与设备授权的关联关系 - 新增 2 个数据库迁移脚本 - 同步 OpenSpec delta specs 到 main specs - 归档 add-enterprise-device-authorization 变更 - 更新 API 文档和路由配置 - 新增完整的集成测试和单元测试覆盖	2026-01-29 13:18:49 +08:00
huang	e87513541b	feat: 实现一次性佣金功能 ... - 新增佣金计算服务，支持一次性佣金和返佣计算 - 新增 ShopSeriesOneTimeCommissionTier 模型和存储层 - 新增两个数据库迁移：一次性佣金表和订单佣金字段 - 更新 Commission 模型，新增佣金来源和关联字段 - 更新 CommissionRecord 存储层，支持一次性佣金查询 - 更新 MyCommission 服务，集成一次性佣金计算逻辑 - 更新 ShopCommission 服务，支持一次性佣金统计 - 新增佣金计算异步任务处理器 - 更新 API 路由，新增一次性佣金相关端点 - 归档 OpenSpec 变更文档，同步规范到主规范库	2026-01-29 09:36:12 +08:00