# Create your models here.
# 导入Django配置、模型相关模块及工具类
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):
    """
    OAuthUser模型：存储通过第三方OAuth登录的用户信息
    关联本地用户模型，记录第三方平台的用户标识、昵称、头像等核心信息
    """
    # 关联本地用户模型（AUTH_USER_MODEL），可为空，级联删除
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        verbose_name=_('author'),  # 国际化字段名：作者/用户
        blank=True,  # 表单提交时可空
        null=True,  # 数据库中可空
        on_delete=models.CASCADE)  # 关联用户删除时，该记录同步删除
    # 第三方平台用户唯一标识（如微博、GitHub的openid）
    openid = models.CharField(max_length=50)
    # 用户昵称，支持国际化显示
    nickname = models.CharField(max_length=50, verbose_name=_('nick name'))
    # 第三方平台访问令牌，可为空
    token = models.CharField(max_length=150, null=True, blank=True)
    # 用户头像图片URL，可为空
    picture = models.CharField(max_length=350, blank=True, null=True)
    # OAuth登录平台类型（如weibo、github），非空
    type = models.CharField(blank=False, null=False, max_length=50)
    # 用户邮箱，可为空
    email = models.CharField(max_length=50, null=True, blank=True)
    # 额外元数据（存储第三方返回的其他信息），文本类型，可为空
    metadata = models.TextField(null=True, blank=True)
    # 创建时间，默认当前时间，支持国际化
    creation_time = models.DateTimeField(_('creation time'), default=now)
    # 最后修改时间，默认当前时间，支持国际化
    last_modify_time = models.DateTimeField(_('last modify time'), default=now)

    def __str__(self):
        """模型实例的字符串表示：返回用户昵称"""
        return self.nickname

    class Meta:
        verbose_name = _('oauth user')  # 模型单数显示名（国际化）
        verbose_name_plural = verbose_name  # 模型复数显示名（与单数一致）
        ordering = ['-creation_time']  # 排序规则：按创建时间倒序


class OAuthConfig(models.Model):
    """
    OAuthConfig模型：存储第三方OAuth登录的平台配置信息
    记录各平台的AppKey、AppSecret、回调地址等核心配置
    """
    # 第三方平台类型选项（元组形式，用于choices参数）
    TYPE = (
        ('weibo', _('weibo')),  # 微博（支持国际化）
        ('google', _('google')),  # 谷歌（支持国际化）
        ('github', 'GitHub'),  # GitHub（固定显示）
        ('facebook', 'FaceBook'),  # FaceBook（固定显示）
        ('qq', 'QQ'),  # QQ（固定显示）
    )
    # 平台类型，关联TYPE选项，默认值为'a'，支持国际化
    type = models.CharField(_('type'), max_length=10, choices=TYPE, default='a')
    # 应用AppKey（第三方平台分配的客户端ID）
    appkey = models.CharField(max_length=200, verbose_name='AppKey')
    # 应用AppSecret（第三方平台分配的客户端密钥）
    appsecret = models.CharField(max_length=200, verbose_name='AppSecret')
    # 回调地址（OAuth授权成功后的跳转地址），非空，默认空字符串，支持国际化
    callback_url = models.CharField(
        max_length=200,
        verbose_name=_('callback url'),
        blank=False,  # 表单提交时不可空
        default='')
    # 是否启用该配置，默认启用，非空
    is_enable = models.BooleanField(
        _('is enable'), default=True, blank=False, null=False)
    # 创建时间，默认当前时间，支持国际化
    creation_time = models.DateTimeField(_('creation time'), default=now)
    # 最后修改时间，默认当前时间，支持国际化
    last_modify_time = models.DateTimeField(_('last modify time'), default=now)

    def clean(self):
        """数据验证方法：确保同一平台类型的配置不重复"""
        # 排除当前记录（编辑时），查询是否已存在同类型的配置
        if OAuthConfig.objects.filter(
                type=self.type).exclude(id=self.id).count():
            # 抛出验证异常，提示该平台配置已存在
            raise ValidationError(_(self.type + _('already exists')))

    def __str__(self):
        """模型实例的字符串表示：返回平台类型"""
        return self.type

    class Meta:
        verbose_name = 'oauth配置'  # 模型单数显示名（中文）
        verbose_name_plural = verbose_name  # 模型复数显示名（与单数一致）
        ordering = ['-creation_time']  # 排序规则：按创建时间倒序