# chain-cloud-customer-uniapp

**Repository Path**: itheima-chain-cloud/chain-cloud-customer-uniapp

## Basic Information

- **Project Name**: chain-cloud-customer-uniapp
- **Description**: 智链云途用户端代码，基于 uni-app + Vue 3 开发，主要面向微信小程序平台。涵盖寄快递、查快递、地址管理、订单管理、实名认证、AI 算运费等核心功能模块。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智链云途 - 用户端

物流项目用户端应用，基于 uni-app + Vue 3 开发，主要面向微信小程序平台。涵盖寄快递、查快递、地址管理、订单管理、实名认证、AI 算运费等核心功能模块。

---

## 技术架构

| 技术 | 版本/说明 |
|------|----------|
| Vue | 3.x |
| uni-app | 最新版 |
| 高德地图 | 地图定位 |
| 微信支付 | 支付模块 |
| SCSS | 样式预处理 |

---

## 运行环境

- **HBuilderX**: 推荐使用最新版
- **微信开发者工具**: 小程序调试与前后端联调必需

---

## 本地开发与联调

> **注意**: 本项目为 uni-app 项目，编译到微信小程序后，需要在编译产物目录中修改后端接口地址。**切勿修改 `utils/env.js` 源码文件**，应修改编译输出目录中对应文件。

### 1. 使用 HBuilderX 打开项目

将项目导入 HBuilderX，确保已安装 uni-app 相关插件。

### 2. 编译到微信小程序

在 HBuilderX 中选择 **运行 -> 运行到小程序模拟器 -> 微信开发者工具**。

编译成功后，输出目录为：

```
@unpackage/dist/dev/mp-weixin
```

### 3. 微信开发者工具导入

打开微信开发者工具，导入编译产物目录：

```
@unpackage/dist/dev/mp-weixin
```

### 4. 修改后端接口地址

修改编译产物中的环境配置文件：

```
@unpackage/dist/dev/mp-weixin/utils/env.js
```

示例：

```js
const baseUrl = "http://127.0.0.1:9527/customer";
```

修改后在微信开发者工具中保存（或刷新），即可进行前后端联调与功能开发。

> **注意**: 每次重新编译后，`@unpackage/dist/dev/mp-weixin/utils/env.js` 会被覆盖，需要根据开发/测试/线上环境重新修改 `baseUrl`。

---

## 项目功能模块

| 模块 | 说明 |
|------|------|
| 寄快递 | 下单寄件、物品信息填写、地址选择 |
| 查快递 | 订单跟踪、取件码展示 |
| 地址簿 | 收寄地址管理 |
| 订单管理 | 订单详情、取消订单、下单成功页 |
| 实名认证 | 实名认证流程及结果页 |
| AI 算运费 | 智能运费计算 |
| 电子存根 | 订单电子凭证 |
| 计费规则 | 费用说明 |

---

## 项目发布

### 1. 修改环境配置

确保 `manifest.json` 中地图 key、微信 appId 等配置正确。

### 2. 构建打包

在 HBuilderX 中选择 **发行**，按需打包为小程序、H5 或 App。

### 3. 部署

- **小程序**: 上传至微信平台审核发布
- **H5**: 将打包后的文件部署至服务器
- **App**: 生成 apk/ipa 安装包