Wujies 无界平台
应用

会员管理(member)

会员档案怎么和平台账号对上、积分与成长值的规则写在哪一行代码里,以及冻结会员后那人还能不能登录。

应用编码 member,本页对应应用版本 1.0.4(引擎要求 >=5.6.2 <6.0.0),清单 license 为 UNLICENSED、licenseRequired 为 true,装与加载都要先有一枚覆盖本应用的凭证,档位口径见 授权档位,仓库 wujies-member-plugin。

会员应用管的是一个平台账号在业务侧的那层身份:档案、等级、余额、积分、成长值、徽章、签到记录、收货地址。登录名、密码、账号启停、角色归平台的 sys_user,member.user_id 只是指过去的一根线;余额要能真扣钱得靠支付应用配渠道,见 支付管理;读写收货地址最频繁的是 商城管理 的下单链路。

装它

清单里 dependencies 是空的,不挑安装顺序,任何部署都能直接装。装之前确认三件事:

  1. 这台部署有办法产生用户(开放注册或后台新建账号)。会员档案不是手工等来的:宿主发布 UserRegisteredEvent,MemberRegisterListener 收到后幂等建档并送 500 积分;装应用之前已存在的账号不会被补建,插件里没有批量补建入口,只能到「会员列表 → 新增会员」逐条关联。
  2. 角色要能看见菜单。权限码全部以 member: 开头,共 68 个,授到 member:member:list 这一级只是进了页面,充值、冻结、调积分这些动作各自还要对应的 F 级权限码。
  3. 多租户部署按租户隔离:member 与 member_level 都带 tenant_id,等级唯一键是 (tenant_id, level_code),新租户不会自动带上 V1 到 V7 那七行种子,要在该租户下自己建。

安装过程与「装完菜单为什么没立刻出现」见 在部署里使用应用。装成功后侧栏多一个「会员管理」,下面九项:

菜单路由需要的权限码
会员列表membermember:member:list
会员等级levelmember:level:list
会员收货地址addressmember:address:list
会员徽章badgemember:badge:list
会员余额balanceLogmember:balanceLog:list
会员积分pointsLogmember:pointsLog:list
会员成长值growthLogmember:growthLog:list
会员徽章发放badgeGrantmember:badgeGrant:list
会员每日签到checkinRecordmember:checkinRecord:list

配它

这一页没有「会员配置」菜单,仓库的迁移脚本也不往 sys_config 里写任何一行;宿主的模块配置组件 ModuleWebsiteSettings / ModuleBusinessSettings 支持的分类只有 mall、im、exam、gallery、cms。要调的那几个值都以常量或种子行的形式在代码与脚本里,改它们要走发版或改数据,不是改配置:

项现值写在哪什么时候要改
注册赠送积分500MemberRegisterListener 的 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_ 前缀不在平台的保护名单内,确实会被删,动手前备份。迁移脚本一经执行内容不可再改,摘要对不上会被账本拒掉,规则见 数据库迁移。

目录