snss-types 1.0.0 → 1.0.1

package/dist-types/index.d.ts

@@ -0,0 +1,678 @@
+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?: ManifestData;
+    constellations_json?: ConstellationsData;
+    satellites_json?: SatellitesData;
+    nodes_json?: NodesData;
+    links_json?: LinksData;
+    tasks_json?: TasksData;
+    flows_json?: FlowsData;
+    timeline_json?: TimelineData;
+    metrics_json?: MetricsData;
+    evaluation_json?: EvaluationData;
+}
+/**
+ * 场景节点（单个架构版本）
+ */
+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 ManifestTime {
+    epoch_utc: string;
+    start_time_s: number;
+    end_time_s: number;
+    time_step_ms: number;
+    frame_count: number;
+}
+/**
+ * 场景清单文件
+ */
+interface ManifestData {
+    scene_id: string;
+    scene_name: string;
+    description: string;
+    time: ManifestTime;
+}
+/**
+ * 星座类型
+ */
+type ConstellationType = 'GEO' | 'MEO' | 'LEO';
+/**
+ * 星座配置
+ */
+interface Constellation {
+    constellation_id: string;
+    constellation_name: string;
+    layer: ConstellationType;
+    satellite_count: number;
+}
+/**
+ * 星座列表
+ */
+interface ConstellationsData {
+    constellations: Constellation[];
+}
+/**
+ * 卫星TLE数据
+ */
+interface SatelliteTLE {
+    line1: string;
+    line2: string;
+}
+/**
+ * 卫星配置
+ */
+interface Satellite {
+    satellite_id: string;
+    satellite_name: string;
+    constellation_id: string;
+    layer: ConstellationType;
+    satellite_type: TaskType;
+    orbit_plane: number;
+    orbit_index: number;
+    tle: SatelliteTLE;
+}
+/**
+ * 卫星列表
+ */
+interface SatellitesData {
+    satellites: Satellite[];
+}
+/**
+ * 容量配置
+ */
+interface Capacity {
+    max_access_capacity_mbps: number;
+}
+/**
+ * 显示配置
+ */
+interface DisplayOptions {
+    show_trajectory?: boolean;
+}
+/**
+ * 节点类型
+ */
+type NodeType = 'gateway' | 'user_terminal' | 'control_center' | 'other';
+/**
+ * 终端类型（仅在 node_type = 'user_terminal' 时使用）
+ */
+type TerminalType = 'fixed' | 'mobile' | 'airborne' | 'maritime';
+/**
+ * 移动模型类型
+ */
+type MobilityModel = 'static' | 'waypoint';
+/**
+ * 网关节点
+ */
+interface GatewayNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'gateway';
+    region: string;
+    geo_position: GeoPosition;
+    capacity: Capacity;
+}
+/**
+ * 固定用户终端
+ */
+interface StaticUserTerminal {
+    node_id: string;
+    node_name: string;
+    node_type: 'user_terminal';
+    terminal_type: 'fixed';
+    mobility_model: 'static';
+    geo_position: GeoPosition;
+    display_options?: DisplayOptions;
+}
+/**
+ * 移动用户终端
+ */
+interface MobileUserTerminal {
+    node_id: string;
+    node_name: string;
+    node_type: 'user_terminal';
+    terminal_type: 'mobile';
+    mobility_model: 'waypoint';
+    geo_position: GeoPosition;
+    display_options?: DisplayOptions;
+}
+/**
+ * 其他类型用户终端
+ */
+interface OtherUserTerminal {
+    node_id: string;
+    node_name: string;
+    node_type: 'user_terminal';
+    terminal_type: Exclude<TerminalType, 'fixed' | 'mobile'>;
+    mobility_model: MobilityModel;
+    geo_position: GeoPosition;
+    display_options?: DisplayOptions;
+}
+/**
+ * 控制中心节点
+ */
+interface ControlCenterNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'control_center';
+    geo_position: GeoPosition;
+}
+/**
+ * 其他类型节点
+ */
+interface OtherNode {
+    node_id: string;
+    node_name: string;
+    node_type: 'other';
+    geo_position: GeoPosition;
+}
+/**
+ * 节点联合类型
+ */
+type Node = GatewayNode | StaticUserTerminal | MobileUserTerminal | OtherUserTerminal | ControlCenterNode | OtherNode;
+/**
+ * 节点列表
+ */
+interface NodesData {
+    nodes: Node[];
+}
+/**
+ * 链路类型
+ */
+type LinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL';
+/**
+ * 节点类型
+ */
+type LinkNodeType = 'satellite' | 'gateway';
+/**
+ * 链路实例
+ */
+interface Link {
+    link_id: string;
+    node_a_id: string;
+    node_a_type: LinkNodeType;
+    node_b_id: string;
+    node_b_type: LinkNodeType;
+    link_type: LinkType;
+    capacity_mbps: number;
+    node_a_constellation_id?: string;
+    node_b_constellation_id?: string;
+}
+/**
+ * 批量链路配置规则
+ */
+interface BulkConfigRule {
+    constellation_id: string;
+    link_type: LinkType;
+    capacity_mbps: number;
+}
+/**
+ * 链路列表
+ */
+interface LinksData {
+    links: Link[];
+    bulk_config_rules: BulkConfigRule[];
+}
+/**
+ * 任务类型
+ */
+type TaskType = 'emergency_communication';
+/**
+ * 任务优先级
+ */
+type TaskPriority = 'high';
+/**
+ * 任务
+ */
+interface Task {
+    task_id: string;
+    task_name: string;
+    task_type: TaskType;
+    priority: TaskPriority;
+    flow_ids: string[];
+    start_time_s: number;
+    end_time_s: number;
+}
+/**
+ * 任务列表
+ */
+interface TasksData {
+    tasks: Task[];
+}
+/**
+ * 业务类型
+ */
+type ServiceType = 'voice' | 'image_return';
+/**
+ * 业务优先级
+ */
+type FlowPriority = 'high';
+/**
+ * 业务流
+ */
+interface Flow {
+    flow_id: string;
+    flow_name: string;
+    task_id: string;
+    service_type: ServiceType;
+    priority: FlowPriority;
+    src_node_id: string;
+    dst_node_id: string;
+    start_time_s: number;
+    end_time_s: number;
+}
+/**
+ * 业务流列表
+ */
+interface FlowsData {
+    flows: Flow[];
+}
+/**
+ * 地理位置
+ */
+interface GeoPosition {
+    lon_deg: number;
+    lat_deg: number;
+    alt_km: number;
+}
+/**
+ * 地理位置
+ */
+interface GeoPosition {
+    lon_deg: number;
+    lat_deg: number;
+    alt_km: number;
+}
+/**
+ * 速度向量
+ */
+interface VelocityWGS {
+    vx: number;
+    vy: number;
+    vz: number;
+    unit: string;
+}
+/**
+ * 用户状态
+ */
+interface UserState {
+    node_id: string;
+    geo_position: GeoPosition;
+    velocity_wgs: VelocityWGS;
+}
+/**
+ * 链路状态
+ */
+interface LinkState {
+    link_id: string;
+    status: string;
+    utilization_ratio: number;
+    congestion_level: number;
+}
+/**
+ * 业务流状态
+ */
+interface FlowState {
+    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 TaskState {
+    task_id: string;
+    status: string;
+    active_flow_ids: string[];
+}
+/**
+ * 时间轴单帧数据
+ */
+interface TimelineFrame {
+    frame_no: number;
+    timestamp_s: number;
+    user_states: UserState[];
+    links: LinkState[];
+    flows: FlowState[];
+    tasks: TaskState[];
+}
+/**
+ * 时间轴数据
+ */
+interface TimelineData {
+    timelines: TimelineFrame[];
+}
+/**
+ * 概要统计
+ */
+interface MetricsSummary {
+    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 TimeseriesPoint {
+    timestamp_s: number;
+    active_flow_count: number;
+    network_throughput_mbps: number;
+    avg_delay_ms: number;
+    avg_loss_rate: number;
+    congested_link_count: number;
+}
+/**
+ * 图表配置
+ */
+interface ChartConfig {
+    chart_id: string;
+    chart_name: string;
+    chart_type: string;
+    x_field: string;
+    y_fields: string[];
+    unit: string;
+}
+/**
+ * 图表资源
+ */
+interface FigureAsset {
+    figure_id: string;
+    figure_name: string;
+    figure_type: string;
+    file_path: string;
+    description: string;
+}
+/**
+ * 指标数据
+ */
+interface MetricsData {
+    summary: MetricsSummary;
+    timeseries: TimeseriesPoint[];
+    charts: ChartConfig[];
+    figure_assets: FigureAsset[];
+}
+/**
+ * 评估方法类型
+ */
+type EvaluationMethod = 'AHP_ENTROPY';
+/**
+ * 指标方向类型
+ */
+type MetricDirection = 'benefit' | 'cost';
+/**
+ * 评估模型
+ */
+interface EvaluationModel {
+    method: EvaluationMethod;
+}
+/**
+ * 细分指标
+ */
+interface Metric {
+    metric_id: string;
+    metric_name: string;
+    direction: MetricDirection;
+    value: number;
+    normalized_value: number;
+    unit: string;
+}
+/**
+ * 评估维度
+ */
+interface EvaluationDimension {
+    dimension_id: string;
+    dimension_name: string;
+    score: number;
+    ahp_weight: number;
+    entropy_weight: number;
+    combined_weight: number;
+    metrics: Metric[];
+}
+/**
+ * 最终得分
+ */
+interface FinalScore {
+    score: number;
+    score_scale: string;
+}
+/**
+ * 评估图表配置
+ */
+interface EvaluationChart {
+    chart_id: string;
+    chart_name: string;
+    chart_type: string;
+    label_field: string;
+    value_field: string;
+    unit: string;
+}
+/**
+ * 评估图表资源
+ */
+interface EvaluationFigureAsset {
+    figure_id: string;
+    figure_name: string;
+    figure_type: string;
+    file_path: string;
+    description: string;
+}
+/**
+ * 评估结果
+ */
+interface EvaluationData {
+    scene_id: string;
+    scene_name: string;
+    evaluation_model: EvaluationModel;
+    dimensions: EvaluationDimension[];
+    final_score: FinalScore;
+    charts: EvaluationChart[];
+    figure_assets: EvaluationFigureAsset[];
+}
+
+/**
+ * 案例类型
+ */
+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?: EvaluationSummaryData;
+}
+/**
+ * 各维度评分
+ */
+interface DimensionScores {
+    /** 网络容量评分 */
+    network_capacity: number;
+    /** 服务质量评分 */
+    service_quality: number;
+    /** 网络韧性评分 */
+    network_resilience: number;
+    /** 网络复杂度评分 */
+    network_complexity: number;
+    [x: string]: number;
+}
+/**
+ * 场景评估节点
+ */
+interface SceneEvaluation {
+    /** 场景唯一标识 */
+    scene_id: string;
+    /** 场景显示名称 */
+    scene_name: string;
+    /** 综合最终得分 */
+    final_score: number;
+    /** 各维度得分详情 */
+    dimension_scores: DimensionScores;
+}
+/**
+ * 多维度评估结果
+ */
+interface EvaluationSummaryData {
+    /** 案例唯一标识 */
+    case_id: string;
+    /** 评估方法 */
+    evaluation_method: EvaluationMethod;
+    /** 场景评估列表 */
+    scenes: SceneEvaluation[];
+}
+
+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 BulkConfigRule, type Capacity, type CaseItem, type CaseItemMeta, type CaseJsonData, type CaseTreeResponse, type CaseType, type ChartConfig, type Constellation, type ConstellationType, type ConstellationsData, type ControlCenterNode, type DimensionScores, DirPathDto, type DisplayOptions, type EvaluationChart, type EvaluationData, type EvaluationDimension, type EvaluationFigureAsset, type EvaluationMethod, type EvaluationModel, type EvaluationSummaryData, type FigureAsset, type FinalScore, type Flow, type FlowPriority, type FlowState, type FlowsData, type GatewayNode, type GeoPosition, InitCaseCacheDto, type Link, type LinkNodeType, type LinkState, type LinkType, type LinksData, type ManifestData, type ManifestTime, type Metric, type MetricDirection, type MetricsData, type MetricsSummary, type MobileUserTerminal, type MobilityModel, ModelDto, ModelEntity, type ModelResponse, type Node, type NodeType, type NodesData, type OtherNode, type OtherUserTerminal, type Satellite, type SatelliteTLE, type SatellitesData, type SceneEvaluation, type SceneItem, type SceneItemMeta, type SceneItemMetaResponse, type SceneItemSelfInfo, type SceneRole, SendMessageDto, type ServiceType, type StaticUserTerminal, type Task, type TaskPriority, type TaskState, type TaskType, type TasksData, type TerminalType, type TimelineData, type TimelineFrame, type TimeseriesPoint, type UploadFileResponse, type UserState, type VelocityWGS };