添加 0003_alter_comment_options_remove_comment_created_time_and_more.py 注释

djangoblog/src/DjangoBlog-master/DjangoBlog-master/comments/migrations/0003_alter_comment_options_remove_comment_created_time_and_more.py

@@ -1,60 +1,64 @@
 # Generated by Django 4.2.5 on 2023-09-06 13:13
+from django.conf import settings  # gst: 导入Django项目配置（含用户模型配置）
+from django.db import migrations, models  # gst: 导入数据库迁移和模型字段相关模块
+import django.db.models.deletion  # gst: 导入外键删除行为相关模块
+import django.utils.timezone  # gst: 导入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):  # gst: 定义迁移类，管理数据库模型的修改操作
 
-class Migration(migrations.Migration):
-
-    dependencies = [
-        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
-        ('blog', '0005_alter_article_options_alter_category_options_and_more'),
-        ('comments', '0002_alter_comment_is_enable'),
+    dependencies = [  # gst: 迁移依赖项，指定执行当前迁移前需完成的其他迁移
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),  # gst: 依赖可替换的用户模型（支持自定义用户）
+        ('blog', '0005_alter_article_options_alter_category_options_and_more'),  # gst: 依赖blog应用的0005号迁移（确保Article模型结构最新）
+        ('comments', '0002_alter_comment_is_enable'),  # gst: 依赖comments应用的0002号迁移（确保Comment模型已有基础修改）
     ]
 
-    operations = [
-        migrations.AlterModelOptions(
-            name='comment',
-            options={'get_latest_by': 'id', 'ordering': ['-id'], 'verbose_name': 'comment', 'verbose_name_plural': 'comment'},
-        ),
-        migrations.RemoveField(
-            model_name='comment',
-            name='created_time',
-        ),
-        migrations.RemoveField(
-            model_name='comment',
-            name='last_mod_time',
-        ),
-        migrations.AddField(
-            model_name='comment',
-            name='creation_time',
-            field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='creation time'),
-        ),
-        migrations.AddField(
-            model_name='comment',
-            name='last_modify_time',
-            field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='last modify time'),
-        ),
-        migrations.AlterField(
-            model_name='comment',
-            name='article',
-            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='blog.article', verbose_name='article'),
-        ),
-        migrations.AlterField(
-            model_name='comment',
-            name='author',
-            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='author'),
-        ),
-        migrations.AlterField(
-            model_name='comment',
-            name='is_enable',
-            field=models.BooleanField(default=False, verbose_name='enable'),
-        ),
-        migrations.AlterField(
-            model_name='comment',
-            name='parent_comment',
-            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='comments.comment', verbose_name='parent comment'),
+    operations = [  # gst: 迁移操作列表，定义当前迁移要执行的数据库操作
+        migrations.AlterModelOptions(  # gst: 执行“修改模型选项”的迁移操作
+            model_name='comment',  # gst: 要修改的模型名称（Comment）
+            options={  # gst: 模型选项的新配置
+                'get_latest_by': 'id',  # gst: 使用latest()方法时按id字段获取最新记录
+                'ordering': ['-id'],  # gst: 数据查询默认排序：按主键倒序（最新评论在前）
+                'verbose_name': 'comment',  # gst: 后台管理中模型的单数显示名称（改为英文）
+                'verbose_name_plural': 'comment',  # gst: 后台管理中模型的复数显示名称（改为英文）
+            },
         ),
-    ]
+        migrations.RemoveField(  # gst: 执行“删除字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='created_time',  # gst: 要删除的字段名称（原创建时间字段）
+        ),
+        migrations.RemoveField(  # gst: 执行“删除字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='last_mod_time',  # gst: 要删除的字段名称（原修改时间字段）
+        ),
+        migrations.AddField(  # gst: 执行“添加字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='creation_time',  # gst: 新增字段名称（创建时间，替换原created_time）
+            field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='creation time'),  # gst: 字段类型为日期时间，默认值为当前时区时间，后台显示名称为“creation time”
+        ),
+        migrations.AddField(  # gst: 执行“添加字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='last_modify_time',  # gst: 新增字段名称（修改时间，替换原last_mod_time）
+            field=models.DateTimeField(default=django.utils.timezone.now, verbose_name='last modify time'),  # gst: 字段类型为日期时间，默认值为当前时区时间，后台显示名称为“last modify time”
+        ),
+        migrations.AlterField(  # gst: 执行“修改字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='article',  # gst: 要修改的字段名称（关联文章字段）
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='blog.article', verbose_name='article'),  # gst: 外键关联blog应用的Article模型，删除文章时级联删除评论，后台显示名称为“article”
+        ),
+        migrations.AlterField(  # gst: 执行“修改字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='author',  # gst: 要修改的字段名称（关联作者字段）
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='author'),  # gst: 外键关联用户模型，删除用户时级联删除评论，后台显示名称为“author”
+        ),
+        migrations.AlterField(  # gst: 执行“修改字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='is_enable',  # gst: 要修改的字段名称（是否显示字段）
+            field=models.BooleanField(default=False, verbose_name='enable'),  # gst: 字段类型为布尔型，默认值为False，后台显示名称为“enable”
+        ),
+        migrations.AlterField(  # gst: 执行“修改字段”的迁移操作
+            model_name='comment',  # gst: 要操作的模型（Comment）
+            name='parent_comment',  # gst: 要修改的字段名称（上级评论字段）
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='comments.comment', verbose_name='parent comment'),  # gst: 自关联外键（支持评论回复），允许为空，删除上级评论时级联删除子评论，后台显示名称为“parent comment”
+        ),
+    ]