snss-types 1.0.3 → 1.0.5

package/dist-types/index.d.ts

@@ -6,6 +6,25 @@ declare class ModelEntity {
     updateTime: Date;
 }
 
+/**
+ * 场景节点（单个架构版本）
+ */
+interface CaseSceneInfo {
+    /** 场景唯一标识 */
+    scene_id: string;
+    /** 场景显示名称 */
+    scene_name: string;
+    /** 文件路径 */
+    file_path?: string;
+    /** 场景角色：基线/迭代/最终 */
+    scene_role: SceneRole;
+    /** 场景描述说明 */
+    description: string;
+    /** 上一个场景ID（可选，基线版本没有） */
+    prev_scene_id?: string;
+    /** 下一个场景ID（可选，最终版本没有） */
+    next_scene_id?: string;
+}
 /**
  * 场景树结构对象类型
  */
@@ -20,7 +39,7 @@ interface SceneItem {
  * 场景元数据详细信息类型
  */
 interface SceneItemMeta {
-    scene_json?: SceneItemSelfInfo;
+    scene_json?: CaseSceneInfo;
     manifest_json?: SceneManifestData;
     constellations_json?: SceneConstellationsData;
     satellites_json?: SceneSatellitesData;
@@ -32,25 +51,6 @@ interface SceneItemMeta {
     metrics_json?: SceneMetricsData;
     evaluation_json?: SceneEvaluationData;
 }
-/**
- * 场景节点（单个架构版本）
- */
-interface SceneItemSelfInfo {
-    /** 场景唯一标识 */
-    scene_id: string;
-    /** 场景显示名称 */
-    scene_name: string;
-    /** 文件路径 */
-    file_path?: string;
-    /** 场景角色：基线/迭代/最终 */
-    scene_role: SceneRole;
-    /** 场景描述说明 */
-    description: string;
-    /** 上一个场景ID（可选，基线版本没有） */
-    prev_scene_id?: string;
-    /** 下一个场景ID（可选，最终版本没有） */
-    next_scene_id?: string;
-}
 /**
  * 场景角色类型
  * - baseline: 基线架构版本
@@ -124,123 +124,78 @@ interface SceneSatellitesData {
     satellites: SceneSatellite[];
 }
 /**
- * 容量配置
- */
-interface SceneCapacity {
-    max_access_capacity_mbps: number;
-}
-/**
- * 显示配置
+ * 节点列表
  */
-interface SceneDisplayOptions {
-    show_trajectory?: boolean;
+interface SceneNodesData {
+    nodes: SceneNode[];
 }
 /**
- * 节点类型
+ * 节点
  */
-type SceneNodeType = 'gateway' | 'user_terminal' | 'control_center' | 'other';
-/**
- * 终端类型（仅在 node_type = 'user_terminal' 时使用）
- */
-type SceneTerminalType = 'fixed' | 'mobile' | 'airborne' | 'maritime';
-/**
- * 移动模型类型
- */
-type SceneMobilityModel = 'static' | 'waypoint';
-/**
- * 网关节点
- */
-interface SceneGatewayNode {
+interface SceneNode {
     node_id: string;
     node_name: string;
-    node_type: 'gateway';
-    region: string;
+    node_type: SceneNodeType;
     geo_position: SceneGeoPosition;
-    capacity: SceneCapacity;
+    /** 仅在 node_type = "geteway" 时使用 */
+    region?: string;
+    /** 仅在 node_type = "geteway" 时使用 */
+    capacity?: SceneNodeGatewayCapacity;
+    /** 仅在 node_type = "user_terminal" 时使用 */
+    terminal_type?: SceneNodeTerminalType;
+    /** 仅在 node_type = "user_terminal" 时使用 */
+    mobility_model?: SceneNodeMobilityModel;
+    /** 仅在 node_type = "user_terminal" 时使用 */
+    display_options?: SceneNodeDisplayOptions;
 }
 /**
- * 固定用户终端
+ * 节点类型
  */
-interface SceneStaticUserTerminal {
-    node_id: string;
-    node_name: string;
-    node_type: 'user_terminal';
-    terminal_type: 'fixed';
-    mobility_model: 'static';
-    geo_position: SceneGeoPosition;
-    display_options?: SceneDisplayOptions;
-}
+type SceneNodeType = 'gateway' | 'user_terminal' | 'control_center' | 'other';
 /**
- * 移动用户终端
+ * 容量配置
  */
-interface SceneMobileUserTerminal {
-    node_id: string;
-    node_name: string;
-    node_type: 'user_terminal';
-    terminal_type: 'mobile';
-    mobility_model: 'waypoint';
-    geo_position: SceneGeoPosition;
-    display_options?: SceneDisplayOptions;
+interface SceneNodeGatewayCapacity {
+    max_access_capacity_mbps: number;
 }
 /**
- * 其他类型用户终端
+ * 终端类型（仅在 node_type = 'user_terminal' 时使用）
+ * 固定、移动、空载、水载
  */
-interface SceneOtherUserTerminal {
-    node_id: string;
-    node_name: string;
-    node_type: 'user_terminal';
-    terminal_type: Exclude<SceneTerminalType, 'fixed' | 'mobile'>;
-    mobility_model: SceneMobilityModel;
-    geo_position: SceneGeoPosition;
-    display_options?: SceneDisplayOptions;
-}
+type SceneNodeTerminalType = 'fixed' | 'mobile' | 'airborne' | 'maritime';
 /**
- * 控制中心节点
+ * 移动模型类型
+ * static ：静态模型，终端位置始终采用 geo_position 中给出的初始经纬高，适用于固定用户终端
+ * waypoint ：路径点模型，瞬时经度、纬度、高度和瞬时速度矢量由动态时间序列
+ * 周期性给出，适用于可移动的用户终端。瞬时速度矢量采用 WGS 坐标系描述，
+ * 单位建议为 km/s 或 m/s
  */
-interface SceneControlCenterNode {
-    node_id: string;
-    node_name: string;
-    node_type: 'control_center';
-    geo_position: SceneGeoPosition;
-}
+type SceneNodeMobilityModel = 'static' | 'waypoint';
 /**
- * 其他类型节点
+ * 显示配置
  */
-interface SceneOtherNode {
-    node_id: string;
-    node_name: string;
-    node_type: 'other';
-    geo_position: SceneGeoPosition;
+interface SceneNodeDisplayOptions {
+    /** show_trajectory 表示是否默认显示该用户终端的运动轨迹。当前版本作为预留字段 */
+    show_trajectory?: boolean;
 }
 /**
- * 节点联合类型
- */
-type SceneNode = SceneGatewayNode | SceneStaticUserTerminal | SceneMobileUserTerminal | SceneOtherUserTerminal | SceneControlCenterNode | SceneOtherNode;
-/**
- * 节点列表
+ * 链路列表
  */
-interface SceneNodesData {
-    nodes: SceneNode[];
+interface SceneLinksData {
+    links: SceneLink[];
+    bulk_config_rules: SceneBulkConfigRule[];
 }
-/**
- * 链路类型
- */
-type SceneLinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL';
-/**
- * 节点类型
- */
-type SceneLinkNodeType = 'satellite' | 'gateway';
 /**
  * 链路实例
  */
 interface SceneLink {
     link_id: string;
+    link_type: SceneLinkType;
     node_a_id: string;
     node_a_type: SceneLinkNodeType;
     node_b_id: string;
     node_b_type: SceneLinkNodeType;
-    link_type: SceneLinkType;
-    capacity_mbps: number;
+    capacity_mbps?: number;
     node_a_constellation_id?: string;
     node_b_constellation_id?: string;
 }
@@ -253,12 +208,13 @@ interface SceneBulkConfigRule {
     capacity_mbps: number;
 }
 /**
- * 链路列表
+ * 链路类型ISL（星间链路） 、 IOL（层间链路） 、 GSL（星地链路） 、 BACKHAUL（馈电链路）
  */
-interface SceneLinksData {
-    links: SceneLink[];
-    bulk_config_rules: SceneBulkConfigRule[];
-}
+type SceneLinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL';
+/**
+ * 节点类型
+ */
+type SceneLinkNodeType = 'satellite' | 'gateway' | 'user_terminal' | 'control_center' | 'other';
 /**
  * 任务类型
  */
@@ -543,7 +499,7 @@ interface CaseJsonData {
     /** 场景顺序列表（按迭代顺序排列的 scene_id 数组） */
     scene_order: string[];
     /** 场景详情列表 */
-    scenes: SceneItemSelfInfo[];
+    scenes: CaseSceneInfo[];
 }
 /**
  * 案例库树结构对象
@@ -690,4 +646,4 @@ interface FigureAssetsImageResponseData {
     fileName: string;
 }
 
-export { type BaseResponse, type CaseEvaluationSummaryJsonData, type CaseItem, type CaseItemMeta, type CaseJsonData, type CaseSceneDimensionScore, type CaseSceneEvaluation, type CaseTreeResponse, type CaseType, DirPathDto, type FigureAssetsImageResponse, type FigureAssetsImageResponseData, InitCaseCacheDto, ModelDto, ModelEntity, type ModelResponse, type SceneBulkConfigRule, type SceneCapacity, type SceneChartConfig, type SceneConstellation, type SceneConstellationType, type SceneConstellationsData, type SceneControlCenterNode, type SceneDisplayOptions, type SceneEvaluationChart, type SceneEvaluationData, type SceneEvaluationDimension, type SceneEvaluationFigureAsset, type SceneEvaluationMethod, type SceneEvaluationModel, type SceneFigureAsset, type SceneFinalScore, type SceneFlow, type SceneFlowPriority, type SceneFlowState, type SceneFlowsData, type SceneGatewayNode, type SceneGeoPosition, type SceneItem, type SceneItemMeta, type SceneItemMetaResponse, type SceneItemSelfInfo, type SceneLink, type SceneLinkNodeType, type SceneLinkState, type SceneLinkType, type SceneLinksData, type SceneManifestData, type SceneManifestTime, type SceneMetric, type SceneMetricDirection, type SceneMetricsData, type SceneMetricsSummary, type SceneMobileUserTerminal, type SceneMobilityModel, type SceneNode, type SceneNodeType, type SceneNodesData, type SceneOtherNode, type SceneOtherUserTerminal, type SceneRole, type SceneSatellite, type SceneSatelliteTLE, type SceneSatelliteType, type SceneSatellitesData, type SceneServiceType, type SceneStaticUserTerminal, type SceneTask, type SceneTaskPriority, type SceneTaskState, type SceneTaskType, type SceneTasksData, type SceneTerminalType, type SceneTimelineData, type SceneTimelineFrame, type SceneTimeseriesPoint, type SceneUserState, type SceneVelocityWGS, SendMessageDto, type UploadFileResponse, type UploadFileResponseData };
+export { type BaseResponse, type CaseEvaluationSummaryJsonData, type CaseItem, type CaseItemMeta, type CaseJsonData, type CaseSceneDimensionScore, type CaseSceneEvaluation, type CaseSceneInfo, type CaseTreeResponse, type CaseType, DirPathDto, type FigureAssetsImageResponse, type FigureAssetsImageResponseData, InitCaseCacheDto, ModelDto, ModelEntity, type ModelResponse, type SceneBulkConfigRule, type SceneChartConfig, type SceneConstellation, type SceneConstellationType, type SceneConstellationsData, type SceneEvaluationChart, type SceneEvaluationData, type SceneEvaluationDimension, type SceneEvaluationFigureAsset, type SceneEvaluationMethod, type SceneEvaluationModel, type SceneFigureAsset, type SceneFinalScore, type SceneFlow, type SceneFlowPriority, type SceneFlowState, type SceneFlowsData, type SceneGeoPosition, type SceneItem, type SceneItemMeta, type SceneItemMetaResponse, type SceneLink, type SceneLinkNodeType, type SceneLinkState, type SceneLinkType, type SceneLinksData, type SceneManifestData, type SceneManifestTime, type SceneMetric, type SceneMetricDirection, type SceneMetricsData, type SceneMetricsSummary, type SceneNode, type SceneNodeDisplayOptions, type SceneNodeGatewayCapacity, type SceneNodeMobilityModel, type SceneNodeTerminalType, type SceneNodeType, type SceneNodesData, type SceneRole, type SceneSatellite, type SceneSatelliteTLE, type SceneSatelliteType, type SceneSatellitesData, type SceneServiceType, type SceneTask, type SceneTaskPriority, type SceneTaskState, type SceneTaskType, type SceneTasksData, type SceneTimelineData, type SceneTimelineFrame, type SceneTimeseriesPoint, type SceneUserState, type SceneVelocityWGS, SendMessageDto, type UploadFileResponse, type UploadFileResponseData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snss-types",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "label": "卫星网络仿真文件解析数据传输服务",
   "description": "基于 Nestjs 的 服务端接口，提供文件数据处理解析传输等服务接口",
   "private": false,