Update 0001_initial.py

src/DjangoBlog-master/owntracks/migrations/0001_initial.py

@@ -1,31 +1,56 @@
-# Generated by Django 4.1.7 on 2023-03-02 07:14
+# 由 Django 4.1.7 于 2023年3月2日 07:14 自动生成
+# 该文件是Django的数据迁移文件，用于定义数据库模型结构的变更
 
 from django.db import migrations, models
 import django.utils.timezone
 
 
 class Migration(migrations.Migration):
-
+    # 标记为初始迁移（首次创建模型时使用）
     initial = True
 
+    # 依赖的其他迁移文件，初始迁移无依赖
     dependencies = [
     ]
 
+    # 迁移操作列表
     operations = [
+        # 创建名为'OwnTrackLog'的数据模型
         migrations.CreateModel(
             name='OwnTrackLog',
             fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('tid', models.CharField(max_length=100, verbose_name='用户')),
-                ('lat', models.FloatField(verbose_name='纬度')),
-                ('lon', models.FloatField(verbose_name='经度')),
-                ('created_time', models.DateTimeField(default=django.utils.timezone.now, verbose_name='创建时间')),
+                # 自增主键字段，类型为BigAutoField（大整数自增）
+                ('id', models.BigAutoField(
+                    auto_created=True,  # 自动创建
+                    primary_key=True,   # 作为主键
+                    serialize=False,    # 不序列化
+                    verbose_name='ID'   # 字段显示名称
+                )),
+                # 用户标识字段，字符串类型，最大长度100
+                ('tid', models.CharField(
+                    max_length=100, 
+                    verbose_name='用户'  # 显示名称为“用户”
+                )),
+                # 纬度字段，浮点型
+                ('lat', models.FloatField(
+                    verbose_name='纬度'  # 显示名称为“纬度”
+                )),
+                # 经度字段，浮点型
+                ('lon', models.FloatField(
+                    verbose_name='经度'  # 显示名称为“经度”
+                )),
+                # 创建时间字段，默认值为当前时间（时区感知）
+                ('created_time', models.DateTimeField(
+                    default=django.utils.timezone.now,  # 默认值为当前时间
+                    verbose_name='创建时间'  # 显示名称为“创建时间”
+                )),
             ],
+            # 模型的额外配置选项
             options={
-                'verbose_name': 'OwnTrackLogs',
-                'verbose_name_plural': 'OwnTrackLogs',
-                'ordering': ['created_time'],
-                'get_latest_by': 'created_time',
+                'verbose_name': 'OwnTrackLogs',  # 模型的单数显示名称
+                'verbose_name_plural': 'OwnTrackLogs',  # 模型的复数显示名称（此处与单数相同）
+                'ordering': ['created_time'],  # 默认排序方式：按创建时间升序
+                'get_latest_by': 'created_time',  # 指定通过created_time字段获取最新记录
             },
         ),
     ]