B-42: 导入功能加固——逐工作表确认、流式上传与诊断证据

src/bank_importer/models.py

@@ -40,3 +40,23 @@ class StatementBatch:
     transactions: tuple[NormalizedTransaction, ...]
     warnings: tuple[str, ...]
     template_version: int = 1
+
+
+@dataclass(frozen=True)
+class SheetResult:
+    """Per-worksheet parse outcome with the four diagnostic evidence items.
+
+    ``outcome`` is the deterministic parse verdict: ``parsed`` (transactions
+    normalized), ``exception`` (template/header/balance problems) or
+    ``ignored`` (empty or single-cell sheets with no bank content). The human
+    decision about whether a parsed sheet may participate in calculations is
+    a separate lifecycle stage (``review_status``), persisted in
+    ``sheet_reviews``; it is never decided here.
+    """
+
+    sheet_name: str
+    outcome: str  # parsed | exception | ignored
+    message: str | None = None
+    scanned_rows: int | None = None
+    candidate_headers: tuple[str, ...] = ()
+    batch: StatementBatch | None = None