cnbnv/PRD/linghang-PRD

Public

WeChat Login

Code Issues

Pull requests Events Packages Insights

main

Branch

Tag

浙江宙雨化工电商运营何云

feat: initialize cloud development backend system (#2)

5691b69a

2 commits

cloudbase-functions
README.md

领航咨询 H5 — 产品需求文档 (PRD)

版本: v1.0 · 日期: 2026-04-17 · 作者: Mochi (OpenClaw) 原始站点: http://h5.dzflzx.com.cn 目标: 1:1 功能复刻

一、项目概述

1.1 项目背景

对"定忠集团业务管理系统"H5 站进行 1:1 功能复刻，项目命名为"领航咨询"。面向法律咨询行业的业务管理平台，集成了服务包购买、报单管理、课程学习、团队管理、业绩追踪等功能。

1.2 技术栈识别

层级	原站技术	复刻建议
前端框架	tdesign (H5)
UI 组件库	tdesign
后端 API	CloudBase 云函数
数据库	CloudBase 云数据库
文件存储	CloudBase 云存储

1.3 用户角色

角色	说明
普通用户/法律咨询	通过邀请码注册，可购买服务包、报单、学习课程
机构用户	具备机构身份，可管理团队和业绩
管理员 (后台)	审核报单、管理课程/服务包/用户 (不在 H5 范围内)

二、功能架构

2.1 全局结构


├── 底部导航栏 (4 Tab)
│   ├── 首页 (Home)
│   ├── 普法课堂 (Course)
│   ├── 消息 (Message)
│   └── 个人中心 (Profile)
│
├── 账户模块
│   ├── 登录页 (手机号+密码)
│   ├── 注册页
│   ├── 忘记密码
│   └── 修改密码
│
├── 首页模块
│   ├── 顶部搜索栏
│   ├── 轮播图 (Banner)
│   ├── 通知公告 (可查看更多)
│   ├── 业务服务 (8 宫格入口)
│   └── 最新课程列表 (查看更多)
│
├── 普法课堂模块
│   ├── 分类筛选 Tab
│   ├── 课程列表 (图文卡片)
│   └── 课程详情页
│
├── 消息模块
│   └── 消息列表 (分页加载)
│
├── 个人中心模块
│   ├── 用户信息卡片
│   ├── 积分/套餐概览
│   ├── 快捷入口 (购买服务/我要报单)
│   └── 功能菜单列表
│
├── 业务功能页
│   ├── 购买服务
│   ├── 我的服务包
│   ├── 我要报单 (填写报单)
│   ├── 我要分享 (海报)
│   ├── 本月业绩
│   ├── 我的团队
│   ├── 我的订单
│   ├── 报单进度
│   ├── 我的课程
│   ├── 学习记录
│   ├── 我的收藏
│   ├── 我的推荐人
│   └── 修改密码
│
└── 设置页
    └── 个人信息设置

三、页面详细需求

3.1 登录页 (`/pages/account/login`)

路由参数: spid (推荐人/来源 ID)

UI 元素:

背景: 渐变色或品牌图片
Logo + 品牌名: "领航咨询"
登录方式切换: 密码登录 / 手机登录
密码登录表单:
- 手机号输入框 (数字键盘)
- 密码输入框 (支持显示/隐藏)
- 忘记密码链接
协议勾选: "我已阅读并同意《服务协议》和《隐私协议》"
登录按钮
"马上注册"链接
底部版权信息

业务逻辑:

API: POST /api/admin/auth/member-login
手机号校验: 11 位数字
密码校验: 非空
协议: 必须勾选才能登录
登录成功 → 存 Token → 跳转首页

支持 spid 参数: 用于邀请关系绑定

3.2 注册页 (`/pages/account/register`)

UI 元素:

手机号输入
验证码 (倒计时 60s)
密码设置
确认密码
邀请码 (可选, 关联推荐人)
协议勾选
注册按钮

业务逻辑:

手机号唯一性校验
验证码发送/验证
密码一致性校验
注册成功 → 自动登录 → 首页

3.3 忘记密码 (`/pages/account/forgot-password`)

手机号 + 验证码 + 新密码 + 确认密码
重置成功 → 跳转登录

3.4 首页 (`/pages/home/index`)

UI 布局:

搜索栏: "输入你想要找的课程名称"
轮播图 (Banner): 可滚动广告位
通知公告:
- 标题 + "更多"入口
- 最新 1 条公告预览
业务服务 (8 宫格, 图标+文字):
- 购买服务
- 我的服务包
- 我要报单
- 我要分享
- 本月业绩
- 我的团队
- 我的订单
- 报单进度
最新课程:
- 课程卡片列表 (封面图 + 类型标签 + 标题 + 分类 + 价格 + 节数)
- "查看更多"入口

API 调用:

POST /api/client/advert/get-list — 轮播图数据
POST /api/client/articles/get-list — 通知公告
POST /api/client/course/get-list — 最新课程

3.5 普法课堂 (`/pages/course/list`)

UI 布局:

分类 Tab: 全部 | 免费专区 | 新人必看 | 金融技术 | 法律法规
课程列表: 纵向卡片列表
- 卡片: 封面图 + 类型标签(图文/视频) + 标题 + 分类 + 会员标签 + 原价(划线) + 节数
分页加载: "没有更多了"

API:

GET /api/client/course/category/get-list — 分类列表
POST /api/client/course/get-page — 课程分页列表

3.6 课程详情页 (`/pages/course/show`)

UI 元素:

封面大图
标题 + 分类标签
会员免费 / 价格
课程简介 (富文本)
收藏按钮
购买/学习按钮

API:

GET /api/client/course/get?id=xxx — 课程详情

3.7 消息中心 (`/pages/message/index`)

UI 布局:

顶部标题: "消息中心" + 清空按钮
消息列表 (分页):
- 图标 + 标题 + 日期 + 内容摘要
消息类型:
- 报单成功/取消/退回
- 积分变更通知
- 报单审核通知

API:

POST /api/client/message/get-page — 消息分页

3.8 个人中心 (`/pages/users/index`)

UI 布局:

用户卡片:
- 头像 + 昵称 + 身份标签 (如"法律咨询")
- 邀请码 (可复制): "邀请码：10036"
- 二维码分享入口
数据概览:
- 0 套餐 | 1500 积分
快捷入口:
- 购买服务 ("查看新权益")
- 我要报单 ("查看新进度")
功能菜单 (图标+文字):
- 我的课程
- 学习记录
- 我的订单
- 报单进度
- 服务包
- 我的团队
- 我的推荐人
- 本月业绩
- 我的收藏
- 修改密码
退出登录

API:

GET /api/admin/members/get-by-user-id?userId=xxx — 用户信息
GET /api/admin/user/get-basic — 基础用户信息

3.9 购买服务 (`/pages/service/index`)

UI 布局:

顶部: "身份:法律咨询；剩余 1500 积分"
服务套餐卡片:
- VIP会员: 划线价￥399 → ￥999, 有效期 1 年, "选择"
- 法律咨询服务包: ￥8000, 8000 积分, "选择"
- 服务机构套餐: 划线价￥29800 → ￥32000, 32000 积分, "选择"
协议: "购买即视为同意《服务须知》"
"立即支付" 按钮
底部: 我的订单摘要

业务逻辑:

选择套餐 → 跳转支付页面
支持积分支付
支持第三方支付 (H5 支付)
API: POST /api/client/membership/get-list — 套餐列表
API: /client/payment/view/{id}?status=1&types=balance,h5 — 支付页面

3.10 我的服务包 (`/pages/service/combo`)

UI 布局:

数据面板: 可用积分 1500 | 累计积分 9400 | 已用积分 7900
Tab 切换: 积分使用明细 / 积分转让记录
服务包列表:
- Tab 切换: 可用 / 已使用
- 服务包卡片:
  - 名称 + 购买日期 + 序号
  - 转让状态 ("不可转让")
  - 剩余积分 / 总积分
  - "使用记录" 入口
底部: "购买服务" + "去报单"

API:

POST /api/client/members/combo/get-page — 服务包列表
POST /api/client/members/get-page — 积分明细

3.11 我要报单 (`/pages/records/edit`)

UI 布局:

表单字段:
- 业务类型 (必选): 下拉选择
- 联盟机构: 自动显示/选择
- 接单员的推荐人: 自动显示
- 客户姓名 (必填): 文本输入
- 客户电话 (必填): 数字输入
- 抵扣积分额度: 滑块/数字输入, 显示 "0 积分"
- 当前可用积分: 显示 (如 "1500 积分") + "购买服务" 入口
- 备注: 多行文本输入
"提交" 按钮
底部提示: "注：抵扣积分额度积分在修改操作下遵循多还少补原则"

API:

POST /api/client/record/type/get-list — 业务类型列表
报单提交接口

3.12 报单进度/我的订单 (`/pages/records/index`)

UI 布局:

报单列表 (分页):
- 报单编号
- 业务类型
- 客户姓名/电话
- 报单时间
- 审核状态 (待审核/已通过/已拒绝/已取消)
- 积分信息
- "详情" 入口

报单详情:

报单完整信息
状态变更记录
操作记录

API:

POST /api/account/records/get-page — 报单分页列表

3.13 我要分享 (`/pages/users/spread_user/share`)

UI 布局:

海报图片 (含用户二维码、品牌信息)
"长按上方图片保存，分享给朋友"
底部平台图标 (微信、朋友圈、QQ 等)

API:

GET /client/spread/poster/get-list — 海报模板数据

3.14 本月业绩 (`/pages/users/performance/index`)

UI 布局:

本月业绩数据汇总
业绩明细列表

API:

POST /api/client/members/performance — 业绩数据

3.15 我的团队 (`/pages/users/team/index`)

UI 布局:

团队成员列表
角色筛选 (全部/一级/二级/三级)
成员信息: 头像 + 昵称 + 角色 + 加入时间

3.16 我的课程 (`/pages/account/course/order`)

已购课程列表
学习进度

API:

POST /api/account/course/order/get-page — 已购课程

3.17 学习记录 (`/pages/users/learn_record/index`)

API:

POST /api/client/course/study/get-list — 学习记录

3.18 我的收藏 (`/pages/users/favorite/index`)

API:

POST /api/client/course/favorite/get-page — 收藏课程列表

3.19 我的推荐人 (`/pages/users/spread_user/recom`)

API:

GET /api/account/user/get-parent-base — 推荐人信息

3.20 修改密码 (`/pages/account/change-password`)

旧密码 + 新密码 + 确认新密码

3.21 通知公告列表 (`/pages/notice/list`)

公告列表 (分页)
公告详情

3.22 个人信息设置 (`/pages/account/setting/index`)

头像修改
昵称修改
其他个人信息

四、数据库设计

4.1 用户表 (users)

字段	类型	说明
_id	string	用户 ID
openid	string	微信 openid
phone	string	手机号
password	string	密码 (加密)
nickname	string	昵称
avatar	string	头像 URL
role	string	身份角色 (法律咨询/机构)
invite_code	string	自己的邀请码
parent_id	string	推荐人 ID
parent_user_id	string	推荐人 userId
spid	number	来源/推荐人 ID
points	number	可用积分
total_points	number	累计积分
used_points	number	已用积分
created_at	date	注册时间
updated_at	date	更新时间

4.2 服务包 (membership_plans)

字段	类型	说明
_id	string	套餐 ID
name	string	套餐名称
original_price	number	原价
price	number	现价
points	number	对应积分
duration	string	有效期 (如 "1 年")
type	string	类型 (VIP会员/服务包/机构套餐)
description	string	描述
is_active	boolean	是否上架
sort	number	排序

4.3 用户服务包 (user_memberships)

字段	类型	说明
_id	string	记录 ID
user_id	string	用户 ID
plan_id	string	套餐 ID
plan_name	string	套餐名称
serial_no	string	序号
total_points	number	总积分
remaining_points	number	剩余积分
is_transferable	boolean	是否可转让
status	string	状态 (可用/已使用/已过期)
created_at	date	购买时间

4.4 课程表 (courses)

字段	类型	说明
_id	string	课程 ID
title	string	标题
cover	string	封面图
type	string	类型 (图文/视频)
category_id	string	分类 ID
category_name	string	分类名称
price	number	价格
is_free	boolean	是否免费
is_member_free	boolean	会员免费
content	string	富文本内容
lesson_count	number	节数
sort	number	排序
status	number	状态 (上架/下架)

4.5 课程分类 (course_categories)

字段	类型	说明
_id	string	分类 ID
name	string	分类名
sort	number	排序

4.6 报单记录 (records)

字段	类型	说明
_id	string	报单 ID
order_no	string	报单编号
user_id	string	报单人 ID
business_type	string	业务类型
agency	string	联盟机构
parent_name	string	接单员推荐人
customer_name	string	客户姓名
customer_phone	string	客户电话
points_used	number	抵扣积分
remark	string	备注
status	string	状态 (待审核/已通过/已拒绝/已取消)
created_at	date	报单时间
updated_at	date	更新时间

4.7 积分记录 (point_records)

字段	类型	说明
_id	string	记录 ID
user_id	string	用户 ID
type	string	类型 (增加/减少)
amount	number	变动数量
balance	number	变动后余额
source	string	来源 (购买/报单/退回/管理员调整)
ref_no	string	关联单号
created_at	date	时间

4.8 消息表 (messages)

字段	类型	说明
_id	string	消息 ID
user_id	string	接收用户 ID
title	string	标题
content	string	内容
type	string	类型 (报单/积分/系统)
is_read	boolean	是否已读
created_at	date	时间

4.9 团队关系 (team_members)

字段	类型	说明
_id	string	记录 ID
user_id	string	上级用户 ID
member_id	string	成员用户 ID
level	number	层级 (1/2/3)
created_at	date	加入时间

4.10 广告/轮播图 (adverts)

字段	类型	说明
_id	string	广告 ID
image	string	图片 URL
link	string	跳转链接
sort	number	排序
is_active	boolean	是否启用

4.11 通知公告 (articles)

字段	类型	说明
_id	string	公告 ID
title	string	标题
content	string	富文本内容
created_at	date	时间

4.12 收藏表 (favorites)

字段	类型	说明
_id	string	记录 ID
user_id	string	用户 ID
course_id	string	课程 ID
created_at	date	收藏时间

4.13 学习记录 (study_records)

字段	类型	说明
_id	string	记录 ID
user_id	string	用户 ID
course_id	string	课程 ID
progress	number	学习进度 (%)
last_study_at	date	最后学习时间

五、API 接口清单

5.1 认证模块

方法	路径	说明
POST	/api/admin/auth/member-login	密码登录
POST	/api/admin/auth/sms-login	短信登录
POST	/api/admin/auth/register	注册
POST	/api/admin/auth/forgot-password	忘记密码
POST	/api/admin/auth/change-password	修改密码
POST	/api/admin/auth/send-sms	发送验证码

5.2 用户模块

方法	路径	说明
GET	/api/admin/user/get-basic	获取用户基本信息
GET	/api/admin/members/get-by-user-id	获取会员详情
POST	/api/admin/user/update	更新用户信息
GET	/api/account/user/get-parent-base	获取推荐人信息

5.3 首页模块

方法	路径	说明
GET	/api/client/config/webconfig	站点配置
POST	/api/client/advert/get-list	轮播图列表
POST	/api/client/articles/get-list	通知公告列表

5.4 课程模块

方法	路径	说明
GET	/api/client/course/category/get-list	课程分类
POST	/api/client/course/get-page	课程列表(分页)
POST	/api/client/course/get-list	最新课程
GET	/api/client/course/get	课程详情
POST	/api/client/course/favorite/get-page	收藏课程列表
POST	/api/client/course/favorite/add	添加收藏
POST	/api/client/course/favorite/remove	取消收藏
POST	/api/client/course/study/get-list	学习记录

5.5 服务包模块

方法	路径	说明
POST	/api/client/membership/get-list	套餐列表
POST	/api/client/members/combo/get-page	用户服务包列表
POST	/api/client/members/get-page	积分明细

5.6 报单模块

方法	路径	说明
POST	/api/client/record/type/get-list	业务类型列表
POST	/api/account/records/create	提交报单
POST	/api/account/records/get-page	报单列表
GET	/api/account/records/get	报单详情
POST	/api/account/records/cancel	取消报单

5.7 支付模块

方法	路径	说明
POST	/api/client/payment/create	创建支付订单
GET	/client/payment/view/{id}	支付页面
POST	/api/client/payment/notify	支付回调

5.8 消息模块

方法	路径	说明
POST	/api/client/message/get-page	消息列表
POST	/api/client/message/read	标记已读
POST	/api/client/message/clear-all	清空消息

5.9 团队与业绩

方法	路径	说明
POST	/api/client/members/team/get-page	团队成员列表
POST	/api/client/members/performance	业绩数据

5.10 分享

方法	路径	说明
GET	/client/spread/poster/get-list	海报模板
POST	/api/client/spread/qrcode	生成分享二维码

六、核心业务流程

6.1 注册-邀请流程


推荐人分享邀请码/海报 → 新用户注册填写邀请码(spid)
→ 绑定推荐关系 → 新用户自动成为推荐人的一级团队成员

6.2 服务包购买流程


浏览服务套餐 → 选择套餐 → 确认支付方式(积分/在线支付)
→ 完成支付 → 积分到账 → 服务包激活

6.3 报单流程


我要报单 → 选择业务类型 → 填写客户信息
→ 选择抵扣积分(可选) → 提交报单
→ 管理员审核(通过/拒绝) → 审核结果通知

6.4 积分流转


购买服务包 → 积分增加
提交报单 → 积分减少(按抵扣额度)
报单取消 → 积分退回
管理员调整 → 积分变更

七、非功能需求

7.1 性能

首屏加载 < 2s
列表页分页加载, 每页 10-20 条
图片懒加载

7.2 安全

Token 认证, 存储 localStorage
密码加密存储
接口防重放
敏感操作二次确认

7.3 兼容

微信小程序 + H5 双端
适配 iPhone SE ~ iPhone 15 Pro Max
适配主流 Android 机型

7.4 运维

CloudBase 云函数部署
云数据库自动备份
错误日志监控

八、页面路由清单

路由	页面名称
/pages/account/login	登录
/pages/account/register	注册
/pages/account/forgot-password	忘记密码
/pages/account/change-password	修改密码
/pages/account/setting/index	个人信息设置
/pages/home/index	首页
/pages/course/list	普法课堂(课程列表)
/pages/course/show	课程详情
/pages/message/index	消息中心
/pages/notice/list	通知公告列表
/pages/users/index	个人中心
/pages/service/index	购买服务
/pages/service/combo	我的服务包
/pages/records/edit	我要报单
/pages/records/index	报单进度/我的订单
/pages/users/spread_user/share	我要分享
/pages/users/performance/index	本月业绩
/pages/users/team/index	我的团队
/pages/users/favorite/index	我的收藏
/pages/users/learn_record/index	学习记录
/pages/users/spread_user/recom	我的推荐人

九、附件

9.1 页面截图

以下为原站各页面截图，用于复刻参考：

screenshots/login.png — 登录页
screenshots/home.png — 首页
screenshots/course-list.png — 普法课堂
screenshots/course-detail.png — 课程详情
screenshots/messages.png — 消息中心
screenshots/profile.png — 个人中心
screenshots/buy-service.png — 购买服务
screenshots/my-pack.png — 我的服务包
screenshots/submit-order.png — 我要报单
screenshots/share.png — 我要分享
screenshots/order-progress.png — 报单进度
screenshots/my-team.png — 我的团队
screenshots/monthly-perf.png — 本月业绩
screenshots/notices.png — 通知公告
screenshots/my-referrer.png — 我的推荐人
screenshots/favorites.png — 我的收藏
screenshots/learning.png — 学习记录

About

No description, topics, or website provided.

200.00 KiB

0 forks 0 stars 2 branches 0 TagREADME

Release
0

Tag

Contributors
1

Language

JavaScript100%

35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen

京ICP备11018762号-111

领航咨询 H5 — 产品需求文档 (PRD)

一、项目概述

1.1 项目背景

1.2 技术栈识别

1.3 用户角色

二、功能架构

2.1 全局结构

三、页面详细需求

3.1 登录页 (/pages/account/login)

3.2 注册页 (/pages/account/register)

3.3 忘记密码 (/pages/account/forgot-password)

3.4 首页 (/pages/home/index)

3.5 普法课堂 (/pages/course/list)

3.6 课程详情页 (/pages/course/show)

3.7 消息中心 (/pages/message/index)

3.8 个人中心 (/pages/users/index)

3.9 购买服务 (/pages/service/index)

3.10 我的服务包 (/pages/service/combo)

3.11 我要报单 (/pages/records/edit)

3.12 报单进度/我的订单 (/pages/records/index)

3.13 我要分享 (/pages/users/spread_user/share)

3.14 本月业绩 (/pages/users/performance/index)

3.15 我的团队 (/pages/users/team/index)

3.16 我的课程 (/pages/account/course/order)

3.17 学习记录 (/pages/users/learn_record/index)

3.18 我的收藏 (/pages/users/favorite/index)

3.19 我的推荐人 (/pages/users/spread_user/recom)

3.20 修改密码 (/pages/account/change-password)

3.21 通知公告列表 (/pages/notice/list)

3.22 个人信息设置 (/pages/account/setting/index)

四、数据库设计

4.1 用户表 (users)

4.2 服务包 (membership_plans)

4.3 用户服务包 (user_memberships)

4.4 课程表 (courses)

4.5 课程分类 (course_categories)

4.6 报单记录 (records)

4.7 积分记录 (point_records)

4.8 消息表 (messages)

4.9 团队关系 (team_members)

4.10 广告/轮播图 (adverts)

4.11 通知公告 (articles)

4.12 收藏表 (favorites)

4.13 学习记录 (study_records)

五、API 接口清单

5.1 认证模块

5.2 用户模块

5.3 首页模块

5.4 课程模块

5.5 服务包模块

5.6 报单模块

5.7 支付模块

5.8 消息模块

5.9 团队与业绩

5.10 分享

六、核心业务流程

6.1 注册-邀请流程

6.2 服务包购买流程

6.3 报单流程

6.4 积分流转

七、非功能需求

7.1 性能

7.2 安全

7.3 兼容

7.4 运维

八、页面路由清单

九、附件

9.1 页面截图

About

Release0

Contributors1

3.1 登录页 (`/pages/account/login`)

3.2 注册页 (`/pages/account/register`)

3.3 忘记密码 (`/pages/account/forgot-password`)

3.4 首页 (`/pages/home/index`)

3.5 普法课堂 (`/pages/course/list`)

3.6 课程详情页 (`/pages/course/show`)

3.7 消息中心 (`/pages/message/index`)

3.8 个人中心 (`/pages/users/index`)

3.9 购买服务 (`/pages/service/index`)

3.10 我的服务包 (`/pages/service/combo`)

3.11 我要报单 (`/pages/records/edit`)

3.12 报单进度/我的订单 (`/pages/records/index`)

3.13 我要分享 (`/pages/users/spread_user/share`)

3.14 本月业绩 (`/pages/users/performance/index`)

3.15 我的团队 (`/pages/users/team/index`)

3.16 我的课程 (`/pages/account/course/order`)

3.17 学习记录 (`/pages/users/learn_record/index`)

3.18 我的收藏 (`/pages/users/favorite/index`)

3.19 我的推荐人 (`/pages/users/spread_user/recom`)

3.20 修改密码 (`/pages/account/change-password`)

3.21 通知公告列表 (`/pages/notice/list`)

3.22 个人信息设置 (`/pages/account/setting/index`)

Release
0

Contributors
1