# 微信小程序部署指南

## 前置条件

- 已安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
- 已有微信公众平台小程序账号（AppID: `wxdbddd60e12144043`）
- 后端 API 已部署并可访问（`https://dda.gaowenbu.cn`）

---

## 一、微信公众平台配置

### 1.1 配置服务器域名

登录 [微信公众平台](https://mp.weixin.qq.com/) → 开发管理 → 开发设置 → 服务器域名

点击「修改」，添加以下域名：

| 类型 | 域名 |
|------|------|
| request 合法域名 | `https://dda.gaowenbu.cn` |
| uploadFile 合法域名 | `https://dda.gaowenbu.cn`（如需要） |
| downloadFile 合法域名 | `https://dingdan9471.oss-cn-beijing.aliyuncs.com`（OSS 域名） |

> ⚠️ **域名必须是 ICP 备案的，且必须是 https**

### 1.2 配置业务域名（如使用 webview）

如果小程序中有 `<web-view>` 组件，需要在「业务域名」中添加对应域名。

### 1.3 确认 AppID 一致性

当前配置中存在两个不同的 AppID：

| 位置 | AppID | 用途 |
|------|-------|------|
| `mini-app/project.config.json` | `wxdbddd60e12144043` | 小程序代码 |
| `backend/.env` 中 `WECHAT_APP_ID` | `wx84c571118b65630e` | 后端发订阅消息 |

**请确认：**
- 如果 `wx84c571118b65630e` 是另一个服务号/小程序（专门用来发消息），则无需修改
- 如果应该是同一个小程序，需要将 `backend/.env` 中的 `WECHAT_APP_ID` 改为 `wxdbddd60e12144043`，`WECHAT_APP_SECRET` 也要对应修改

---

## 二、上传小程序代码

### 2.1 打开微信开发者工具

1. 打开微信开发者工具
2. 选择「导入项目」
3. 项目目录选择 `frontend/mini-app/`
4. AppID 填写 `wxdbddd60e12144043`
5. 点击「导入」

### 2.2 检查配置

导入后确认：

- `config.js` 中 `apiBaseUrl` 是 `https://dda.gaowenbu.cn` ✅（已配置好）
- 开发者工具右上角「详情」→「基本信息」中 AppID 正确

### 2.3 本地调试

1. 点击「编译」或按 `Ctrl+B`
2. 在模拟器中测试登录、下单等功能
3. 确认 API 请求正常（在「网络」面板查看）

### 2.4 上传代码

1. 点击右上角「上传」按钮
2. 填写版本号，如 `1.0.0`
3. 填写项目备注，如 `首次部署`
4. 点击「上传」

---

## 三、提交审核与发布

### 3.1 提交审核

1. 登录 [微信公众平台](https://mp.weixin.qq.com/)
2. 管理 → 版本管理
3. 在「开发版本」中找到刚上传的版本
4. 点击「提交审核」

### 3.2 审核注意事项

- 确保小程序有完整的功能说明
- 如涉及用户登录，需要有隐私协议
- 如涉及订单/交易，需要有相关资质
- 审核一般 1-7 个工作日

### 3.3 发布上线

审核通过后：

1. 在「审核版本」中点击「全量发布」或「分阶段发布」
2. 发布后用户即可在微信中搜索使用

---

## 四、开发版本 vs 正式版本

在开发和调试阶段，可以在微信开发者工具中：

1. 点击右上角「详情」→「本地设置」
2. 勾选「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」
3. 这样可以使用 `http://127.0.0.1:8000` 进行本地调试

> ⚠️ 此选项仅在开发工具中生效，真机预览和正式版必须使用合法域名

---

## 五、真机调试

### 5.1 真机预览

1. 微信开发者工具中点击「预览」
2. 用手机微信扫码即可在真机上体验
3. 需要先在公众平台配置好服务器域名，否则请求会失败

### 5.2 真机调试

1. 点击「真机调试」
2. 可以在电脑上查看真机的 console 日志和网络请求

---

## 六、常见问题

### Q1: 真机请求失败，模拟器正常

检查公众平台「服务器域名」是否已配置 `https://dda.gaowenbu.cn`，且域名已备案。

### Q2: uploadFile 报错

检查公众平台「uploadFile 合法域名」是否配置。如果文件上传走的是 OSS 直传，需要配置 OSS 域名。

### Q3: 订阅消息发送失败

确认 `backend/.env` 中的 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET` 是否正确，以及是否在公众平台配置了订阅消息模板。

### Q4: 版本更新后用户没有生效

微信有缓存机制，发布后可能需要等待一段时间。也可以让用户删除小程序重新搜索打开。