326 lines
9.6 KiB
Markdown
326 lines
9.6 KiB
Markdown
# 空运宝 - 无人机物流供需匹配平台
|
||
|
||
无人机物流供需匹配平台，连接发货方与无人机运营方，实现同城即时配送。
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
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. 运营方：查看任务大厅 → 接单 → 无人机管理 → 查看收入
|