|
|
# 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 |
