中国 帮助

会员管理(member)

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

会员管理(member)
封面

> 本文整理自平台文档 docs/wujies/5.x/plugins/member.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-d9a2246b0933-cover.svg)

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

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

装它

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

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

安装过程与「装完菜单为什么没立刻出现」见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps)。装成功后侧栏多一个「会员管理」,下面九项:

菜单路由需要的权限码
会员列表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),要改两处一起改,见 [内容中心](/docs/wujies/5.x/plugins/cms)。

出问题查什么

现象先看
冻结了会员,那个人还能登录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

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-d9a2246b0933-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容