跳轉到

Topic 命名規則

這份命名規則的目標,是讓 topic 名稱能表達 domain、entity、粒度與版本。

建議格式

<domain>.<entity>[.<granularity>].v<version>

範例

市場資料

  • md.instrument.v1
  • md.trade.v1
  • md.quote.v1
  • md.book.v1
  • md.bar.1s.v1
  • md.bar.1m.v1

參考資料

  • ref.corp_action.v1
  • ref.session_calendar.v1

執行資料

  • exec.order_intent.v1
  • exec.order_event.v1
  • exec.fill.v1
  • exec.position_snapshot.v1
  • exec.account_snapshot.v1

策略資料

  • signal.alpha.v1
  • signal.entry_exit.v1

風控與營運

  • risk.limit_breach.v1
  • ops.data_quality_alert.v1

命名原則

  • domain 固定且簡短
  • entity 用公司內部 canonical 名稱
  • 若有時間粒度,再放 granularity
  • schema 變更時用版本號管理,不要直接覆寫舊語意