feat: 动态生成资料包异常提示

apps/documents/services.py

@@ -247,6 +247,59 @@ def build_batch_rows(batches) -> list[dict]:
     return rows
 
 
+def build_exception_items(batches, documents) -> list[dict]:
+    """
+    聚合资料包页需要关注的异常提示。
+
+    只返回真实存在的异常来源，避免页面继续展示静态 demo 文案：
+    - 批次级待复核
+    - 文档级待人工复核
+    - 文档级处理失败
+    """
+    items = []
+
+    for document in documents:
+        if document.status == UploadedDocument.STATUS_FAILED:
+            items.append(
+                {
+                    "level": "失败",
+                    "title": f"文档处理失败：{document.original_name}",
+                    "detail": document.error_message or "文档处理异常，请重新上传或稍后重试。",
+                }
+            )
+            continue
+
+        if document.needs_manual_review:
+            review_reasons = []
+            if document.file_type.lower() == "docx" and document.page_count_confidence != "exact":
+                review_reasons.append("页数为估算值，建议人工确认")
+            if not document.chapter_code or document.chapter_match_status != "matched":
+                review_reasons.append("章节点未识别，建议人工确认归类")
+            items.append(
+                {
+                    "level": "待确认",
+                    "title": f"文档待人工复核：{document.original_name}",
+                    "detail": "；".join(review_reasons) or "资料存在待确认项，建议人工复核。",
+                }
+            )
+
+    for batch in batches:
+        if batch.import_status != SubmissionBatch.STATUS_REVIEW_REQUIRED:
+            continue
+        items.append(
+            {
+                "level": "待确认",
+                "title": f"资料包待复核：{batch.batch_id}",
+                "detail": (
+                    f"{batch.product_name or '未识别产品名称'} 当前存在 "
+                    f"{batch.exception_count} 项异常，请进入关联会话或处理历史继续复核。"
+                ),
+            }
+        )
+
+    return items
+
+
 def extract_text(document: UploadedDocument) -> str:
     """
     根据文档类型选择合适的文本抽取策略。

apps/documents/views.py

@@ -7,7 +7,12 @@ from apps.scenarios.services import list_scenarios
 
 from .forms import DocumentUploadForm
 from .models import SubmissionBatch, UploadedDocument
-from .services import build_batch_rows, import_submission_batch, index_document
+from .services import (
+    build_batch_rows,
+    build_exception_items,
+    import_submission_batch,
+    index_document,
+)
 
 
 def document_list(request):
@@ -18,14 +23,21 @@ def document_list(request):
         batches = batches.filter(
             Q(product_name__icontains=keyword) | Q(batch_id__icontains=keyword)
         )
-    documents = UploadedDocument.objects.all()
+    batches = list(batches)
+    documents = list(UploadedDocument.objects.all())
     status_counts = {
-        "pending": batches.filter(import_status=SubmissionBatch.STATUS_PENDING).count(),
-        "completed": batches.filter(import_status=SubmissionBatch.STATUS_COMPLETED).count(),
-        "review_required": batches.filter(
-            import_status=SubmissionBatch.STATUS_REVIEW_REQUIRED
-        ).count(),
-        "total": batches.count(),
+        "pending": sum(
+            1 for batch in batches if batch.import_status == SubmissionBatch.STATUS_PENDING
+        ),
+        "completed": sum(
+            1 for batch in batches if batch.import_status == SubmissionBatch.STATUS_COMPLETED
+        ),
+        "review_required": sum(
+            1
+            for batch in batches
+            if batch.import_status == SubmissionBatch.STATUS_REVIEW_REQUIRED
+        ),
+        "total": len(batches),
     }
     processing_pipeline = [
         {"title": "原始文件接收", "detail": "校验格式、大小和场景归属后保存原件。"},
@@ -34,11 +46,6 @@ def document_list(request):
         {"title": "章节点归类", "detail": "基于文件名、标题和正文线索识别 CH 节点。"},
         {"title": "切片与索引入库", "detail": "生成知识切片，供 RAG、规则定位和审计引用使用。"},
     ]
-    exception_items = [
-        {"level": "待确认", "title": "CH1.2 监管信息目录.docx", "detail": "目录页码与正文页数存在偏差，建议人工复核。"},
-        {"level": "低可信度", "title": "目标产品说明书.docx", "detail": "Word 页数为估算值，表格抽取质量良好。"},
-        {"level": "失败", "title": "沟通记录扫描件.pdf", "detail": "疑似扫描件，需补做 OCR 或重新上传清晰版。"},
-    ]
     return render(
         request,
         "documents/document_list.html",
@@ -49,7 +56,7 @@ def document_list(request):
             "keyword": keyword,
             "status_counts": status_counts,
             "processing_pipeline": processing_pipeline,
-            "exception_items": exception_items,
+            "exception_items": build_exception_items(batches, documents),
         },
     )