US05-03: Parse and Persist Uploader Outcomes (#73)

photo_pipeline/services/upload_batches.py

@@ -18,10 +18,11 @@ cannot undo, so the discipline is:
   vanished ``unknown_requires_verification`` (concept §15) instead of retrying it
   blindly. Resolving that is US05-04.
 
-Per-asset upload *results* are deliberately not interpreted here — parsing the
-report is US05-03. What this story guarantees is that the report exists, is bounded,
-carries no credential, and that the batch's state is an honest description of what
-the process did.
+Per-asset upload *results* are not interpreted here: after the attempt ends the
+report is handed to :class:`~photo_pipeline.services.upload_reports.
+UploadReportService` (US05-03), which classifies every file. The batch ``state``
+stays an honest description of what the *process* did; ``outcome_state`` says
+whether the report's evidence is complete enough to trust.
 """
 
 from __future__ import annotations
@@ -38,6 +39,7 @@ from photo_pipeline.config import Config
 from photo_pipeline.integrations import immich_go
 from photo_pipeline.models import UploadBatch, UploadItem
 from photo_pipeline.services.hashing import sha1_file
+from photo_pipeline.services.upload_reports import UploadReportService
 from photo_pipeline.services.uploads import UploadService
 
 
@@ -238,6 +240,13 @@ class UploadBatchService:
         self._finish(batch_id, token=token, state=state, error=error, result=result)
         if item_state:
             self._set_items(batch_id, item_state)
+        # The report is the only evidence of what happened per file, so it is read
+        # while it is fresh (US05-03). A parse failure must not lose the batch
+        # outcome that was just recorded; the items simply stay unknown.
+        try:
+            UploadReportService(self._session_factory).ingest(batch_id)
+        except OSError:
+            pass
         return self.get(batch_id)
 
     def cancel(self, batch_id: str) -> dict:
@@ -409,6 +418,14 @@ def _batch_dict(row: UploadBatch, items: list[UploadItem]) -> dict:
         "exit_code": row.exit_code,
         "error_code": row.error_code,
         "error_message": row.error_message,
+        # Parsed report evidence (US05-03): what the uploader said per file, and
+        # whether that evidence is complete enough to be trusted.
+        "parser": row.parser,
+        "parser_version": row.parser_version,
+        "parsed_at": row.parsed_at.isoformat() if row.parsed_at else None,
+        "outcome_state": row.outcome_state,
+        "outcome_counts": json.loads(row.outcome_counts) if row.outcome_counts else None,
+        "report_counts": json.loads(row.report_counts) if row.report_counts else None,
         "started_at": row.started_at.isoformat() if row.started_at else None,
         "finished_at": row.finished_at.isoformat() if row.finished_at else None,
         "items": [
@@ -418,6 +435,9 @@ def _batch_dict(row: UploadBatch, items: list[UploadItem]) -> dict:
                 "sha256": item.sha256,
                 "sha1": item.sha1,
                 "state": item.state,
+                "outcome": item.outcome,
+                "evidence": item.evidence,
+                "outcome_at": item.outcome_at.isoformat() if item.outcome_at else None,
             }
             for item in items
         ],