feat: add coupon checkout support

Tiku.Api/Controllers/CommerceController.cs

@@ -81,6 +81,45 @@ public sealed class CommerceController(
             cancellationToken));
     }
 
+    [HttpPost("coupons/claim")]
+    [EndpointSummary("领取优惠券")]
+    [ProducesResponseType<CommerceCouponItem>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceCouponItem>> ClaimCoupon(
+        ClaimCommerceCouponDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceService.ClaimCouponAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("coupons")]
+    [EndpointSummary("查询当前用户优惠券")]
+    [ProducesResponseType<CommerceCouponList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceCouponList>> Coupons(
+        [FromQuery] CommerceCouponQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceService.GetCouponsAsync(
+            ResolveActor(),
+            query.ToQuery(),
+            cancellationToken));
+    }
+
+    [HttpPost("coupons/check")]
+    [EndpointSummary("校验优惠券并预览订单金额")]
+    [ProducesResponseType<CommerceCouponCheckResult>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CommerceCouponCheckResult>> CheckCoupon(
+        CheckCommerceCouponDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await commerceService.CheckCouponAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
     [AllowAnonymous]
     [HttpPost("payments/notify/wechat-pay")]
     [EndpointSummary("微信支付回调")]