Files
wxapp_escort/doc/PROJECT_GUIDE.md
T
lik 0eb8578a30 refactor: 环境开关与服务基址收敛到 utils/config.js
- 新增 utils/config.js:DEBUG 一处控制 health/user/ws 三个服务的本地与线上地址,
  顺带集中 appId、识别链路超时、WS 心跳与重连参数
- request.js / api.js / chatmsg.js 改为从 config 取值,删除各自硬编码的基址
- 修正本地调试时聊天 WS 仍连线上导致 token 查不到用户的问题
- PROJECT_GUIDE 同步接口与配置约定
2026-10-31 18:50:22 +08:00

57 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 暖橙陪诊小程序
陪诊服务的微信小程序,基于微信原生框架 + TDesign 组件库。
## 技术栈
- 微信小程序原生框架
- `tdesign-miniprogram` ^1.9.2(依赖 `package.json`,构建产物在 `miniprogram_npm/`)
- 基础库 3.15.2(`project.config.json`),最低 ≥ 2.12.0
## 运行
1. `npm install`
2. 微信开发者工具导入本项目目录 `ui/wxapp_escort`
3. 工具栏 `工具 → 构建 npm`
4. 编译预览
## 目录结构
```
app.js / app.json / app.wxss 全局入口、页面与 tabBar 配置、色板令牌
custom-tab-bar/ 自定义底部导航(fixed 在底部,各 tab 页需自备底部占位)
pages/ 页面(清单见下)
utils/
request.js HTTP 封装(基址、登录 token 头、401 静默重登)
api.js 接口定义
chatmsg.js AI 客服 WebSocket
doc/
DESIGN.md 配色规范(全站唯一色板来源)
PROJECT_GUIDE.md 本文件
```
## 页面
| 路径 | 说明 |
|---|---|
| `pages/home/index` | 首页 |
| `pages/ai/aichat` | AI 客服 |
| `pages/escort/itemlist` | 陪诊服务列表 |
| `pages/escort/itemdetail` | 服务详情 / 下单 |
| `pages/escort/recordlist` | 订单记录 |
| `pages/escort/recorddetail` | 订单详情 |
| `pages/escort/agreement` | 用户协议 |
| `pages/escort/guide` | 服务指南 |
| `pages/health/profilelist` | 就诊人列表 |
| `pages/health/profileedit` | 就诊人编辑 |
| `pages/mine/mine` | 我的 |
| `pages/mine/about` | 关于 |
| `pages/mine/contact` | 联系我们 |
| `pages/mine/business` | 合作与入驻(商务合作 / 陪诊师入驻 / 陪诊师培训,入口自首页与「我的」页页脚) |
## 约定
- **配色**:见 `doc/DESIGN.md`。色板令牌集中在 `app.wxss` 的 `page{}`,改配色只改这一处。
- **接口**:统一走 `utils/request.js`,环境开关、服务基址、`appId` 与网络参数集中在 `utils/config.js`(`DEBUG` 置 `true` 时直连本机 `127.0.0.1:9004/9010/9005`,线上走 `https://api.huashengtec.com`);请求自动携带 `appId=wxapp-escort` 与登录 token,遇 401 静默重登并重试一次。`appId` 是服务端在 `conf.json` 里选 appid/secret 的键,不能删。
- **登录**:`app.js` 的 `onShow` 调 `wx.login` 换 token,存于 `globalData.user`。
- **全局数据**:服务列表 / 协议在 `onLaunch` 以 Promise 预取,页面通过 `loadServices()` / `loadAgreement()` / `waitForAuth()` 消费就绪结果,失败后可重试。