Merge branch 'kub-stage' into production

src/CMSMicroservice.Application/ManualPaymentCQ/Commands/CreateManualPayment/CreateManualPaymentCommand.cs

@@ -14,10 +14,15 @@ public class CreateManualPaymentCommand : IRequest<long>
     public long UserId { get; set; }
 
     /// <summary>
-    /// مبلغ تراکنش (تومان)
+    /// مبلغ تراکنش (تومان) — [DEPRECATED] مبلغ از پکیج خوانده می‌شود
     /// </summary>
     public long Amount { get; set; }
 
+    /// <summary>
+    /// شناسه پکیج — اگر 0 باشد، پکیج پایه استفاده می‌شود
+    /// </summary>
+    public long PackageId { get; set; }
+
     /// <summary>
     /// نوع تراکنش دستی
     /// </summary>

src/CMSMicroservice.Application/ManualPaymentCQ/Commands/CreateManualPayment/CreateManualPaymentCommandHandler.cs

@@ -70,10 +70,20 @@ public class CreateManualPaymentCommandHandler : IRequestHandler<CreateManualPay
                 throw new NotFoundException($"کیف پول کاربر {request.UserId} یافت نشد");
             }
 
-            // 4. بارگذاری پکیج پایه و محاسبه مبالغ
-            var package = await _context.Packages
-                .FirstOrDefaultAsync(p => p.IsBasePackage && !p.IsDeleted, cancellationToken)
-                ?? throw new NotFoundException("پکیج پایه یافت نشد");
+            // 4. بارگذاری پکیج انتخاب‌شده (یا پکیج پایه اگر PackageId=0)
+            Domain.Entities.Package package;
+            if (request.PackageId > 0)
+            {
+                package = await _context.Packages
+                    .FirstOrDefaultAsync(p => p.Id == request.PackageId && !p.IsDeleted, cancellationToken)
+                    ?? throw new NotFoundException($"پکیج با شناسه {request.PackageId} یافت نشد");
+            }
+            else
+            {
+                package = await _context.Packages
+                    .FirstOrDefaultAsync(p => p.IsBasePackage && !p.IsDeleted, cancellationToken)
+                    ?? throw new NotFoundException("پکیج پایه یافت نشد");
+            }
 
             var balanceAmount = package.Price;
             var discountBalanceAmount = (long)(package.Price * package.DiscountMultiplier);

src/CMSMicroservice.Application/ManualPaymentCQ/Commands/CreateManualPayment/CreateManualPaymentCommandValidator.cs

@@ -11,12 +11,10 @@ public class CreateManualPaymentCommandValidator : AbstractValidator<CreateManua
             .GreaterThan(0)
             .WithMessage("شناسه کاربر باید بزرگتر از صفر باشد");
 
-        // حصار ایمنی — مبلغ واقعی از پکیج کاربر خوانده می‌شود
-        RuleFor(x => x.Amount)
-            .GreaterThan(0)
-            .WithMessage("مبلغ باید بزرگتر از صفر باشد")
-            .LessThanOrEqualTo(SystemConstants.WalletMaxSafeAmount)
-            .WithMessage("مبلغ وارد شده بیش از حد مجاز است");
+        // مبلغ از پکیج خوانده می‌شود — فیلد Amount دیگر اعتبارسنجی نمی‌شود
+        RuleFor(x => x.PackageId)
+            .GreaterThanOrEqualTo(0)
+            .WithMessage("شناسه پکیج نامعتبر است");
 
         RuleFor(x => x.Type)
             .IsInEnum()

src/CMSMicroservice.Application/StockMovementCQ/Commands/CreateStockMovement/CreateStockMovementCommandHandler.cs

@@ -61,7 +61,9 @@ public class CreateStockMovementCommandHandler : IRequestHandler<CreateStockMove
                 {
                     throw new InvalidOperationException($"Insufficient available stock. Available: {inventoryItem.AvailableQuantity}, Requested: {request.Quantity}");
                 }
+                // رزرو فقط ReservedQuantity رو زیاد می‌کنه، Quantity فیزیکی تغییر نمی‌کنه
                 inventoryItem.ReservedQuantity += request.Quantity;
+                // quantityAfter = quantityBefore (بدون تغییر)
                 break;
 
             case StockMovementType.Released:
@@ -69,15 +71,32 @@ public class CreateStockMovementCommandHandler : IRequestHandler<CreateStockMove
                 {
                     throw new InvalidOperationException($"Cannot release more than reserved. Reserved: {inventoryItem.ReservedQuantity}, Requested: {request.Quantity}");
                 }
+                // آزادسازی فقط ReservedQuantity رو کم می‌کنه، Quantity فیزیکی تغییر نمی‌کنه
                 inventoryItem.ReservedQuantity -= request.Quantity;
+                // quantityAfter = quantityBefore (بدون تغییر)
                 break;
         }
 
+        // محاسبه مقدار Quantity برای ذخیره (منفی برای عملیات کاهشی)
+        // تا constraint دیتابیس (QuantityAfter = QuantityBefore + Quantity) برقرار بماند
+        var storedQuantity = request.MovementType switch
+        {
+            StockMovementType.Sale or
+            StockMovementType.AdjustmentMinus or
+            StockMovementType.Lost or
+            StockMovementType.Damaged or
+            StockMovementType.TransferOut => -request.Quantity,
+            // رزرو و آزادسازی تأثیری روی Quantity فیزیکی ندارن
+            StockMovementType.Reserved or
+            StockMovementType.Released => 0,
+            _ => request.Quantity
+        };
+
         var entity = new StockMovement
         {
             InventoryItemId = request.InventoryItemId,
             MovementType = request.MovementType,
-            Quantity = request.Quantity,
+            Quantity = storedQuantity,
             QuantityBefore = quantityBefore,
             QuantityAfter = quantityAfter,
             Note = request.Note,

src/CMSMicroservice.Protobuf/CMSMicroservice.Protobuf.csproj

@@ -3,7 +3,7 @@
     <TargetFramework>net9.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <Version>0.0.190</Version>
+    <Version>0.0.192</Version>
     <DebugType>None</DebugType>
     <DebugSymbols>False</DebugSymbols>
     <GeneratePackageOnBuild>False</GeneratePackageOnBuild>

src/CMSMicroservice.Protobuf/Protos/manualpayment.proto

@@ -72,13 +72,14 @@ enum ManualPaymentStatus
 message CreateManualPaymentRequest
 {
     int64 user_id = 1;
-    int64 amount = 2;
+    int64 amount = 2;           // [DEPRECATED] مبلغ از پکیج خوانده می‌شود — نادیده گرفته می‌شود
     ManualPaymentType type = 3;
     string description = 4;
     google.protobuf.StringValue reference_number = 5;
     google.protobuf.StringValue image_path = 6;
     google.protobuf.Int64Value image_document_id = 7;
     FileUploadModel image_file = 8;
+    int64 package_id = 9;       // شناسه پکیج — اگر 0 باشد، پکیج پایه استفاده می‌شود
 }
 
 message CreateManualPaymentResponse