snss-types 1.0.6 → 1.0.7

package/dist-types/index.d.ts

@@ -45,11 +45,11 @@ interface SceneItemMeta {
     satellites_json?: SceneSatellitesData;
     nodes_json?: SceneNodesData;
     links_json?: SceneLinksData;
+    metrics_json?: SceneMetricsData;
+    evaluation_json?: SceneEvaluationData;
     tasks_json?: SceneTasksData;
     flows_json?: SceneFlowsData;
     timeline_json?: SceneTimelineData;
-    metrics_json?: SceneMetricsData;
-    evaluation_json?: SceneEvaluationData;
 }
 /**
  * 场景角色类型
@@ -215,6 +215,135 @@ type SceneLinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL';
  * 节点类型
  */
 type SceneLinkNodeType = 'satellite' | 'gateway' | 'user_terminal' | 'control_center' | 'other';
+/**
+ * 概要统计
+ */
+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[];
+}
 /**
  * 任务列表
  */
@@ -347,158 +476,725 @@ interface SceneTaskState {
     active_flow_ids: string[];
 }
 /**
- * 概要统计
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-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 SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 时序数据点
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-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 SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 图表配置
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneChartConfig {
-    chart_id: string;
-    chart_name: string;
-    chart_type: string;
-    x_field: string;
-    y_fields: string[];
-    unit: string;
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 图表资源
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneFigureAsset {
-    figure_id: string;
-    figure_name: string;
-    figure_type: string;
-    file_path: string;
-    description: string;
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 指标数据
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneMetricsData {
-    summary: SceneMetricsSummary;
-    timeseries: SceneTimeseriesPoint[];
-    charts: SceneChartConfig[];
-    figure_assets: SceneFigureAsset[];
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 评估方法类型
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-type SceneEvaluationMethod = 'AHP_ENTROPY';
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
 /**
- * 指标方向类型
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-type SceneMetricDirection = 'benefit' | 'cost';
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
 /**
- * 评估模型
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneEvaluationModel {
-    method: SceneEvaluationMethod;
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 细分指标
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneMetric {
-    metric_id: string;
-    metric_name: string;
-    direction: SceneMetricDirection;
-    value: number;
-    normalized_value: number;
-    unit: string;
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 评估维度
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneEvaluationDimension {
-    dimension_id: string;
-    dimension_name: string;
-    score: number;
-    ahp_weight: number;
-    entropy_weight: number;
-    combined_weight: number;
-    metrics: SceneMetric[];
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 最终得分
+ * 场景任务实体（querySceneTasks 返回的列表项）
  */
-interface SceneFinalScore {
-    score: number;
-    score_scale: string;
+interface SceneTaskEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 任务ID */
+    task_id: string;
+    /** 任务名称 */
+    task_name: string;
+    /** 任务类型 */
+    task_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 关联的业务流ID列表（逗号分隔） */
+    flow_ids: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 评估图表配置
+ * 场景业务流实体（querySceneFlows 返回的列表项）
  */
-interface SceneEvaluationChart {
-    chart_id: string;
-    chart_name: string;
-    chart_type: string;
-    label_field: string;
-    value_field: string;
-    unit: string;
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 评估图表资源
+ * 场景业务流实体（querySceneFlows 返回的列表项）
  */
-interface SceneEvaluationFigureAsset {
-    figure_id: string;
-    figure_name: string;
-    figure_type: string;
-    file_path: string;
-    description: string;
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
 /**
- * 评估结果
+ * 场景业务流实体（querySceneFlows 返回的列表项）
  */
-interface SceneEvaluationData {
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
     scene_id: string;
-    scene_name: string;
-    evaluation_model: SceneEvaluationModel;
-    dimensions: SceneEvaluationDimension[];
-    final_score: SceneFinalScore;
-    charts: SceneEvaluationChart[];
-    figure_assets: SceneEvaluationFigureAsset[];
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
-
 /**
- * 案例类型
+ * 场景业务流实体（querySceneFlows 返回的列表项）
  */
-type CaseType = 'architecture_optimization';
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
 /**
- * 优化评估案例
+ * 场景业务流实体（querySceneFlows 返回的列表项）
  */
-interface CaseJsonData {
-    /** 案例唯一标识 */
+interface SceneFlowEntityData {
+    /** 案例ID */
     case_id: string;
-    /** 案例名称 */
-    case_name: string;
-    /** 案例类型 */
-    case_type: CaseType;
-    /** 案例描述 */
-    description: string;
-    /** 默认展示的场景ID */
-    default_scene_id: string;
-    /** 场景顺序列表（按迭代顺序排列的 scene_id 数组） */
-    scene_order: string[];
-    /** 场景详情列表 */
-    scenes: CaseSceneInfo[];
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
 }
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景业务流实体（querySceneFlows 返回的列表项）
+ */
+interface SceneFlowEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 所属任务ID */
+    task_id: string;
+    /** 业务流ID */
+    flow_id: string;
+    /** 业务流名称 */
+    flow_name: string;
+    /** 业务类型 */
+    service_type: string;
+    /** 优先级 */
+    priority: string;
+    /** 源节点ID */
+    src_node_id: string;
+    /** 目标节点ID */
+    dst_node_id: string;
+    /** 开始时间（秒） */
+    start_time_s: number;
+    /** 结束时间（秒） */
+    end_time_s: number;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+/**
+ * 场景时间轴实体（querySceneTimelines 返回的列表项）
+ */
+interface SceneTimelineEntityData {
+    /** 案例ID */
+    case_id: string;
+    /** 场景ID */
+    scene_id: string;
+    /** 帧号 */
+    frame_no: number;
+    /** 时间戳（秒） */
+    timestamp_s: number;
+    /** JSON 字符串，可解析为 SceneTimelineFrame */
+    json_str: string;
+}
+
+/**
+ * 案例类型
+ */
+type CaseType = 'architecture_optimization';
 /**
  * 案例库树结构对象
  */
@@ -517,6 +1213,28 @@ interface CaseItem {
 interface CaseItemMeta {
     case_json?: CaseJsonData;
     evaluation_summary_json?: CaseEvaluationSummaryJsonData;
+    optimization_trace_json?: OptimizationTraceJsonData;
+}
+/**
+ * 优化评估案例
+ */
+interface CaseJsonData {
+    /** 案例唯一标识 */
+    case_id: string;
+    /** 案例名称 */
+    case_name: string;
+    /** 案例类型 */
+    case_type: CaseType;
+    /** 案例描述 */
+    description: string;
+    /** 默认展示的场景ID */
+    default_scene_id: string;
+    /** 是否为实时模式 */
+    is_realtime_mode: boolean;
+    /** 场景顺序列表（按迭代顺序排列的 scene_id 数组） */
+    scene_order: string[];
+    /** 场景详情列表 */
+    scenes: CaseSceneInfo[];
 }
 /**
  * 案例库多维度评估结果
@@ -556,6 +1274,91 @@ interface CaseSceneDimensionScore {
     network_complexity: number;
     [x: string]: number;
 }
+/**
+ * 网络架构优化搜索过程记录（case 级文件 optimization_trace.json）
+ */
+interface OptimizationTraceJsonData {
+    /** 案例唯一标识 */
+    case_id: string;
+    /** 优化终止目标 */
+    optimization_goal: OptimizationGoal;
+    /** 前端主线展示的场景序列（仅包含初始场景和每轮被选中的最优场景） */
+    main_scene_path: string[];
+    /** 逐轮优化记录 */
+    rounds: OptimizationRound[];
+    /** 最终优化得到的场景编号 */
+    final_selected_scene_id: string;
+    /** 优化停止原因 */
+    stop_reason: string;
+}
+/**
+ * 优化目标
+ */
+interface OptimizationGoal {
+    /** 目标类型，如 "completed_task_count" */
+    goal_type: string;
+    /** 目标任务完成数量 */
+    target_completed_task_count?: number;
+    /** 目标任务完成率 */
+    target_completion_rate?: number;
+}
+/**
+ * 单轮优化记录
+ */
+interface OptimizationRound {
+    /** 优化轮次编号 */
+    round_id: string;
+    /** 优化轮次序号（从 1 开始） */
+    round_index: number;
+    /** 本轮候选方案列表 */
+    candidate_results: OptimizationCandidate[];
+    /** 本轮起点场景 ID */
+    base_scene_id: string;
+    /** 本轮起点场景的评估结果 */
+    base_result: OptimizationEvaluationResult;
+    /** 本轮最终选中的优化方向 */
+    selected_action_direction_id: string;
+    /** 本轮最优方案落成后的主线场景编号 */
+    selected_next_scene_id: string;
+    /** 选择该候选方案的原因 */
+    selection_reason: string;
+    /** 选中该候选方案后是否已满足优化目标 */
+    is_goal_satisfied_after_selection: boolean;
+}
+/**
+ * 候选优化方案
+ */
+interface OptimizationCandidate {
+    /** 候选方案名称 */
+    candidate_scene_name: string;
+    /** 优化方向编号 */
+    action_direction_id: string;
+    /** 优化方向名称 */
+    action_direction_name: string;
+    /** 相对本轮起点场景的主要配置变化摘要 */
+    change_summary: string;
+    /** 该候选方案的评估结果 */
+    evaluation_result: OptimizationEvaluationResult;
+    /** 本轮排名 */
+    rank: number;
+    /** 是否被选为本轮最优方案 */
+    is_selected: boolean;
+}
+/**
+ * 优化轮次中的评估结果（起点场景或候选方案的评估摘要）
+ */
+interface OptimizationEvaluationResult {
+    /** 综合最终得分 */
+    final_score: number;
+    /** 各维度得分详情 */
+    dimension_scores: CaseSceneDimensionScore;
+    /** 完成的任务数量 */
+    completed_task_count: number;
+    /** 任务完成率 */
+    task_completion_rate: number;
+    /** 有效服务容量（Mbps） */
+    effective_service_capacity_mbps: number;
+}
 
 declare class DirPathDto {
     dir: string;
@@ -581,11 +1384,11 @@ declare class SendMessageDto {
  * 基础响应结构
  * 所有 API 响应的通用格式
  */
-interface BaseResponse {
+interface BaseResponse<T = any> {
     /** 状态码，通常 200 表示成功，其他表示错误 */
     code: number;
     /** 响应数据，可选 */
-    data?: any;
+    data?: T;
     /** 响应消息或错误描述 */
     message: string;
 }
@@ -644,4 +1447,4 @@ interface FigureAssetsImageResponseData {
     fileName: string;
 }
 
-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 };
+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 OptimizationCandidate, type OptimizationEvaluationResult, type OptimizationGoal, type OptimizationRound, type OptimizationTraceJsonData, 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 SceneFlowEntityData, 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 SceneTaskEntityData, type SceneTaskPriority, type SceneTaskState, type SceneTaskType, type SceneTasksData, type SceneTimelineData, type SceneTimelineEntityData, type SceneTimelineFrame, type SceneTimeseriesPoint, type SceneUserState, type SceneVelocityWGS, SendMessageDto, type UploadFileResponse, type UploadFileResponseData };