refactor(market-ranking): 重命名组件与数据模型

2026-07-23 11:06:33 +08:00
parent 0b90b3fa21
commit e3dc1edb37
7 changed files with 8 additions and 8 deletions
@@ -0,0 +1,86 @@
+// ============ 视图数据类型（合并接口 + 行情后，供 View 消费） ============
+// 保留原始字段，不在数据层预先格式化/预先判断涨跌色；HTTP 占位行允许行情字段暂缺。
+export interface RankItem {
+  code: string;
+  market: string;
+  name: string;
+  price?: number;
+  // 涨跌幅（%数值，如 3.21 表示 +3.21%）。行情推送里固定字段，任何 Tab 下都存在，
+  // 用于「最新价」列的取色，也是 涨幅/跌幅 Tab 第三列的数据来源。
+  price_chg?: number;
+  // 涨速/跌速（%数值）。仅 riseSpeed/fallSpeed Tab 下有值。
+  chg_speed?: number;
+  // 成交额（原始数值，未换算单位）。仅 turnOver Tab 下有值。
+  turnover?: number;
+  // 日增仓（原始数值，未换算单位）。仅 increPosit Tab 下有值。
+  incre_posit?: number;
+}
+
+// 当前市场排名卡片的完整展示数据；网络/行情更新后整体替换以触发 UI 刷新。
+export interface CardData {
+  tableList: RankItem[];
+}
+
+// 4106 行情推送的原始分列数据。Vue 中实际为“字段 ID -> 数组”的字典，
+// ArkTS 使用显式属性描述同一结构，数组中相同下标代表同一份合约行情。
+// 字段 ID：code=4、market=36103、name=55、price=10、price_chg=34818、
+// pre_price=6、open_price=7、pre_settle_price=66、turnover=19、incre_posit=34355、
+// chg_speed_1min=34874、chg_speed_5min=34325、chg_speed_10min=34875、chg_speed_15min=34876。
+export interface MarketRankingQuoteData {
+  code: string[];
+  market: string[];
+  name: string[];
+  price: number[];
+  price_chg: number[];
+  pre_price: number[];
+  open_price: number[];
+  pre_settle_price: number[];
+  turnover: number[];
+  incre_posit: number[];
+  chg_speed_1min: number[];
+  chg_speed_5min: number[];
+  chg_speed_10min: number[];
+  chg_speed_15min: number[];
+}
+
+export interface MarketRankingQuoteRequestParams {
+  protocolId: string;
+  pageId: string;
+  onlineId: string;
+  columnOrder: string;
+  requestDic: string;
+}
+
+export interface TabMetric {
+  id: string;
+  label: ResourceStr;
+  stat: string;      // 埋点用
+  api: string;        // HTTP 接口 quote_type 参数用
+  hqId: string;        // 行情订阅 sortid 用
+  hqName: string;      // 推送字段映射用
+  index: number;
+  hasChildren: boolean; // Vue 用 children 数组本身判断，这里简化为布尔标记
+}
+
+export interface PeriodRange {
+  id: string;
+  label: ResourceStr;
+  stat: string;
+  api: string;
+  hqId: string;
+  index: number;
+}
+
+// ============ 后端接口原始响应类型（recommend_futures） ============
+// 对应 docs/cards/interfaces.md「一、HTTP 接口 - 1. 市场排名列表」
+
+export interface RecommendFuturesItem {
+  contract_code: string;
+  contract_name: string;
+  market: string;
+}
+
+export interface RecommendFuturesResponse {
+  code: number;
+  data: RecommendFuturesItem[];
+}