From 764184047fe9cf4826f97f58fb7befc8770c8195 Mon Sep 17 00:00:00 2001
From: ikmkj <1@qq,com>
Date: Mon, 16 Jun 2025 20:57:35 +0800
Subject: [PATCH] =?UTF-8?q?refactor(entity):=20=E4=BC=98=E5=8C=96=E5=AE=9E?=
 =?UTF-8?q?=E4=BD=93=E7=B1=BB=E5=AD=97=E6=AE=B5=E6=8F=8F=E8=BF=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 更新 image 实体类字段描述，明确各字段含义
- 修改 MarkdownFile 实体类字段描述，提高字段可理解性
---
 .../java/com/test/bijihoudaun/entity/Image.java   | 15 ++++++++-------
 .../com/test/bijihoudaun/entity/MarkdownFile.java |  4 ++--
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/Image.java b/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/Image.java
index fe15352..a7909c7 100644
--- a/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/Image.java
+++ b/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/Image.java
@@ -16,27 +16,28 @@ public class Image {
     @Schema(description = "图片id",implementation = Long.class)
     @TableId(type = IdType.AUTO)
     private Long id;
-    @Schema(description = "图片名称",implementation = Long.class  )
+    @Schema(description = "外键，关联用户ID，标识图片所有者\n",implementation = Long.class  )
     private Long userId;
-    @Schema(description = "图片名称",implementation = Long.class  )
+    @Schema(description = " 外键，关联Markdown文件ID，标识图片所属文档",implementation = Long.class  )
     private Long markdownId;
 
-    @Schema(description = "图片名称",implementation = String.class  )
+    @Schema(description = "原始文件名（用户上传时的文件名）",implementation = String.class  )
     @TableField("original_name")
     private String originalName;
 
-    @Schema(description = "图片名称",implementation = String.class  )
+    @Schema(description = "存储文件名（系统生成的唯一文件名）",implementation = String.class  )
     @TableField("stored_name")
     private String storedName;
 
-    @Schema(description = "图片名称",implementation = String.class  )
+    @Schema(description = " 图片访问URL",implementation = String.class  )
     private String url;
-    @Schema(description = "图片大小",implementation = Long.class  )
+    @Schema(description = "图片大小（字节）",implementation = Long.class  )
     private Long size;
 
-    @Schema(description = "图片类型",implementation = String.class  )
+    @Schema(description = "图片MIME类型（如image/jpeg）",implementation = String.class  )
     @TableField("content_type")
     private String contentType;
 
+    @Schema(description = "图片上传时间",implementation = LocalDateTime.class  )
     private LocalDateTime createdAt;
 }
\ No newline at end of file
diff --git a/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/MarkdownFile.java b/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/MarkdownFile.java
index 7e25db3..6ec20e7 100644
--- a/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/MarkdownFile.java
+++ b/biji-houdaun/src/main/java/com/test/bijihoudaun/entity/MarkdownFile.java
@@ -21,11 +21,11 @@ public class MarkdownFile {
     @Schema(description = "文本标题",implementation = String.class)
     private String title;
 
-    @Schema(description = "文本内容",implementation = String.class)
+    @Schema(description = " 文件名（带.md后缀），用于存储和识别",implementation = String.class)
     @TableField("file_name")
     private String fileName;
 
-    @Schema(description = "文本内容",implementation = String.class)
+    @Schema(description = "Markdown内容，存储实际文档内容",implementation = String.class)
     private String content;
     @Schema(description = "创建时间",implementation = LocalDateTime.class)
     private LocalDateTime createdAt;