中国 帮助

会员管理

官方 付费 应用

Wujies 无界平台(wujies.cn)的会员应用,一个插件一个仓库:

v1.0.9 2 次安装 本季度 1 次

<p> <a href="https://wujies.cn" target="_blank" rel="nofollow"> <img width="100" src="https://wujies.cn/brand/logo-stacked.svg" alt="Wujies 无界 logo"> </a> </p>

<p><b>会员管理</b>,会员档案、等级、余额、积分、成长值、徽章、签到与收货地址。</p> <p> <a rel="nofollow"><img alt="应用版本" src="https://img.shields.io/badge/app-1.0.9-111111?style=flat-square"></a> <a rel="nofollow"><img alt="应用编码" src="https://img.shields.io/badge/code-member-0057FE?style=flat-square"></a> <a rel="nofollow"><img alt="License" src="https://img.shields.io/badge/license-commercial-orange?style=flat-square"></a> <br> <a rel="nofollow">功能特性</a> <a rel="nofollow">预览</a> <a rel="nofollow">安装</a> <a rel="nofollow">设置</a> <a rel="nofollow">常见问题</a> <a href="https://docs.wujies.cn/docs/wujies/5.x/platform/plugin" rel="nofollow">插件开发</a> <a href="https://gitee.com/wujies" rel="nofollow">Gitee</a> </p>


Wujies 无界平台(wujies.cn)的会员应用,一个插件一个仓库:

  • 后台:应用市场装上后多一个「会员管理」菜单,九个页面(会员列表、会员等级、会员收货地址、 会员徽章、会员余额、会员积分、会员成长值、会员徽章发放、会员每日签到),前端是远程应用 (frontend/,46 个文件)。
  • 移动端:/portal/member 与 /portal/member/address(PortalMemberController、 PortalMemberAddressController),路径与插件化之前一致;C 端页面本身在宿主 wujies-web,不在本仓库。
  • 对外给内容中心用的一条匿名只读接口:GET /site/member/profiles?userIds=1,2,3 (MemberSiteController,类级映射实测就是 /site/member)—— 评论行上只有 user_id, 前台评论挂件拿这批 id 一次问齐昵称、头像、等级与勋章(MemberSiteProfileVo)。
  • 前台页面:本应用不出直出的公开页,仓库里没有 site-templates/。

应用编码 member | 应用版本 1.0.9 | 后端构件 wujies-member-plugin | 引擎 &gt;=5.6.2 &lt;6.0.0

✨ 功能特性

  • 👤 会员档案 — 列表 + 详情,注册即自动建档(MemberRegisterListener,幂等,赠 500 积分)。
  • 🏅 会员等级 — 内置 V1–V10 十档(03 脚本),等级图标随包走;成长值与等级联动在服务层。
  • 💰 余额 / 积分 / 成长值 — 三条流水各自一页,余额与积分的变动都留痕。
  • 🎖️ 徽章 — 19 个内置徽章(成长 / 荣誉 / 成就 / 限定四组),另有「徽章发放」页手工授予。
  • 📅 每日签到 — 签到、连签与签到记录;签到发积分走同一套积分账。
  • 🏠 收货地址 — 后台可查,C 端走 /portal/member/address 增删改查。
  • ⏳ 积分过期 — snail-job 任务 memberPointsExpireTask 扫描到期积分并回收(调度在平台里配)。
  • 🔌 会员契约 — PlatformMemberApi 适配器(PlatformMemberApiAdapter)给钱包支付、商城等应用读会员等级/徽章。
  • 🧩 匿名作者资料 — /site/member/profiles 一次最多 50 个 id,只出公开字段。
  • 🔐 多租户 — 会员、流水、徽章、地址都带 tenant_id,与平台其它应用同一套租户口径。

📸 预览

会员管理主界面

![会员管理主界面](docs/screenshots/member.png)

🚀 安装

环境要求

| 项 | 要求 | |---|---| | 平台版本 | &gt;=5.6.2 &lt;6.0.0(app.json 的 engine) | | 后端构建 | JDK 17+(父 POM 的 java.version 为 17) | | 前端构建 | Node.js 18+(建议 20 LTS 及以上),npm | | 安装方式 | 管理端「应用市场 → 本地安装」上传 zip,或由上架中心(wujies-market)发布后拉取 |

从应用市场安装

  1. 打开管理端「应用市场 → 本地安装」,上传打包好的 zip;或经上架中心发布后由平台拉取。
  2. 安装时自动执行 migrations/ 下的四个脚本:01 建表、02 通用种子(等级 V1–V7、示例会员、 徽章、签到)、03 内置 V1–V10 等级与成就徽章(带保护的 UPDATE,只替换仍是原始种子 OSS 图标的行)、 04 周年徽章描述(按 member.register_time 算「注册 N 周年」)。
  3. 装完刷新菜单,出现「会员管理」即成功。

包里两个产物的路径由 app.json 的 assets 决定: frontend → frontend/index.js | backend → backend/wujies-member-plugin-1.0.9.jar。

版本对不上的口径:Maven 构件版本跟着父 pom 走(现在是 1.0.0,target/ 里就是 wujies-member-plugin-1.0.0.jar),包内那个 jar 由脚本按 app.json 的 version 重命名成 -&lt;应用版本&gt;.jar,所以 assets.backend 声明的 1.0.9 不需要去改 pom; 要把默认版本也提上去,改 app.json 的 version(-Version 只改本次包内那份清单,不动源文件)。

从源码构建

在本仓库根打包(三条命令各管一段,都在本仓库根执行):

powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -CheckOnly   # ① 打包前检查:清单/产物/迁移/菜单/密钥,几秒返回
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1 -Dev         # ② 开发包:不签名,落 ..\.plugin-dist\member\dev
powershell -NoProfile -ExecutionPolicy Bypass -File package.ps1              # ③ 正式包:构建 + 用 keys\private.pem 签名

关于上面三条命令的取值口径:

  • 判据是「脚本所在仓库根有没有 app.json」,所以在本仓库里不要传 -Plugin(它按子目录找清单, 会报「找不到插件目录」);-FrontendProject / -FrontendDist 也不用传 —— 独立布局的前端工程固定就是 本仓库 frontend/、产物 frontend/dist,脚本自己跑 npm run build(首次先 cd frontend &amp;&amp; npm install, 缺依赖时脚本会把这条命令直接报给你)。只想复用现成产物就加 -SkipBuild。
  • -SkipFrontend 只用于没有前端的纯后端应用:带前端时它会连「复制前端产物」一起跳过, 出的包只有 app.json,装上去没有界面。
  • -CheckOnly 打出的 CHECK|级别|项|说明 行就是管理端「开发工具 → 插件开发 → 打包」抽屉里那份体检清单, 两边跑的是同一套检查;有 ERROR 时正式打包会被直接拦下。签名密钥在本仓库 keys/ (private.pem + public.pem,已在 .gitignore 里),生成或更换用 -Keygen (覆盖已有密钥要显式加 -KeygenForce,旧钥先整份备份进 keys\backup\&lt;时间戳&gt;\)。 参数全表与产物结构见文档站「打包应用」与「密钥与签名」两页。

手工构建(不用打包脚本时):

mvn -B -o package -DskipTests                # 后端(前提见「常见问题」里的父 pom 一条)
cd frontend &amp;&amp; npm install &amp;&amp; npm run build  # 前端,产物 dist/index.js + assets/member-app.css

最快的开发路子不用打包、不用重启宿主:启动平台宿主,打开管理端「开发工具 → 插件开发」, 找到 member 这一行点「启动后端」(自动编译并加载 target/classes,同时开启监听)与「启动前端」 (常驻 vite build --watch,保存源码即重建,刷新页面生效,没有 HMR)。全流程见 文档站「插件开发」。

升级与卸载

  • 升级:换 app.json 的 version 后重新打包上传;已执行的迁移脚本不可改内容 —— 平台按 (app_code, 脚本名) 记 SHA-256 锁定,改了会让校验失败。新增表结构一律加新编号脚本。
  • 卸载:管理端「应用市场」里卸载,平台按 migrations/ 记录的建表脚本清理会员相关的数据表。

⚙️ 设置

本应用没有单独的配置页(migrations/ 里也不写 sys_config):等级、徽章、签到与流水都在各自的 菜单页里维护。三处「藏在代码里」的口径:

  • 注册赠分:MemberRegisterListener.REGISTER_BONUS_POINTS = 500,注册即送;要改是改常量,不是改配置。
  • 积分过期:由 snail-job 任务 memberPointsExpireTask 驱动(MemberPointsExpireTask), 调度周期在平台任务管理里配,插件只提供执行体。
  • 徽章/等级图:静态资源在 public/assets/member/(宿主两份)与插件前端各自读同一组路径,见「等级与徽章素材」。

菜单入口

| 菜单 | 路径 | 组件键 | 权限前缀 | |---|---|---|---| | 会员列表 | member | remote:member/member/member | member:member:list | | 会员等级 | level | remote:member/member/level | member:level:list | | 会员收货地址 | address | remote:member/member/address | member:address:list | | 会员徽章 | badge | remote:member/member/badge | member:badge:list | | 会员余额 | balanceLog | remote:member/member/balanceLog | member:balanceLog:list | | 会员积分 | pointsLog | remote:member/member/pointsLog | member:pointsLog:list | | 会员成长值 | growthLog | remote:member/member/growthLog | member:growthLog:list | | 会员徽章发放 | badgeGrant | remote:member/member/badgeGrant | member:badgeGrant:list | | 会员每日签到 | checkinRecord | remote:member/member/checkinRecord | member:checkinRecord:list |

&gt; 权限点全是 member: 前缀(与 app.json 里每个 C/F 节点的 perms 逐字对应); &gt; 改前缀会让已授权角色失效,所以保留。

门户与公开入口:

| 接口 | 鉴权 | 说明 | |---|---|---| | /portal/member/** | 只要求登录 | 当前用户的信息、详情、改资料、余额、积分、成长、等级、徽章墙、签到、签到状态/汇总/记录 | | /portal/member/address/** | 只要求登录 | 地址列表、单条、增删改 | | GET /site/member/profiles?userIds= | 匿名 + 最多 50 个 id | 只出昵称、头像、等级、徽章;余额/积分/成长值/总消费/实名/手机号一个都不出 |

🧩 依赖与插件支持

| 项 | 说明 | |---|---| | 依赖插件 | 无(app.json 的 dependencies 为空) | | 被谁依赖 | pay(钱包按会员读余额/积分口径)、mall(展示会员等级与徽章);对外的唯一入口是 PlatformMemberApi | | 平台事件 | 监听 UserRegisteredEvent 自动建档;失败只记 WARN,绝不回滚用户注册 | | CMS 主题 | 评论作者块调 /site/member/profiles,另一半约定在内容中心的 CmsThemeProperties.AUTHOR_API_URL,改路径两处要一起动 | | 平台存储 | 头像上传走平台「存储配置」,本插件不另存密钥 | | 公共 API | 前端走打进包内的 @wujies/api-client,运行时由宿主 import map 提供 vue / element-plus / @wujies/ui-shared 单例 |

等级与徽章素材

内置等级与徽章图是随包静态资源,不是上传件,所以在三个地方各有一份,改一处必须同步全部:

| 位置 | 作用 | |---|---| | wujies-member-plugin/frontend/src/utils/memberVisual.ts | 插件后台页面用:LEVEL_IMAGE_MAP(V1–V10 → /assets/member/levels/vN.webp)、BADGE_IMAGE_MAP(19 个内置徽章码 → /assets/member/badges/*.webp) | | wujies-admin/src/utils/memberVisual.ts | 管理端宿主用:同样的两张表,多 MEMBER_ASSET_VERSION + versionedMemberAsset() 与 BADGE_SECTIONS(成长/荣誉/成就/限定) | | wujies-web/src/utils/memberVisual.ts | C 端宿主(会员中心)用:同样两张表 |

  • 静态图本身有两份,内容必须完全一致:wujies-admin/public/assets/member/ 与 wujies-web/public/assets/member/;migrations/03 里写的 icon 路径也是这一组。
  • .svg → .webp 归一化:早期种子写的是 /assets/member/badges/x.svg, 而种子脚本的校验和已锁定不能改内容,所以 getMemberBadgeImage 在读取时把旧后缀换成 .webp —— 看到代码里这段替换不要以为是历史包袱没清。
  • 换图要 bump 版本号:宿主 nginx 对静态资源有 7 天强缓存,wujies-admin 侧的 MEMBER_ASSET_VERSION = '20261110' 会让路径带版本参数;替换内置图后不改这个值,浏览器会继续显示旧图。

会员中心与深链

C 端「会员中心」在宿主 wujies-web(src/router/index.ts),13 条路由全部带 meta.appCode: 'member', 宿主据此把页面归到会员应用(不是插件自己发的页面,改这里不用发插件包):

| 路径 | 页面 | |---|---| | /member | 用户中心 | | /member/orders | 我的订单 | | /member/orders/:id | 订单详情 | | /member/orders/:id/after-sale | 申请售后 | | /member/profile | 资料设置 | | /member/addresses | 我的地址 | | /member/coupon | 我的优惠券 | | /member/security | 安全中心 | | /member/balance | 财富中心(余额) | | /member/points | 财富中心(积分,复用余额页) | | /member/growth | 成长记录 | | /member/checkin | 签到中心 | | /member/badges | 徽章中心 |

另外还有一个「消息中心」页也挂 appCode: 'member'。深链口径:

  • /member 在匿名白名单里(未登录也能落地再由页面引导登录);/mall/product 走 whitePrefixList 以便商品冷链接直接打开;/mall/checkout/:id 故意不在匿名白名单 —— 结算必须登录。
  • 内容中心与商城拼深链时用 consoleUrl + /member?redirect=… / consoleUrl + /login?redirect=…, redirect 做 URL 编码(+ 转 %20);consoleUrl 没配时模板不渲染这两个入口。

开发环境

git clone git@gitee.com:wujies/wujies-member-plugin.git
cd wujies-member-plugin

打包脚本:本仓库自带完整的 package.ps1(母本在 wujies-plugins 仓库根,各仓用 node scripts/sync-package-script.mjs 同步过来),clone 下来就能在本仓库根直接体检、构建、签名、出包、 生成密钥,不需要回到单体仓库,也不需要手工传产物路径。

前端 SDK:已迁到已发布的 @wujies/* SDK(ui-shared / components / api-client / ui-plugin-bundler-kit)。frontend/vite.config.ts 只声明 defineRemoteApp({ appCode, root }), 共享依赖一律 external、运行期由宿主 import map 兜到同一份实例;宿主独有工具与业务模块 (@/utils/wujies、@/api/system/*、UserSelect/MemberSelect 等)按原样复制进了 frontend/src/, proxy?.$modal / useDict / download 与 ImageUpload/UserDetail/Module*Settings 由宿主运行时提供。 本仓库前端可独立构建;要直接落位到宿主,构建前设 WUJIES_FRONTEND_DIST=/app-market-dist/remote-apps。

仓库布局

| 位置 | 内容 | |---|---| | pom.xml | Maven 模块(父 pom = cn.wujies.plugins:wujies-plugins-parent,` 已置空;构件版本仍随父 pom 为 1.0.0`) | | app.json | 应用清单,打包器读的唯一事实来源(code / version / menus / assets) | | src/ | Java 源码(85 个文件,含 site/ 与 portal/ 两族控制器)、Mapper XML | | src/main/java/cn/wujies/member/listener/、task/ | MemberRegisterListener(注册建档 + 赠分)、MemberPointsExpireTask(snail-job 执行体) | | migrations/ | 4 个脚本:01 建表、02 种子、03 内置 V1–V10 等级与成就徽章、04 周年徽章描述 | | frontend/ | 远程应用源码(src/ 46 个文件),入口 frontend/src/index.ts,等级/徽章映射在 src/utils/memberVisual.ts |

❓ 常见问题

Q:陌生人 clone 后 mvn package 报找不到 wujies-plugins-parent? 父 pom 与 wujies-common-* 目前只有本地 mvn install 出来的版本,还没发布到 Maven 仓库 (后端构件发布那一阶段才补)。本机装过就能通,本机实测 mvn -B -o package -DskipTests 通过。

Q:打包时提示「找不到插件目录」? 在本仓库根不要传 -Plugin —— 脚本按「仓库根有没有 app.json」判定布局,传了它就去找子目录清单。

Q:新用户注册后没有会员档案、也没收到 500 积分? 建档监听是同步的,但异常被刻意吞掉(只打 WARN 用户注册后建会员档案失败),以免会员侧问题回滚注册; 重复投递也不会建出第二个会员。先查那条 WARN 与平台事件是否发出。

Q:会员中心/后台的等级图、徽章图 404? 图在宿主的 public/assets/member/(wujies-admin 与 wujies-web 各一份),路径写死在 memberVisual.ts 与 migrations/03 里;只拷一份就会出现另一端点 404(见「等级与徽章素材」)。

Q:换了内置徽章图,浏览器还是显示旧的? 宿主 nginx 对静态资源强缓存 7 天,要 bump wujies-admin 里的 MEMBER_ASSET_VERSION, 让 versionedMemberAsset() 生成新路径。

Q:为什么徽章图路径里 .svg 被代码改成了 .webp? 早期种子写的是 .svg,而种子脚本的内容已按校验和锁定不能改,所以读取时归一化到 .webp。

Q:前端构建产物里有裸 vue 之类的 import,会不会找不到? 正常。vue / element-plus / @wujies/ui-shared 由宿主 import map 提供单例,属于刻意 external。

🔒 隐私与外部资源

  • 不收集、不上报任何遥测;会员档案、余额、积分、成长值、地址只存本平台数据库(按 tenant_id 隔离)。
  • 匿名接口 /site/member/profiles 只回公开字段(昵称、头像、等级、徽章),一次最多 50 个 id, 查不到的 id 不塞 null —— 前台拼不到的那条评论画成「匿名 + 没有头衔」。
  • 头像等上传件存放位置由平台「存储配置」决定,本插件代码里不写任何密钥。
  • README 与仓库中不包含任何真实口令、token 或私钥;签名密钥只在本机 keys/(已 gitignore)。

📄 许可证与致谢

商业授权:需要一枚覆盖本应用的有效授权凭证才允许安装与加载(条文见仓库根目录 LICENSE)。 清单 app.json 里 license 为 UNLICENSED、licenseRequired 为 true;三档口径见官网文档「授权与版本」。

💬 反馈与建议

参考

wujies-hello-plugin(已按新布局跑通前端独立构建的样板)、 wujies-ui(npm 上 @wujies/* 四件套的源码仓)、 wujies-pay-plugin(钱包支付策略在本进程内直接用本仓库的会员契约)、 文档站「插件开发」章节。

v1.0.9 2026-11-10 平台 >=5.6.2 <6.0.0 402 KB

新增

  • 徽章墙进度接口与徽章/等级页改版,发布 1.0.9

修复

  • 头像空值保护与任务日志改 slf4j
  • 同步公钥检查——开源仓 yml 只有环境变量占位符时改比部署仓 keys/package-public.pem

重构

  • 注释瘦身;站点资料补等级与勋章图字段

其他

  • member 1.0.5 —— 版本号与包内 jar 名同步
v1.0.8 2026-11-10 平台 >=5.6.2 <6.0.0 398 KB

徽章按条件自动发放(注册天数/周年/签到/原创文章/评论/文章点赞/评论点赞/阅读量);个人中心徽章页改为成长/荣誉/成就/限定四分区;周年徽章描述改为注册满 N 周年。

v1.0.7 2026-11-10 平台 >=5.6.2 <6.0.0 392 KB

等级扩至 V10(10 张内置压缩等级图)+ 16 枚原创内置徽章;等级/徽章图标改为随前端分发的内置静态资源(/assets/member/...),不再依赖外部 OSS。

v1.0.6 2026-11-08 平台 >=5.6.2 <6.0.0 388 KB

patch 升级 1.0.6

v1.0.5 2026-11-08 平台 >=5.6.2 <6.0.0 388 KB

patch 升级 1.0.5

v1.0.3 2026-10-02 平台 >=5.6.2 <6.0.0 377 KB

这个版本没有写更新日志。

v1.0.2 2026-10-01 平台 >=5.6.2 <6.0.0 375 KB

这个版本没有写更新日志。

v1.0.1 2026-10-01 平台 >=5.6.2 <6.0.0 375 KB

这个版本没有写更新日志。

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