yxy添加 0003.py 注释

djangoblog/src/DjangoBlog-master/DjangoBlog-master/blog/migrations/0003_blogsettings_comment_need_review.py

@@ -1,17 +1,31 @@
-# Generated by Django 4.2.1 on 2023-05-09 07:45
-
+# 生成信息：由Django 4.2.1版本在2023-05-09 07:45自动生成的迁移文件
 from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
+    """
+    数据库迁移类：为网站配置表添加评论审核开关字段
+    用于控制用户评论是否需要管理员审核后才显示，增强内容管理能力
+    """
+
+    # 依赖关系：当前迁移依赖于博客应用的上一个迁移文件（0002_...）
+    # 确保在之前的表结构变更完成后再执行本次迁移
     dependencies = [
         ('blog', '0002_blogsettings_global_footer_and_more'),
     ]
 
+    # 迁移操作：为BlogSettings模型添加评论审核开关字段
     operations = [
         migrations.AddField(
-            model_name='blogsettings',
-            name='comment_need_review',
-            field=models.BooleanField(default=False, verbose_name='评论是否需要审核'),
+            model_name='blogsettings',  # 目标模型：网站配置表（BlogSettings）
+            name='comment_need_review',  # 新字段名称：评论是否需要审核
+            field=models.BooleanField(
+                default=False,  # 默认值为False：评论无需审核，提交后直接显示
+                verbose_name='评论是否需要审核'  # 管理后台显示的字段名称
+            ),
+            # 字段作用：
+            # - 当值为True时：用户提交的评论需管理员在后台审核通过后才会在前端显示
+            # - 当值为False时：评论提交后立即显示，无需审核
+            # 用于防止垃圾评论或违规内容直接展示，提升网站内容安全性
         ),
-    ]
+    ]