Skip to content

User 用户核心模块 ​

User 模块是 C 端用户体系的地基,提供手机号/验证码登录、用户资料、关注粉丝、邀请关系、收货地址、用户偏好、授权记录、注销冷静期等能力。是会员投稿、作者入驻、社区互动的前置依赖。

模块信息 ​

属性值
名称user
类型核心模块(基座内置)
描述用户核心 -- 手机号/资料/关注/邀请/地址/偏好/注销
版本v2.1.0 新增(S1-S5 基座升级)

核心能力 ​

能力说明
手机号登录手机+验证码登录(短信通道配置化)
邮箱验证码邮箱+验证码登录/找回
用户资料昵称/头像/性别/生日/简介
关注粉丝用户间关注/粉丝关系
邀请关系邀请码/邀请树
收货地址多地址管理
用户偏好语言/时区/通知偏好
授权记录第三方授权/OAuth 记录
注销冷静期注销 7 天冷静期,可撤销
C 端 username自动生成用户名(如 user_abc123)

数据模型 ​

User(用户主表扩展) ​

表名: users(在原有基础上扩展)

字段类型说明
Phonestring(20)手机号(租户内唯一)
Sourcestring(50)注册来源(email/phone/oauth)

UserProfile(用户资料) ​

表名: user_profiles

字段类型说明
(BaseEntity)embeddedID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt
Nicknamestring(100)昵称
Avatarstring(500)头像 URL
Genderint性别(0=未知, 1=男, 2=女)
Birthdaydate生日
Biotext个人简介
Websitestring(500)个人网站

UserVerification(实名认证) ​

表名: user_verifications

字段类型说明
(BaseEntity)embeddedID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt
Levelint认证级别(0=未认证, 1=手机, 2=邮箱, 3=实名)
RealNameHashstring(64)实名哈希(脱敏存储)
IDCardHashstring(64)身份证哈希(脱敏存储)

UserAddress(收货地址) ​

表名: user_addresses

字段类型说明
(BaseEntity)embeddedID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt
ReceiverNamestring(100)收件人
Phonestring(20)联系电话
Provincestring(50)省
Citystring(50)市
Districtstring(50)区
Addressstring(500)详细地址
IsDefaultbool是否默认

UserFollow(关注关系) ​

表名: user_follows

字段类型说明
(BaseEntity)embeddedID, TenantID, CreatedAt, UpdatedAt, DeletedAt
FollowerIDstring关注者用户 ID
FollowingIDstring被关注者用户 ID

UserInvite(邀请关系) ​

表名: user_invites

字段类型说明
(BaseEntity)embeddedID, TenantID, CreatedAt, UpdatedAt, DeletedAt
InviterIDstring邀请人用户 ID
InviteeIDstring被邀请人用户 ID
InviteCodestring(20)邀请码

UserConsent(授权记录) ​

表名: user_consents

字段类型说明
(BaseEntity)embeddedID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt
ConsentTypestring(50)授权类型(privacy/terms/marketing)
Versionstring(20)协议版本
GrantedAttimestamp授权时间
RevokedAttimestamp撤销时间

UserPreference(用户偏好) ​

表名: user_preferences

字段类型说明
(BaseEntity)embeddedID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt
Languagestring(10)语言(zh-CN/en-US)
Timezonestring(50)时区(Asia/Shanghai)
NotificationEmailbool邮件通知开关
NotificationSMSbool短信通知开关

API 端点 ​

认证增强 ​

POST /api/v1/auth/login/phone    # 手机+验证码登录
POST /api/v1/auth/login/email    # 邮箱+验证码登录
POST /api/v1/auth/send-code      # 发送验证码
POST /api/v1/auth/logout         # 注销(进入 7 天冷静期)
POST /api/v1/auth/cancel-logout  # 撤销注销

用户资料 ​

GET  /api/v1/me/profile          # 获取我的资料
PUT  /api/v1/me/profile          # 更新我的资料
GET  /api/v1/me/addresses        # 我的地址列表
POST /api/v1/me/addresses        # 添加地址
PUT  /api/v1/me/addresses/:id    # 更新地址
DELETE /api/v1/me/addresses/:id  # 删除地址
GET  /api/v1/me/preferences      # 我的偏好
PUT  /api/v1/me/preferences      # 更新偏好

关注关系 ​

POST /api/v1/users/:id/follow    # 关注用户
DELETE /api/v1/users/:id/follow  # 取消关注
GET  /api/v1/users/:id/followers # 粉丝列表
GET  /api/v1/users/:id/following # 关注列表

邀请关系 ​

GET  /api/v1/me/invite-code      # 获取我的邀请码
GET  /api/v1/me/invites          # 我的邀请记录

权限点 ​

权限说明
user.read查看用户
user.write编辑用户
user.delete删除用户
user.address.manage管理地址
user.preference.manage管理偏好

迁移历史 ​

迁移编号说明
000015_user_core用户核心扩展(users 加 phone/source + user_profiles + user_verifications)
000016_user_relations用户关系表(user_addresses + user_follows + user_invites + user_consents + user_preferences)

分拣边界 ​

进基座(通用能力) ​

  • 手机号/验证码登录
  • 用户资料/关注/邀请/地址/偏好
  • 实名级别+脱敏存储
  • 注销冷静期

留应用层(秒折扣特有) ​

  • 成长值+七级会员
  • 权益矩阵
  • 付费会员订阅
  • 四资产(活力分/礼赠分/💎/金豆)
  • 二级分润计算
  • 风控规则
  • 私域运营工具

注意: 金豆碰资金需持牌分账,绝不进基座。

与其他模块关系 ​

模块关系
auth认证增强(验证码登录/注销)
author作者关联用户
cms会员投稿关联用户
notification通知接收方

Released under the Apache 2.0 License.