---
config:
  theme: default
  layout: elk
  look: neo
---
flowchart TD
 subgraph s3["新架構"]
        brand_CEO_A["品牌總管理員 A"]
        Boss["Boss"]
        brand_CEO_B["品牌總管理員 B"]
        brand_A_database["主資料庫"]
        Dishs_A["菜品"]
        CategoryOptionsA["類別選項"]
        OptionsA["選項"]
        StoreA2["店鋪A2"]
        AdminAssignment["管理員分配"]
        StoreAdminA1["店鋪管理員A1"]
        StoreAdminA2["店鋪管理員A2"]
        StoreAdminA3["店鋪管理員A3"]
        MenuA2["菜單A2"]
        StoreAreaA1["StoreAreaA1"]
  end
 subgraph StoreAreaA1["店鋪A1區域"]
        StoreA1["店鋪A1"]
        MenuA1["菜單A1"]
        NetpageA1["前端網頁"]
        Promotion["促銷系統"]
        ExCoupon["兌換券"]
        DiscountCoupon["折價券"]
        MenuPage["菜單頁面"]
        CustomerCountPage["客人帳戶相關頁面"]
        ShoppingCartPage["購物車頁面"]
        CheckOutPage["客人結帳確認頁面"]
        n1["庫存與銷售控制"]
        n2["資料耦合"]
        n3["點餐頁面"]
        n4["完成頁面"]
        n5["店員前端頁面"]
        n6["訂單查看頁面"]
        n7["庫存增減頁面<br>餐點啟用/停賣頁面"]
  end
    Boss --> brand_CEO_A & brand_CEO_B
    brand_CEO_A --> brand_A_database & AdminAssignment
    brand_CEO_A -.-> StoreA1 & StoreA2
    brand_A_database -- 包含 --- Dishs_A & CategoryOptionsA & OptionsA
    CategoryOptionsA -- 連接 --> OptionsA
    Dishs_A -- 連接 --> CategoryOptionsA
    AdminAssignment --> StoreAdminA1 & StoreAdminA2 & StoreAdminA3
    StoreAdminA1 -- 擁有權限P1,P2,P3 --> StoreA1
    StoreAdminA2 -- 擁有權限P1,P2 --> StoreA1
    StoreAdminA3 -- 擁有權限P1,P2,P3,P4 --> StoreA2
    StoreA1 --> MenuA1 & n1 & n5
    brand_A_database -- 資料提供 --> MenuA1 & MenuA2
    StoreA2 --> MenuA2
    StoreA1 -- 資料提供 --> NetpageA1
    Promotion -- 包含 --- ExCoupon & DiscountCoupon
    brand_A_database --> Promotion
    NetpageA1 --- MenuPage & CustomerCountPage & ShoppingCartPage
    Promotion --> ShoppingCartPage
    Promotion -- 提供客人的Coupon --> CustomerCountPage
    ShoppingCartPage --> CheckOutPage
    brand_A_database -- 提供客人個資 --> CustomerCountPage
    n1 -- 資料提供 --> n2
    MenuA1 -- 資料提供 --> n2
    n2 --> MenuPage & n3
    CheckOutPage -- 提交訂單 --> n4
    n4 L_n4_n1_0@-- 根據販售的餐點減少庫存 --> n1
    n5 --- n3
    n5 --> n6 & n7
    n7 --> n1
    style brand_CEO_A fill:#f9f,stroke:#333
    style Boss fill:#f9f,stroke:#333,stroke-width:2px
    style brand_CEO_B fill:#f9f,stroke:#333
    style brand_A_database fill:#90EE90,stroke:#006400
    style Dishs_A fill:#C1FFC1,stroke:#006400
    style CategoryOptionsA fill:#C1FFC1,stroke:#006400
    style OptionsA fill:#C1FFC1,stroke:#006400
    style StoreA2 fill:#D8BFD8,stroke:#333
    style AdminAssignment fill:#FFB6C1,stroke:#333
    style StoreAdminA1 fill:#FFE4E1,stroke:#333
    style StoreAdminA2 fill:#FFE4E1,stroke:#333
    style StoreAdminA3 fill:#FFE4E1,stroke:#333
    style MenuA2 fill:#E6E6FA,stroke:#333
    style StoreAreaA1 fill:#B0F0FD,stroke:#1E90FF,stroke-width:4px,stroke-dasharray: 5 5
    style StoreA1 fill:#00CED1,stroke:#333,color:white,font-weight:bold
    style MenuA1 fill:#00BFFF,stroke:#333,color:white,font-weight:bold
    style NetpageA1 fill:#1E90FF,stroke:#333,color:white,font-weight:bold
    style Promotion fill:#4169E1,stroke:#333,color:white
    style ExCoupon fill:#B0E0E6,stroke:#333
    style DiscountCoupon fill:#B0E0E6,stroke:#333
    style MenuPage fill:#87CEFA,stroke:#333
    style CustomerCountPage fill:#87CEFA,stroke:#333
    style ShoppingCartPage fill:#87CEFA,stroke:#333
    style CheckOutPage fill:#87CEFA,stroke:#333
    style n1 fill:#5F9EA0,stroke:#333,color:white,font-weight:bold
    style n2 fill:#4682B4,stroke:#333,color:white,font-weight:bold
    style n3 fill:#6495ED,stroke:#333,color:white
    style n4 fill:#AA00FF,color:white,stroke:#333,font-weight:bold
    style n5 fill:#6495ED,stroke:#333,color:white
    style n6 fill:#6495ED,stroke:#333,color:white
    style n7 fill:#5F9EA0,stroke:#333,color:white,font-weight:bold
    style s3 fill:#E0FFE0,stroke:#50b050,stroke-width:2px
    L_n4_n1_0@{ animation: fast }

---
config:
  theme: default
  look: neo
  layout: elk
---
flowchart TB
 subgraph s2["權限類型"]
        P1["P1: 登入前台點餐系統<br>庫存管理"]
        P2["P2: 查看後台資料<br>記帳"]
        P3["P3: 編輯後臺資料"]
        P4["P4: 員工權限管理"]
  end
  subgraph PermissionLogic["權限管理邏輯"]
        AllStores["AllStores"]
        StoreCheck["StoreCheck"]
        brand_admin["brand_admin"]
        HasPermission["HasPermission"]
        PermissionCheck["PermissionCheck"]
        store_admin["store_admin"]
        ExecuteActions["ExecuteActions"]
  end
  brand_admin -- 檢查 manage 陣列內的 store --> StoreCheck
  StoreCheck -- 若 store 存在則擁有權限 --> HasPermission
  store_admin -- 檢查 manage 陣列內的 store & permission --> PermissionCheck
  PermissionCheck -- "確認 P1-P4 權限" --> ExecuteActions

---
config:
  theme: default
---
erDiagram
    %% 基礎架構實體
    Brand {
        ObjectId _id
        String name
        String description
        Object image
        Boolean isActive
        Date createdAt
        Date updatedAt
    }

    Store {
        ObjectId _id
        String name
        ObjectId brand
        Array businessHours
        Array announcements
        Object image
        Object serviceSettings
        Boolean isActive
        Date createdAt
        Date updatedAt
    }

    User {
        ObjectId _id
        String name
        String email
        String password
        String phone
        Array addresses
        Date dateOfBirth
        String gender
        Boolean isActive
        String resetPasswordToken
        Date resetPasswordExpire
        Date createdAt
        Date updatedAt
    }

    Admin {
        ObjectId _id
        String name
        String password
        String role
        ObjectId brand
        ObjectId store
        Boolean isActive
        Date lastLogin
        ObjectId createdBy
        Date createdAt
        Date updatedAt
    }

    %% 餐點相關實體
    DishTemplate {
        ObjectId _id
        ObjectId brand
        String name
        Number basePrice
        Array optionCategories
        Object image
        String description
        Array tags
        Date createdAt
        Date updatedAt
    }

    DishInstance {
        ObjectId _id
        ObjectId brand
        ObjectId templateId
        String name
        Number basePrice
        Array options
        Number finalPrice
        Date createdAt
        Date updatedAt
    }

    OptionCategory {
        ObjectId _id
        ObjectId brand
        String name
        String inputType
        Array options
        Date createdAt
        Date updatedAt
    }

    Option {
        ObjectId _id
        ObjectId brand
        String name
        ObjectId refDishTemplate
        Number price
        Array tags
        Date createdAt
        Date updatedAt
    }

    Menu {
        ObjectId _id
        String name
        ObjectId store
        ObjectId brand
        Array categories
        Boolean isActive
        Date createdAt
        Date updatedAt
    }

    %% 庫存管理實體
    Inventory {
        ObjectId _id
        ObjectId brand
        ObjectId store
        String inventoryType
        ObjectId dish
        String itemName
        Number totalStock
        Boolean enableAvailableStock
        Number availableStock
        Number minStockAlert
        Number targetStockLevel
        Boolean isInventoryTracked
        Boolean isSoldOut
        Date createdAt
        Date updatedAt
    }

    StockLog {
        ObjectId _id
        ObjectId brand
        ObjectId store
        String inventoryType
        ObjectId dish
        String itemName
        Number previousStock
        Number newStock
        Number changeAmount
        String changeType
        String reason
        ObjectId order
        ObjectId admin
        Date createdAt
    }

    %% 訂單系統實體 (支援混合購買)
    Order {
        ObjectId _id
        ObjectId store
        ObjectId brand
        ObjectId user
        String orderDateCode
        Number sequence
        String orderType
        String status
        Array items
        Number dishSubtotal
        Number couponSubtotal
        Number subtotal
        Number serviceCharge
        Array discounts
        Number totalDiscount
        Number total
        Number pointsEarned
        Number pointsCalculationBase
        Object pointsRule
        String paymentType
        String paymentMethod
        Object customerInfo
        Object deliveryInfo
        Object dineInInfo
        String notes
        Date createdAt
        Date updatedAt
    }

    %% 促銷系統實體
    PointRule {
        ObjectId _id
        ObjectId brand
        String name
        String description
        String type
        Number conversionRate
        Number minimumAmount
        Number validityDays
        Boolean isActive
        Date createdAt
        Date updatedAt
    }

    PointInstance {
        ObjectId _id
        ObjectId user
        ObjectId brand
        Number amount
        String source
        String sourceModel
        ObjectId sourceId
        String status
        Date expiryDate
        Date usedAt
        Object usedIn
        Date createdAt
        Date updatedAt
    }

    CouponTemplate {
        ObjectId _id
        ObjectId brand
        String name
        String description
        String couponType
        Number pointCost
        Object discountInfo
        Object exchangeInfo
        Number validityPeriod
        Boolean isActive
        Array stores
        Number totalIssued
        Date createdAt
        Date updatedAt
    }

    CouponInstance {
        ObjectId _id
        ObjectId brand
        ObjectId template
        String couponName
        String couponType
        Number discount
        Array exchangeItems
        ObjectId user
        Boolean isUsed
        Date usedAt
        ObjectId order
        Date acquiredAt
        Date expiryDate
        Number pointsUsed
        Date createdAt
        Date updatedAt
    }

    PromotionMenu {
        ObjectId _id
        ObjectId brand
        String name
        String description
        Array items
        Object pricing
        Object purchaseTypes
        Boolean isActive
        Number totalSold
        Date validFrom
        Date validUntil
        Array stores
        Date createdAt
        Date updatedAt
    }

    %% 實體關係
    Brand ||--o{ Store : "owns"
    Brand ||--o{ Admin : "employs"
    Brand ||--o{ DishTemplate : "provides"
    Brand ||--o{ OptionCategory : "defines"
    Brand ||--o{ Option : "defines"
    Brand ||--o{ PointRule : "sets"
    Brand ||--o{ CouponTemplate : "offers"
    Brand ||--o{ PromotionMenu : "creates"

    Store ||--o{ Admin : "managed_by"
    Store ||--o{ Order : "receives"
    Store ||--o{ Inventory : "manages"
    Store ||--o{ StockLog : "logs"
    Store ||--|| Menu : "uses"

    User ||--o{ Order : "places"
    User ||--o{ PointInstance : "owns"
    User ||--o{ CouponInstance : "holds"

    DishTemplate ||--o{ DishInstance : "instantiates"
    DishTemplate ||--o{ Inventory : "tracked_in"
    DishTemplate }o--o{ OptionCategory : "has_options"
    OptionCategory ||--o{ Option : "contains"

    Order }o--o{ DishInstance : "includes"
    Order ||--o{ StockLog : "affects_inventory"
    Order ||--o{ PointInstance : "generates"
    Order }o--o{ CouponInstance : "uses_coupons"

    PointRule ||--o{ PointInstance : "creates"
    CouponTemplate ||--o{ CouponInstance : "instantiates"
    PromotionMenu }o--o{ CouponTemplate : "bundles"

    Menu }o--o{ DishTemplate : "displays"

flowchart TD
    Start([用戶進入系統]) --> CheckLogin{已登入?}
    CheckLogin -->|是| Dashboard[進入主頁面]
    CheckLogin -->|否| LoginPage[登入頁面]

    LoginPage --> LoginChoice{選擇操作}
    LoginChoice -->|登入| LoginForm[輸入帳號密碼]
    LoginChoice -->|註冊| RegisterForm[註冊表單]
    LoginChoice -->|忘記密碼| ForgotPwd[忘記密碼]

    LoginForm --> Authenticate{驗證}
    Authenticate -->|成功| Dashboard
    Authenticate -->|失敗| LoginError[顯示錯誤訊息] --> LoginPage

    RegisterForm --> VerifyPhone[電話驗證]
    VerifyPhone --> CreateAccount[創建帳號]
    CreateAccount --> Dashboard

    ForgotPwd --> SendSMS[發送簡訊驗證碼]
    SendSMS --> VerifyCode[驗證碼驗證]
    VerifyCode --> ResetPassword[重設密碼]
    ResetPassword --> LoginPage

flowchart TD
    Start([開始購物]) --> Cart[加入購物車]
    Cart --> ItemChoice{選擇商品類型}

    ItemChoice -->|餐點| AddDish[添加餐點到購物車]
    ItemChoice -->|兌換券套餐| AddCoupon[添加券套餐到購物車]

    AddDish --> Cart
    AddCoupon --> Cart
    Cart --> CheckOut[結帳]

    CheckOut --> CalcPoints[計算點數獎勵<br/>基於總金額]
    CalcPoints --> PaymentChoice{選擇支付方式}

    PaymentChoice -->|現金| CreateOrderCash[創建訂單<br/>status: unpaid]
    PaymentChoice -->|線上支付| CreateOrderOnline[創建訂單<br/>進入支付流程]

    CreateOrderCash --> ProcessDish[處理餐點項目<br/>生成DishInstance<br/>扣減庫存]
    CreateOrderOnline --> PaymentGateway[支付閘道]

    PaymentGateway --> PaymentResult{支付結果}
    PaymentResult -->|成功| OrderPaid[訂單狀態: paid]
    PaymentResult -->|失敗| PaymentFailed[支付失敗] --> PaymentChoice

    OrderPaid --> ProcessDish
    ProcessDish --> ProcessCoupons[處理兌換券項目<br/>生成CouponInstance]
    ProcessCoupons --> AwardPoints[發放點數獎勵<br/>基於訂單總額]
    AwardPoints --> OrderComplete[訂單完成]

    CreateOrderCash --> WaitPayment[等待現金支付確認]
    WaitPayment --> StaffConfirm{店員確認收款}
    StaffConfirm -->|確認| OrderPaid
    StaffConfirm -->|取消| CancelOrder[取消訂單]

flowchart TD
    Start[顧客下單頁面] --> Submit[顧客提交訂單]
    Submit --> PaymentChoice{選擇付款方式}

    %% 現場付款流程
    PaymentChoice -->|現場付款<br/>On-site| CreateOnsite[創建訂單<br/>isFinalized: true<br/>status: unpaid]
    CreateOnsite --> SuccessDetail[訂單詳情頁面<br/>付款成功]

    %% 線上付款流程
    PaymentChoice -->|線上付款<br/>Online| CreateTemp[創建臨時訂單<br/>isFinalized: false<br/>status: pending_payment]
    CreateTemp --> CreateTxn[創建 Transaction<br/>tempOrderData: Order._id]
    CreateTxn --> RedirectPlatform[跳轉到金流平台]
    RedirectPlatform --> SelectMethod[選擇線上支付方式<br/>信用卡/LINE Pay/Apple Pay]
    SelectMethod --> Processing[支付處理中...]

    Processing --> PaymentResult{支付結果}

    %% 支付成功
    PaymentResult -->|成功| FinalizeOrder[完成訂單<br/>isFinalized: true<br/>status: paid<br/>補充 orderDateCode, sequence]
    FinalizeOrder --> UpdateTxn[更新 Transaction<br/>orderId: Order._id<br/>status: completed]
    UpdateTxn --> RedirectSuccess[重定向到訂單詳情]
    RedirectSuccess --> SuccessDetail[訂單成功<br/>訂單詳情頁面]

    %% 支付失敗
    PaymentResult -->|失敗| CancelOrder[標記訂單<br/>status: cancelled]
    CancelOrder --> UpdateTxnFail[更新 Transaction<br/>status: failed]
    UpdateTxnFail --> RedirectFail[重定向回下單頁面<br/>顯示錯誤訊息]
    RedirectFail --> Start

flowchart TD
    UserLogin([用戶登入]) --> ViewPromo[查看促銷活動]
    ViewPromo --> PromoType{促銷類型}

    PromoType -->|點數兌換券| PointExchange[點數兌換流程]
    PromoType -->|現金買券| CashPurchase[現金購買流程]
    PromoType -->|套餐優惠| BundlePurchase[套餐購買流程]

    PointExchange --> CheckPoints[檢查點數餘額]
    CheckPoints --> EnoughPoints{點數足夠?}
    EnoughPoints -->|是| DeductPoints[扣除點數]
    EnoughPoints -->|否| InsufficientPoints[點數不足提示]

    DeductPoints --> GenerateCoupon[生成兌換券實例]
    GenerateCoupon --> NotifyUser[通知用戶]

    CashPurchase --> CreatePayment[創建支付訂單]
    CreatePayment --> PaymentProcess[支付流程]
    PaymentProcess --> PaymentSuccess{支付成功?}
    PaymentSuccess -->|是| GenerateCoupon
    PaymentSuccess -->|否| PaymentFail[支付失敗]

    BundlePurchase --> SelectBundle[選擇套餐組合]
    SelectBundle --> CalcDiscount[計算套餐折扣]
    CalcDiscount --> PaymentProcess

    NotifyUser --> UseCoupon[使用兌換券]
    UseCoupon --> OrderDiscount[訂單折扣/免費兌換]

flowchart TD
    OrderComplete([訂單完成]) --> CheckInventory{檢查庫存設定}
    CheckInventory -->|啟用庫存追蹤| AutoDeduct[自動扣減庫存]
    CheckInventory -->|未啟用| SkipInventory[跳過庫存處理]

    AutoDeduct --> UpdateStock[更新庫存數量]
    UpdateStock --> LogChange[記錄庫存變動日誌]
    LogChange --> CheckAlert{達到警告門檻?}

    CheckAlert -->|是| SendAlert[發送補貨警告]
    CheckAlert -->|否| StockComplete[庫存處理完成]

    SendAlert --> CheckSoldOut{庫存歸零?}
    CheckSoldOut -->|是| SetSoldOut[設定為售完]
    CheckSoldOut -->|否| StockComplete

    SetSoldOut --> NotifyStaff[通知店員]
    NotifyStaff --> StockComplete

    StaffRestock([店員補貨]) --> ManualAdd[手動增加庫存]
    ManualAdd --> UpdateStock

    ManagerAdjust([管理員調整]) --> StockAdjust[庫存調整]
    StockAdjust --> UpdateStock

flowchart TD
    OrderPaid([訂單支付完成]) --> CheckUser{用戶已登入?}
    CheckUser -->|否| SkipPoints[跳過點數發放]
    CheckUser -->|是| GetRules[獲取品牌點數規則]

    GetRules --> RuleActive{規則啟用?}
    RuleActive -->|否| SkipPoints
    RuleActive -->|是| CheckMinimum{達到最低消費?}

    CheckMinimum -->|否| SkipPoints
    CheckMinimum -->|是| CalcPoints[計算點數<br/>總額/轉換率]

    CalcPoints --> CreatePoints[創建點數實例]
    CreatePoints --> SetExpiry[設定過期日期]
    SetExpiry --> NotifyUser[通知用戶獲得點數]

    UserViewPoints([用戶查看點數]) --> AutoCheckExpired[自動檢查過期點數]
    AutoCheckExpired --> MarkExpired[標記過期點數]
    MarkExpired --> DisplayBalance[顯示當前餘額]

    UsePoints([用戶使用點數]) --> CheckBalance{餘額足夠?}
    CheckBalance -->|否| InsufficientBalance[餘額不足]
    CheckBalance -->|是| DeductFIFO[按到期日扣除點數]

    DeductFIFO --> MarkUsed[標記點數為已使用]
    MarkUsed --> UpdateBalance[更新點數餘額]
    UpdateBalance --> ProcessComplete[點數使用完成]

flowchart TD
    AdminLogin([管理員登入]) --> VerifyRole[驗證角色]
    VerifyRole --> RoleLevel{角色層級}

    RoleLevel -->|系統級| SystemAccess[系統全權限<br/>管理所有品牌店鋪]
    RoleLevel -->|品牌級| BrandAccess[品牌權限<br/>管理品牌下店鋪]
    RoleLevel -->|店鋪級| StoreAccess[店鋪權限<br/>管理單一店鋪]

    SystemAccess --> ManageAll[管理所有資源]
    BrandAccess --> CheckBrand{驗證品牌權限}
    StoreAccess --> CheckStore{驗證店鋪權限}

    CheckBrand -->|通過| ManageBrand[管理品牌資源]
    CheckBrand -->|拒絕| AccessDenied[拒絕訪問]

    CheckStore -->|通過| ManageStore[管理店鋪資源]
    CheckStore -->|拒絕| AccessDenied

    ManageAll --> AdminAction[執行管理操作]
    ManageBrand --> AdminAction
    ManageStore --> AdminAction

    AdminAction --> LogActivity[記錄操作日誌]
    LogActivity --> Result[返回操作結果]