|
|
# 赵瑞萍：评论模型迁移模块，用于定义Comment模型在数据库中的初始结构
|
|
|
# 该模块通过Django迁移系统创建评论表，支持用户对文章的评论及嵌套回复功能
|
|
|
# 生成于Django 4.1.7版本，包含字段定义、关联关系及数据库操作规则
|
|
|
|
|
|
# 赵瑞萍：导入Django迁移所需核心模块
|
|
|
from django.conf import settings # 用于获取项目配置的用户模型
|
|
|
from django.db import migrations, models # 提供数据库迁移操作和字段类型
|
|
|
import django.db.models.deletion # 用于定义外键删除时的关联行为
|
|
|
import django.utils.timezone # 提供带时区的时间处理工具
|
|
|
|
|
|
|
|
|
class Migration(migrations.Migration):
|
|
|
"""
|
|
|
赵瑞萍：迁移类，封装评论模型的数据库结构创建逻辑
|
|
|
负责定义迁移依赖关系和具体的表创建操作，确保数据库结构与模型一致
|
|
|
"""
|
|
|
|
|
|
# 赵瑞萍：标记为初始迁移，即首次创建该模型对应的数据库表
|
|
|
initial = True
|
|
|
|
|
|
# 赵瑞萍：迁移依赖配置，确保执行顺序正确
|
|
|
dependencies = [
|
|
|
('blog', '0001_initial'), # 依赖blog应用的初始迁移，确保Article表已存在
|
|
|
migrations.swappable_dependency(settings.AUTH_USER_MODEL), # 依赖用户模型迁移，确保用户表存在
|
|
|
]
|
|
|
|
|
|
# 赵瑞萍：数据库操作列表，此处为创建Comment表的核心操作
|
|
|
operations = [
|
|
|
# 赵瑞萍：创建Comment模型对应的数据库表
|
|
|
migrations.CreateModel(
|
|
|
name='Comment', # 模型名称，对应数据库表名为comments_comment
|
|
|
fields=[
|
|
|
# 赵瑞萍：主键字段，自动增长的大整数类型
|
|
|
('id', models.BigAutoField(
|
|
|
auto_created=True, # 自动生成主键值，无需手动赋值
|
|
|
primary_key=True, # 设为主键，唯一标识每条评论记录
|
|
|
serialize=False, # 序列化模型时不包含该字段
|
|
|
verbose_name='ID' # 后台管理界面显示的字段名称
|
|
|
)),
|
|
|
# 赵瑞萍：评论正文字段，存储用户输入的评论内容
|
|
|
('body', models.TextField(
|
|
|
max_length=300, # 限制最大长度为300字符，控制评论长度
|
|
|
verbose_name='正文' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：评论创建时间字段，记录评论发布的时间
|
|
|
('created_time', models.DateTimeField(
|
|
|
default=django.utils.timezone.now, # 默认值为当前时区时间
|
|
|
verbose_name='创建时间' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：评论修改时间字段，记录评论最后更新的时间
|
|
|
('last_mod_time', models.DateTimeField(
|
|
|
default=django.utils.timezone.now, # 默认值为当前时间，更新时需手动刷新
|
|
|
verbose_name='修改时间' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：评论显示状态字段，控制评论是否在前端展示
|
|
|
('is_enable', models.BooleanField(
|
|
|
default=True, # 默认值为True，新评论默认可见
|
|
|
verbose_name='是否显示' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：外键字段，关联文章模型，建立评论与所属文章的关系
|
|
|
('article', models.ForeignKey(
|
|
|
on_delete=django.db.models.deletion.CASCADE, # 级联删除：文章删除时，关联评论同步删除
|
|
|
to='blog.article', # 关联目标为blog应用的Article模型
|
|
|
verbose_name='文章' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：外键字段，关联用户模型，记录评论的发布者
|
|
|
('author', models.ForeignKey(
|
|
|
on_delete=django.db.models.deletion.CASCADE, # 级联删除：用户删除时，其发布的评论同步删除
|
|
|
to=settings.AUTH_USER_MODEL, # 关联目标为项目配置的用户模型
|
|
|
verbose_name='作者' # 后台显示名称
|
|
|
)),
|
|
|
# 赵瑞萍：外键自关联，实现评论的嵌套回复功能
|
|
|
('parent_comment', models.ForeignKey(
|
|
|
blank=True, # 表单提交时允许为空（一级评论无需上级评论）
|
|
|
null=True, # 数据库字段允许为NULL
|
|
|
on_delete=django.db.models.deletion.CASCADE, # 级联删除：上级评论删除时，回复评论同步删除
|
|
|
to='comments.comment', # 关联目标为当前应用的Comment模型
|
|
|
verbose_name='上级评论' # 后台显示名称
|
|
|
)),
|
|
|
],
|
|
|
# 赵瑞萍：模型元数据配置，定义表的显示和行为规则
|
|
|
options={
|
|
|
'verbose_name': '评论', # 模型的单数显示名称
|
|
|
'verbose_name_plural': '评论', # 模型的复数显示名称（中文无复数变化）
|
|
|
'ordering': ['-id'], # 默认排序规则：按id降序（最新评论优先显示）
|
|
|
'get_latest_by': 'id', # 调用latest()方法时，以id字段作为判断最新的依据
|
|
|
},
|
|
|
),
|
|
|
] |
