DenTalk

多重身份的設定

User 資料表是系統中最頻繁被查詢的資源之一。為了減少查詢次數和 JSON 資料的消耗， 我們選擇將多重身份資訊儲存在同一張表的單一欄位中，採用 Bitmask（位元遮罩）的方式處理。

Bitmask 實作

以下是 EnumIdentity 的實作，透過位元運算（1 << n）定義 12 種不同身份類型， 包括牙醫師、診所、醫院、講師、學生等。每個身份對應一個獨立的位元位置，可以透過位元 OR 運算組合多重身份。

<?php

namespace App\Enum;

use Illuminate\Support\Collection;

enum EnumIdentity: int
{
    case NULL = 0;
    case DENTIST = 1 << 0;              // 牙醫師
    case DENTAL_ASSISTANT = 1 << 1;     // 牙科助理
    case DENTAL_HYGIENIST = 1 << 2;     // 口腔衛生師
    case DENTAL_TECHNICIAN = 1 << 3;    // 牙體技術師
    case INTERN = 1 << 4;                // 實習生
    case STUDENT = 1 << 5;               // 學生
    case CLINIC = 1 << 6;                // 診所
    case HOSPITAL = 1 << 7;              // 醫院
    case VENDOR = 1 << 8;                // 廠商
    case INSTRUCTOR = 1 << 9;            // 講師
    case ASSOCIATION = 1 << 10;          // 公會
    case SOCIETY = 1 << 11;              // 協會

    public function getLabel(): string { /* ... */ }
    public function getGroup(): string { /* ... */ }

    // 權限判斷方法
    public function isJobProvider(): bool { /* 醫院、診所 */ }
    public function isJobSeeker(): bool { /* 牙醫師、助理等 */ }
    public function isCourseProvider(): bool { /* 講師 */ }
    public function canSell(): bool { /* 可販售權限 */ }

    // Bitmask 雙向轉換
    public static function fromBitmask(int $bitmask): Collection
    {
        // 將整數轉換為身份集合
        return collect(self::cases())
            ->filter(fn ($case) => ($bitmask & $case->value) !== 0);
    }

    public static function toBitmask(array|Collection $identities): int
    {
        // 將身份集合轉換為整數
        return collect($identities)
            ->map(fn ($identity) => $identity->value)
            ->reduce(fn ($carry, $val) => $carry | $val, 0);
    }
}

技術優勢

• 資料庫效能 - 單一欄位儲存，減少 JOIN 查詢，提升查詢速度
• 彈性組合 - 使用者可同時擁有多種身份（如：牙醫師 + 講師）
• 權限管理 - 透過 isJobProvider()、canSell() 等方法快速判斷權限
• 身份分組 - getGroup() 方法可將相關身份歸類（如：牙醫事相關人員）

訂單複雜的狀態管理

商城功能涉及複雜的訂單狀態轉換，從下單、付款、出貨到完成，每個階段都有嚴格的狀態限制。 為了避免程式碼中充斥大量的 if/else 條件判斷，本專案採用 State Machine（狀態機）的設計模式。

State Machine 優勢

• 清晰的狀態定義 - 明確定義所有可能的訂單狀態（待付款、已付款、配送中、已完成、已取消等）
• 嚴格的轉換規則 - 限制狀態只能按照預定規則轉換，避免非法狀態出現
• 易於維護 - 避免複雜的條件判斷巢狀，新增狀態或修改流程時更加安全
• 程式碼可讀性 - 狀態轉換邏輯集中管理，容易理解整體業務流程

透過 State Machine 模式，即使訂單流程再複雜，也能保持程式碼的簡潔與可維護性。