snss-types 1.0.0

package/README.md

@@ -0,0 +1,227 @@
+<p align="center">
+  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
+</p>
+
+[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
+[circleci-url]: https://circleci.com/gh/nestjs/nest
+
+  <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
+
+# PM2 开机自启持久化配置指南
+
+PM2 支持生成系统启动脚本，实现服务器重启后**自动恢复进程列表**，支持主流 Linux、macOS、Windows 系统，兼容多种初始化系统。
+
+## 一、支持的初始化系统
+
+PM2 可通过 `pm2 startup` 自动检测系统，对应关系如下：
+| 初始化系统 | 适用系统 |
+|------------|----------|
+| systemd | Ubuntu ≥16、CentOS ≥7、Arch、Debian ≥7 |
+| upstart | Ubuntu ≤14 |
+| launchd | macOS（Darwin） |
+| openrc | Gentoo Linux、Arch Linux |
+| rcd | FreeBSD |
+| systemv | CentOS 6、Amazon Linux |
+
+## 二、核心操作命令
+
+### 1. 生成开机自启脚本
+
+直接执行命令，PM2 会提示需要 root 权限：
+
+```bash
+pm2 startup
+```
+
+执行后会输出**带权限的完整命令**，复制粘贴到终端执行（无需手动修改参数）：
+
+```bash
+# 示例输出命令，直接复制执行即可
+sudo su -c "env PATH=$PATH:/home/unitech/.nvm/versions/node/v14.3/bin pm2 startup <distribution> -u <user> --hp <home-path>"
+```
+
+✅ 可选：自定义服务名称
+
+```bash
+pm2 startup --service-name 自定义服务名
+```
+
+### 2. 保存当前应用进程列表
+
+启动所有需要持久化的应用后，执行保存命令，重启后会自动恢复：
+
+```bash
+pm2 save
+```
+
+### 3. 手动恢复进程
+
+如需手动还原已保存的进程列表，执行：
+
+```bash
+pm2 resurrect
+```
+
+### 4. 禁用开机自启
+
+删除 PM2 启动配置，关闭开机自启：
+
+```bash
+pm2 unstartup
+```
+
+## 三、进阶配置
+
+### 1. Node.js 版本升级后更新启动脚本
+
+升级 Node 后，需重新生成 PM2 启动脚本，确保使用最新 Node 二进制文件：
+
+```bash
+# 1. 先禁用旧配置
+pm2 unstartup
+# 2. 重新生成新配置
+pm2 startup
+```
+
+### 2. 指定运行用户
+
+以指定用户执行 PM2 启动脚本（替换用户名和家目录）：
+
+```bash
+pm2 startup ubuntu -u www --hp /home/ubuntu
+```
+
+### 3. 手动指定初始化系统
+
+如需强制指定平台/初始化系统，使用以下命令：
+
+```bash
+pm2 startup [ubuntu|ubuntu14|ubuntu16|ubuntu18|ubuntu20|centos|centos6|arch|macos|systemd|upstart|launchd|openrc|rcd]
+```
+
+## 四、Systemd 系统检查命令（适用于 Ubuntu16+/CentOS7+）
+
+```bash
+# 查看 PM2 服务是否添加成功
+systemctl list-units | grep pm2
+
+# 查看 PM2 服务日志
+journalctl -u pm2-<用户名>
+
+# 查看 systemd 配置文件
+systemctl cat pm2-<用户名>
+
+# 分析系统启动耗时
+systemd-analyze plot > output.svg
+```
+
+### Systemd 优化：等待网络联机后启动 PM2
+
+编辑 PM2 系统服务文件，添加以下配置，避免网络未就绪导致应用启动失败：
+
+```ini
+[Unit]
+Wants=network-online.target
+After=network.target network-online.target
+
+[Install]
+WantedBy=multi-user.target network-online.target
+```
+
+## 五、Windows 系统开机自启
+
+1. 执行以下命令并按回车确认
+
+```bash
+npx pm2-service-install -n PM2
+```
+
+1. 保存当前 PM2 进程列表，安装好服务后，需要把当前正在运行的应用保存下来，这样开机后服务才能自动拉起它们：
+
+```bash
+pm2 save
+```
+
+以后只要用 PM2 启动或停止了新的应用，记得再次执行 pm2 save 来更新开机自启列表。
+
+## 六、完整操作流程（推荐）
+
+1. 启动所有需要持久化的 Node.js 应用
+2. 保存进程列表：`pm2 save`
+3. 生成开机自启脚本：`pm2 startup`（复制输出命令执行）
+4. 重启服务器验证：`reboot`
+5. 重启后查看进程：`pm2 list`
+
+# package.json
+
+```json
+{
+  "name": "satellite-network-simulation-server",
+  "private": true,
+  "version": "1.0.0",
+  "description": "Nest TypeScript starter repository",
+  "license": "MIT",
+  "scripts": {
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "start": "node dist/src/main.js",
+    "pm2:start": "npx pm2 start ecosystem.config.js --name nest-app",
+    "pm2:list": "npx pm2 list",
+    "pm2:status": "npx pm2 show nest-app",
+    "pm2:stop": "npx pm2 stop nest-app",
+    "pm2:delete": "npx pm2 delete nest-app",
+    "pm2:logs": "npx pm2 logs nest-app --lines 1000"
+  },
+  "engines": {
+    "npm": ">=10.0.0",
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.17",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.1.11",
+    "@nestjs/platform-socket.io": "^11.1.19",
+    "@nestjs/platform-ws": "^11.1.19",
+    "@nestjs/swagger": "^11.4.2",
+    "@nestjs/typeorm": "^11.0.1",
+    "@nestjs/websockets": "^11.1.19",
+    "class-validator": "^0.15.1",
+    "dotenv": "^17.4.2",
+    "mysql2": "^3.22.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.29",
+    "ws": "^8.20.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@swc/cli": "^0.6.0",
+    "@swc/core": "^1.10.8",
+    "@types/express": "^5.0.0",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "globals": "^15.14.0",
+    "pm2": "^7.0.1",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["@nestjs/core", "@swc/core"]
+  }
+}
+```

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "snss-types",
+  "version": "1.0.0",
+  "label": "卫星网络仿真文件解析数据传输服务",
+  "description": "基于 Nestjs 的 服务端接口，提供文件数据处理解析传输等服务接口",
+  "private": false,
+  "main": "./src/types/index.ts",
+  "files": [
+    "./src/types"
+  ],
+  "scripts": {
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "start": "node dist/src/main.js",
+    "pm2:start": "npx pm2 start ecosystem.config.js --name nest-app",
+    "pm2:save": "npx pm2 save",
+    "pm2:list": "npx pm2 list",
+    "pm2:status": "npx pm2 show nest-app",
+    "pm2:stop": "npx pm2 stop nest-app",
+    "pm2:delete": "npx pm2 delete nest-app",
+    "pm2:logs": "npx pm2 logs nest-app --lines 1000"
+  },
+  "engines": {
+    "npm": ">=10.0.0",
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.17",
+    "@nestjs/config": "^4.0.4",
+    "@nestjs/core": "^11.1.21",
+    "@nestjs/platform-express": "^11.1.11",
+    "@nestjs/platform-socket.io": "^11.1.19",
+    "@nestjs/platform-ws": "^11.1.19",
+    "@nestjs/swagger": "^11.4.2",
+    "@nestjs/typeorm": "^11.0.1",
+    "@nestjs/websockets": "^11.1.19",
+    "class-validator": "^0.15.1",
+    "cross-zip": "^4.0.1",
+    "dotenv": "^17.4.2",
+    "lodash-es": "^4.18.1",
+    "mysql2": "^3.22.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.29",
+    "ws": "^8.20.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@swc/cli": "^0.6.0",
+    "@swc/core": "^1.10.8",
+    "@types/cross-zip": "^4.0.2",
+    "@types/express": "^5.0.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^24.12.4",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "globals": "^15.14.0",
+    "pm2": "^7.0.1",
+    "pm2-windows-service": "^0.2.1",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@nestjs/core",
+      "@swc/core"
+    ]
+  }
+}

package/src/types/case.ts

@@ -0,0 +1,86 @@
+import { EvaluationMethod, SceneItem, SceneItemSelfInfo } from './scene'
+
+/**
+ * 案例类型
+ */
+export type CaseType = 'architecture_optimization'
+
+/**
+ * 优化评估案例
+ */
+export 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[]
+}
+
+/**
+ * 案例库树结构对象
+ */
+export interface CaseItem {
+  label: string
+  value: string
+  meta: CaseItemMeta
+  children: SceneItem[]
+  isLeaf?: boolean
+  isOnline?: boolean
+  [x: string]: any
+}
+
+export interface CaseItemMeta {
+  case_json?: CaseJsonData
+  evaluation_summary_json?: EvaluationSummaryData
+}
+
+/**
+ * 各维度评分
+ */
+export interface DimensionScores {
+  /** 网络容量评分 */
+  network_capacity: number
+  /** 服务质量评分 */
+  service_quality: number
+  /** 网络韧性评分 */
+  network_resilience: number
+  /** 网络复杂度评分 */
+  network_complexity: number
+  // 支持增加新的评估维度
+  [x: string]: number
+}
+
+/**
+ * 场景评估节点
+ */
+export interface SceneEvaluation {
+  /** 场景唯一标识 */
+  scene_id: string
+  /** 场景显示名称 */
+  scene_name: string
+  /** 综合最终得分 */
+  final_score: number
+  /** 各维度得分详情 */
+  dimension_scores: DimensionScores
+}
+
+/**
+ * 多维度评估结果
+ */
+export interface EvaluationSummaryData {
+  /** 案例唯一标识 */
+  case_id: string
+  /** 评估方法 */
+  evaluation_method: EvaluationMethod
+  /** 场景评估列表 */
+  scenes: SceneEvaluation[]
+}

package/src/types/index.ts

@@ -0,0 +1,70 @@
+import { ModelEntity } from '@/entity/ModelEntity'
+import { CaseItem } from './case'
+import { SceneItemMeta } from './scene'
+
+export * from '@/dto/DirPathDto'
+export * from '@/dto/InitCaseCacheDto'
+export * from '@/dto/ModelDto'
+export * from '@/dto/SendMessageDto'
+export * from '@/entity/ModelEntity'
+export * from './case'
+export * from './scene'
+
+/**
+ * 基础响应结构
+ * 所有 API 响应的通用格式
+ */
+export interface BaseResponse {
+  /** 状态码，通常 200 表示成功，其他表示错误 */
+  code: number
+  /** 响应数据，可选 */
+  data?: any
+  /** 响应消息或错误描述 */
+  message: string
+}
+
+/**
+ * 库树结构响应
+ * 用于返回层级化的树形结构数据（如目录树、模型库树等）
+ */
+export interface CaseTreeResponse extends BaseResponse {
+  /** 树形节点数组 */
+  data?: CaseItem[]
+}
+/**
+ * 场景详细信息响应
+ * 通过场景文件夹路径查询并返回场景详细信息
+ */
+export interface SceneItemMetaResponse extends BaseResponse {
+  /** 树形节点数组 */
+  data?: SceneItemMeta
+}
+
+/**
+ * JSON 文件上传响应
+ * 用于返回上传后的文件详细信息
+ */
+export interface UploadFileResponse extends BaseResponse {
+  /** 上传文件的具体信息 */
+  data?: {
+    /** 原始文件名 */
+    originalName: string
+    /** 文件大小（字节） */
+    size: number
+    /** 文件 MIME 类型 */
+    mimetype: string
+    /** 服务器存储路径 */
+    path: string
+    /** 服务器生成的文件名 */
+    filename: string
+  }
+}
+
+/**
+ * 模型响应
+ * 用于返回单个模型、模型列表或空值
+ */
+export interface ModelResponse extends BaseResponse {
+  /** 模型实体数据，可能是单个对象、数组或 null */
+  data?: ModelEntity | ModelEntity[] | null
+}

package/src/types/scene.ts

@@ -0,0 +1,612 @@
+/**
+ * 场景树结构对象类型
+ */
+export interface SceneItem {
+  label: string
+  value: string
+  meta: SceneItemMeta
+  isLeaf?: boolean
+  [x: string]: any
+}
+
+/**
+ * 场景元数据详细信息类型
+ */
+export 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
+}
+
+/**
+ * 场景节点（单个架构版本）
+ */
+export 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: 最终优化版本
+ */
+export type SceneRole = 'baseline' | 'iteration' | 'final'
+
+// #region manifest.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== manifest.json 类型 ====================
+/**
+ * 时间配置
+ */
+export interface ManifestTime {
+  epoch_utc: string // 起始UTC时间，如 "2026-01-01T00:00:00Z"
+  start_time_s: number
+  end_time_s: number
+  time_step_ms: number
+  frame_count: number
+}
+
+/**
+ * 场景清单文件
+ */
+export interface ManifestData {
+  scene_id: string
+  scene_name: string
+  description: string
+  time: ManifestTime
+}
+
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region constellations.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== constellations.json 类型 ====================
+/**
+ * 星座类型
+ */
+export type ConstellationType = 'GEO' | 'MEO' | 'LEO'
+
+/**
+ * 星座配置
+ */
+export interface Constellation {
+  constellation_id: string
+  constellation_name: string
+  layer: ConstellationType
+  satellite_count: number
+}
+
+/**
+ * 星座列表
+ */
+export interface ConstellationsData {
+  constellations: Constellation[]
+}
+
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region satellites.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== satellites.json 类型 ====================
+/**
+ * 卫星TLE数据
+ */
+export interface SatelliteTLE {
+  line1: string
+  line2: string
+}
+
+/**
+ * 卫星配置
+ */
+export interface Satellite {
+  satellite_id: string
+  satellite_name: string
+  constellation_id: string
+  layer: ConstellationType
+  satellite_type: TaskType
+  orbit_plane: number
+  orbit_index: number
+  tle: SatelliteTLE
+}
+
+/**
+ * 卫星列表
+ */
+export interface SatellitesData {
+  satellites: Satellite[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region nodes.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== nodes.json 类型 ====================
+/**
+ * 地理位置
+ */
+export interface GeoPosition {
+  lon_deg: number
+  lat_deg: number
+  alt_km: number
+}
+
+/**
+ * 容量配置
+ */
+export interface Capacity {
+  max_access_capacity_mbps: number
+}
+
+/**
+ * 显示配置
+ */
+export interface DisplayOptions {
+  show_trajectory?: boolean
+}
+
+/**
+ * 节点类型
+ */
+export type NodeType = 'gateway' | 'user_terminal' | 'control_center' | 'other'
+
+/**
+ * 终端类型（仅在 node_type = 'user_terminal' 时使用）
+ */
+export type TerminalType = 'fixed' | 'mobile' | 'airborne' | 'maritime'
+
+/**
+ * 移动模型类型
+ */
+export type MobilityModel = 'static' | 'waypoint'
+
+/**
+ * 网关节点
+ */
+export interface GatewayNode {
+  node_id: string
+  node_name: string
+  node_type: 'gateway'
+  region: string
+  geo_position: GeoPosition
+  capacity: Capacity
+}
+
+/**
+ * 固定用户终端
+ */
+export interface StaticUserTerminal {
+  node_id: string
+  node_name: string
+  node_type: 'user_terminal'
+  terminal_type: 'fixed'
+  mobility_model: 'static'
+  geo_position: GeoPosition
+  display_options?: DisplayOptions
+}
+
+/**
+ * 移动用户终端
+ */
+export interface MobileUserTerminal {
+  node_id: string
+  node_name: string
+  node_type: 'user_terminal'
+  terminal_type: 'mobile'
+  mobility_model: 'waypoint'
+  geo_position: GeoPosition
+  display_options?: DisplayOptions
+}
+
+/**
+ * 其他类型用户终端
+ */
+export 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
+}
+
+/**
+ * 控制中心节点
+ */
+export interface ControlCenterNode {
+  node_id: string
+  node_name: string
+  node_type: 'control_center'
+  geo_position: GeoPosition
+}
+
+/**
+ * 其他类型节点
+ */
+export interface OtherNode {
+  node_id: string
+  node_name: string
+  node_type: 'other'
+  geo_position: GeoPosition
+}
+
+/**
+ * 节点联合类型
+ */
+export type Node =
+  | GatewayNode
+  | StaticUserTerminal
+  | MobileUserTerminal
+  | OtherUserTerminal
+  | ControlCenterNode
+  | OtherNode
+
+/**
+ * 节点列表
+ */
+export interface NodesData {
+  nodes: Node[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region links.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== links.json 类型 ====================
+/**
+ * 链路类型
+ */
+export type LinkType = 'ISL' | 'IOL' | 'GSL' | 'BACKHAUL'
+
+/**
+ * 节点类型
+ */
+export type LinkNodeType = 'satellite' | 'gateway'
+
+/**
+ * 链路实例
+ */
+export 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
+}
+
+/**
+ * 批量链路配置规则
+ */
+export interface BulkConfigRule {
+  constellation_id: string
+  link_type: LinkType
+  capacity_mbps: number
+}
+
+/**
+ * 链路列表
+ */
+export interface LinksData {
+  links: Link[]
+  bulk_config_rules: BulkConfigRule[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region tasks.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== tasks.json 类型 ====================
+/**
+ * 任务类型
+ */
+export type TaskType = 'emergency_communication'
+
+/**
+ * 任务优先级
+ */
+export type TaskPriority = 'high'
+
+/**
+ * 任务
+ */
+export interface Task {
+  task_id: string
+  task_name: string
+  task_type: TaskType
+  priority: TaskPriority
+  flow_ids: string[]
+  start_time_s: number
+  end_time_s: number
+}
+
+/**
+ * 任务列表
+ */
+export interface TasksData {
+  tasks: Task[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region flows.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== flows.json 类型 ====================
+/**
+ * 业务类型
+ */
+export type ServiceType = 'voice' | 'image_return'
+
+/**
+ * 业务优先级
+ */
+export type FlowPriority = 'high'
+
+/**
+ * 业务流
+ */
+export 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
+}
+
+/**
+ * 业务流列表
+ */
+export interface FlowsData {
+  flows: Flow[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region timeline.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== timeline.json 类型 ====================
+/**
+ * 地理位置
+ */
+export interface GeoPosition {
+  lon_deg: number
+  lat_deg: number
+  alt_km: number
+}
+
+/**
+ * 速度向量
+ */
+export interface VelocityWGS {
+  vx: number
+  vy: number
+  vz: number
+  unit: string
+}
+
+/**
+ * 用户状态
+ */
+export interface UserState {
+  node_id: string
+  geo_position: GeoPosition
+  velocity_wgs: VelocityWGS
+}
+
+/**
+ * 链路状态
+ */
+export interface LinkState {
+  link_id: string
+  status: string
+  utilization_ratio: number
+  congestion_level: number
+}
+
+/**
+ * 业务流状态
+ */
+export 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
+}
+
+/**
+ * 任务状态
+ */
+export interface TaskState {
+  task_id: string
+  status: string
+  active_flow_ids: string[]
+}
+
+/**
+ * 时间轴单帧数据
+ */
+export interface TimelineFrame {
+  frame_no: number
+  timestamp_s: number
+  user_states: UserState[]
+  links: LinkState[]
+  flows: FlowState[]
+  tasks: TaskState[]
+}
+
+/**
+ * 时间轴数据
+ */
+export interface TimelineData {
+  timelines: TimelineFrame[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region metrics.json 类型 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== metrics.json 类型 ====================
+/**
+ * 概要统计
+ */
+export 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
+}
+
+/**
+ * 时序数据点
+ */
+export 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
+}
+
+/**
+ * 图表配置
+ */
+export interface ChartConfig {
+  chart_id: string
+  chart_name: string
+  chart_type: string
+  x_field: string
+  y_fields: string[]
+  unit: string
+}
+
+/**
+ * 图表资源
+ */
+export interface FigureAsset {
+  figure_id: string
+  figure_name: string
+  figure_type: string
+  file_path: string
+  description: string
+}
+
+/**
+ * 指标数据
+ */
+export interface MetricsData {
+  summary: MetricsSummary
+  timeseries: TimeseriesPoint[]
+  charts: ChartConfig[]
+  figure_assets: FigureAsset[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
+
+// #region evaluation.json ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
+// ==================== evaluation.json 类型 ====================
+/**
+ * 评估方法类型
+ */
+export type EvaluationMethod = 'AHP_ENTROPY'
+
+/**
+ * 指标方向类型
+ */
+export type MetricDirection = 'benefit' | 'cost'
+
+/**
+ * 评估模型
+ */
+export interface EvaluationModel {
+  method: EvaluationMethod
+}
+
+/**
+ * 细分指标
+ */
+export interface Metric {
+  metric_id: string
+  metric_name: string
+  direction: MetricDirection
+  value: number
+  normalized_value: number
+  unit: string
+}
+
+/**
+ * 评估维度
+ */
+export interface EvaluationDimension {
+  dimension_id: string
+  dimension_name: string
+  score: number
+  ahp_weight: number
+  entropy_weight: number
+  combined_weight: number
+  metrics: Metric[]
+}
+
+/**
+ * 最终得分
+ */
+export interface FinalScore {
+  score: number
+  score_scale: string
+}
+
+/**
+ * 评估图表配置
+ */
+export interface EvaluationChart {
+  chart_id: string
+  chart_name: string
+  chart_type: string
+  label_field: string
+  value_field: string
+  unit: string
+}
+
+/**
+ * 评估图表资源
+ */
+export interface EvaluationFigureAsset {
+  figure_id: string
+  figure_name: string
+  figure_type: string
+  file_path: string
+  description: string
+}
+
+/**
+ * 评估结果
+ */
+export interface EvaluationData {
+  scene_id: string
+  scene_name: string
+  evaluation_model: EvaluationModel
+  dimensions: EvaluationDimension[]
+  final_score: FinalScore
+  charts: EvaluationChart[]
+  figure_assets: EvaluationFigureAsset[]
+}
+// #endregion ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑