feature: Approval and Promotion to VigilCareClinical

VigilCareRecordsAPI/Services/Interfaces/IVerificationService.cs

@@ -0,0 +1,20 @@
+/// <summary>
+/// Handles batch verification, rejection, and separation-of-duties enforcement.
+/// </summary>
+public interface IVerificationService
+{
+    /// <summary>
+    /// Verifies a batch that is in PendingVerification status.
+    /// Enforces separation of duties: the verifier cannot be the same user who entered the data.
+    /// On pass, transitions to Verified or AwaitingClinicalApproval based on site config.
+    /// On fail (Passed = false), transitions to Rejected with field check notes as the reason.
+    /// </summary>
+    Task<DigitizationBatch> VerifyAsync(Guid batchId, VerifyBatchRequest request, Guid verifierUserId);
+
+    /// <summary>
+    /// Rejects a batch that is in PendingVerification or AwaitingClinicalApproval status.
+    /// Stores the rejection reason on the batch and transitions status to Rejected.
+    /// The batch returns to the entry work queue for re-entry by a data entry clerk.
+    /// </summary>
+    Task<DigitizationBatch> RejectAsync(Guid batchId, RejectBatchRequest request, Guid actorUserId);
+}