From 184213b3c5da1de6d264e511978e9f30b77396ec Mon Sep 17 00:00:00 2001
From: tian <11429339@qq.com>
Date: Thu, 18 Jun 2026 17:28:29 +0800
Subject: [PATCH] =?UTF-8?q?=E5=AF=B9=E6=8E=A5=E6=96=87=E6=A1=A3=20V1.7?=
 =?UTF-8?q?=EF=BC=9A=E6=95=B0=E6=8D=AE=E5=88=86=E5=B1=82=E6=9E=B6=E6=9E=84?=
 =?UTF-8?q?=20+=20ScenarioDrone/ScenarioUnit=20=E5=A4=96=E9=94=AE=E5=BC=95?=
 =?UTF-8?q?=E7=94=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/对接文档_Unity前端.md | 81 +++++++++++++++++++++++++-------------
 1 file changed, 54 insertions(+), 27 deletions(-)

diff --git a/docs/对接文档_Unity前端.md b/docs/对接文档_Unity前端.md
index d9c7a32..76cf71a 100644
--- a/docs/对接文档_Unity前端.md
+++ b/docs/对接文档_Unity前端.md
@@ -1,6 +1,6 @@
 # 后端对接文档（Unity 前端）
 
-> **版本**：V1.6  
+> **版本**：V1.7  
 > **日期**：2026-06-18  
 > **Unity 版本**：2022.3.62f3c1  
 
@@ -72,20 +72,23 @@ var scenarioId = demos.Items[0].Id;
 // 方式 B：自定义
 var sc = scenario.CreateScenario("我的想定", "");
 scenario.SaveScene(sc.Id, new CombatScene { WindSpeed = 5, WindDirection = (int)WindDirection.E });
+
+// 无人机：引用 DroneSpec (基础数据) + 想定特有字段
 scenario.SaveScenarioDrone(sc.Id, new ScenarioDrone {
-    WaveId = "w1", Model = "Shahed-136", Description = "活塞巡飞弹",
-    Quantity = 1, DroneType = (int)DroneType.FixedWing,
-    TypicalSpeed = 200, TypicalAltitude = 500
+    DroneSpecId = "shahed", WaveId = "w1", Quantity = 3
 });
+
+// 部署：引用 FireUnitSpec (基础数据) + 想定特有字段
+scenario.SaveDeployment(sc.Id, new List<ScenarioUnit> {
+    new() { FireUnitSpecId = "ground-light", Quantity = 2,
+            PositionX = 5000, PositionY = 0, PositionZ = 50,
+            AerosolType = 0, MunitionCount = 8, Description = "地面轻型平台" }
+});
+
 scenario.SaveRoute(sc.Id, "w1", new RoutePlan(), new List<Waypoint> {
     new() { PosX = 0, PosY = 500, PosZ = 0, Speed = 200 },
     new() { PosX = 10000, PosY = 500, PosZ = 0, Speed = 200 }
 });
-scenario.SaveDeployment(sc.Id, new List<ScenarioUnit> {
-    new() { EquipmentRole = 1, PlatformType = 1, Quantity = 1,
-            PositionX = 5000, AerosolType = 0, MunitionCount = 8,
-            Description = "地面轻型平台" }
-});
 scenario.SaveCloud(sc.Id, new CloudDispersal { AerosolType = 0, DisperseHeight = 500 });
 scenario.UpdateStep(sc.Id, 5);
 ```
@@ -209,54 +212,78 @@ replay.TotalFrames / replay.GetFrame(index)
 |------|------|
 | **DroneEntity** | Id, PosX/Y/Z, Hp, Status, DroneType, Wingspan, CruiseSpeed, Route, TraveledArc, TotalArc, Progress |
 | **CloudEntity** | Id, PosX/Y/Z, Radius, Density, Phase, Elapsed, IsDissipated |
-| **MunitionEntity** | Id, PosX/Y/Z, Velocity, Start, LaunchTime, ElapsedTime, LaunchAngle, Azimuth, MuzzleVelocity, FlightDuration, Target, HasArrived |
-| **PlatformEntity** | Id, PosX/Y/Z, CurrentVelocity, State, MunitionCount, Cooldown, MuzzleVelocity, CruiseSpeed, ReleaseAltitude, Target, FlightDistance |
+| **MunitionEntity** | Id, PosX/Y/Z, Velocity, Start, LaunchTime, ElapsedTime, LaunchAngle, Azimuth, MuzzleVelocity, FlightDuration, TargetX/Y/Z, HasArrived |
+| **PlatformEntity** | Id, PosX/Y/Z, CurrentVelocity, State, MunitionCount, Cooldown, MuzzleVelocity, CruiseSpeed, ReleaseAltitude, TargetX/Y/Z, FlightDistance |
 | **DetectionEntity** | Id, PosX/Y/Z, Source, IsInRange(), IsDetected() |
 
 ---
 
 ## 七、核心模型
 
-### 7.1 数据库表
+### 7.1 数据分层
+
+```
+基础数据（全局模板）              想定数据（归属 ScenarioId）
+─────────────────              ──────────────────────────
+DroneSpec                       ScenarioDrone (DroneSpecId FK)
+FireUnitSpec                    ScenarioUnit  (FireUnitSpecId / SensorSpecId FK)
+SensorSpec
+AmmunitionSpec
+EnvironmentSpec
+FormationTemplate
+RouteTemplate
+ModelInfo
+```
+
+### 7.2 数据库表
 
 | 模型 | SQLite 表 | 说明 |
 |------|------|------|
 | `Scenario` | `Scenario` | 想定任务 |
 | `CombatScene` | `CombatScene` | 作战环境 |
-| `ScenarioDrone` | `ScenarioDrone` | 无人机批次参数 |
-| `ScenarioUnit` | `ScenarioUnit` | 装备部署 |
+| `ScenarioDrone` | `ScenarioDrone` | 无人机批次（引用 DroneSpec） |
+| `ScenarioUnit` | `ScenarioUnit` | 装备部署（引用 FireUnitSpec/SensorSpec） |
 | `CloudDispersal` | `CloudDispersal` | 云团抛撒配置 |
 | `RoutePlan` | `RoutePlan` | 航路规划 |
 | `Waypoint` | `Waypoint` | 航路点 |
 | `ControlZone` | `ControlZone` | 管控区域 |
 | `SimulationReport` | `SimulationReport` | 仿真报告 |
-| `AmmunitionSpec` | `AmmunitionSpec` | 弹药基础参数 |
 | `DroneSpec` | `DroneSpec` | 无人机基础模板 |
 | `FireUnitSpec` | `FireUnitSpec` | 火力单元基础模板 |
 | `SensorSpec` | `SensorSpec` | 传感器基础模板 |
+| `AmmunitionSpec` | `AmmunitionSpec` | 弹药基础参数 |
 | `EnvironmentSpec` | `EnvironmentSpec` | 环境基础模板 |
 | `FormationTemplate` | `FormationTemplate` | 编队基础模板 |
 | `RouteTemplate` | `RouteTemplate` | 航线基础模板 |
 | `ModelInfo` | `ModelInfo` | 3D 模型元数据 |
 
-### 7.2 关键属性
+### 7.3 关键属性
 
 | 模型 | 属性 | 类型 | 说明 |
 |------|------|------|------|
-| `ScenarioDrone` | `Model` | string | 型号 |
-| `ScenarioDrone` | `Description` | string | 描述/用途 |
-| `ScenarioDrone` | `DroneType` | DroneType | Rotor / FixedWing / HighSpeed |
-| `ScenarioDrone` | `PowerType` | PowerType | Electric / Piston / Jet |
-| `ScenarioDrone` | `TypicalSpeed` | double | 典型速度 (km/h) |
-| `ScenarioDrone` | `TypicalAltitude` | double | 典型高度 (m) |
-| `Scenario` | `ScenarioNumber` | string | 想定编号（唯一） |
-| `Scenario` | `Description` | string | 想定描述 |
+| `ScenarioDrone` | `DroneSpecId` | string | FK → DroneSpec |
+| `ScenarioDrone` | `WaveId` | string | 批次 ID |
+| `ScenarioDrone` | `Quantity` | int | 数量 |
+| `ScenarioUnit` | `FireUnitSpecId` | string | FK → FireUnitSpec（发射平台） |
+| `ScenarioUnit` | `SensorSpecId` | string | FK → SensorSpec（探测设备） |
+| `ScenarioUnit` | `PositionX/Y/Z` | double | 部署位置 |
+| `ScenarioUnit` | `AerosolType` | int? | 挂载弹药类型 |
+| `ScenarioUnit` | `MunitionCount` | int? | 弹药数量 |
 | `ScenarioUnit` | `Description` | string | 部署备注 |
-| `ScenarioUnit` | `MuzzleVelocity` | double? | 初速 (m/s) |
-| `ScenarioUnit` | `CruiseSpeed` | double? | 巡航速度 (m/s)，空基专用 |
 | `DroneSpec` | `Model` | string | 型号 |
 | `DroneSpec` | `Description` | string | 描述/用途 |
+| `DroneSpec` | `DroneType` | DroneType | Rotor / FixedWing / HighSpeed |
+| `DroneSpec` | `PowerType` | PowerType | Electric / Piston / Jet |
+| `DroneSpec` | `TypicalSpeed` | double | 典型速度 (km/h) |
+| `DroneSpec` | `TypicalAltitude` | double | 典型高度 (m) |
 | `FireUnitSpec` | `Description` | string | 描述/用途 |
+| `FireUnitSpec` | `MuzzleVelocity` | double | 初速 (m/s) |
+| `FireUnitSpec` | `CruiseSpeed` | double | 巡航速度 (m/s) |
+| `FireUnitSpec` | `RadarRange` | double | 雷达距离 (m) |
+| `Scenario` | `ScenarioNumber` | string | 想定编号（唯一） |
+| `Scenario` | `Description` | string | 想定描述 |
+| `SimulationReport` | `DroneCount` | int | 无人机总数 |
+| `SimulationReport` | `UnitCount` | int | 装备总数 |
 
 ---
 
@@ -291,4 +318,4 @@ dotnet publish -c Release -o ../../unity_plugins
 |------|------|
 | 架构设计 | `docs/design/architecture/总体架构设计.md` |
 | 实体事件映射 | `docs/design/technical/仿真器实体与事件映射.md` |
-| 测试状态 | **238 测试，11 秒（全部通过）** |
+| 测试状态 | **238 测试，10 秒（全部通过）** |