# FRR：该模块定义了评论(Comment)数据模型，用于存储用户对文章的评论信息，
# 包括评论内容、作者、关联文章、创建时间等字段，同时支持评论回复功能（父子评论关联）。

from django.conf import settings
from django.db import models
from django.utils.timezone import now  # 用于获取当前时间
from django.utils.translation import gettext_lazy as _  # 用于国际化翻译

from blog.models import Article  # 导入文章模型，建立评论与文章的关联


# FRR：评论模型类，继承自Django的Model基类，映射数据库中的评论表
class Comment(models.Model):
    # FRR：评论正文字段，TextField支持长文本，max_length限制最大长度为300字符
    body = models.TextField('正文', max_length=300)
    
    # FRR：评论创建时间字段，默认值为当前时间，verbose_name用于后台显示的字段名（国际化）
    creation_time = models.DateTimeField(_('creation time'), default=now)
    
    # FRR：评论最后修改时间字段，默认值为当前时间，用于记录评论更新时间
    last_modify_time = models.DateTimeField(_('last modify time'), default=now)
    
    # FRR：评论作者外键，关联Django内置的用户模型（settings.AUTH_USER_MODEL）
    # on_delete=models.CASCADE表示：若用户被删除，其评论也会被级联删除
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL,
        verbose_name=_('author'),
        on_delete=models.CASCADE)
    
    # FRR：关联的文章外键，评论属于某篇文章
    # on_delete=models.CASCADE表示：若文章被删除，其下所有评论也会被级联删除
    article = models.ForeignKey(
        Article,
        verbose_name=_('article'),
        on_delete=models.CASCADE)
    
    # FRR：父评论外键，实现评论回复功能（自关联）
    # 'self'表示关联自身模型，blank=True和null=True允许为空（即一级评论无父评论）
    # on_delete=models.CASCADE表示：若父评论被删除，其下所有子评论也会被级联删除
    parent_comment = models.ForeignKey(
        'self',
        verbose_name=_('parent comment'),
        blank=True,
        null=True,
        on_delete=models.CASCADE)
    
    # FRR：评论是否启用的状态字段，默认值为False（可能需要管理员审核后启用）
    # blank=False和null=False表示该字段为必填项，不允许为空
    is_enable = models.BooleanField(_('enable'),
                                    default=False, blank=False, null=False)

    # FRR：Meta内部类用于配置模型的元数据
    class Meta:
        ordering = ['-id']  # 数据查询时按id降序排列（最新评论在前）
        verbose_name = _('comment')  # 模型的单数显示名称（国际化）
        verbose_name_plural = verbose_name  # 模型的复数显示名称（与单数相同）
        get_latest_by = 'id'  # 指定通过id字段获取最新记录

    # FRR：定义模型实例的字符串表示，返回评论正文（便于在后台和调试时识别对象）
    def __str__(self):
        return self.body