# 实施计划与任务跟踪

> **项目**：反无人机仿真系统后端  
> **文档版本**：V1.0  
> **创建日期**：2026-06-11  

---

## 一、阶段总览

```
Phase 1  ■■■■■ 核心基础（6天）
Phase 2  ■■■■■ 想定管理（5天）
Phase 3  ■■■■■ 算法层（7天）
Phase 4  ■■■■■ 仿真引擎（7天）
Phase 5  ■■■   报告生成（3天）
Phase 6  ■■■■  Unity 集成（5天）
Phase 7  ■■    打磨收尾（3天）
────────────────────────────
合计             约 36 天（7~8 周）
```

> 依赖关系：Phase 1 → Phase 2 → Phase 3+4（可并行） → Phase 5 → Phase 6 → Phase 7

---

## 二、各阶段详情

### Phase 1：核心基础

**目标**：搭建项目骨架，数据层可读写，单元测试全绿。  
**时间**：6 天  
**验证**：`dotnet test` 全绿，所有 Repository 和基础 Service 可独立运行。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 1.1 | 创建 `CounterDrone.Core` 类库项目（.NET Standard 2.1） | 2h | ⬜ |
| 1.2 | 创建 `CounterDrone.Core.Tests` xUnit 测试项目 | 1h | ⬜ |
| 1.3 | 定义所有枚举（17 个）和数据模型（11 张表 POCO） | 4h | ⬜ |
| 1.4 | 集成 sqlite-net，编写 `DatabaseManager`（建表 / 迁移） | 3h | ⬜ |
| 1.5 | 实现 `IPathProvider` 接口 + 测试用实现 | 1h | ⬜ |
| 1.6 | 实现 `ModelRepository`（CRUD + 文件存储路径管理） | 3h | ⬜ |
| 1.7 | 实现 `AmmunitionSpecRepository`（加载第三方 JSON 配置） | 2h | ⬜ |
| 1.8 | 实现 `GroupRepository` | 2h | ⬜ |
| 1.9 | 实现 `IModelService` + `ModelService` | 3h | ⬜ |
| 1.10 | 实现 `IGroupService` + `GroupService` | 2h | ⬜ |
| 1.11 | 编写 ModelService / GroupService 单元测试 | 4h | ⬜ |
| 1.12 | 编写 Repository 单元测试（SQLite 文件模式） | 4h | ⬜ |

**Phase 1 验收标准**：
- [ ] 11 张表可在 SQLite 中自动建表
- [ ] ModelInfo、AmmunitionSpec、Group 的完整 CRUD 通过测试
- [ ] 第三方 AmmunitionSpec JSON 可成功导入数据库
- [ ] dotnet test 全部通过

---

### Phase 2：想定管理

**目标**：仿真任务的完整 CRUD + 5 步配置保存/加载 + 搜索分页。  
**时间**：5 天  
**验证**：可创建想定、逐步骤配置保存、草稿恢复、搜索分页。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 2.1 | 实现 `SimTaskRepository` + `SimTask` 增删改查 | 2h | ⬜ |
| 2.2 | 实现 `CombatSceneRepository` | 1h | ⬜ |
| 2.3 | 实现 `ControlZoneRepository` | 1h | ⬜ |
| 2.4 | 实现 `TargetConfigRepository` | 1h | ⬜ |
| 2.5 | 实现 `EquipmentDeploymentRepository` | 1h | ⬜ |
| 2.6 | 实现 `CloudDispersalRepository` | 1h | ⬜ |
| 2.7 | 实现 `RoutePlanRepository` + `WaypointRepository` | 2h | ⬜ |
| 2.8 | 实现 `IScenarioService` — CreateTask / DeleteTask | 2h | ⬜ |
| 2.9 | 实现步骤保存方法（SaveScene / SaveTarget / ... / SaveRoute） | 3h | ⬜ |
| 2.10 | 实现 `GetTaskDetail`（聚合 5 步配置） | 2h | ⬜ |
| 2.11 | 实现 `SearchTasks`（关键词 + 时间范围 + 分页） | 3h | ⬜ |
| 2.12 | 实现 UpdateStep（步骤状态管理） | 1h | ⬜ |
| 2.13 | 实现输入校验（必填校验、数值范围校验） | 2h | ⬜ |
| 2.14 | 编写 ScenarioService 单元测试 | 6h | ⬜ |

**Phase 2 验收标准**：
- [ ] 创建任务 → 5 步逐步骤保存 → 草稿恢复 → 搜索分页 全链路可走通
- [ ] 按任务名称搜索、按日期筛选、分页浏览通过测试
- [ ] 必填校验：任务名称为空时拒绝创建
- [ ] `GetTaskDetail` 返回完整的 5 步配置聚合对象

---

### Phase 3：算法层

**目标**：高斯烟团扩散模型、三种毁伤模型、防御推荐算法全部实现并通过确定性测试。  
**时间**：7 天  
**验证**：固定输入 → 固定输出，可精确断言计算结果。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 3.1 | 实现 `GaussianPuffDispersion`（简化球体膨胀 + 风速漂移 + 密度衰减） | 8h | ⬜ |
| 3.2 | 编写扩散模型单元测试（无风/有风/消散/密度衰减 4 场景） | 4h | ⬜ |
| 3.3 | 实现 `InertGasDamageModel`（阈值型吸入式灭火） | 3h | ⬜ |
| 3.4 | 实现 `ActiveMaterialDamageModel`（触发型爆燃式） | 3h | ⬜ |
| 3.5 | 实现 `ActiveFuelDamageModel`（指数累积型吸入式爆炸） | 3h | ⬜ |
| 3.6 | 实现 `DamageModelRouter`（根据 AerosolType 路由到对应模型） | 1h | ⬜ |
| 3.7 | 编写毁伤模型单元测试（每种机制 3 个场景） | 4h | ⬜ |
| 3.8 | 实现 `DefaultDefenseAdvisor` — Step A 气溶胶选型规则 | 3h | ⬜ |
| 3.9 | 实现 `DefaultDefenseAdvisor` — Step B 时空交汇优化 | 6h | ⬜ |
| 3.10 | 实现 `DefaultDefenseAdvisor` — Step C 反推平台部署 | 4h | ⬜ |
| 3.11 | 实现 `AlgorithmFactory`（注册/创建） | 2h | ⬜ |
| 3.12 | 编写 DefenseAdvisor 单元测试（活塞→惰性气体 / 喷气→活性材料） | 4h | ⬜ |

**Phase 3 验收标准**：
- [ ] 扩散模型：给定初始半径+风速+60s → 断言最终半径和中心偏移
- [ ] 毁伤模型：活塞发动机 5s 暴露于惰性气体 → 断言 HP ≤ 阈值
- [ ] 防御推荐：活塞发动机航路 → 推荐惰性气体，拦截概率 > 0
- [ ] AlgorithmFactory.Register 可替换任一算法实现
- [ ] 所有测试结果完全可复现（确定性）

---

### Phase 4：仿真引擎

**目标**：完整 8 阶段仿真引擎，支持运行/暂停/停止，录制帧数据和事件。  
**时间**：7 天  
**验证**：加载想定 → 运行完整仿真 → 检查事件序列和帧数据。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 4.1 | 实现 `DroneEntity`（航路移动 + 风偏 + 编队排列） | 4h | ⬜ |
| 4.2 | 实现 `PlatformEntity`（空基/地基 + 冷却计时） | 3h | ⬜ |
| 4.3 | 实现 `MunitionEntity`（自由落体 + 抛物线弹道） | 4h | ⬜ |
| 4.4 | 实现 `CloudEntity`（集成扩散模型 + 毁伤判定） | 3h | ⬜ |
| 4.5 | 实现 `DetectionEntity`（探测扫描） | 2h | ⬜ |
| 4.6 | 实现 `ControlZone` 多边形判定（Point-in-Polygon） | 2h | ⬜ |
| 4.7 | 实现 `EventQueue` | 2h | ⬜ |
| 4.8 | 实现 `SimulationEngine` — Initialize（加载配置，实例化实体） | 4h | ⬜ |
| 4.9 | 实现 `SimulationEngine` — 8 阶段 Tick 流程 | 6h | ⬜ |
| 4.10 | 实现 `SimulationEngine` — Pause/Resume/Stop + State 管理 | 2h | ⬜ |
| 4.11 | 实现 `IFrameDataStore` — CreateTaskDb / WriteFrame / ReadFrames | 4h | ⬜ |
| 4.12 | 实现 `SimEvent` 写入主库 + 查询 | 2h | ⬜ |
| 4.13 | 编写仿真集成测试（单无人机无拦截 → 到达目标） | 3h | ⬜ |
| 4.14 | 编写仿真集成测试（单无人机 → 拦截成功 → 被摧毁） | 3h | ⬜ |
| 4.15 | 编写仿真集成测试（多无人机 + 编队 + 蜂群） | 3h | ⬜ |
| 4.16 | 编写仿真集成测试（管控区域侵入） | 2h | ⬜ |

**Phase 4 验收标准**：
- [ ] 加载完整想定配置后可启动仿真
- [ ] 8 个阶段的 Tick 顺序正确，事件队列正常产出
- [ ] 集成测试：单无人机无拦截 → 断言 "DroneReachedTarget" 事件
- [ ] 集成测试：单无人机被拦截 → 断言 "DroneDestroyed" + "CloudGenerated"
- [ ] 帧数据可正确写入 `frames/{taskId}.db`，回读验证帧数一致
- [ ] Pause/Resume 不影响仿真状态一致性

---

### Phase 5：报告生成

**目标**：仿真结束后自动生成报告，支持 PDF/Word 导出。  
**时间**：3 天  
**验证**：跑完仿真 → 生成报告 → 导出文件存在且内容正确。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 5.1 | 实现 `ReportGenerator`（从 SimEvent + 配置聚合统计数据） | 4h | ⬜ |
| 5.2 | 实现对抗结果判定逻辑（成功/部分/失败） | 1h | ⬜ |
| 5.3 | 实现报告模板引擎（占位符填充） | 3h | ⬜ |
| 5.4 | 实现 PDF 导出（QuestPDF 或替代方案调研） | 4h | ⬜ |
| 5.5 | 实现 Word 导出 | 3h | ⬜ |
| 5.6 | 实现 `SimulationReportRepository` | 1h | ⬜ |
| 5.7 | 实现 `IReportService`（Generate / Get / Delete / Search / Export） | 3h | ⬜ |
| 5.8 | 编写报告生成单元测试 | 3h | ⬜ |

**Phase 5 验收标准**：
- [ ] 仿真完成后报告自动生成，包含仿真前/中/后三阶段数据
- [ ] 对抗结果判定正确
- [ ] PDF 导出文件可正常打开
- [ ] 报告搜索分页功能正常

---

### Phase 6：Unity 集成

**目标**：将 Core.dll 集成到 Unity，实现完整运行链路。  
**时间**：5 天  
**验证**：在 Unity Editor 中完成"创建想定 → 配置 5 步 → 算法推荐 → 启动仿真 → 查看回放"全流程。

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 6.1 | 创建 Unity 22.3.62 项目，导入 Core.dll 到 Assets/Plugins | 1h | ⬜ |
| 6.2 | 实现 `UnityPathProvider`（返回 persistentDataPath） | 1h | ⬜ |
| 6.3 | 实现 `ModelManager` MonoBehaviour（桥接 IModelService） | 3h | ⬜ |
| 6.4 | 实现 `ScenarioManager` MonoBehaviour（桥接 IScenarioService） | 4h | ⬜ |
| 6.5 | 实现 `SimulationRunner` MonoBehaviour（Update 驱动引擎） | 3h | ⬜ |
| 6.6 | 实现 `ReplayController` MonoBehaviour（协程回放） | 3h | ⬜ |
| 6.7 | 实现 `ReportManager` MonoBehaviour（桥接 IReportService） | 2h | ⬜ |
| 6.8 | 实现 3D 实体可视化（根据 Snapshot 更新 GameObject Transform） | 4h | ⬜ |
| 6.9 | 实现粒子系统参数传递（CloudEntity → ParticleSystem） | 3h | ⬜ |
| 6.10 | 端到端联调 + 问题修复 | 6h | ⬜ |

**Phase 6 验收标准**：
- [ ] Unity Editor 中创建想定 → 配置保存 → 算法推荐 → 启动仿真全链路可走通
- [ ] 仿真过程中 3D 实体实时移动
- [ ] 回放功能正常
- [ ] 无 Crash，无内存泄漏

---

### Phase 7：打磨收尾

**目标**：性能优化、边界处理、TTL 清理、文档。  
**时间**：3 天

| # | 任务 | 预估 | 状态 |
|---|------|------|------|
| 7.1 | 性能优化：Tick() P99 < 5ms | 4h | ⬜ |
| 7.2 | TTL 清理实现 + 测试 | 2h | ⬜ |
| 7.3 | 边界场景测试（0 实体、超大航路、极端风速） | 3h | ⬜ |
| 7.4 | 错误处理加固 | 2h | ⬜ |
| 7.5 | 补充缺失的单元测试（目标覆盖率 > 80%） | 4h | ⬜ |
| 7.6 | 文档更新 + API 注释 | 3h | ⬜ |

**Phase 7 验收标准**：
- [ ] Tick() 单帧耗时 P99 < 5ms（16 实体场景）
- [ ] 过期帧数据库可自动清理
- [ ] 单元测试覆盖率 > 80%
- [ ] 所有公开 API 有 XML 文档注释

---

## 三、依赖关系

```
Phase 1 (核心基础)
    │
    ▼
Phase 2 (想定管理)
    │
    ├──────────────────┐
    ▼                  ▼
Phase 3 (算法层)   Phase 4 (仿真引擎)
    │                  │
    └────────┬─────────┘
             ▼
        Phase 5 (报告生成)
             │
             ▼
        Phase 6 (Unity 集成)
             │
             ▼
        Phase 7 (打磨收尾)
```

> Phase 3 和 Phase 4 可部分并行：算法层完成后仿真引擎才能完整串联，但仿真实体模型可先开工。

---

## 四、里程碑

| 里程碑 | 截止 | 标志 |
|------|------|------|
| M1 — 数据层就绪 | Phase 1 结束 | 11 张表 CRUD 通过 |
| M2 — 想定可配置 | Phase 2 结束 | 5 步配置保存/恢复/搜索 |
| M3 — 算法可计算 | Phase 3 结束 | 扩散/毁伤/推荐输出正确 |
| M4 — 仿真可运行 | Phase 4 结束 | 集成测试通过 |
| M5 — 报告可生成 | Phase 5 结束 | PDF/Word 导出 |
| M6 — Unity 可演示 | Phase 6 结束 | 端到端全链路 |
| M7 — 交付就绪 | Phase 7 结束 | 覆盖率 > 80%，P99 < 5ms |

---

## 五、状态图例

| 符号 | 含义 |
|------|------|
| ⬜ | 未开始 |
| 🔄 | 进行中 |
| ✅ | 已完成 |
| ⏸️ | 阻塞 |
| ❌ | 放弃 |

---

> **下一步**：确认阶段划分和时间计划后，可以开始 Phase 1，逐项打勾推进。