|
|
"""lrj：
|
|
|
OAuth 认证模块数据模型定义
|
|
|
提供第三方登录用户信息和配置管理的数据结构
|
|
|
"""
|
|
|
|
|
|
from django.conf import settings
|
|
|
from django.core.exceptions import ValidationError
|
|
|
from django.db import models
|
|
|
from django.utils.timezone import now
|
|
|
from django.utils.translation import gettext_lazy as _
|
|
|
|
|
|
|
|
|
class OAuthUser(models.Model):
|
|
|
"""lrj：
|
|
|
OAuth 第三方登录用户信息模型
|
|
|
存储通过第三方平台(微博、GitHub等)登录的用户信息
|
|
|
"""
|
|
|
|
|
|
# lrj：关联本站用户，可为空(用户首次第三方登录时尚未绑定本站账号)
|
|
|
author = models.ForeignKey(
|
|
|
settings.AUTH_USER_MODEL,
|
|
|
verbose_name=_('author'), # lrj：翻译：作者
|
|
|
blank=True,
|
|
|
null=True,
|
|
|
on_delete=models.CASCADE) # lrj：级联删除：本站用户删除时同步删除OAuth关联
|
|
|
|
|
|
# lrj：第三方平台的用户唯一标识
|
|
|
openid = models.CharField(max_length=50)
|
|
|
|
|
|
# lrj：第三方平台的用户昵称
|
|
|
nickname = models.CharField(max_length=50, verbose_name=_('nick name'))
|
|
|
|
|
|
# lrj：OAuth访问令牌，用于调用第三方平台API
|
|
|
token = models.CharField(max_length=150, null=True, blank=True)
|
|
|
|
|
|
# lrj：用户头像URL
|
|
|
picture = models.CharField(max_length=350, blank=True, null=True)
|
|
|
|
|
|
# lrj：第三方平台类型：weibo, github, google等
|
|
|
type = models.CharField(blank=False, null=False, max_length=50)
|
|
|
|
|
|
# lrj：用户邮箱(从第三方平台获取)
|
|
|
email = models.CharField(max_length=50, null=True, blank=True)
|
|
|
|
|
|
# lrj：原始元数据，存储从第三方平台返回的完整用户信息(JSON格式)
|
|
|
metadata = models.TextField(null=True, blank=True)
|
|
|
|
|
|
# lrj：记录创建时间，自动设置为当前时间
|
|
|
creation_time = models.DateTimeField(_('creation time'), default=now)
|
|
|
|
|
|
#lrj： 最后修改时间，自动更新为当前时间
|
|
|
last_modify_time = models.DateTimeField(_('last modify time'), default=now)
|
|
|
|
|
|
def __str__(self):
|
|
|
"""lrj：管理员界面显示的用户标识"""
|
|
|
return self.nickname
|
|
|
|
|
|
class Meta:
|
|
|
"""lrj：模型元数据配置"""
|
|
|
verbose_name = _('oauth user') # lrj：单数显示名称
|
|
|
verbose_name_plural = verbose_name # lrj：复数显示名称
|
|
|
ordering = ['-creation_time'] # lrj：默认按创建时间降序排列
|
|
|
|
|
|
|
|
|
class OAuthConfig(models.Model):
|
|
|
"""lrj：
|
|
|
OAuth 应用配置模型
|
|
|
存储各个第三方平台的OAuth应用配置信息
|
|
|
"""
|
|
|
|
|
|
# lrj：支持的第三方平台类型选项
|
|
|
TYPE = (
|
|
|
('weibo', _('weibo')), # lrj：微博
|
|
|
('google', _('google')), # 谷歌
|
|
|
('github', 'GitHub'), # lrj：GitHub
|
|
|
('facebook', 'FaceBook'), # lrj：Facebook
|
|
|
('qq', 'QQ'), # lrj：QQ
|
|
|
)
|
|
|
|
|
|
# lrj：平台类型选择
|
|
|
type = models.CharField(_('type'), max_length=10, choices=TYPE, default='a')
|
|
|
|
|
|
# lrj：OAuth应用的AppKey/Client ID
|
|
|
appkey = models.CharField(max_length=200, verbose_name='AppKey')
|
|
|
|
|
|
# lrj：OAuth应用的AppSecret/Client Secret
|
|
|
appsecret = models.CharField(max_length=200, verbose_name='AppSecret')
|
|
|
|
|
|
# lrj：OAuth回调URL，用于接收授权码
|
|
|
callback_url = models.CharField(
|
|
|
max_length=200,
|
|
|
verbose_name=_('callback url'),
|
|
|
blank=False,
|
|
|
default='')
|
|
|
|
|
|
# lrj：是否启用该平台配置
|
|
|
is_enable = models.BooleanField(
|
|
|
_('is enable'), default=True, blank=False, null=False)
|
|
|
|
|
|
# lrj：配置创建时间
|
|
|
creation_time = models.DateTimeField(_('creation time'), default=now)
|
|
|
|
|
|
# lrj：配置最后修改时间
|
|
|
last_modify_time = models.DateTimeField(_('last modify time'), default=now)
|
|
|
|
|
|
def clean(self):
|
|
|
"""lrj：
|
|
|
数据验证方法：确保同类型平台配置唯一
|
|
|
避免重复配置同一个第三方平台
|
|
|
"""
|
|
|
if OAuthConfig.objects.filter(
|
|
|
type=self.type).exclude(id=self.id).count():
|
|
|
raise ValidationError(_(self.type + _('already exists')))
|
|
|
|
|
|
def __str__(self):
|
|
|
"""lrj：管理员界面显示的配置标识"""
|
|
|
return self.type
|
|
|
|
|
|
class Meta:
|
|
|
"""lrj：模型元数据配置"""
|
|
|
verbose_name = 'OAuth配置' # lrj：单数显示名称
|
|
|
verbose_name_plural = verbose_name # lrj：复数显示名称
|
|
|
ordering = ['-creation_time'] # lrj：默认按创建时间降序排列
|
|
|
|
