> 本文整理自平台文档 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)。装成功后侧栏多一个「会员管理」,下面九项:
| 菜单 | 路由 | 需要的权限码 |
|---|---|---|
| 会员列表 | 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),要改两处一起改,见 [内容中心](/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)


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