领航咨询服务系统 — 心理咨询/课程预约平台，含 C 端 H5 + 运营管理后台，基于 Vue 3 + 腾讯云开发 CloudBase。
Forked from cnbvv/lhzx-h5
| 子项目 | 说明 | 技术栈 |
|---|---|---|
| lhzx-h5/ | C 端 H5 客户端 | Vue 3.5 + Vite 8 + TDesign Mobile + CloudBase JS SDK + Pinia |
| lhzx-admin/ | 运营管理后台 | Vue 3.5 + Vite 5 + TDesign + ECharts + Tailwind CSS + Pinia |
后端完全基于腾讯云开发 CloudBase，使用云函数 + NoSQL 数据库，无需自建服务器。
- 🏠 首页 — 课程推荐、服务入口
- 📖 课程 — 课程列表、课程详情、在线报名
- 🛒 报单/下单 — 创建订单、查看订单列表
- 💰 积分 — 积分账本、积分兑换商品、积分兑换 VIP
- 👤 个人中心 — 用户资料、消息通知
- 📊 数据看板 — 用户增长、积分流水、报单状态、课程热度（ECharts 图表）
- 👥 用户管理 — 用户列表/详情、积分调整、VIP 管理
- 📋 报单管理 — 报单审核、状态流转
- 📝 操作日志 — 所有管理操作可追溯
- 🔐 权限控制 — 超级管理员 / 运营管理员 / 咨询师 三级角色
┌─────────────────────────────────────────────┐
│ 前端 │
│ ┌──────────────┐ ┌──────────────────────┐ │
│ │ H5 客户端 │ │ 管理后台 │ │
│ │ Vue 3 + Vite │ │ Vue 3 + TDesign │ │
│ │ TDesign Mobile│ │ + ECharts + Tailwind│ │
│ └──────┬───────┘ └──────────┬───────────┘ │
│ │ │ │
│ @cloudbase/js-sdk @cloudbase/js-sdk │
└─────────┼─────────────────────┼──────────────┘
│ │
┌─────────▼─────────────────────▼──────────────┐
│ CloudBase 云端 │
│ ┌──────────────┐ ┌──────────────────────┐ │
│ │ 云函数 ×18 │ │ 管理云函数 ×11 │ │
│ │ (客户端) │ │ (admin*) │ │
│ └──────┬───────┘ └──────────┬───────────┘ │
│ │ │ │
│ ┌──────▼─────────────────────▼───────────┐ │
│ │ NoSQL 数据库 (12+ 集合) │ │
│ │ users / orders / courses / points ... │ │
│ └────────────────────────────────────────┘ │
│ │
│ CloudBase 原生 Auth（短信验证码 / 密码登录） │
└───────────────────────────────────────────────┘
| 端 | 方式 | 实现 |
|---|---|---|
| H5 客户端 | 用户名 + 密码（原短信验证码，已重构） | CloudBase Auth SDK |
| 管理后台 | 管理员账号密码 | adminLogin 云函数 |
| 微信小程序 | 微信登录（上游仓库保留） | login 云函数 |
| 函数 | 用途 |
|---|---|
login | 微信登录 |
syncCloudBaseUser | 原生 Auth 登录后同步到 users 集合 |
sendSmsCode | 短信验证码（已被原生 Auth 替代，可移除） |
getUserInfo | 获取用户信息 |
updateUserProfile | 更新用户资料 |
getCourseList | 课程列表 |
getCourseDetail | 课程详情 |
enrollCourse | 课程报名 |
getServiceList | 服务列表 |
createOrder | 创建订单 |
getOrderList | 订单列表 |
reviewOrder | 订单审核 |
getPointLedger | 积分流水 |
exchangePointsItem | 积分兑换商品 |
exchangeVip | 积分兑换 VIP |
getMessages | 消息列表 |
markMessageRead | 标记消息已读 |
common | 公共工具模块 |
| 函数 | 用途 |
|---|---|
adminLogin | 管理员登录 |
adminGetDashboard | 数据看板 |
adminQueryUsers | 用户查询 |
adminGetUserDetail | 用户详情 |
adminGrantPoints | 积分发放 |
adminQueryOrders | 报单查询 |
adminGetOrderDetail | 报单详情 |
adminReviewOrder | 报单审核 |
adminQueryPointLedger | 积分流水查询 |
adminQueryPointExchanges | 积分兑换查询 |
adminQueryLogs | 操作日志查询 |
| 集合 | 说明 |
|---|---|
users | 用户信息（角色、积分、VIP） |
orders | 报单/订单 |
courses | 课程 |
chapters | 课程章节 |
enrollments | 课程报名 |
services | 服务项目 |
messages | 消息通知 |
point_ledger | 积分流水 |
point_exchanges | 积分兑换记录 |
sessions | 会话记录 |
coupons | 优惠券 |
├── lhzx-h5/ # H5 客户端
│ ├── src/
│ │ ├── pages/ # 页面（home/login/courses/order/points-*/profile）
│ │ ├── components/ # 公共组件
│ │ ├── layouts/ # 布局
│ │ ├── router/ # 路由
│ │ ├── stores/ # Pinia 状态管理
│ │ ├── utils/ # 工具函数（cloudbase/api/auth）
│ │ └── config/ # 配置
│ ├── cloudfunctions/ # 客户端云函数 ×18
│ ├── database/ # 数据库 Schema（JSON Schema）
│ └── docs/ # 文档
├── lhzx-admin/ # 管理后台
│ ├── src/
│ │ ├── views/ # 页面（Dashboard/Users/Orders/Points/Logs）
│ │ ├── api/ # API 调用
│ │ ├── router/ # 路由
│ │ ├── stores/ # Pinia 状态管理
│ │ ├── layouts/ # 后台布局
│ │ └── lib/ # 工具库
│ ├── cloudfunctions/ # 管理云函数 ×11
│ └── scripts/ # 脚本
├── rules/ # 业务规则
├── config/ # 配置
├── specs/ # PRD / 规格文档
├── codebuddy-plugin/ # CodeBuddy 插件
└── 领航咨询后端管理后台PRD.md # 管理后台 PRD
- Node.js ≥ 18
- 腾讯云开发 CloudBase 环境（需开通短信登录）
- 环境变量：
ENV_ID、VITE_CLOUDBASE_ACCESS_KEY
cd lhzx-h5
cp .env.example .env # 填入 CloudBase ENV_ID 和 AccessKey
npm install
npm run dev # http://localhost:5173
cd lhzx-admin
cp .env.example .env # 填入 CloudBase ENV_ID
npm install
npm run dev # http://localhost:5174
# H5
cd lhzx-h5 && npm run build
# Admin
cd lhzx-admin && npm run build
静态文件部署到 CloudBase 静态托管，云函数通过 CloudBase CLI 或控制台部署。
# 安装 CloudBase CLI
npm i -g @cloudbase/cli
# 部署云函数
tcb fn deploy <function-name> -e <env-id>
私有项目，未开源。
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
