feat(SaveDocStatusCommand): enhance SaveDocStatusCommandHandler with flexible envelope & receiver filters

- Added support for filtering by Envelope.Id or Envelope.Uuid
- Added support for filtering by Receiver.Id, Receiver.EmailAddress, or Receiver.Signature
- Throw BadRequestException when required identifiers are missing
- Updated repository queries to combine envelope and receiver filters

EnvelopeGenerator.Application/DocStatus/Commands/SaveDocStatusCommand.cs

@@ -1,4 +1,5 @@
 using DigitalData.Core.Abstraction.Application.Repository;
+using DigitalData.Core.Exceptions;
 using EnvelopeGenerator.Domain.Entities;
 using MediatR;
 using Microsoft.EntityFrameworkCore;
@@ -36,15 +37,30 @@ public class SaveDocStatusCommandHandler : IRequestHandler<SaveDocStatusCommand,
     /// <returns></returns>
     public async Task<int?> Handle(SaveDocStatusCommand request, CancellationToken cancel)
     {
-        Expression<Func<DocumentStatus, bool>> filter = ds => ds.EnvelopeId == request.EnvelopeId && ds.ReceiverId == request.ReceiverId;
+        // envelope filter
+        Expression<Func<DocumentStatus, bool>>? eExp =
+            request.Envelope.Id is not null 
+            ? ds => ds.EnvelopeId == request.Envelope.Id
+                : !string.IsNullOrWhiteSpace(request.Envelope.Uuid) 
+                ? ds => ds.Envelope.Uuid == request.Envelope.Uuid
+                    : throw new BadRequestException();
+
+        // receiver filter
+        Expression<Func<DocumentStatus, bool>>? rExp =
+            request.Receiver.Id is not null
+                ? ds => ds.ReceiverId == request.Receiver.Id
+                : request.Receiver.EmailAddress is not null
+                    ? ds => ds.Receiver.EmailAddress == request.Receiver.EmailAddress
+                    : !string.IsNullOrWhiteSpace(request.Receiver.Signature) ? ds => ds.Receiver.Signature == request.Receiver.Signature
+                        : throw new BadRequestException();
 
         // ceck if exists
-        bool isExists = await _repo.ReadOnly().Where(filter).AnyAsync(cancel);
+        bool isExists = await _repo.ReadOnly().Where(eExp).Where(rExp).AnyAsync(cancel);
 
         if (isExists)
         {
             var uReq = request.To<UpdateDocStatusCommand>();
-            await _repo.UpdateAsync(uReq, filter, cancel);
+            await _repo.UpdateAsync(uReq, q => q.Where(eExp).Where(rExp), cancel);
         }
         else
         {
@@ -52,7 +68,7 @@ public class SaveDocStatusCommandHandler : IRequestHandler<SaveDocStatusCommand,
             await _repo.CreateAsync(cReq, cancel);
         }
 
-        var docStatus = await _repo.ReadOnly().Where(filter).FirstOrDefaultAsync(cancel);
+        var docStatus = await _repo.ReadOnly().Where(eExp).Where(rExp).FirstOrDefaultAsync(cancel);
         return docStatus?.Id;
     }
 }