flowchart LR
    subgraph QT["Trang quản trị (admin)"]
        A1["Màn hình tạo vận đơn<br/>(EzyDelivery)"] --> A2["Bộ xử lý gửi đơn<br/>(lõi thương mại điện tử)"]
        A2 --> M1["Bộ quản lý dịch vụ vận chuyển"]
    end
    subgraph WEB["Trang web (web)"]
        W1["Endpoint /callback/{mã-dịch-vụ}"] --> M2["Bộ quản lý dịch vụ vận chuyển"]
    end
    M1 -->|"tìm theo mã"| P1["AcmeExpressDeliveryService<br/>(bản admin)"]
    M2 -->|"tìm theo mã"| P2["AcmeExpressDeliveryService<br/>(bản web)"]
    P1 -->|"gọi API tạo đơn"| ACME[("API ACME Express")]
    ACME -->|"webhook trạng thái"| W1

flowchart TD
    S["Khởi động admin / web"] --> B["Quét bean của các plugin"]
    B --> C{"Bean có cài đặt<br/>DeliveryService?"}
    C -->|"Có"| D["Đưa vào bảng tra cứu<br/>khoá = getCode()"]
    C -->|"Không"| E["Bỏ qua"]
    D --> F["Trang Các dịch vụ vận chuyển<br/>liệt kê mọi mã trong bảng"]
    D --> G["Gửi đơn / nhận webhook<br/>tìm dịch vụ theo mã"]

classDiagram
    class DeliveryService {
        <<interface>>
        +getCode() String
        +deliver(setting, order) DeliveryOrderResultModel
        +verifyDeliveryCallbackParameters(...) DeliveryVerifyResponseModel
        +extractDeliveryOrder(params, body) DeliveryOrderCallbackModel
        +verifyDeliveryResult(order, params, body) DeliveryVerifyResultModel
        +getDeliveryOrderNotFoundResponse() DeliveryVerifyResponseModel
        +convertVerifyExceptionToResponse(e) DeliveryVerifyResponseModel
        +getTrackingDeliveryOrderUrl(serviceUrl, trackingId) String
        +isAuthenticatedByUsernamePassword() boolean
        +login(settingId, setting, username, password)
        +loginWithSecretKey(settingId, setting, secretKey)
        +cancelDeliveryOrderById(id)
    }
    class EzyDeliveryDeliveryService {
        <<interface>>
        +getOrderList(request, limit) TrackingDeliveryOrderPaginationModel
    }
    class AcmeExpressDeliveryService
    class AdminAcmeExpressDeliveryService
    class WebAcmeExpressDeliveryService
    DeliveryService <|-- EzyDeliveryDeliveryService
    EzyDeliveryDeliveryService <|.. AcmeExpressDeliveryService
    AcmeExpressDeliveryService <|-- AdminAcmeExpressDeliveryService
    AcmeExpressDeliveryService <|-- WebAcmeExpressDeliveryService

sequenceDiagram
    autonumber
    actor NV as Nhân viên
    participant ED as EzyDelivery (admin)
    participant LOI as Bộ xử lý gửi đơn (lõi)
    participant SV as AcmeExpressDeliveryService
    participant API as API ACME Express

    NV->>ED: Tạo vận đơn, chọn ACME_EXPRESS
    ED->>LOI: Gửi đơn với mã ACME_EXPRESS
    LOI->>LOI: Tìm dịch vụ theo mã<br/>Kiểm tra cấu hình đang ACTIVATED
    LOI->>LOI: Dựng ForDeliveryOrderModel<br/>(người gửi, kho, người nhận, sản phẩm, COD...)
    LOI->>SV: deliver(cấu hình, đơn)
    SV->>API: Gọi API tạo đơn
    API-->>SV: Kết quả + mã vận đơn
    SV-->>LOI: DeliveryOrderResultModel
    alt SUCCESS
        LOI->>LOI: Lưu mã vận đơn, trạng thái "Đã gửi yêu cầu"
    else FAILED hoặc có exception
        LOI->>LOI: Trạng thái "Gửi yêu cầu thất bại"<br/>Lưu nội dung lỗi
    end
    LOI->>LOI: Lưu properties vào dữ liệu phụ của đơn

sequenceDiagram
    autonumber
    participant API as ACME Express
    participant CB as Endpoint /callback/ACME_EXPRESS (lõi)
    participant SV as AcmeExpressDeliveryService (web)
    participant DB as Đơn giao hàng

    API->>CB: Webhook (header, query, body)
    CB->>CB: Tìm dịch vụ theo mã<br/>(không có thì 404)
    CB->>SV: verifyDeliveryCallbackParameters(...)
    alt Có lỗi
        SV-->>CB: DeliveryVerifyResponseModel (mã + dữ liệu lỗi)
        CB-->>API: Trả lỗi, dừng xử lý
    end
    CB->>SV: extractDeliveryOrder(params, body)
    SV-->>CB: DeliveryOrderCallbackModel
    CB->>DB: Tìm đơn theo deliveryOrderId
    alt Không có đơn hoặc trackingId không khớp
        CB->>SV: getDeliveryOrderNotFoundResponse()
        CB-->>API: Trả "không tìm thấy"
    end
    CB->>SV: verifyDeliveryResult(đơn, params, body)
    CB->>DB: Cập nhật trạng thái (nếu status khác rỗng)
    CB->>DB: Lưu properties (rỗng thì lưu toàn bộ params + body)
    CB-->>API: 200 OK

flowchart LR
    subgraph ACME["Mã trạng thái ACME"]
        a1["CREATED"]
        a2["PICKED"]
        a3["SHIPPING"]
        a4["DONE"]
        a5["RETURN"]
        a6["Mã khác"]
    end
    subgraph EZ["DeliveryOrderStatus"]
        e1["REQUEST_RECEIVED"]
        e2["PICKED_UP"]
        e3["IN_TRANSIT"]
        e4["DELIVERED"]
        e5["RETURNING_TO_SENDER"]
        e6["UNKNOWN"]
    end
    a1 --> e1
    a2 --> e2
    a3 --> e3
    a4 --> e4
    a5 --> e5
    a6 --> e6

flowchart TD
    A["Lưu cấu hình dịch vụ"] --> B["Lưu các ô cấu hình<br/>+ mẫu ánh xạ tiền tố"]
    B --> C{"Có nhập khoá bí mật?"}
    C -->|"Có"| D["loginWithSecretKey(...)"]
    D -->|"Exception"| E["Báo lỗi ô Khoá bí mật"]
    C -->|"Không"| F{"isAuthenticatedByUsernamePassword()?"}
    D -->|"OK"| F
    F -->|"true, có đủ tên đăng nhập + mật khẩu"| G["login(...)"]
    G -->|"Exception"| H["Báo lỗi ô Tên đăng nhập / Mật khẩu"]
    G -->|"OK"| I["Lưu thành công"]
    F -->|"false"| I

flowchart TD
    R["acme-delivery (pom cha)"] --> SDK["acme-delivery-sdk<br/>AcmeExpressDeliveryService"]
    R --> AD["acme-delivery-admin-plugin<br/>AdminAcmeExpressDeliveryService<br/>+ mẫu tiền tố mặc định"]
    R --> WB["acme-delivery-web-plugin<br/>WebAcmeExpressDeliveryService"]
    AD --> SDK
    WB --> SDK
    SDK -.->|"phụ thuộc"| E1["ecommerce-sdk<br/>ezydelivery-sdk"]

flowchart LR
    A["Build và cài<br/>admin + web plugin"] --> B["Khởi động lại<br/>admin và web"]
    B --> C["ACME_EXPRESS xuất hiện<br/>trong Các dịch vụ vận chuyển"]
    C --> D["Điền cấu hình<br/>bật ACTIVATED"]
    D --> E["Khai báo webhook<br/>trên ACME Express"]
    E --> F["Tạo vận đơn thử<br/>chọn ACME Express"]