会员用户、标签与分组

会员用户是商城、营销、积分、签到等业务的统一用户基础。本页覆盖会员用户列表、用户标签和用户分组，相关前端位于 apps/web-antd/src/views/member/user、member/tag，后端接口位于 /member/user、/member/tag、/member/group。

能力边界

能力	后端接口	关键字段/操作
会员用户	/member/user/page、/member/user/update	手机号、昵称、头像、状态、地区、标签、分组、备注
修改等级	/member/user/update-level	会员等级、修改原因
修改积分	/member/user/update-point	增减积分，并写入积分记录
用户标签	/member/tag/*	标签名称、分页、精简列表
用户分组	/member/group/*	分组名称、状态、精简列表

会员画像结构

管理端常用操作

编辑基础资料

可维护手机号、昵称、头像、真实姓名、性别、生日、所在地、标签、分组和备注。生日字段在前端以时间戳提交，后端当前用户资料接口负责落库和回显，二开时要保持日期格式一致。

调整会员等级

后台可通过“修改等级”弹窗调整用户等级，并要求填写修改原因。建议把原因写成可审计语句，例如“线下大客户补录金卡权益”。

调整积分

后台可选择增加或减少积分。接口会通过 MemberPointRecordService.createPointRecord 生成业务类型为 ADMIN 的积分流水，不建议绕过接口直接改用户积分字段。

标签与分组怎么用

类型	适用场景	建议
标签	可多选，适合灵活画像	如“高价值客户、企业客户、售后关注”
分组	单选，适合运营归类	如“默认分组、渠道客户、内部测试用户”
等级	与成长和权益挂钩	不要把临时运营活动塞进等级体系

二开建议

• 批量操作谨慎开放：用户列表支持多选，批量打标、批量分组可作为二开点，但要增加操作日志。
• 手机号唯一性要保持：如果接入第三方会员来源，优先用手机号或外部用户 ID 做合并策略。
• 标签数量控制：标签过多会降低运营效率，建议定期清理低使用率标签。
• 积分调整要可追溯：后台人工增减积分必须保留操作人、原因和业务来源。

排查清单

现象	优先检查
用户列表等级/分组为空	关联等级或分组是否已删除/禁用；分页接口是否拼接返显数据
标签保存后不显示	tagIds 是否传数组；标签精简列表是否包含该标签
积分调整失败	权限 member:user:update-point；变动后积分是否小于 0
修改等级失败	权限 member:user:update-level；等级 ID 是否有效；修改原因是否填写