波多野结衣av一区二区全免费观看 ,92久久精品一区二区,公交车上扒开嫩j挺进去

首頁(yè)

Java

java教程

設(shè)計(jì)一個(gè)網(wǎng)路信用購(gòu)買系統(tǒng)

Susan Sarandon

Jan 15, 2025 pm 06:05 PM

在我面臨的一次技術(shù)面試中，我被要求設(shè)計(jì)一個(gè)電子商務(wù)系統(tǒng)，允許用戶從第三方供應(yīng)商購(gòu)買網(wǎng)路積分。

自信地，我提出了一個(gè)簡(jiǎn)單的解決方案：顯示可用的套餐，讓用戶選擇一個(gè)，透過(guò)外部網(wǎng)關(guān)處理付款，並與提供者互動(dòng)以提供積分。然而，當(dāng)被問(wèn)及失敗場(chǎng)景時(shí)（例如用戶完成付款後供應(yīng)商缺貨），我意識(shí)到我的設(shè)計(jì)缺乏有效處理此類問(wèn)題的彈性。

幾週前，我對(duì)閃購(gòu)系統(tǒng)和庫(kù)存預(yù)訂模式進(jìn)行了研究，特別關(guān)注庫(kù)存預(yù)訂策略。限時(shí)搶購(gòu)?fù)ǔＰ枰獞?yīng)對(duì)高需求和有限的庫(kù)存，需要複雜的機(jī)制來(lái)維持系統(tǒng)穩(wěn)定性和管理客戶期望。我發(fā)現(xiàn)的一個(gè)概念是臨時(shí)庫(kù)存預(yù)訂，這有助於防止高峰時(shí)段超售。

這項(xiàng)研究讓我想起了我的面試經(jīng)驗(yàn)。我認(rèn)識(shí)到應(yīng)用這些庫(kù)存預(yù)留策略可以解決我最初設(shè)計(jì)中的缺點(diǎn)。透過(guò)在結(jié)帳過(guò)程中暫時(shí)保留庫(kù)存，系統(tǒng)可以有效處理提供者庫(kù)存耗盡的情況。

在本研究文件中，我旨在分享從我的研究中獲得的見(jiàn)解，並提出一種設(shè)計(jì)網(wǎng)路信用購(gòu)買系統(tǒng)的改進(jìn)方法。透過(guò)整合庫(kù)存預(yù)留策略，我們可以建立一個(gè)既強(qiáng)大又用戶友好的平臺(tái)，能夠處理各種故障場(chǎng)景，同時(shí)提供無(wú)縫體驗(yàn)。

1. 關(guān)鍵設(shè)計(jì)考量

在設(shè)計(jì)網(wǎng)路信用購(gòu)買系統(tǒng)時(shí)，需要考慮幾個(gè)關(guān)鍵因素，以確保無(wú)縫、安全和愉快的使用者體驗(yàn)。讓我們來(lái)分解一下：

1.1 配額管理

即時(shí)配額驗(yàn)證：系統(tǒng)應(yīng)立即檢查網(wǎng)路積分包是否有庫(kù)存，這樣使用者就不會(huì)意外選擇不可用的選項(xiàng)。
臨時(shí)配額保留：增加短期保留所選套餐的機(jī)制，讓使用者有足夠的時(shí)間完成購(gòu)買，而不會(huì)有遺失物品的風(fēng)險(xiǎn)。
處理配額衝突：制定策略來(lái)管理多個(gè)使用者嘗試同時(shí)購(gòu)買相同套餐的情況，確保公平分配。
包裹資訊的快取管理：保持快取資料準(zhǔn)確且最新，以便使用者始終看到正確的詳細(xì)資訊和可用性。

1.2 付款處理

安全付款處理：實(shí)施強(qiáng)大的安全措施來(lái)保護(hù)用戶在交易過(guò)程中的付款詳細(xì)資訊。
用於支付保護(hù)的託管系統(tǒng)：使用託管服務(wù)來(lái)持有資金，直到積分交付，確保買家和提供者的安全。
支付網(wǎng)關(guān)整合：確保系統(tǒng)與可靠的支付網(wǎng)關(guān)順暢連接，確保交易無(wú)憂。
退款機(jī)制：建立清晰且使用者友善的流程，以便在付款失敗或取消時(shí)發(fā)放退款。

1.3 提供商集成

系統(tǒng)可用性：與擁有可靠系統(tǒng)的供應(yīng)商合作，以確保購(gòu)買過(guò)程不會(huì)中斷。
API 可靠性：與提供穩(wěn)定、記錄完善的 API 的供應(yīng)商合作，以實(shí)現(xiàn)無(wú)縫整合。
服務(wù)啟動(dòng)驗(yàn)證：包括檢查以確認(rèn)購(gòu)買的積分是否已正確且及時(shí)地啟動(dòng)。
錯(cuò)誤處理和重試：實(shí)作協(xié)定來(lái)快速擷取和解決錯(cuò)誤，並為任何失敗的進(jìn)程提供重試機(jī)制。

1.4 交易安全

資金流向控制：確保資金僅在交易成功完成後才釋放。
交易一致性：保持所有交易的記錄準(zhǔn)確一致，以防止錯(cuò)誤。
回滾機(jī)制：制定計(jì)畫在出現(xiàn)問(wèn)題時(shí)恢復(fù)交易，保護(hù)使用者和系統(tǒng)。
審核追蹤：維護(hù)詳細(xì)的日誌，以幫助有效監(jiān)控和解決任何問(wèn)題。

1.5 使用者體驗(yàn)

清晰的錯(cuò)誤訊息：為使用者提供易於理解且資訊豐富的錯(cuò)誤訊息，以指導(dǎo)他們解決遇到的任何問(wèn)題。
交易狀態(tài)可見(jiàn)度：讓用戶輕鬆即時(shí)追蹤購(gòu)買狀態(tài)，提高透明度。
快速載入包：最佳化系統(tǒng)，快速載入可用的套件，減少使用者等待時(shí)間。
即時(shí)更新：及時(shí)通知用戶其交易或可用套餐的任何變更或更新。

透過(guò)考慮這些因素，我們可以設(shè)計(jì)一個(gè)高效、安全、用戶友好的網(wǎng)路信用購(gòu)買系統(tǒng)，從而提高用戶滿意度和信任度。

2. 系統(tǒng)設(shè)計(jì)及流程

基於上述基本考慮因素，下一步是將這些原則轉(zhuǎn)化為穩(wěn)健且有效的系統(tǒng)設(shè)計(jì)。透過(guò)仔細(xì)規(guī)劃各個(gè)組件之間的交互，我們可以確保系統(tǒng)不僅滿足功能需求，而且在保持可靠性和可擴(kuò)展性的同時(shí)提供無(wú)縫的用戶體驗(yàn)。

在本節(jié)中，我們將深入研究系統(tǒng)的架構(gòu)和流程，展示配額管理、支付處理和服務(wù)激活等核心功能是如何緊密結(jié)合實(shí)現(xiàn)的。目的是強(qiáng)調(diào)每種設(shè)計(jì)選擇如何有助於解決潛在挑戰(zhàn)並提供可靠的電子商務(wù)信用購(gòu)買平臺(tái)。

讓我們先概述系統(tǒng)流程，透過(guò)流程圖視覺(jué)化，以說(shuō)明使用者從開(kāi)始到結(jié)束如何與系統(tǒng)互動(dòng)。

2.1 流程圖

Designing an Internet Credit Purchase System

為了清晰起見(jiàn)，系統(tǒng)流程分為六個(gè)階段：

封裝選擇階段

首先，使用者存取包選擇頁(yè)面，應(yīng)用程式從快取中取得包資料。此數(shù)據(jù)包括可用的包及其快取的配額信息，然後顯示給用戶。
用戶選擇一個(gè)套餐並點(diǎn)擊「購(gòu)買」。
如果該套餐的配額不可用，應(yīng)用程式會(huì)顯示「不可用」訊息並將使用者帶回選擇頁(yè)面。否則，系統(tǒng)會(huì)暫時(shí)為該使用者保留配額。

購(gòu)買啟動(dòng)

接下來(lái)，系統(tǒng)會(huì)嘗試為所選套餐保留配額。
如果預(yù)訂失敗，使用者會(huì)看到錯(cuò)誤訊息並被重新導(dǎo)向回選擇頁(yè)面。
如果預(yù)訂成功，用戶將前往付款頁(yè)面。

付款階段

在此階段，使用者開(kāi)始付款流程並被重新導(dǎo)向到第三方支付網(wǎng)關(guān)。
應(yīng)用程式等待支付網(wǎng)關(guān)的回應(yīng)（回呼）以確認(rèn)付款狀態(tài)。

付款處理

應(yīng)用程式檢查支付網(wǎng)關(guān)的回呼以驗(yàn)證付款：
- 對(duì)於無(wú)效回調(diào)，系統(tǒng)會(huì)記錄問(wèn)題並停止進(jìn)一步的步驟。
- 對(duì)於有效的回呼：
  - 如果付款失?。合到y(tǒng)釋放預(yù)留額度並通知使用者。
  - 如果付款成功：系統(tǒng)驗(yàn)證付款，託管資金，並建立新訂單。

服務(wù)啟用

付款成功後，系統(tǒng)會(huì)要求提供者啟動(dòng)服務(wù)。
- 如果啟動(dòng)失?。河毠苜Y金將退還給客戶，並通知他們失敗。
- 如果啟動(dòng)成功：系統(tǒng)驗(yàn)證啟動(dòng)。
  - 如果驗(yàn)證失敗，客戶將退款。
  - 如果驗(yàn)證成功，託管資金將釋放給提供者，並且客戶會(huì)收到通知。

後臺(tái)程式

定期快取更新：包資料快取定期更新。
即時(shí)配額更新：配額變更透過(guò) WebSocket 連線進(jìn)行傳達(dá)。

此流程可確保為使用者提供流暢、可靠的體驗(yàn)，同時(shí)還可有效管理資源和潛在錯(cuò)誤。

2.2 時(shí)序圖

下面的序列圖有助於說(shuō)明不同角色和組件之間的交互作用。

Designing an Internet Credit Purchase System

為了清晰起見(jiàn)，系統(tǒng)流程分為六個(gè)階段：

封裝選擇階段

客戶首先造訪套餐選擇頁(yè)面。
前端從快取中檢索包裹數(shù)據(jù)，並向客戶顯示所有可用的包裹及其快取的配額資訊。

購(gòu)買啟動(dòng)

一旦客戶選擇套餐並點(diǎn)擊“購(gòu)買”，前端就會(huì)向後端發(fā)送購(gòu)買請(qǐng)求。
後端即時(shí)與提供者檢查所選套餐的配額是否仍然可用。
如果有配額，後臺(tái)會(huì)暫時(shí)預(yù)留給提供者15分鐘。
後端會(huì)向前端發(fā)送預(yù)訂確認(rèn)訊息，客戶將被重定向到付款頁(yè)面。

付款階段

客戶進(jìn)入付款頁(yè)面並提交付款詳細(xì)資訊。
前端將此資訊傳送到後端，後端初始化與支付網(wǎng)關(guān)的支付會(huì)話。
支付會(huì)話準(zhǔn)備就緒後，後端會(huì)與前端分享會(huì)話詳細(xì)資訊。
前端將客戶重新導(dǎo)向至支付網(wǎng)關(guān)以完成付款。

付款處理

在支付網(wǎng)關(guān)，客戶輸入付款資訊並完成付款流程。
支付網(wǎng)關(guān)透過(guò)回呼通知後端支付狀態(tài)：
- 如果付款成功：
  - 後端與支付網(wǎng)關(guān)驗(yàn)證支付狀態(tài)。
  - 付款被託管，後端確認(rèn)託管。
- 如果付款失?。?
  - 後端釋放與提供者的預(yù)留配額，並更新付款狀態(tài)以反映失敗。
- 如果在預(yù)計(jì)時(shí)間內(nèi)沒(méi)有收到回呼：
  - 後端定期輪詢付款閘道以檢查付款狀態(tài)。如果付款失敗或逾時(shí)，後臺(tái)會(huì)釋放預(yù)留額度。

服務(wù)啟用

付款成功，後臺(tái)請(qǐng)求提供者開(kāi)通服務(wù)。
提供者回應(yīng)啟動(dòng)狀態(tài)，後端驗(yàn)證啟動(dòng)：
- 如果啟動(dòng)成功：
  - 後端將付款從託管釋放給提供者。
  - 成功通知會(huì)發(fā)送給客戶，讓他們知道服務(wù)已準(zhǔn)備就緒。
- 如果啟動(dòng)失?。?
  - 後臺(tái)將託管資金退還給客戶。
  - 發(fā)送失敗通知以告知客戶該問(wèn)題。

後臺(tái)程式

提供者透過(guò) WebSocket 連線向後端發(fā)送有關(guān)包裹配額的即時(shí)更新。
這些更新確?？烊∈冀K是最新的，因此客戶在瀏覽時(shí)可以看到最準(zhǔn)確的軟體包可用性。

三、技術(shù)實(shí)現(xiàn)

現(xiàn)在我們已經(jīng)概述了系統(tǒng)的流程和交互，是時(shí)候深入研究它們?nèi)绾卧诔淌酱a中組合在一起了。本節(jié)逐步分解實(shí)現(xiàn)，展示如何將設(shè)計(jì)轉(zhuǎn)化為工作部件，處理從管理訂單到與提供者和支付系統(tǒng)互動(dòng)的所有事務(wù)。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

這些類別的作用如下：

套餐：這是我們定義使用者可以購(gòu)買的網(wǎng)路積分套餐的地方。它會(huì)追蹤包 ID、名稱、價(jià)格、提供者成本、描述以及包是否處?kù)痘顒?dòng)狀態(tài)等詳細(xì)資訊。
訂單：將此視為用戶購(gòu)買的記錄。它包括訂單 ID、客戶 ID、所選套餐 ID 等信息，以及預(yù)訂 ID、付款 ID、託管 ID、訂單狀態(tài)、付款金額、提供者成本和時(shí)間戳等相關(guān)詳細(xì)資訊。
QuotaReservation：處理套餐配額的暫時(shí)預(yù)訂。它記錄預(yù)訂 ID、所綁定的套餐、過(guò)期時(shí)間及其當(dāng)前狀態(tài)（如有效或過(guò)期）。
OrderStatus 枚舉：此枚舉列出了訂單可能經(jīng)歷的所有可能階段，從 CREATED 和 RESERVED 到 PAYMENT_PENDING、COMPLETED 甚至 REFUNDED。
ReservationStatus 列舉：同樣，此枚舉追蹤配額預(yù)留的狀態(tài)，無(wú)論是活動(dòng)、過(guò)期、已使用或已取消。

這些類別和枚舉共同建構(gòu)了系統(tǒng)中管理包裹、訂單和配額預(yù)留的主幹。這是一種有效處理電子商務(wù)功能的簡(jiǎn)單而結(jié)構(gòu)化的方法。

// Request/Response DTOs
@Getter @Setter
public class OrderRequest {
    private String customerId;
    private String packageId;
    private BigDecimal amount;
}

@Getter @Setter
public class PaymentCallback {
    private String orderId;
    private String paymentId;
    private String status;
    private BigDecimal amount;
    private LocalDateTime timestamp;
}

@Getter @Setter
public class QuotaResponse {
    private String packageId;
    private boolean available;
    private Integer remainingQuota;
    private LocalDateTime timestamp;
}

@Getter @Setter
public class ReservationResponse {
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

@Getter @Setter
public class ActivationResponse {
    private String orderId;
    private boolean success;
    private String activationId;
    private String errorCode;
    private String errorMessage;
}

@Getter @Setter
public class VerificationResponse {
    private String orderId;
    private String activationId;
    private boolean success;
    private String status;
    private LocalDateTime activatedAt;
}

@Getter @Setter
public class PaymentRequest {
    private String orderId;
    private BigDecimal amount;
    private String currency;
    private String customerId;
    private String returnUrl;
    private String callbackUrl;
}

@Getter @Setter
public class PaymentSession {
    private String sessionId;
    private String paymentUrl;
    private LocalDateTime expiresAt;
    private String status;
}

@Getter @Setter
public class EscrowResponse {
    private String id;
    private String paymentId;
    private BigDecimal amount;
    private String status;
    private LocalDateTime createdAt;
}

讓我們來(lái)分解一下：

OrderRequest：這一切都是關(guān)於建立新訂單所需的資料。它包括客戶 ID、他們想要購(gòu)買的套餐以及他們將支付的總金額。
PaymentCallback：將此視為來(lái)自支付網(wǎng)關(guān)的通知。嘗試付款後，它會(huì)提供訂單 ID、付款 ID、狀態(tài)（成功或失?。⒅Ц督痤~以及付款時(shí)間等詳細(xì)資訊。
QuotaResponse：這是關(guān)於檢查可用性的。它告訴我們套餐是否可用、剩餘配額以及資訊上次更新的時(shí)間。
ReservationResponse：預(yù)訂套餐後，這將為您提供所有詳細(xì)資訊：預(yù)訂ID、關(guān)聯(lián)的套餐、預(yù)訂何時(shí)到期以及其當(dāng)前狀態(tài)（例如有效或已過(guò)期） .
ActivationResponse：這告訴我們服務(wù)啟動(dòng)的情況。如果成功或失敗，如果出現(xiàn)問(wèn)題，它會(huì)向我們提供啟動(dòng) ID 和錯(cuò)誤詳細(xì)資訊。
VerificationResponse：?jiǎn)?dòng)後，我們驗(yàn)證一切是否順利。其中包括訂單 ID、啟動(dòng) ID、成功狀態(tài)以及啟動(dòng)時(shí)間。
PaymentRequest：在開(kāi)始付款流程之前，此 DTO 會(huì)收集必要的詳細(xì)信息，例如訂單 ID、要支付的金額、貨幣、客戶 ID 和回調(diào) URL。
PaymentSession：這是付款流程開(kāi)始時(shí)創(chuàng)建的內(nèi)容。它包括會(huì)話 ID、付款 URL（使用者去支付的地方）、過(guò)期時(shí)間以及會(huì)話狀態(tài)。
EscrowResponse：如果資金被託管，這會(huì)告訴我們所有相關(guān)信息，例如託管 ID、付款 ID、持有金額、狀態(tài)以及創(chuàng)建時(shí)間。

所有這些類別都定義了系統(tǒng)不同部分之間通訊的建構(gòu)塊－無(wú)論是發(fā)出請(qǐng)求還是回傳回應(yīng)。他們確保每個(gè)人（和所有事物）都在同一頁(yè)上。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

快取服務(wù)

1. 目的：

該服務(wù)負(fù)責(zé)儲(chǔ)存包資料的本機(jī)快取。目標(biāo)是使系統(tǒng)更快並減少對(duì)提供者 API 的不必要呼叫。

2. 主要特點(diǎn)：

updateCache()：此方法透過(guò)從提供者取得所有套件數(shù)據(jù)，每 5 分鐘刷新一次本機(jī)快取。它確?？烊”３肿钚?。
getPackage()：此方法使用其 ID 從快取中檢索包資訊。
updatePackageQuota()：當(dāng)配額詳細(xì)資料發(fā)生變更時(shí)，此方法會(huì)使用特定套件的新資訊更新快取。

提供者整合

1. 目的：

此服務(wù)處理與提供者的 API 的通訊。它管理諸如檢查配額、預(yù)訂套餐、啟動(dòng)服務(wù)和驗(yàn)證這些啟動(dòng)等任務(wù)。

2. 主要特點(diǎn)：

checkQuota()：此方法透過(guò)呼叫提供者的 API 來(lái)檢查套件是否有足夠的可用配額。
ReserveQuota()：它透過(guò)向提供者發(fā)送請(qǐng)求來(lái)為客戶保留包裹的配額。
activateService()：當(dāng)需要為訂單啟動(dòng)服務(wù)時(shí)，此方法將處理對(duì)提供者的請(qǐng)求。
verifyActivation()：?jiǎn)?dòng)後，此方法確認(rèn)是否一切成功。
getAllPackages()：此方法從提供者檢索所有可用的套件，這對(duì)於更新快取或向使用者顯示套件選項(xiàng)非常有用。

3.重試機(jī)制：

當(dāng)出現(xiàn)臨時(shí)問(wèn)題時(shí)，該服務(wù)使用 RetryTemplate 自動(dòng)重試對(duì)提供者 API 的請(qǐng)求。這確保了系統(tǒng)即使在出現(xiàn)輕微問(wèn)題時(shí)也能保持可靠和彈性。

透過(guò)組合這些功能，此程式碼可確保系統(tǒng)有效地管理套件數(shù)據(jù)，同時(shí)保持與提供者的 API 的順暢且可靠的通訊。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

支付網(wǎng)關(guān)集成

此類在管理系統(tǒng)如何與支付網(wǎng)關(guān)互動(dòng)以順利、安全地處理金融交易方面發(fā)揮關(guān)鍵作用。

1.初始化Payment(PaymentRequest請(qǐng)求):

將此視為付款流程的開(kāi)始。它會(huì)向支付網(wǎng)關(guān)發(fā)送包含所有付款詳細(xì)資訊的請(qǐng)求。
它傳回一個(gè) PaymentSession 對(duì)象，其中包含付款 URL 和會(huì)話狀態(tài)等資訊。

2.holdInEscrow(String paymentId):

此方法使用給定的付款 ID 來(lái)保護(hù)託管帳戶中的付款。
它提供了一個(gè) EscrowResponse 對(duì)象，其中包含有關(guān)託管資金的所有詳細(xì)資訊。

3.releaseToProvider(String escrowId):

服務(wù)成功啟動(dòng)後，此方法將託管資金釋放給服務(wù)提供者。
託管 ID 用於識(shí)別和釋放正確的資金。

4.refundToCustomer(String escrowId):

如果出現(xiàn)問(wèn)題，例如服務(wù)啟動(dòng)失敗，此方法會(huì)將託管資金退還給客戶。
它使用託管 ID 來(lái)處理退款。

主要特點(diǎn)：

該類別使用 WebClient 向支付網(wǎng)關(guān)的 REST API 發(fā)送 HTTP 請(qǐng)求，確保無(wú)縫整合。
它處理關(guān)鍵操作，例如開(kāi)始付款、管理託管和處理退款。
所有方法都使用同步呼叫（透過(guò) .block()）來(lái)確保操作在繼續(xù)之前完成，從而確?？煽啃?。

在管理系統(tǒng)中安全且有效率的金融交易時(shí)，此類是拼圖的關(guān)鍵部分。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

通知 DTO

1. 電子郵件通知：

將此視為發(fā)送電子郵件通知的藍(lán)圖。它包括：
- 收件者的電子郵件 (to)。
- 電子郵件的主題。
- 用於確定格式的範(fàn)本 ID。
- 用於個(gè)人化內(nèi)容的動(dòng)態(tài)資料（templateData）。

2.簡(jiǎn)訊通知：

類似電子郵件通知，但針對(duì)簡(jiǎn)訊量身訂做。它包括：
- 收件者的電話號(hào)碼 (phoneNumber)。
- 訊息格式的範(fàn)本 ID。
- 用於個(gè)人化的動(dòng)態(tài)資料（templateData）。

通知服務(wù)

此服務(wù)處理發(fā)送給使用者的所有關(guān)於訂單狀態(tài)的通知。其工作原理如下：

1.sendSuccessNotification(訂單訂單)：

此方法處理發(fā)送成功通知。它使用：
- buildSuccessEmail 用於建立電子郵件通知。
- buildSuccessSms 用於建立簡(jiǎn)訊通知。
- 它還使用 QuotaWebSocketHandler 透過(guò) WebSocket 發(fā)送即時(shí)更新。

2.sendFailureNotification(訂單順序)：

這個(gè)負(fù)責(zé)處理失敗通知。它使用：
- buildFailureEmail 用於電子郵件。
- buildFailureSms 用於簡(jiǎn)訊。
- 與成功通知一樣，它也會(huì)發(fā)送 WebSocket 更新。

3. 輔助方法：

buildSuccessEmail 和 buildFailureEmail：這些方法根據(jù)訂單是成功還是失敗建立電子郵件通知。他們使用模板和訂單詳細(xì)資訊。
buildSuccessSms 和 buildFailureSms：它們的功能相同，但用於簡(jiǎn)訊通知。

附加功能：

WebSocket 更新：使用 QuotaWebSocketHandler 保持前端即時(shí)更新。
錯(cuò)誤記錄：如果出現(xiàn)問(wèn)題，它會(huì)記錄錯(cuò)誤以供偵錯(cuò)。

這項(xiàng)服務(wù)可確保用戶始終了解其訂單，無(wú)論是透過(guò)電子郵件、簡(jiǎn)訊或即時(shí)更新。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

配額更新類

將此類視為配額更新的簡(jiǎn)單信使。它攜帶三個(gè)關(guān)鍵訊息：
- packageId：正在更新的套件的ID。
- availableQuota: 該包還剩多少配額。
- 時(shí)間戳：更新的時(shí)間。

WebSocket 配置

1.WebSocket配置：

這是 WebSocket 通訊成為可能的設(shè)定。
它註冊(cè)一個(gè)處理程序 (quotaWebSocketHandler) 來(lái)偵聽(tīng) /ws/quota 處的 WebSocket 連線。
它還可以透過(guò)設(shè)定 allowedOrigins("*") 來(lái)允許來(lái)自任何來(lái)源的連接。

2.quotaWebSocketHandler():

這定義了將管理傳入訊息和連線的 WebSocket 處理程序 bean。

配額WebSocketHandler

這就是所有 WebSocket 魔法發(fā)生的地方！它管理伺服器和客戶端之間的即時(shí)更新。

1. 領(lǐng)域：

PackageCacheService：每當(dāng)配額更新到來(lái)時(shí)協(xié)助更新本機(jī)快取。
ObjectMapper：處理 JSON 有效負(fù)載到 Java 物件的轉(zhuǎn)換，反之亦然。
會(huì)話：追蹤所有活動(dòng)的 WebSocket 會(huì)話（目前連線的客戶端）。

2、方法：

afterConnectionEstablished（WebSocketSession 會(huì)話）：
- 連線後立即將新的客戶端會(huì)話新增至活動(dòng)清單。
afterConnectionClosed（WebSocketSession 會(huì)話，CloseStatus 狀態(tài)）：
- 斷開(kāi)連線時(shí)刪除客戶端會(huì)話。
handleTextMessage（WebSocketSession會(huì)話，TextMessage訊息）：
- 處理傳入訊息。
- 將接收到的 JSON 轉(zhuǎn)換為 QuotaUpdate 物件並更新本機(jī)快取。

3. sendOrderUpdate(訂單順序):

向所有連接的客戶端發(fā)送有關(guān)訂單變更的即時(shí)更新。
將 Order 物件轉(zhuǎn)換為 JSON 並將其作為訊息傳送到活動(dòng)的 WebSocket 會(huì)話。
確保只有開(kāi)啟的連線才能收到更新。

此守則的主要特點(diǎn)：

即時(shí)更新：
- 讓客戶立即了解配額變更和訂單更新。
執(zhí)行緒安全管理：
- 使用ConcurrentHashSet處理連接的客戶端，確保多個(gè)客戶端處?kù)痘顒?dòng)狀態(tài)時(shí)不會(huì)發(fā)生衝突。
錯(cuò)誤處理：
- 發(fā)送訊息時(shí)出現(xiàn)問(wèn)題時(shí)記錄錯(cuò)誤，以便更輕鬆地進(jìn)行故障排除。

此設(shè)定可確保後端和前端之間的順暢和即時(shí)通信，因此使用者始終可以獲得有關(guān)配額可用性和訂單狀態(tài)的最新資訊。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

以下是這些自訂異常類別的詳細(xì)資訊以及如何使用它們來(lái)處理系統(tǒng)中的特定錯(cuò)誤場(chǎng)景：

QuotaNotAvailableException：

當(dāng)使用者嘗試購(gòu)買套餐，但該套餐的配額已用完時(shí)，會(huì)觸發(fā)此異常。
它附帶一條簡(jiǎn)單的預(yù)設(shè)訊息：“軟體包配額不可用”，因此開(kāi)發(fā)者和用戶都可以清楚地了解該問(wèn)題。

OrderNotFoundException：

當(dāng)系統(tǒng)無(wú)法根據(jù)提供的 orderId 找到訂單時(shí)，此功能就會(huì)啟動(dòng)。
它包含詳細(xì)的錯(cuò)誤訊息，例如“未找到訂單：[orderId]”，可以輕鬆準(zhǔn)確地找出遺失的訂單。

PaymentVerificationException：

如果驗(yàn)證付款時(shí)出現(xiàn)問(wèn)題（可能金額不匹配，或付款狀態(tài)不清楚），則會(huì)拋出此異常。
它允許您傳遞自訂訊息，增加診斷付款問(wèn)題的靈活性和上下文。

透過(guò)使用這些異常，系統(tǒng)以乾淨(jìng)且可預(yù)測(cè)的方式處理錯(cuò)誤。它們不僅可以提高開(kāi)發(fā)人員的調(diào)試效率，還可以確保用戶在出現(xiàn)問(wèn)題時(shí)收到清晰且可操作的回饋。

// Request/Response DTOs
@Getter @Setter
public class OrderRequest {
    private String customerId;
    private String packageId;
    private BigDecimal amount;
}

@Getter @Setter
public class PaymentCallback {
    private String orderId;
    private String paymentId;
    private String status;
    private BigDecimal amount;
    private LocalDateTime timestamp;
}

@Getter @Setter
public class QuotaResponse {
    private String packageId;
    private boolean available;
    private Integer remainingQuota;
    private LocalDateTime timestamp;
}

@Getter @Setter
public class ReservationResponse {
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

@Getter @Setter
public class ActivationResponse {
    private String orderId;
    private boolean success;
    private String activationId;
    private String errorCode;
    private String errorMessage;
}

@Getter @Setter
public class VerificationResponse {
    private String orderId;
    private String activationId;
    private boolean success;
    private String status;
    private LocalDateTime activatedAt;
}

@Getter @Setter
public class PaymentRequest {
    private String orderId;
    private BigDecimal amount;
    private String currency;
    private String customerId;
    private String returnUrl;
    private String callbackUrl;
}

@Getter @Setter
public class PaymentSession {
    private String sessionId;
    private String paymentUrl;
    private LocalDateTime expiresAt;
    private String status;
}

@Getter @Setter
public class EscrowResponse {
    private String id;
    private String paymentId;
    private BigDecimal amount;
    private String status;
    private LocalDateTime createdAt;
}

OrderService 類別處理管理訂單時(shí)的繁重工作。讓我們來(lái)看看它是如何運(yùn)作的：

主要職責(zé)

createOrder(OrderRequest 請(qǐng)求):
- 這個(gè)方法主要是建立一個(gè)新訂單。它檢查包裹是否可用，獲取詳細(xì)信息，保留配額，並將訂單保存到資料庫(kù)，初始狀態(tài)為 RESERVED。
processPayment(String orderId, PaymentCallback 回呼):
- 在這裡，付款被處理。系統(tǒng)驗(yàn)證付款詳細(xì)資訊、更新訂單、將付款託管並啟動(dòng)服務(wù)啟動(dòng)流程。如果出現(xiàn)問(wèn)題，它會(huì)優(yōu)雅地管理失敗。
驗(yàn)證啟動(dòng)（訂單順序）:
- 此方法會(huì)仔細(xì)檢查服務(wù)啟動(dòng)是否順利。它最多嘗試 3 次，如果仍然失敗，系統(tǒng)會(huì)回退來(lái)處理失敗。
completeOrder(訂單順序):
- 一旦一切檢查完畢，此方法就會(huì)最終確定訂單。它將託管資金釋放給提供者，更新?tīng)顟B(tài)，並通知用戶成功。
handleActivationFailure(訂單順序):
- 如果啟動(dòng)失敗，此方法可確保客戶獲得退款並收到有關(guān)問(wèn)題所在的通知。
getOrder(String orderId):
- 這個(gè)簡(jiǎn)單的方法透過(guò) ID 檢索訂單。如果訂單不存在，則會(huì)拋出特定異常。

為什麼它有效

由於其事務(wù)性質(zhì)，它確保事務(wù)完成或回滾。
透過(guò)清晰的錯(cuò)誤處理和重試，它足夠強(qiáng)大，可以處理現(xiàn)實(shí)世界中的問(wèn)題。
通知讓使用者隨時(shí)了解每一步的情況。

此服務(wù)是訂單管理流程的支柱，將所有內(nèi)容結(jié)合在一起以提供無(wú)縫的使用者體驗(yàn)。

// Domain Models
@Getter @Setter
@Entity
public class Package {
    @Id
    private String id;
    private String name;
    private BigDecimal price;
    private BigDecimal providerCost;
    private String description;
    private boolean active;
}

@Getter @Setter
@Entity
public class Order {
    @Id
    private String id;
    private String customerId;
    private String packageId;
    private String reservationId;
    private String paymentId;
    private String escrowId;
    private OrderStatus status;
    private BigDecimal amount;
    private BigDecimal providerCost;
    private LocalDateTime createdAt;
    private LocalDateTime updatedAt;
}

@Getter @Setter
@Entity
public class QuotaReservation {
    @Id
    private String id;
    private String packageId;
    private LocalDateTime expiresAt;
    private ReservationStatus status;
}

// Enums
public enum OrderStatus {
    CREATED, RESERVED, PAYMENT_PENDING, PAYMENT_COMPLETED, 
    IN_ESCROW, ACTIVATING, ACTIVATION_FAILED, COMPLETED, REFUNDED
}

public enum ReservationStatus {
    ACTIVE, EXPIRED, USED, CANCELLED
}

OrderController 類別負(fù)責(zé)管理系統(tǒng)中訂單的 REST API 端點(diǎn)。 Think 是發(fā)出請(qǐng)求的客戶端和執(zhí)行繁重任務(wù)的後端服務(wù)之間的橋樑。

關(guān)鍵端點(diǎn)

POST /api/orders (createOrder):
- 此端點(diǎn)處理建立新訂單。
- 發(fā)生的事情是這樣的：
  - 它接收來(lái)自客戶端的 OrderRequest。
  - 呼叫 OrderService.createOrder 處理請(qǐng)求並建立訂單。
  - 發(fā)回：
    - 如果一切順利，新建立的訂單將收到 200 OK 回應(yīng)。
    - 如果包配額不可用，則會(huì)出現(xiàn) 409 衝突。
    - 任何意外問(wèn)題都會(huì)出現(xiàn) 500 內(nèi)部伺服器錯(cuò)誤。
POST /api/orders/callback (handlePaymentCallback):
- 此處理由支付網(wǎng)關(guān)發(fā)送的付款更新。
- 流程如下：
  - 它收到一個(gè)包含所有付款詳細(xì)資訊的 PaymentCallback。
  - 呼叫 OrderService.processPayment 處理付款並更新訂單狀態(tài)。
  - 可能的反應(yīng)是：
    - 200 OK 如果付款成功處理。
    - 如果提供的訂單 ID 不存在，則傳回 404 Not Found。
    - 422 如果付款驗(yàn)證不匹配，則無(wú)法處理實(shí)體。
    - 500 內(nèi)部伺服器錯(cuò)誤，出現(xiàn)任何意外狀況。
GET /api/orders/{orderId} (getOrder):
- 此端點(diǎn)透過(guò) ID 取得特定訂單的詳細(xì)資訊。
- 其工作原理如下：
  - 它呼叫 OrderService.getOrder 來(lái)擷取訂單。
  - 回傳：
    - 如果找到的話，會(huì)給出 200 OK 回應(yīng)以及訂單詳細(xì)資訊。
    - 如果訂單 ID 與任何記錄都不匹配，則會(huì)出現(xiàn) 404 Not Found。

特徵

關(guān)注點(diǎn)分離：OrderController 將所有業(yè)務(wù)邏輯委託給 OrderService，保持事物乾淨(jìng)且集中。
驗(yàn)證：使用@Valid註解驗(yàn)證請(qǐng)求有效負(fù)載，以確保傳入的資料符合預(yù)期。
錯(cuò)誤處理：
- 針對(duì)常見(jiàn)問(wèn)題（例如配額不可用或訂單缺失）提供具體且有用的回應(yīng)。
- 記錄任何問(wèn)題以使偵錯(cuò)更容易。
日誌記錄：追蹤傳入請(qǐng)求、錯(cuò)誤和訂單詳細(xì)資訊等關(guān)鍵事件，以提高可見(jiàn)度。

此控制器確?？蛻舳撕歪岫藷o(wú)縫通信，使訂單管理盡可能順利。