Handler.cs 18 KB

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