Handler.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418
  1. using Application.Abstractions.Data;
  2. using Application.Abstractions.Messaging;
  3. using Domain.Entities.Common.ValueObject;
  4. using Domain.Entities.Store.ValueObject;
  5. using Microsoft.EntityFrameworkCore;
  6. using SharedKernel.Results;
  7. using OrderEntity = Domain.Entities.Store.Order;
  8. using OrderItemEntity = Domain.Entities.Store.OrderItem;
  9. using GameSettlementEntity = Domain.Entities.Store.GameSettlement;
  10. using MemberInventoryEntity = Domain.Entities.Store.MemberInventory;
  11. namespace Application.Features.Api.Store.Orders.Place;
  12. /// <summary>
  13. /// 상점 결제 핸들러 — 사용자 정책 핵심:
  14. /// • PgCharged(다날 충전 예치금) 잔액에서만 차감
  15. /// • 게임사 몫은 GameSettlement 큐에 적재 (월별 정산)
  16. /// • Digital 상품은 결제 즉시 쿠폰 코드 발급 + MemberInventory 등록 + Delivered 점프
  17. /// • Physical 상품은 Paid 상태로 머무름 (이후 배송 단계 진행)
  18. /// </summary>
  19. internal sealed class Handler(IAppDbContext db) : ICommandHandler<Command, Result<Response>>
  20. {
  21. public async Task<Result<Response>> Handle(Command request, CancellationToken ct)
  22. {
  23. // 0. 입력 검증
  24. if (request.Items is null || request.Items.Count == 0)
  25. {
  26. return Result.Failure<Response>(Error.Problem("Order.NoItems", "주문할 상품이 없습니다."));
  27. }
  28. if (request.Items.Any(i => i.Quantity <= 0))
  29. {
  30. return Result.Failure<Response>(Error.Problem("Order.InvalidQuantity", "수량은 1 이상이어야 합니다."));
  31. }
  32. // 1. 채널 검증 (선택된 경우) — 채널 보상 적립은 제거됨(2026-07-03), 채널 귀속 스냅샷만 유지
  33. if (request.ChannelID.HasValue)
  34. {
  35. var channel = await db.Channel.AsNoTracking()
  36. .Where(c => c.ID == request.ChannelID.Value && c.IsActive)
  37. .Select(c => new { c.ID, c.MemberID })
  38. .FirstOrDefaultAsync(ct);
  39. if (channel is null)
  40. {
  41. return Result.Failure<Response>(Error.NotFound("Order.ChannelNotFound", "후원 채널을 찾을 수 없습니다."));
  42. }
  43. // 본인 채널 선택 금지 (기존 정책 유지)
  44. if (channel.MemberID == request.MemberID)
  45. {
  46. return Result.Failure<Response>(Error.Problem("Order.SelfChannelNotAllowed", "본인 채널은 후원 코드로 선택할 수 없습니다."));
  47. }
  48. }
  49. // 2. 상품 로드 (Include Game)
  50. var productIDs = request.Items.Select(i => i.ProductID).Distinct().ToList();
  51. var products = await db.Product
  52. .Include(p => p.Game)
  53. .Where(p => productIDs.Contains(p.ID))
  54. .ToListAsync(ct);
  55. if (products.Count != productIDs.Count)
  56. {
  57. return Result.Failure<Response>(Error.NotFound("Order.ProductNotFound", "일부 상품을 찾을 수 없습니다."));
  58. }
  59. var now = DateTime.UtcNow;
  60. foreach (var p in products)
  61. {
  62. if (!p.IsActive)
  63. {
  64. return Result.Failure<Response>(Error.Problem("Order.ProductInactive", $"비활성 상품입니다: {p.Name}"));
  65. }
  66. if (p.SaleStartAt.HasValue && p.SaleStartAt.Value > now)
  67. {
  68. return Result.Failure<Response>(Error.Problem("Order.NotYetOnSale", $"판매 시작 전 상품입니다: {p.Name}"));
  69. }
  70. if (p.SaleEndAt.HasValue && p.SaleEndAt.Value <= now)
  71. {
  72. return Result.Failure<Response>(Error.Problem("Order.SaleEnded", $"판매 종료된 상품입니다: {p.Name}"));
  73. }
  74. }
  75. // 2.5 후원 채널 필수 상품 검증 — 하나라도 필수면 ChannelID 가 반드시 있어야 함 (프런트 우회 방어)
  76. if (!request.ChannelID.HasValue && products.Any(p => p.RequireDonationChannel))
  77. {
  78. return Result.Failure<Response>(Error.Problem("Order.DonationChannelRequired", "후원 채널 선택이 필수인 상품이 포함되어 있습니다. 후원 채널을 선택해 주세요."));
  79. }
  80. // 3. 라인별 합계 + 게임별 그룹화 (수익 배분용)
  81. var lineTotals = new Dictionary<int, int>(); // ProductID -> Quantity (입력 중복 합산)
  82. foreach (var item in request.Items)
  83. {
  84. lineTotals[item.ProductID] = lineTotals.GetValueOrDefault(item.ProductID) + item.Quantity;
  85. }
  86. var productByID = products.ToDictionary(p => p.ID);
  87. var totalAmount = 0;
  88. int gameRevenueTotal = 0;
  89. var perGameRevenue = new Dictionary<int, int>(); // GameID -> 누적 GameRevenueAmount (정산 큐 적재용)
  90. foreach (var (productID, qty) in lineTotals)
  91. {
  92. var p = productByID[productID];
  93. if (qty < p.MinPurchase)
  94. {
  95. return Result.Failure<Response>(Error.Problem("Order.BelowMinPurchase",
  96. $"{p.Name}: 최소 {p.MinPurchase}개 이상 주문해야 합니다."));
  97. }
  98. if (qty > p.MaxPurchase)
  99. {
  100. return Result.Failure<Response>(Error.Problem("Order.AboveMaxPurchase",
  101. $"{p.Name}: 최대 {p.MaxPurchase}개까지 주문 가능합니다."));
  102. }
  103. // 할인 반영 — 서버 기준 GetSalePrice() 사용 (정가 p.Price 가 아님)
  104. var unitPrice = p.GetSalePrice();
  105. var lineAmount = checked(unitPrice * qty);
  106. totalAmount = checked(totalAmount + lineAmount);
  107. // 게임별 수익 배분 (스냅샷)
  108. var gameCommission = p.Game!.CommissionRate;
  109. var gameRevenue = (int)Math.Floor(lineAmount * gameCommission / 100m);
  110. gameRevenueTotal = checked(gameRevenueTotal + gameRevenue);
  111. perGameRevenue[p.GameID] = perGameRevenue.GetValueOrDefault(p.GameID) + gameRevenue;
  112. }
  113. var platformFeeTotal = checked(totalAmount - gameRevenueTotal);
  114. if (platformFeeTotal < 0)
  115. {
  116. return Result.Failure<Response>(Error.Problem("Order.NegativeFee", "수익 배분 계산에 실패했습니다 (PlatformFee < 0)."));
  117. }
  118. // 3.5 판매 정책 검증 — 회원당 누적 구매 수량 제한 (ProductLimitConfig)
  119. var limitProductIDs = lineTotals.Keys.ToList();
  120. var limitConfigs = await db.ProductLimitConfig.AsNoTracking()
  121. .Where(c => limitProductIDs.Contains(c.ProductID))
  122. .ToDictionaryAsync(c => c.ProductID, ct);
  123. foreach (var (productID, qty) in lineTotals)
  124. {
  125. if (!limitConfigs.TryGetValue(productID, out var cfg))
  126. {
  127. continue;
  128. }
  129. if (!cfg.UseQuantityLimit || cfg.MaxQuantity <= 0)
  130. {
  131. continue;
  132. }
  133. var product = productByID[productID];
  134. var windowStart = cfg.GetWindowStart(now);
  135. var windowEnd = cfg.GetWindowEnd(now);
  136. var pastQtyQuery = db.OrderItem.AsNoTracking()
  137. .Where(oi => oi.ProductID == productID
  138. && oi.Order!.MemberID == request.MemberID
  139. && oi.Order.Status != Domain.Entities.Store.ValueObject.OrderStatus.Cancelled
  140. && oi.Order.Status != Domain.Entities.Store.ValueObject.OrderStatus.Refunded);
  141. if (windowStart.HasValue)
  142. {
  143. var ws = windowStart.Value;
  144. pastQtyQuery = pastQtyQuery.Where(oi => oi.Order!.CreatedAt >= ws);
  145. }
  146. if (windowEnd.HasValue)
  147. {
  148. var we = windowEnd.Value;
  149. pastQtyQuery = pastQtyQuery.Where(oi => oi.Order!.CreatedAt < we);
  150. }
  151. var pastQty = await pastQtyQuery.SumAsync(oi => oi.Quantity, ct);
  152. if (pastQty + qty > cfg.MaxQuantity)
  153. {
  154. var windowDesc = (windowStart.HasValue || windowEnd.HasValue)
  155. ? GetWindowLabel(cfg.PeriodType, cfg.PeriodStartAt, cfg.PeriodEndAt)
  156. : "전체 기간";
  157. return Result.Failure<Response>(Error.Problem("Order.LimitExceeded",
  158. $"{product.Name}: 회원당 최대 {cfg.MaxQuantity}개까지 구매 가능합니다 ({windowDesc}). 누적 {pastQty}개 / 신규 {qty}개"));
  159. }
  160. }
  161. // 4. 구매자 지갑 로드 + PgCharged 잔액 검증
  162. var buyerWallet = await db.Wallet
  163. .Include(w => w.Balances)
  164. .Include(w => w.Transactions)
  165. .FirstOrDefaultAsync(w => w.MemberID == request.MemberID, ct);
  166. if (buyerWallet is null)
  167. {
  168. return Result.Failure<Response>(Error.NotFound("Wallet.NotFound", "지갑을 찾을 수 없습니다."));
  169. }
  170. var storeAvailable = buyerWallet.GetStoreOrderAvailable();
  171. if (storeAvailable.Value < totalAmount)
  172. {
  173. return Result.Failure<Response>(Error.Problem("Wallet.InsufficientBalance",
  174. $"잔액이 부족합니다. 필요: {totalAmount:N0}원 / 사용 가능: {(int)storeAvailable.Value:N0}원."));
  175. }
  176. // 5. 재고 차감 (RowVersion 동시성 보호 — SaveChanges 가 자동 처리)
  177. foreach (var (productID, qty) in lineTotals)
  178. {
  179. productByID[productID].DecreaseStock(qty);
  180. }
  181. // 6. Digital 상품 — 쿠폰 코드 점유 (Available → Issued, 직접 발급)
  182. var digitalLineCodes = new Dictionary<int, List<Domain.Entities.Store.CouponCode>>(); // ProductID -> 발급된 코드 리스트
  183. foreach (var (productID, qty) in lineTotals)
  184. {
  185. var product = productByID[productID];
  186. if (product.Type != ProductType.Digital)
  187. {
  188. continue;
  189. }
  190. // Digital 상품에 연결된 Coupon 1건 (1:1 가정 — 첫 번째 활성 쿠폰 사용)
  191. var coupon = await db.Coupon.Where(c => c.ProductID == productID).FirstOrDefaultAsync(ct);
  192. if (coupon is null)
  193. {
  194. return Result.Failure<Response>(Error.Problem("Order.NoCouponForDigital", $"상품에 쿠폰이 등록되지 않았습니다: {product.Name}"));
  195. }
  196. // 사용 가능한 코드 qty 개 점유
  197. var availableCodes = await db.CouponCode
  198. .Where(c => c.CouponID == coupon.ID && c.Status == CouponCodeStatus.Available)
  199. .OrderBy(c => c.ID)
  200. .Take(qty)
  201. .ToListAsync(ct);
  202. if (availableCodes.Count < qty)
  203. {
  204. return Result.Failure<Response>(Error.Problem("Order.InsufficientCouponCodes",
  205. $"쿠폰 코드가 부족합니다 ({product.Name} 잔여 {availableCodes.Count}개, 필요 {qty}개)"));
  206. }
  207. foreach (var code in availableCodes)
  208. {
  209. code.Reserve();
  210. code.Issue(request.MemberID);
  211. }
  212. digitalLineCodes[productID] = availableCodes;
  213. }
  214. // 7. Order 생성
  215. var orderNumber = GenerateOrderNumber();
  216. var order = OrderEntity.Create(
  217. orderNumber: orderNumber,
  218. memberID: request.MemberID,
  219. totalAmount: totalAmount,
  220. channelID: request.ChannelID,
  221. platformFeeAmount: platformFeeTotal,
  222. gameRevenueAmount: gameRevenueTotal,
  223. channelRewardAmount: 0
  224. );
  225. // OrderItem 추가 (각 라인별)
  226. bool hasPhysical = false;
  227. bool hasDigital = false;
  228. foreach (var (productID, qty) in lineTotals)
  229. {
  230. var product = productByID[productID];
  231. // OrderItem 의 unitPrice 는 결제 시점의 할인된 단가 (영수증/환불 일관성)
  232. var orderItem = OrderItemEntity.Create(productID, qty, product.GetSalePrice());
  233. if (product.Type == ProductType.Digital)
  234. {
  235. hasDigital = true;
  236. }
  237. else
  238. {
  239. hasPhysical = true;
  240. }
  241. order.AddItem(orderItem);
  242. }
  243. order.MarkPaid();
  244. // Digital 단독 주문이면 즉시 Delivered 점프
  245. if (hasDigital && !hasPhysical)
  246. {
  247. order.MarkDelivered();
  248. }
  249. db.Order.Add(order);
  250. // 8. 구매자 잔액 차감 (SpendPolicy.StoreOrderSpendOrder 순서로 분할, 출처별 트랜잭션 기록)
  251. buyerWallet.DebitForStoreOrder(Money.KRW(totalAmount), reason: "ORDER_PAY", refID: orderNumber);
  252. // 10. GameSettlement 큐 적재 (월별)
  253. var year = now.Year;
  254. var month = now.Month;
  255. foreach (var (gameID, revenue) in perGameRevenue)
  256. {
  257. if (revenue <= 0)
  258. {
  259. continue;
  260. }
  261. var settlement = await db.GameSettlement
  262. .FirstOrDefaultAsync(s => s.GameID == gameID && s.Year == year && s.Month == month, ct);
  263. if (settlement is null)
  264. {
  265. settlement = GameSettlementEntity.Create(gameID, year, month);
  266. db.GameSettlement.Add(settlement);
  267. }
  268. settlement.AddRevenue(revenue);
  269. }
  270. // 11. 1차 저장 — Order.ID, OrderItem.ID 확보
  271. await db.SaveChangesAsync(ct);
  272. // 12. Digital 상품: MemberInventory + OrderItem.IssuedCouponCodeID 연결
  273. if (hasDigital)
  274. {
  275. foreach (var orderItem in order.Items)
  276. {
  277. var product = productByID[orderItem.ProductID];
  278. if (product.Type != ProductType.Digital)
  279. {
  280. continue;
  281. }
  282. if (!digitalLineCodes.TryGetValue(product.ID, out var codes))
  283. {
  284. continue;
  285. }
  286. // 첫 코드를 OrderItem 에 연결, 모든 코드를 MemberInventory 에 등록
  287. if (codes.Count > 0)
  288. {
  289. orderItem.AssignCouponCode(codes[0].ID);
  290. }
  291. foreach (var code in codes)
  292. {
  293. DateTime? expiresAt = null;
  294. var coupon = await db.Coupon.AsNoTracking().FirstOrDefaultAsync(c => c.ID == code.CouponID, ct);
  295. if (coupon is not null)
  296. {
  297. expiresAt = coupon.ExpiresAt;
  298. }
  299. var inv = MemberInventoryEntity.Create(request.MemberID, orderItem.ID, code.ID, expiresAt);
  300. db.MemberInventory.Add(inv);
  301. }
  302. }
  303. await db.SaveChangesAsync(ct);
  304. }
  305. return Result.Success(new Response(
  306. OrderID: order.ID,
  307. OrderNumber: orderNumber,
  308. TotalAmount: totalAmount,
  309. PlatformFeeAmount: platformFeeTotal,
  310. GameRevenueAmount: gameRevenueTotal,
  311. ChannelRewardAmount: 0,
  312. HasPhysical: hasPhysical,
  313. HasDigital: hasDigital
  314. ));
  315. }
  316. private static string GenerateOrderNumber()
  317. {
  318. var date = DateTime.UtcNow.ToString("yyyyMMdd");
  319. var random = Guid.NewGuid().ToString("N")[..6].ToUpperInvariant();
  320. return $"{date}-{random}";
  321. }
  322. private static string GetWindowLabel(
  323. Domain.Entities.Store.ValueObject.LimitPeriodType type,
  324. DateTime? periodStartAt,
  325. DateTime? periodEndAt
  326. ) => type switch
  327. {
  328. Domain.Entities.Store.ValueObject.LimitPeriodType.Day => "최근 1일",
  329. Domain.Entities.Store.ValueObject.LimitPeriodType.Week => "최근 1주",
  330. Domain.Entities.Store.ValueObject.LimitPeriodType.Month => "최근 30일",
  331. Domain.Entities.Store.ValueObject.LimitPeriodType.Custom => FormatCustomRange(periodStartAt, periodEndAt),
  332. _ => "전체 기간"
  333. };
  334. private static string FormatCustomRange(DateTime? startAt, DateTime? endAt)
  335. {
  336. if (!startAt.HasValue || !endAt.HasValue)
  337. {
  338. return "지정 기간";
  339. }
  340. return $"{startAt.Value:yyyy-MM-dd HH:mm:ss} ~ {endAt.Value:yyyy-MM-dd HH:mm:ss} (UTC)";
  341. }
  342. }