# 空运宝 - 无人机物流供需匹配平台

无人机物流供需匹配平台，连接发货方与无人机运营方，实现同城即时配送。

---

## 目录

1. [项目概述](#1-项目概述)
2. [产品功能](#2-产品功能)
3. [技术路径](#3-技术路径)
4. [范围管理](#4-范围管理)
5. [WBS 工作分解](#5-wbs-工作分解)
6. [进度管理](#6-进度管理)
7. [项目结构](#7-项目结构)
8. [快速启动](#8-快速启动)

---

## 1. 项目概述

### 1.1 项目背景

传统同城物流存在时效长、成本高、信息不对称等问题。无人机物流作为低空经济的重要组成，正处于政策开放与市场爆发的窗口期。空运宝平台旨在降低无人机物流的使用门槛，让中小商户和个人用户能够便捷地使用无人机配送服务。

### 1.2 项目目标

| 目标 | 描述 |
|------|------|
| **MVP** | 完成供需双方核心交易闭环：发布需求 → 智能匹配 → 接单配送 → 完成交付 |
| **验证** | 通过原型验证产品概念与市场需求，收集种子用户反馈 |
| **扩展** | 为后续平台化、智能化演进奠定架构基础 |

### 1.3 项目范围

- **平台端**：Web 单页应用，支持发货方和运营方两种角色
- **后端**：RESTful API（预留，当前为离线 Mock 数据）
- **文档**：产品文档、商业计划书、项目管理文档

---

## 2. 产品功能

### 2.1 发货方

| 模块 | 功能 |
|------|------|
| 发货大厅 | 查看实时运力、我的订单列表、运营统计 |
| 发布需求 | 填写起运地/目的地、货物类型、重量、时效要求 |
| 匹配运力 | 查看多家供应商报价，比价下单 |
| 我的订单 | 查看所有订单状态、订单详情、确认收货 |
| 运力地图 | 基于 Leaflet 查看附近可用无人机 |

### 2.2 运营方

| 模块 | 功能 |
|------|------|
| 运营概览 | 今日订单、收入、飞行时长、评分等统计看板 |
| 任务大厅 | 查看待接订单，一键接单 |
| 订单管理 | 查看全部订单及状态 |
| 无人机管理 | 添加/移除无人机设备，查看设备状态 |
| 运力地图 | 地图可视化运力分布 |
| 收入明细 | 账户余额、收入记录、提现 |

---

## 3. 技术路径

### 3.1 架构演进路线

```mermaid
graph LR
    subgraph T1年 MVP验证期
        A1[HTML/CSS/JS<br>单页应用]
        A2[Leaflet地图]
        A3[Mock数据<br>离线运行]
    end

    subgraph T2-T3年 平台化期
        B1[Vue3/React18<br>TypeScript]
        B2[Go/Node.js<br>微服务]
        B3[MySQL+Redis<br>+MongoDB]
        B4[自研匹配引擎]
    end

    subgraph T4-T5年 智能化期
        C1[强化学习<br>动态调度]
        C2[LSTM<br>运力预测]
        C3[多Agent<br>协同编排]
        C4[垂域LLM<br>私有化部署]
    end

    A1 --> B1 --> C1
    A2 --> B2 --> C2
    A3 --> B3 --> C3
    B4 --> C4
```

### 3.2 当前技术栈（MVP）

| 层级 | 技术选型 |
|------|---------|
| **前端** | 原生 HTML5 + CSS3 + JavaScript (ES6+) |
| **地图** | Leaflet 1.9.4 + CartoDB 深色底图 |
| **字体** | Google Fonts - Noto Sans SC |
| **部署** | 静态文件，浏览器直接打开 |
| **后端** | RESTful API 预留（可选） |

### 3.3 核心技术要点

- **单页应用架构**：通过原生 JS 实现客户端路由、状态管理、动态渲染
- **API 抽象层**：统一 `API.request()` 方法，支持后端/离线双模式
- **响应式适配**：支持桌面端与移动端布局
- **深色主题**：CSS 变量驱动的暗色设计系统

---

## 4. 范围管理

### 4.1 产品范围

```mermaid
graph TB
    subgraph 包含 In Scope
        IS1[角色选择与登录]
        IS2[发货方: 发布/匹配/追踪]
        IS3[运营方: 接单/无人机管理/收入]
        IS4[运力地图展示]
        IS5[订单全生命周期管理]
    end

    subgraph 不包含 Out of Scope
        OS1[在线支付系统]
        OS2[用户注册/实名认证]
        OS3[移动端App/小程序]
        OS4[后台管理系统]
        OS5[航线规划与空域审批]
    end

    subgraph 待定 TBD
        TB1[评价体系]
        TB2[消息推送]
        TB3[数据统计看板]
    end
```

### 4.2 功能清单

| 模块 | 优先级 | 状态 |
|------|--------|------|
| 角色选择（发货方/运营方） | P0 | ✅ 已完成 |
| 发货方 - 发货大厅 | P0 | ✅ 已完成 |
| 发货方 - 发布需求 | P0 | ✅ 已完成 |
| 发货方 - 匹配运力 | P0 | ✅ 已完成 |
| 发货方 - 我的订单 | P0 | ✅ 已完成 |
| 发货方 - 运力地图 | P1 | ✅ 已完成 |
| 运营方 - 运营概览 | P0 | ✅ 已完成 |
| 运营方 - 任务大厅 | P0 | ✅ 已完成 |
| 运营方 - 订单管理 | P0 | ✅ 已完成 |
| 运营方 - 无人机管理 | P0 | ✅ 已完成 |
| 运营方 - 运力地图 | P1 | ✅ 已完成 |
| 运营方 - 收入明细 | P1 | ✅ 已完成 |
| 添加无人机（弹窗表单） | P1 | ✅ 已完成 |
| 订单详情弹窗 | P1 | ✅ 已完成 |
| 匹配动画交互 | P1 | ✅ 已完成 |
| Toast 通知反馈 | P1 | ✅ 已完成 |

---

## 5. WBS 工作分解

### 5.1 项目工作分解结构

```mermaid
graph TD
    P[空运宝平台] --> A[产品设计]
    P --> B[前端开发]
    P --> C[后端开发]
    P --> D[测试与部署]
    P --> E[项目管理]

    A --> A1[需求分析]
    A --> A2[原型设计]
    A --> A3[UI设计]
    A --> A4[产品文档]

    B --> B1[项目脚手架]
    B --> B2[登录/角色选择]
    B --> B3[发货方模块]
    B --> B3a[发货大厅]
    B --> B3b[发布需求]
    B --> B3c[匹配报价]
    B --> B3d[我的订单]
    B --> B4[运营方模块]
    B --> B4a[运营概览]
    B --> B4b[任务大厅]
    B --> B4c[订单管理]
    B --> B4d[无人机管理]
    B --> B4e[收入明细]
    B --> B5[通用组件]
    B --> B5a[侧边导航]
    B --> B5b[弹窗/Modal]
    B --> B5c[地图组件]
    B --> B5d[Toast通知]
    B --> B6[地图集成]

    C --> C1[API设计]
    C --> C2[数据库设计]
    C --> C3[认证模块]
    C --> C4[业务接口]

    D --> D1[功能测试]
    D --> D2[兼容性测试]
    D --> D3[部署上线]

    E --> E1[进度管理]
    E --> E2[文档管理]
    E --> E3[代码管理]
```

### 5.2 工作包说明

| WBS 编号 | 工作包 | 负责人 | 产出物 |
|----------|--------|--------|--------|
| 1.1 | 需求分析 | PM | PRD 文档 |
| 1.2 | 原型设计 | Designer | 交互原型 |
| 1.3 | UI设计 | Designer | 设计稿 |
| 1.4 | 产品文档 | PM | 产品文档.md |
| 2.1 | 项目脚手架 | FE | index.html |
| 2.2 | 登录/角色选择 | FE | 角色选择页面 |
| 2.3 | 发货方模块 | FE | 发货方全套页面 |
| 2.4 | 运营方模块 | FE | 运营方全套页面 |
| 2.5 | 通用组件 | FE | 导航/弹窗/地图/Toast |
| 2.6 | 地图集成 | FE | Leaflet 地图实例 |
| 3.1 | API设计 | BE | API 接口文档 |
| 4.1 | 功能测试 | QA | 测试报告 |
| 5.1 | 进度管理 | PM | 甘特图/周报 |

---

## 6. 进度管理

### 6.1 里程碑计划

```mermaid
gantt
    title 空运宝项目里程碑
    dateFormat  YYYY-MM-DD
    axisFormat  %m-%d

    section 产品设计
    需求分析与PRD           :a1, 2026-05-01, 5d
    原型与UI设计           :a2, after a1, 5d
    产品文档编制           :a3, after a2, 3d

    section 前端开发
    项目脚手架与架构       :b1, after a2, 2d
    角色选择与登录         :b2, after b1, 2d
    发货方模块             :b3, after b2, 5d
    运营方模块             :b4, after b3, 5d
    通用组件与地图         :b5, after b4, 3d
    联调与集成             :b6, after b5, 3d

    section 后端开发
    API设计与开发          :c1, after a1, 10d

    section 测试部署
    功能测试               :d1, after b6, 3d
    兼容性测试             :d2, after d1, 2d
    部署上线               :d3, after d2, 1d
```

### 6.2 关键里程碑

| 里程碑 | 时间 | 交付物 | 验收标准 |
|--------|------|--------|---------|
| M1 需求确认 | Day 5 | PRD 文档 | 需求评审通过 |
| M2 设计定稿 | Day 10 | UI 设计稿 | 设计评审通过 |
| M3 角色选择 | Day 14 | 登录页面 | 可切换两种角色进入 |
| M4 发货方MVP | Day 19 | 发货方功能 | 发布→匹配→下单全流程跑通 |
| M5 运营方MVP | Day 24 | 运营方功能 | 接单→配送→完成全流程跑通 |
| M6 集成测试 | Day 27 | 全功能版本 | 核心功能无阻塞 Bug |
| M7 上线交付 | Day 28 | 产品发布 | 所有 P0 功能通过验收 |

### 6.3 风险管理

| 风险 | 概率 | 影响 | 应对措施 |
|------|------|------|---------|
| 需求变更频繁 | 中 | 中 | 采用敏捷迭代，优先级管理 |
| 技术方案不成熟 | 低 | 高 | MVP 使用成熟技术栈验证 |
| 人员资源不足 | 中 | 中 | 明确优先级，确保核心功能 |
| 浏览器兼容性 | 低 | 低 | 使用标准 API，主流浏览器测试 |
| 交付延期 | 中 | 高 | 预留缓冲时间，严格控制范围 |

---

## 7. 项目结构

```
lae-log/
├── README.md                 # 项目说明（本文件）
├── platform/
│   ├── index.html            # 主应用入口（2048 行单页应用）
│   └── docs/
│       ├── 产品文档.md        # 产品需求与功能说明
│       └── 商业计划书.md      # 商业模式与财务预测
```

---

## 8. 快速启动

```bash
# 1. 克隆仓库
git clone <repo-url>
cd lae-log

# 2. 直接在浏览器打开
start platform/index.html
```

**使用流程**：
1. 打开页面，选择角色（发货方 / 运营方）
2. 发货方：发布需求 → 查看报价 → 下单 → 追踪配送
3. 运营方：查看任务大厅 → 接单 → 无人机管理 → 查看收入