feature: Corrections and Supersession

VigilCareRecordsAPI/Models/Records/Batch/BatchDetailResponse.cs

@@ -19,11 +19,16 @@ public record BatchDetailResponse(
     Guid? PromotionEncounterId,
     Guid? SupersedesBatchId,
     bool ClinicianAttestation,
+    bool IsCorrection,
+    SupersessionInfo? Supersession,
     DateTimeOffset CreatedAt,
     DateTimeOffset UpdatedAt
 )
 {
-    public static BatchDetailResponse FromEntity(DigitizationBatch batch, string? documentUrl = null) =>
+    public static BatchDetailResponse FromEntity(
+        DigitizationBatch batch,
+        string? documentUrl = null,
+        SupersessionInfo? supersession = null) =>
         new(
             batch.Id,
             batch.Status.ToDbString(),
@@ -41,7 +46,19 @@ public record BatchDetailResponse(
             batch.PromotionEncounterId,
             batch.SupersedesBatchId,
             batch.ClinicianAttestation,
+            batch.SupersedesBatchId.HasValue,
+            supersession,
             batch.CreatedAt,
             batch.UpdatedAt
         );
+
+    public static SupersessionInfo ToSupersessionInfo(
+        DigitizationBatch supersededBatch,
+        int originalObservationCount) =>
+        new(
+            supersededBatch.Id,
+            supersededBatch.Status.ToDbString(),
+            supersededBatch.PromotedAt ?? supersededBatch.UpdatedAt,
+            originalObservationCount
+        );
 }

VigilCareRecordsAPI/Models/Records/Batch/CreateBatchForm.cs

@@ -1,24 +1,19 @@
 using System.ComponentModel.DataAnnotations;
 
-/// <summary>
-/// Multipart form for batch creation. Combines the uploaded scan with batch metadata
-/// so Swagger documents a single <c>multipart/form-data</c> request.
-/// </summary>
 public class CreateBatchForm
 {
-    /// <summary>PDF, JPEG, or PNG scan (max 25 MB).</summary>
     [Required]
     public IFormFile File { get; set; } = null!;
 
-    /// <summary>Batch type literal, e.g. PATIENT_REGISTRATION or ENCOUNTER_SUMMARY.</summary>
     [Required]
     public string BatchType { get; set; } = null!;
 
-    /// <summary>BACKFILL (default) or LIVE_CAPTURE.</summary>
     public string? Track { get; set; }
 
-    /// <summary>Optional patient link used for duplicate-document detection.</summary>
     public Guid? PatientId { get; set; }
 
-    public CreateBatchRequest ToMetadata() => new(BatchType, Track, PatientId);
-}
+    public Guid? SupersedesBatchId { get; set; }
+
+    public CreateBatchRequest ToMetadata() =>
+        new(BatchType, Track, PatientId, SupersedesBatchId);
+}

VigilCareRecordsAPI/Models/Records/Batch/CreateBatchRequest.cs

@@ -4,5 +4,6 @@
 public record CreateBatchRequest(
     string BatchType,
     string? Track,
-    Guid? PatientId
+    Guid? PatientId,
+    Guid? SupersedesBatchId
 );

VigilCareRecordsAPI/Models/Records/Batch/CreateBatchResult.cs

@@ -0,0 +1,4 @@
+public record CreateBatchResult(
+    DigitizationBatch Batch,
+    SupersessionInfo? Supersession
+);

VigilCareRecordsAPI/Models/Records/Batch/DigitizationEventSummary.cs

@@ -0,0 +1,7 @@
+public record DigitizationEventSummary(
+    string EventType,
+    DateTimeOffset OccurredAt,
+    Guid ActorUserId,
+    string ActorName,
+    string? MetadataJson
+);

VigilCareRecordsAPI/Models/Records/Batch/DigitizationHistoryEntry.cs

@@ -0,0 +1,23 @@
+public record DigitizationHistoryEntry(
+    Guid BatchId,
+    string Status,
+    string BatchType,
+    string Track,
+    Guid? SupersedesBatchId,
+    bool IsCorrection,
+    bool HasBeenSuperseded,
+    Guid? SupersededByBatchId,
+    int DraftObservationCount,
+    int LiveObservationCount,
+    int SupersededObservationCount,
+    DateTimeOffset CreatedAt,
+    DateTimeOffset? PromotedAt,
+    Guid? PromotionEncounterId,
+    Guid? EnteredByUserId,
+    string? EnteredByUserName,
+    Guid? VerifiedByUserId,
+    string? VerifiedByUserName,
+    Guid? ApprovedByUserId,
+    string? ApprovedByUserName,
+    IReadOnlyList<DigitizationEventSummary> AuditTrail
+);

VigilCareRecordsAPI/Models/Records/Batch/PatientDigitizationHistoryResponse.cs

@@ -0,0 +1,8 @@
+public record PatientDigitizationHistoryResponse(
+    Guid PatientId,
+    int TotalBatches,
+    int PromotedBatches,
+    int SupersededBatches,
+    int PendingBatches,
+    IReadOnlyList<DigitizationHistoryEntry> Entries
+);

VigilCareRecordsAPI/Models/Records/Batch/SupersessionInfo.cs

@@ -0,0 +1,6 @@
+public record SupersessionInfo(
+    Guid OriginalBatchId,
+    string OriginalBatchStatus,
+    DateTimeOffset OriginalPromotedAt,
+    int OriginalObservationCount
+);