7月迭代技术方案总览
讨论日期：2026-07-11
分支：Iteration/7-11
系统：junhong_cmp_fiber（已上线，迭代阶段）
阶段划分
| 阶段 |
范围 |
说明 |
| Phase 1（本迭代） |
需求 1-22（除企微对接） |
Gateway 接口已有，全部可做 |
| Phase 2（下次迭代） |
需求 18（APR-009）/22（EXP-003）的企微对接部分 |
仅依赖企业微信审批/推送 API |
需求总览
简单改动（无新表，影响范围小）
| # |
需求 |
文档 |
实现要点 |
| 1 |
行业卡复机允许未实名 |
需求01 |
ManualStartCard 换用 isRealnameOK() |
| 3 |
店铺列表加联系电话搜索 |
需求03 |
Shop Store 加 contact_phone 过滤 |
| 4 |
退款中资产禁止换货 |
需求04 |
换货前检查活跃退款单 |
| 7 |
IoT卡/设备加实名筛选 |
需求07 |
列表接口加 real_name_status filter |
| 11 |
资产详情-套餐到期时间高亮 |
需求11 |
接口新增字段 + 前端高亮 |
| 12 |
换货管理显示问题修复 |
需求12 |
EXC-001~004，字段显示对齐 |
| 13 |
列表字段新增 |
需求13 |
退款/代理充值/换号管理加提交人审批人 |
中等复杂（有新字段或配置机制）
| # |
需求 |
文档 |
实现要点 |
| 2 |
H5流程顺序配置化 |
需求02 |
依赖系统配置 |
| 5 |
套餐分配生效条件 |
需求05 |
ShopPackageAllocation 加 expiry_base_override |
| 6 |
资产最后到期时间 |
需求06 |
查 PackageUsage 计算 max(expires_at) |
| 8 |
设备批量分配 Excel |
需求08 |
参考现有 Excel 导入体系 |
| 9 |
C端支付方式限制配置化 |
需求09 |
恢复已注释代码 + 系统配置 |
| 10 |
限速规则 |
需求10 |
Gateway SetSpeedLimit 已有，套餐加限速字段 |
| 14 |
导出功能 |
需求14 |
6 个模块导出，复用 ExportTask 体系 |
| 15 |
下架套餐允许续费 |
需求15 |
ShelfStatus 判断 + 续费入口 |
复杂新模块（DDD 结构）
| # |
需求 |
文档 |
实现要点 |
| 16 |
代理分销码与佣金提现 |
需求16 |
二维码注册 + 发展人体系 |
| 17 |
信用额度 |
需求17 |
Shop/角色信用字段 + 负余额支持 |
| 18 |
多人审批 |
需求18 |
依赖审批流 + 站内消息 |
| 19 |
批量订购套餐 |
需求19 |
Excel 导入 + 代理余额扣款 |
| 20 |
退款审批 |
需求20 |
依赖审批流 |
| 21 |
充值审核流程 |
需求21 |
依赖审批流 |
| 22 |
套餐临期提醒 |
需求22 |
定时任务 + 站内消息 |
基础设施文档
| 文档 |
说明 |
被哪些需求依赖 |
| DDD规范 |
领域模型设计规范、目录结构、代码示例 |
复杂新模块全部 |
| 系统配置 |
tb_system_config + 管理接口 |
需求 2、9 |
| 站内消息 |
tb_notification + Asynq 异步分发 |
需求 18、20、21、22 |
| 审批流 |
通用多级审批引擎 |
需求 18、20、21 |
执行顺序建议
