会员等级
会员等级管理是一个系列一张表的左右分栏页：左边列出全部卡系列，点一个系列，右边就摊开这个系列的等级阶梯——每一档从多少分开始、到多少分结束、对应哪个会员卡类别、送什么会员礼包、到期后怎么降级，全在同一屏里对齐着看。它是 会员卡系列 那层能力开关之下的执行数值层，也是自动升降级这套成长机制的唯一配置入口。
一、功能概述
菜单位置：会员管理 → 编码 → 会员等级管理（页面地址 /admin/VIP/vipseriallevelpage/）
三层职责划分要记牢：
| 层 | 功能 | 管什么 |
|---|---|---|
| 总开关 | 会员卡系列 | 这一大类卡允不允许折扣、充值、积分、返利 |
| 阶梯 | 会员等级（本页） | 分几档、每档的门槛区间、每档挂哪个卡类别、礼包、升降级方式 |
| 数值 | 会员卡类型 | 该档实际的积分率、有效期、金额上下限等执行参数 |
网页端的等级表里没有折扣率输入框。等级通过 对应卡类别 指向一个会员卡类型，积分率等具体数值在那个类型上配。所以「改一档会员的折扣」的正确路径是：本页确认这一档对应哪个卡类别 → 去 会员卡类型 改那个类别。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 顶部 | 标题 会员等级管理、一个宽关键字框、蓝色 查询、重置 |
| 左栏 | 卡系列列表，列 系列编号 / 系列名称，上方「共 N 条，第 X-Y 条」，下方每页条数下拉（默认 100 条/页），右上角全屏图标 |
| 右栏 | 编辑等级 按钮、自动升级规则 下拉、橙色警示条、等级表、等级权益说明 文本区、等级图片 上传位 |
未选系列时右栏是空的，提示「请先从左侧选择一个卡系列」。左栏点一行，右栏立刻加载该系列的等级，不需要点查询。
等级表列
| 列 | 含义 |
|---|---|
| 编号 | 等级代码，如 Lv1、Lv2、Lv3 |
| 排序 | 阶梯顺序，数字越小档越低。自动升级按这个顺序往上走 |
| 等级标题 | 对客人展示的名字，如「新秀 / 精英 / 贵宾」 |
| 开始值 | 本档门槛下界，含该值 |
| 结束值 | 本档门槛上界，不含该值 |
| 对应卡类别 | 该档绑定的 会员卡类型，积分率等数值挂在这里 |
| 会员礼包 | 升到该档时发放的礼包，如「青铜会员Lv2礼包」；最底层常写成「会员等级」表示不额外发 |
| 降级规则 | 0 不降级 / 1 按有效期降级[到期重算] / 2 按有效期降级[指定降级] |
| 有效天数 | 该档的有效期天数，配合降级规则使用 |
实测一个系列的三档配置：Lv1 新秀 0～1000 萌新会员 0 不降级、Lv2 精英 1000～4000 铜牌会员 青铜会员Lv2礼包 1 按有效期降级[到期重算]、Lv3 贵宾 4000～9999999 银牌会员 白银会员Lv3礼包 2 按有效期降级[指定降级]。最高档的结束值用 9999999 这类大数封顶，不是错误。
自动升级规则
右栏顶部一个下拉，决定 开始值 / 结束值 这两列按什么口径判定。实测可选值含「按可用积分」等，与系列详情里 升级方式 是同一件事的两个入口——以本页的选择为准。
开始值和结束值的单位跟着这个下拉变：选「按可用积分」就是积分区间，选按消费额就是金额区间。改了口径，下面所有档的门槛数值含义同时改变，需要重算。
等级权益说明与等级图片
表格下方两块是给前台展示用的素材：等级权益说明 是一段文本（占位提示「当前等级的权益说明...」），等级图片 是一张图。这两项会随会员档案下发到小程序、微信卡包侧展示给客人看，不参与任何计算。
三、业务操作步骤
给一个系列配三档等级
- 会员管理 → 编码 → 会员等级管理，左栏搜出目标系列并点击。
- 右栏点 编辑等级，等级表解锁。
- 选 自动升级规则，先定口径（按可用积分 / 按累计消费额）。
- 逐行填 编号 / 排序 / 等级标题 / 开始值 / 结束值 / 对应卡类别 / 会员礼包 / 降级规则 / 有效天数。
- 三档的区间要首尾相接：第 1 档 0～1000、第 2 档 1000～4000、第 3 档 4000～9999999。中间留空档，落在空档的会员会升不上去。
- 补 等级权益说明 和 等级图片，供小程序展示。
- 点保存。
让某个等级享受更高积分率
- 本页找到该等级，读 对应卡类别 那一列的值（例如「铜牌会员」）。
- 打开 会员卡类型，搜这个类别。
- 进详情改 积分率。
- 保存后回本页确认该等级仍指向这个类别。不要在本页直接换指向，否则客人会跳档。
调整升降级行为
- 选系列，点 编辑等级。
- 逐档设 降级规则：
0 不降级—— 只升不降，最简单，适合储值为主的门店。1 按有效期降级[到期重算]—— 有效期到了重新按当前门槛算一次，可能降也可能保级。2 按有效期降级[指定降级]—— 到期直接降到指定档。
- 填 有效天数，它是上面两种「按有效期」的时间来源。
- 保存。首次启用自动升级时，页面会提示需要联系开发商配置开通生效（见第四节）。
四、字段详细说明
降级规则枚举
| 值 | 行为 | 用在哪 |
|---|---|---|
| 0 不降级 | 升上去就不掉 | 门店以储值沉淀为主、不想因淡季掉级引起投诉 |
| 1 按有效期降级[到期重算] | 有效期到期时，按当前 开始值/结束值 重新判定所在档 | 希望等级反映真实活跃度，但允许保级 |
| 2 按有效期降级[指定降级] | 有效期到期时直接降到预设的档 | 高端档需要「不活跃就让位」的场景 |
降级只在配了自动降级时间后才会发生，时间在 会员卡系列 详情的 自动降级时间 里设。
门槛区间
开始值含、结束值不含。0～1000 表示 0 分算这一档，正好 1000 分归下一档。相邻两档的结束值必须等于下一档的开始值，否则中间出现无人可归的空档。
会员礼包
礼包本身在客户端侧维护，网页端只做引用。可选值里除了具体礼包名，还有一个 「会员等级」 的特殊项，表示该档不发礼包、只作为等级标识。
首次设置的限制
页面在 自动升级规则 下方有一条橙色提示：
首次设置后需要联系开发商配置开通生效。
也就是说自动升级的定时任务不是配了就跑，第一次配置完要联系实施开通后台任务，否则会员只会在开卡时定档，之后不再自动升降。
五、典型使用场景
场景一：把「消费满 4000 送银卡」写进系统
- 选系列，确认 自动升级规则 是按累计消费额口径。
- 把
Lv3的开始值改成 4000。 - 对应卡类别 指向已有的「银牌会员」类型（其积分率、折扣已配好）。
- 会员礼包 选银牌对应的礼包，客人升档时自动发放。
- 确认系列的 自动升级时间 已设，并确认自动升级任务已开通。
场景二：做一次「等级体检」
- 左栏逐个点系列，右栏看三件事：区间是否首尾相接、对应卡类别是否为空、最高档结束值是否封顶。
- 对应卡类别为空的等级，客人升到那档会拿不到任何数值参数，属于配置缺陷。
- 89 个系列逐个看效率低，先按系列名称筛出在营的系列，历史系列可以直接跳过。
场景三：小程序上等级图标不显示
- 本页选中该系列该档，检查 等级图片 是否上传过。
- 检查 等级权益说明 是否为占位文本。
- 两项都是纯展示素材，补上后等小程序侧刷新，与积分、折扣无关。
六、权限控制与前置条件
菜单权限：需要「会员管理 → 编码 → 会员等级管理」的查看与修改权限。等级是全局档案，通常只开放给总部实施，见 30权限与授权。
前置条件：
- 系列必须先存在，且其 升级方式 与本选择的 自动升级规则 口径一致。
- 对应卡类别 来自 会员卡类型，且该类型必须属于当前这个系列——跨系列的类别不会出现在下拉里。
- 会员礼包 必须先在客户端侧建好，网页端只能引用。
- 自动升降级要生效，需 会员卡系列 的 自动升级时间 / 自动降级时间 已设，且首次配置已联系实施开通后台任务。
跨端一致性：客户端「会员管理 → 会员编码 → 会员卡级别」与本页面读写同一批表；客户端侧的折扣率、积分率分段设置说明更细，见 会员卡级别。
七、常见问题
改了等级表，前台折扣没变。 等级表里没有折扣值，只有 对应卡类别。折扣在类别上，去 会员卡类型 改；改完收银端还要等一次基础档案同步。
右栏一直是「请先从左侧选择一个卡系列」。 左栏的系列要点中（整行高亮）才加载，鼠标划过不算。左栏条目多时先用顶部关键字框 查询 缩小范围。
会员到了门槛却没升档。 三个检查点：一是 自动升级规则 口径和会员实际数据是否对得上（用积分门槛去判消费额永远不会升）；二是系列的 自动升级时间 是否设了；三是首次配置后是否已联系实施开通定时任务。
有会员卡在两档之间来回掉。 通常是相邻档的区间重叠了（第 1 档 0～1500、第 2 档 1000～4000）。区间必须首尾相接且不重叠；重叠时系统按排序取档，会员余额在临界区波动就会反复跳。
开始值填 9999999 是笔误吗？ 不是。最高档需要一个封顶值，9999999 是常用的「足够大」写法，表示这一档之上再无档位。
能不能只配一档？ 可以，等于该系列所有会员同档、不升不降。但 降级规则 仍需选 0 不降级，否则到期时找不到目标档。