APEX BANK - Private Client Treasury Portal

A premium multi-currency core banking portal and distributed engine featuring real-time ledger settlement, international transfers, card funding, and foreign exchange tracking.

Core Features

• Consolidated Cash Pools: Multi-currency ledger balances (USD, EUR, GBP, etc.) updated in real-time.
• International Transfers: Cross-currency P2P transfers powered by distributed Saga Orchestration with transaction reversal protection.
• Instant Card Deposits: Secure mock card funding integrated with a backend Stripe sandbox pipeline.
• Live Forex Exchange Rates: Continuous mid-market rate tracking and automatic conversions.

---

Getting Started on Localhost

1. Prerequisites

• Java 21 & Maven (for Backend Services)
• Node.js 18+ & npm (for Frontend Portal)
• PostgreSQL (running locally)

2. Backend Setup

1. Clone the repository and configure the .env environment variables in the root folder:

   STRIPE_SECRET_KEY=your_stripe_test_secret_key
   STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret

2. Start the database and backend services using Maven:

   # Run all Spring Boot microservices
   mvn spring-boot:run -pl auth-service
   mvn spring-boot:run -pl clearing-service
   mvn spring-boot:run -pl ledger-service
   mvn spring-boot:run -pl fx-service
   mvn spring-boot:run -pl notification-service
   mvn spring-boot:run -pl gateway-service

3. Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies and start the Vite development server:

   npm install

3. Run the development server:

   npm run dev

4. Access the premium banking portal at http://localhost:5173.