| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436 |
- using Application.Abstractions.Data;
- using Application.Abstractions.Messaging;
- using Domain.Entities.Common.ValueObject;
- using Domain.Entities.Store.ValueObject;
- using Microsoft.EntityFrameworkCore;
- using SharedKernel.Results;
- using OrderEntity = Domain.Entities.Store.Order;
- using OrderItemEntity = Domain.Entities.Store.OrderItem;
- using GameSettlementEntity = Domain.Entities.Store.GameSettlement;
- using MemberInventoryEntity = Domain.Entities.Store.MemberInventory;
- using MemberItemEntity = Domain.Entities.Members.MemberItem;
- namespace Application.Features.Api.Store.Orders.Place;
- /// <summary>
- /// 상점 결제 핸들러 — 사용자 정책 핵심:
- /// • 캐시(PgCharged→Deposit) 잔액에서만 차감 — 토큰(Reward/Airdrop)은 상점 구매 불가 (SpendPolicy.StoreOrderSpendOrder)
- /// • 게임사 몫은 GameSettlement 큐에 적재 (월별 정산)
- /// • Digital 상품은 결제 즉시 쿠폰 코드 발급 + MemberInventory 등록 + Delivered 점프
- /// • Physical 상품은 Paid 상태로 머무름 (이후 배송 단계 진행)
- /// </summary>
- internal sealed class Handler(IAppDbContext db) : ICommandHandler<Command, Result<Response>>
- {
- public async Task<Result<Response>> Handle(Command request, CancellationToken ct)
- {
- // 0. 입력 검증
- if (request.Items is null || request.Items.Count == 0)
- {
- return Result.Failure<Response>(Error.Problem("Order.NoItems", "주문할 상품이 없습니다."));
- }
- if (request.Items.Any(i => i.Quantity <= 0))
- {
- return Result.Failure<Response>(Error.Problem("Order.InvalidQuantity", "수량은 1 이상이어야 합니다."));
- }
- // 1. 채널 검증 (선택된 경우) — 채널 보상 적립은 제거됨(2026-07-03), 채널 귀속 스냅샷만 유지
- if (request.ChannelID.HasValue)
- {
- var channel = await db.Channel.AsNoTracking()
- .Where(c => c.ID == request.ChannelID.Value && c.IsActive)
- .Select(c => new { c.ID, c.MemberID })
- .FirstOrDefaultAsync(ct);
- if (channel is null)
- {
- return Result.Failure<Response>(Error.NotFound("Order.ChannelNotFound", "후원 채널을 찾을 수 없습니다."));
- }
- // 본인 채널 선택 금지 (기존 정책 유지)
- if (channel.MemberID == request.MemberID)
- {
- return Result.Failure<Response>(Error.Problem("Order.SelfChannelNotAllowed", "본인 채널은 후원 코드로 선택할 수 없습니다."));
- }
- }
- // 2. 상품 로드 (Include Game)
- var productIDs = request.Items.Select(i => i.ProductID).Distinct().ToList();
- var products = await db.Product
- .Include(p => p.Game)
- .Where(p => productIDs.Contains(p.ID))
- .ToListAsync(ct);
- if (products.Count != productIDs.Count)
- {
- return Result.Failure<Response>(Error.NotFound("Order.ProductNotFound", "일부 상품을 찾을 수 없습니다."));
- }
- var now = DateTime.UtcNow;
- foreach (var p in products)
- {
- if (!p.IsActive)
- {
- return Result.Failure<Response>(Error.Problem("Order.ProductInactive", $"비활성 상품입니다: {p.Name}"));
- }
- if (p.SaleStartAt.HasValue && p.SaleStartAt.Value > now)
- {
- return Result.Failure<Response>(Error.Problem("Order.NotYetOnSale", $"판매 시작 전 상품입니다: {p.Name}"));
- }
- if (p.SaleEndAt.HasValue && p.SaleEndAt.Value <= now)
- {
- return Result.Failure<Response>(Error.Problem("Order.SaleEnded", $"판매 종료된 상품입니다: {p.Name}"));
- }
- }
- // 2.5 후원 채널 필수 상품 검증 — 하나라도 필수면 ChannelID 가 반드시 있어야 함 (프런트 우회 방어)
- if (!request.ChannelID.HasValue && products.Any(p => p.RequireDonationChannel))
- {
- return Result.Failure<Response>(Error.Problem("Order.DonationChannelRequired", "후원 채널 선택이 필수인 상품이 포함되어 있습니다. 후원 채널을 선택해 주세요."));
- }
- // 3. 라인별 합계 + 게임별 그룹화 (수익 배분용)
- var lineTotals = new Dictionary<int, int>(); // ProductID -> Quantity (입력 중복 합산)
- foreach (var item in request.Items)
- {
- lineTotals[item.ProductID] = lineTotals.GetValueOrDefault(item.ProductID) + item.Quantity;
- }
- var productByID = products.ToDictionary(p => p.ID);
- var totalAmount = 0;
- int gameRevenueTotal = 0;
- var perGameRevenue = new Dictionary<int, int>(); // GameID -> 누적 GameRevenueAmount (정산 큐 적재용)
- foreach (var (productID, qty) in lineTotals)
- {
- var p = productByID[productID];
- if (qty < p.MinPurchase)
- {
- return Result.Failure<Response>(Error.Problem("Order.BelowMinPurchase",
- $"{p.Name}: 최소 {p.MinPurchase}개 이상 주문해야 합니다."));
- }
- if (qty > p.MaxPurchase)
- {
- return Result.Failure<Response>(Error.Problem("Order.AboveMaxPurchase",
- $"{p.Name}: 최대 {p.MaxPurchase}개까지 주문 가능합니다."));
- }
- // 할인 반영 — 서버 기준 GetSalePrice() 사용 (정가 p.Price 가 아님)
- var unitPrice = p.GetSalePrice();
- var lineAmount = checked(unitPrice * qty);
- totalAmount = checked(totalAmount + lineAmount);
- // 게임별 수익 배분 (스냅샷) — 소모품(ItemKind, GameID null)은 게임 수익·정산 없음
- if (p.GameID.HasValue && p.Game is not null)
- {
- var gameRevenue = (int)Math.Floor(lineAmount * p.Game.CommissionRate / 100m);
- gameRevenueTotal = checked(gameRevenueTotal + gameRevenue);
- perGameRevenue[p.GameID.Value] = perGameRevenue.GetValueOrDefault(p.GameID.Value) + gameRevenue;
- }
- }
- var platformFeeTotal = checked(totalAmount - gameRevenueTotal);
- if (platformFeeTotal < 0)
- {
- return Result.Failure<Response>(Error.Problem("Order.NegativeFee", "수익 배분 계산에 실패했습니다 (PlatformFee < 0)."));
- }
- // 3.5 판매 정책 검증 — 회원당 누적 구매 수량 제한 (ProductLimitConfig)
- var limitProductIDs = lineTotals.Keys.ToList();
- var limitConfigs = await db.ProductLimitConfig.AsNoTracking()
- .Where(c => limitProductIDs.Contains(c.ProductID))
- .ToDictionaryAsync(c => c.ProductID, ct);
- foreach (var (productID, qty) in lineTotals)
- {
- if (!limitConfigs.TryGetValue(productID, out var cfg))
- {
- continue;
- }
- if (!cfg.UseQuantityLimit || cfg.MaxQuantity <= 0)
- {
- continue;
- }
- var product = productByID[productID];
- var windowStart = cfg.GetWindowStart(now);
- var windowEnd = cfg.GetWindowEnd(now);
- var pastQtyQuery = db.OrderItem.AsNoTracking()
- .Where(oi => oi.ProductID == productID
- && oi.Order!.MemberID == request.MemberID
- && oi.Order.Status != Domain.Entities.Store.ValueObject.OrderStatus.Cancelled
- && oi.Order.Status != Domain.Entities.Store.ValueObject.OrderStatus.Refunded);
- if (windowStart.HasValue)
- {
- var ws = windowStart.Value;
- pastQtyQuery = pastQtyQuery.Where(oi => oi.Order!.CreatedAt >= ws);
- }
- if (windowEnd.HasValue)
- {
- var we = windowEnd.Value;
- pastQtyQuery = pastQtyQuery.Where(oi => oi.Order!.CreatedAt < we);
- }
- var pastQty = await pastQtyQuery.SumAsync(oi => oi.Quantity, ct);
- if (pastQty + qty > cfg.MaxQuantity)
- {
- var windowDesc = (windowStart.HasValue || windowEnd.HasValue)
- ? GetWindowLabel(cfg.PeriodType, cfg.PeriodStartAt, cfg.PeriodEndAt)
- : "전체 기간";
- return Result.Failure<Response>(Error.Problem("Order.LimitExceeded",
- $"{product.Name}: 회원당 최대 {cfg.MaxQuantity}개까지 구매 가능합니다 ({windowDesc}). 누적 {pastQty}개 / 신규 {qty}개"));
- }
- }
- // 4. 구매자 지갑 로드 + 캐시(PgCharged→Deposit) 잔액 검증
- var buyerWallet = await db.Wallet
- .Include(w => w.Balances)
- .Include(w => w.Transactions)
- .FirstOrDefaultAsync(w => w.MemberID == request.MemberID, ct);
- if (buyerWallet is null)
- {
- return Result.Failure<Response>(Error.NotFound("Wallet.NotFound", "지갑을 찾을 수 없습니다."));
- }
- var storeAvailable = buyerWallet.GetStoreOrderAvailable();
- if (storeAvailable.Value < totalAmount)
- {
- return Result.Failure<Response>(Error.Problem("Wallet.InsufficientBalance",
- $"잔액이 부족합니다. 필요: {totalAmount:N0}원 / 사용 가능: {(int)storeAvailable.Value:N0}원."));
- }
- // 5. 재고 차감 (RowVersion 동시성 보호 — SaveChanges 가 자동 처리)
- foreach (var (productID, qty) in lineTotals)
- {
- productByID[productID].DecreaseStock(qty);
- }
- // 6. Digital 상품 — 쿠폰 코드 점유 (Available → Issued, 직접 발급)
- var digitalLineCodes = new Dictionary<int, List<Domain.Entities.Store.CouponCode>>(); // ProductID -> 발급된 코드 리스트
- foreach (var (productID, qty) in lineTotals)
- {
- var product = productByID[productID];
- if (product.Type != ProductType.Digital)
- {
- continue;
- }
- if (product.ItemKind is not null)
- {
- continue; // 소모품(ItemKind)은 쿠폰 대신 MemberItem 발급 (12단계)
- }
- // Digital 상품에 연결된 Coupon 1건 (1:1 가정 — 첫 번째 활성 쿠폰 사용)
- var coupon = await db.Coupon.Where(c => c.ProductID == productID).FirstOrDefaultAsync(ct);
- if (coupon is null)
- {
- return Result.Failure<Response>(Error.Problem("Order.NoCouponForDigital", $"상품에 쿠폰이 등록되지 않았습니다: {product.Name}"));
- }
- // 사용 가능한 코드 qty 개 점유
- var availableCodes = await db.CouponCode
- .Where(c => c.CouponID == coupon.ID && c.Status == CouponCodeStatus.Available)
- .OrderBy(c => c.ID)
- .Take(qty)
- .ToListAsync(ct);
- if (availableCodes.Count < qty)
- {
- return Result.Failure<Response>(Error.Problem("Order.InsufficientCouponCodes",
- $"쿠폰 코드가 부족합니다 ({product.Name} 잔여 {availableCodes.Count}개, 필요 {qty}개)"));
- }
- foreach (var code in availableCodes)
- {
- code.Reserve();
- code.Issue(request.MemberID);
- }
- digitalLineCodes[productID] = availableCodes;
- }
- // 7. Order 생성
- var orderNumber = GenerateOrderNumber();
- var order = OrderEntity.Create(
- orderNumber: orderNumber,
- memberID: request.MemberID,
- totalAmount: totalAmount,
- channelID: request.ChannelID,
- platformFeeAmount: platformFeeTotal,
- gameRevenueAmount: gameRevenueTotal,
- channelRewardAmount: 0
- );
- // OrderItem 추가 (각 라인별)
- bool hasPhysical = false;
- bool hasDigital = false;
- foreach (var (productID, qty) in lineTotals)
- {
- var product = productByID[productID];
- // OrderItem 의 unitPrice 는 결제 시점의 할인된 단가 (영수증/환불 일관성)
- var orderItem = OrderItemEntity.Create(productID, qty, product.GetSalePrice());
- if (product.Type == ProductType.Digital)
- {
- hasDigital = true;
- }
- else
- {
- hasPhysical = true;
- }
- order.AddItem(orderItem);
- }
- order.MarkPaid();
- // Digital 단독 주문이면 즉시 Delivered 점프
- if (hasDigital && !hasPhysical)
- {
- order.MarkDelivered();
- }
- db.Order.Add(order);
- // 8. 구매자 잔액 차감 (SpendPolicy.StoreOrderSpendOrder 순서로 분할, 출처별 트랜잭션 기록)
- buyerWallet.DebitForStoreOrder(Money.KRW(totalAmount), reason: "ORDER_PAY", refID: orderNumber);
- // 10. GameSettlement 큐 적재 (월별)
- var year = now.Year;
- var month = now.Month;
- foreach (var (gameID, revenue) in perGameRevenue)
- {
- if (revenue <= 0)
- {
- continue;
- }
- var settlement = await db.GameSettlement
- .FirstOrDefaultAsync(s => s.GameID == gameID && s.Year == year && s.Month == month, ct);
- if (settlement is null)
- {
- settlement = GameSettlementEntity.Create(gameID, year, month);
- db.GameSettlement.Add(settlement);
- }
- settlement.AddRevenue(revenue);
- }
- // 11. 1차 저장 — Order.ID, OrderItem.ID 확보
- await db.SaveChangesAsync(ct);
- // 12. Digital 상품: MemberInventory + OrderItem.IssuedCouponCodeID 연결
- if (hasDigital)
- {
- foreach (var orderItem in order.Items)
- {
- var product = productByID[orderItem.ProductID];
- if (product.ItemKind is not null)
- {
- // 소모품 — 수량만큼 계정 귀속 MemberItem 발급
- for (int i = 0; i < orderItem.Quantity; i++)
- {
- db.MemberItem.Add(MemberItemEntity.Create(request.MemberID, product.ID, orderItem.ID, product.ItemKind.Value, product.DurationDays));
- }
- continue;
- }
- if (product.Type != ProductType.Digital)
- {
- continue;
- }
- if (!digitalLineCodes.TryGetValue(product.ID, out var codes))
- {
- continue;
- }
- // 첫 코드를 OrderItem 에 연결, 모든 코드를 MemberInventory 에 등록
- if (codes.Count > 0)
- {
- orderItem.AssignCouponCode(codes[0].ID);
- }
- foreach (var code in codes)
- {
- DateTime? expiresAt = null;
- var coupon = await db.Coupon.AsNoTracking().FirstOrDefaultAsync(c => c.ID == code.CouponID, ct);
- if (coupon is not null)
- {
- expiresAt = coupon.ExpiresAt;
- }
- var inv = MemberInventoryEntity.Create(request.MemberID, orderItem.ID, code.ID, expiresAt);
- db.MemberInventory.Add(inv);
- }
- }
- await db.SaveChangesAsync(ct);
- }
- return Result.Success(new Response(
- OrderID: order.ID,
- OrderNumber: orderNumber,
- TotalAmount: totalAmount,
- PlatformFeeAmount: platformFeeTotal,
- GameRevenueAmount: gameRevenueTotal,
- ChannelRewardAmount: 0,
- HasPhysical: hasPhysical,
- HasDigital: hasDigital
- ));
- }
- private static string GenerateOrderNumber()
- {
- var date = DateTime.UtcNow.ToString("yyyyMMdd");
- var random = Guid.NewGuid().ToString("N")[..6].ToUpperInvariant();
- return $"{date}-{random}";
- }
- private static string GetWindowLabel(
- Domain.Entities.Store.ValueObject.LimitPeriodType type,
- DateTime? periodStartAt,
- DateTime? periodEndAt
- ) => type switch
- {
- Domain.Entities.Store.ValueObject.LimitPeriodType.Day => "최근 1일",
- Domain.Entities.Store.ValueObject.LimitPeriodType.Week => "최근 1주",
- Domain.Entities.Store.ValueObject.LimitPeriodType.Month => "최근 30일",
- Domain.Entities.Store.ValueObject.LimitPeriodType.Custom => FormatCustomRange(periodStartAt, periodEndAt),
- _ => "전체 기간"
- };
- private static string FormatCustomRange(DateTime? startAt, DateTime? endAt)
- {
- if (!startAt.HasValue || !endAt.HasValue)
- {
- return "지정 기간";
- }
- return $"{startAt.Value:yyyy-MM-dd HH:mm:ss} ~ {endAt.Value:yyyy-MM-dd HH:mm:ss} (UTC)";
- }
- }
|