# 项目分析报告 (PROJECT.MD)

## 1. 项目概述
本项目旨在构建一个管理大疆机场（DJI Dock）及大疆行业无人机的平台。当前目录包含官方提供的“上云 API” (Cloud API) 前后端 Demo，采用前后端分离架构。

## 2. 目录结构
*   `Cloud-API/`: 后端服务代码。
*   `Cloud-API-Web/`: 前端 Web 应用代码。

## 3. 技术栈详细分析

### 3.1 后端 (Cloud-API)
*   **开发语言**: Java (必须 JDK 11+)。
*   **核心框架**: Spring Boot 2.7.12。
*   **构建工具**: Maven。
*   **模块结构**:
    *   `cloud-sdk`: 封装与大疆设备交互的核心 SDK 逻辑。
    *   `sample`: 业务逻辑实现示例。
*   **关键依赖**:
    *   `spring-integration-mqtt`: 用于 MQTT 协议通信（设备控制与状态上报的核心）。
    *   MySQL Connector (隐含): 用于数据持久化。
*   **数据存储**:
    *   **MySQL**: 关系型数据库 (版本 8.0.26+)，初始化脚本位于 `sql/cloud_sample.sql`。
    *   **Redis**: 缓存服务 (版本 6.2+)。
*   **消息中间件**:
    *   **EMQX**: MQTT Broker (版本 4.4.0)，用于处理高并发的设备消息。

### 3.2 前端 (Cloud-API-Web)
*   **核心框架**: Vue 3 (v3.2.26)。
*   **开发语言**: TypeScript (v4.5.4)。
*   **构建工具**: Vite (v2.4.0)。
*   **UI 组件库**: Ant Design Vue (v2.2.8)。
*   **状态管理**: Vuex (v4.0.2)。
*   **路由管理**: Vue Router (v4)。
*   **关键功能库**:
    *   `@amap/amap-jsapi-loader`: 高德地图 API，用于地图展示和航线规划。
    *   `agora-rtc-sdk-ng`: 声网 RTC SDK，推测用于无人机实时图传或语音对讲。
    *   `mqtt`: 前端 MQTT 客户端。
    *   `axios`: HTTP 请求库。
*   **样式**: SCSS (Sass)。

## 4. 环境依赖总结
要运行此项目，需要准备以下环境：

1.  **服务器**: Linux (推荐 Ubuntu 16.04+)。
2.  **Java 环境**: OpenJDK 11 或更高版本。
3.  **Node.js**: v17.8 (前端构建)。
4.  **数据库**: MySQL 8.0.26+。
5.  **缓存**: Redis 6.2+。
6.  **MQTT Broker**: EMQX 4.4.0。
7.  **Web 服务器**: Nginx 1.20.2 (用于部署前端静态资源及反向代理)。
8.  **地图服务**: 高德地图 API Key。