01｜業務流程與範疇

flowchart LR
    Demand[上游訂單需求] --> Ordering[Ordering 收單]
    Ordering --> Inventory[Inventory 整單配貨]
    Receipt[同步收貨] --> Inventory
    Inventory --> WMS[WMS 波次／揀貨／包裝／交運]
    WMS --> Done[Inventory 完成出庫]
    Done --> Fulfilled[Ordering 履約完成]
    Cancel[取消請求] --> Fulfillment[Fulfillment 取消協調]
    Fulfillment --> WMS
    Fulfillment --> Ordering

載入圖表…

flowchart TB
    subgraph People["上游與作業人員"]
        direction LR
        Demand[提供訂單、貨主、倉別與出貨期限]
        Receipt[核對收貨資料與現物]
        Review[異常時查單、盤點或修正資料]
        Demand ~~~ Receipt ~~~ Review
    end
    subgraph Interface["操作介面"]
        direction LR
        OrderAPI[POST /orders]
        ReceiptAPI[POST /stock-receipts]
        Query[查詢訂單與履約進度]
        OrderAPI ~~~ ReceiptAPI ~~~ Query
    end
    subgraph Services["核心業務服務"]
        direction LR
        Validate{訂單資料有效？}
        Pending[建立訂單 PENDING]
        Allocate{可整單配貨？}
        Waiting[需求保持 CONFIRMED]
        Assigned[一次預留全部需求 ASSIGNED]
        Warehouse[WMS 揀貨、包裝與交運]
        Done[扣減庫存 DONE、完成履約 FULFILLED]
        Reject[拒絕請求並回報原因]
        StockReceipt[驗證收貨並原子入帳]
        Validate -->|通過| Pending --> Allocate
        Validate -->|失敗| Reject
        Allocate -->|不足| Waiting
        Allocate -->|充足| Assigned --> Warehouse --> Done
        Waiting -. 條件改變後重評 .-> Allocate
        StockReceipt -. 可用量增加 .-> Waiting
    end
    subgraph Infrastructure["資料與事件基礎設施"]
        direction LR
        DB[(PostgreSQL 業務資料與 Outbox)]
        CDC[Debezium 擷取已提交事件]
        Kafka[Kafka 交付事件]
        Inbox[各訂閱者以 Inbox 去重]
        DB --> CDC --> Kafka --> Inbox
    end
    People -->|提交需求或查詢| Interface
    Interface -->|HTTP 請求| Services
    Services -. 儲存狀態與交付事件 .-> Infrastructure

載入圖表…

stateDiagram-v2
    [*] --> PENDING: place
    PENDING --> ALLOCATED: markAllocated
    ALLOCATED --> FULFILLED: markFulfilled
    PENDING --> CANCELLED: cancel
    ALLOCATED --> CANCELLED: cancel（跨服務協調後）
    CANCELLED --> CANCELLED: 相同取消事實重播
    FULFILLED --> FULFILLED: 相同履約事實重播
    FULFILLED --> [*]
    CANCELLED --> [*]

載入圖表…

stateDiagram-v2
    [*] --> CONFIRMED
    CONFIRMED --> ASSIGNED: 全需求可配與原子預留
    ASSIGNED --> DONE: Shipment 交運後完成出庫
    CONFIRMED --> CANCELLED: 取消未預留需求
    ASSIGNED --> CANCELLED: 外部取消確認後釋放預留
    DONE --> [*]
    CANCELLED --> [*]

載入圖表…