Spring Boot & MiniBank'a Giriş

Mini sözlük: Aynı dili konuşalım

Eğitim boyunca sık geçecek birkaç kelimeyi en baştan netleştirelim. Bu modülde derinleşmiyoruz; sadece kelimelerin ne anlama geldiğini oturtuyoruz.

Bu eğitimde ne yapacağız?

Tek bir ürünü — MiniBank — sıfırdan production'a yakın bir olgunluğa kadar, 3 günde 11 modül boyunca birikimli olarak inşa edeceğiz.

Bu eğitim bağımsız örneklerden oluşmaz. Her modül bir öncekinin bıraktığı yerin üstüne yeni bir yetenek ekler: önce çekirdek servis katmanı, sonra web katmanı, en sonunda güvenlik, veri ve gözlemlenebilirlik. Modül sonunda elinde çalışan, anlamlı bir banka API'si olur — ezberlenmiş parçalar değil.

Spring Boot neden var?

Spring Boot'un temel vaadi sade: "Sen iş mantığına odaklan; uygulamayı ayağa kaldırmak için gereken standart parçaları ben hazırlayayım."

Bir web uygulaması yazmak sadece controller yazmak değildir. HTTP isteğini karşılayacak bir sunucu, isteği doğru metoda yönlendiren bir mekanizma, JSON dönüşümü, hata yönetimi, konfigürasyon okuma ve daha fazlası gerekir. Spring Boot bu tekrar eden parçaları yaygın ve güvenli varsayılanlarla hazırlar. Bu modülde sadece bu çerçeveyi tanıyoruz; nasıl çalıştığını Modül 01'de açacağız.

Nasıl çalışacağız?

Her modülde aynı ritmi izleyeceğiz: önce portalda öğren, sonra dashboard'da case'i aç, branch'i klonla, kendin yaz, test ile doğrula.

Geliştirme ortamı

Tek ihtiyacın JDK 17 ve projeyi klonlamak. Maven'ı ayrı kurmana gerek yok — proje kendi wrapper'ı (./mvnw) ile gelir.

• JDK 17 kurulu (java -version ile doğrula).
• Repoyu klonla ve proje dizinine gir.
• lab-00-base branch'ine geç (boş MiniBank iskeleti).
• Uygulamayı çalıştır ve localhost:8080'de ayağa kalkışını gör.

java -version            # 17 görmelisin
git checkout lab-00-base
./mvnw spring-boot:run   # uygulama localhost:8080'de ayağa kalkar

Uygulama ayağa kalktığında tarayıcıdan http://localhost:8080 adresini aç: Lab Dashboard'u göreceksin. http://localhost:8080/api/status ise uygulamanın UP olduğunu söyleyen basit bir JSON döner. Port 8080'dir (varsayılan; base projede henüz özel bir application.yml yoktur).

Araçlar & indirme linkleri

Eğitim için gereken ve işini kolaylaştıran araçlar. JDK 17, IntelliJ IDEA ve Git zorunlu; gerisi opsiyonel.

Base project turu

lab-00-base bilinçli olarak neredeyse boş bir iskelettir: sadece uygulamanın ayağa kalkması ve dashboard'un servis edilmesi için gereken minimum vardır. Domain (hesap, müşteri, transfer…) henüz yoktur — onları modül modül biz ekleyeceğiz.

minibank
├── pom.xml                          # Spring Boot 3.5.0 · Java 17
├── mvnw / mvnw.cmd                  # Maven Wrapper
└── src
    ├── main
    │   ├── java/com/definex/minibank
    │   │   ├── MiniBankApplication.java   # @SpringBootApplication (giriş noktası)
    │   │   └── web
    │   │       └── HomeController.java     # GET /api/status
    │   └── resources
    │       └── static
    │           └── index.html             # Lab Dashboard
    └── test/java/com/definex/minibank
        ├── MiniBankApplicationTests.java      # context ayağa kalkıyor mu
        └── MiniBankHomeControllerTests.java   # status + dashboard

Paket kök kuralı

Tüm kod com.definex.minibank kök paketinin altında durur. MiniBankApplication bu kökte olduğu için, eklediğimiz her alt paket (account, customer …) otomatik olarak görülebilir konumda olur. Bunun neden böyle olduğunu Modül 01'de (component scanning) açacağız.

Bu modülden akılda kalması gerekenler