Handler.cs 17 KB

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