核心資料實體

harukibox 的資料模型由幾個核心實體構成，它們彼此關聯、串成完整的代購營運鏈。理解這些實體是掌握系統運作的基礎。

商品 Product

harukibox 的主體單位。每個商品帶有基本資訊（名稱、SKU、價格）、商品圖片、商品連結、狀態與底下的品項列表。

商品是所有下游流程的起點 — 登記、買家確認、出貨、物流、庫存與收益分析全部從商品出發。可以透過手動建立、Smart Listing AI 辨識或快速登記時一併建立。

商品底下更細的維度，例如不同版本、角色、規格或色系。每個品項可以獨立記錄數量、價格、到貨狀態與備註。

為什麼要拆品項？

同一款商品可能有「標準版」和「限定版」、不同角色或不同規格。品項讓你精確追蹤每個版本的庫存與到貨情況，也讓出貨批次可以只選特定品項。

某位買家對某商品的購買紀錄，是系統中最核心的營運單位。每筆登記包含品項明細、小計、運費、折扣、總金額、已付款金額與流程狀態。

登記串連了商品、買家、付款、確認與出貨，是整個營運鏈的樞紐。

可以從以下入口建立登記：

訂單的擁有者。每位買家可能有別名（不同社群平台的暱稱）、備註、預付款餘額與歷史購買紀錄。

harukibox 不只是商品系統，也是買家關係與對帳系統。別名機制讓同一位買家在不同平台使用不同名稱時，系統仍能正確歸戶。

將可出貨的登記按買家與狀態整理，支援單一買家出貨與批次出貨。出貨流程包含運費拆分、通知訊息產生與寄送確認。

出貨批次（Shipment Batch）允許將出貨工作分批管理，因為現實中商品不一定同時到貨，出貨常需分批進行。

三層式的倉庫地點體系：區域（Area）→ 位置（Location）→ 箱位（Box）。用於記錄商品的實體存放位置，方便倉儲查找、盤點與出貨作業。

提供給買家確認訂單內容的公開連結，通常帶有 Token 驗證。從管理端產生、複製、重新寄送，買家點擊後進入確認流程。

確認連結有到期時間設定，預設 7 天。過期後可由管理端重新啟用或重新產生。