会员卡

会员卡是会员管理里唯一一张逐卡视图：左边一列把这张卡的档案、六类交易流水、四类卡务安全记录、五类会员资料全铺开，右边第一屏就把「卡里还有多少钱、多少分、在哪家店、什么时候到期」摊在四张卡片上。查一个会员的来龙去脉、处理一次投诉、核对一笔充值，都在这一个页面里完成，不用在功能之间来回跳。

一、功能概述

菜单位置：会员管理 → 编码 → 会员卡（页面地址 /admin/VIP/vipcard/）

这个功能承担三件事：

用途	说明
查	按卡号、姓名、电话、状态、会员类别、所属分店任意组合定位会员卡，进卡片看它的余额构成、积分构成和全部流水
改档案	改持卡人姓名、电话、证件、地址、生日这类资料字段，以及卡的微信绑定、消费密码、物理卡号
批量建卡	「新增会员卡」按号段一次生成一批空卡号备用，供收银端发放和绑定实体卡

余额和积分不在这里改。 编辑资料页里「卡内余额」「可用积分」都是只读文本，要动这两项只能走单据：会员卡充值单、会员积分调整单、会员积分返金额单。状态要改成停用、挂失、作废，走 会员卡状态修改单。

整体结构是「列表 → 卡片 → 卡片内左侧菜单切换视图」三层。列表页负责定位，卡片页负责展示，卡片内左侧菜单把同一张卡的十几种数据切成十几个视图，切换时顶部标题和页签不变，不会新开窗口。

二、界面布局说明

会员卡列表

区域	内容
工具栏	蓝色 新增会员卡；右侧三个图标按钮依次是 搜索、刷新、全屏
查询条	关键字框（提示「搜索...」）、会员卡状态: 全部、会员类别: 全部、所属分店: 全部、⌄ 更多、蓝色 🔍 搜索
列表	勾选 / 排序 / 会员卡编号 / 持卡人姓名 / 电话 / 卡内余额 / 可用积分 / 会员卡状态 / 会员类别 / 所属分店
分页	「共 N 条」+「共 N 页」+ 首页/上一页/页码/下一页/末页 + 每页条数下拉（默认 20 条/页）

会员卡编号是链接，点进去就是这张卡的详情页。列表默认不带任何条件，也就是全库卡；测试账套实测 191721 条、9587 页，所以先筛再翻，靠翻页找人是找不到的。

⌄ 更多 展开的是扩展筛选区，收起状态下只能按状态、类别、分店筛。查询条件的通用行为（已选条件芯片、⚙ 高级筛选、★ 保存筛选方案）见 30查询条件与筛选方案。

会员卡详情：左侧菜单

卡片页左侧是一棵固定的菜单树，分四组：

分组	视图	看什么
会员	概览 / 编辑资料	概览是资产和消费摘要的仪表盘；编辑资料是可改的档案表单
交易明细	储值账簿 / 充值明细 / 消费明细 / 赠送明细 / 计次明细 / 积分明细	六本流水账，各看一类变动
卡务安全	预授权 / 解锁记录 / M1日志 / 修改记录	支付前的锁定、密码解锁、写卡日志、字段级修改留痕
会员资料	联络信息 / 生日管家 / 礼品卡 / 分销 / 详细资料	客诉与回访记录、生日提醒、礼品卡、推荐关系、完整档案

分销 这一项不是每张卡都有——它受「会员设置特点 → 会员卡设置 → 会员卡管理显示分销标签页」控制，开关关了这棵树里就没有该节点，见 70会员设置特点。

卡片顶部标题是「卡号 持卡人姓名」，后面跟两个标签：会员类别（灰底）和 会员卡状态（正常绿底、挂失橙底）。左上角 返回列表 回到列表页并保留上一次的筛选条件。

概览页

区块	字段	口径
账户资产	卡内余额	大字是可用合计，小字拆成「本金 X / 赠送 Y」。本金可退，赠送一般不可退，退款时按这个拆分算
	线上余额	微商城、小程序侧可用的金额，与门店余额分开计
	可用积分	小字 累计 是历史上总共得过分，大字是当前还没用的
	电子券	张数。券在 促销管理 和会员礼包里配
	礼品卡	张数 + 余额
	所属分店	开卡门店。跨店消费是否受限由会员设置特点和分店设置决定
	有效期	多数卡显示「跟随会员类型」，即有效期不由卡自己决定，见本章第四节
消费摘要	开始消费日期 / 最近消费日期 / 累计消费次数 / 累计消费金额 / 支付次数 / 最近返利时间	判断沉睡会员看这两个日期，判断返利是否跑过看最近返利时间
卡片操作	修改资料 / 解除微信绑定 / 清除密码 / 修改物理卡号	四个都是直接动作按钮，不跳转

没有消费过的卡，消费摘要整块显示「-」，不是数据丢了。

编辑资料页

工具栏是 返回 / 编辑 / 刷新 / 上一行 / 下一行，右侧 历史版本。未点 编辑 之前整页是只读的；进入编辑态后按钮变成 保存 / 取消 / 保存并继续编辑。

上一行 / 下一行 是沿列表的当前顺序在卡之间移动，不用回列表重查——逐张核卡时很有用。

字段分组：

分组	字段	可改
会员卡基本信息	会员卡编号、持卡人姓名、电话、身份证号、地址	是（卡号除外）
会员卡金额信息	卡内余额、线上余额、本金余额、赠送余额、累计充值金额、累计返利金额、累计赠送金额、已用赠送金额、预扣款锁定金额、预扣款锁定赠送金额、信用金额、总可用赠送金额、可用合计金额	否，全部只读
会员卡积分信息	累计积分、可用积分、当前返利比例、最近返利时间	否，全部只读
会员卡状态与类型	会员卡状态、会员类别、会员系列等	折叠，展开后可改
消费信息	开始/最近消费日期、累计消费次数与金额	折叠，只读
有效期	有效期类型与起止日期	折叠，可改
超级会员信息	超级会员相关字段	折叠，仅启用超级会员时有效
其他信息	备注等	折叠，可改
编码状态	是否总部编码、定义人员、定义日期	折叠，只读
审计信息	修改人员、修改日期、修改次数	折叠，只读

预扣款锁定金额 不为零时，这部分钱在收银端不可用。它来自「下单未支付」或「支付中」的挂起交易，正常会自动释放；长期挂着说明有未确认的支付，需要查收银端的支付未确认数据。

交易明细视图

六本流水账共用一个版式：顶部标题 + 「共 N 条」+ 搜索框 + 搜索/刷新按钮，下面是表格。

储值账簿 是金额变动的总账，列 日期 / 票号 / 操作 / 操作时间 / 金额 / 剩余金额 / 备注 / 备注1。金额 有正有负，剩余金额 是逐行滚存的余额。

对账只看储值账簿就够了：充值明细只记充值、消费明细只记消费、赠送明细只记返利和赠送，三本分开记，一笔钱到底进没进余额，看储值账簿的剩余金额最快。

积分明细 同构，记积分的产生与消耗。计次明细 只对计次卡有意义，普通储值卡这里是空的。

会员资料视图

联络信息 记客诉和回访，列 联络时间 / 联系人 / 联络电话 / 联络内容 / 操作员 / 联络日期 / 操作，右上角 + 新增联络。

详细资料 是最完整的档案表单，分两组：基础信息（会员卡、中文姓名、英文姓名、性别、出生日期，出生日期旁有 今天 快捷链接和日历）和 联系方式（电话、传真、移动电话、地址、通讯地址、邮编、E-Mail、QQ号）。列表页只显示姓名和电话，其余字段都要在这里看。

新增会员卡（批量建号）

这是一个号段生成器，不是给某个客人办卡：

字段	必填	含义
会员类型	是	决定这批卡继承哪套规则，见 40会员卡类型
卡号前缀	是	固定前缀，如 VIP
起始流水号	否	默认 1
发放张数	是	默认 1，一次生成多少张卡号
流水号长度	否	默认 6，不足位数补前导零
随机码长度	否	默认 4，在流水号后拼随机数字，防止卡号被猜
会员姓名	否	提示「可选，批量开卡时统一设置」，留空即开卡时再填
排除字符	否	提示「如：4,7」，卡号中需要排除的数字，逗号分隔

按钮只有 返回 和 确认开卡。确认开卡是写操作，一次生成 N 张卡号入库，点之前核对发放张数。

三、业务操作步骤

查一个会员的余额和最近消费

1. 会员管理 → 编码 → 会员卡，在查询条选 会员卡状态: 正常（排除作废、退卡干扰）。
2. 关键字框输入卡号、姓名或电话，点蓝色 🔍 搜索。列表刷新，只显示命中行，「共 N 条」变成命中数。
3. 点目标行的 会员卡编号 链接进入卡片，默认落在 概览。
4. 看 账户资产 的卡内余额（注意小字里本金和赠送的拆分）和 可用积分；看 消费摘要 的最近消费日期判断活跃度。
5. 要看这笔钱怎么来的，点左侧 储值账簿，从下往上看 剩余金额 与 金额 是否连续。

修改持卡人电话

1. 进入卡片，点左侧 编辑资料。
2. 点工具栏 编辑，表单解锁。
3. 改 电话 字段。
4. 点 保存。回到只读态，右上角提示保存成功；列表页该行刷新后 电话 列同步。
5. 要接着改下一张卡，点 下一行，不用回列表。

处理「电话打不通、要求退卡」的客诉

1. 进卡片看 概览，记下 卡内余额 的本金/赠送拆分——可退的是本金部分。
2. 点左侧 储值账簿，导出或逐行核对，确认余额和客人主张是否一致。
3. 点左侧 联络信息，右上角 + 新增联络，填写 联络时间 / 联系人 / 联络电话 / 联络内容，保存。这条记录带 操作员 和 联络日期，是后续追溯的依据。
4. 确认要退卡，用 会员卡状态修改单 把状态改成 退卡，不要在编辑资料里直接改状态字段。

批量生成一批备用卡号

1. 会员卡列表页，点蓝色 新增会员卡。
2. 选 会员类型，填 卡号前缀、起始流水号、发放张数。
3. 需要卡号防撞，保留 随机码长度 默认 4；忌讳数字填 排除字符（如 4,7）。
4. 点 确认开卡。生成的卡号进入列表，状态为 未激活，等收银端发放或绑定实体卡时激活。

解除微信绑定 / 清除消费密码

1. 进卡片，默认在 概览。
2. 底部 卡片操作 区点 解除微信绑定 或 清除密码。
3. 操作立即生效，无需保存。清密码后该卡在收银端消费不再校验密码（前提是「启用会员卡消费密码」这个特点本身是开的，见 70会员设置特点）。

四、字段详细说明

会员卡状态

列表筛选下拉里的全部枚举值：

状态	含义	收银端表现
正常	可用	可充值、可消费、可积分、可折扣
未激活	号已生成，还没发放绑定	不能消费
停用	暂时冻结	不能消费，余额保留
停用（并取消微信会员）	冻结同时解掉微信侧会员身份	小程序/微商城侧也不再识别为会员
挂失	卡丢了或被盗	不能消费；解挂需走状态修改单
作废	这张卡彻底作废	不可恢复使用
退卡	已办退卡	不可再用，余额按退卡流程处理
已过期	超过有效期	系统自动判定，不由人填

状态只能通过 会员卡状态修改单 批量改，编辑资料页里的状态字段受「允许修改会员卡状态」这个特点控制，默认关闭。

金额字段口径

字段	口径
卡内余额	这张卡在门店可用的钱
本金余额	客人真金白银充进来的部分，可退
赠送余额	充值赠送、返利转入的部分，一般不可退
线上余额	微商城/小程序侧可用金额，与门店余额分账
累计充值金额	历史总充值，只增不减
累计返利金额	历史总返利
可用返利金额	返利里还没用的部分
累计赠送金额 / 已用赠送金额	赠送的总账和消耗
预扣款锁定金额 / 预扣款锁定赠送金额	被挂起交易占住、当前不可用的部分
信用金额	允许透支的额度
总可用赠送金额	赠送侧合计可用
可用合计金额	收银端实际能刷的合计，概览页大字即此值

有效期

概览页 有效期 显示「跟随会员类型」时，说明这张卡自己没有单独设有效期，取会员类型上的规则。要改某一张卡的有效期，在 编辑资料 → 有效期 分组里展开设置；改完全公司的默认口径，在 40会员卡类型 的开始日期/结束日期上设。

卡自定义 > 会员类型 是优先级顺序。

积分字段

字段	口径
累计积分	历史总得分
可用积分	当前余额，消费和兑换都会扣
当前返利比例	这张卡当前生效的返利比例，来自 会员等级
最近返利时间	上一次积分转金额成功的时间；长期为空说明返利任务没跑或该卡不返利

五、典型使用场景

场景一：客人说充值没到账

1. 会员卡列表按手机号搜出卡，进 概览 看 卡内余额 是否变化。
2. 点 充值明细，看有没有这笔充值记录。
3. 有记录但金额不对 → 查 备注 里的票号，回收银端找那张小票。
4. 无记录 → 是收银端没上传，先在收银端做数据上传；确实需要后台补，走 会员卡充值单。

场景二：找出长期不消费的会员做唤醒

1. 网页端列表没有「最近消费日期」这一列，用 概览 逐张看效率低。
2. 改用 会员消费报表，把业务日期设成需要观察的区间，按持卡人汇总出「这段时间消费过的人」。
3. 要的是「这段时间没消费的人」，用会员画像侧的沉睡客群分析，见 会员画像。

场景三：门店交接，把某张卡的归属和状态理清

1. 概览 的 所属分店 看开卡店。
2. 修改记录（卡务安全组）看这张卡历史上谁在什么时候改过哪些字段。
3. 解锁记录 看有没有反复输错密码的异常。
4. 储值账簿 导出交给接手人做余额确认。

场景四：给一批员工卡统一挂失

1. 会员卡列表用 会员类别 或 所属分店 筛出这批卡。
2. 勾选行，走 会员卡状态修改单 的 选择会员 批量加行，统一设 新卡状态 为 挂失。
3. 单据审核后，收银端下次同步即生效。

六、权限控制与前置条件

菜单权限：需要「会员管理 → 编码 → 会员卡」的菜单权限和对应的操作权限（查看 / 新增 / 修改 / 删除）。谁能看到哪些分店的数据，由用户授权时的机构范围决定，配法见 30权限与授权。

前置条件：

• 至少存在一个 会员卡系列 和一个 会员卡类型，否则「新增会员卡」里的 会员类型 下拉是空的。
• 收银端要看到网页端改过的档案，需要收银端完成基础档案同步；改了名字收银端没变，先确认同步是否跑过。
• 删除会员卡 只对没有任何流水的卡开放。有储值账簿记录的卡删不掉，只能改成 作废 或 退卡。

跨端一致性：客户端「会员管理 → 会员卡管理」和网页端「编码 → 会员卡」读写同一批表，两边同时改同一张卡时后保存的覆盖先保存的。批量维护建议固定在一端做。

七、常见问题

列表打开很慢或转圈。 全库卡量在十几万级别，无条件查询会拉全表。先选状态或类别再搜，或直接用关键字框输完整卡号。

点了会员卡编号没反应。 编号列的链接只在正常渲染时有效；若上一次操作留下了未关闭的弹窗，先关掉再点。列表通用行为见 20表格窗口通用操作。

编辑资料里改不了余额。 这是设计如此，金额和积分字段一律只读。要调余额走 会员卡充值单，要调积分走 会员积分调整单。

「新增会员卡」点确认开卡提示需要操作员密码。 批量发卡属于敏感动作，收银端和后台都要求输入当前操作员密码确认，防止误发一批号段。

概览里电子券、礼品卡都是 0，但客人说有券。 电子券在 促销管理 的会员礼包和充值赠券规则里配，配了之后要等发放条件命中；礼品卡是独立编码，见客户端 礼品卡管理。两边都在网页端卡片上只显示结果，不显示发放过程。

左侧找不到「分销」。 该页签受「会员卡管理显示分销标签页」这个系统特点控制，默认不显示，见 70会员设置特点。

改完状态收银端还是能用。 状态修改单要审核后才生效，只保存不审核等于没改；生效后收银端还要完成一次同步。