跳到主要内容

EIOTCLUB 接入交接

这份文档说明 EIOTCLUB 在 AOVIS 里的接入边界和当前交接重点。

1. 交接目标​

  • 让 AOVIS 能接入 EIOTCLUB 的 SIM / eSIM 能力
  • 让订单、套餐、卡片、退款、会话状态可以在站内查询
  • 让后续开发知道哪些是确定要做的，哪些只是预留

2. 关键模块​

  • 卡片查询
  • 套餐购买
  • 套餐订购
  • 套餐退款
  • 订单状态查询
  • 卡片会话取消
  • 运营商切换
  • 池子管理

3. 当前建议的实现方式​

  • 先做最小可用封装
  • 统一在一个服务层处理签名、参数和错误码
  • 不要把 EIOTCLUB 调用散落到各个 route 里
  • 不要让页面直接拼接口

4. 交接边界​

  • 站内先负责订单、套餐、卡片的业务状态
  • EIOTCLUB 负责外部卡片和套餐执行
  • 出错时要能回写站内状态，方便人工处理

5. 后续建议​

  • 先把查询和订购链路打通
  • 再补退款、会话和运营商切换
  • 最后再考虑更复杂的批处理和自动同步