Appearance
User 用户核心模块
User 模块是 C 端用户体系的地基,提供手机号/验证码登录、用户资料、关注粉丝、邀请关系、收货地址、用户偏好、授权记录、注销冷静期等能力。是会员投稿、作者入驻、社区互动的前置依赖。
模块信息
| 属性 | 值 |
|---|---|
| 名称 | user |
| 类型 | 核心模块(基座内置) |
| 描述 | 用户核心 -- 手机号/资料/关注/邀请/地址/偏好/注销 |
| 版本 | v2.1.0 新增(S1-S5 基座升级) |
核心能力
| 能力 | 说明 |
|---|---|
| 手机号登录 | 手机+验证码登录(短信通道配置化) |
| 邮箱验证码 | 邮箱+验证码登录/找回 |
| 用户资料 | 昵称/头像/性别/生日/简介 |
| 关注粉丝 | 用户间关注/粉丝关系 |
| 邀请关系 | 邀请码/邀请树 |
| 收货地址 | 多地址管理 |
| 用户偏好 | 语言/时区/通知偏好 |
| 授权记录 | 第三方授权/OAuth 记录 |
| 注销冷静期 | 注销 7 天冷静期,可撤销 |
| C 端 username | 自动生成用户名(如 user_abc123) |
数据模型
User(用户主表扩展)
表名: users(在原有基础上扩展)
| 字段 | 类型 | 说明 |
|---|---|---|
| Phone | string(20) | 手机号(租户内唯一) |
| Source | string(50) | 注册来源(email/phone/oauth) |
UserProfile(用户资料)
表名: user_profiles
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt |
| Nickname | string(100) | 昵称 |
| Avatar | string(500) | 头像 URL |
| Gender | int | 性别(0=未知, 1=男, 2=女) |
| Birthday | date | 生日 |
| Bio | text | 个人简介 |
| Website | string(500) | 个人网站 |
UserVerification(实名认证)
表名: user_verifications
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt |
| Level | int | 认证级别(0=未认证, 1=手机, 2=邮箱, 3=实名) |
| RealNameHash | string(64) | 实名哈希(脱敏存储) |
| IDCardHash | string(64) | 身份证哈希(脱敏存储) |
UserAddress(收货地址)
表名: user_addresses
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt |
| ReceiverName | string(100) | 收件人 |
| Phone | string(20) | 联系电话 |
| Province | string(50) | 省 |
| City | string(50) | 市 |
| District | string(50) | 区 |
| Address | string(500) | 详细地址 |
| IsDefault | bool | 是否默认 |
UserFollow(关注关系)
表名: user_follows
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, CreatedAt, UpdatedAt, DeletedAt |
| FollowerID | string | 关注者用户 ID |
| FollowingID | string | 被关注者用户 ID |
UserInvite(邀请关系)
表名: user_invites
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, CreatedAt, UpdatedAt, DeletedAt |
| InviterID | string | 邀请人用户 ID |
| InviteeID | string | 被邀请人用户 ID |
| InviteCode | string(20) | 邀请码 |
UserConsent(授权记录)
表名: user_consents
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt |
| ConsentType | string(50) | 授权类型(privacy/terms/marketing) |
| Version | string(20) | 协议版本 |
| GrantedAt | timestamp | 授权时间 |
| RevokedAt | timestamp | 撤销时间 |
UserPreference(用户偏好)
表名: user_preferences
| 字段 | 类型 | 说明 |
|---|---|---|
| (BaseEntity) | embedded | ID, TenantID, UserID, CreatedAt, UpdatedAt, DeletedAt |
| Language | string(10) | 语言(zh-CN/en-US) |
| Timezone | string(50) | 时区(Asia/Shanghai) |
| NotificationEmail | bool | 邮件通知开关 |
| NotificationSMS | bool | 短信通知开关 |
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 | 通知接收方 |

