feat(documents): 增强上传反馈与状态展示

apps/documents/models.py

@@ -2,6 +2,7 @@ from django.db import models
 
 
 class UploadedDocument(models.Model):
+    # 文档状态用于驱动前端提示和后续可操作项。
     STATUS_UPLOADED = "uploaded"
     STATUS_INDEXED = "indexed"
     STATUS_FAILED = "failed"
@@ -21,3 +22,11 @@ class UploadedDocument(models.Model):
 
     def __str__(self) -> str:
         return self.original_name
+
+    def get_status_display_text(self) -> str:
+        """为模板提供更适合演示的中文状态文案。"""
+        return {
+            self.STATUS_UPLOADED: "已上传，待入库",
+            self.STATUS_INDEXED: "已入库，可检索",
+            self.STATUS_FAILED: "入库失败",
+        }.get(self.status, self.status)