# 平台端多版本部署指南

## 项目结构

```
frontend/
├── admin_web/         # Web版本
├── admin_app/         # Flutter APP版本
├── admin_desktop/     # Windows桌面版本
├── admin_miniapp/     # 小程序版�?
└── shared/           # 共享代码
```

## 1. Web版本部署

### 环境要求

- Node.js 20+（前端使用 Vite 7.x、TypeScript 5.9.x）
- npm 10+（配合 Node.js 20）

### 构建步骤

1. 进入Web版本目录�?
   ```bash
   cd frontend/admin_web
   ```

2. 安装依赖�?
   ```bash
   npm install
   ```

3. 构建生产版本�?
   ```bash
   npm run build
   ```

4. 构建产物将生成在 `dist` 目录�?

### 部署到服务器

- 使用 Nginx �?Apache 部署 `dist` 目录
- 配置反向代理指向后端 API

## 2. Flutter APP版本部署

### 环境要求

- Flutter 3.0+
- Dart 3.0+
- Android Studio (Android 构建)
- Xcode (iOS 构建)

### 构建步骤

#### Android 构建

1. 进入APP版本目录�?
   ```bash
   cd frontend/admin_app
   ```

2. 构建APK�?
   ```bash
   flutter build apk --release
   ```

3. 构建产物：`build/app/outputs/flutter-apk/app-release.apk`

#### iOS 构建

1. 进入APP版本目录�?
   ```bash
   cd frontend/admin_app
   ```

2. 构建IPA�?
   ```bash
   flutter build ios --release
   ```

3. 使用 Xcode 归档并导�?IPA

#### Web 构建

1. 进入APP版本目录�?
   ```bash
   cd frontend/admin_app
   ```

2. 构建Web版本�?
   ```bash
   flutter build web
   ```

3. 构建产物：`build/web`

## 3. Windows桌面版本部署

### 环境要求

- Node.js 20+
- npm 10+
- Windows 10+

### 构建步骤

1. 进入桌面版本目录�?
   ```bash
   cd frontend/admin_desktop
   ```

2. 安装依赖�?
   ```bash
   npm install
   ```

3. 构建应用�?
   ```bash
   npm run electron:build
   ```

4. 构建产物将生成在 `dist-electron` 目录�?

## 4. 小程序版本部�?

### 环境要求

- 微信开发者工�?
- 微信公众平台账号

### 部署步骤

1. 打开微信开发者工�?
2. 导入 `frontend/admin_miniapp` 目录
3. 进行代码审核
4. 提交审核
5. 发布上线

## 5. 环境配置

### API 配置

各版本的API配置文件�?

- Web版本：`admin_web/src/services/fetch.ts`
- APP版本：`admin_app/lib/config/api_config.dart`
- 小程序版本：`admin_miniapp/utils/api_config.js`
- 桌面版本：`admin_desktop/src/services/fetch.ts`

### 环境变量

创建 `.env` 文件，配置以下变量：

```
VITE_API_BASE_URL=https://api.fzx.com
VITE_WS_URL=wss://ws.fzx.com
```

## 6. 功能模块说明

### 核心功能

1. **仪表�?*：平台数据概览、实时统�?
2. **订单管理**：订单列表、详情、状态管�?
3. **用户管理**：用户列表、详情、权限管�?
4. **商户管理**：商户列表、审核、配�?
5. **骑手管理**：骑手列表、认证、状态管�?
6. **营销管理**：活动创建、管�?
7. **财务管理**：收支统计、提现管�?
8. **系统设置**：平台配置、权限管�?

### 技术特�?

- **响应式设�?*：适配不同屏幕尺寸
- **主题切换**：支持浅�?深色模式
- **实时数据**：WebSocket 实时更新
- **多端同步**：数据在各端保持一�?

## 7. 常见问题与解决方�?

### 1. API 连接失败

- 检查网络连�?
- 确认 API 地址配置正确
- 检查后端服务是否运�?

### 2. 构建失败

- 确保依赖安装完整
- 检�?Node.js/Flutter 版本
- 清理缓存后重新构�?

### 3. 小程序审核不通过

- 确保功能符合微信小程序规�?
- 提供完整的测试账�?
- 优化用户体验

### 4. 性能问题

- 优化图片资源
- 减少不必要的网络请求
- 使用缓存策略

## 8. 开发规�?

### 代码风格

- Web/桌面版本：ESLint + Prettier
- APP版本：Flutter 官方风格
- 小程序版本：微信官方风格

### 版本控制

- 使用 Git 进行版本管理
- 遵循 Git Flow 工作�?
- 提交信息规范：`feat: 功能描述`

### 安全规范

- 敏感信息使用环境变量
- 所�?API 请求使用 HTTPS
- 定期更新依赖�?

## 9. 监控与维�?

### 日志管理

- 前端日志：使用控制台和第三方服务
- 后端日志：ELK stack

### 性能监控

- 使用 Google Analytics
- 监控页面加载时间
- 监控 API 响应时间

### 错误监控

- 使用 Sentry 进行错误监控
- 定期查看错误报告
- 及时修复严重错误

## 10. 联系支持

- **技术支�?*：support@fengqiliu.com
- **商务合作**：business@fengqiliu.com
- **客服热线**�?00-888-8888

---

**版本�?.0.0**
**更新时间�?026-03-25**
