89 lines
2.1 KiB
Markdown
89 lines
2.1 KiB
Markdown
# 接入 HashMall 商城
|
||
|
||
独立项目验证完成后，将 `src/pages/customer-service`、`src/components/customer-service`、`src/api`、`src/services`、`src/config`、`src/adapters` 和客服静态资源合入商城工程。
|
||
|
||
## 1. 注册页面
|
||
|
||
建议在商城 `pages.json` 中将客服页放入分包：
|
||
|
||
```json
|
||
{
|
||
"root": "pages/customer_service_package",
|
||
"pages": [
|
||
{
|
||
"path": "chat/chat",
|
||
"style": {
|
||
"navigationBarTitleText": "在线客服",
|
||
"navigationBarBackgroundColor": "#FFFFFF",
|
||
"navigationBarTextStyle": "black"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
合入分包时需要同步调整 `hashmall.js` 中的 `CHAT_ROUTE` 和页面内 `@/` 引用路径。
|
||
|
||
## 2. 初始化商城适配
|
||
|
||
商城启动后设置登录页。应用级 Authorization 应由商城现有配置注入，不要复制到客服源码或提交 Git。
|
||
|
||
```js
|
||
configureHashMallIntegration({
|
||
loginPage: '/pages/login_package/login/login',
|
||
appAuthorization: Authorization
|
||
})
|
||
```
|
||
|
||
客服请求会继续读取商城已有的：
|
||
|
||
- Token：`fcc-token`
|
||
- 用户缓存：`fcc-user-data`
|
||
- 用户详情接口：`/user/getUserInfo`
|
||
|
||
## 3. “我的”页入口
|
||
|
||
把当前客服电话弹窗或第三方客服跳转替换为：
|
||
|
||
```js
|
||
openCustomerService()
|
||
```
|
||
|
||
## 4. 商品详情入口
|
||
|
||
```js
|
||
openProductConsultation({
|
||
goodsId: goods.id,
|
||
goodsName: goods.name,
|
||
goodsMainGraph: goods.mainGraph,
|
||
currentPrice: goods.currentPrice
|
||
})
|
||
```
|
||
|
||
页面只把该对象作为待发送预览。正式发送前后端仍需按 `goodsId` 校验并补齐可信商品信息。
|
||
|
||
## 5. 订单入口
|
||
|
||
```js
|
||
openOrderConsultation({
|
||
id: order.id,
|
||
orderNo: order.orderNo,
|
||
goodsName: order.goodsName,
|
||
goodsMainGraph: order.goodsMainGraph,
|
||
payAmount: order.payAmount
|
||
})
|
||
```
|
||
|
||
正式发送前后端必须校验订单归属当前登录用户。
|
||
|
||
## 6. 小程序配置
|
||
|
||
微信公众平台需要配置测试或正式环境的：
|
||
|
||
- request 合法域名
|
||
- socket 合法域名
|
||
- uploadFile 合法域名
|
||
- downloadFile 合法域名
|
||
|
||
测试环境 API 为 `https://api.o.tbmall.xin`，Socket 使用对应的 `wss://api.o.tbmall.xin`。
|