Platform Overview

High-level overview of the Arya Banking microservices platform.

What is Arya Banking?

Arya Banking is an event-driven microservices platform modelling the core backend of a digital banking application. It is built around a service mesh of independently deployable Spring Boot services coordinated through Spring Cloud infrastructure.

Stack: Spring Boot 3.5.4 · Spring Cloud 2025.0.0 · Java 17 · MongoDB · Kafka · Keycloak · HashiCorp Vault · Eureka

🏗️ Core Architecture & Guides

Explore the foundational principles and technical guides that power the Arya Banking platform:

Guide	Description
System Architecture	Component roles, data flow patterns, and network layout.
Inter-service Communication	Details on Feign, OAuth2 (M2M), and Kafka event flows.
Security Model	Comprehensive overview of Keycloak, Vault, and JWT processing.
Infrastructure Stack	Docker orchestration, networking, and platform setup.
Local Development Setup	Step-by-step guide to running the full platform locally.

🧩 Microservice Documentation

Each service has its own dedicated documentation covering its specific logic, APIs, and configuration:

Service	Description	Docs
Common Library	Shared domain models, Kafka/Avro schemas, and exceptions	View Docs →
API Gateway	Reactive entry point, JWT validation, and request routing	View Docs →
User Service	Multi-step registration and profile management	View Docs →
Auth Service	Identity bridge and Keycloak user management	View Docs →
Admin Service	Infrastructure administration and secret provisioning	View Docs →
Config Server	Centralized Spring Cloud configuration layer	View Docs →
Service Registry	Eureka service discovery server	View Docs →

Repository Map

The platform is distributed across 9 interconnected repositories:

Text code-highlight

Event-Based-Banking-Application/
│
├── arya-banking/                        ← Documentation site (Hugo)
├── arya-banking-infra/                  ← Docker Compose infra (Kafka, Keycloak, Vault)
├── arya-banking-configs/                ← Centralized Git-backed configuration
├── arya-banking-common/                 ← Shared Maven library (GitHub Packages)
│
├── arya-banking-service-registry/       ← Eureka Server (Discovery)
├── arya-banking-config-server/          ← Spring Cloud Config Server
├── arya-banking-api-gateway/            ← Reactive entry point
│
├── arya-banking-user-service/           ← User domain
├── arya-banking-auth-service/           ← Identity bridge
└── arya-banking-admin-service/          ← Infrastructure admin

Quick Reference

Service	Port	Description
API Gateway	`8085`	Primary entry point (Docker)
User Service	`8086`	User domain (Host)
Auth Service	`8087`	Identity bridge (Host)
Admin Service	`8089`	Infrastructure admin (Host)
Config Server	`8090`	Centralized configuration (Docker)
Vault	`8091`	Secrets management + UI (Docker)
Eureka	`8761`	Service discovery dashboard (Docker)
Kafka	`9092` / `29092`	Messaging — external / internal (Docker)
Keycloak	`5433`	IAM admin + auth (Docker)

Shared Network: arya-banking-net
Infrastructure Runs In: Docker containers via arya-banking-infra
Business Services Run On: Host via mvn spring-boot:run
Secrets: HashiCorp Vault with AppRole authentication (local vault-credentials.yml)

overviewarchitecturemicroservices

System Architecture