diff --git a/CLAUDE.md b/CLAUDE.md index 1bfdd31..13e86e7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -186,6 +186,14 @@ shadcn/ui bileşenleri ihtiyaç oldukça tek tek eklenir, toplu kurulmaz. `@Import(TestcontainersConfiguration.class)` ile ona bağlanır — Spring Boot bu konteyneri test sınıfları arasında context cache üzerinden paylaşır, her sınıf ayrı konteyner açmaz. +- **Test `application.yml`'i ana dosyayı gölgeler.** İkisi classpath'te + aynı adı taşıyor; testlerde yalnızca `src/test/resources/application.yml` + yüklenir. Ana dosyayı yalnızca `MainConfigurationTest` yükler + (`spring.config.location`, Testcontainers ile context açılışı); ana + dosyaya eklenen ayar orada doğrulanır. Hikari `connection-timeout: 2s` + (long bekliyor) bu yüzden testlerden geçip canlıda açılışı durdurmuştu. + Test göreli yol kullanır, `backend/`'den çalıştırılır. Test dosyasını + `config/` altına taşıyıp her testte ana dosyayı yüklemek Faz 1'de. - **DB bilgileri ortam değişkeninden gelir**, `application.yml`'e hardcode edilmez. Yerelde `docker-compose.yml` için `.env` kullan (`.env.example`'dan kopyala); `.env` ve `.idea/` git'e girmez. diff --git a/backend/src/main/resources/application.yml b/backend/src/main/resources/application.yml index 009f367..4e815bd 100644 --- a/backend/src/main/resources/application.yml +++ b/backend/src/main/resources/application.yml @@ -9,7 +9,9 @@ spring: hikari: # Varsayılan 30 sn. DB erişilemezken /api/health ve API istekleri # 30 sn takılı kalmasın, ~2 sn'de hata versin. - connection-timeout: 2s + # Milisaniye: Hikari long bekler, "2s" yazılırsa uygulama açılmaz + # (MainConfigurationTest). + connection-timeout: 2000 jpa: # true olursa view render edilene kadar connection pool'u meşgul eder, diff --git a/backend/src/test/java/com/meteucar/mulakatslot/config/MainConfigurationTest.java b/backend/src/test/java/com/meteucar/mulakatslot/config/MainConfigurationTest.java new file mode 100644 index 0000000..a7b7e6e --- /dev/null +++ b/backend/src/test/java/com/meteucar/mulakatslot/config/MainConfigurationTest.java @@ -0,0 +1,48 @@ +package com.meteucar.mulakatslot.config; + +import static org.assertj.core.api.Assertions.assertThat; + +import com.meteucar.mulakatslot.TestcontainersConfiguration; +import com.zaxxer.hikari.HikariDataSource; +import javax.sql.DataSource; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Import; + +/** + * Ana application.yml ile uygulama bağlamı açılır. + * + * src/test/resources/application.yml classpath'te ana dosyayla aynı adı + * taşıdığı için onu gölgeliyor: diğer testler ana dosyayı hiç okumuyor. + * Hikari connection-timeout "2s" yazıldığında (long bekliyor) testler yeşil + * kalmış, uygulama canlıda açılmamıştı. Bu test ana dosyayı açıkça yükler; + * ana dosyaya eklenen ayar burada doğrulanır. + * + * Yol göreli (file:src/main/resources/...): test backend/ dizininden + * çalıştırılmalı. Maven (./mvnw test) ve CI bunu zaten yapıyor; IDE'de + * çalışma dizini repo kökü olursa dosya bulunamaz. + * + * Ortam değişkenlerinden gelen sırlar test değerleriyle verilir; DB_URL + * gerekmez, bağlantıyı @ServiceConnection (Testcontainers) sağlar. + */ +@Import(TestcontainersConfiguration.class) +@SpringBootTest(properties = { + "spring.config.location=file:src/main/resources/application.yml", + "JWT_SECRET=test-jwt-secret-en-az-otuz-iki-bayt-olmali", + "GITHUB_CLIENT_ID=test-client-id", + "GITHUB_CLIENT_SECRET=test-client-secret", + "app.content.location=classpath:test-content/*.json" +}) +class MainConfigurationTest { + + @Autowired + private DataSource dataSource; + + @Test + void contextLoadsWithMainConfiguration() { + // Varsayılan 30000 olurdu; 2000 görmek ana dosyanın okunduğunu kanıtlar. + assertThat(dataSource).isInstanceOf(HikariDataSource.class); + assertThat(((HikariDataSource) dataSource).getConnectionTimeout()).isEqualTo(2000); + } +} diff --git a/docs/deploy.md b/docs/deploy.md index 0e502e8..1a086f3 100644 --- a/docs/deploy.md +++ b/docs/deploy.md @@ -160,19 +160,44 @@ Yöntem 2'yi kullan. ### Yöntem 2 — sunucuda elle (image 7 gün içinde sunucudaysa) Sunucudaki image'lar 7 günden eskiyse `docker image prune` ile silinir. -Hâlâ duruyorsa çekmeye gerek yok, doğrudan başlatılır: +Hâlâ duruyorsa çekmeye gerek yok, doğrudan başlatılır. + +**1. Dönülecek SHA'yı bul.** Deploy SHA'yı `up -d`'den hemen sonra, +sağlık kontrolünden önce yazar. Sağlık kontrolünde düşen bir deploy'dan +sonra son satır o başarısız sürümdür; dönülecek sürüm son satırdan bir +öncekidir. ```sh cd /opt/mulakat -docker image ls 'ghcr.io/metecode/slot-*' # eski SHA'nın etiketi listede mi? +tail -n 5 deploy-history.txt # en alttaki en yeni +PREV=$(tail -n 2 deploy-history.txt | head -n 1) +echo "$PREV" # doğru SHA mı, gözle kontrol et +docker image ls 'ghcr.io/metecode/slot-*' # bu SHA'nın etiketi listede mi? +``` + +Geri alma da dosyaya satır yazar. Arka arkaya ikinci bir geri almada +"sondan bir önceki" artık doğru sürüm değildir; SHA'yı listeye bakarak +elle seç (`PREV=`). -PREV= +**2. Başlat ve geçmişe yaz.** + +```sh IMAGE_TAG=$PREV docker compose -f docker-compose.prod.yml up -d echo "$PREV" >> deploy-history.txt # geri alma da geçmişe yazılır +``` + +**3. Sağlık kontrolü.** Backend'in açılması (Flyway dahil) bir dakika +kadar sürebilir; 200 gelene kadar birkaç kez dene. -curl -i https://slot.meteucar.com/api/health +```sh +curl -i https://slot.meteucar.com/api/health # 200 ve {"status":"up"} +docker compose -f docker-compose.prod.yml ps # backend "healthy" ``` +503 `{"status":"down","db":"down"}` uygulamanın açıldığını ama +veritabanına erişemediğini gösterir; ayrıntı +`docker compose -f docker-compose.prod.yml logs backend`'de. + **Image sunucuda yoksa elle pull token gerekir.** ghcr.io paketleri private; deploy job'unun token'ı job bitince geçersiz olur ve sunucuda kayıtlı bir kimlik bilgisi bırakılmaz. Bu durumda `up -d` image'ı diff --git a/docs/roadmap-backend.md b/docs/roadmap-backend.md index a9bf2d6..358a347 100644 --- a/docs/roadmap-backend.md +++ b/docs/roadmap-backend.md @@ -94,6 +94,7 @@ Sonraki fazlarda güvenle değişiklik yapabilmek için güvenlik ağı. Takım - [ ] Hata modeli: RFC 9457 Problem Details, tutarlı hata kodları. - [ ] CI: test + coverage raporu + imaj build; PR'da kırmızıysa merge yok. - [ ] Güvenlik taraması: Dependabot + OWASP dependency-check veya Trivy (imaj). +- [ ] Test yapılandırmasını `src/test/resources/config/application.yml`'e taşı: Spring önce ana `application.yml`'i, üstüne `config/` altındakini yükler, böylece her test ana yapılandırmayı da görür. Bugün test dosyası ana dosyayı gölgeliyor; ana dosyayı yalnızca `MainConfigurationTest` yüklüyor (Hikari `connection-timeout: 2s` bu yüzden canlıya kadar fark edilmedi). **Bitti tanımı:** `./mvnw verify` temiz makinede Docker dışında hiçbir şey gerektirmeden geçiyor; README'de CI ve coverage rozetleri var.