snss-types 1.0.0 → 1.0.2

package/dist-types/index.d.ts

@@ -0,0 +1,681 @@
+declare class ModelEntity {
+    id: number;
+    name: string;
+    type: string;
+    url: string;
+    updateTime: Date;
+}
+
+/**
+ * 场景树结构对象类型
+ */
+interface SceneItem {
+    label: string;
+    value: string;
+    meta: SceneItemMeta;
+    isLeaf?: boolean;
+    [x: string]: any;
+}
+/**
+ * 场景元数据详细信息类型
+ */
+interface SceneItemMeta {
+    scene_json?: SceneItemSelfInfo;
+    manifest_json?: SceneManifestData;
+    constellations_json?: SceneConstellationsData;
+    satellites_json?: SceneSatellitesData;
+    nodes_json?: SceneNodesData;
+    links_json?: SceneLinksData;
+    tasks_json?: SceneTasksData;
+    flows_json?: SceneFlowsData;
+    timeline_json?: SceneTimelineData;
+    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: 基线架构版本
+ * - iteration: 优化迭代版本
+ * - final: 最终优化版本
+ */
+type SceneRole = 'baseline' | 'iteration' | 'final';
+/**
+ * 时间配置
+ */
+interface SceneManifestTime {
+    epoch_utc: string;
+    start_time_s: number;
+    end_time_s: number;
+    time_step_ms: number;
+    frame_count: number;
+}
+/**
+ * 场景清单文件
+ */
+interface SceneManifestData {
+    scene_id: string;
+    scene_name: string;
+    description: string;
+    time: SceneManifestTime;
+}
+/**
+ * 星座类型
+ */
+type SceneConstellationType = 'GEO' | 'MEO' | 'LEO';
+/**
+ * 星座配置
+ */
+interface SceneConstellation {
+    constellation_id: string;
+    constellation_name: string;
+    layer: SceneConstellationType;
+    satellite_count: number;
+}
+/**
+ * 星座列表
+ */
+interface SceneConstellationsData {
+    constellations: SceneConstellation[];
+}
+/**
+ * 卫星TLE数据
+ */
+interface SceneSatelliteTLE {
+    line1: string;
+    line2: string;
+}
+/**
+ * 卫星配置
+ */
+interface SceneSatellite {
+    satellite_id: string;
+    satellite_name: string;
+    constellation_id: string;
+    layer: SceneConstellationType;
+    satellite_type: SceneTaskType;
+    orbit_plane: number;
+    orbit_index: number;
+    tle: SceneSatelliteTLE;
+}
+/**
+ * 卫星列表
+ */
+interface SceneSatellitesData {
+    satellites: SceneSatellite[];
+}
+/**
+ * 容量配置
+ */
+interface SceneCapacity {
+    max_access_capacity_mbps: number;
+}
+/**
+ * 显示配置
+ */
+interface SceneDisplayOptions {
+    show_trajectory?: boolean;
+}
+/**
+ * 节点类型
+ */
+type SceneNodeType = 'gateway' | 'user_terminal' | 'control_center' | 'other';
+/**
+ * 终端类型（仅在 node_type = 'user_terminal' 时使用）
+ */
+type SceneTerminalType = 'fixed' | 'mobile' | 'airborne' | 'maritime';
+/**
+ * 移动模型类型
+ */
+type SceneMobilityModel = 'static' | 'waypoint';
+/**
+ * 网关节点
+ */
+interface SceneGatewayNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'gateway';
+    region: string;
+    geo_position: SceneGeoPosition;
+    capacity: SceneCapacity;
+}
+/**
+ * 固定用户终端
+ */
+interface SceneStaticUserTerminal {
+    node_id: string;
+    node_name: string;
+    node_type: 'user_terminal';
+    terminal_type: 'fixed';
+    mobility_model: 'static';
+    geo_position: SceneGeoPosition;
+    display_options?: SceneDisplayOptions;
+}
+/**
+ * 移动用户终端
+ */
+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 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;
+}
+/**
+ * 控制中心节点
+ */
+interface SceneControlCenterNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'control_center';
+    geo_position: SceneGeoPosition;
+}
+/**
+ * 其他类型节点
+ */
+interface SceneOtherNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'other';
+    geo_position: SceneGeoPosition;
+}
+/**
+ * 节点联合类型
+ */
+type SceneNode = SceneGatewayNode | SceneStaticUserTerminal | SceneMobileUserTerminal | SceneOtherUserTerminal | SceneControlCenterNode | SceneOtherNode;
+/**
+ * 节点列表
+ */
+interface SceneNodesData {
+    nodes: SceneNode[];
+}
+/**
+ * 链路类型
+ */
+type SceneLinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL';
+/**
+ * 节点类型
+ */
+type SceneLinkNodeType = 'satellite' | 'gateway';
+/**
+ * 链路实例
+ */
+interface SceneLink {
+    link_id: string;
+    node_a_id: string;
+    node_a_type: SceneLinkNodeType;
+    node_b_id: string;
+    node_b_type: SceneLinkNodeType;
+    link_type: SceneLinkType;
+    capacity_mbps: number;
+    node_a_constellation_id?: string;
+    node_b_constellation_id?: string;
+}
+/**
+ * 批量链路配置规则
+ */
+interface SceneBulkConfigRule {
+    constellation_id: string;
+    link_type: SceneLinkType;
+    capacity_mbps: number;
+}
+/**
+ * 链路列表
+ */
+interface SceneLinksData {
+    links: SceneLink[];
+    bulk_config_rules: SceneBulkConfigRule[];
+}
+/**
+ * 任务类型
+ */
+type SceneTaskType = 'emergency_communication';
+/**
+ * 任务优先级
+ */
+type SceneTaskPriority = 'high';
+/**
+ * 任务
+ */
+interface SceneTask {
+    task_id: string;
+    task_name: string;
+    task_type: SceneTaskType;
+    priority: SceneTaskPriority;
+    flow_ids: string[];
+    start_time_s: number;
+    end_time_s: number;
+}
+/**
+ * 任务列表
+ */
+interface SceneTasksData {
+    tasks: SceneTask[];
+}
+/**
+ * 业务类型
+ */
+type SceneServiceType = 'voice' | 'image_return';
+/**
+ * 业务优先级
+ */
+type SceneFlowPriority = 'high';
+/**
+ * 业务流
+ */
+interface SceneFlow {
+    flow_id: string;
+    flow_name: string;
+    task_id: string;
+    service_type: SceneServiceType;
+    priority: SceneFlowPriority;
+    src_node_id: string;
+    dst_node_id: string;
+    start_time_s: number;
+    end_time_s: number;
+}
+/**
+ * 业务流列表
+ */
+interface SceneFlowsData {
+    flows: SceneFlow[];
+}
+/**
+ * 地理位置
+ */
+interface SceneGeoPosition {
+    lon_deg: number;
+    lat_deg: number;
+    alt_km: number;
+}
+/**
+ * 地理位置
+ */
+interface SceneGeoPosition {
+    lon_deg: number;
+    lat_deg: number;
+    alt_km: number;
+}
+/**
+ * 速度向量
+ */
+interface SceneVelocityWGS {
+    vx: number;
+    vy: number;
+    vz: number;
+    unit: string;
+}
+/**
+ * 用户状态
+ */
+interface SceneUserState {
+    node_id: string;
+    geo_position: SceneGeoPosition;
+    velocity_wgs: SceneVelocityWGS;
+}
+/**
+ * 链路状态
+ */
+interface SceneLinkState {
+    link_id: string;
+    status: string;
+    utilization_ratio: number;
+    congestion_level: number;
+}
+/**
+ * 业务流状态
+ */
+interface SceneFlowState {
+    flow_id: string;
+    status: string;
+    throughput_mbps: number;
+    avg_delay_ms: number;
+    loss_rate: number;
+    current_path_node_ids: string[];
+    is_sla_satisfied: boolean;
+}
+/**
+ * 任务状态
+ */
+interface SceneTaskState {
+    task_id: string;
+    status: string;
+    active_flow_ids: string[];
+}
+/**
+ * 时间轴单帧数据
+ */
+interface SceneTimelineFrame {
+    frame_no: number;
+    timestamp_s: number;
+    user_states: SceneUserState[];
+    links: SceneLinkState[];
+    flows: SceneFlowState[];
+    tasks: SceneTaskState[];
+}
+/**
+ * 时间轴数据
+ */
+interface SceneTimelineData {
+    timelines: SceneTimelineFrame[];
+}
+/**
+ * 概要统计
+ */
+interface SceneMetricsSummary {
+    active_flow_total: number;
+    high_priority_flow_total: number;
+    avg_delay_ms: number;
+    avg_loss_rate: number;
+    avg_throughput_mbps: number;
+    congested_link_total: number;
+}
+/**
+ * 时序数据点
+ */
+interface SceneTimeseriesPoint {
+    timestamp_s: number;
+    active_flow_count: number;
+    network_throughput_mbps: number;
+    avg_delay_ms: number;
+    avg_loss_rate: number;
+    congested_link_count: number;
+}
+/**
+ * 图表配置
+ */
+interface SceneChartConfig {
+    chart_id: string;
+    chart_name: string;
+    chart_type: string;
+    x_field: string;
+    y_fields: string[];
+    unit: string;
+}
+/**
+ * 图表资源
+ */
+interface SceneFigureAsset {
+    figure_id: string;
+    figure_name: string;
+    figure_type: string;
+    file_path: string;
+    description: string;
+}
+/**
+ * 指标数据
+ */
+interface SceneMetricsData {
+    summary: SceneMetricsSummary;
+    timeseries: SceneTimeseriesPoint[];
+    charts: SceneChartConfig[];
+    figure_assets: SceneFigureAsset[];
+}
+/**
+ * 评估方法类型
+ */
+type SceneEvaluationMethod = 'AHP_ENTROPY';
+/**
+ * 指标方向类型
+ */
+type SceneMetricDirection = 'benefit' | 'cost';
+/**
+ * 评估模型
+ */
+interface SceneEvaluationModel {
+    method: SceneEvaluationMethod;
+}
+/**
+ * 细分指标
+ */
+interface SceneMetric {
+    metric_id: string;
+    metric_name: string;
+    direction: SceneMetricDirection;
+    value: number;
+    normalized_value: number;
+    unit: string;
+}
+/**
+ * 评估维度
+ */
+interface SceneEvaluationDimension {
+    dimension_id: string;
+    dimension_name: string;
+    score: number;
+    ahp_weight: number;
+    entropy_weight: number;
+    combined_weight: number;
+    metrics: SceneMetric[];
+}
+/**
+ * 最终得分
+ */
+interface SceneFinalScore {
+    score: number;
+    score_scale: string;
+}
+/**
+ * 评估图表配置
+ */
+interface SceneEvaluationChart {
+    chart_id: string;
+    chart_name: string;
+    chart_type: string;
+    label_field: string;
+    value_field: string;
+    unit: string;
+}
+/**
+ * 评估图表资源
+ */
+interface SceneEvaluationFigureAsset {
+    figure_id: string;
+    figure_name: string;
+    figure_type: string;
+    file_path: string;
+    description: string;
+}
+/**
+ * 评估结果
+ */
+interface SceneEvaluationData {
+    scene_id: string;
+    scene_name: string;
+    evaluation_model: SceneEvaluationModel;
+    dimensions: SceneEvaluationDimension[];
+    final_score: SceneFinalScore;
+    charts: SceneEvaluationChart[];
+    figure_assets: SceneEvaluationFigureAsset[];
+}
+
+/**
+ * 案例类型
+ */
+type CaseType = 'architecture_optimization';
+/**
+ * 优化评估案例
+ */
+interface CaseJsonData {
+    /** 案例唯一标识 */
+    case_id: string;
+    /** 案例名称 */
+    case_name: string;
+    /** 案例类型 */
+    case_type: CaseType;
+    /** 案例描述 */
+    description: string;
+    /** 默认展示的场景ID */
+    default_scene_id: string;
+    /** 场景顺序列表（按迭代顺序排列的 scene_id 数组） */
+    scene_order: string[];
+    /** 场景详情列表 */
+    scenes: SceneItemSelfInfo[];
+}
+/**
+ * 案例库树结构对象
+ */
+interface CaseItem {
+    label: string;
+    value: string;
+    meta: CaseItemMeta;
+    children: SceneItem[];
+    isLeaf?: boolean;
+    isOnline?: boolean;
+    [x: string]: any;
+}
+/**
+ * 案例库树结构对象元数据
+ */
+interface CaseItemMeta {
+    case_json?: CaseJsonData;
+    evaluation_summary_json?: CaseEvaluationSummaryJsonData;
+}
+/**
+ * 案例库多维度评估结果
+ */
+interface CaseEvaluationSummaryJsonData {
+    /** 案例唯一标识 */
+    case_id: string;
+    /** 评估方法 */
+    evaluation_method: SceneEvaluationMethod;
+    /** 场景评估列表 */
+    scenes: CaseSceneEvaluation[];
+}
+/**
+ * 案例库场景评估节点
+ */
+interface CaseSceneEvaluation {
+    /** 场景唯一标识 */
+    scene_id: string;
+    /** 场景显示名称 */
+    scene_name: string;
+    /** 综合最终得分 */
+    final_score: number;
+    /** 各维度得分详情 */
+    dimension_scores: CaseSceneDimensionScore;
+}
+/**
+ * 案例库各维度评分
+ */
+interface CaseSceneDimensionScore {
+    /** 网络容量评分 */
+    network_capacity: number;
+    /** 服务质量评分 */
+    service_quality: number;
+    /** 网络韧性评分 */
+    network_resilience: number;
+    /** 网络复杂度评分 */
+    network_complexity: number;
+    [x: string]: number;
+}
+
+declare class DirPathDto {
+    dir: string;
+    isAbsolutePath?: boolean;
+}
+
+declare class InitCaseCacheDto {
+    dirPaths?: Array<DirPathDto>;
+    fileName?: string;
+}
+
+declare class ModelDto {
+    name: string;
+    type: string;
+    url: string;
+}
+
+declare class SendMessageDto {
+    msg: string;
+}
+
+/**
+ * 基础响应结构
+ * 所有 API 响应的通用格式
+ */
+interface BaseResponse {
+    /** 状态码，通常 200 表示成功，其他表示错误 */
+    code: number;
+    /** 响应数据，可选 */
+    data?: any;
+    /** 响应消息或错误描述 */
+    message: string;
+}
+/**
+ * 库树结构响应
+ * 用于返回层级化的树形结构数据（如目录树、模型库树等）
+ */
+interface CaseTreeResponse extends BaseResponse {
+    /** 树形节点数组 */
+    data?: CaseItem[];
+}
+/**
+ * 场景详细信息响应
+ * 通过场景文件夹路径查询并返回场景详细信息
+ */
+interface SceneItemMetaResponse extends BaseResponse {
+    /** 树形节点数组 */
+    data?: SceneItemMeta;
+}
+/**
+ * JSON 文件上传响应
+ * 用于返回上传后的文件详细信息
+ */
+interface UploadFileResponse extends BaseResponse {
+    /** 上传文件的具体信息 */
+    data?: {
+        /** 原始文件名 */
+        originalName: string;
+        /** 文件大小（字节） */
+        size: number;
+        /** 文件 MIME 类型 */
+        mimetype: string;
+        /** 服务器存储路径 */
+        path: string;
+        /** 服务器生成的文件名 */
+        filename: string;
+    };
+}
+/**
+ * 模型响应
+ * 用于返回单个模型、模型列表或空值
+ */
+interface ModelResponse extends BaseResponse {
+    /** 模型实体数据，可能是单个对象、数组或 null */
+    data?: ModelEntity | ModelEntity[] | null;
+}
+
+export { type BaseResponse, type CaseEvaluationSummaryJsonData, type CaseItem, type CaseItemMeta, type CaseJsonData, type CaseSceneDimensionScore, type CaseSceneEvaluation, type CaseTreeResponse, type CaseType, DirPathDto, 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 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 };