跳到主要内容

EIOTCLUB / aovis-direct-store Claude 开发任务版

目标​

这份文档是给 Claude / AI 开发工具看的执行版说明，用来加速 EIOTCLUB 相关功能的实现。

统一约定​

  • 以现有站点数据模型为准
  • 不要重做整套架构
  • 优先补强查询、订购、退款、状态同步
  • 所有接口都要考虑签名、错误码和日志脱敏

开发优先级​

1. 卡片查询与状态​

  • 卡片详情
  • 卡片列表
  • 卡片状态
  • 可用余额 / 可用流量

2. 套餐与订购​

  • 可购套餐
  • 下单订购
  • 订购结果
  • 订购状态轮询

3. 流量与会话​

  • 流量刷新
  • 会话取消
  • 套餐到期

4. 退款​

  • 可退金额查询
  • 退款执行
  • 退款状态回写

5. eSIM / 云 eSIM​

  • 云 eSIM 查询
  • 云 eSIM 购买
  • 云 eSIM 订购记录

6. 卡片控制与运营商​

  • 运营商切换
  • 卡片与池子的关系
  • 卡片解绑 / 绑定

7. 通知回调​

  • 订单状态回调
  • 套餐状态回调
  • 流量变化回调

实施建议​

  • 先做一个统一 client
  • 再补 service 层
  • 最后在 route 里接入

给 Claude 的直接任务​

先读取现有 docs/eiotclub-apifox-openapi.json 和项目内 EIOTCLUB 相关文档，按“查询 - 订购 - 退款 - 状态同步”四条链路实现统一封装。不要散落实现，不要破坏现有订单链路。