黄臻代码注释

src/DjangoBlog-master/servermanager/models.py

@@ -3,6 +3,18 @@ from django.db import models
 
 # Create your models here.
 class commands(models.Model):
+    """
+    命令模型类
+
+    用于存储命令相关信息的数据库模型
+
+    Attributes:
+        title (CharField): 命令标题，最大长度300字符
+        command (CharField): 命令内容，最大长度2000字符
+        describe (CharField): 命令描述，最大长度300字符
+        creation_time (DateTimeField): 创建时间，自动设置为记录创建时的时间
+        last_modify_time (DateTimeField): 修改时间，自动更新为记录每次修改的时间
+    """
     title = models.CharField('命令标题', max_length=300)
     command = models.CharField('命令', max_length=2000)
     describe = models.CharField('命令描述', max_length=300)
@@ -10,14 +22,37 @@ class commands(models.Model):
     last_modify_time = models.DateTimeField('修改时间', auto_now=True)
 
     def __str__(self):
+        """
+        返回命令对象的字符串表示
+
+        Returns:
+            str: 命令的标题
+        """
         return self.title
 
     class Meta:
+        """
+        模型元数据配置
+
+        配置模型在Django管理界面中的显示名称
+        """
         verbose_name = '命令'
         verbose_name_plural = verbose_name
 
 
 class EmailSendLog(models.Model):
+    """
+    邮件发送日志模型类
+
+    用于记录邮件发送历史和结果的数据库模型
+
+    Attributes:
+        emailto (CharField): 收件人邮箱地址，最大长度300字符
+        title (CharField): 邮件标题，最大长度2000字符
+        content (TextField): 邮件正文内容
+        send_result (BooleanField): 邮件发送结果，True表示成功，False表示失败
+        creation_time (DateTimeField): 创建时间，自动设置为记录创建时的时间
+    """
     emailto = models.CharField('收件人', max_length=300)
     title = models.CharField('邮件标题', max_length=2000)
     content = models.TextField('邮件内容')
@@ -25,9 +60,20 @@ class EmailSendLog(models.Model):
     creation_time = models.DateTimeField('创建时间', auto_now_add=True)
 
     def __str__(self):
+        """
+        返回邮件发送日志对象的字符串表示
+
+        Returns:
+            str: 邮件的标题
+        """
         return self.title
 
     class Meta:
+        """
+        模型元数据配置
+
+        配置模型在Django管理界面中的显示名称和排序规则
+        """
         verbose_name = '邮件发送log'
         verbose_name_plural = verbose_name
         ordering = ['-creation_time']