# 名导精讲 uni-app 小程序

这是“名导精讲”景区导游讲解预约项目的 uni-app 小程序工程。当前主要完成用户端小程序页面、交互原型和部分演示流程，后续准备接入后端管理系统、真实接口、微信支付和 App 端。

## 快速开始

```bash
npm install
npm run dev:mp-weixin
npm run build:mp-weixin
```

微信开发者工具导入构建产物：

```text
dist/build/mp-weixin
```

## 主工程结构

```text
pages/                  小程序页面
components/             业务组件
constants/              当前 mock 配置和静态数据
services/               接口封装入口
static/ui-icons/        通用图标
static/pencil-icons/    Pencil 导出的图标资源
docs/                   开发和交接文档
```

## 当前主要页面

- `pages/home/index.vue`：首页地图、服务抽屉、下单流程。
- `pages/scenic-select/index.vue`：景区选择与搜索。
- `pages/mine/index.vue`：我的。
- `pages/orders/index.vue`：我的订单。
- `pages/order-pending-pay/index.vue`：待付款。
- `pages/order-waiting/index.vue`：等待接单。
- `pages/order-pending-guide/index.vue`：待讲解。
- `pages/order-serving/index.vue`：讲解中。
- `pages/order-pending-review/index.vue`：待评价。
- `pages/order-completed/index.vue`：已完成。
- `pages/order-canceled/index.vue`：已取消。
- `pages/order-review-detail/index.vue`：查看评价。

## 交接文档

- [开发说明](docs/开发说明.md)
- [功能需求清单](docs/功能需求清单.md)
- [接口与数据模型草案](docs/接口与数据模型草案.md)
- [后续 Agent 接手说明](docs/后续Agent接手说明.md)

## 当前注意事项

- 当前大量业务数据仍是前端 mock，正式开发需要接后端接口。
- 首页地图使用微信小程序原生 `map`；高德 SDK 当前用于定位后的逆地理解析。
- 等待接单页目前 5 秒自动进入待讲解页，只是演示流程，正式应改为订单状态接口或推送驱动。
- 所有中文源码、配置和 Markdown 必须保持 UTF-8 编码。