📦 epiQ 多網站電商 · 架構藍圖

graph TD
    subgraph core["Odoo 18 核心"]
        direction LR
        W[website]
        WS[website_sale]
        PAY[payment]
        ACC[account]
    end

    MV["選單/頁面權限
menu_visibility"]:::ok
    AS["業務代訂
sale_assisted"]:::ok
    THEMES["3 個佈景主題
liquor · tobacco · apple_shop"]:::ok
    EXTRA["詢價 inquiry
法規彈窗 legal_popup"]:::ok

    PEC["金流 payment_ecpay
payment_newebpay"]:::warn
    EIT["電子發票
ecpay_invoice_tw"]:::warn

    MISS["租賃 / BYOD / CTBC 模組
缺 property_rental、user_signup"]:::no

    W --> MV
    WS --> AS
    MV --> AS
    AS --> THEMES
    W --> THEMES
    WS --> EXTRA
    PAY --> PEC
    WS --> PEC
    ACC --> EIT
    PAY -.缺依賴.-> MISS

    classDef ok fill:#E3EFE7,stroke:#2D6A4F,stroke-width:2px,color:#1b4332;
    classDef warn fill:#F7ECDC,stroke:#92400E,stroke-width:2px,color:#5c2e0a;
    classDef no fill:#F6E2E2,stroke:#991B1B,stroke-width:1.5px,color:#7a1414,stroke-dasharray:5 3;
      

classDiagram
    class website_url_visibility {
        +新建模型
        Char url
        Many2one website_id
        Integer sequence
        Selection visibility
        Many2many group_ids
        Char visibility_password
        Html access_denied_message
        _match_url(path, website_id)
        _enforce()
        _is_internal_sales_context() ◀assisted擴充
    }
    class website_menu {
        ◇inherit
        Selection menu_visibility
        _compute_visible()
        get_tree() RPC
        save() RPC
        resolve_content_access()
        _get_content_access()
    }
    class ir_http {
        ◇inherit
        _pre_dispatch() 強制規則
        _handle_error() connected→login
        _get_error_html() 403 拒絕頁
    }
    class ir_ui_view {
        ◇inherit
        visibility 欄位整合
    }
    class website_mv {
        ◇inherit website
        Html dobtor_menu_access_denied_message
        Integer dobtor_menu_access_denied_delay
    }
    class res_groups {
        Odoo 核心
    }

    website_url_visibility "1" --> "*" res_groups : group_ids
    website_url_visibility --> website_mv : website_id
    ir_http ..> website_url_visibility : _match_url/_enforce
    website_menu ..> website_url_visibility : resolve
    website_menu --> res_groups : 受限群組
      

classDiagram
    class website_as {
        ◇inherit website
        Boolean assisted_allow_create_customer
        _assisted_can_render() 授權判斷
        _assisted_active() 已選客戶?
        _get_cart_partner_sudo() 取客戶
        sale_get_order() cart綁客戶
        _prepare_sale_order_values()
        _get_current_pricelist() 跟客戶
        _get_current_fiscal_position()
    }
    class WebsiteSaleAssisted_Controller {
        「/shop/assisted/*」
        search() 搜尋客戶
        set() 選定客戶
        clear() 取消代訂
        create_customer() 新增客戶
        share_link() 產付款連結
    }
    class sale_order {
        Odoo 核心
        Many2one partner_id ◀客戶
        Many2one user_id ◀業務
        Selection state
        Monetary amount_total
        access_token portal
        _portal_ensure_token()
        action_quotation_sent()
    }
    class res_partner {
        客戶
        Char name / email / phone
        property_product_pricelist
    }
    class res_users {
        業務（內部）
        partner_id
        groups_id
    }
    class payment_transaction {
        Odoo 核心
        state
        sale_order_ids
    }

    website_as ..> sale_order : sale_get_order()
    WebsiteSaleAssisted_Controller ..> website_as : guard
    sale_order "*" --> "1" res_partner : partner_id 客戶
    sale_order "*" --> "1" res_users : user_id 業務
    sale_order "1" --> "*" payment_transaction : 線上付款
    res_users --> res_partner : partner_id
      

flowchart TD
    A([業務登入
公司內部帳號]) --> B{進入 /shop}
    B -->|公開訪客| B0[HTTP 403
看不到商品]:::block
    B -->|授權業務| C[顯示「業務代訂」工具列]

    C --> D[搜尋客戶
/assisted/search]
    D --> E{客戶存在?}
    E -->|是| F[選定客戶
/assisted/set]
    E -->|否| G[新增客戶
/assisted/create_customer]
    G --> F

    F --> H[session 記住客戶
ws_assisted_partner_id]
    H --> I[瀏覽商品 → 加入購物車]
    I --> J[(購物車 = 報價單
partner=客戶
user=業務
價目表跟客戶)]

    J --> K{結單方式}

    K -->|路徑 A| L[直接代付結帳
/shop/checkout]
    L --> M[確認訂單 sale.order]
    M --> N[[拋後端
會計每月結單]]:::pendingA

    K -->|路徑 B| O[產生付款連結
/assisted/share_link]
    O --> P[portal token
報價單轉寄送狀態]
    P --> Q[把連結傳給客戶
LINE / 複製]
    Q --> R([客戶開啟付款網頁
看到訂單內容])
    R --> S{已裝金流?}
    S -->|否 目前| S0[無法線上付款]:::pendingB
    S -->|是 待裝| T[線上付款
payment.transaction]
    T --> U([付款完成
訂單確認])

    classDef block fill:#F6E2E2,stroke:#991B1B,color:#7a1414;
    classDef pendingA fill:#F7ECDC,stroke:#92400E,color:#5c2e0a;
    classDef pendingB fill:#F7ECDC,stroke:#92400E,color:#5c2e0a;