下面按可以直接交给产品、前端、后端和测试使用的方式整理。对于目前通过黑盒检查确认的内容，我标记为“现状”；无法从前端确认的后端规则，标记为“待后端确认”，避免把推测当成既定需求。

会员推荐关系 + 新零售商城系统开发文档

文档版本： V1.0
文档类型： 产品/技术开发规格说明
适用角色： 产品、UI/UX、前端、后端、测试、运维、安全
系统形态： 移动 Web / 服务端渲染 MPA
当前文档依据： 登录后前端黑盒检查结果
说明： 本文档用于建立第一版开发基线，不代表已完成后端源码、数据库、支付网关及管理后台审计。

1. 项目概述

1.1 系统定位

本系统由两个业务子系统组成：

纯文本复制⌃会员推荐关系平台
├── 登录
├── 会员中心
├── 邀请注册
├── 会员等级升级
├── 下级升级审核
└── 团队管理

新零售商城
├── 商城首页
├── 分类/专区
├── 商品详情
├── 购物车
├── 收货地址
├── 订单
├── 资产/积分
├── 积分转账
├── 提现
├── 收藏
├── 关注
└── 浏览记录

整体业务关系：

纯文本复制⌃用户
  │
  ├── 注册/登录
  │
  ├── 会员体系
  │    ├── 当前会员等级
  │    ├── 推荐关系
  │    ├── 申请升级
  │    ├── 审核下级
  │    └── 查看团队
  │
  └── 商城体系
       ├── 浏览商品
       ├── 加入购物车
       ├── 提交订单
       ├── 支付
       ├── 收货
       └── 积分资产

2. 技术现状

2.1 前端现状

现有系统属于传统多页面移动 Web：

• 服务端渲染 MPA
• 普通 URL 跳转 + 整页刷新
• jQuery AJAX 进行局部数据提交
• 使用 RequireJS
• 使用 WeUI
• 使用 Bootstrap
• 使用 Font Awesome
• 使用 Swiper
• 使用 tmodjs
• 多套历史 CSS / JS 并存
• 存在 javascript: 形式的交互链接

主要路由形态：

纯文本复制⌃/mob/ucenter
/mob/UCenter/...
/mob/Catalog/...
/mob/account/...

2.2 推荐的新版本架构

如果此次是“重构旧系统”，建议保持 MPA/服务端渲染模式，避免为了技术升级直接引入 SPA，第一阶段重点解决业务、权限、安全和体验统一。

建议：

纯文本复制⌃Browser
   │
   ▼
Nginx / CDN
   │
   ▼
Web Application
   ├── Auth
   ├── Member
   ├── Team
   ├── Upgrade
   ├── Mall
   ├── Order
   ├── Asset
   └── Account
        │
        ▼
     Database
        │
        ├── User
        ├── Member
        ├── Relation
        ├── Product
        ├── Order
        └── Asset

3. 用户角色与权限

3.1 角色定义

游客

未登录用户。

权限：

• 浏览登录页
• 注册
• 浏览注册页
• 访问公开商城内容（是否允许需产品确认）

普通会员

已经登录的用户。

权限：

• 查看个人中心
• 查看会员等级
• 邀请/帮助注册
• 申请升级
• 查看商城
• 加购
• 下单
• 查看订单
• 查看资产
• 管理收货地址
• 收藏/关注/浏览记录

具备审核权限的会员

当前检查账号存在该能力。

额外权限：

• 查看下级升级申请
• 查看申请成员信息
• 同意升级
• 拒绝升级

管理员

本次检查没有覆盖管理后台。

需要单独定义：

• 用户管理
• 等级管理
• 推荐关系管理
• 商品管理
• 订单管理
• 财务管理
• 积分管理
• 审核日志
• 系统配置

4. 会员等级体系

现有业务呈现为逐级升级。

例如：

纯文本复制⌃一星会员
   ↓
二星会员
   ↓
三星会员
   ↓
...

4.1 升级规则

当前检查结果：

当前等级只能申请下一等级。

因此前端不能允许：

纯文本复制⌃一星 → 三星
一星 → 五星

正确流程：

纯文本复制⌃当前等级 = N
允许升级等级 = N + 1

4.2 后端必须强制校验

前端隐藏按钮不等于安全控制。

后端必须校验：

纯文本复制⌃当前用户是否登录
↓
当前用户是否有会员身份
↓
当前等级是否允许升级
↓
目标等级是否 = 当前等级 + 1
↓
是否已经存在未处理申请
↓
是否满足升级条件
↓
创建升级申请

5. 推荐关系体系

5.1 推荐关系

注册时支持通过 URL 中的 tid 指定推荐人。

示例：

纯文本复制⌃/register?tid=10001

页面进入后：

纯文本复制⌃URL tid
   ↓
读取推荐人
   ↓
显示/预填邀请码
   ↓
用户完成注册
   ↓
创建 User
   ↓
创建推荐关系

5.2 推荐关系数据要求

建议不要只在用户表保存一个简单邀请码，而是建立独立关系模型：

纯文本复制⌃member_relation

id
parent_user_id
child_user_id
relation_level
created_at
status

其中：

• parent_user_id：推荐人
• child_user_id：被推荐人
• relation_level：关系层级
• status：关系状态

即便当前页面只展示直接下级，也应为以后扩展多级团队保留数据结构。

6. 全局导航结构

建议新版本统一为：

纯文本复制⌃工作台
商城
团队
订单
我的

对应：

纯文本复制⌃工作台
├── 会员等级
├── 升级
├── 审核
├── 邀请
└── 公告

商城
├── 首页
├── 分类
├── 专区
├── 商品
└── 购物车

团队
├── 团队概况
└── 团队成员

订单
├── 全部
├── 待付款
├── 待发货
├── 待收货
└── 已完成

我的
├── 会员资料
├── 资产
├── 收藏
├── 关注
├── 浏览记录
├── 收货地址
├── 设置
└── 客服

7. 页面清单

以上建议路由是新版本规划，不表示现网站一定使用这些完整路径。

8. 页面详细功能与逻辑

P01 登录页

页面目标

完成用户身份认证。

页面元素

• 手机号/账号
• 密码
• 登录按钮
• 注册入口
• 忘记密码入口
• 推荐注册入口

核心逻辑

纯文本复制⌃输入账号密码
      ↓
前端基本校验
      ↓
POST 登录接口
      ↓
服务端验证
      ↓
创建登录会话
      ↓
跳转 /mob/ucenter

后端要求

必须：

• HTTPS
• 密码不可明文存储
• 密码哈希使用安全算法
• 登录失败限流
• 防暴力破解
• Session/Token 安全
• Cookie 设置 Secure
• HttpOnly
• SameSite
• 登录日志

异常

纯文本复制⌃账号不存在
密码错误
账号被禁用
登录频率过高
系统异常

P02 注册页

注册字段

现状确认：

• 手机号
• 微信号
• 姓名
• 密码
• 确认密码
• 推荐人/邀请码

当前前端未看到短信验证码或图形验证码。

建议流程

纯文本复制⌃打开注册页
   ↓
读取 tid
   ↓
解析推荐人
   ↓
填写注册信息
   ↓
验证手机号
   ↓
验证密码
   ↓
提交
   ↓
创建用户
   ↓
创建会员
   ↓
建立推荐关系
   ↓
注册成功

后端必须校验

不能信任前端传入的：

• 推荐人 ID
• 会员等级
• 用户 ID
• 注册状态

P03 帮助注册页

功能

用于推荐人协助新用户完成注册。

核心参数

纯文本复制⌃tid = 推荐人 ID

页面逻辑

纯文本复制⌃链接进入
 ↓
读取 tid
 ↓
查询推荐人
 ↓
展示推荐人信息
 ↓
用户填写注册信息
 ↓
完成注册

异常

纯文本复制⌃tid 不存在
tid 已失效
推荐关系无法建立
推荐人被禁用

P04 会员中心 /mob/ucenter

页面定位

会员系统的工作台。

页面内容

建议包含：

纯文本复制⌃会员头像
姓名
会员等级
推荐码
公告
邀请注册
申请升级
审核下级
团队
进入商城

现有界面为：

纯文本复制⌃蓝色插画头部
会员信息
公告区域
2 × 3 功能宫格

按钮显示规则

纯文本复制⌃等级信息
    ↓
计算当前权限
    ↓
显示对应功能

例如：

纯文本复制⌃有升级权限 → 显示“申请升级”
有审核权限 → 显示“审核”
有团队权限 → 显示“团队”

但最终权限必须由后端决定。

P05 会员升级申请页

功能

申请升级到下一会员等级。

页面字段

• 当前等级
• 目标等级
• 升级说明
• 提交按钮
• 当前审核状态

现有接口

http复制⌃POST /mob/UCenter/sqsj_ck_save

当前前端提交时存在用户 ID 参数。

新版本建议

不要由浏览器决定：

纯文本复制⌃user_id
current_level
target_level

服务端应该从登录 Session 获取用户。

请求示例：

json复制⌃{
  "remark": ""
}

服务端自行读取：

纯文本复制⌃currentUserId
currentLevel
targetLevel

状态

建议：

纯文本复制⌃未申请
待审核
已通过
已拒绝
已取消

流程：

纯文本复制⌃未申请
 ↓
提交
 ↓
待审核
 ├── 同意 → 已通过
 └── 拒绝 → 已拒绝

P06 升级历史页

功能

展示所有升级申请记录。

列表字段

空状态

不能只留白。

应显示：

纯文本复制⌃暂无升级申请记录

并提供返回会员中心入口。

P07 下级升级审核页

功能

审核有权限成员的直接下级升级申请。

列表字段

• 姓名
• 手机号
• 微信号
• 当前等级
• 申请等级
• 申请时间
• 状态

权限

必须满足：

纯文本复制⌃当前用户已登录
AND
具有审核权限

重点安全要求

前端虽然可以提交申请 ID：

纯文本复制⌃request_id

但服务端必须检查：

纯文本复制⌃request_id 是否存在
↓
该申请是否待审核
↓
申请人是否属于当前审核人的授权范围
↓
当前审核人是否具有对应等级审核权限

否则存在越权审核风险。

P08 升级审核详情页

页面内容

纯文本复制⌃申请人资料
当前会员等级
申请目标等级
申请时间
联系方式
申请说明
审核历史

操作

纯文本复制⌃同意
拒绝

现有前端动作码：

纯文本复制⌃90 = 同意
30 = 拒绝

现有接口

http复制⌃POST /mob/UCenter/sqsj_ck_update

新版本建议

不要继续使用魔法数字。

推荐：

json复制⌃{
  "request_id": 10001,
  "action": "approve",
  "remark": ""
}

或：

纯文本复制⌃approve
reject

审核成功后

同意：

纯文本复制⌃升级申请 → 已通过
会员等级 → +1
审核记录 → 写入
操作人 → 写入
操作时间 → 写入

拒绝：

纯文本复制⌃升级申请 → 已拒绝
会员等级不变
写入拒绝原因

整个升级动作必须事务化。

P09 团队成员页

功能

查看推荐团队成员。

现状：

• 展示直接成员数量
• 展示成员等级
• 展示联系方式
• 暂无复杂多层级树

建议字段

纯文本复制⌃成员
会员等级
注册时间
状态
联系方式

隐私要求

不要完整显示：

纯文本复制⌃13812345678

建议：

纯文本复制⌃138****5678

微信号也根据业务需要脱敏。

后续扩展

可增加：

纯文本复制⌃一级团队
二级团队
三级团队
团队总人数
等级分布
注册趋势

P10 商城首页

页面目标

商品浏览和商城入口。

当前视觉

• 高饱和圆形图标
• 三列商品网格
• 红色价格
• 固定底部导航

建议内容

纯文本复制⌃搜索
Banner
专区
分类
推荐商品
热销商品
最新商品

商品卡片

纯文本复制⌃商品图
商品名称
价格
销量
积分抵扣

P11 分类页

功能

展示商品分类。

页面结构

纯文本复制⌃一级分类
   ↓
二级分类
   ↓
商品列表

功能

• 分类切换
• 商品排序
• 商品筛选
• 分页/无限滚动

P12 专区页

功能

展示运营配置的专题专区。

例如：

纯文本复制⌃新品专区
热销专区
推荐专区
品牌专区

专区应由后台配置，而不是写死在前端。

P13 商品详情页

页面内容

纯文本复制⌃商品图片
商品名称
售价
积分抵扣规则
库存
规格
商品描述
购买数量
收藏
加入购物车
立即购买

操作逻辑

加入购物车

纯文本复制⌃选择规格
 ↓
检查库存
 ↓
写入/更新购物车
 ↓
提示加入成功

立即购买

纯文本复制⌃选择规格
 ↓
选择数量
 ↓
检查库存
 ↓
进入确认订单

合规要求

当前商品详情存在较多医疗/健康功效描述。

开发阶段不应直接默认沿用原文案。

商品宣传文案应经过业务/法务审核，并建立后台内容审核机制。

P14 购物车

功能

管理待购买商品。

页面内容

纯文本复制⌃商品
规格
数量
单价
小计
选择框
全选
删除
合计
去结算

计算

纯文本复制⌃商品小计 = 商品单价 × 数量

订单商品金额
= Σ 商品小计

积分抵扣
= 按系统积分规则计算

最终应付
= 商品金额 - 优惠 - 积分抵扣

当前页面口径：

纯文本复制⌃100 积分 = 1 元抵扣

最终结算金额必须由服务端重新计算。

P15 收货地址列表

功能

管理收货地址。

页面内容

纯文本复制⌃收货人
手机号
省市区
详细地址
默认地址
编辑
删除
新增地址

规则

纯文本复制⌃只能有一个默认地址

修改默认地址时：

纯文本复制⌃旧默认地址 → false
新默认地址 → true

应使用数据库事务。

P16 地址编辑页

字段

• 收货人姓名
• 手机号
• 省
• 市
• 区
• 详细地址
• 是否默认

校验

• 收货人不能为空
• 手机号格式正确
• 地址不能为空
• 长度限制
• 特殊字符处理

P17 确认订单页

页面内容

纯文本复制⌃收货地址
商品
规格
数量
商品金额
运费
优惠
积分抵扣
应付金额
提交订单

核心流程

纯文本复制⌃购物车/立即购买
 ↓
读取当前地址
 ↓
重新获取商品价格
 ↓
重新验证库存
 ↓
重新计算积分
 ↓
生成订单
 ↓
锁定库存
 ↓
进入支付

不能直接信任前端：

纯文本复制⌃price
discount
points
total

P18 订单列表

现有商城个人中心提供：

纯文本复制⌃待付款
待收货
订单

建议扩展：

纯文本复制⌃全部
待付款
待发货
待收货
已完成
售后

页面状态

每个订单显示：

纯文本复制⌃订单编号
下单时间
商品
数量
金额
订单状态
操作按钮

P19 订单详情

页面内容

纯文本复制⌃订单状态
订单编号
下单时间
支付时间
发货时间
收货时间

商品信息

收货地址

费用明细
商品金额
运费
优惠
积分抵扣
实付金额

操作记录

状态建议

纯文本复制⌃待付款
   ↓
已付款/待发货
   ↓
已发货
   ↓
待收货
   ↓
已完成

异常状态：

纯文本复制⌃已取消
退款中
已退款

P20 商城个人中心

功能

商城侧用户总入口。

现有模块包括：

纯文本复制⌃待付款
待收货
订单
资产
资料
地址
关注
收藏
浏览记录

建议页面统一为：

纯文本复制⌃用户信息
会员等级
订单状态入口
资产
地址
收藏
关注
浏览记录
设置
客服

P21 资产中心

当前业务模型

商城资产采用积分模型。

页面提示：

纯文本复制⌃100 积分抵扣 1 元

页面内容

纯文本复制⌃当前积分
可用积分
冻结积分
积分明细
转账
提现

建议增加积分流水

每一次资产变化都必须记录：

纯文本复制⌃流水 ID
用户 ID
变动类型
变动前余额
变动金额
变动后余额
关联业务单号
备注
时间

例如：

纯文本复制⌃购物抵扣
积分转入
积分转出
奖励
人工调整
提现
冻结
解冻

P22 积分转账

功能

会员之间转移积分。

建议流程

纯文本复制⌃输入对方账号
 ↓
查询目标用户
 ↓
显示目标用户脱敏信息
 ↓
输入积分数量
 ↓
验证余额
 ↓
确认转账
 ↓
生成资金流水
 ↓
扣减转出方积分
 ↓
增加接收方积分

强制要求

必须使用数据库事务：

纯文本复制⌃BEGIN

扣减 A
增加 B
写入 A 流水
写入 B 流水
写入业务流水

COMMIT

任何一步失败：

纯文本复制⌃ROLLBACK

P23 提现

当前问题

现有提现流程要求：

纯文本复制⌃姓名
银行名称
银行卡号
身份证号

但资料编辑页面对应银行相关字段处于隐藏状态，形成业务闭环阻断。

推荐新流程

纯文本复制⌃提现
 ↓
检查实名资料
 ↓
检查银行卡资料
 ↓
检查积分/资产余额
 ↓
输入提现数量
 ↓
确认提现
 ↓
创建提现申请
 ↓
进入审核

提现状态建议

纯文本复制⌃待审核
审核中
已通过
已打款
已拒绝
已取消

敏感信息

银行卡号和身份证号不能完整展示。

例如：

纯文本复制⌃**** **** **** 1234

服务端日志中也不应记录完整敏感数据。

P24 个人资料

功能

管理用户基本资料。

现有资料

• 姓名
• 联系信息
• 微信号
• 部分银行卡/身份信息

建议拆分

基础资料

纯文本复制⌃头像
姓名
手机号
微信号

实名资料

纯文本复制⌃真实姓名
身份证信息

银行资料

纯文本复制⌃银行名称
银行卡号

敏感资料建议独立页面，并设置权限。

P25 收藏

功能

用户收藏商品。

操作

纯文本复制⌃商品详情
 ↓
点击收藏
 ↓
写入 Favorite

再次点击：

纯文本复制⌃取消收藏

列表支持：

• 分页
• 删除
• 进入商品详情

P26 关注

功能

当前商城个人中心存在“关注”入口。

开发时需要明确关注对象：

纯文本复制⌃商品
店铺
品牌
专区

目前从黑盒检查结果不能确认具体对象，应在产品阶段最终定义。

P27 浏览记录

功能

记录用户浏览商品。

建议：

纯文本复制⌃用户
商品
首次浏览时间
最后浏览时间
浏览次数

同一商品建议合并记录，而不是无限写入重复数据。

P28 客服中心

当前问题

现有“客服中心”存在错误链接，实际指向与客服无关的宣传文章。

新版本

应明确提供：

纯文本复制⌃客服电话
客服微信
在线客服
客服时间
常见问题
提交工单

至少保证点击客服中心后不会跳转到无关内容。

P29 关于我们

当前状态

主要展示经营资质/营业执照。

建议

纯文本复制⌃公司简介
经营主体
营业执照
联系地址
联系方式
隐私政策
用户协议
商城规则

资质图片建议：

• 压缩
• 防篡改
• 提供清晰查看
• 不暴露不必要的内部信息

P30 商家入驻

当前状态

没有在线申请流程，只提示联系客服。

两种实现方案

方案 A：客服申请

纯文本复制⌃商家入驻
 ↓
展示入驻条件
 ↓
联系客服

方案 B：在线申请

纯文本复制⌃公司信息
营业执照
联系人
手机号
经营类目
银行资料
提交
 ↓
平台审核

如果后续发展为平台型商城，建议直接设计为独立的商户体系。

9. 核心业务流程

9.1 注册流程

纯文本复制⌃游客
 ↓
注册页
 ↓
输入推荐人 tid
 ↓
填写手机号/微信/姓名/密码
 ↓
服务端校验
 ↓
创建用户
 ↓
创建会员
 ↓
建立推荐关系
 ↓
登录
 ↓
会员中心

9.2 会员升级流程

纯文本复制⌃会员中心
 ↓
查看当前等级
 ↓
申请升级
 ↓
系统确认目标等级 = 当前等级 + 1
 ↓
创建申请
 ↓
待审核
 ↓
审核人查看
 ├── 同意
 │    ↓
 │  更新会员等级
 │    ↓
 │  申请完成
 │
 └── 拒绝
      ↓
    记录原因
      ↓
    申请结束

9.3 商品购买流程

纯文本复制⌃商城
 ↓
分类/专区
 ↓
商品详情
 ├── 加购物车
 │    ↓
 │  购物车
 │
 └── 立即购买
      ↓
    确认订单
      ↓
    地址
      ↓
    服务端计算金额
      ↓
    创建订单
      ↓
    支付
      ↓
    待发货
      ↓
    已发货
      ↓
    待收货
      ↓
    已完成

9.4 积分转账流程

纯文本复制⌃资产中心
 ↓
积分转账
 ↓
输入目标账号
 ↓
确认目标用户
 ↓
输入数量
 ↓
验证余额
 ↓
确认
 ↓
事务扣款/入账
 ↓
生成双方流水

9.5 提现流程

纯文本复制⌃资产中心
 ↓
提现
 ↓
检查实名信息
 ↓
检查银行卡
 ↓
检查余额
 ↓
提交金额
 ↓
创建提现单
 ↓
人工/系统审核
 ↓
通过
 ↓
打款
 ↓
完成

10. 推荐数据模型

以下为建议的数据结构。

users

纯文本复制⌃id
mobile
password_hash
wechat
real_name
avatar
status
created_at
updated_at

members

纯文本复制⌃id
user_id
level_id
member_status
created_at
updated_at

member_levels

纯文本复制⌃id
name
level_code
level_sort
upgrade_enabled
status

member_relations

纯文本复制⌃id
parent_user_id
child_user_id
relation_level
status
created_at

upgrade_requests

纯文本复制⌃id
user_id
from_level_id
to_level_id
status
remark
reviewer_id
review_remark
created_at
reviewed_at

products

纯文本复制⌃id
category_id
name
cover
description
price
points_price
stock
status
created_at
updated_at

product_skus

纯文本复制⌃id
product_id
sku_code
specification
price
stock
status

carts

纯文本复制⌃id
user_id
sku_id
quantity
created_at
updated_at

addresses

纯文本复制⌃id
user_id
receiver
mobile
province
city
district
detail
is_default
created_at
updated_at

orders

纯文本复制⌃id
order_no
user_id
status
product_amount
freight_amount
discount_amount
points_discount
payable_amount
receiver_snapshot
created_at
paid_at
shipped_at
completed_at

order_items

纯文本复制⌃id
order_id
product_id
sku_id
product_name_snapshot
sku_name_snapshot
price_snapshot
quantity
subtotal

订单中的商品名称、价格、规格必须保存快照，避免商品后续修改影响历史订单。

points_accounts

纯文本复制⌃id
user_id
available_points
frozen_points
updated_at

points_transactions

纯文本复制⌃id
user_id
type
amount
balance_before
balance_after
reference_type
reference_id
remark
created_at

withdrawal_requests

纯文本复制⌃id
user_id
amount
status
bank_account_id
reviewer_id
review_remark
paid_at
created_at
updated_at

11. 权限模型

权限建议不要通过前端按钮控制实现。

纯文本复制⌃用户
 ↓
角色
 ↓
权限
 ↓
业务数据范围

例如：

纯文本复制⌃upgrade.apply
upgrade.review
team.view
order.view
order.create
asset.view
asset.transfer
asset.withdraw

同时增加数据范围：

纯文本复制⌃本人
直接下级
全部团队
全部用户

特别是审核权限，需要同时验证：

纯文本复制⌃功能权限
+
数据权限

12. API 设计规范

12.1 请求规范

推荐：

http复制⌃POST /api/member/upgrade/apply
Content-Type: application/json

请求：

json复制⌃{
  "remark": ""
}

不建议：

json复制⌃{
  "user_id": 123,
  "level": 3
}

因为这些字段属于服务端可以从 Session/数据库确定的内容。

12.2 返回规范

建议统一：

json复制⌃{
  "code": 0,
  "message": "success",
  "data": {}
}

错误：

json复制⌃{
  "code": 4001,
  "message": "当前会员等级不允许升级",
  "data": null
}

12.3 HTTP 状态码

建议：

纯文本复制⌃200 成功
400 参数错误
401 未登录
403 无权限
404 数据不存在
409 状态冲突
422 业务校验失败
429 请求过于频繁
500 服务端异常

13. 安全要求

P0

HTTPS

全站强制：

纯文本复制⌃HTTP → 301 → HTTPS

登录、注册、订单、资料、银行卡、积分操作全部禁止明文 HTTP。

Session 安全

Cookie 至少：

纯文本复制⌃Secure
HttpOnly
SameSite

密码

禁止：

纯文本复制⌃明文存储
可逆加密存储
日志输出密码

使用安全密码哈希。

服务端授权

所有关键接口必须进行：

纯文本复制⌃身份认证
权限认证
数据归属检查
状态检查

CSRF

对 Cookie Session 模式的 POST/PUT/DELETE 接口增加 CSRF 防护。

参数篡改

重点检查：

纯文本复制⌃user_id
request_id
order_id
points
price
level_id
address_id

不能仅根据前端传值执行。

14. 隐私要求

目前页面直接展示完整：

纯文本复制⌃手机号
微信号

建议：

纯文本复制⌃手机号：138****5678
微信号：wx****123

同时：

纯文本复制⌃身份证号脱敏
银行卡号脱敏
日志脱敏
接口返回脱敏
错误页面脱敏

15. UI/UX 统一要求

目前存在：

纯文本复制⌃会员系统
商城
账户系统

三套视觉语言。

新版本应统一：

色彩

定义：

纯文本复制⌃Primary
Success
Warning
Danger
Text
Secondary
Background
Border

字号

统一：

纯文本复制⌃12
14
16
18
20
24

页面容器

移动端建议：

纯文本复制⌃width: 100%
max-width: 750px
margin: auto

桌面环境不能继续无限拉伸。

底部导航

建议统一：

纯文本复制⌃工作台 | 商城 | 团队 | 订单 | 我的

16. 响应式要求

手机

重点支持：

纯文本复制⌃375px
390px
414px
428px

平板/桌面

建议限制：

纯文本复制⌃max-width: 750px

避免当前 1280px 视口下：

• 图标无限放大
• 商品无限拉宽
• 内容失去移动端比例

17. 空状态设计

所有列表都必须有明确状态。

例如：

纯文本复制⌃暂无升级记录
暂无团队成员
暂无订单
暂无收藏商品
暂无浏览记录
暂无收货地址
暂无积分流水
暂无提现记录

不能使用：

纯文本复制⌃空白页面
大片留白
只有一个返回按钮

18. 状态与审计要求

涉及资金/等级/权限的操作必须记录审计日志。

至少记录：

纯文本复制⌃操作人
操作类型
目标对象
操作前状态
操作后状态
IP
User-Agent
时间
业务单号
结果
失败原因

重点业务：

纯文本复制⌃会员升级
升级审核
积分转账
提现
订单状态变化
人工资产调整

19. 需要重点核查的后端问题

当前黑盒检查无法直接确定以下内容，开发上线前必须进行接口/源码/数据库审计：

20. 已发现问题对应开发任务

P0

纯文本复制⌃TASK-001 HTTPS 全站改造
TASK-002 登录/Session 安全
TASK-003 密码存储核查
TASK-004 CSRF 防护
TASK-005 服务端权限校验
TASK-006 IDOR/越权接口测试
TASK-007 登录限流
TASK-008 敏感数据脱敏

P1

纯文本复制⌃TASK-101 提现资料闭环
TASK-102 会员等级数据统一
TASK-103 修复客服错误链接
TASK-104 修复提现页面错误标题
TASK-105 统一积分规则
TASK-106 重写会员/商城业务说明
TASK-107 完善审核日志

P2

纯文本复制⌃TASK-201 统一 Design System
TASK-202 统一底部导航
TASK-203 响应式优化
TASK-204 CSS/JS 依赖清理
TASK-205 移除 javascript: 链接
TASK-206 无障碍优化
TASK-207 完善空状态
TASK-208 完善错误提示
TASK-209 页面性能优化

21. 前端开发规范

页面层

推荐：

纯文本复制⌃Page
 ├── Component
 ├── Service/API
 ├── Validator
 └── State

不允许

纯文本复制⌃页面直接拼接敏感业务逻辑
页面自行决定用户权限
页面自行计算最终订单金额
页面自行判断会员等级是否可以升级

应由服务端决定

纯文本复制⌃会员等级
升级资格
审核权限
商品最终价格
库存
积分余额
提现余额
订单状态

22. 测试重点

注册

纯文本复制⌃正常注册
重复手机号
非法手机号
弱密码
密码不一致
不存在 tid
失效 tid
重复推荐关系

登录

纯文本复制⌃正确密码
错误密码
禁用账号
连续错误
高频登录
Session 失效
退出登录

升级

纯文本复制⌃正常升级
重复申请
跨级申请
伪造 user_id
伪造 request_id
越权审核
重复审核
审核后再次操作

团队

纯文本复制⌃查看本人团队
查看他人团队
伪造 user_id
联系方式脱敏

商城

纯文本复制⌃库存不足
价格被修改
SKU 被删除
购物车价格变化
订单重复提交
重复支付
订单越权查看

积分

纯文本复制⌃余额不足
负数
小数
超额
重复提交
并发转账
自己给自己转账
伪造 user_id

提现

纯文本复制⌃资料缺失
余额不足
超额提现
重复提现
修改银行卡后提现
审核重复操作
越权查看提现记录

23. 验收标准

页面层

每个页面必须满足：

纯文本复制⌃正常进入
正常返回
正常加载
错误可提示
空状态明确
无权限正确拦截
移动端布局正常

业务层

关键操作必须做到：

纯文本复制⌃前端校验
+
后端校验
+
数据库状态校验
+
审计日志

安全层

上线前必须通过：

纯文本复制⌃HTTPS 检查
认证测试
授权测试
越权测试
CSRF 测试
XSS 测试
SQL 注入测试
暴力破解测试
敏感信息检查
Session 安全检查

24. 第一阶段开发建议

建议不要一次同时重写全部商城。

第一阶段优先完成：

纯文本复制⌃1. 登录/注册
2. 会员中心
3. 推荐关系
4. 会员升级
5. 升级审核
6. 团队
7. 个人中心
8. 统一权限
9. HTTPS/安全基础设施

第二阶段：

纯文本复制⌃商城首页
分类
专区
商品详情
购物车
地址
订单

第三阶段：

纯文本复制⌃积分
转账
提现
商家
客服
运营后台

25. 推荐最终系统结构

最终建议统一成以下信息架构：

纯文本复制⌃                    ┌─────────────┐
                    │    登录     │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │    工作台   │
                    └──────┬──────┘
                           │
          ┌────────────────┼────────────────┐
          │                │                │
     ┌────▼────┐      ┌────▼────┐      ┌────▼────┐
     │ 会员体系 │      │  团队   │      │  公告   │
     └────┬────┘      └─────────┘      └─────────┘
          │
     ┌────┼───────────────┐
     │    │               │
  升级申请 审核          邀请注册
     │    │
     └────┴───────┐
                  │
             ┌────▼─────┐
             │   商城   │
             └────┬─────┘
                  │
       ┌──────────┼───────────┐
       │          │           │
     分类       商品详情     购物车
       │          │           │
       └──────────┼───────────┘
                  │
              ┌───▼────┐
              │  订单  │
              └───┬────┘
                  │
              ┌───▼────┐
              │  我的  │
              └───┬────┘
                  │
      ┌───────────┼────────────┐
      │           │            │
    资产        地址         资料
      │
  ┌───┴─────┐
  │         │
转账       提现

26. 开发交付物建议

前端：

纯文本复制⌃页面清单
路由表
UI 组件规范
接口调用层
权限判断
表单校验
响应式适配

后端：

纯文本复制⌃数据库 ER 图
API 文档
权限模型
会员等级规则
订单状态机
积分账本
提现流程
审计日志

测试：

纯文本复制⌃测试用例
接口测试
权限测试
越权测试
流程测试
兼容性测试
安全测试

运维：

纯文本复制⌃HTTPS
域名
证书
日志
监控
备份
告警
数据库备份

27. 本文档中的“现状”和“建议”边界

已从前端检查结果确认

纯文本复制⌃会员中心存在
推荐注册存在
逐级升级存在
升级审核存在
团队页存在
商城存在
购物车/订单存在
资产/积分存在
转账/提现入口存在
个人中心存在
客服入口存在
关于我们存在
商家入驻入口存在

仍需后端确认

纯文本复制⌃真实数据库结构
真实 API 完整清单
服务端权限规则
会员等级计算规则
推荐关系深度
积分产生规则
积分冻结规则
提现结算规则
支付方式
库存锁定机制
退款机制
订单超时机制
密码哈希方式
CSRF 防护
接口限流
管理员权限

28. 开发原则

本项目后续开发建议遵循四个原则：

第一，前端负责交互，后端负责最终业务判断。

第二，会员、商城、资产三个领域的数据模型必须明确分层，但用户身份保持统一。

第三，涉及会员等级、积分、提现、订单等资产性操作必须具备事务和审计能力。

第四，新版本先统一业务逻辑和设计体系，再处理历史代码和技术债务，避免继续形成新的多套模板。

这份已经可以作为 V1 开发总规格文档 使用。下一步实际进入开发时，最适合继续拆成三份：《页面/原型需求文档》、 《API 接口文档》、 《数据库 ER + 字段设计文档》，这样前后端可以直接按任务拆分开发。