Files
wxapp_escort/doc/PROJECT_GUIDE.md
T
2026-10-06 17:58:18 +08:00

60 lines
2.3 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 封装(基址、appId、token 头)
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/attendantlist` | 陪诊师列表 |
| `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/hospital/contact` | 医院联系 |
| `pages/hospital/ranking` | 医院排行 |
| `pages/home/webview` | 网页容器 |
## 约定
- **配色**:见 `doc/DESIGN.md`。色板令牌集中在 `app.wxss` 的 `page{}`,改配色只改这一处。
- **接口**:统一走 `utils/request.js`,基址 `https://api.huashengtec.com`(本地调试可改用文件内注释的 `127.0.0.1:9004`);请求自动携带 `appId=wxapp-escort` 与登录 token。
- **登录**:`app.js` 的 `onShow` 调 `wx.login` 换 token,存于 `globalData.user`。
- **全局数据**:服务列表 / 协议 / 医院信息 / 排行在 `onLaunch` 预取,挂到 `globalData` 供各页取用。