首页 / Java 平台（cloud-java） / member 会员
member 会员
APP 用户、登录安全、家庭管理、会员等级与积分体系。
职责概览
会员模块 独立端口 48092，面向 APP 用户（member_user）提供：注册登录与账号安全、家庭管理、会员等级、积分/签到、社交绑定、常用地址、FAQ、意见反馈、消息通知配置与常用文档。
接口清单
| 分组 | Controller | 说明 |
|---|---|---|
| 登录认证 | AppAuthController | APP 注册、登录、找回密码、令牌刷新 |
| 账号安全 | AppTotpController、MemberTotpController、MemberTotpRecoveryCodeController | TOTP 双因子与恢复码（后台管理） |
| 用户资料 | AppMemberUserController | 个人资料、头像、设置 |
| 家庭 | AppMemberFamilyController、MemberFamilyMemberController | 家庭创建/成员管理（家庭分享的基础） |
| 等级/积分 | AppMemberLevelController、AppMemberExperienceRecordController、AppMemberPointRecordController、MemberLevelController、MemberExperienceRecordController | 会员等级、经验与积分流水 |
| 签到/社交 | AppMemberSignInConfigController、AppMemberSignInRecordController、AppSocialUserController | 签到配置与记录、第三方社交账号绑定 |
| 辅助能力 | AppAddressController、AppMemberMarkLocationController、AppMemberFaqController、AppMemberUserFeedbackController、AppMemberCommonDocsController | 地址、标记位置、FAQ、反馈、文档 |
| 通知配置 | AppMemberNotificationConfigController、MemberNotificationConfigController | 用户级通知偏好 |
| 标签 | MemberTagController | 会员标签管理 |
关键实现
- MFA：TOTP 密钥与恢复码属敏感数据，不得写日志；绑定/解绑流程需二次校验。
- 家庭模型：家庭是设备分享与订阅 Seat 分配的常见主体，成员角色决定操作权限。
- 消息消费：member 模块存在
mq/consumer消费者（按 profile 启用），涉及积分、通知等异步更新。
数据与维护注意
核心表：member_*（23 张），覆盖用户、家庭、等级、积分、签到、地址、社交、标签、通知配置等。
- 字段语义以实际 DO/表为准，尤其"用户 ID"存在
member_id/user_id等多种命名。 - 会员注销/封禁需级联处理家庭、分享与订阅 Seat 占用。