csxj2026/junhong_cmp_fiber

Files

huang 3078bc71c8 docs: add research findings

2026-03-27 19:04:17 +08:00

16 KiB

Raw Blame History

Feature Research

Domain: 物联网卡/号卡/设备全生命周期管理平台（面向代理商 B 端 + C 端个人用户） Researched: 2026-03-27 Confidence: HIGH（主要来源：广梦云/SIMBOSS/Simbest/iotcard 实际竞品研究 + 项目现有功能盘点）

背景：已实现功能（Brownfield 基线）

以下功能已在代码库中落地，本文档不重复列出，仅聚焦缺口分析：

已实现模块	关键能力
IoT 卡生命周期	开卡/激活/停复机/销户
套餐系统	主套餐/加油包/排队/囤货待实名激活/流量扣减
订单系统	5 种购买场景，微信/富友/钱包支付
代理商体系	7 级层级，差价佣金 + 一次性佣金，提现申请流程
RBAC 权限	角色/权限/菜单，基于店铺层级数据过滤
C 端认证	微信 OAuth + 手机号绑定
设备管理	绑卡/解绑/批量 Excel 导入
流量轮询	实名状态/流量/套餐余额，Asynq + Redis Sorted Set
退款流程	tb_refund_request 模型，7 个退款接口（方案 I，已规划）

Feature Landscape

Table Stakes（用户期望有，缺了就感觉产品不完整）

卡/资产管理

Feature	Why Expected	Complexity	当前状态	Notes
卡批量操作（停/复/注销）	运营场景必须，一次管几百张卡不能单张操作	MEDIUM	❌ 缺失	已有单卡接口，缺批量接口；广梦云/SIMBOSS 均有
卡信息批量导出（Excel/CSV）	资产台账、对账、交接必须	LOW	❌ 缺失	已有导入；竞品均有导出；格式含 ICCID/IMEI/状态/套餐/流量
实名状态手动刷新（单卡/批量）	运营商实名状态有延迟，客服需要手动触发同步	LOW	⚠️ 部分	有轮询系统但无手动触发单卡实名刷新接口
卡状态变更历史记录	出现纠纷时需要溯源"什么时候谁停了这张卡"	MEDIUM	❌ 缺失	审计日志只覆盖账号操作，不覆盖卡操作
流量使用日粒度详单	C 端用户最常问"今天用了多少流量"	MEDIUM	⚠️ 规划中	方案 E（流量体系改革）已规划 tb_card_daily_usage

套餐/订单

Feature	Why Expected	Complexity	当前状态	Notes
订单搜索与筛选（多维度）	运营/客服必须能按 ICCID/手机号/订单号/状态/时间段查单	LOW	⚠️ 部分	基础筛选存在，高级组合筛选可能不完整
订单批量导出	财务对账、月度报告	LOW	❌ 缺失	竞品标配；广梦云最近大幅提升导出速度
退款完整流程（申请/审批/退回）	用户错购、套餐未生效退款场景必须有	HIGH	⚠️ 规划中	方案 I 已规划 7 个退款接口，尚未实现
订单超时提醒/催付	代理采购大额预存时需要提醒	LOW	❌ 缺失	已有 30 分钟自动取消，无催付通知

代理/分销

Feature	Why Expected	Complexity	当前状态	Notes
代理商资金流水（充值/消费/佣金/提现完整账单）	代理商需要对自己的每一笔资金进来去出有清晰记录	MEDIUM	⚠️ 部分	有钱包余额，但完整流水账单（按时间倒序，标注来源类型）不确定是否完整
套餐分配记录（谁分配了给谁，什么时候）	分配纠纷溯源必须	LOW	⚠️ 部分	asset_allocation_record 已实现，但可能不全面
下级代理业绩报表	代理商管理下级时必须知道业绩	MEDIUM	❌ 缺失	有佣金统计 commission_stats，但完整业绩报表（订单数/金额/活跃卡数）缺失
代理商余额充值（线上转账充值）	代理预存款是核心资金流入，不能只靠线下	MEDIUM	⚠️ 部分	agent_recharge 存在，但富友支付 JSAPI 接口为留桩（方案 J-1）

C 端体验

Feature	Why Expected	Complexity	当前状态	Notes
C 端查询套餐列表与详情	用户购套餐前必须看清楚买的是什么	LOW	⚠️ 部分	customer_view_service 存在，但套餐展示完整性待确认
套餐到期提醒（微信通知/短信）	用户断网会直接差评，预告到期是行业标配	MEDIUM	❌ 缺失	无主动推送机制；竞品用微信模板消息/公众号推送
充值记录/消费历史	用户自助查账必须	LOW	⚠️ 部分	有钱包，但消费历史接口（按时间倒序列表）待确认
卡/设备转手后钱包自然转移展示	钱包绑卡而非绑人的设计已实现，需 C 端有清晰提示	LOW	✅ 基本实现	设计已对 C 端透出

实名认证（中国市场法规强制）

Feature	Why Expected	Complexity	当前状态	Notes
二要素身份验证（姓名+身份证）	工信部实名制要求，物联网卡/号卡必须实名	MEDIUM	⚠️ 部分	有实名状态轮询，但主动二要素接口验证待确认
三要素身份验证（姓名+身份证+手机号）	号卡开户严格场景	MEDIUM	❌ 可能缺失	广梦云 v2.14.8 专门完善了三要素验证
实名认证状态全链路可见（平台→代理→C端）	合规审计必须	LOW	⚠️ 部分	实名状态字段存在，但链路完整性待确认

Differentiators（竞争差异化功能）

Feature	Value Proposition	Complexity	优先级	Notes
流量池（多卡共享流量）	降低单卡超额风险，SIMBOSS/广梦云核心卖点，运营商原生支持	HIGH	P2	当前每卡独立流量；实现需运营商 API 支持
数据大屏/经营报表（首页工作台）	让代理一眼看清业绩，销售额/活跃卡数/今日新增	MEDIUM	P2	广梦云 v2.7.13 增加工作台；核心商业决策支持
开放 API 平台（供企业客户对接）	企业客户有自有系统，需要 API 接入卡信息/套餐/流量	HIGH	P2	Simbest/SIMBOSS 均有 SDK；广梦云有开放平台
短信通知（套餐到期/流量告警/提现审批）	微信通知依赖公众号关注，短信是兜底保障	MEDIUM	P2	广梦云 v0.1.6 就支持；触达率关键
微信公众号模板消息推送	在微信生态内操作，公众号消息触达率最高	MEDIUM	P2	广梦云/SIMBOSS 标配；需绑定公众号 APPID
流量告警（达量预警/超量告警）	避免客户意外断网，自动预警降低客服工单	MEDIUM	P2	轮询系统框架存在 polling_alert；但告警通知渠道未接通
AI 推广文案生成	代理商自动生成商品推广素材，降低运营门槛	MEDIUM	P3	广梦云 v2.11 增加 AI 推广文案；ToB 差异化
电子签约合同（代理商签约）	合规合同管理，法律保障	HIGH	P3	广梦云 v0.12 增加；降低纠纷风险
LBS 基站定位（卡位置查询）	IoT 场景设备追踪	HIGH	P3	iotcard/SIMBOSS 支持；需运营商 API
卡在线诊断（信号/状态/异常）	客服自助排查工单，减少人工	HIGH	P3	iotcard 有"在线诊断"功能
多支付方式（支付宝 + 微信）	部分用户无微信支付，支付宝是标配	MEDIUM	P2	当前仅微信 + 富友 + 钱包；缺支付宝
代理商独立品牌域名/店铺定制	白标分销，代理商可用自己品牌	HIGH	P3	SIMBOSS/广梦云核心卖点；v2 方向

Anti-Features（看起来好，实际容易踩坑的功能）

Feature	Why Requested	Why Problematic	Alternative
多租户 SaaS 架构（现阶段）	想一套系统卖给多个卡商	当前 MVP 阶段做 SaaS 重构会推迟上线 6-12 个月；数据隔离模型完全不同	单租户先上线验证，v2 规划 SaaS；已在 Out of Scope
设备定期后台轮询	想实时掌握设备在线状态	高频轮询对运营商 API 有调用限额，极易触发封禁；成本高	按需实时拉取（sync-info），已决策
自动化测试覆盖	提升代码质量信心	项目明确不做，IoT 卡状态依赖运营商真实回调，Mock 成本极高	人工验收 + 生产日志监控；已在项目约束中
实时所有卡流量推送	想让用户实时看到流量	WebSocket 长连接并发维护成本极高；百万卡量级时不可行	轮询拉取 + 流量超阈值主动告警即可
全球/国际物联网卡管理	扩展市场	需要对接 Jasper/SIM Alliance 等国际 CMP，运营商 API 完全不同，开发量是现有的 2-3 倍	先做国内三大运营商 + 广电，国际方向单独立项
卡号靓号系统（号卡场景）	号卡分销平台都有	物联网卡无靓号概念；号卡业务涉及选号/归属地/运营商配号，与物联网卡逻辑完全不同	物联网卡和号卡维护分离的套餐/渠道体系

Feature Dependencies

退款完整流程（方案I）
    └──requires──> 订单系统（已完成）
                   └──requires──> 代理佣金计算（已完成）

批量操作（停/复/导出）
    └──requires──> 单卡操作接口（已完成）

套餐到期提醒（微信/短信）
    └──requires──> 微信公众号配置（wechat_config 已实现）
    └──requires──> 短信服务商接入（❌ 未接入）

流量告警通知
    └──requires──> 轮询系统 alert_service（已实现，告警规则存在）
    └──requires──> 通知渠道（短信/微信，❌ 未打通）

数据报表/工作台
    └──enhances──> 代理佣金统计（commission_stats 已实现）
    └──enhances──> 订单系统（已完成）

流量池（共享池）
    └──requires──> 运营商 API 支持流量池管理（独立对接）
    └──conflicts──> 当前每卡独立流量计费模型

开放 API 平台
    └──requires──> 认证体系（已完成）
    └──enhances──> 企业客户管理（已完成）

二/三要素实名验证
    └──enhances──> 实名认证轮询（已完成）
    └──requires──> 第三方实名验证服务商接入（国政通/公安部接口）

Dependency Notes

退款 requires 佣金计算：退款审批通过后需按比例扣减代理佣金钱包，佣金必须已正确落账
告警 requires 通知渠道：alert_service 框架已有，但告警结果只写日志，未接短信/微信推送
流量池 conflicts 当前计费模型：流量池是设备级/卡群组共享，与当前每套餐独立计费逻辑有冲突，需专项设计
二要素验证 requires 第三方接口：国政通/华道数据/阿里实人认证等，需采购接入

MVP Definition

当前阶段：修复上线（v1 Production Ready）

必须完成（对应 PROJECT.md Active 方案 A-J）：

实名常量修复（A-1 ~ A-3）— 主链路断裂，P0
充值回调 + 佣金补全（A-4 ~ A-5）— 资金链路，P0
退款完整流程（方案 I）— 用户期望有，缺了影响信任
订单批量导出 — 财务对账必须
卡批量操作（停/复） — 运营必须
富友支付 JSAPI（J-1）— 支付链路完整性

Add After Validation（v1.x，上线后 1-2 月内）

套餐到期提醒（微信模板消息） — 核心留存功能，上线第一周就会收到投诉
流量告警通知渠道打通（短信/微信） — polling_alert 框架已有，补上通知
代理商业绩报表（工作台首页） — 增加代理黏性
卡状态变更历史 — 减少客服纠纷

Future Consideration（v2+）

流量池（共享池）— 需运营商 API 合作，独立立项
开放 API 平台 — 企业客户集成需求
多租户 SaaS — 卖给其他卡商
LBS 基站定位 — IoT 定位场景
支付宝支付 — 扩大支付覆盖，目前微信+富友已覆盖主流

Feature Prioritization Matrix

缺口功能优先级

Feature	User Value	Implementation Cost	Priority	对应方案
退款流程（申请/审批/退回）	HIGH	HIGH	P1	方案 I
富友支付 JSAPI 实现	HIGH	MEDIUM	P1	方案 J-1
卡批量操作（停/复/导出）	HIGH	LOW	P1	新增
订单批量导出	HIGH	LOW	P1	新增
套餐到期微信推送	HIGH	MEDIUM	P1	新增
流量告警通知渠道	HIGH	MEDIUM	P1	补全 alert_service
代理商资金流水完整账单	MEDIUM	LOW	P2	补全
代理商业绩报表（工作台）	MEDIUM	MEDIUM	P2	新增
卡状态变更历史	MEDIUM	LOW	P2	新增
二要素实名验证接口	MEDIUM	MEDIUM	P2	新增
流量池（共享池）	HIGH	HIGH	P3	v2
开放 API 平台	MEDIUM	HIGH	P3	v2
LBS 定位	LOW	HIGH	P3	v2

Priority key:

P1: 必须有，影响上线质量
P2: 上线后优先补充，影响留存
P3: 竞争差异化，长期方向

Competitor Feature Analysis

Feature	广梦云（竞品）	SIMBOSS（竞品）	Simbest（竞品）	君鸿当前状态
批量停/复/注销	✅ 有	✅ 有	✅ 有	❌ 缺
批量数据导出	✅ 有（高速）	✅ 有	✅ 有	❌ 缺
流量告警 + 通知	✅ 微信公众号告警	✅ 达量告警	✅ 有	⚠️ 框架有，通知未打通
套餐到期通知	✅ 微信模板消息	✅ 公众号推送	✅ 有	❌ 缺
退款流程	✅ 一键退款（卡板/套餐）	✅ 有	✅ 有	⚠️ 规划中（方案 I）
代理资金流水	✅ 完整账单	✅ 有	✅ 有	⚠️ 基础有，完整性待确认
多支付宝支付	✅ 支付宝/微信/当面付	✅ 有	✅ 有	⚠️ 微信+富友，缺支付宝
流量池共享	✅ 共享池 + 月账单	✅ 流量共享	✅ 有	❌ 缺（v2）
开放 API	✅ 开放平台 + SDK	✅ 多语言 SDK	✅ 有	❌ 缺（v2）
业绩报表/工作台	✅ v2.7 增加工作台	✅ 数据助力运营	✅ 营收成本核算	❌ 缺
代理商独立域名	✅ 品牌定制	✅ 个性化域名	✅ 有	❌ 缺（v2/SaaS）
设备 WiFi 远程控制	✅ v2.13 增加	—	—	⚠️ 设备 sync-info 规划中
实名二/三要素验证	✅ 国政通对接	✅ 有	✅ 有	⚠️ 部分

中国市场特殊要求

监管合规

物联网实名制（工信部要求）：所有物联网卡必须实名，平台需支持实名状态追踪和验证
号卡实名（2021 年起更严）：号卡开户必须姓名+身份证+手机号三要素，平台需有三证上传
广电运营商支持：2022 年起广电（第四运营商）加入物联网卡市场，竞品已快速对接
运营商 API 依赖：
- 移动：CT-Boss、PBoss
- 电信：CMP、DCP
- 联通：Jasper、CMP
- 广电：广电直连 API

支付合规

提现需支持灵活用工平台（代理商收入合规开票）
大额打款需支持对公转账或企业支付宝批量打款

Sources

广梦云更新日志（https://docs.facms.cn）— 2019-2026 完整版本历史，揭示了市场真实功能演进路径
SIMBOSS 产品页（https://www.simboss.com）— 核心竞品，国内头部物联网卡平台
Simbest 平台（https://www.simbest.cn）— 专注三网对接的分销管理平台
iotcard IOT CardBOSS（https://www.iotcard.com/platform）— 运营商系统深度融合的企业级方案
项目 PROJECT.md + ARCHITECTURE.md — 已实现功能基线，方案 A-J 规划
置信度评估：
- Table Stakes 功能：HIGH（多个竞品交叉验证）
- Differentiators：MEDIUM（竞品分析 + 市场观察，非用户调研）
- 合规要求：HIGH（工信部政策 + 竞品普遍实现）

Feature research for: 物联网卡/号卡/设备全生命周期管理平台（中国市场） Researched: 2026-03-27

16 KiB Raw Blame History Unescape Escape