Files
wxapp_escort/doc/PROJECT_GUIDE.md
T
2026-11-03 16:58:09 +08:00

2.6 KiB
Raw Blame History

暖橙陪诊小程序

陪诊服务的微信小程序,基于微信原生框架 + 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                   陪诊助手 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() 消费就绪结果,失败后可重试。