地址管理

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

@@ -0,0 +1,119 @@
+<?php
+
+namespace App\Endpoint\Api\Http\Controllers;
+
+use App\Endpoint\Api\Http\Resources\AddressResource;
+use App\Models\Zone;
+use App\Rules\PhoneNumber;
+use Illuminate\Http\Request;
+
+class AddressController extends Controller
+{
+    /**
+     * 地址列表
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function index(Request $request)
+    {
+        $addresses = $request->user()->addresses()->latest('id')->get();
+
+        return AddressResource::collection($addresses->sortByDesc('is_default'));
+    }
+
+    /**
+     * 添加地址
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function store(Request $request)
+    {
+        $input = $request->validate([
+            'zone_id' => ['bail', 'required', 'int'],
+            'consignee' => ['bail', 'required', 'max:255'],
+            'telephone' => ['bail', 'required', new PhoneNumber()],
+            'address' => ['bail', 'required', 'string', 'max:255'],
+            'is_default' => ['bail', 'required', 'bool'],
+        ]);
+
+        $zone = Zone::areas()->findOrFail($input['zone_id']);
+
+        $user = $request->user();
+
+        $address = $user->addresses()->create(
+            array_merge($input, ['zone' => $zone->full_name])
+        );
+
+        if ($address->is_default) {
+            $user->addresses()->where('id', '!=', $address->id)->update(['is_default' => false]);
+        }
+
+        return AddressResource::make($address);
+    }
+
+    /**
+     * 查看地址
+     *
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function show($id, Request $request)
+    {
+        $address = $request->user()->addresses()->findOrFail($id);
+
+        return AddressResource::make($address);
+    }
+
+    /**
+     * 编辑地址
+     *
+     * @param int $id
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function update($id, Request $request)
+    {
+        $input = $request->validate([
+            'zone_id' => ['bail', 'required', 'int'],
+            'consignee' => ['bail', 'required', 'max:255'],
+            'telephone' => ['bail', 'required', new PhoneNumber()],
+            'address' => ['bail', 'required', 'string', 'max:255'],
+            'is_default' => ['bail', 'required', 'bool'],
+        ]);
+
+        $user = $request->user();
+
+        $address = $user->addresses()->findOrFail($id);
+        $address->fill($input);
+
+        if ($address->isDirty('zone_id')) {
+            $zone = Zone::areas()->findOrFail($input['zone_id']);
+
+            $address->zone = $zone->full_name;
+        }
+
+        $address->save();
+
+        if ($address->is_default && $address->wasChanged('is_default')) {
+            $user->addresses()->where('id', '!=', $address->id)->update(['is_default' => false]);
+        }
+
+        return AddressResource::make($address);
+    }
+
+    /**
+     * 删除地址
+     *
+     * @param int $id
+     * @param \Illuminate\Http\Request $request
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy($id, Request $request)
+    {
+        $request->user()->addresses()->where('id', $id)->delete();
+
+        return response()->noContent();
+    }
+}

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

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Endpoint\Api\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class AddressResource 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,
+            'zone_id' => $this->zone_id,
+            'consignee' => $this->consignee,
+            'telephone' => $this->telephone,
+            'zone' => $this->zone,
+            'address' => $this->address,
+            'is_default' => $this->is_default,
+        ];
+    }
+}

app/Endpoint/Api/routes.php

@@ -3,6 +3,7 @@
 use App\Endpoint\Api\Http\Controllers\Account\ChangePasswordController;
 use App\Endpoint\Api\Http\Controllers\Account\UserController;
 use App\Endpoint\Api\Http\Controllers\AdController;
+use App\Endpoint\Api\Http\Controllers\AddressController;
 use App\Endpoint\Api\Http\Controllers\Auth\LoginController;
 use App\Endpoint\Api\Http\Controllers\Auth\LogoutController;
 use App\Endpoint\Api\Http\Controllers\Auth\RegisterController;
@@ -65,5 +66,7 @@ Route::group([
         Route::post('shopping-cart-items', [ShoppingCartItemController::class, 'store']);
         Route::delete('shopping-cart-items', [ShoppingCartItemController::class, 'delete']);
         Route::put('shopping-cart-items/{shopping_cart_item}', [ShoppingCartItemController::class, 'update']);
+
+        Route::apiResource('addresses', AddressController::class);
     });
 });

app/Models/Address.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Address extends Model
+{
+    /**
+     * @var array
+     */
+    protected $attributes = [
+        'is_default' => false,
+    ];
+
+    /**
+     * @var array
+     */
+    protected $casts = [
+        'is_default' => 'bool',
+    ];
+
+    /**
+     * @var array
+     */
+    protected $fillable = [
+        'user_id',
+        'zone_id',
+        'consignee',
+        'telephone',
+        'zone',
+        'address',
+        'is_default',
+    ];
+}

app/Models/User.php

@@ -86,6 +86,14 @@ class User extends Model implements AuthorizableContract, AuthenticatableContrac
         return $this->hasMany(ShoppingCartItem::class);
     }
 
+    /**
+     * 属于此用户的地址
+     */
+    public function addresses()
+    {
+        return $this->hasMany(Address::class);
+    }
+
     /**
      * 禁用用户
      *

app/Models/Zone.php

@@ -18,4 +18,64 @@ class Zone extends Model
         'parent_id',
         'type',
     ];
+
+    /**
+     * 仅查询区级地区
+     */
+    public function scopeAreas($query)
+    {
+        return $query->where('type', static::TYPE_AREA);
+    }
+
+    /**
+     * 此地区的上级地区
+     */
+    public function parent()
+    {
+        return $this->belongsTo(static::class, 'parent_id');
+    }
+
+    /**
+     * 确认此地区是否是省
+     *
+     * @return bool
+     */
+    public function isProvince(): bool
+    {
+        return $this->type === static::TYPE_PROVINCE;
+    }
+
+    /**
+     * 确认此地区是否是市
+     *
+     * @return bool
+     */
+    public function isCity(): bool
+    {
+        return $this->type === static::TYPE_CITY;
+    }
+
+    /**
+     * 确认此地区是否是区
+     *
+     * @return bool
+     */
+    public function isArea(): bool
+    {
+        return $this->type === static::TYPE_AREA;
+    }
+
+    /**
+     * 获取当前地区的完整名称
+     *
+     * @return string
+     */
+    public function getFullNameAttribute()
+    {
+        if ($this->parent_id === null) {
+            return $this->name;
+        }
+
+        return $this->parent->full_name . ' ' . $this->name;
+    }
 }

database/migrations/2021_12_07_131430_create_addresses_table.php

@@ -0,0 +1,38 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateAddressesTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('addresses', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('user_id')->comment('地区ID');
+            $table->unsignedBigInteger('zone_id')->comment('地区ID');
+            $table->string('consignee')->comment('收件人');
+            $table->string('telephone')->comment('联系电话');
+            $table->string('zone')->comment('所在地区');
+            $table->string('address')->comment('详细地址');
+            $table->boolean('is_default')->default(false)->comment('是否默认');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('addresses');
+    }
+}

resources/lang/zh_CN/models.php

@@ -4,10 +4,12 @@ use App\Models\Address;
 use App\Models\ProductSku;
 use App\Models\ProductSpu;
 use App\Models\ShoppingCartItem;
+use App\Models\Zone;
 
 return [
     Address::class => '地址',
     ProductSpu::class => '商品',
     ProductSku::class => '商品',
     ShoppingCartItem::class => '商品',
+    Zone::class => '地区',
 ];