会员管理(member)
会员档案怎么和平台账号对上、积分与成长值的规则写在哪一行代码里,以及冻结会员后那人还能不能登录。
应用编码 member,本页对应应用版本 1.0.4(引擎要求 >=5.6.2 <6.0.0),清单 license 为 UNLICENSED、licenseRequired 为 true,装与加载都要先有一枚覆盖本应用的凭证,档位口径见 授权档位,仓库 wujies-member-plugin。
会员应用管的是一个平台账号在业务侧的那层身份:档案、等级、余额、积分、成长值、徽章、签到记录、收货地址。登录名、密码、账号启停、角色归平台的 sys_user,member.user_id 只是指过去的一根线;余额要能真扣钱得靠支付应用配渠道,见 支付管理;读写收货地址最频繁的是 商城管理 的下单链路。
装它
清单里 dependencies 是空的,不挑安装顺序,任何部署都能直接装。装之前确认三件事:
- 这台部署有办法产生用户(开放注册或后台新建账号)。会员档案不是手工等来的:宿主发布
UserRegisteredEvent,MemberRegisterListener收到后幂等建档并送 500 积分;装应用之前已存在的账号不会被补建,插件里没有批量补建入口,只能到「会员列表 → 新增会员」逐条关联。 - 角色要能看见菜单。权限码全部以
member:开头,共 68 个,授到member:member:list这一级只是进了页面,充值、冻结、调积分这些动作各自还要对应的 F 级权限码。 - 多租户部署按租户隔离:
member与member_level都带tenant_id,等级唯一键是 (tenant_id,level_code),新租户不会自动带上 V1 到 V7 那七行种子,要在该租户下自己建。
安装过程与「装完菜单为什么没立刻出现」见 在部署里使用应用。装成功后侧栏多一个「会员管理」,下面九项:
| 菜单 | 路由 | 需要的权限码 |
|---|---|---|
| 会员列表 | member | member:member:list |
| 会员等级 | level | member:level:list |
| 会员收货地址 | address | member:address:list |
| 会员徽章 | badge | member:badge:list |
| 会员余额 | balanceLog | member:balanceLog:list |
| 会员积分 | pointsLog | member:pointsLog:list |
| 会员成长值 | growthLog | member:growthLog:list |
| 会员徽章发放 | badgeGrant | member:badgeGrant:list |
| 会员每日签到 | checkinRecord | member:checkinRecord:list |
配它
这一页没有「会员配置」菜单,仓库的迁移脚本也不往 sys_config 里写任何一行;宿主的模块配置组件 ModuleWebsiteSettings / ModuleBusinessSettings 支持的分类只有 mall、im、exam、gallery、cms。要调的那几个值都以常量或种子行的形式在代码与脚本里,改它们要走发版或改数据,不是改配置:
| 项 | 现值 | 写在哪 | 什么时候要改 |
|---|---|---|---|
| 注册赠送积分 | 500 | MemberRegisterListener 的 REGISTER_BONUS_POINTS | 活动期改赠送量要发版;改之前确认没有别处也在送同一笔分 |
| 签到奖励 | 10 积分 + 5 成长值 | MemberServiceImpl 的 DEFAULT_CHECKIN_POINTS_REWARD / DEFAULT_CHECKIN_GROWTH_REWARD | 同上,成长值一动就牵动等级门槛 |
| 签到积分有效期 | 一年后过期 | MemberServiceImpl 里 cal.add(Calendar.YEAR, 1) | 回收节奏变了才动;它只作用于签到这一类积分 |
| 等级门槛 | V1 到 V7 分别 0 / 100 / 300 / 800 / 2000 / 5000 / 10000 成长值 | 02-create-member-seed-data.sql 的 member_level.required_growth | 在「会员等级」页直接改,autoUpgradeLevel 按 required_growth 取够得着的最高级,不看 level_sort |
| 徽章触发条件 | 只认 checkin_streak(连续签到)与 checkin_total(累计签到) | MemberBadgeServiceImpl 的两个常量 | 想按消费额发徽章得改代码;页面能把别的编码存进去,但自动发放不认 |
| 会员编号 | VIP + yyyyMMdd + 4 位随机,最多试 10 次 | MemberServiceImpl#generateMemberNo | 撞号会重试,编号唯一键是 (tenant_id, member_no) |
| 等级图标、徽章图标 | 种子行里写的是 https://oss.wujies.cn/... 外链 | 02-create-member-seed-data.sql | 交付给客户前换成自己 OSS 上的图,否则客户的站引用的是你的域名 |
member:page: 这个 Redis 前缀缓存会员列表页 20 秒(MemberServiceImpl 的 PAGE_CACHE_TTL),充值、调分、签到都会主动清它,改完数字不动先等 20 秒再怀疑别的。
用它
管理员在「会员列表」里做充值、扣款、调整积分、调整成长值、改等级、冻结/解冻、发徽章、代客签到,也能按用户 id 反查档案(GET /member/member/detail/user/{userId});三张流水页(余额 / 积分 / 成长值)都是「可查可导出、add 与 edit 也在权限里」的形态,手工补流水是给对账纠偏用的,正常业务不该走它。签到记录页同理,日常签到由会员自己触发。
会员走 /portal/member/** 与 /portal/member/address/**:查档案与余额/积分/成长值三项数值、改资料、注册、看三类流水、看等级与徽章列表、签到(POST /portal/member/checkin)、查签到状态与汇总、管自己的收货地址。这一族接口上没有 @SaCheckPermission,身份取自当前登录用户,只回本人数据。
前台公开页只有一条:GET /site/member/profiles?userIds=1,2,3(MemberSiteController,类级 @SaIgnore)。它是给内容中心的评论挂件用的,一次最多 50 个 id,超了直接失败;返回字段只有昵称、头像、等级与勋章,余额、积分、成长值、手机号一个都不出。本应用自己不出直出的公开页,仓库里没有 site-templates/。这条路径在内容中心侧还有一份副本(CmsThemeProperties.AUTHOR_API_URL),要改两处一起改,见 内容中心。
出问题查什么
| 现象 | 先看 |
|---|---|
| 冻结了会员,那个人还能登录 | freeze 会经 PlatformUserApi.updateStatus 同步改 sys_user 状态;宿主日志里有 WARN「宿主未提供 PlatformUserApi,会员状态已改但系统账号状态未同步」时,说明这层同步没接上,会员状态改了账号没改 |
| 超级管理员那一条冻不掉也删不掉 | MemberServiceImpl#validateSuperAdminMember 直接拦,报「不允许对超级管理员执行该操作」 |
| 新注册的账号没有会员档案 | 看宿主日志有没有「用户注册后建会员档案失败(不影响注册本身)」;建档失败不回滚注册,所以账号在、档案不在 |
积分到了 expire_time 还没被回收 | 回收靠 SnailJob 上名为 memberPointsExpireTask 的执行器(MemberPointsExpireTask),调度台里没建这个 job 就永远不跑。本页只读了代码,未联机验证这条任务链路 |
| 前台评论区一片「匿名」 | GET /site/member/profiles 是否可达、userIds 是否超 50、/site/** 是否还在宿主 open-api.tenant.path-patterns 的匿名带里 |
| 列表里的余额/积分改完不变 | 20 秒页缓存;确认写库成功再怀疑缓存 |
| 权限给了却按按钮报无权限 | F 级权限码与 :list 是分开的两条,逐条授;菜单树在登录时生成,改完要重登,见 应用菜单 |
实现索引
| 项 | 值 |
|---|---|
| 数据表 | member、member_address、member_badge、member_badge_grant、member_balance_log、member_checkin_record、member_growth_log、member_level、member_points_log |
| 后台接口前缀 | /member/member、/member/level、/member/address、/member/badge、/member/badgeGrant、/member/balanceLog、/member/pointsLog、/member/growthLog、/member/checkinRecord |
| 会员端 | /portal/member/**、/portal/member/address/**(无权限码,按当前登录用户取数) |
| 公开端 | /site/member/profiles(@SaIgnore,一次 ≤ 50 个 id) |
| 迁移脚本 | migrations/01-create-member-tables.sql、migrations/02-create-member-seed-data.sql |
| 源码 | cn/wujies/member |
那九张表同时也是「彻底删除」时的删表依据:卸载服务从迁移脚本里解析 CREATE TABLE 得到「本应用声明的表」,member_ 前缀不在平台的保护名单内,确实会被删,动手前备份。迁移脚本一经执行内容不可再改,摘要对不上会被账本拒掉,规则见 数据库迁移。