主题
会员(预留模块)
MBR-00 | Maven
pmforge-module-member| 状态 ⏸ 预留(已纳入构建,未接入运行时)
C 端会员:会员档案、等级、标签、积分记录与配置、签到与优惠券。system 通过反射调用它的 MemberUserApi,未启用时会抛 ClassNotFoundException。
1. 模块概览
| 项 | 值 |
|---|---|
| Maven 模块 | pmforge-module-member |
| 控制器 | 20 |
| 接口 | 72 |
| 唯一权限点 | 26 |
| 数据对象(DO) | 11 |
| 已拆功能点 | 8 项 |
| 需求原件 | 05-01-会员管理 |
2. 能力清单
| 能力 | 优先级 | 状态 |
|---|---|---|
| 会员列表 | P0 | ⏸ 预留 |
| 会员详情 | P0 | ⏸ 预留 |
| 会员标签 | P1 | ⏸ 预留 |
| 会员等级 | P1 | ⏸ 预留 |
| 积分记录 | P1 | ⏸ 预留 |
| 积分配置 | P1 | ⏸ 预留 |
| 签到配置 | P2 | ⏸ 预留 |
| 优惠券 | P2 | ⏸ 预留 |
共 8 项,与能力地图的统计口径一致;状态为「预留」:代码在库、已通过编译验证,尚未接入 server 运行时。
3. 控制器与接口
| Controller | 路径前缀 | 接口 | 权限点 | 代码位置 |
|---|---|---|---|---|
| AppAuthController | /member/auth | 10 | 0 | modules/member/src/main/java/com/pmforge/module/member/controller/app/auth/AppAuthController.java#L45 |
| MemberTagController | /member/tag | 7 | 4 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/tag/MemberTagController.java#L35 |
| AppAddressController | /member/address | 6 | 0 | modules/member/src/main/java/com/pmforge/module/member/controller/app/address/AppAddressController.java#L32 |
| AppMemberUserController | /member/user | 6 | 0 | modules/member/src/main/java/com/pmforge/module/member/controller/app/user/AppMemberUserController.java#L35 |
| MemberGroupController | /member/group | 6 | 4 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/group/MemberGroupController.java#L32 |
| MemberLevelController | /member/level | 6 | 4 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/level/MemberLevelController.java#L30 |
| AppSocialUserController | /member/social-user | 5 | 0 | modules/member/src/main/java/com/pmforge/module/member/controller/app/social/AppSocialUserController.java#L36 |
| MemberSignInConfigController | /member/sign-in/config | 5 | 4 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/signin/MemberSignInConfigController.java#L33 |
| MemberUserController | /member/user | 5 | 4 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/user/MemberUserController.java#L54 |
| AppMemberSignInRecordController | /member/sign-in/record | 3 | 0 | modules/member/src/main/java/com/pmforge/module/member/controller/app/signin/AppMemberSignInRecordController.java#L33 |
| MemberConfigController | /member/config | 2 | 2 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/config/MemberConfigController.java#L29 |
| MemberExperienceRecordController | /member/experience-record | 2 | 1 | modules/member/src/main/java/com/pmforge/module/member/controller/admin/level/MemberExperienceRecordController.java#L34 |
| … | 其余 8 个 | 见接口索引 |
4. 数据对象
| 表 | DO | 字段数 |
|---|---|---|
member_address | MemberAddressDO | 0 |
member_config | MemberConfigDO | 0 |
member_experience_record | MemberExperienceRecordDO | 0 |
member_group | MemberGroupDO | 0 |
member_level | MemberLevelDO | 0 |
member_level_record | MemberLevelRecordDO | 0 |
member_point_record | MemberPointRecordDO | 0 |
member_sign_in_config | MemberSignInConfigDO | 0 |
member_sign_in_record | MemberSignInRecordDO | 0 |
member_tag | MemberTagDO | 0 |
member_user | MemberUserDO | 0 |
主库脚本
sql/mysql/pmforge.sql只覆盖 system 与 infra,本模块的表结构以 DO 为准;启用前需自备 DDL(部分模块有测试脚本src/test/resources/sql/create_tables.sql)。
5. 启用前提
依赖:mall 的 product 子模块依赖它;建议在 pay 之前或同时启用。
- 根 pom 取消
pmforge-module-member注释 - server 加依赖
- 导入模块测试 DDL
- 补菜单与权限点(
member:*、app-api侧接口)
6. 风险与注意
system的MemberServiceImpl用SpringUtil.getBean(ClassUtil.loadClass(...))+ 反射取手机号邮箱,属软依赖,未启用即运行期异常而非降级- 会员端接口走
/app-api,与后台菜单体系分开
7. 关联
- 相关页面:MOD-RSV-00
- 相关页面:SYS-USER-01
- 模块手册:/modules/reserved/
- 接口索引:/code/api/member