Harden wallet domain invariants and add regression tests (#37)

Author: Amir-Golmoradi

payguard-wallet/src/main/java/dev/amg/payguard/WalletApp.java

@@ -0,0 +1,12 @@
+package dev.amg.payguard;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class WalletApp {
+
+  public static void main(String[] args) {
+    SpringApplication.run(WalletApp.class, args);
+  }
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/FinancialAccountType.java

@@ -0,0 +1,9 @@
+package dev.amg.payguard.domain.enums;
+
+public enum FinancialAccountType {
+  USER_WALLET,
+  BANK_CLEARING,
+  COMPANY_REVENUE,
+  PROMOTIONAL_EXPENSE,
+  SETTLEMENT_SUSPENSE
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/HoldStatus.java

@@ -0,0 +1,8 @@
+package dev.amg.payguard.domain.enums;
+
+public enum HoldStatus {
+  PENDING,
+  CAPTURED,
+  RELEASED,
+  EXPIRED
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/LedgerEntryType.java

@@ -0,0 +1,6 @@
+package dev.amg.payguard.domain.enums;
+
+public enum LedgerEntryType {
+  DEBIT,
+  CREDIT
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/TransactionStatus.java

@@ -0,0 +1,9 @@
+package dev.amg.payguard.domain.enums;
+
+public enum TransactionStatus {
+  INITIATED,
+  PENDING_SETTLEMENT,
+  SUCCESSFUL,
+  FAILED,
+  REVERSED
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/TransactionType.java

@@ -0,0 +1,10 @@
+package dev.amg.payguard.domain.enums;
+
+public enum TransactionType {
+  DEPOSIT,
+  WITHDRAWAL,
+  P2P_TRANSFER,
+  PURCHASE,
+  REFUND,
+  FEE
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/enums/WalletStatus.java

@@ -0,0 +1,9 @@
+package dev.amg.payguard.domain.enums;
+
+public enum WalletStatus {
+  ACTIVE,
+  SUSPENDED_DEBIT,
+  SUSPENDED_CREDIT,
+  FROZEN,
+  CLOSED
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/event/FundsHoldCapturedEvent.java

@@ -0,0 +1,22 @@
+package dev.amg.payguard.domain.event;
+
+import dev.amg.payguard.domain.value_object.HoldId;
+import dev.amg.payguard.domain.value_object.Money;
+import dev.amg.payguard.domain.value_object.WalletId;
+import domain.DomainEvent;
+import java.time.Instant;
+import java.util.UUID;
+
+public record FundsHoldCapturedEvent(
+    UUID eventId, Instant occurredAt, HoldId holdId, WalletId walletId, Money amount)
+    implements DomainEvent {
+  @Override
+  public Instant occurredOn() {
+    return occurredAt;
+  }
+
+  public static FundsHoldCapturedEvent now(
+      HoldId holdId, WalletId walletId, Money amount, Instant now) {
+    return new FundsHoldCapturedEvent(UUID.randomUUID(), now, holdId, walletId, amount);
+  }
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/event/FundsHoldCreatedEvent.java

@@ -0,0 +1,27 @@
+package dev.amg.payguard.domain.event;
+
+import dev.amg.payguard.domain.value_object.HoldId;
+import dev.amg.payguard.domain.value_object.Money;
+import dev.amg.payguard.domain.value_object.WalletId;
+import domain.DomainEvent;
+import java.time.Instant;
+import java.util.UUID;
+
+public record FundsHoldCreatedEvent(
+    UUID eventId,
+    Instant occurredAt,
+    HoldId holdId,
+    WalletId walletId,
+    Money amount,
+    Instant expiresAt)
+    implements DomainEvent {
+  @Override
+  public Instant occurredOn() {
+    return occurredAt;
+  }
+
+  public static FundsHoldCreatedEvent now(
+      HoldId holdId, WalletId walletId, Money amount, Instant expiresAt, Instant now) {
+    return new FundsHoldCreatedEvent(UUID.randomUUID(), now, holdId, walletId, amount, expiresAt);
+  }
+}

payguard-wallet/src/main/java/dev/amg/payguard/domain/event/FundsHoldExpiredEvent.java

@@ -0,0 +1,22 @@
+package dev.amg.payguard.domain.event;
+
+import dev.amg.payguard.domain.value_object.HoldId;
+import dev.amg.payguard.domain.value_object.Money;
+import dev.amg.payguard.domain.value_object.WalletId;
+import domain.DomainEvent;
+import java.time.Instant;
+import java.util.UUID;
+
+public record FundsHoldExpiredEvent(
+    UUID eventId, Instant occurredAt, HoldId holdId, WalletId walletId, Money amount)
+    implements DomainEvent {
+  public static FundsHoldExpiredEvent now(
+      HoldId holdId, WalletId walletId, Money amount, Instant now) {
+    return new FundsHoldExpiredEvent(UUID.randomUUID(), now, holdId, walletId, amount);
+  }
+
+  @Override
+  public Instant occurredOn() {
+    return occurredAt;
+  }
+}