# Create your models here.
# 备注：当前文件定义了OAuth相关的数据模型

# 导入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):
    """第三方登录用户关联模型，存储用户与第三方平台的绑定信息"""
    # 关联本地用户模型（外键）
    # - 允许为空（支持未绑定本地账号的场景）
    # - 级联删除（本地用户删除时，关联记录也删除）
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        verbose_name=_('author'),  # 国际化显示名称"作者/用户"
        blank=True,
        null=True,
        on_delete=models.CASCADE)

    # 第三方平台返回的用户唯一标识（如微信openid、GitHub id等）
    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)

    # 第三方用户的头像图片地址（允许为空）
    picture = models.CharField(max_length=350, blank=True, null=True)

    # 第三方平台类型（如'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):
    """第三方登录平台配置模型，存储各平台的授权参数"""
    # 定义支持的第三方平台类型选项（元组形式，(存储值, 显示值)）
    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
    appkey = models.CharField(max_length=200, verbose_name='AppKey')

    # 第三方平台申请的AppSecret
    appsecret = models.CharField(max_length=200, verbose_name='AppSecret')

    # 授权回调地址（必选字段，默认空字符串）
    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']  # 默认按创建时间倒序排序