Update admin.py

src/DjangoBlog-master/owntracks/admin.py

@@ -1,7 +1,13 @@
+# 导入Django的admin模块，用于管理后台配置
 from django.contrib import admin
 
+# 注册模型的地方（当前尚未注册任何模型）
 # Register your models here.
 
 
+# 定义OwnTrackLogs模型的Admin管理类
+# 继承自ModelAdmin，这是Django admin的基础管理类
 class OwnTrackLogsAdmin(admin.ModelAdmin):
+    # pass表示暂时不添加任何自定义配置
+    # 此时会使用ModelAdmin的默认配置来展示和管理模型数据
     pass

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

@@ -1,31 +1,40 @@
-# Generated by Django 4.1.7 on 2023-03-02 07:14
+# 由Django 4.1.7在2023年3月2日07:14生成
-
 from django.db import migrations, models
 import django.utils.timezone
 
 
 class Migration(migrations.Migration):
+    """数据库迁移类，用于定义数据库结构的变更"""
 
+    # 标识这是初始迁移（第一次创建模型）
     initial = True
 
+    # 依赖的其他迁移文件，初始迁移没有依赖
     dependencies = [
     ]
 
+    # 定义要执行的数据库操作列表
     operations = [
+        # 创建一个新的数据模型（数据库表）
         migrations.CreateModel(
-            name='OwnTrackLog',
+            name='OwnTrackLog',  # 模型名称，对应数据库中的表名
-            fields=[
+            fields=[  # 模型包含的字段定义
+                # 自增主键字段，BigAutoField会自动生成大整数类型的唯一ID
                 ('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={
+            options={  # 模型的额外配置选项
-                'verbose_name': 'OwnTrackLogs',
+                'verbose_name': 'OwnTrackLogs',  # 模型的单数显示名称
-                'verbose_name_plural': 'OwnTrackLogs',
+                'verbose_name_plural': 'OwnTrackLogs',  # 模型的复数显示名称
-                'ordering': ['created_time'],
+                'ordering': ['created_time'],  # 默认排序方式，按创建时间升序
-                'get_latest_by': 'created_time',
+                'get_latest_by': 'created_time',  # 指定获取最新记录时使用的字段
             },
         ),
     ]

src/DjangoBlog-master/owntracks/migrations/0002_alter_owntracklog_options_and_more.py

@@ -1,22 +1,36 @@
-# Generated by Django 4.2.5 on 2023-09-06 13:19
+# 由Django 4.2.5版本在2023年9月6日13:19自动生成
-
 from django.db import migrations
 
 
 class Migration(migrations.Migration):
+    """
+    数据库迁移类，用于修改现有数据模型的结构和配置
+    这是一个增量迁移，基于之前的迁移进行修改
+    """
 
+    # 依赖关系：表示此迁移依赖于'owntracks'应用中的0001_initial迁移
+    # 执行此迁移前必须先执行完依赖的迁移
     dependencies = [
         ('owntracks', '0001_initial'),
     ]
 
+    # 定义要执行的数据库操作列表
     operations = [
+        # 修改模型的配置选项
         migrations.AlterModelOptions(
-            name='owntracklog',
+            name='owntracklog',  # 要修改的模型名称
-            options={'get_latest_by': 'creation_time', 'ordering': ['creation_time'], 'verbose_name': 'OwnTrackLogs', 'verbose_name_plural': 'OwnTrackLogs'},
+            # 新的模型配置选项
+            options={
+                'get_latest_by': 'creation_time',  # 更新获取最新记录的字段为creation_time
+                'ordering': ['creation_time'],  # 更新默认排序字段为creation_time
+                'verbose_name': 'OwnTrackLogs',  # 模型的单数显示名称（未变）
+                'verbose_name_plural': 'OwnTrackLogs'  # 模型的复数显示名称（未变）
+            },
         ),
+        # 重命名字段
         migrations.RenameField(
-            model_name='owntracklog',
+            model_name='owntracklog',  # 要操作的模型名称
-            old_name='created_time',
+            old_name='created_time',  # 原字段名
-            new_name='creation_time',
+            new_name='creation_time',  # 新字段名
         ),
     ]