优惠券

app/Endpoint/Api/Filters/UserCouponFilter.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Endpoint\Api\Filters;
+
+use EloquentFilter\ModelFilter;
+
+class UserCouponFilter extends ModelFilter
+{
+    public function status($status)
+    {
+        switch ($status) {
+            case 'unuse':
+                $this->isUnuse();
+                break;
+
+            case 'used':
+                $this->isUsed();
+                break;
+
+            case 'expired':
+                $this->isExpired();
+                break;
+        }
+    }
+}

app/Endpoint/Api/Http/Controllers/Account/CouponController.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Endpoint\Api\Http\Controllers;
+
+use App\Endpoint\Api\Http\Resources\CouponResource;
+use App\Helpers\Paginator as PaginatorHelper;
+use Illuminate\Http\Request;
+
+class CouponController extends Controller
+{
+    /**
+     * 优惠券
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function index(Request $request)
+    {
+        $user = $request->user();
+
+        $coupons = $user->coupons()
+                        ->filter(array_merge([
+                            'status' => 'unuse',
+                        ], $request->all()))
+                        ->simplePaginate(PaginatorHelper::resolvePerPage('per_page', 20, 50));
+
+        return CouponResource::make($coupons);
+    }
+}

app/Endpoint/Api/Http/Controllers/CouponController.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Endpoint\Api\Http\Controllers;
+
+use App\Endpoint\Api\Http\Resources\CouponResource;
+use App\Helpers\Paginator as PaginatorHelper;
+use Illuminate\Http\Request;
+
+class CouponController extends Controller
+{
+    /**
+     * 我的优惠券
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function index(Request $request)
+    {
+        $user = $request->user();
+
+        $coupons = $user->coupons()
+                        ->filter(array_merge([
+                            'status' => 'unuse',
+                        ], $request->all()))
+                        ->simplePaginate(PaginatorHelper::resolvePerPage('per_page', 20, 50));
+
+        return CouponResource::collection($coupons);
+    }
+}

app/Endpoint/Api/Http/Resources/CouponResource.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Endpoint\Api\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CouponResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return array|\Illuminate\Contracts\Support\Arrayable|\JsonSerializable
+     */
+    public function toArray($request)
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->coupon_name,
+            'type' => $this->coupon_type,
+            'amount' => $this->coupon_amount_format,
+            'threshold' => $this->coupon_threshold_format,
+            'use_start_at' => $this->use_start_at,
+            'use_end_at' => $this->use_end_at,
+        ];
+    }
+}

app/Endpoint/Api/routes.php

@@ -9,6 +9,7 @@ use App\Endpoint\Api\Http\Controllers\Auth\LogoutController;
 use App\Endpoint\Api\Http\Controllers\Auth\RegisterController;
 use App\Endpoint\Api\Http\Controllers\Auth\ResetPasswordController;
 use App\Endpoint\Api\Http\Controllers\CaptchaController;
+use App\Endpoint\Api\Http\Controllers\CouponController;
 use App\Endpoint\Api\Http\Controllers\MessageController;
 use App\Endpoint\Api\Http\Controllers\Product\HotController;
 use App\Endpoint\Api\Http\Controllers\Product\ProductCategoryController;
@@ -87,5 +88,8 @@ Route::group([
         Route::get('messages/wait-read-num', [MessageController::class, 'waitReadNum']);
         Route::post('messages/read/{message}', [MessageController::class, 'read']);
         Route::post('messages/batch-read', [MessageController::class, 'batchRead']);
+
+        // 我的优惠券
+        Route::get('coupons', [CouponController::class, 'index']);
     });
 });

app/Models/Coupon.php

@@ -12,6 +12,9 @@ class Coupon extends Model
     use HasFactory;
     use HasDateTimeFormatter;
 
+    public const TYPE_VALUE = 1;        // 抵扣券
+    public const TYPE_DISCOUNT = 2;     // 折扣券
+
     protected $casts = [
         'amount' => Price::class,
         'threshold'=>Price::class,

app/Models/User.php

@@ -128,6 +128,16 @@ class User extends Model implements AuthorizableContract, AuthenticatableContrac
         return $this->hasMany(AfterSale::class);
     }
 
+    /**
+     * 属于此用户的优惠券
+     *
+     * @return void
+     */
+    public function coupons()
+    {
+        return $this->hasMany(UserCoupon::class);
+    }
+
     /**
      * 禁用用户
      *

app/Models/UserCoupon.php

@@ -2,12 +2,15 @@
 
 namespace App\Models;
 
+use App\Helpers\Numeric as NumericHelper;
+use EloquentFilter\Filterable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class UserCoupon extends Model
 {
     use HasFactory;
+    use Filterable;
 
     protected $fillable = [
         'user_id',
@@ -23,6 +26,32 @@ class UserCoupon extends Model
         'updated_at',
     ];
 
+    /**
+     * 仅查询已过期的优惠券
+     */
+    public function scopeIsExpired($query)
+    {
+        return $query->where('status', 0)->where('use_end_at', '<=', now());
+    }
+
+    /**
+     * 仅查询已使用的优惠券
+     */
+    public function scopeIsUsed($query)
+    {
+        return $query->where('status', 1);
+    }
+
+    /**
+     * 仅查询未使用的优惠券
+     */
+    public function scopeIsUnuse($query)
+    {
+        $time = now();
+
+        return $query->where('status', 0)->where('use_start_at', '<', $time)->where('use_end_at', '>', $time);
+    }
+
     /**
      * 优惠券可用范围规则
      *
@@ -32,4 +61,43 @@ class UserCoupon extends Model
     {
         return $this->hasMany(CouponRange::class, 'coupon_id', 'coupon_id');
     }
+
+    /**
+     * 确认此优惠券是否是折扣券
+     *
+     * @return bool
+     */
+    public function isDiscountCoupon(): bool
+    {
+        return $this->coupon_type === Coupon::TYPE_DISCOUNT;
+    }
+
+    /**
+     * 获取此优惠券的面值
+     *
+     * @return string
+     */
+    public function getCouponAmountFormatAttribute(): string
+    {
+        $value = $this->attributes['coupon_amount'];
+
+        // 如果是折扣券
+        if ($this->isDiscountCoupon()) {
+            return NumericHelper::trimZero(bcdiv($value, 10, 1));
+        }
+
+        return NumericHelper::trimZero(bcdiv($value, 100, 2));
+    }
+
+    /**
+     * 获取此优惠券的面值
+     *
+     * @return string
+     */
+    public function getCouponThresholdFormatAttribute(): string
+    {
+        return NumericHelper::trimZero(
+            bcdiv($this->attributes['coupon_threshold'], 100, 2)
+        );
+    }
 }