feat: 整合 Preline UI 3.x 與重寫 README 為 Docker 架構

- 新增 Preline UI 3.2.3 作為 UI 組件庫
- 更新 tailwind.config.js 整合 Preline
- 更新 app.js 初始化 Preline
- 完全重寫 README.md 以 Docker 容器化架構為核心
- 新增 Docker 常用指令大全
- 新增故障排除與生產部署指南
- 新增會員系統相關功能（會員、錢包、點數、會籍、禮物）
- 新增社交登入測試功能

app/Http/Controllers/Admin/DepositBonusRuleController.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Models\DepositBonusRule;
+use Illuminate\Http\Request;
+
+class DepositBonusRuleController extends Controller
+{
+    public function index()
+    {
+        $rules = DepositBonusRule::orderBy('min_amount')->get();
+        return view('admin.deposit-bonus-rules.index', compact('rules'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'min_amount' => 'required|numeric|min:0',
+            'bonus_type' => 'required|in:fixed,percentage',
+            'bonus_value' => 'required|numeric|min:0',
+            'is_active' => 'boolean',
+            'start_at' => 'nullable|date',
+            'end_at' => 'nullable|date|after:start_at',
+        ]);
+
+        DepositBonusRule::create($validated);
+
+        return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已建立');
+    }
+
+    public function update(Request $request, DepositBonusRule $depositBonusRule)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'min_amount' => 'required|numeric|min:0',
+            'bonus_type' => 'required|in:fixed,percentage',
+            'bonus_value' => 'required|numeric|min:0',
+            'is_active' => 'boolean',
+            'start_at' => 'nullable|date',
+            'end_at' => 'nullable|date|after:start_at',
+        ]);
+
+        $depositBonusRule->update($validated);
+
+        return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已更新');
+    }
+
+    public function destroy(DepositBonusRule $depositBonusRule)
+    {
+        $depositBonusRule->delete();
+        return redirect()->route('admin.deposit-bonus-rules.index')->with('success', '儲值回饋規則已刪除');
+    }
+}

app/Http/Controllers/Admin/GiftDefinitionController.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Models\GiftDefinition;
+use App\Models\MembershipTier;
+use Illuminate\Http\Request;
+
+class GiftDefinitionController extends Controller
+{
+    public function index()
+    {
+        $gifts = GiftDefinition::with('tier')->get();
+        $tiers = MembershipTier::orderBy('sort_order')->get();
+        return view('admin.gift-definitions.index', compact('gifts', 'tiers'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'type' => 'required|in:points,coupon,product,discount,cash',
+            'value' => 'required|numeric|min:0',
+            'tier_id' => 'nullable|exists:membership_tiers,id',
+            'trigger' => 'required|in:register,birthday,annual,upgrade,manual',
+            'validity_days' => 'required|integer|min:1',
+            'is_active' => 'boolean',
+        ]);
+
+        GiftDefinition::create($validated);
+
+        return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已建立');
+    }
+
+    public function update(Request $request, GiftDefinition $giftDefinition)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'type' => 'required|in:points,coupon,product,discount,cash',
+            'value' => 'required|numeric|min:0',
+            'tier_id' => 'nullable|exists:membership_tiers,id',
+            'trigger' => 'required|in:register,birthday,annual,upgrade,manual',
+            'validity_days' => 'required|integer|min:1',
+            'is_active' => 'boolean',
+        ]);
+
+        $giftDefinition->update($validated);
+
+        return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已更新');
+    }
+
+    public function destroy(GiftDefinition $giftDefinition)
+    {
+        $giftDefinition->delete();
+        return redirect()->route('admin.gift-definitions.index')->with('success', '禮品已刪除');
+    }
+}

app/Http/Controllers/Admin/MembershipTierController.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Models\MembershipTier;
+use Illuminate\Http\Request;
+
+class MembershipTierController extends Controller
+{
+    public function index()
+    {
+        $tiers = MembershipTier::orderBy('sort_order')->get();
+        return view('admin.membership-tiers.index', compact('tiers'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'annual_fee' => 'required|numeric|min:0',
+            'discount_rate' => 'required|numeric|min:0|max:1',
+            'point_multiplier' => 'required|numeric|min:0',
+            'description' => 'nullable|string',
+            'is_default' => 'boolean',
+        ]);
+
+        if ($request->is_default) {
+            MembershipTier::where('is_default', true)->update(['is_default' => false]);
+        }
+
+        MembershipTier::create($validated);
+
+        return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已建立');
+    }
+
+    public function update(Request $request, MembershipTier $membershipTier)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'annual_fee' => 'required|numeric|min:0',
+            'discount_rate' => 'required|numeric|min:0|max:1',
+            'point_multiplier' => 'required|numeric|min:0',
+            'description' => 'nullable|string',
+            'is_default' => 'boolean',
+        ]);
+
+        if ($request->is_default && !$membershipTier->is_default) {
+            MembershipTier::where('is_default', true)->update(['is_default' => false]);
+        }
+
+        $membershipTier->update($validated);
+
+        return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已更新');
+    }
+
+    public function destroy(MembershipTier $membershipTier)
+    {
+        $membershipTier->delete();
+        return redirect()->route('admin.membership-tiers.index')->with('success', '會員等級已刪除');
+    }
+}

app/Http/Controllers/Admin/PointRuleController.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Models\PointRule;
+use Illuminate\Http\Request;
+
+class PointRuleController extends Controller
+{
+    public function index()
+    {
+        $rules = PointRule::all();
+        return view('admin.point-rules.index', compact('rules'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'trigger' => 'required|in:purchase,deposit,register,birthday,referral',
+            'points_per_unit' => 'required|integer|min:1',
+            'unit_amount' => 'required|numeric|min:0',
+            'validity_days' => 'required|integer|min:1',
+            'is_active' => 'boolean',
+        ]);
+
+        PointRule::create($validated);
+
+        return redirect()->route('admin.point-rules.index')->with('success', '點數規則已建立');
+    }
+
+    public function update(Request $request, PointRule $pointRule)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'trigger' => 'required|in:purchase,deposit,register,birthday,referral',
+            'points_per_unit' => 'required|integer|min:1',
+            'unit_amount' => 'required|numeric|min:0',
+            'validity_days' => 'required|integer|min:1',
+            'is_active' => 'boolean',
+        ]);
+
+        $pointRule->update($validated);
+
+        return redirect()->route('admin.point-rules.index')->with('success', '點數規則已更新');
+    }
+
+    public function destroy(PointRule $pointRule)
+    {
+        $pointRule->delete();
+        return redirect()->route('admin.point-rules.index')->with('success', '點數規則已刪除');
+    }
+}

app/Http/Controllers/Api/MemberController.php

@@ -0,0 +1,260 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\Member;
+use App\Models\SocialAccount;
+use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\Rules\Password;
+
+class MemberController extends Controller
+{
+    /**
+     * 會員註冊
+     */
+    public function register(Request $request): JsonResponse
+    {
+        $validator = Validator::make($request->all(), [
+            'name' => ['required', 'string', 'max:255'],
+            'email' => ['nullable', 'email', 'unique:members,email'],
+            'phone' => ['nullable', 'string', 'unique:members,phone'],
+            'password' => ['required', Password::min(6)],
+            'birthday' => ['nullable', 'date'],
+            'gender' => ['nullable', 'in:male,female,other'],
+        ], [
+            'name.required' => '請輸入姓名',
+            'email.unique' => '此 Email 已被註冊',
+            'phone.unique' => '此手機號碼已被註冊',
+            'password.required' => '請輸入密碼',
+        ]);
+
+        if ($validator->fails()) {
+            return response()->json([
+                'success' => false,
+                'message' => '驗證失敗',
+                'errors' => $validator->errors(),
+            ], 422);
+        }
+
+        // 必須提供 email 或 phone 其中之一
+        if (empty($request->email) && empty($request->phone)) {
+            return response()->json([
+                'success' => false,
+                'message' => '請提供 Email 或手機號碼',
+            ], 422);
+        }
+
+        $member = Member::create([
+            'name' => $request->name,
+            'email' => $request->email,
+            'phone' => $request->phone,
+            'password' => $request->password,
+            'birthday' => $request->birthday,
+            'gender' => $request->gender,
+        ]);
+
+        $token = $member->createToken('member-token')->plainTextToken;
+
+        return response()->json([
+            'success' => true,
+            'message' => '註冊成功',
+            'data' => [
+                'member' => $member,
+                'token' => $token,
+            ],
+        ], 201);
+    }
+
+    /**
+     * 會員登入（Email/Phone + Password）
+     */
+    public function login(Request $request): JsonResponse
+    {
+        $validator = Validator::make($request->all(), [
+            'account' => ['required', 'string'],
+            'password' => ['required', 'string'],
+        ], [
+            'account.required' => '請輸入帳號',
+            'password.required' => '請輸入密碼',
+        ]);
+
+        if ($validator->fails()) {
+            return response()->json([
+                'success' => false,
+                'message' => '驗證失敗',
+                'errors' => $validator->errors(),
+            ], 422);
+        }
+
+        // 嘗試以 email 或 phone 查詢
+        $member = Member::where('email', $request->account)
+            ->orWhere('phone', $request->account)
+            ->first();
+
+        if (!$member || !Hash::check($request->password, $member->password)) {
+            return response()->json([
+                'success' => false,
+                'message' => '帳號或密碼錯誤',
+            ], 401);
+        }
+
+        if (!$member->is_active) {
+            return response()->json([
+                'success' => false,
+                'message' => '帳號已被停用',
+            ], 403);
+        }
+
+        $token = $member->createToken('member-token')->plainTextToken;
+
+        return response()->json([
+            'success' => true,
+            'message' => '登入成功',
+            'data' => [
+                'member' => $member,
+                'token' => $token,
+            ],
+        ]);
+    }
+
+    /**
+     * 社群登入
+     */
+    public function socialLogin(Request $request): JsonResponse
+    {
+        $validator = Validator::make($request->all(), [
+            'provider' => ['required', 'in:line,google,facebook'],
+            'provider_id' => ['required', 'string'],
+            'access_token' => ['nullable', 'string'],
+            'name' => ['nullable', 'string'],
+            'email' => ['nullable', 'email'],
+            'avatar' => ['nullable', 'string'],
+        ], [
+            'provider.required' => '請指定登入平台',
+            'provider.in' => '不支援的登入平台',
+            'provider_id.required' => '缺少社群用戶 ID',
+        ]);
+
+        if ($validator->fails()) {
+            return response()->json([
+                'success' => false,
+                'message' => '驗證失敗',
+                'errors' => $validator->errors(),
+            ], 422);
+        }
+
+        // 查詢是否已綁定
+        $socialAccount = SocialAccount::where('provider', $request->provider)
+            ->where('provider_id', $request->provider_id)
+            ->first();
+
+        if ($socialAccount) {
+            // 已綁定，直接登入
+            $member = $socialAccount->member;
+
+            // 更新 token
+            $socialAccount->update([
+                'access_token' => $request->access_token,
+            ]);
+        } else {
+            // 未綁定，建立新會員
+            $member = Member::create([
+                'name' => $request->name ?? '會員',
+                'email' => $request->email,
+                'avatar' => $request->avatar,
+                'email_verified_at' => $request->email ? now() : null, // 社群登入自動驗證
+            ]);
+
+            // 綁定社群帳號
+            $member->socialAccounts()->create([
+                'provider' => $request->provider,
+                'provider_id' => $request->provider_id,
+                'access_token' => $request->access_token,
+                'profile_data' => $request->only(['name', 'email', 'avatar']),
+            ]);
+        }
+
+        if (!$member->is_active) {
+            return response()->json([
+                'success' => false,
+                'message' => '帳號已被停用',
+            ], 403);
+        }
+
+        $token = $member->createToken('member-token')->plainTextToken;
+
+        return response()->json([
+            'success' => true,
+            'message' => '登入成功',
+            'data' => [
+                'member' => $member,
+                'token' => $token,
+            ],
+        ]);
+    }
+
+    /**
+     * 取得個人資料
+     */
+    public function profile(Request $request): JsonResponse
+    {
+        $member = $request->user();
+
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'member' => $member->load('socialAccounts'),
+            ],
+        ]);
+    }
+
+    /**
+     * 更新個人資料
+     */
+    public function updateProfile(Request $request): JsonResponse
+    {
+        $member = $request->user();
+
+        $validator = Validator::make($request->all(), [
+            'name' => ['nullable', 'string', 'max:255'],
+            'birthday' => ['nullable', 'date'],
+            'gender' => ['nullable', 'in:male,female,other'],
+            'avatar' => ['nullable', 'string'],
+        ]);
+
+        if ($validator->fails()) {
+            return response()->json([
+                'success' => false,
+                'message' => '驗證失敗',
+                'errors' => $validator->errors(),
+            ], 422);
+        }
+
+        $member->update($request->only(['name', 'birthday', 'gender', 'avatar']));
+
+        return response()->json([
+            'success' => true,
+            'message' => '更新成功',
+            'data' => [
+                'member' => $member,
+            ],
+        ]);
+    }
+
+    /**
+     * 登出
+     */
+    public function logout(Request $request): JsonResponse
+    {
+        $request->user()->currentAccessToken()->delete();
+
+        return response()->json([
+            'success' => true,
+            'message' => '登出成功',
+        ]);
+    }
+}

app/Http/Controllers/MemberController.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Member;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class MemberController extends Controller
+{
+    /**
+     * Display a listing of the members.
+     */
+    public function index()
+    {
+        $members = Member::query()
+            ->latest()
+            ->paginate(10);
+
+        return view('admin.members.index', [
+            'members' => $members,
+        ]);
+    }
+}

app/Http/Controllers/SocialLoginTestController.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Http;
+
+class SocialLoginTestController extends Controller
+{
+    public function index()
+    {
+        return view('test.social-login');
+    }
+
+    public function lineCallback(Request $request)
+    {
+        // 這裡可以實作後端換發 Token 的邏輯
+        // 為了測試方便，我們先直接顯示回傳的 code 與 state
+        // 或者嘗試交換 Token 並取得 User Profile
+        
+        $code = $request->input('code');
+        $state = $request->input('state');
+        $error = $request->input('error');
+        
+        return view('test.social-login', [
+            'line_data' => [
+                'code' => $code,
+                'state' => $state,
+                'error' => $error
+            ]
+        ]);
+    }
+}

app/Models/DepositBonusRule.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class DepositBonusRule extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'min_amount',
+        'bonus_type',
+        'bonus_value',
+        'is_active',
+        'start_at',
+        'end_at',
+    ];
+
+    protected $casts = [
+        'min_amount' => 'decimal:2',
+        'bonus_value' => 'decimal:2',
+        'is_active' => 'boolean',
+        'start_at' => 'datetime',
+        'end_at' => 'datetime',
+    ];
+
+    /**
+     * 取得目前有效的規則
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true)
+            ->where(function ($q) {
+                $q->whereNull('start_at')->orWhere('start_at', '<=', now());
+            })
+            ->where(function ($q) {
+                $q->whereNull('end_at')->orWhere('end_at', '>=', now());
+            });
+    }
+
+    /**
+     * 計算回饋金額
+     */
+    public function calculateBonus(float $depositAmount): float
+    {
+        if ($depositAmount < $this->min_amount) {
+            return 0;
+        }
+
+        if ($this->bonus_type === 'fixed') {
+            return $this->bonus_value;
+        }
+
+        // percentage
+        return $depositAmount * ($this->bonus_value / 100);
+    }
+}

app/Models/GiftDefinition.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class GiftDefinition extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'type',
+        'value',
+        'tier_id',
+        'trigger',
+        'validity_days',
+        'is_active',
+    ];
+
+    protected $casts = [
+        'value' => 'decimal:2',
+        'validity_days' => 'integer',
+        'is_active' => 'boolean',
+    ];
+
+    /**
+     * 適用等級
+     */
+    public function tier(): BelongsTo
+    {
+        return $this->belongsTo(MembershipTier::class, 'tier_id');
+    }
+
+    /**
+     * 發放紀錄
+     */
+    public function memberGifts(): HasMany
+    {
+        return $this->hasMany(MemberGift::class);
+    }
+
+    /**
+     * 有效禮品
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true);
+    }
+}

app/Models/Member.php

@@ -0,0 +1,147 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Illuminate\Notifications\Notifiable;
+use Laravel\Sanctum\HasApiTokens;
+use Illuminate\Support\Str;
+
+class Member extends Authenticatable
+{
+    use HasApiTokens, HasFactory, Notifiable;
+
+    /**
+     * 資料表名稱
+     */
+    protected $table = 'members';
+
+    /**
+     * 可批量賦值的屬性
+     */
+    protected $fillable = [
+        'uuid',
+        'name',
+        'email',
+        'phone',
+        'password',
+        'birthday',
+        'gender',
+        'avatar',
+        'is_active',
+        'email_verified_at',
+    ];
+
+    /**
+     * 隱藏的屬性
+     */
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    /**
+     * 屬性轉換
+     */
+    protected $casts = [
+        'email_verified_at' => 'datetime',
+        'birthday' => 'date',
+        'is_active' => 'boolean',
+        'password' => 'hashed',
+    ];
+
+    /**
+     * 建立時自動產生 UUID
+     */
+    protected static function boot()
+    {
+        parent::boot();
+
+        static::creating(function ($model) {
+            if (empty($model->uuid)) {
+                $model->uuid = (string) Str::uuid();
+            }
+        });
+    }
+
+    /**
+     * 關聯：社群帳號
+     */
+    public function socialAccounts()
+    {
+        return $this->hasMany(SocialAccount::class);
+    }
+
+    /**
+     * 關聯：錢包
+     */
+    public function wallet()
+    {
+        return $this->hasOne(MemberWallet::class);
+    }
+
+    /**
+     * 關聯：點數帳戶
+     */
+    public function points()
+    {
+        return $this->hasOne(MemberPoint::class);
+    }
+
+    /**
+     * 關聯：會員資格紀錄
+     */
+    public function memberships()
+    {
+        return $this->hasMany(MemberMembership::class);
+    }
+
+    /**
+     * 關聯：禮品紀錄
+     */
+    public function gifts()
+    {
+        return $this->hasMany(MemberGift::class);
+    }
+
+    /**
+     * 取得目前有效的會員資格
+     */
+    public function activeMembership()
+    {
+        return $this->hasOne(MemberMembership::class)->active()->latest('starts_at');
+    }
+
+    /**
+     * 檢查是否已綁定指定社群
+     */
+    public function hasSocialAccount(string $provider): bool
+    {
+        return $this->socialAccounts()->where('provider', $provider)->exists();
+    }
+
+    /**
+     * 取得或建立錢包
+     */
+    public function getOrCreateWallet(): MemberWallet
+    {
+        return $this->wallet ?? $this->wallet()->create([
+            'balance' => 0,
+            'bonus_balance' => 0,
+        ]);
+    }
+
+    /**
+     * 取得或建立點數帳戶
+     */
+    public function getOrCreatePoints(): MemberPoint
+    {
+        return $this->points ?? $this->points()->create([
+            'available_points' => 0,
+            'pending_points' => 0,
+            'expired_points' => 0,
+            'used_points' => 0,
+        ]);
+    }
+}

app/Models/MemberGift.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class MemberGift extends Model
+{
+    use HasFactory;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'member_id',
+        'gift_definition_id',
+        'status',
+        'claimed_at',
+        'expires_at',
+    ];
+
+    protected $casts = [
+        'claimed_at' => 'datetime',
+        'expires_at' => 'datetime',
+        'created_at' => 'datetime',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 禮品定義
+     */
+    public function giftDefinition(): BelongsTo
+    {
+        return $this->belongsTo(GiftDefinition::class);
+    }
+
+    /**
+     * 待領取的禮品
+     */
+    public function scopePending($query)
+    {
+        return $query->where('status', 'pending')
+            ->where(function ($q) {
+                $q->whereNull('expires_at')
+                    ->orWhere('expires_at', '>', now());
+            });
+    }
+}

app/Models/MemberMembership.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class MemberMembership extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'member_id',
+        'tier_id',
+        'starts_at',
+        'expires_at',
+        'payment_id',
+        'auto_renew',
+        'status',
+    ];
+
+    protected $casts = [
+        'starts_at' => 'datetime',
+        'expires_at' => 'datetime',
+        'auto_renew' => 'boolean',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 會員等級
+     */
+    public function tier(): BelongsTo
+    {
+        return $this->belongsTo(MembershipTier::class, 'tier_id');
+    }
+
+    /**
+     * 是否有效
+     */
+    public function getIsActiveAttribute(): bool
+    {
+        return $this->status === 'active' 
+            && (!$this->expires_at || $this->expires_at->isFuture());
+    }
+
+    /**
+     * 有效會員資格
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('status', 'active')
+            ->where(function ($q) {
+                $q->whereNull('expires_at')
+                    ->orWhere('expires_at', '>', now());
+            });
+    }
+}

app/Models/MemberPoint.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class MemberPoint extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'member_id',
+        'available_points',
+        'pending_points',
+        'expired_points',
+        'used_points',
+    ];
+
+    protected $casts = [
+        'available_points' => 'integer',
+        'pending_points' => 'integer',
+        'expired_points' => 'integer',
+        'used_points' => 'integer',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 點數異動紀錄
+     */
+    public function transactions(): HasMany
+    {
+        return $this->hasMany(PointTransaction::class, 'member_id', 'member_id');
+    }
+}

app/Models/MemberWallet.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class MemberWallet extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'member_id',
+        'balance',
+        'bonus_balance',
+    ];
+
+    protected $casts = [
+        'balance' => 'decimal:2',
+        'bonus_balance' => 'decimal:2',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 交易紀錄
+     */
+    public function transactions(): HasMany
+    {
+        return $this->hasMany(WalletTransaction::class, 'member_id', 'member_id');
+    }
+
+    /**
+     * 總餘額 (儲值 + 回饋)
+     */
+    public function getTotalBalanceAttribute(): float
+    {
+        return $this->balance + $this->bonus_balance;
+    }
+}

app/Models/MembershipTier.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class MembershipTier extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'annual_fee',
+        'discount_rate',
+        'point_multiplier',
+        'description',
+        'is_default',
+        'sort_order',
+    ];
+
+    protected $casts = [
+        'annual_fee' => 'decimal:2',
+        'discount_rate' => 'decimal:2',
+        'point_multiplier' => 'decimal:2',
+        'is_default' => 'boolean',
+        'sort_order' => 'integer',
+    ];
+
+    /**
+     * 此等級的會員紀錄
+     */
+    public function memberships(): HasMany
+    {
+        return $this->hasMany(MemberMembership::class, 'tier_id');
+    }
+
+    /**
+     * 此等級的禮品定義
+     */
+    public function giftDefinitions(): HasMany
+    {
+        return $this->hasMany(GiftDefinition::class, 'tier_id');
+    }
+
+    /**
+     * 取得預設等級
+     */
+    public static function getDefault(): ?self
+    {
+        return static::where('is_default', true)->first();
+    }
+
+    /**
+     * 是否為免費等級
+     */
+    public function getIsFreeAttribute(): bool
+    {
+        return $this->annual_fee <= 0;
+    }
+}

app/Models/PointRule.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class PointRule extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'trigger',
+        'points_per_unit',
+        'unit_amount',
+        'validity_days',
+        'is_active',
+    ];
+
+    protected $casts = [
+        'points_per_unit' => 'integer',
+        'unit_amount' => 'decimal:2',
+        'validity_days' => 'integer',
+        'is_active' => 'boolean',
+    ];
+
+    /**
+     * 取得有效規則
+     */
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true);
+    }
+
+    /**
+     * 根據金額計算可獲得點數
+     */
+    public function calculatePoints(float $amount): int
+    {
+        if ($this->unit_amount <= 0) {
+            return 0;
+        }
+
+        return (int) floor($amount / $this->unit_amount) * $this->points_per_unit;
+    }
+}

app/Models/PointTransaction.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PointTransaction extends Model
+{
+    use HasFactory;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'member_id',
+        'type',
+        'points',
+        'balance_after',
+        'description',
+        'expires_at',
+        'reference_type',
+        'reference_id',
+    ];
+
+    protected $casts = [
+        'points' => 'integer',
+        'balance_after' => 'integer',
+        'expires_at' => 'datetime',
+        'created_at' => 'datetime',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+
+    /**
+     * 是否已過期
+     */
+    public function getIsExpiredAttribute(): bool
+    {
+        return $this->expires_at && $this->expires_at->isPast();
+    }
+}

app/Models/SocialAccount.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class SocialAccount extends Model
+{
+    use HasFactory;
+
+    /**
+     * 資料表名稱
+     */
+    protected $table = 'social_accounts';
+
+    /**
+     * 可批量賦值的屬性
+     */
+    protected $fillable = [
+        'member_id',
+        'provider',
+        'provider_id',
+        'access_token',
+        'refresh_token',
+        'profile_data',
+        'token_expires_at',
+    ];
+
+    /**
+     * 屬性轉換
+     */
+    protected $casts = [
+        'profile_data' => 'array',
+        'token_expires_at' => 'datetime',
+    ];
+
+    /**
+     * 隱藏的屬性
+     */
+    protected $hidden = [
+        'access_token',
+        'refresh_token',
+    ];
+
+    /**
+     * 關聯：會員
+     */
+    public function member()
+    {
+        return $this->belongsTo(Member::class);
+    }
+}

app/Models/WalletTransaction.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class WalletTransaction extends Model
+{
+    use HasFactory;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'member_id',
+        'type',
+        'amount',
+        'balance_after',
+        'description',
+        'reference_type',
+        'reference_id',
+    ];
+
+    protected $casts = [
+        'amount' => 'decimal:2',
+        'balance_after' => 'decimal:2',
+        'created_at' => 'datetime',
+    ];
+
+    /**
+     * 所屬會員
+     */
+    public function member(): BelongsTo
+    {
+        return $this->belongsTo(Member::class);
+    }
+}