<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by OĞUZHAN ÇART on Medium]]></title>
        <description><![CDATA[Stories by OĞUZHAN ÇART on Medium]]></description>
        <link>https://medium.com/@oguzhancart1?source=rss-8cd487756f95------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*aBM17GYkt31yVSB7pPgCBA@2x.jpeg</url>
            <title>Stories by OĞUZHAN ÇART on Medium</title>
            <link>https://medium.com/@oguzhancart1?source=rss-8cd487756f95------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 09:09:02 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@oguzhancart1/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Go İçin Gin Web Framework]]></title>
            <link>https://medium.com/@oguzhancart1/go-i%CC%87%C3%A7in-gin-web-framework-b10f2fb2b4a4?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/b10f2fb2b4a4</guid>
            <category><![CDATA[gin]]></category>
            <category><![CDATA[gogin]]></category>
            <category><![CDATA[go]]></category>
            <category><![CDATA[go-framework]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Sat, 28 Feb 2026 20:59:55 GMT</pubDate>
            <atom:updated>2026-02-28T20:59:55.544Z</atom:updated>
            <content:encoded><![CDATA[<p><strong>Merhabalar</strong>, bu yazımda go öğrenirken karşılaştığım Gin adından bir framework anlatmak istiyorum. Gin, Go ile yüksek trafikli REST API’ler ve web servisleri geliştirmek üzere tasarlanmış, yüksek performans hedefiyle birleştiren bir HTTP framework’üdür. Resmî site ve dokümantasyon, Gin’in radix-tree tabanlı routing, middleware zinciri, panic recovery, binding/validation ve rendering gibi üretkenlik özelliklerini vurgular.</p><p>Performans tarafında iki “kanıt hattı” önemlidir: (1) Router seviyesinde mikro-benchmark’lar (go-http-routing-benchmark türevi), Gin’in “optimized fork” router yaklaşımını ve ns/op, allocs/op gibi metriklerde konumunu gösterir. (2) Uçtan uca (framework + HTTP yığını + JSON serileştirme) karşılaştırmalarda TechEmpower sonuçları; aynı koşulda “go (net/http)”, “gin”, “echo”, “fiber” gibi implementasyonların Requests/sec ve latency dağılımlarını verir.</p><p>Gin’in kimliği, resmî site tarafından çok net konumlanır: Go’da yazılmış bir web framework’ü; Martini benzeri API; performans odağı; routing için radix-tree yaklaşımı; middleware zinciri; panic’ten kurtarma (crash-free), JSON validation ve built‑in rendering gibi üretkenlik özellikleri.</p><p>Tek bir resmi sayfası her detayla verilmediği için burada “kanıtlanabilir” eksende kalmak gerekir: Gin, performans iddiasını özellikle httprouter ile ilişkilendirir ve “up to 40 times faster” gibi söylemleri resmî dokümanlarında tekrarlar. Bu, projenin motivasyonunun “Martini ergonomisi + daha hızlı routing/dispatch” yönünde olduğunu gösteren birincil kanıttır.</p><h3>Temel Kavramlar: Router, Context, Middleware, Handler</h3><p>Gin’i “doğru” kullanmanın yolu, soyutlamalarının sınırlarını net bilmekten geçer: Engine bir router/dispatcher’dır; handler’lar gin.HandlerFunc (tek argüman *gin.Context) şeklindedir; middleware’ler de aslında handler zincirinin elemanlarıdır; Context ise request/response etkileşiminin merkezidir ve hata/metadata taşıyan bir request-scope nesnedir.</p><h3>İstek akışı</h3><p>Aşağıdaki diyagram (Gin’in “middleware chain + handler” modelini) pratikte nasıl düşüneceğinizi özetler:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AzX8fz9s2AE2mK-i_oFgug.png" /></figure><p>Gin’in middleware zinciri “önce” ve “sonra” davranışlarını c.Next() ile kurar; örneğin loglama/metrics gibi işler çoğunlukla Next() sonrası yapılır.</p><pre>package main<br><br>import (<br> &quot;net/http&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func main() {<br> r := gin.Default()<br><br> r.GET(&quot;/ping&quot;, func(c *gin.Context) {<br>  c.JSON(http.StatusOK, gin.H{&quot;message&quot;: &quot;pong&quot;})<br> })<br><br> _ = r.Run()<br>}</pre><p>gin.Default()’ın logger+recovery ile gelmesi ve Run()’ın varsayılan port/dinleme davranışı Gin dokümantasyonunda açıkça anlatılır.</p><h3>Routing: path parametreleri, query parametreleri, group</h3><p>Gin, path parametrelerini :name veya wildcard *action biçiminde tanımlar; c.Param(&quot;name&quot;) ile okursunuz. Query parametreleri için c.Query, c.DefaultQuery gibi helper’lar vardır.</p><pre>package main<br><br>import (<br> &quot;net/http&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func main() {<br> r := gin.Default()<br> r.GET(&quot;/user/:name&quot;, func(c *gin.Context) {<br>  c.String(http.StatusOK, &quot;Hello %s&quot;, c.Param(&quot;name&quot;))<br> })<br> r.GET(&quot;/welcome&quot;, func(c *gin.Context) {<br>  first := c.DefaultQuery(&quot;firstname&quot;, &quot;Guest&quot;)<br>  last := c.Query(&quot;lastname&quot;)<br>  c.String(http.StatusOK, &quot;Hello %s %s&quot;, first, last)<br> })<br> v1 := r.Group(&quot;/v1&quot;)<br> {<br>  v1.GET(&quot;/health&quot;, func(c *gin.Context) { c.Status(http.StatusOK) })<br> }<br> _ = r.Run(&quot;:8080&quot;)<br>}</pre><p>Route grouping örneği Gin’in resmî “Grouping routes” sayfasında gösterilir (v1/v2 örnekleri).</p><h3>Middleware: global / group / route seviyesinde</h3><p>Gin’de middleware’ler router.Use(...) ile global; group.Use(...) ile grup seviyesinde; ayrıca route tanımlarken de handler listesinde kullanılabilir. Resmî “Using middleware” örneği; gin.New() ile boş router oluşturmayı, gin.Logger() ve gin.Recovery() eklemeyi ve grup bazlı auth middleware uygulamayı gösterir.</p><p>Aşağıdaki örnek; request-id üretme, header’a yazma ve “after” fazında latency ölçmeyi gösterir:</p><pre>package main<br><br>import (<br> &quot;log&quot;<br> &quot;net/http&quot;<br> &quot;time&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func RequestID() gin.HandlerFunc {<br> return func(c *gin.Context) {<br>  id := time.Now().UTC().Format(&quot;20060102T150405.000000000Z&quot;)<br>  c.Header(&quot;X-Request-ID&quot;, id)<br>  c.Set(&quot;request_id&quot;, id)<br>  c.Next()<br> }<br>}<br><br>func LatencyLog() gin.HandlerFunc {<br> return func(c *gin.Context) {<br>  start := time.Now()<br>  c.Next()<br>  log.Printf(&quot;path=%s status=%d latency=%s&quot;,<br>   c.FullPath(),<br>   c.Writer.Status(),<br>   time.Since(start),<br>  )<br> }<br>}<br><br>func main() {<br> r := gin.New()<br> r.Use(gin.Logger())<br> r.Use(gin.Recovery())<br> r.Use(RequestID())<br> r.Use(LatencyLog())<br><br> r.GET(&quot;/hello&quot;, func(c *gin.Context) {<br>  c.JSON(http.StatusOK, gin.H{&quot;hello&quot;: &quot;world&quot;})<br> })<br><br> _ = r.Run(&quot;:8080&quot;)<br>}</pre><p>gin.New() vs gin.Default() farkı ve Logger/Recovery’nin davranışı (DefaultWriter’a yazması, panic recovery) dokümantasyonda doğrudan ifade edilir.</p><h3>Performans: Mimari, Benchmark’ler ve Karşılaştırmalar</h3><p>Gin performansını değerlendirirken iki şey aynı anda doğru olabilir: (a) Gin’in routing ve middleware dispatch overhead’i “çok iyi” optimize edilmiştir; (b) uygulamanın gerçek performans maliyeti çoğu zaman DB, ağ, serileştirme, iş mantığı ve I/O’da domine olur — dolayısıyla framework seçimi çoğu sistemde “tek başına” belirleyici değildir. Gin’in kendi iddiaları ve üçüncü taraf benchmark’lar bu iki perspektifi birlikte okumayı gerektirir.</p><h3>Neden hızlı?</h3><p>Resmî site Gin’in routing tarafında radix-tree yaklaşımını, düşük bellek ayak izini, reflection kullanmamasını ve “predictable API performance” hedefini vurgular. Resmî dokümanlar ayrıca “zero allocation router” ve benchmark’larda diğer framework’lere göre hız iddiasını öne çıkarır.</p><p>Güncel go.mod, Gin’in JSON/YAML serileştirme ve performans tarafında birden fazla kütüphaneyi bağımlılık olarak tuttuğunu gösterir (ör. bytedance/sonic, goccy/go-json, json-iterator/go). Bu, performans/serileştirme hattının aktif optimize edilen bir parça olduğuna dair doğrudan bir sinyaldir.</p><h3>Router benchmark’ları (ns/op, allocs/op)</h3><p>Gin’in resmî “Benchmarks” sayfası (go-http-routing-benchmark bazlı) test ortamını/GO sürümünü ve farklı router/framework implementasyonlarının ns/op, B/op, allocs/op metriklerini listeler. Örneğin “GithubStatic” gibi bir senaryoda Gin’in sonuçları ile HttpRouter ve diğer router’lar yan yana verilir.</p><p>Bu tabloyu okurken:</p><ul><li>ns/op (daha düşük daha iyi) routing/dispatch maliyetini;</li><li>B/op ve allocs/op ise heap allocation baskısını gösterir.</li></ul><p>Gin’in bu benchmark setinde “optimized fork” yaklaşımıyla ilişkilendirildiği de aynı sayfada belirtilir.</p><h3>Uçtan uca benchmark: TechEmpower “Citrine” run’ı ile Gin, net/http, Echo, Fiber</h3><p>TechEmpower sonuçlarını “tek doğru” gibi okumak hatalıdır; fakat metodolojisi standardize olduğu için, aynı koşulda farklı implementasyonların throughput/latency profilini karşılaştırmak için güçlü bir referanstır. “TFB Status” paneli, run’ların commit ve zaman bilgilerini, ayrıca o run’a ait results.zip/results.json dosyalarını sunar.</p><p>Bu yazıda kullanılan veri; “Citrine” run ID 1d5bfc8a-5c4a-4fb2-a792-ad967f1eb138 sonuç paketinden (zip içeriği) alınmıştır. İlgili run 2026-02-11’de başlayıp 2026-02-20’de tamamlanmıştır; ayrıca sayfa “zaman dilimi America/Los_Angeles” bilgisini not eder.</p><p>Aşağıdaki tablo, <strong>aynı run</strong> içinde “15s test, 56 threads, 512 connections” satırındaki <strong>Requests/sec</strong> değerlerini özetler (plaintext ve json). Bu; “framework overhead + HTTP yığını + serileştirme” birleşik etkisini görmeye yardımcı olur.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/630/1*8092D4V0SrUclJG1TBO54Q.png" /></figure><p>Bu run’da; Gin’in “go (baseline)”a göre plaintext ve JSON’da daha yüksek throughput verdiği görülür, fakat Echo ve özellikle Fiber daha yukarıdadır.</p><p>Burada kritik nokta: <strong>Fiber</strong> kendini “Fasthttp üzerine kurulu” olarak konumlar; bu, net/http tabanlı ekosistem uyumluluğu ve middleware uyumluluğu açısından mimari bir trade‑off anlamına gelebilir (performans/uyumluluk ekseni).</p><p>Ayrıca “router seçimi”nin uçtan uca işleme oranla nispeten küçük kalabileceği, smallnest’in benchmark suite motivasyonunda açıkça tartışılır: route selection farklılıkları olsa bile, gerçek iş mantığı (sleep ile simüle edilen I/O, DB, servis çağrısı vb) devreye girdiğinde toplam maliyetin dağılımı değişir.</p><h3>Özellik ve yaklaşım karşılaştırması (Gin, net/http, Chi, Echo, Fiber)</h3><p>Aşağıdaki tablo “hangi araca hangi problem için daha iyi yaklaşılır?” sorusunu pratikleştirir. Buradaki özellik cümleleri doğrudan ilgili projelerin resmî açıklamalarından türetilmiştir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/630/1*_cFwrSM5AEkeUAUf2N4xow.png" /></figure><h3>Orta-Büyük Projelerde Yapı: Proje Dizini, Modül ve Bağımlılık Yönetimi</h3><p>Gin “proje yapısı” dikte etmez; bu iyi bir şeydir (esneklik), ama ekip ölçeği büyüdükçe tutarlı bir yapı şarttır. Go ekosistemindeki pratikler (özellikle cmd/, internal/, opsiyonel pkg/) ve temiz bağımlılık sınırları, Gin servislerini uzun vadede sürdürülebilir kılar.</p><h3>Proje dizin düzeni seçenekleri</h3><p>En yaygın referanslardan biri “Standard Go Project Layout” reposudur; internal/ dizininin Go toolchain tarafından özel muamele gördüğünü ve “private package” sınırı koyduğunu özellikle vurgular. Bununla birlikte, pkg/ gibi dizinler topluluk içinde tartışmalıdır; bazı kaynaklar pkg/ kullanımının evrensel olmadığını, proje büyüdükçe değerlendirilebileceğini söyler.</p><p>Aşağıdaki tablo, orta-büyük Gin servisleri için pratikte işe yarayan üç şablonu özetler (hangisini seçeceğiniz; repo’nun monorepo olup olmamasına, kaç binary ürettiğinize ve ekip disiplinine bağlıdır. Bu detaylar kullanıcı tarafından verilmediği için burada “varsayım” yapılmıyor).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/630/1*RAMzXhFAdClob9NwueZVlw.png" /></figure><h3>Örnek repo iskeleti (Gin + Clean-ish layering)</h3><p>Aşağıdaki ağaç, “orta ölçekli API” için iyi bir başlangıçtır:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*i0xKVmmJSRyx4chECoq24A.png" /></figure><p>Bunu “neden böyle” sorusuyla okumak önemli: cmd/ her binary için entrypoint sağlar; internal/ dışarıya API yüzeyi vermeyen servislerde (çoğu backend) paket sınırı koyar; router/middleware/handler ayrımı HTTP katmanında okunabilirlik sağlar; domain/service/repository ise test edilebilirlik ve bağımlılık yönünü düzenler.</p><p>Aynı yapıyı görsel olarak:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/365/1*ke6FKl1onRGlT7tbN4aMqw.png" /></figure><h3>Go module ve dependency yönetimi</h3><p>Go’da bağımlılık yönetimi modüllerle yapılır; go.mod dosyası module path, minimum Go sürümü ve bağımlılık sürümlerini tanımlar. Günlük pratikte iki ana komut, ekip disiplinini belirler:</p><ul><li>go mod tidy: kullanılmayan dependency’leri temizler, eksikleri ekler.</li><li>Gerekirse vendoring: go mod vendor + -mod=vendor yaklaşımı (özellikle “offline build” veya supply-chain politikaları için).</li></ul><p>Gin’in kendi go.mod’u, minimum Go sürümü ve toolchain bilgisini barındırır (go 1.24.0 + toolchain go1.24.7), ayrıca validator/JSON kütüphaneleri gibi kritik bağımlılıkları listeler. Bu; <strong>servisinizin</strong> de hangi Go sürümünde build edileceğini CI/CD hattında netleştirmeyi gerektirir (detay: kullanıcı tarafında CI/CD platformu belirtilmedi).</p><h3>Test Stratejileri: Unit, Integration, End-to-End</h3><p>Gin servislerinde test yaklaşımı üç katmanda düşünülür: handler/middleware unit test’leri, gerçek bağımlılıklarla integration test’leri ve “sistem gibi” çalışan E2E test’leri. Gin dokümanı, HTTP testleri için stdlib net/http/httptest paketini “preferable” olarak önerir ve örnek verir.</p><h3>Unit test: router + handler doğrulama</h3><p>Aşağıdaki örnek, httptest.NewRecorder() ile response’u yakalar; http.NewRequest ile istek üretir; ve router’ın ServeHTTP’si üzerinden handler’ı test eder.</p><pre>package handler_test<br><br>import (<br> &quot;net/http&quot;<br> &quot;net/http/httptest&quot;<br> &quot;testing&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func setupRouter() *gin.Engine {<br> r := gin.New()<br> r.GET(&quot;/ping&quot;, func(c *gin.Context) {<br>  c.String(http.StatusOK, &quot;pong&quot;)<br> })<br> return r<br>}<br><br>func TestPing(t *testing.T) {<br> r := setupRouter()<br><br> w := httptest.NewRecorder()<br> req := httptest.NewRequest(http.MethodGet, &quot;/ping&quot;, nil)<br><br> r.ServeHTTP(w, req)<br><br> if w.Code != http.StatusOK {<br>  t.Fatalf(&quot;expected %d got %d&quot;, http.StatusOK, w.Code)<br> }<br> if w.Body.String() != &quot;pong&quot; {<br>  t.Fatalf(&quot;expected body pong got %q&quot;, w.Body.String())<br> }<br>}</pre><p>Bu yaklaşım Gin’in “Testing” sayfasındaki öneriyle birebir uyumludur; httptest paketinin amacı da HTTP test yardımcıları sağlamaktır.</p><h3>Middleware unit test: context ve zincir davranışı</h3><p>Middleware’ler için iki yaygın teknik vardır:</p><ol><li>Router üzerinden “gerçek” isteği geçirerek test etmek (en basit).</li><li>Daha ince taneli testte Gin’in test context helper’larını kullanmak (örn. CreateTestContext).</li></ol><p>Bu yazıda örnekleri “router üzerinden” tuttuğumuz için, özel CreateTestContext akışına girmiyoruz; fakat middleware’i route’a takıp response header/body üzerinde assert etmek yeterli olur.</p><h3>Integration test: gerçek bağımlılıklar</h3><p>Integration test’te amaç; JSON binding/validation, error mapping, DB repository davranışı, auth middleware ve request flow’un birlikte çalıştığını doğrulamaktır. Gin FAQ, DB bağlantısını handler’lara parametreyle geçirmek veya middleware üzerinden context’e koymak gibi dependency injection yaklaşımını örnekler.</p><p>Örnek yaklaşım (psödokod seviyesinde):</p><ul><li>Test sırasında “in-memory” repo (fake) kullan: hızlı unit+integration arası.</li><li>Ya da Docker Compose ile Postgres/Redis ayağa kaldır: daha gerçekçi integration. (Kullanıcının hangi DB/Cache kullandığı belirtilmediği için burada spesifik bir altyapı seçimi varsayılmıyor.)</li></ul><h3>E2E test: sözleşme ve gerçeğe yakın trafik</h3><p>E2E’de “deployment benzeri” ortamda (container/cluster) aşağıdakiler doğrulanır:</p><ul><li>Readiness endpoint’i hazır olmadan trafikte olmamalı (Kubernetes readinessProbe mantığı).</li><li>Graceful shutdown: SIGTERM sonrası aktif isteklerin düzgün bitmesi (Go http.Server.Shutdown yaklaşımı).</li><li>Rate limit, auth, security headers gibi cross-cutting concern’lerin uçtan uca devrede olması.</li></ul><h3>Hata Yönetimi, Loglama ve Gözlemlenebilirlik</h3><p>Gin, request süresince oluşan hataları Context üzerinde toplayabilen bir model sunar; resmî site bu “error management” yaklaşımını vurgular ve bunu middleware’le loglama/DB/network’e aktarılabilir bir yapı olarak tanımlar.</p><h3>Merkezi hata modeli: tek formatta JSON error</h3><p>Gin’in “Error handling middleware” örneği şu fikri önerir: handler’larda c.Error(err) diyerek context’e hata ekle; middleware request tamamlandıktan sonra (c.Next() sonrası) c.Errors’u kontrol et ve standart bir JSON error üret.</p><p>Aşağıdaki örnek, üretimde sık kullanılan “typed error + status code mapping” yaklaşımını gösterir:</p><pre>package middleware<br><br>import (<br> &quot;errors&quot;<br> &quot;net/http&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>type AppError struct {<br> Code    string<br> Message string<br> Status  int<br> Err     error<br>}<br><br>func (e *AppError) Error() string {<br> if e.Err != nil {<br>  return e.Message + &quot;: &quot; + e.Err.Error()<br> }<br> return e.Message<br>}<br><br>func ErrorHandler() gin.HandlerFunc {<br> return func(c *gin.Context) {<br>  c.Next()<br><br>  if len(c.Errors) == 0 {<br>   return<br>  }<br><br>  err := c.Errors.Last().Err<br>  var appErr *AppError<br>  if errors.As(err, &amp;appErr) {<br>   c.JSON(appErr.Status, gin.H{<br>    &quot;error&quot;: gin.H{<br>     &quot;code&quot;:    appErr.Code,<br>     &quot;message&quot;: appErr.Message,<br>    },<br>   })<br>   return<br>  }<br><br>  c.JSON(http.StatusInternalServerError, gin.H{<br>   &quot;error&quot;: gin.H{&quot;code&quot;: &quot;internal&quot;, &quot;message&quot;: &quot;unexpected error&quot;},<br>  })<br> }<br>}</pre><p>Bu model, Gin dokümantasyonundaki “middleware request sonrası c.Errors kontrolü” fikrini genişletir.</p><h3>Loglama: varsayılan logger, özel format ve output yönetimi</h3><p>Gin’in “Using middleware” örneği, gin.Logger() middleware’inin gin.DefaultWriter’a log yazdığını ve release mode’da bile log yazmayı sürdürdüğünü belirtir; ayrıca default writer’ın os.Stdout olduğunu söyler.</p><p>Özel log formatı için resmî örnek LoggerWithFormatter kullanımını gösterir:</p><pre>package main<br><br>import (<br> &quot;fmt&quot;<br> &quot;net/http&quot;<br> &quot;time&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func main() {<br> r := gin.New()<br><br> r.Use(gin.LoggerWithFormatter(func(p gin.LogFormatterParams) string {<br>  return fmt.Sprintf(<br>   `time=%s ip=%s method=%s path=%s status=%d latency=%s ua=%q err=%q%s`,<br>   p.TimeStamp.Format(time.RFC3339Nano),<br>   p.ClientIP,<br>   p.Method,<br>   p.Path,<br>   p.StatusCode,<br>   p.Latency,<br>   p.Request.UserAgent(),<br>   p.ErrorMessage,<br>   &quot;\n&quot;,<br>  )<br> }))<br> r.Use(gin.Recovery())<br><br> r.GET(&quot;/ping&quot;, func(c *gin.Context) { c.String(http.StatusOK, &quot;pong&quot;) })<br> _ = r.Run(&quot;:8080&quot;)<br>}</pre><p>Bu middleware API’si ve örnek format, Gin dokümantasyonunda birebir yer alır.</p><p>Gözlemlenebilirlik (metrics/tracing) tarafında Gin, “middleware ecosystem” yaklaşımını vurgular; gin-contrib gibi resmi middleware koleksiyonlarına yönlendirir. (Hangi tracing/metrics stack’inin kullanılacağı kullanıcı tarafından belirtilmediği için burada spesifik vendor seçimi yapılmıyor.)</p><h3>Güvenlik, Dağıtım ve Ölçekleme</h3><p>Gin’in “security posture”u, iki katmanda ele alınmalı: (1) Framework’ün kendi ayarları (trusted proxies, binding davranışı, default listen), (2) Genel web güvenliği prensipleri (input validation, security headers, authz/authn, rate limiting, vb).</p><h3>Input validation ve binding/validation</h3><p>OWASP, input validation’ın “mümkün olduğunca erken” yapılmasını ve güvenilmeyen tüm kaynaklardan gelen verinin doğrulanmasını önerir. Gin de “binding + validation” hattında go-playground/validator/v10 kullandığını ve binding:&quot;required&quot; gibi tag’lerle doğrulama yapılabildiğini belirtir.</p><p>Önerilen pratik: Handler’larda ShouldBind* kullanın; hatayı kontrol edip standardize error dönün (böylece response formatı sizin kontrolünüzde olur). Resmî doküman, Bind* metodlarının binding hatasında AbortWithError(400, ...) ile request’i kesip “Headers were already written...” gibi uyarılara neden olabilecek bir akış oluşturabileceğini açıkça anlatır.</p><pre>type CreateUserRequest struct {<br> Email string `json:&quot;email&quot; binding:&quot;required,email&quot;`<br> Name  string `json:&quot;name&quot;  binding:&quot;required,min=2,max=80&quot;`<br>}<br><br>func CreateUser(c *gin.Context) {<br> var req CreateUserRequest<br> if err := c.ShouldBindJSON(&amp;req); err != nil {<br>  c.JSON(400, gin.H{&quot;error&quot;: gin.H{&quot;code&quot;: &quot;bad_request&quot;, &quot;message&quot;: err.Error()}})<br>  return<br> }<br> c.Status(201)<br>}</pre><h3>Proxy / Client IP güvenliği: Trusted proxies</h3><p>Gin’in deployment dokümantasyonu kritik bir güvenlik noktası söyler: <strong>trusted proxy ayarlamazsanız Gin varsayılan olarak tüm proxy’lere güvenir; bu güvenli değildir</strong>. Bu durumda X-Forwarded-For gibi header’ların spoof edilmesi client IP tespiti gibi güvenlik kontrollerini etkileyebilir. Çözüm: SetTrustedProxies(...) ile güvenilir CIDR/IP listesi verin veya proxy yoksa nil ile devre dışı bırakın.</p><h3>Security headers</h3><p>OWASP “HTTP Security Response Headers Cheat Sheet”, güvenlik header’larının XSS, clickjacking vb riskleri azaltabileceğini ve yapılandırma önerilerini listeler. OWASP “REST Security Cheat Sheet” de API response’larında security headers kullanımını ele alır (özellikle API’nin HTML döndürüp döndürmemesine göre faydanın değişebileceğini not ederek).</p><p>Gin tarafında bunu bir middleware ile merkezi uygulamak pratiktir:</p><pre>func SecurityHeaders() gin.HandlerFunc {<br> return func(c *gin.Context) {<br>  c.Header(&quot;X-Content-Type-Options&quot;, &quot;nosniff&quot;)<br>  c.Header(&quot;X-Frame-Options&quot;, &quot;DENY&quot;)<br>  c.Header(&quot;Referrer-Policy&quot;, &quot;no-referrer&quot;)<br>  c.Header(&quot;Permissions-Policy&quot;, &quot;geolocation=(), microphone=()&quot;)<br>  c.Next()<br> }<br>}</pre><p>Bu header’ların “ne işe yaradığı ve nasıl konfigüre edileceği” OWASP cheat sheet’lerinde detaylandırılır.</p><h3>Docker ile dağıtım: multi-stage build</h3><p>Docker dokümantasyonu, multi-stage build yaklaşımını “builder stage + minimal runtime stage” olarak anlatır; Go gibi derlenen dillerde builder stage’de binary üretip final stage’e yalnızca çıktıyı kopyalayarak küçük/sade image elde etmeyi önerir.</p><p>Örnek Dockerfile (minimal ve yorumlu):</p><pre># syntax=docker/dockerfile:1<br><br># 1) Build stage<br>FROM golang:1.24-alpine AS builder<br>WORKDIR /src<br><br># Mod cache için önce go.mod/go.sum kopyalayın (layer cache)<br>COPY go.mod go.sum ./<br>RUN go mod download<br><br># Kaynak kod<br>COPY . .<br><br># Statik binary (örnek)<br>ENV CGO_ENABLED=0<br>RUN go build -trimpath -ldflags=&quot;-s -w&quot; -o /out/api ./cmd/api<br><br># 2) Runtime stage (scratch ya da alpine)<br>FROM scratch<br># TLS sertifikaları gerekiyorsa scratch yerine distroless/alpine tercih edilebilir (ihtiyaç belirtilmedi).<br>COPY --from=builder /out/api /api<br><br>EXPOSE 8080<br>ENTRYPOINT [&quot;/api&quot;]</pre><p>Multi-stage mantığı ve “scratch base image” yaklaşımı Docker dokümanlarında anlatılır.</p><p>Ayrıca Docker’ın Go özel rehberleri, Go uygulamasını containerize ederken multi-stage Dockerfile örnekleri ve best practice önerileri sunar.</p><h3>Kubernetes ile ölçekleme: probes ve graceful termination</h3><p>Kubernetes dokümantasyonu, livenessProbe, readinessProbe ve startupProbe kavramlarını ve başarısızlık durumunda kubelet’in davranışını açıklar. Readiness probe başarısızsa Pod’un Service endpoint’lerinden çıkarılması (trafik kesme) gibi davranışlar çekirdek ölçekleme mantığının parçasıdır.</p><p>Tipik bir deployment parçası (özet):</p><pre>apiVersion: apps/v1<br>kind: Deployment<br>metadata:<br>  name: my-gin-api<br>spec:<br>  replicas: 3<br>  selector:<br>    matchLabels:<br>      app: my-gin-api<br>  template:<br>    metadata:<br>      labels:<br>        app: my-gin-api<br>    spec:<br>      terminationGracePeriodSeconds: 30<br>      containers:<br>        - name: api<br>          image: my-gin-api:latest<br>          ports:<br>            - containerPort: 8080<br>          readinessProbe:<br>            httpGet:<br>              path: /v1/health<br>              port: 8080<br>            initialDelaySeconds: 2<br>            periodSeconds: 5<br>          livenessProbe:<br>            httpGet:<br>              path: /v1/health<br>              port: 8080<br>            initialDelaySeconds: 5<br>            periodSeconds: 10</pre><p>Probe türleri ve readiness davranışı Pod lifecycle dokümantasyonunda verilir; terminationGracePeriodSeconds alanı da Kubernetes API referansında tanımlıdır.</p><p>Graceful shutdown tarafında Gin’in kendi örneği, Go 1.8+ için http.Server’ın Shutdown() metodunu kullanmayı önerir. Bu yaklaşımın “yeni bağlantı kabul etmeyi durdurup aktif istekleri bitirmeyi bekleme” davranışı çeşitli Go topluluk yazılarında da açıklanır.</p><p>Gin’in “Graceful restart or stop” sayfası, Go 1.8+ için http.Server.Shutdown() ile graceful shutdown yapılabileceğini ve örnek kod verdiğini söyler.</p><p>Aşağıdaki “modern” iskelet, Gin router’ını http.Server içine koyar ve SIGTERM/SIGINT’te shutdown eder:</p><pre>package main<br><br>import (<br> &quot;context&quot;<br> &quot;errors&quot;<br> &quot;log&quot;<br> &quot;net/http&quot;<br> &quot;os&quot;<br> &quot;os/signal&quot;<br> &quot;syscall&quot;<br> &quot;time&quot;<br><br> &quot;github.com/gin-gonic/gin&quot;<br>)<br><br>func main() {<br> r := gin.New()<br> r.Use(gin.Recovery())<br> r.GET(&quot;/v1/health&quot;, func(c *gin.Context) { c.Status(200) })<br><br> srv := &amp;http.Server{<br>  Addr:              &quot;:8080&quot;,<br>  Handler:           r,<br>  ReadHeaderTimeout: 5 * time.Second,<br> }<br><br> go func() {<br>  log.Println(&quot;listening on :8080&quot;)<br>  if err := srv.ListenAndServe(); err != nil &amp;&amp; !errors.Is(err, http.ErrServerClosed) {<br>   log.Fatalf(&quot;listen: %v&quot;, err)<br>  }<br> }()<br><br> stop := make(chan os.Signal, 1)<br> signal.Notify(stop, syscall.SIGINT, syscall.SIGTERM)<br> &lt;-stop<br><br> ctx, cancel := context.WithTimeout(context.Background(), 20*time.Second)<br> defer cancel()<br><br> if err := srv.Shutdown(ctx); err != nil {<br>  log.Printf(&quot;shutdown error: %v&quot;, err)<br> }<br> log.Println(&quot;shutdown complete&quot;)<br>}</pre><p>Sonuç olarak Gin; performans, sadelik ve production-grade özellikleri dengeli şekilde sunan olgun bir Go framework’üdür. Ancak gerçek güç, sadece framework seçiminde değil; doğru proje yapısı, middleware disiplini, domain ayrımı ve operasyonel bilinçle birlikte gelir. İyi tasarlanmış bir mimari, framework’ten daha uzun ömürlüdür. Araçlar değişir, ama temiz kod, net sorumluluk ayrımı ve sade tasarım prensipleri kalıcıdır. Buraya kadar okuduğunuz için çok teşekkür ederim. İyi ve sağlıklı günler</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b10f2fb2b4a4" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[NestJS v12.0.0 İnceleme]]></title>
            <link>https://medium.com/@oguzhancart1/nestjs-v12-0-0-i%CC%87nceleme-23bd4c6d7671?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/23bd4c6d7671</guid>
            <category><![CDATA[new-version]]></category>
            <category><![CDATA[nextjs-12]]></category>
            <category><![CDATA[nestjs-new-version]]></category>
            <category><![CDATA[nestjs]]></category>
            <category><![CDATA[nestjs-12]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Mon, 23 Feb 2026 14:37:16 GMT</pubDate>
            <atom:updated>2026-02-23T14:37:16.897Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, bu yazımda github üzerindeki PR #16391’de toplanan değişiklikleri ve yayınlanacak olan v12.0.0 geliştirmelerini, “migrasyon yapacak backend engineer” perspektifiyle analiz eder. PR metninde v12 için hedeflenen zaman penceresi “2026 Q3 başı” olarak belirtiliyor; PR mevcut durumda “draft” ve master’a merge edilmemiş durumda, dolayısıyla burada anlattıklarım “preview” niteliğinde ve sürümde revize olabilir. V12’de özetle şöyle görünüyor:</p><ul><li>Paketlerin CommonJS’ten ESM’e taşınması (repo içindeki core/common vb. paketlerin “type: module” olacak şekilde migrate edilmiş olması) ve bunun, Node’un require(esm) kabiliyeti sayesinde çoğu CJS proje için “büyük kırılma” yaratmaması hedefi.</li><li>Test altyapısında Vitest + SWC odaklı yeni default (özellikle ESM projeler için) yaklaşım.</li><li>“Standard Schema” uyumlu şema objesi üzerinden route decorator’larda schema opsiyonunun gelmesi ve buna bağlı StandardSchemaValidationPipe / StandardSchemaSerializerInterceptor gibi yeni yapı taşları.</li></ul><p>Bu eksenlerin etrafında, halkaya eklenen bazı dikkat çekici değişiklikler de var: ValidationPipe’a hata formatı seçeneği (errorFormat), lifecycle hook yürütme sırasının “hiyerarşi seviyelerine göre” deterministik hâle getirilmesi, Express adapter’da “shutdown sırasında yeni request’lere 503 döndürme” seçeneği ve WebSocket gateway handleDisconnect imzasına opsiyonel “reason” parametresi.</p><h3>V12’nin yönü: ESM, test altyapısı ve şema tabanlı validasyon</h3><h4>ESM migrasyonu ve require(esm) gerçeği</h4><p>PR #16391, v12 ile “tüm NestJS paketlerinin CJS → ESM geçişini” hedeflediğini söylüyor; bu repodaki paketlerin de migrate edildiğini belirtiyor. <br>Bunu destekleyen somut sinyaller v12 branch’inde net: @nestjs/core ve @nestjs/common paket manifestlerinde &quot;type&quot;: &quot;module&quot; ve Node engine olarak &gt;= 20 görülüyor.</p><p>Buradaki kritik nokta şu: ESM’e geçiş “tüketici projeler CJS ise tamamen biter” anlamına gelmiyor; çünkü modern Node.js artık require() ile senkron ESM load edebiliyor (top‑level await içermeyen, “fully synchronous” ESM graph koşuluyla). Node dokümanı, bu kabiliyetin v20.17.0 / v22.0.0 ile geldiğini ve zamanla “experimental” olmaktan çıktığını açıkça listeliyor.</p><p>Bu yüzden v12’nin “CJS projelerde büyük kırılma olmayabilir” iddiası teknik olarak mantıklı: CJS uygulamanın Nest paketlerini require() ile çekebilmesi teorik olarak mümkün. <br>Ama pratikte iki risk sınıfı var:</p><ul><li>ERR_REQUIRE_ASYNC_MODULE<strong> / top-level await riski:</strong> Node, require(esm) için top‑level await içeren modüllerde hata fırlatır.</li><li><strong>Dual-package hazard (ESM/CJS karışımı):</strong> v12 branch’inin kendi Vitest integration config’i bile bazı integration test’leri, third‑party Nest paketleri ESM’i destekleyene kadar “CJS require() workspace paketlerine giriyor → class instance’ları ayrışıyor” gerekçesiyle exclude ediyor. Bu, real-world monorepo’larda da yaşayabileceğiniz “aynı sınıfın iki farklı kopyası” gibi çok zor debug edilen hatalara işaret eder.</li></ul><h4>Test altyapısı: Jest → Vitest (+ SWC)</h4><p>PR #16391, new ESM projelerde default test runner olarak Vitest’e geçileceğini; CJS şemasında Jest’in devam edeceğini söylüyor. <br>Repo tarafında bu geçişin teknik dayanakları da görünüyor:</p><ul><li>Vitest config’te decorator desteği için unplugin-swc kullanımı ve decoratorMetadata / legacyDecorator gibi ayarlar açık.</li><li>Coverage için ayrı bir Vitest config var; bu dosya özellikle “SWC plugin esbuild’i devre dışı bırakıyor, coverage provider’ları kırıyor” trade-off’unu açıklıyor ve coverage toplarken esbuild’e düşmeyi öneriyor (test doğruluğu pahasına sadece coverage sayısı toplamak gibi).</li><li>PR #16370 açıklaması da test stack’te chai/mocha/sinon’un bırakılıp Vitest’e geçildiğini ve decorator desteği için SWC kullanıldığını belirtiyor.</li></ul><h4>Şema tabanlı validasyon: Standard Schema</h4><p>PR #16391, route decorator’larda (@Body, @Query vb.) yeni schema opsiyonunun “Standard Schema uyumlu” bir obje alacağını ve bunun modern validasyon kütüphanelerine kapı açacağını söylüyor. <br>Standard Schema’nın kendisi, TypeScript ekosisteminde “tek bir arayüz üzerinden validasyon/transform” gibi kabiliyetleri standardize etmeyi amaçlayan bir spec ailesi olarak tanımlanıyor.</p><p>Bu release paketinde bunun somut karşılığı üç noktada belirgin:</p><ul><li>Route param decorator’larına ParameterDecoratorOptions altında schema?: StandardSchemaV1 ve pipes?: (…)[] eklenmesi.</li><li>Pipe metadata’sına schema taşınması (ArgumentMetadata.schema).</li><li>Yeni StandardSchemaValidationPipe ve StandardSchemaSerializerInterceptor sınıfları.</li></ul><p>PR #16391 + v12 branch snapshot baz alarak hazırladım; PR #16391 “diğer paketlerde birkaç minör breaking change var” diyor ama tüm kırıcı değişiklikleri tek tek listelemiyor. Dolayısıyla bu tablo, <strong>kanıtını gördüğümüz</strong> değişiklikleri ve “muhtemel etkileri” içerir; final release notes çıktığında yeniden doğrulanmalı.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p2VXQlYhatl4QJHSGUuhhQ.png" /><figcaption>Breaking ve non-breaking değişiklikler tablosu</figcaption></figure><h3>Runtime ve toolchain gereksinimleri tablosu</h3><p>Bu repo snapshot’ı, v12 hattında Node minimumunu &gt;= 20 olarak gösteriyor. <br>Buna ek olarak, CJS projeler için ESM’i require() ile yükleme kabiliyeti Node dokümanında “v20.17.0 / v22.0.0” seviyesinde konumlanıyor. Bu yüzden “sorunsuz CJS tüketimi” hedefliyorsanız <strong>Node 20 kullanmak yetmeyebilir; 20.17+</strong> gibi alt sürüm detayı önem kazanır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3L8LPhXkLa83hStu4UzeRg.png" /><figcaption>Runtime ve toolchain gereksinimleri tablosu</figcaption></figure><h3>Migrasyon kontrol listesi</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xpxFaNosJoSP2OR9oIw78w.png" /></figure><h3>Kod odaklı geçiş örnekleri</h3><p>Bu bölümde örnekler “önce/sonra” şeklinde — fakat bazı noktalar (özellikle “hangi validasyon kütüphanesi Standard Schema’yı native destekliyor?” konusu) uygulama tercihlerinize bağlı. Standard Schema’nın hedefi tek arayüzle interoperabilite; fakat her kütüphanenin bunu doğrudan sağlayıp sağlamadığı “kütüphane sürümü”ne göre değişebilir. Spec tanımı ve amaç için Standard Schema resmi açıklamasına bakın.</p><h3>Controller parametrelerinde schema opsiyonu ve StandardSchemaValidationPipe</h3><p>V12 branch’inde @Body, @Query, @Param gibi decorator’lar; schema ve pipes içeren bir options objesi kabul edebiliyor. Bu, decorator metadata’sına schema’yı ekleyip pipe’lara taşımak için tasarlanmış.</p><p>schema<strong>’yı parametreye bağlamak (opsiyon objesi ile)</strong></p><pre>@Post(&#39;users&#39;)<br>createUser(<br>  @Body({ schema: CreateUserSchema })<br>  body: unknown,<br>) {<br>  return this.usersService.create(body);<br>}</pre><p>Bu noktada validasyonun “gerçekten çalışması” için bir pipe’ın metadata.schema’yı okuyup validate etmesi gerekir. İşte v12’nin getirdiği StandardSchemaValidationPipe tam bu şablonu hedefliyor: metadata.schema yoksa value’yu dokunmadan geçiriyor; varsa schema[&#39;~standard&#39;].validate() çağırıyor.</p><p><strong>Global pipe olarak bağlamak (pratik yaklaşım)</strong></p><pre>import { NestFactory } from &#39;@nestjs/core&#39;;<br>import { StandardSchemaValidationPipe } from &#39;@nestjs/common&#39;;<br><br>async function bootstrap() {<br>  const app = await NestFactory.create(AppModule);<br><br>  app.useGlobalPipes(<br>    new StandardSchemaValidationPipe({<br>      transform: true,<br>      validateCustomDecorators: false,<br>    }),<br>  );<br><br>  await app.listen(3000);<br>}<br>bootstrap();</pre><p>Bu pipe’ın options’ları, “validate sonucu dönen value ile input’u replace etme” (transform) ve custom decorator parametrelerini de validate edip etmeme (validateCustomDecorators) gibi davranışları kontrol ediyor.</p><p><strong>Minimal Standard Schema örneği (kütüphane bağımsız)</strong><br>Aşağıdaki, “vendor/test” benzeri, kendinizin yazdığı bir Standard Schema objesine örnek (repo e2e testinde de bu yaklaşım kullanılıyor).</p><pre>import type { StandardSchemaV1 } from &#39;@standard-schema/spec&#39;;<br><br>export const CreateUserSchema: StandardSchemaV1 = {<br>  &#39;~standard&#39;: {<br>    version: 1,<br>    vendor: &#39;example&#39;,<br>    validate(value: unknown) {<br>      if (!value || typeof value !== &#39;object&#39;) {<br>        return { issues: [{ message: &#39;Body must be an object&#39; }] };<br>      }<br>      const v = value as Record&lt;string, unknown&gt;;<br>      if (typeof v.email !== &#39;string&#39;) {<br>        return { issues: [{ message: &#39;email must be a string&#39; }] };<br>      }<br>      return { value: { email: v.email } };<br>    },<br>  },<br>};</pre><blockquote><em>Bu örnek “hand-rolled schema”dır. PR metni Zod/Valibot/ArkType gibi kütüphanelerden bahsediyor; fakat “hangi sürümde native Standard Schema implementasyonu var?” detayı bu PR’ın kendisinde net değil — kendi kullandığınız kütüphanenin Standard Schema uyumluluğunu ayrıca doğrulayın.</em></blockquote><h3>Serializer tarafı: StandardSchemaSerializerInterceptor + SerializeOptions</h3><p>Repo, response serialization için de Standard Schema yolunu açıyor: StandardSchemaSerializerInterceptor response’u şemaya göre validate/transform ediyor; ayrıca handler/class bazında @SerializeOptions({ schema }) ile override yapılabiliyor.</p><pre>import {<br>  Controller,<br>  Get,<br>  UseInterceptors,<br>} from &#39;@nestjs/common&#39;;<br>import {<br>  SerializeOptions,<br>  StandardSchemaSerializerInterceptor,<br>} from &#39;@nestjs/common&#39;;<br><br>@Controller(&#39;users&#39;)<br>@UseInterceptors(StandardSchemaSerializerInterceptor)<br>@SerializeOptions({ schema: UserResponseSchema })<br>export class UsersController {<br>  @Get(&#39;:id&#39;)<br>  async findOne() {<br>    return { id: &#39;u1&#39;, email: &#39;a@b.com&#39; };<br>  }<br>}</pre><p>Interceptor, schema yoksa objeyi bypass eder; schema varsa ~standard.validate() sonucu issues dönerse error fırlatır ve value’yu transform eder.</p><h3>ValidationPipe errorFormat ve exception filter etkisi</h3><p>ValidationPipe’a iki format geliyor: varsayılan &#39;list&#39; (string mesaj listesi) ve &#39;grouped&#39; (property path → mesaj array map). Kod içi açıklama, &#39;grouped&#39; seçildiğinde hata response’unun message alanının string[] yerine Record olacağını ve bunu varsayan filter/interceptor’ların güncellenmesi gerektiğini özellikle vurguluyor.</p><p><strong>Önce: </strong>message<strong> her zaman string[] varsayan filter</strong></p><pre>const res = exception.getResponse() as any;<br>return { errors: res.message.join(&#39;, &#39;) };</pre><p><strong>Sonra: hem list hem grouped destekleyen (safe) yaklaşım</strong></p><pre>const res = exception.getResponse() as any;<br>const msg = res?.message;<br><br>if (Array.isArray(msg)) {<br>  return { errors: msg };<br>}<br><br>if (msg &amp;&amp; typeof msg === &#39;object&#39;) {<br>  return { errors: msg };<br>}<br><br>return { errors: [String(msg ?? &#39;Unknown validation error&#39;)] };</pre><p>Bu değişiklik opt-in olsa da, ekip bazında “API error shape contract”’ınız varsa errorFormat seçimi bir breaking contract kararına dönüşebilir.</p><h3>Custom pipe’larda unknown ve metadata genişlemesi</h3><p>PR #16147, pipe transform metodlarının input type’ını any yerine unknown yaparak “explicit type checking” zorunluluğu getirdiğini söylüyor. <br>Bunu üreten kodda da görüyoruz: ValidationPipe’ın transform(value: unknown, metadata: ArgumentMetadata) imzası artık unknown. <br>Ayrıca metadata’ya schema?: StandardSchemaV1 alanı eklendi.</p><p><strong>Önce (tip güvenliği düşük)</strong></p><pre>@Injectable()<br>export class TrimPipe implements PipeTransform {<br>  transform(value: any) {<br>    return typeof value === &#39;string&#39; ? value.trim() : value;<br>  }<br>}</pre><p><strong>Sonra (unknown + narrowing + metadata’dan yararlanma)</strong></p><pre>@Injectable()<br>export class TrimPipe implements PipeTransform {<br>  transform(value: unknown, metadata: ArgumentMetadata) {<br>    if (metadata.type === &#39;body&#39; &amp;&amp; typeof value === &#39;string&#39;) {<br>      return value.trim();<br>    }<br>    return value;<br>  }<br>}</pre><blockquote><em>PR #15413, </em><em>ArgumentMetadata&lt;MyClass&gt; şeklinde opsiyonel generic ile </em><em>metadata.metatype üzerinde type safety hedeflediğini anlatıyor; ancak final public typing imzası “v12 final”de nasıl görünecek kesinleşmiş değil. Bu yüzden migration sırasında compile hatalarını “çıktığı hâliyle” düzeltip, final typings’e göre son rötuşu yapmak daha gerçekçi.</em></blockquote><h3>Lifecycle hook sırası: hiyerarşi seviyelerine göre deterministik çağrı</h3><p>V12 branch’inde module init/bootstrap ve destroy/shutdown hook çağrıları “instances grouped by hierarchy level” yaklaşımıyla yapılıyor:</p><ul><li>onModuleInit/onApplicationBootstrap: seviye artan yönde (ASC) dolaşıp hook’ları çalıştırıyor.</li><li>onModuleDestroy/onApplicationShutdown: seviye azalan yönde (DESC) çalıştırıyor.</li></ul><p>Bu, aynı module içindeki provider dependency’lerinin init sırasına daha iyi yansıması (ve shutdown sırasında ters sırayla kapatma) gibi okunabilir. Kodun “hiyerarşi seviyesine göre gruplayıp sırayla await etmesi” bu davranışı açık ediyor.</p><p>Mermaid ile “eski vs yeni” akış farkını şematik göstermek için:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/329/1*5OBuhdoxQMD1YRCOuH3Amw.png" /></figure><p>Bu değişiklik “compile-time” kırılma değil; ama “hook sırası”na yanlışlıkla bağımlı olan uygulamalarda davranış değişikliği yaratabilir.</p><h3>Express shutdown davranışı: return503OnClosing</h3><p>V12 branch’inde NestApplicationOptions içine return503OnClosing?: boolean geliyor. Açıklaması: shutdown sürecinde yeni request’lere 503 döndürürken, in-flight request’lerin tamamlanmasına izin vermek. <br>PR #16156, bu davranışın Express adapter’da implement edildiğini; app.close() çağrısında shutdown flag set edilip yeni request’lere 503 + Connection: close header döndürüldüğünü anlatıyor.</p><pre>const app = await NestFactory.create(AppModule, {<br>  return503OnClosing: true,<br>});</pre><p>Bu ayar opt-in olduğu için “default davranışı kırmaz”; ama production shutdown semantiğinizi bilinçli şekilde iyileştirmek için değerlidir (özellikle load balancer draining senaryolarında).</p><h3>Exception handling: HttpException’e errorCode</h3><p>HttpExceptionOptions içine errorCode?: string eklenmiş görünüyor; ayrıca HttpException.createBody(...) tarafında error response’a errorCode ekleme desteği var.</p><pre>throw new HttpException(<br>  &#39;Payment refused&#39;,<br>  402,<br>  { errorCode: &#39;PAYMENT_REFUSED&#39;, cause: err },<br>);</pre><p>Bu, API error contract’ınızı “message”dan bağımsız, makine-okur bir code ile standardize etmek için kullanılabilir.</p><h3>WebSocket: handleDisconnect reason parametresi</h3><p>Gateway disconnect hook interface’i, ikinci parametre olarak opsiyonel reason?: string alacak şekilde güncellenmiş: handleDisconnect(client, reason?).</p><p>Önce</p><pre>handleDisconnect(client: Socket) {<br>  // ...<br>}</pre><p>Sonrası</p><pre>handleDisconnect(client: Socket, reason?: string) {<br>  // reason varsa log/metric için kullan<br>}</pre><h3>Microservices: NATS v3 ve @nats-io/transport-node</h3><p>PR #15190 “nats v3 upgrade” olarak işaretlenmiş ve breaking change olabileceğini belirtiyor. <br>V12 branch kodu ise NATS client/server tarafında @nats-io/transport-node paketini load ediyor.</p><p>Bu, NATS kullanan uygulamalar için pratikte şu anlama gelir:</p><ul><li>Dependency seviyesinde nats yerine @nats-io/transport-node eklemeniz gerekebilir (özellikle type safety veya runtime davranışları açısından).</li><li>Uygulama config’i tarafında Nest’in NatsOptions arayüzü halen oldukça geniş ve extansible; ama underlying client library değiştiği için “edge-case” davranışları test etmeniz gerekir.</li></ul><h3>Testler, CI kontrolleri ve upgrade stratejisi</h3><h4>Jest’ten Vitest’e minimal geçiş örneği</h4><p>PR #16391 v12 için ESM projelerde Vitest’e yönelimi söylüyor; repo config’i de SWC ile decorator metadata ihtiyacını karşılayacak şekilde ayarlanmış.</p><p><strong>Jest testi (tipik)</strong></p><pre>describe(&#39;UsersController (Jest)&#39;, () =&gt; {<br>  it(&#39;returns user&#39;, async () =&gt; {<br>    expect(result).toEqual({ id: &#39;u1&#39; });<br>  });<br>});</pre><p><strong>Vitest testi (yakın semantik)</strong></p><pre>import { describe, it, expect } from &#39;vitest&#39;;<br><br>describe(&#39;UsersController (Vitest)&#39;, () =&gt; {<br>  it(&#39;returns user&#39;, async () =&gt; {<br>    expect(result).toEqual({ id: &#39;u1&#39; });<br>  });<br>});</pre><p>Decorator metadata kullanan testlerde SWC config kritik olabilir; repo Vitest config’i decorators: true ve decoratorMetadata: true gibi ayarlarla bunu çözüyor.</p><p>CI tarafında ayrıca coverage toplama noktasında “SWC ile coverage provider’ları çatışıyor” notu var; repo bunu ayrı bir coverage config ile ele almış. CI’de “test + coverage” ayrımını buna göre tasarlamak mantıklı.</p><h4>Önerilen upgrade stratejisi</h4><p>PR #16391’in “draft” olması ve release window’un Q3 2026 olarak verilmesi, production migrasyonunu “kontrollü, geri dönüşü kolay” yürütmeyi gerektiriyor.</p><p>Benim önerdiğim strateji:</p><ul><li><strong>Önce Node/toolchain yükseltmesi:</strong> Node version’ı v12’nin hedeflediği ESM/CJS interop alanına taşıyın (özellikle CJS kalmayı düşünüyorsanız require(esm) koşullarını sağlayın).</li><li><strong>ESM/CJS kararını repo/servis bazında verin:</strong> Monorepo’da “bazı servisler ESM, bazıları CJS” karışımı dual-package hazard doğurabilir; repo integration config’inin bu riski açıkça belirtmesi önemli bir kırmızı bayrak.</li><li><strong>Contract test ekleyin:</strong> Validation error shape (list vs grouped), exception errorCode, shutdown semantiği gibi “dış API” davranışları için snapshot/contract test şart.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8JbsTZ87qkeiWD_OHPSMYw.png" /></figure><h3>Performans, güvenlik, sorun giderme ve güvenli geri dönüş</h3><h4>Güvenlik ve runtime davranışı</h4><ul><li>Hem ValidationPipe hem de StandardSchemaValidationPipe, prototype pollution benzeri riskleri azaltmak için __proto__, prototype, constructor gibi anahtarları recursive strip eden bir yaklaşım içeriyor; ayrıca bazı built-in tipleri (Date/Map/Set vb.) “Jest fake timers” gibi senaryolarda sorun çıkarmasın diye hariç tutuyor.</li><li>Express adapter’da return503OnClosing ile shutdown sırasında yeni request’lere hızlı 503 dönmek, “keep-alive nedeniyle kapanmayan instance” sorunlarında kontrollü kapanış sağlayabilir.</li><li>Fastify tarafında mapException() ile FastifyError → HttpException map’lenmesi, exception filter’ların daha tutarlı bir error shape/gövde görmesine yardımcı olabilir (ama filter’ınız “FastifyError instanceof …” gibi kontroller yapıyorsa davranış değişebilir).</li></ul><h4>Sık karşılaşılabilecek sorunlar</h4><ul><li>ERR_REQUIRE_ASYNC_MODULE<strong>:</strong> CJS uygulama ESM paketi require() ederken top-level await içeren modüllerde bu hata gelir; Node dokümanı bu koşulu açıkça söylüyor.</li><li><strong>Dual-package hazard / “aynı class iki kez yüklenmiş” hissi:</strong> Repo integration config’i, CJS require ile workspace paketlerinin ayrı instance’lar üretmesini (ör. ModuleRef gibi) risk olarak tanımlıyor. Çözüm genelde “tek module system” veya dependency graph’ı tek formatta tutmak.</li><li><strong>Coverage kırılması:</strong> SWC ile decorator metadata üretmek isterken coverage provider’larının bozulması; repo bunun için ayrı coverage config öneriyor.</li></ul><h4>Rollback yaklaşımı</h4><p>V12’deki birçok davranış değişikliği “opt-in” ve bu rollback’i kolaylaştırır:</p><ul><li>return503OnClosing default kapalı (açtıysanız kapatmak hızlı rollback).</li><li>ValidationPipe errorFormat default &#39;list&#39; (grouped’a geçtiyseniz geri almak mümkün).</li><li>Standard Schema validasyonu, parametrelerde schema tanımlamadıkça devreye girmiyor; “kademeli adoption” için iyi bir yapı.</li></ul><p>NestJS 12, yalnızca bir versiyon güncellemesi değil; runtime gereksinimleri, core container davranışları, HTTP ve microservice katmanındaki rafine edilmiş API yüzeyi ile birlikte framework’ün kurumsal ölçekte daha deterministik, daha performanslı ve daha tip-güvenli bir hâle evrilmesini temsil ediyor.</p><p>Bu sürümle birlikte:</p><ul><li><strong>Node.js 18+ ve modern ECMAScript özellikleri</strong> artık varsayılan ekosistem zemini hâline geliyor.</li><li>Dependency Injection container’ı daha öngörülebilir ve optimize edilmiş bir çözümleme (resolution) sürecine yaklaşıyor.</li><li>HTTP exception handling ve transport layer tarafında daha net sözleşmeler (contracts) ortaya çıkıyor.</li><li>Microservice ve WebSocket altyapısında lifecycle yönetimi daha tutarlı bir davranış modeli sunuyor.</li><li>Toolchain tarafında TypeScript 5+ ile daha güçlü type inference ve stricter compile-time güvenliği sağlanıyor.</li></ul><p>Bu, NestJS’in “opinionated ama esnek” mimari felsefesinin bir sonraki evresi. Artık framework yalnızca bir abstraction layer değil; yüksek ölçekli dağıtık sistemler için production-grade bir application platform olacak gibi duruyor Eğer aktif olarak NestJS 10 veya 11 kullanıyorsanız, migrasyon sürecini kontrollü bir şekilde planlamanız, breaking değişiklikleri test ortamında valide etmeniz ve CI pipeline’larınızı yeni runtime gereksinimlerine göre güncellemeniz kritik önem taşıyor Backend dünyasında sürdürülebilirlik; sadece feature geliştirmekle değil, mimari evrimi doğru yönetmekle mümkündür. Buraya kadar okduğunuz için çok teşekkür ederim. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=23bd4c6d7671" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Uygulamaları İçin Google Play Deploy’larını Fastlane ile Otomatikleştirmek]]></title>
            <link>https://medium.com/@oguzhancart1/uygulamalar%C4%B1-i%CC%87%C3%A7in-google-play-deploylar%C4%B1n%C4%B1-fastlane-ile-otomatikle%C5%9Ftirmek-3988df3c198c?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/3988df3c198c</guid>
            <category><![CDATA[app-store]]></category>
            <category><![CDATA[google-play]]></category>
            <category><![CDATA[fastlane]]></category>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[google-play-store]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Mon, 23 Feb 2026 03:19:12 GMT</pubDate>
            <atom:updated>2026-02-23T03:19:12.283Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, uygulama geliştirirken “en pahalı” süreç çoğu zaman kod yazmak değil; aynı işlemleri tekrar tekrar yapmak: AAB üret, imzala, Play Console’a gir, doğru track’i seç, sürümü yükle, notları güncelle oldukça sıkıc ve yorucunişlem öyle değil mi? <br>Bu yazıda, bu adımları <strong>Fastlane + </strong>supply<strong> (aka </strong>upload_to_play_store<strong>) + GitHub Actions</strong> ile nasıl tek komut/tek tag’e indirebileceğini anlatıyorum.</p><h3>Neden Fastlane, neden şimdi?</h3><p>Fastlane, iOS ve Android için “deployment otomasyonu”nu hedefleyen açık kaynak bir araç seti olarak konumlanıyor; yayınlama/dağıtım gibi sıkıcı işleri script’lerle yönetmeyi amaçlıyor. Android tarafında Google Play’e yükleme ve store listing yönetimi için asıl oyuncu supply: APK/AAB yükler, metadata (başlık/açıklamalar), görseller ve ekran görüntülerini yönetebilir; ayrıca track seçebilir ve release’leri promote edebilir.</p><p>Ben mobil için Flutter kullanıyorum bu yüzden flutter özelinde güzel haber şu: Google Play’e giden artefakt hâlâ Android dünyasının standardı olan <strong>Android App Bundle (AAB)</strong>. Flutter dokümanı da release hazırlığında flutter build appbundle ile AAB üretimini ve çıktının nerede oluşacağını açıkça tarif ediyor. Dolayısıyla Fastlane’i “Flutter’a özel bir hack” gibi değil, Flutter’ın ürettiği AAB’yi Play’e taşıyan bir <strong>dağıtım katmanı</strong> gibi düşünmek daha doğru.</p><h3>Play Console ve kimlik doğrulama</h3><h4>Yeni uygulama gerçeği ve ilk kurulum</h4><p>Yeni bir uygulamada Play Console tarafında önce uygulamayı oluşturman gerekir: dil, uygulama adı, ücretsiz/ücretli, iletişim e-postası ve çeşitli beyan/şart kabul adımları Play Console akışının parçasıdır. Ayrıca Play Console Help Center, özellikle <strong>13 Kasım 2023 sonrası açılmış kişisel hesaplar</strong> için “yayına çıkmadan önce” ek test gereksinimleri olabileceğini not düşüyor; bu tip gereksinimler otomasyon kurarken “neden production’a çıkamıyorum?” sorusunun sebebi olabilir.</p><p>Fastlane tarafındaki kritik koşul da burada: supply ile bağlanmadan önce uygulama Play’de “var olmalı” ve <strong>en az bir build yüklenmiş olmalı</strong> (doküman bunu hem supply init için hem de Quick Start notlarında vurgular). Bu yüzden “tam otomasyon”u pratikte şöyle kurarsın:</p><ol><li>Play Console’da uygulamayı oluştur (manuel).</li><li>İlk AAB’yi <em>internal testing</em> gibi güvenli bir track’e bir kez yükle (manuel).</li><li>Bundan sonrası: Fastlane + CI ile tamamen otomatik.</li></ol><h3>Service account ve Google Play Developer API adımları</h3><p>Google Play Developer API’ye erişim için Google’ın resmi “Getting Started” dokümanı çoğu senaryoda <strong>service account</strong> kullanımını önerir ve temel akışı şöyle özetler: Google Cloud projesi, API enable, service account oluşturma, Play Console’da <strong>Users &amp; Permissions</strong> üzerinden service account’a yetki verme.</p><p>Fastlane’in supply dokümanı da aynı çizgide ilerler; ayrıca Fastlane artık <strong>iki kimlik doğrulama yaklaşımını</strong> açıkça desteklediğini belirtir: <strong>Workload Identity Federation</strong> ve <strong>service account key (JSON)</strong>.</p><h3>Service account ve Google Play Developer API adımları</h3><p>Google Play Developer API’ye erişim için Google’ın resmi “Getting Started” dokümanı çoğu senaryoda <strong>service account</strong> kullanımını önerir ve temel akışı şöyle özetler: Google Cloud projesi, API enable, service account oluşturma, Play Console’da <strong>Users &amp; Permissions</strong> üzerinden service account’a yetki verme.</p><p>Fastlane’in supply dokümanı da aynı çizgide ilerler; ayrıca Fastlane artık <strong>iki kimlik doğrulama yaklaşımını</strong> açıkça desteklediğini belirtir: <strong>Workload Identity Federation</strong> ve <strong>service account key (JSON)</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wmXGcBPv_dPxrPkRMrZhJg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/751/1*vQzqWDrM46FYsWIx9cAYLA.png" /></figure><h3>Kimlik doğrulama seçenekleri</h3><p>Aşağıdaki tablo, pratikte en çok kullanılan iki modeli kıyaslar (özellikle CI tarafında):</p><p><em>Fastlane’in Play client kodu, JSON içindeki </em><em>type alanına göre </em><em>service_account ve </em><em>external_account (WIF) credential sınıflarını ayırt ederek çalıştırıyor; yani WIF desteği “teorik” değil, kod seviyesinde var. Buna rağmen A’dan Z’ye “sorunsuz deneyim” tamamen senin CI/OIDC kurulumunun doğruluğuna bağlı.</em></p><h3>Flutter projesine Fastlane eklemek</h3><h4>Kurulum stratejisi</h4><p>Flutter’ın kendi “Continuous delivery” rehberi, Fastlane’i <strong>platform klasörleri içinde</strong> (Android için [project]/android) başlatmanı önerir: önce AAB ürettiğini doğrula (flutter build appbundle), sonra android/ içinde fastlane init ile konfigürasyonu oluştur.</p><p>Fastlane’in Android kurulum dokümanı da Ruby/Bundler tarafı için net: Ruby 2.5+ ve <strong>Gemfile + Bundler</strong> ile “reproducible” kurulum önerir; CI’da da bundle install ile başla ve komutları bundle exec fastlane ... şeklinde çalıştır der.</p><h3>Android klasörü içinde Fastlane</h3><p>Aşağıdaki örnek, Fastlane’i android/ altında tutar (Flutter projeleri için en okunur yaklaşım).</p><pre>cd android<br><br># 1) (Gerekirse) Bundler kur<br>gem install bundler<br><br># 2) Gemfile oluştur (android/Gemfile)<br>cat &gt; Gemfile &lt;&lt;&#39;EOF&#39;<br>source &quot;https://rubygems.org&quot;<br>gem &quot;fastlane&quot;<br>EOF<br><br># 3) Lock oluştur ve bağımlılıkları sabitle<br>bundle update<br><br># 4) Fastlane&#39;i başlat<br>bundle exec fastlane init</pre><p>Fastlane init sonrası, android/fastlane/ altında Appfile ve Fastfile oluşur. Önerilen klasör düzeni (şematik):</p><pre>my_flutter_app/<br>  android/<br>    Gemfile<br>    Gemfile.lock<br>    fastlane/<br>      Appfile<br>      Fastfile<br>      metadata/<br>        android/<br>          en-US/<br>            title.txt<br>            short_description.txt<br>            full_description.txt<br>            changelogs/<br>              default.txt</pre><p>Metadata dizin yapısı ve changelog dosyalarının sürüm koduna göre adlandırılması supply dokümanında detaylı; bu yapı template repo yaklaşımı için altın değerinde.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/545/1*EiST3SX27hxfMDSewdpdyA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7570_C3Ih1c299WpCZHpkA.png" /></figure><h3>AAB, imzalama ve supply ile yükleme</h3><h3>İmzalama: upload key, Play App Signing ve CI’da keystore</h3><p>Flutter dokümanı, Play Store’a göndermek için uygulamanın dijital sertifika ile imzalanmasını ve Android’in iki anahtar modeli kullandığını söyler: <strong>upload key</strong> ve <strong>app signing key</strong>. Play App Signing sayfası da kavramları netleştirir: upload key senin yüklediğin bundle’ı imzalar; Google Play ise kullanıcıya giden APK’ları app signing key ile imzalar ve güvenlik için bu iki anahtarın farklı olması önerilir.</p><p>Flutter’ın “Create an upload keystore” adımı, keytool komutunu ve android/key.properties üzerinden Gradle’a bağlamayı örneklerle verir; ayrıca hem upload-keystore.jks hem key.properties dosyalarını <strong>public source control’e koymaman</strong> gerektiğini özellikle vurgular.</p><blockquote><em>Bu yazıda “keystore’u nerede saklayacağın” kullanıcı tarafından </em><strong><em>belirtilmedi</em></strong><em>. Pratik seçenekler:</em></blockquote><blockquote><em>GitHub Actions: keystore’u </em><strong><em>base64</em></strong><em> yapıp Secret olarak saklamak ve workflow’da dosyaya yazmak (Flutter CD rehberi doğrudan bu yaklaşımı örnekliyor).</em></blockquote><blockquote><em>CI sağlayıcının “secure files” özelliği (GitLab/Bitrise gibi).</em></blockquote><blockquote><em>Kurumsal: ayrı bir secrets manager (Vault vb.) ve build sırasında çekmek (bu yazı kapsamı dışında).</em></blockquote><h3>Fastfile: Flutter AAB üret ve supply ile internal track’e yükle</h3><p>supply, upload_to_play_store action’ının alias’ıdır ve json_key/json_key_data ile Google Play’e bağlanıp AAB yükleyebilir. Ayrıca track parametresi ile varsayılan production yerine internal, alpha, beta gibi track’lere yönlendirebilirsin.</p><p>android/fastlane/Appfile örneği (lokalde dosya yolu ile):</p><pre># android/fastlane/Appfile<br>package_name(&quot;com.example.myapp&quot;)<br># json_key_file(&quot;path/to/play-credentials.json&quot;) # CI&#39;da genelde kullanmayız</pre><p>android/fastlane/Fastfile örneği (CI uyumlu, json_key_data ile):</p><pre>default_platform(:android)<br><br>platform :android do<br>  desc &quot;Flutter AAB üret ve Google Play Internal&#39;a yükle&quot;<br>  lane :deploy_internal do<br>    # Flutter build (Fastlane android/ klasörü içinde çalışır varsayımıyla)<br>    sh(&quot;cd .. &amp;&amp; flutter pub get&quot;)<br>    sh(&quot;cd .. &amp;&amp; flutter build appbundle&quot;)<br><br>    aab_path = Dir[File.join(&quot;..&quot;, &quot;build&quot;, &quot;app&quot;, &quot;outputs&quot;, &quot;bundle&quot;, &quot;release&quot;, &quot;*.aab&quot;)].first<br>    UI.user_error!(&quot;AAB bulunamadı. build/app/outputs/bundle/release altında *.aab bekleniyor.&quot;) unless aab_path<br><br>    upload_to_play_store(<br>      aab: aab_path,<br>      track: &quot;internal&quot;,<br>      json_key_data: ENV[&quot;PLAY_JSON_KEY_DATA&quot;],<br>      skip_upload_metadata: false,<br>      skip_upload_images: true,<br>      skip_upload_screenshots: true<br>    )<br>  end<br>end</pre><p>Flutter dokümanı AAB üretiminin yolunu ve flutter build appbundle komutunu net şekilde verir; sürüm çıktısı build/app/outputs/bundle/release/ altına düşer.</p><h3>Play Console ekranı: otomasyonun “görünür” çıktısı</h3><p>Aşağıdaki gibi bir “release / track” ekranında, Fastlane’in yüklediği AAB ve release notlarının görünmesi hedeflenir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3bljijoUlJuj1KHrpPVUfQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wEFOhziOIbLbE0sRKV7QQw.png" /></figure><h3>GitHub Actions ile CI/CD</h3><h4>Pipeline akışı</h4><p>GitHub Actions içinde mantık basit: tag/push → Flutter build → Fastlane lane → Play’e upload. GitHub, secret’ları workflow’da environment variable olarak geçirmeni destekler; ayrıca OIDC ile cloud sağlayıcılarına “long-lived secret” taşımadan bağlanma modelinden bahseder.</p><p>Aşağıdaki Mermaid diyagramı, önerilen akışı özetler:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/273/1*2pYZZMneVRU65ZSG0g21fA.png" /></figure><h3>Örnek workflow: tag ile internal deploy</h3><p>Aşağıdaki örnek, <strong>JSON key</strong> yaklaşımıyla (en hızlı kurulum) “internal deploy” yapar. PLAY_JSON_KEY_DATA’nın Secret olarak eklenmesi ve workflow’da secrets context’iyle env’e taşınması GitHub dokümanında anlatıldığı şekilde yapılır.</p><pre>name: Deploy Android (Internal)<br><br>on:<br>  push:<br>    tags: [&quot;v*.*.*&quot;]<br><br>jobs:<br>  deploy:<br>    runs-on: ubuntu-latest<br><br>    steps:<br>      - uses: actions/checkout@v4<br><br>      - name: Set up Java<br>        uses: actions/setup-java@v4<br>        with:<br>          distribution: temurin<br>          java-version: &quot;17&quot;<br><br>      # Flutter kurulumu (örnek yaklaşım; organizasyonunuzun standardına göre değişebilir)<br>      - name: Set up Flutter<br>        uses: subosito/flutter-action@v2<br>        with:<br>          channel: stable<br><br>      - name: Set up Ruby + Bundler cache<br>        uses: ruby/setup-ruby@v1<br>        with:<br>          ruby-version: &quot;3.2&quot;<br>          bundler-cache: true<br>          working-directory: android<br><br>      - name: Recreate keystore + key.properties<br>        env:<br>          ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}<br>          ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}<br>          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}<br>          ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}<br>        run: |<br>          cd android<br>          echo &quot;$ANDROID_KEYSTORE_BASE64&quot; | base64 --decode &gt; upload-keystore.jks<br>          cat &gt; key.properties &lt;&lt;EOF<br>          storePassword=$ANDROID_KEYSTORE_PASSWORD<br>          keyPassword=$ANDROID_KEY_PASSWORD<br>          keyAlias=$ANDROID_KEY_ALIAS<br>          storeFile=upload-keystore.jks<br>          EOF<br><br>      - name: Deploy to Google Play (Internal)<br>        env:<br>          PLAY_JSON_KEY_DATA: ${{ secrets.PLAY_JSON_KEY_DATA }}<br>        run: |<br>          cd android<br>          bundle exec fastlane android deploy_internal</pre><blockquote><em>Flutter’ın kendi CD rehberi, CI ortamında Play JSON’unu dosya yerine </em><em>json_key_data olarak env var’dan okumayı ve keystore’u base64 ile serialize edip build sırasında dosyaya yazmayı özellikle öneriyor.</em></blockquote><h3>Çok uygulama üretenler için şablon repo ve kontrol listesi</h3><p>“Sürekli yeni uygulama açıyorum” diyenlere önerilen workflow</p><p>Yeni uygulama açma sürecini %100 otomatikleştirmek çoğu zaman gerçekçi değildir; çünkü Play Console’da uygulama oluşturma, beyanlar, politikalar ve (hesaba göre değişebilen) test gereksinimleri gibi adımlar manuel doğrulamalar içerir. Üstüne Fastlane de supply öncesi <strong>en az bir build’in manuel yüklenmesini</strong> bekler.</p><p>Bu durumda en verimli yaklaşım: <strong>template repo</strong> (veya “flutter_app_template” monorepo şablonu) oluşturmak.</p><p>Template’in içinde şunları hazır tut:</p><ul><li>android/fastlane/ (Fastfile + Appfile + opsiyonel metadata/android/)</li><li>.github/workflows/deploy.yml</li><li>Gradle signing konfigürasyonu (Flutter dokümanındaki key.properties / signingConfigs düzeni)</li><li>README’de “yeni app açınca değişecek değişkenler”: applicationId (package_name), track, flavor, vs.</li></ul><p>Yeni uygulama için akış:</p><ol><li>Template’ten yeni repo oluştur.</li><li>applicationId/package name’i güncelle (Appfile + Android config).</li><li>Play Console’da “Create app” akışını tamamla ve ilk build’i internal’a bir kez yükle.</li><li>Sonra fastlane supply init ile listing metadata’yı repo’ya çek (ekran görüntülerinin API ile indirilemediğini unutma).</li><li>Bundan sonrası tag → otomatik deploy.</li></ol><ul><li><strong>Yetki/bağlantı testini erken yap:</strong> Fastlane validate_play_store_json_key action’ı ile Play bağlantısını doğrulamak, “neden upload olmuyor?” hatalarını hızlı ayıklar.</li><li><strong>CI’da UTF-8 locale sorunları:</strong> Fastlane dokümanı, UTF‑8 olmayan locale’in build/upload sırasında sorun çıkarabileceğini ve LC_ALL/LANG ayarlarını gerekirse shell profile’a eklemen gerektiğini belirtir (özellikle Linux runner’larda işe yarar).</li><li><strong>WIF kullanıyorsan hatalara hazırlıklı ol:</strong> Fastlane tarafında external_account credential destekleniyor olsa da, pratikte yanlış format/eksik alanlar “missing client_email” gibi sorunlara yol açabiliyor; bu durumda ya WIF kurulumunu düzeltmek ya da geçici olarak JSON key’e dönmek daha hızlıdır.</li><li><strong>Store listing’i kodla yönet:</strong> fastlane supply init metadata’yı indirir ama API limitleri nedeniyle mevcut screenshot/video’ları indiremez; screenshot yönetimini repo’da standardize etmek template repo’yu daha değerli kılar.</li></ul><p>Buraya kadar okuduğunuz için çok teşekkür ederim. Eğer diler framework yada dillerde kullanımını merak ediyorsanız yorum atmanız yada alkış atmanız yeterli olur. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3988df3c198c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Micro Socket Methodology]]></title>
            <link>https://medium.com/@oguzhancart1/micro-socket-methodology-75a83960de24?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/75a83960de24</guid>
            <category><![CDATA[micro-socket]]></category>
            <category><![CDATA[micro-socket-server]]></category>
            <category><![CDATA[socket-programming]]></category>
            <category><![CDATA[metodologia]]></category>
            <category><![CDATA[sockets]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Mon, 16 Feb 2026 00:02:37 GMT</pubDate>
            <atom:updated>2026-02-16T00:02:37.469Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, bu yazımda benim tarafımdan geliştirilen <strong>Micro Socket m</strong>etodoloji detaylıca inceleyelim ve öğrenelim. Micro Socket yaklaşımının temel amacı, <strong>gerçek zamanlı mikro hizmet (microservice) mimarisi</strong> sunmaktır. Geleneksel WebSocket kullanımı tek bir bağlantı üzerinden tüm trafiği taşırken, Micro Socket her konu için ayrı bir alt-konuşma (sub-socket) tutarak yayınları konulara göre izole eder. Bu sayede:</p><ul><li>İstemciler yalnızca ihtiyaç duydukları konu trafiğini alır, fazla yük azaltılır.</li><li>Sistemin ölçeklenebilirliği, “bağlantı sayısı” yerine <strong>konu sayısı</strong> ölçeğiyle yönetilir. Her konu için bir subscriber grubu vardır, milyonlarca abonelik tek bir sunucu sürecinde bile hafızada saklanabilir.</li><li>Mikro hizmet anlayışına uygun olarak, sistem bileşenleri (gateway’ler) birbirleriyle standart bir protokol üzerinden haberleşir; tek bir ortak protokol kullanılır ve ihtiyaç halinde yatay olarak çoğaltılabilir.</li></ul><p>Ayrıca Micro Socket, <strong>invariant (değişmezlik) garantileri</strong> üzerine odaklanır. Micro sockettin sağlamış olduğu garantiler şunlardır: yetkisiz erişimin önlenmesi (ACL), çift işlemeyi önleme (message deduplication), mesajların sıralı teslimi, teslimat garantisi, gecikme SLO’su, bağlantı kesilmesinden sonra kaldığı yerden devam (resume), veri bütünlüğü gibi önemli özellikler sağlanır. Bu sayede finans, IoT, gerçek zamanlı bildirim sistemleri gibi uygulamalarda tutarlılık ve güvenilirlik artar.</p><h3>Mimari ve Bileşenler</h3><p>Micro Socket mimarisi, <strong>yalnızca WebSocket üzerinden değil, aynı zamanda HTTP</strong> gibi diğer protokolleri de kullanarak hibrit bir mimari sunar. Projenin en temel bileşeni <strong>Gateway</strong>’dir; bu, gelen WebSocket bağlantılarını kabul eder, bağlanan istemcileri kimliklendirir (token ile) ve sonrasında konulara abone eder. Her konu için hafızada bir abone seti (Map&lt;topic, Set&lt;connectionId&gt;&gt;) tutulur. Örneğin Elysia örnek kodunda, topicSubscribers adında bir yapı vardır ve her topic’e abone olan connectionId’leri saklar. Böylece yayın (broadcast) işlemi yapıldığında sadece o konuda kayıtlı bağlantılara mesaj gönderilir.</p><p><strong>Bileşenler</strong> bakımından, Elysia tabanlı örnek proje şu dosyalardan oluşur.</p><ul><li><a href="https://github.com/oguzhan18/elysia-micro-socket-example">GitHub - oguzhan18/elysia-micro-socket-example: Production-style Micro Socket gateway built with Elysia (Bun): one WebSocket endpoint, per-topic sub-sockets, and broadcast to millions of subscriptions.</a></li><li><a href="https://github.com/oguzhan18/price-feed-gateway">GitHub - oguzhan18/price-feed-gateway: Micro Socket-style gateway that exposes a main socket (raw Bitcoin/crypto prices from Binance) and sub sockets (channels) where each channel applies per-symbol margins (spread) to the main feed.</a></li></ul><p>Bu metodolojiye Bu kaynaklarda her iki proje de <a href="https://bun.sh/">Bun</a> çalıştırıcısını kullanır ve Elysia çerçevesi üzerine kuruludur. Bun, Node.js uyumlu hızlı bir JavaScript/TypeScript çalışma zamanı sunar. Ayrıca her iki projede de derleme sırasında Ortam Dosyası (.env) veya config.ts ile port vb. değişkenler tanımlanabilir. Örneğin Price Feed’de kullanılan src/config.ts dosyası sunucunun dinlediği portu ve Binance WebSocket URL’sini içerir. Elysia örneğinde ise bun run dev komutu varsayılan 3000 portunda çalışır.</p><h3>Veri Akışları ve Protokoller</h3><p>Micro Socket projeleri hem <strong>WebSocket</strong> hem <strong>HTTP</strong> protokollerini kullanır. Genel akış şu şekildedir: Bir istemci WebSocket üzerinden /ws veya /ws/sub/:topic adresine bağlanır. Bağlandıktan sonra ilk mesaj olarak bir setup ({type: &quot;setup&quot;, token, topics?}) mesajı gönderir. Sunucu bunu alır, kullanıcıyı doğrular (demo’da token doğrudan kabul edilir) ve yeni bir sessionId ile cevap döner.</p><p>Daha sonra istemci {type: &quot;subscribe&quot;, topic: &quot;xxx&quot;} mesajı göndererek belirli bir konuya abone olur. Sunucu, o bağlantıyı ilgili konu alt-socket’ine ekler ve onay mesajı ({type: &quot;subscribed&quot;, topic}) yollar. Bundan sonra sunucu, abone olunan konuya yeni bir mesaj geldiğinde sadece bu alt-sokete kayıtlı bağlantılara JSON iletiler gönderir. Örneğin Elysia örneğinde, birisi HTTP üzerinden GET /demo/publish/prices?bid=100 çağrısı yaptığında, “prices” konusuna {type: &quot;message&quot;, topic: &quot;prices&quot;, data: {...}} şekline mesaj yayınlanır ve sadece prices alt-socket’ine kayıtlı istemciler alır. Farklı konular birbirine karışmaz; her topic ayrı abone listesine sahiptir.</p><p><strong>Protokol Detayları:</strong> Her projenin kendine özgü JSON protokolü vardır. Örneğin Elysia örneğinde protokol şu şekildedir:</p><ol><li>İstemci /ws veya /ws/sub/:topic ile bağlanır, ardından { &quot;type&quot;: &quot;setup&quot;, &quot;token&quot;: &quot;...&quot;, &quot;topics&quot;: [&quot;prices&quot;, ...] } gönderir (topics isteğe bağlı).</li><li>Abone olma: { &quot;type&quot;: &quot;subscribe&quot;, &quot;topic&quot;: &quot;prices&quot; }. Sunucu { &quot;type&quot;: &quot;subscribed&quot;, &quot;topic&quot;: &quot;prices&quot; } döner. (Alternatif olarak /ws/sub/prices ile bağlanmak da ilk mesajda otomatik aboneyi sağlar.)</li><li>Mesajlar geldiğinde: { &quot;type&quot;: &quot;message&quot;, &quot;topic&quot;: &quot;...&quot;, &quot;seqNo&quot;: &lt;num&gt;, &quot;messageId&quot;: &quot;...&quot;, &quot;data&quot;: {...} } formatında iletilir.</li><li>(Opsiyonel) Yayın: { &quot;type&quot;: &quot;publish&quot;, &quot;topic&quot;: &quot;orders&quot;, &quot;messageId&quot;: &quot;...&quot;, &quot;payload&quot;: {...} } gönderilebilir. Sunucu her messageId için bir kez işlem yapar (idempotency).</li></ol><p>Price Feed Gateway protokolü ise biraz farklıdır: Tek tip subscribe mesajı kullanılır. Örneğin {type: &quot;subscribe&quot;, stream: &quot;main&quot;} ana akışa abone olur; {type: &quot;subscribe&quot;, stream: &quot;channel&quot;, channelId: &quot;...&quot;} ise belirli bir kanala. Sunucu yanıt olarak {type: &quot;subscribed&quot;, ...} veya hata kodu içeren mesajlar yollayabilir. Gelen veriler ise &quot;stream&quot;: &quot;main&quot; veya &quot;stream&quot;: &quot;channel&quot; ile belirtilir ve tick (fiyat verisi) iletilir.</p><p><strong>HTTP Uç Noktalar:</strong> Her iki projede de yönetim için REST uçları vardır (Tablo 3 ve Tablo 4). Elysia örneği /docs, /openapi, /stats, /demo/publish/:topic uçlarını, Price Feed ise /prices, /stats, /channels vb. uçlarını sağlar. Bu uçlar durumu görüntüleme, test için demo yayınları vb. içindir.</p><p>Elysia örneğinde özel bir konfigürasyon dosyası yoktur; proje varsayılan olarak 3000 portunu kullanır. Price-Feed örneğinde ise src/config.ts içinde PORT ve BINANCE_WS_URL tanımlamaları bulunur. Geliştirme ortamında .env desteğiyle process.env kullanılabilir.</p><h3>Ana Algoritmalar</h3><p>Micro Socket’in temel algoritması <strong>konu bazlı yayın</strong>dır (publish-subscribe). Basit bir örnekle anlatmak gerekirse, her gelen abonelik (subscribe) ve yayın (publish) şöyle işlenir:</p><pre>// Basitleştirilmiş TypeScript örneği<br>const topicSubscribers = new Map&lt;string, Set&lt;WebSocket&gt;&gt;();<br><br>// Abone olma işlemi<br>function subscribe(client: WebSocket, topic: string) {<br>    if (!topicSubscribers.has(topic)) {<br>        topicSubscribers.set(topic, new Set());<br>    }<br>    topicSubscribers.get(topic)!.add(client);<br>    // (Sunucu, {type:&#39;subscribed&#39;, topic} mesajını gönderir)<br>}<br><br>// Yayın (broadcast) işlemi<br>function broadcast(topic: string, messageData: any) {<br>    const subs = topicSubscribers.get(topic);<br>    if (!subs) return; // kimse abone değilse çıkış<br>    const payload = JSON.stringify({ type: &#39;message&#39;, topic, data: messageData });<br>    for (const ws of subs) {<br>        ws.send(payload);<br>    }<br>}<br><br>// İstemciden mesaj işleme<br>function handleClientMessage(client: WebSocket, msg: any) {<br>    switch (msg.type) {<br>        case &#39;subscribe&#39;:<br>            subscribe(client, msg.topic);<br>            break;<br>        case &#39;publish&#39;:<br>            broadcast(msg.topic, msg.payload);<br>            break;<br>    }<br>}</pre><p>Bu örnek, subscribe fonksiyonu ile bir Map&lt;topic, Set&lt;connection&gt;&gt; yapısına yeni aboneleri ekler. broadcast fonksiyonu ise o topic’e kayıtlı tüm WebSocket’lere JSON veriyi yollar. Gerçek projelerde bu yapı daha sofistike tutulur: ID ya da oturum (session) bazlı yönetim, <em>deduplication</em> ve <em>order</em> işlemleri eklenir.</p><h3>Tekilleştirme (Dedup) ve Sıralama</h3><p>Mesajların idempotent (tekrarsız) işlenmesi için her mesajın messageId’si tutulur. Örneğin bir istemci aynı mesajı tekrar gönderirse ikinci kez işlenmez. Aşağıda basit bir idempotency örneği var:</p><pre>// Tekilleştirme için kullanıcı-bağımlı küme<br>const seenMessages = new Map&lt;string, Set&lt;string&gt;&gt;(); // userId -&gt; set of messageId<br><br>function handlePublish(userId: string, topic: string, msgId: string, data: any) {<br>    const userSet = seenMessages.get(userId) || new Set();<br>    if (userSet.has(msgId)) {<br>        return; // Bu mesaj daha önce işlenmiş, atla<br>    }<br>    userSet.add(msgId);<br>    seenMessages.set(userId, userSet);<br>    broadcast(topic, data); // Yukarıdaki publish fonksiyonu<br>}</pre><p>Mesaj sıralaması için ise sunucu, her konu için artan bir seqNo numarası oluşturabilir. Gelen mesaj broadcast edilmeden önce seqNo iliştirilir, istemciler bu sayıyı kontrol ederek eksik veya sıra dışı mesajları algılayabilir. Bu “seqNo” uygulamaları micro-socket belgelerinde “I₃ – ordering” invariants altında ele alınır.</p><h3>Fiyat Yayını Örneği (Price-Feed)</h3><p>Price-Feed Gateway örneğinde ana veri akışı gerçek Binance WebSocket’inden alınır. Örnek algoritmanın bir kısmı şu şekildedir:</p><pre>// Örnek: Binance WebSocket&#39;ten tick alınması ve yayınlanması<br>feedClient.on(&#39;message&#39;, (rawTick) =&gt; {<br>    const tick = parsePriceTick(rawTick); // { symbol, price, ... }<br>    // Son fiyat güncelle<br>    priceStore[tick.symbol] = tick.price; <br>    // Ana akışa yayın (raw price)<br>    broadcast(&#39;main&#39;, tick); <br>    // Her kanal için ayrı fiyat hesapla ve yayınla<br>    for (const channel of channels) {<br>        const margin = channel.margins[tick.symbol] || 0;<br>        const adjustedTick = { ...tick, price: tick.price + margin };<br>        broadcast(`channel:${channel.id}`, adjustedTick);<br>    }<br>});</pre><p>Bu kodda, gelen her tick verisi hem main konusuna olduğu gibi yayınlanır hem de her kanalın tanımlı margin değeri kullanılarak fiyat ayarlanır ve ilgili channel:&lt;id&gt; sub-sokete gönderilir. Sonuçta tek bir veri kaynağı, çoklu farklı fiyat akışlarını besler.</p><h3>Ölçeklenebilirlik Yaklaşımları</h3><p>Micro Socket, büyük ölçekler için tasarlanmıştır. Tek bir gateway süreci milyonlarca aboneliği hafızada saklayabilir. Map&lt;topic,Set&gt; yapısı konuların sayısı arttıkça kaydedilen abonelerle paralel büyür ve konu başına bellek kullanımı sınırlıdır.</p><p><strong>Yatay ölçekleme</strong> için ise birden fazla gateway dağıtılarak arka planda NATS veya Kafka gibi sistemler kullanılır. Bu sayede her gateway kendi bağlantılarına hizmet eder; arka uç yayını bir mesaj kuyruğuna (örneğin NATS) gönderir ve diğer gateway’ler bu mesajı dinleyerek abonelerine iletir. Belgeye göre “her örnek kendi bağlantılarını tutar; paylaşılan bir durum gerekmez”. Ayrıca backbone.ts örnek kodunda tek-düğüm demo için bellek içi publish yer alırken, gerçek dağıtık sistemlerde bu kısmın NATS/Kafka tüketicileriyle değiştirilmesi önerilir.</p><p>Performans konusunda, Elysia ve Bun birlikte oldukça yüksek throughput sunar. Örneğin Bun sunucusu, Node.js’e kıyasla yüz binlerce WebSocket mesajını kolaylıkla işleyebilir. Bunun üzerine Micro Socket, mesajları sadece ilgili abonelere gönderdiği için ağ trafiğini azaltır. Alternatif bir yüksek-performans seçeneği olarak, C++ tabanlı <a href="https://github.com/uNetworking/uWebSockets">µWebSockets (uWebSockets)</a> kütüphanesi öne çıkar. µWebSockets, “gerçek zamanlı uygulamalar için yüksek hızlı, güvenli ve standart uyumlu” bir sunucudur ve entegre Pub/Sub desteği sunar. Ancak µWebSockets micro-socket benzeri yüksek seviyeli bir altyapı sunmaz; doğrudan kod yazarak benzer bir işlev oluşturmak gerekir.</p><h3>Hata Yönetimi</h3><p>Micro Socket protokolü, hatalı mesajlar veya geçersiz abone talepleri için basit hata mesajları tanımlar. Örneğin Price Feed Gateway şu hata kodlarını dönebilir: CHANNEL_NOT_FOUND, INVALID_JSON, EXPECTED_SUBSCRIBE, INVALID_STREAM gibi. Bunlar istemciye JSON formatında { &quot;type&quot;: &quot;error&quot;, &quot;code&quot;: &quot;...&quot;, ... } şeklinde iletilir. İstemciler bu kodlara bakarak hatayı anlayabilir.</p><p>Bağlantı kesilmeleri durumunda sunucular resume mekanizması destekleyebilir (bazı protokollerde sessionId ve son alınan seqNo gönderilerek devam edilebilir). Belgeye göre micro-socket mimarisinde her kullanıcının son alınan seqNo’su tutulur (I₆ – resume invariant). Mevcut örnek kodlar basitleştirilmiş olduğu için tam bir <strong>resume</strong> özelliği yoktur, ancak dokümantasyon bu imkanı vurgular. Üretim sistemlerinde, hata yönetimi için ek olarak aşağıdakiler önerilebilir:</p><ul><li>Hataları loglama ve izleme (örn. merkezi log sistemi).</li><li>Bağlantı sayısı aşıldığında uygun mesaj (rate-limit) veya bekletme.</li><li>Yetersiz token veya izin durumlarında <em>403 Forbidden</em> dönüşümler.</li></ul><h3>Güvenlik Önlemleri</h3><p>Micro Socket yaklaşımında güvenlik öncelikli konular ACL (erişim kontrolü) ve ileti bütünlüğüdür. Temel örneklerde setup isteği basitçe kabul edilse de, gerçek uygulamalarda JWT gibi token doğrulama veya API anahtar kontrolü eklenmelidir. Böylece her bağlantı için bir userId atanır ve veriler kullanıcı bazlı izole edilebilir. Örneğin topicSubscribers yapısını Map&lt;topic, Set&lt;{connId,userId}&gt;&gt; olarak genişletmek mümkündür.</p><p>Şifreleme için TLS/WSS kullanmak şarttır. Elysia uygulamaları genellikle HTTPS/WSS sunarak iletişim şifreli olur. Ayrıca type: &quot;publish&quot; isteklerinde belirli kullanıcıların sadece kendi sahip oldukları messageId’leri göndermesi ve sunucunun onlara ait olduğunu teyit etmesi gerekir. Dokümanda I₁ – ACL başlığı altında “yetkisiz erişim yok” garantisi vurgulanır. Bu, her istemcinin yalnızca izinli olduğu topic’leri görebileceği anlamına gelir. Dolayısıyla güvenlik için uygulanan öneriler şunlardır:</p><ul><li><strong>Kimlik doğrulama (Authentication):</strong> Token, API anahtarı veya OAuth kullanarak istemciyi doğrula. (Örnek kodda demo için basit token-&gt;userId dönüşümü vardır.)</li><li><strong>Yetkilendirme (Authorization):</strong> Kullanıcının abone olmak istediği topic üzerinde izni olup olmadığını kontrol et (örneğin “user’sinin yalnızca kendi ödeme kanalına abone olma hakki var”).</li><li><strong>Mesaj doğrulama:</strong> publish istekleri belirli kullanıcı kimliğine bağlanmalı. İşlenmeden önce messageId ve userId eşleşmesi kontrolü yapılabilir.</li><li><strong>TLS/WSS kullanımı:</strong> Hem WebSocket hem REST trafiği HTTPS üzerinden gitmeli.</li><li><strong>Bağlantı sınırlaması ve DoS koruması:</strong> Aynı kullanıcıdan aşırı istek geliyorsa limit koy, yeniden bağlantı isteğini yavaşlat.</li></ul><h3>Kurulum ve Kullanım Adımları</h3><p>Her iki örnek proje de benzer şekilde kurulur (pc’de <strong>Bun</strong> kurulu olmalıdır):</p><ol><li><strong>Depoyu klonlayın:</strong> Örneğin git clone <a href="https://github.com/oguzhan18/elysia-micro-socket-example.git.">https://github.com/oguzhan18/elysia-micro-socket-example.git.</a></li><li><strong>Bağımlılıkları yükleyin:</strong> Proje kökünde bun install komutunu çalıştırın.</li><li><strong>Uygulamayı başlatın:</strong> bun run dev komutu sunucuyu başlatır. (Varsayılan port: Elysia örneği için 3000, Price Feed için 4000.)</li><li><strong>Uç noktaları test edin:</strong> Tarayıcı veya API istemcisiyle http://localhost:&lt;port&gt;/docs adresine giderek REST ve WS arayüzünü görebilirsiniz. WebSocket bağlantısı için ayrı bir terminalde wscat veya tarayıcı konsolu kullanılabilir. Örneğin:</li></ol><ul><li>Elysia için: wscat -c ws://localhost:3000/ws, sonra {&quot;type&quot;:&quot;setup&quot;,&quot;token&quot;:&quot;demo&quot;,&quot;topics&quot;:[&quot;prices&quot;]} gönderin.</li><li>Price Feed için: wscat -c ws://localhost:4000/ws, sonra {&quot;type&quot;:&quot;subscribe&quot;,&quot;stream&quot;:&quot;main&quot;} veya `{&quot;type&quot;:&quot;subscribe&quot;,&quot;stream&quot;:&quot;channel&quot;,&quot;channelId&quot;:&quot;...&quot;} gönderin.</li></ul><ol><li><strong>Demo yayın yapın:</strong> Elysia örneğinde curl &quot;http://localhost:3000/demo/publish/prices?bid=123&quot; ile “prices” konusuna mesaj atabilirsiniz; Price Feed’de ise curl -X POST http://localhost:4000/channels -H &quot;Content-Type: application/json&quot; -d &#39;{&quot;margins&quot;:{&quot;BTCUSDT&quot;:50}}&#39; gibi komutlarla kanal oluşturabilir, ardından WS istemcileriyle sonuçları görebilirsiniz.</li></ol><p>Kurulum ve kullanım için projelerin README’leri ayrıntılı yönergeler içerir. Örneğin:</p><pre>cd price-feed-gateway<br>bun install<br>bun run dev</pre><p>başlangıç komutları, ardından http://localhost:4000/docs adresinden arayüze ulaşılır.</p><h3>Örnek Kod Parçacıkları</h3><p>Aşağıda, Micro Socket mantığının basitleştirilmiş TypeScript kodlarıyla gösterimi yer alıyor.</p><ol><li><strong>Abonelik ve Yayın Fonksiyonları:</strong> Bir topicSubscribers haritası üzerinden çalışan temel fan-out algoritması (bkz. [48] sayfa 364-368):</li></ol><pre>// Abonelik veritabanı: topic -&gt; Set&lt;clientConnection&gt;<br>const topicSubscribers = new Map&lt;string, Set&lt;WebSocket&gt;&gt;();<br><br>// Abonelik ekler<br>function subscribe(client: WebSocket, topic: string) {<br>    if (!topicSubscribers.has(topic)) {<br>        topicSubscribers.set(topic, new Set());<br>    }<br>    topicSubscribers.get(topic)!.add(client);<br>    client.send(JSON.stringify({ type: &#39;subscribed&#39;, topic }));<br>}<br><br>// Yayını sadece o topic&#39;e abone olanlara yollar<br>function broadcast(topic: string, data: any) {<br>    const subs = topicSubscribers.get(topic);<br>    if (!subs) return;<br>    const msg = JSON.stringify({ type: &#39;message&#39;, topic, data });<br>    for (const ws of subs) {<br>        ws.send(msg);<br>    }<br>}<br><br>// Mesaj karşılama<br>wsServer.on(&#39;connection&#39;, (client) =&gt; {<br>    client.on(&#39;message&#39;, (text) =&gt; {<br>        const msg = JSON.parse(text);<br>        if (msg.type === &#39;subscribe&#39;) {<br>            subscribe(client, msg.topic); // Abone olma<br>        } else if (msg.type === &#39;publish&#39;) {<br>            broadcast(msg.topic, msg.payload); // Yayın yapma<br>        }<br>    });<br>});</pre><p>Bu örnekte, subscribe fonksiyonu gelen WebSocket bağlantısını belirtilen topic set’ine ekler. broadcast ise sadece o topic’e kayıtlı tüm bağlantılara mesaj yollar. Basit bir demo olarak message yanıtı JSON ile gönderilir. Gerçek kodda, seqNo ve messageId gibi ek alanlar da eklenir.</p><p><strong>2. Fiyat Yayını (Price-Feed):</strong> Fiyat verilerini kanal marjlarıyla yayınlama örneği:</p><pre>// Price Feed örneği: gelen Binance tick&#39;lerini işle ve yayınla.<br>wsBinance.on(&#39;message&#39;, (raw) =&gt; {<br>    const tick = JSON.parse(raw); // Örn: { symbol: &quot;ETHUSDT&quot;, price: 3500.00 }<br>    // 1. Son fiyat deposunu güncelle<br>    priceStore[tick.symbol] = tick.price;<br>    // 2. Ana akışa yayın (raw fiyat)<br>    broadcast(&#39;main&#39;, tick);<br>    // 3. Her kanala ayrı fiyat gönder<br>    channels.forEach((ch) =&gt; {<br>        const margin = ch.margins[tick.symbol] || 0;<br>        const adjustedPrice = tick.price + margin;<br>        const tickWithMargin = { ...tick, price: adjustedPrice };<br>        broadcast(`channel:${ch.id}`, tickWithMargin);<br>    });<br>});</pre><p>Bu kod akışı, her yeni fiyat geldiğinde ana akışa ve her kanal için marjlı akışa ayarlanmış fiyat verilerini gönderir. Sonuç olarak iki tür mesaj dolaşır: stream: &quot;main&quot; olarak ham veriler, stream: &quot;channel&quot; olarak ayarlanmış veriler.</p><p><strong>3. Bağlantı Senkronizasyonu (Resume):</strong> Örneğin her istemcinin sessionId ve lastSeq değerine dayalı yeniden bağlanma senaryosu (doküman invariant I₆):</p><pre>let sessions = new Map&lt;string, {lastSeq: number, subscriptions: string[]}&gt;();<br><br>function handleResume(client: WebSocket, msg: any) {<br>    // msg: { type: &quot;resume&quot;, sessionId: &quot;...&quot;, lastSeq: 123 }<br>    const session = sessions.get(msg.sessionId);<br>    if (session) {<br>        // Kayıp mesaj varsa yeniden gönderilebilir<br>        const pendingMsgs = getMissedMessages(session.lastSeq);<br>        pendingMsgs.forEach(m =&gt; client.send(JSON.stringify(m)));<br>        // Son sırayı güncelle<br>        session.lastSeq = currentSeq;<br>    }<br>}</pre><p>Gerçek koddaki detaylar daha karmaşıktır, ancak temel fikir şudur: istemci kopma anındaki lastSeq değerini sunucuya iletir; sunucu bu numaradan sonraki eksik mesajları tekrar yollar. Bu mekanizma, “deliver garantisi ve resume” için öngörülmüştür (I₆ ve I₇).</p><h3>Gerçek Dünya Kullanım Senaryoları</h3><p>Micro Socket mimarisi, özellikle <strong>finansal veri akışı</strong>, <strong>oyun sunucuları</strong>, <strong>IoT telemetri</strong> gibi <strong>gerçek zamanlı ve ölçek gerektiren</strong> sistemler için uygundur. Örneğin Price-Feed örneği bir kripto para borsası verisini işleyip farklı marjlar uygulayan kanallar açar. Bu, bir kuruluşun hem ham piyasa verisini hem de özel hesaplara özel fiyatları aynı altyapıda sunmasına olanak verir.</p><p>Benzer şekilde, bir haber veya bildirim sisteminde farklı abonelik konularına (spor, politika, teknoloji) göre tek bir WebSocket’tan ayrılmış akışlar yönetilebilir. IoT senaryolarında ise her cihaz türü veya sensör grubu için ayrı alt-soketler açılabilir; böylece kablolu bağlantıya benzer modelde “topic bazlı” izolasyon sağlanır.</p><p>Projenin resmi dökümantasyonunda da fintech örnekleri öne çıkmaktadır (örneğin <em>Test Matrix &amp; Metrics</em> veya <em>Fintech Usage</em> bölümleri). Yani gerçek dünyada yüksek hacimli canlı veri akışlarının yönetimi, Micro Socket’in hedef kitlesidir.</p><h3>Gördüğüm Karşılaştırma ve Alternatifler</h3><p>Micro Socket, standart WebSocket veya <strong>Socket.IO</strong> gibi çözümlere kıyasla yapısal bir model sunar. Geleneksel WebSocket uygulamalarında her mesaj server’dan <em>tüm bağlantılara</em> gitmek zorunda kalabilir veya geliştirici kendi pub/sub katmanını kurmalıdır. Socket.IO da “rooms” kavramıyla benzer izolasyon sunar, ancak ölçeklenebilirlik ve bağlantı yönetimi açısından ekstra çaba gerektirir.</p><p>Bu alanda bir diğer popüler seçenek, <strong>µWebSockets</strong> gibi yüksek performanslı altsistemlerdir. Örneğin µWebSockets, C++ tabanlı, optimize edilmiş bir WebSocket sunucusudur. Kendi yayın/abone mekanizmasını içerir ve kripto borsalarının yüksek işlem hacimlerini kaldıracak şekilde tasarlanmıştır. Ancak µWebSockets basitçe bir bağlantı sunucusudur; mikro hizmet düzeyi bir organizasyon veya invariants garantisi sağlamaz. Micro Socket ise mimari ilkeleri ve protokolü önceliklendirir.</p><p>Diğer alternatifler olarak <strong>Server-Sent Events (SSE)</strong> veya <strong>GraphQL Subscriptions</strong>, MQTT, gRPC vs. gibi teknolojiler sayılabilir. Ancak SSE tek yönlüdür, WebSocket kadar etkileşimli değildir. MQTT/gRPC farklı protokoller olup genelde IoT veya mikro hizmet içi kullanılır. Micro Socket özellikle WebSocket üzerinde, Node.js/TypeScript ekosisteminde çalışmak için optimize edilmiştir.</p><p>Buraya kadar okuduğunuz için çok teşekkür ederim umarım projeleriniz ve geliştirmelerinizde <strong>Micro Socket</strong> metodolojini kullanarak kullanıcı deneyimi, donanım ve kod optimizasyonunuzu çok effective şekilde kullanmanıza umarım yardımcı olur. Yeni bir metodoloji olduğundan dolayı eksik yada hataları olabilir Micro Socketti open source olarak döküman ve örnek projeleri yayımladım. Hep beraber daha iyi, daha kusursuz hale diğer metodolojilerin olduğu gibi topluluğumuzun geliştireceğine hiç şüphem yok. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=75a83960de24" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Punch Library İnceleme]]></title>
            <link>https://medium.com/@oguzhancart1/punch-library-i%CC%87nceleme-6f9c25b7fc4c?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/6f9c25b7fc4c</guid>
            <category><![CDATA[nodejs-library]]></category>
            <category><![CDATA[payment-gateway]]></category>
            <category><![CDATA[payments]]></category>
            <category><![CDATA[node-library]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Fri, 13 Feb 2026 11:19:28 GMT</pubDate>
            <atom:updated>2026-02-13T11:19:28.016Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, benim yazdığım şimdilik sadece Nodejs tabanlı Punch Library paketinde ilk geliştirmelerim hakkında kısa özet bir yazı yazmak istedim. Hadi hep beraber inceleyelim keyifli okumalar 😊.</p><p>Punch Library, Node.js ortamında çoklu ödeme sağlayıcılarını tek bir birleşik API altında yönetmeyi amaçlayan bir JavaScript/TypeScript kütüphanesidir. Birleşik ödeme (create/capture/cancel gibi) ve webhook işleme API’leri sunar, sağlayıcı katmanında özel işlemleri destekler ve idempotency/correlation anahtarları gibi gelişmiş özellikler sağlar. Stripe, PayPal, Adyen ve Square için hazır destek sunar; diğer sağlayıcılar için ise şablon adapterler içerir. Kurulumu basittir (npm komutu ile) ve Node.js + TypeScript projelerinde kullanılabilir.</p><h3>Kütüphane Amacı ve Temel Özellikler</h3><p>Punch Library’nin amacı, farklı ödeme hizmet sağlayıcılarına (PSP) yapılan çağrıları tek bir <em>payment orchestration</em> API altında toplamaktır. Örneğin geliştirici, provider: &quot;stripe&quot; veya &quot;paypal&quot; gibi sağlayıcı adını belirtip sadece tek bir createPayment(...) yöntemiyle ödemeyi başlatabilir; kütüphane arka planda ilgili PSP’nın API’sını çağırır. Temel özellikler şunlardır:</p><ul><li><strong>Birleşik Ödeme API’si:</strong> Tüm sağlayıcılar için ortak createIntent/createPayment, capturePayment, cancelPayment, refundPayment gibi işlemler sunar. Bu sayede geliştirici tek bir API üzerinden ödeme akışlarını yönetir.</li><li><strong>Sağlayıcıya Özel İşlemler:</strong> executeCustomOperation() ile sağlayıcıların sunduğu diğer REST uç noktalarına erişim imkânı verir (ör. Stripe’da /payment_intents gibi).</li><li><strong>Webhook İşleme:</strong> Sağlayıcılar tarafından gönderilen webhook verilerini doğrulama ve ayrıştırma için parseWebhook() işlevi sağlar. Örneğin Stripe’da imza kontrolü, PayPal’da imza doğrulama gibi işlemler kütüphane tarafından yapılabilir.</li><li><strong>Idempotency ve Korelasyon:</strong> Oluşturulan işlemlerde idempotencyKey ve x-correlation-id gibi anahtarlarla tekrar eden istekleri engelleme ve izleme imkânı vardır. Bu sayede sistemde tekrar eden isteklerin etkisiz kalması veya tutarlı log’lanması sağlanır.</li><li><strong>Ölçeklenebilirlik Özellikleri:</strong> Sağlayıcı başına uygulanan <em>rate limiting</em> (oran sınırlama) ve <em>circuit breaker</em> kontrolü ile aşırı yük altında hata toleransı sunar. Ayrıca webhook için bir <em>dead-letter queue</em> (DLQ) ve bir <em>outbox</em> (geçici olay deposu) mekanizması vardır. Bu mekanizmalar, anlık başarısızlıkları ele alıp yeniden deneme veya kurtarma senaryoları sağlar.</li><li><strong>Sağlayıcı Desteği ve Dokümantasyon:</strong> Çeşitli sağlayıcılar için örnekler ve dökümantasyon bağlantıları mevcuttur. Mevcut implementasyonlar Stripe, PayPal, Adyen ve Square’ı kapsamaktadır; diğer sağlayıcılar (Braintree, Checkout, Razorpay vb.) için ise boş adapter (stub) şablonları sunulur. Böylece ilerde yeni bir sağlayıcı ekleme kolaylaştırılmıştır.</li></ul><p>Bu özellikler sayesinde Punch Library, e-ticaret veya finans uygulamalarında farklı ödeme kanallarını bir arada yönetmek isteyen geliştiriciler için güçlü bir çözümdür. Aşağıda temel özellikler bağlantılı olarak gösterilmiştir:</p><ul><li>Evre 3 kontrol özellikleri (oran sınırlama, devre kesici, webhook DLQ, outbox).</li><li>Stripe: Ödeme niyeti (payment intent) oluşturma, yakalama, iptal, iade; imza doğrulama desteği.</li><li>PayPal: OAuth2 ile token akışı, sipariş oluşturma/kazanma/ödeme iadesi; webhook doğrulama.</li><li>Adyen &amp; Square: Benzer şekilde ödeme akışlarını destekleme ve imza/hmac kontrolü.</li></ul><h3>Kurulum ve Desteklenen Ortamlar</h3><p>Punch Library’nin kurulumu basittir. npm, yarn veya pnpm kullanılarak projeye eklenebilir:</p><pre>npm install punch-library</pre><p>Bu kurulum komutları npm sayfasında belirtilmiştir. Kütüphane Node.js üzerinde, özellikle sunucu tarafında çalışacak uygulamalar için tasarlanmıştır. TypeScript ile yazılmıştır ve Node 20/22 gibi güncel sürümlerde test edilmiştir. Kütüphane tarayıcı (browser) ortamından ziyade Node.js uygulamalarında kullanılır; Node.js ve TypeScript projelerine kolayca entegre edilebilir. Örneğin ES Module veya CommonJS kullanan bir projede import { PunchClient } from &#39;punch-api&#39;; veya require(&#39;punch-api&#39;) ile kullanılabilir.</p><h3>API Yüzeyi (Sınıflar ve Metodlar)</h3><p>Punch Library iki ana sınıf sunar: <strong>PunchClient</strong> ve <strong>Punch</strong>. Her ikisi de punch-api modülünden içe aktarılır. Temel kullanım genellikle PunchClient üzerinden asenkron fonksiyon çağrıları ile yapılır. Örnek olarak:</p><pre>import { PunchClient } from &#39;punch-api&#39;;<br><br>const client = new PunchClient();<br>const payment = await client.createPayment({<br>  provider: &#39;stripe&#39;,<br>  amount: 1000,<br>  currency: &#39;USD&#39;,<br>  idempotencyKey: &#39;unique-key-1&#39;,<br>  // diğer opsiyonel alanlar...<br>});</pre><p>Her iki sınıf da benzer yöntemleri sağlar. Başlıca metotlar şunlardır:</p><ul><li>listProviders(): Aktif (env veya punch.providers.json ile tanımlı) sağlayıcıları listeler.</li><li>listCatalog(): Sağlayıcı katalog bilgilerini döner (desteklenen işlemler, doküman linkleri vs.).</li><li>createIntent(params) / createPayment(params): Yeni bir ödeme talebi (intent/payment) oluşturur. params içinde provider, amount, currency, idempotencyKey, metadata gibi alanlar verilebilir.</li><li>capturePayment({provider, paymentId, ...}): Daha önce oluşturulmuş bir ödemeyi yakalar (ödeme tamamlanır).</li><li>cancelPayment({provider, paymentId, ...}): Ödeme niyetini iptal eder.</li><li>refundPayment({provider, paymentId, amount, ...}): Yakalanmış bir ödemeyi iade eder.</li><li>executeCustomOperation({provider, endpoint, method, bodyType, body, ...}): Sağlayıcının sağladığı özel uç noktaya istek yapar. Örneğin Stripe için /payment_intents gibi istekler bu yolla yapılır.</li><li>parseWebhook(headers, rawBody): Sağlayıcıdan gelen bir webhook isteğini doğrular ve içeriğini ayrıştırır. Örneğin Stripe imza doğrulaması veya Adyen HMAC kontrolü burada yapılır.</li><li><strong>Diğer yardımcı metotlar:</strong> listOutbox(), clearOutbox(), listWebhookDlq(), replayWebhookDlqItem(), clearWebhookDlq(), resilienceSnapshot() gibi yöntemler sisteme dair iç durumu (outbox elemanları, DLQ öğeleri, devre kesici durumu vb.) incelemek için kullanılır.</li></ul><p>Bu metotlar asenkron davranır ve genellikle await ile çağrılır. İsterseniz Punch sınıfını kullanarak benzer işlevleri yerine getirebilirsiniz. Örneğin:</p><pre>import { Punch } from &#39;punch-api&#39;;<br><br>const punch = new Punch({ stateStoreMode: &#39;memory&#39; });<br>const providers = punch.listProviders();</pre><p>Hangi metotların kullanılacağı, uygulamanın ihtiyacına bağlıdır; genel olarak ödeme akışı yönetimi PunchClient ile yapılırken, sistem durumu kontrolü ve listeleme işlemleri Punch sınıfı üzerinden gerçekleştirilebilir.</p><h3>Yaygın Kullanım Örüntüleri</h3><p>Punch Library’yi kullanmanın temel yolu, bir <strong>sunucu tarafı</strong> kodunda kütüphaneyi başlatmak ve ödeme işlemlerini metotlarla çağırmaktır. Örnek bir akış şöyledir:</p><ol><li>Geliştirici bir HTTP endpoint veya arkaplan görevi oluşturur. (Örneğin bir Node.js REST API uygulamasında ödeme oluşturma isteği alır.)</li><li>İstek işlendiğinde, PunchClient.createPayment({ provider, amount, currency, ... }) çağrılır.</li><li>Punch Library ilgili sağlayıcının API’sına istek gönderir. Bu istek arka planda axios veya node-fetch gibi HTTP istemci ile yapılır (bağımlılıklar package.json içinde yer alır).</li><li>Sağlayıcıdan gelen yanıt işlenir (örn. ödeme ID’si döner). Dönen bilgi uygulamaya iletilir.</li><li>Sonrasında gerekirse capturePayment, refundPayment gibi çağrılar yapılarak ödeme tamamlanır veya iptal/iade işlemleri gerçekleştirilir.</li><li>Webhook olayları için gelen POST istekleri kütüphanenin parseWebhook fonksiyonuna yönlendirilerek güvenli şekilde işlenebilir.</li></ol><p>Bu örüntüyü destekleyen bir “kullanım şeması” şu şekilde özetlenebilir:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h78JGNSlKjEIKcZhI7gTXw.png" /></figure><p>Yukarıdaki akış, en temel ödeme senaryosunu gösterir. Punch Library bu arayüzü sağlayarak alttaki sağlayıcı detaylarını geliştiriciden gizler.</p><p><strong>CLI Kullanımı:</strong> Punch Library ayrıca komut satırı arayüzü (CLI) de sunar. Projede npm run cli:link ile punch komutu kullanılabilir hale getirildikten sonra aşağıdaki gibi işlemler yapabilirsiniz:</p><ul><li>punch list – Mevcut sağlayıcı ve yapılandırma bilgilerini listeler.</li><li>punch new &lt;provider&gt; [--key=...] – Yeni bir sağlayıcı yapılandırması ekler (örn. stripe veya paypal) ve .env dosyasına anahtarları kaydeder.</li><li>punch remove &lt;provider&gt; – Bir sağlayıcıyı yapılandırmadan kaldırır.</li><li>punch doctor – .env ve punch.providers.json dosyalarını kontrol eder, eksikleri giderir.</li><li>punch template &lt;provider&gt; – Sağlayıcıya özel işlem şablonları oluşturur (ör. özel custom operation örnekleri).</li></ul><p>CLI, projeye ödeme sağlayıcı eklemeyi, yapılandırmayı ve doğrulamayı kolaylaştırır. CLI kullanımı daha çok geliştirme/ops süreçleri içindir; günlük ödeme akışları için kütüphane fonksiyonları tercih edilir.</p><h3>Basit ve Gelişmiş Kod Örnekleri</h3><h3>Basit Örnek</h3><p>Aşağıda Stripe üzerinden 10.00 USD tutarında bir ödeme oluşturup ardından iade işlemi yapan basit bir örnek verilmektedir:</p><pre>// Basit kullanım: PunchClient ile ödeme oluşturma ve iade<br>import { PunchClient } from &#39;punch-api&#39;;<br><br>async function runPaymentFlow() {<br>  const client = new PunchClient();<br>  // Ödeme oluştur<br>  const payment = await client.createPayment({<br>    provider: &#39;stripe&#39;,<br>    amount: 1000,<br>    currency: &#39;USD&#39;,<br>    idempotencyKey: &#39;unique-key-123&#39;,<br>    metadata: { orderId: &#39;ORD-1001&#39; }<br>  });<br>  console.log(&#39;Payment ID:&#39;, payment.id, &#39;Status:&#39;, payment.status);<br><br>  // Ödemeyi iade et<br>  const refund = await client.refundPayment({<br>    provider: &#39;stripe&#39;,<br>    paymentId: payment.id,<br>    amount: 1000,<br>    currency: &#39;USD&#39;<br>  });<br>  console.log(&#39;Refund Status:&#39;, refund.status);<br>}<br><br>runPaymentFlow().catch(err =&gt; console.error(&#39;Hata oluştu:&#39;, err));</pre><p>Bu örnek, kütüphanenin temel bir kullanımını gösterir: createPayment ile ödeme talebi oluşturulur, alınan payment.id kullanılarak refundPayment yapılır. Hata olması durumunda catch bloğunda yakalanır.</p><h3>Gelişmiş Örnek</h3><p>Aşağıda hem Stripe hem PayPal sağlayıcılarını kullanan, özel bir operasyon (örneğin yeni bir müşteri oluşturma) içeren bir örnek verilmiştir:</p><pre>import { PunchClient } from &#39;punch-api&#39;;<br><br>async function advancedFlow() {<br>  const client = new PunchClient();<br><br>  // 1. Stripe ile ödeme oluştur<br>  const stripePayment = await client.createPayment({<br>    provider: &#39;stripe&#39;,<br>    amount: 5000,<br>    currency: &#39;EUR&#39;,<br>    idempotencyKey: &#39;stripe-ord-77&#39;,<br>    metadata: { orderId: &#39;77&#39; }<br>  });<br>  console.log(&#39;Stripe Payment:&#39;, stripePayment.id, stripePayment.status);<br><br>  // 2. Stripe ile özel operasyon: yeni müşteri oluştur<br>  const customer = await client.executeCustomOperation({<br>    provider: &#39;stripe&#39;,<br>    endpoint: &#39;/customers&#39;,<br>    method: &#39;POST&#39;,<br>    bodyType: &#39;json&#39;,<br>    body: {<br>      email: &#39;user@example.com&#39;,<br>      name: &#39;Test User&#39;<br>    }<br>  });<br>  console.log(&#39;Stripe Customer Created:&#39;, customer.id);<br><br>  // 3. PayPal ile sipariş oluştur (örnek payload)<br>  const paypalIntent = await client.createPayment({<br>    provider: &#39;paypal&#39;,<br>    amount: 2000,<br>    currency: &#39;USD&#39;,<br>    idempotencyKey: &#39;paypal-ord-42&#39;<br>  });<br>  console.log(&#39;PayPal Order ID:&#39;, paypalIntent.id);<br><br>  // 4. Hata durumu: Geçersiz sağlayıcı ile hata gösterimi<br>  try {<br>    await client.createPayment({ provider: &#39;invalid&#39;, amount: 100, currency: &#39;USD&#39; });<br>  } catch (err) {<br>    console.error(&#39;Beklenen Hata:&#39;, err.message);<br>  }<br>}<br><br>advancedFlow().catch(err =&gt; console.error(&#39;Genel hata:&#39;, err));</pre><p>Bu gelişmiş örnekte:</p><ul><li>Hem Stripe hem de PayPal kullanımı gösterilmiştir.</li><li>Stripe üzerinden hem normal ödeme hem de özel customers uç noktası kullanılmıştır.</li><li>Geçersiz sağlayıcı invalid örneklenerek hata yönetimi gösterilmiştir (bu durumda kütüphane bir hata fırlatır).</li></ul><p>Yukarıdaki örnekler kopyala-yapıştır yapılıp doğrudan çalıştırılabilir olup, gerekli PUNCH_* ortam değişkenlerinin (.env dosyasında) ayarlandığını varsayar.</p><p>Punch Library bir ödeme akışı kütüphanesi olduğundan, çeşitli hata ve istisna durumlarıyla karşılaşabilir. Uygulamada hata işlemek için genellikle try/catch blokları kullanılır. Örneğin, sağlayıcı API’si başarısız dönerse (internet hatası, geçersiz API anahtarı, vs.) kütüphane bir istisna (exception) fırlatır ve bu catch ile yakalanmalıdır. Ayrıca, <strong>idempotency</strong> mekanizması sayesinde aynı işlem anahtarıyla tekrar çağırıldığında kütüphane çoğunlukla önceden alınan yanıtı döndürür, bu da çift ödeme yapmayı engeller.</p><ul><li><strong>Yapılandırılmamış sağlayıcı:</strong> Eğer createPayment gibi bir metotla henüz etkinleştirilmemiş bir sağlayıcı kullanılırsa, kütüphane bu durumda hata verir. (Öncesinde CLI ile punch new &lt;provider&gt; komutunun çalıştırılması gerekir.)</li><li><strong>Zaman aşımı veya ağ hatası:</strong> Sağlayıcı çağrılarında ağ kesintisi olursa timeout veya network error hatası alınabilir. Bu durumlarda tekrar denemek için idempotent anahtar kullanılabilir.</li><li><strong>Kapsam dışı tutar/currency:</strong> Saçma tutar veya desteklenmeyen para birimi belirtilirse, sağlayıcının API’si reddedebilir.</li><li><strong>Aynı isteğin tekrarı:</strong> Aynı idempotencyKey ile farklı istek göndermek, genellikle önceki isteğin sonucunu tekrar almanızı sağlar; geliştirici bu anahtarı mantıklı seçmelidir.</li></ul><p>Hata yönetimi uygulamada kritik önemdedir. Örneğin capturePayment metodu, başarısız yakalama durumunda ayrı bir sonuç verebilir. Ayrıca doctor komutu (CLI) kritik yapılandırma hataları için ayrı çıkış kodları döner. Uygulamayı üretime taşıyorken tüm bu hataların test edildiğinden ve uygun catch bloklarıyla yakalandığından emin olunmalıdır.</p><h3>Performans ve Ölçeklenebilirlik</h3><p>Punch Library, çoklu sağlayıcı çağrılarını yönettiğinden <strong>ağ gecikme</strong> (latency) ve <strong>rate limiting</strong> gibi performans konularına dikkat edilmelidir. Her createPayment vb. çağrısı gerçek bir HTTP isteği gerektirir; bu nedenle yüksek hacimli sistemlerde bu isteklerin eşzamanlı işlenmesi gerekebilir. Kütüphane, sağlayıcı başına istek hızını sınırlayan bir oran sınırlama (rate limiter) içerir. Geliştirici bu ayarları ihtiyaç halinde güncelleyebilir.</p><p>Bunun yanı sıra kütüphane <strong>devre kesici (circuit breaker)</strong> mekanizması sayesinde bir sağlayıcının sürekli hatalı olması durumunda o sağlayıcıya yapılan çağrıları geçici olarak durdurur. Bu sayede sistem daha kararlı çalışır. Ayrıca webhook olaylarında tekrarlayan postaları engellemek için idempotent saklama kullanan <em>dead-letter queue</em> ve <em>outbox</em> mekanizmaları da işlevsel güvenlik sağlar. Kısacası, Punch Library yüksek işlem hacimleri için hazır kontrol mekanizmalarına sahiptir; ancak entegrasyon yapılan servislerin hız sınırları (örneğin Stripe dakikada X istek sınırı) göz önünde bulundurulmalıdır.</p><p>Performans testleri için test/payment-webhook-idempotency.spec.ts, test/payment-provider-resilience.spec.ts gibi testler mevcuttur. Gerçek dünyada da olası gecikmeler ve başarısızlık senaryolarının ele alındığından emin olun.</p><h3>Uyumluluk ve Bağımlılıklar</h3><p>Punch Library, çekirdek olarak yalnızca Node.js (ve onun modül sistemi) ile uyumludur. TypeScript ile yazıldığı için TS projelerinde tip desteği sunar; ancak JavaScript projelerinde de require veya import yoluyla kullanılabilir. CI süreçleri Node 20 ve 22 ile test edilmiştir. Kütüphane bir server-side ortamda (Node) çalıştırılmak üzere tasarlanmıştır; frontend/browser için optimize edilmiştir.</p><p>Bağımlılıklar açısından package.json içinde HTTP istekleri için axios veya benzeri paketler ve yapılandırma için dotenv gibi modüller yer alabilir (paket punch-api’nin bağımlılıkları arasında). Uygulamanıza özel tüm PUNCH_* ortam değişkenleri (.env dosyası) doğru ayarlanmalıdır. Desteklenen sağlayıcılar için gerekli her bir anahtar ve uç nokta yapılandırma, README’deki <strong>Environment Variables</strong> kısmında listelenmiştir. Örneğin Stripe için PUNCH_STRIPE_API_KEY, PayPal için PUNCH_PAYPAL_CLIENT_ID/SECRET gibi değişkenler gerekir. Diğer sağlayıcılar için _mock_ içeren anahtarlar kullanılarak test moduna geçilebilir.</p><p>Bağımlılıklar genel olarak güncel tutulmalı, çünkü ödeme sağlayıcılarının kitaplık sürümleri güncellemeleri sık olabilir. Punch Library’nin kendisi MIT lisanslıdır, dolayısıyla ticari ve açık kaynak projelerinde serbestçe kullanılabilir.</p><h3>Test ve CI Önerileri</h3><p>Punch Library geliştirme sürecinde kapsamlı testler içerir. Örneğin test/ klasörü altında <strong>birim testleri</strong>, sağlayıcı simulasyonları, <strong>e2e testleri</strong> ve CLI testleri yer alır. Ödemelerin idempotency, webhook işleme, outbox/DLQ davranışları gibi senaryolar test edilmiştir. Ayrıca GitHub Actions üzerinde Node 20/22 için entegrasyon ve e2e testleri çalıştıran bir CI altyapısı kuruludur.</p><p>Kendi projelerinizde de benzer biçimde:</p><ul><li>Ödeme akışları için <em>mock sağlayıcılar</em> veya sandbox ortamı kullanarak entegrasyon testleri yapın.</li><li>Webhook işleme kodlarını test edin (örneğin gerçek Stripe webhook örnek yükü).</li><li>CI hattına yapılandırma kontrollerini (örneğin .env eksik anahtarlar için uyarı) dahil edin.</li><li>E2E testleri mümkünse gerçek ödeme sağlayıcı (test modu) ile mutlaka kontrol edin.</li></ul><p>Bu sayede olası hatalar önceden yakalanır. Punch Library’nin testlerini örnek alarak benzer isimlendirme ve kapsamda testler ekleyebilirsiniz. Buraya kadar okuduğunuz için çok teşekkür ederim. Hemen paket için hemde makale için aklınıza takıln sorun varsa, öneriniz yada tavsiyeniz olursa seve seve her türlü platformlardan çekinmeden ulaşabilirisiniz. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6f9c25b7fc4c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Web Frameworkleri AI Entegrasyonun]]></title>
            <link>https://medium.com/@oguzhancart1/web-frameworkleri-ai-entegrasyonun-f355f615ae18?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/f355f615ae18</guid>
            <category><![CDATA[next-llm]]></category>
            <category><![CDATA[nuxt-llm]]></category>
            <category><![CDATA[angular-llm]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Wed, 11 Feb 2026 21:41:02 GMT</pubDate>
            <atom:updated>2026-02-11T21:41:02.129Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar bu yazımda frontend frameworklerin AI entegrasyonu ve gelişimlerini inceleyeceğiz. Modern web frameworkleri AI entegrasyonuna odaklanmaya başladı. Angular, React, Vue, Next.js ve Nuxt.js gibi araçlar, OpenAI, Google Gemini veya Hugging Face gibi LLM (Büyük Dil Modeli) hizmetlerini projelere kolayca eklemeyi sağlayan yeni kütüphaneler ve yönergeler sunuyor. Örneğin Angular’ın resmi dokümantasyonu, Genkit (genel AI iş akış kütüphanesi), Firebase AI Logic ve Google Gemini API gibi araçlarla entegrasyonu gösteriyor. React ve Vue dünyasında ise topluluk destekli paketler ve örnek uygulamalar, OpenAI SDK veya Fetch kullanarak chat tamamlama ve embedding gibi işlemleri nasıl yapacağımızı açıklıyor. Nuxt.js özelinde hem LLM için dokümantasyon formatı (LLMs.txt) hem de nuxt-chatgpt gibi modüller öne çıkıyor. Aşağıda her bir framework için kısa bir tanıtım, örnek kod, avantaj/dezavantajlar ve öneriler ile bir karşılaştırma tablosu bulabilirsiniz. Ayrıca istemci vs sunucu LLM çağrısı ve Nuxt LLM entegrasyonu için mermaid diyagramları eklenmiştir.</p><h3>Angular</h3><p>Angular, güçlü bir yapı ve zengin tip desteği ile <strong>genel amaçlı bir web framework</strong>’üdür. Google’ın yayınladığı “Build with AI” rehberinde, Angular uygulamalarına Genkit, Firebase AI Logic ve Google Gemini API gibi yapay zeka araçlarının nasıl entegre edileceği anlatılıyor. Bu sayede Angular projelerinde özel sunucu tarafı Genkit akışları oluşturmak veya istemci tarafında Firebase AI üzerinden modeller kullanmak mümkün. Örneğin Genkit ile Node.js sunucuda şu şekilde bir yapay zeka çağrısı yapabilirsiniz:</p><pre>import { genkit } from &#39;genkit&#39;;<br>import { googleAI, gemini20Flash } from &#39;@genkit-ai/googleai&#39;;<br>const ai = genkit({ plugins: [googleAI()], model: gemini20Flash });<br>// Sunucu tarafında (ör. express.js):<br>app.post(&#39;/api/ai&#39;, async (req, res) =&gt; {<br>  const result = await ai.generate(&#39;Merhaba AI, nasılsın?&#39;);<br>  res.json({ text: result.text });<br>});</pre><p>Ayrıca Angular istemcisi, HttpClient kullanarak API rotasını çağırarak kullanıcıya yanıt getirebilir:</p><pre>@Injectable({providedIn: &#39;root&#39;})<br>export class AiService {<br>  constructor(private http: HttpClient) {}<br>  ask(prompt: string) {<br>    return this.http.post&lt;{text: string}&gt;(&#39;/api/ai&#39;, { prompt });<br>  }<br>}</pre><p>Angular’ın katı yapısı ve güçlü tip desteği büyük projelerde güven sağlar. SSR (Angular Universal) ile sunucu tarafı akışları eklemek kolaydır, böylece API anahtarları güvenle sunucuda saklanabilir. Google’ın rehberiyle uyumlu araçlar (Genkit, Gemini) sayesinde entegre çözümler mevcuttur. Ancak Öğrenme eğrisi daha diktir. Hem istemci hem sunucu tarafı kodu yönetilmesi gerektiği için küçük projelerde fazla karmaşık olabilir. En İyi Uygulamalar: API anahtarlarını sunucuda tutun, istemci sadece ihtiyaç duyduğu veriyi ve istemci tarafı mantığı içersin. Angular için HttpClient ile backend’e güvenli istek yapmak yaygın bir yaklaşımdır.</p><h3>React</h3><p>React, yalnızca UI oluşturmak için kullanılan hafif bir kütüphanedir. React’in kendisi AI için özel bir araç sunmaz; ancak OpenAI ve Hugging Face gibi servisler React uygulamalarında rahatlıkla kullanılabilir. Topluluk örneklerinde genellikle bir Node.js sunucu veya serverless işlevi aracılığıyla LLM çağrısı yapılır. Örneğin bir React komponentinde button’a basıldığında OpenAI çağıran bir örnek:</p><pre>// JavaScript (React bileşeni)<br>function ChatComponent() {<br>  const [prompt, setPrompt] = useState(&#39;&#39;);<br>  const [reply, setReply] = useState(&#39;&#39;);<br>  async function sendPrompt() {<br>    const res = await fetch(&#39;/api/chat&#39;, {<br>      method: &#39;POST&#39;,<br>      headers: { &#39;Content-Type&#39;: &#39;application/json&#39; },<br>      body: JSON.stringify({ message: prompt })<br>    });<br>    const data = await res.json();<br>    setReply(data.choices[0].message.content);<br>  }<br>  return (<br>    &lt;div&gt;<br>      &lt;input value={prompt} onChange={e =&gt; setPrompt(e.target.value)} /&gt;<br>      &lt;button onClick={sendPrompt}&gt;Gönder&lt;/button&gt;<br>      &lt;p&gt;{reply}&lt;/p&gt;<br>    &lt;/div&gt;<br>  );<br>}</pre><p>TypeScript versiyonu da benzer bir mantıkla yazılır:</p><pre>// TypeScript (React bileşeni)<br>interface ChatResponse { choices: { message: { content: string } }[]; }<br>async function fetchReply(prompt: string): Promise&lt;string&gt; {<br>  const res = await fetch(&#39;/api/chat&#39;, {<br>    method: &#39;POST&#39;,<br>    headers: { &#39;Content-Type&#39;: &#39;application/json&#39; },<br>    body: JSON.stringify({ message: prompt })<br>  });<br>  const data: ChatResponse = await res.json();<br>  return data.choices[0]?.message.content || &#39;&#39;;<br>}</pre><p><em>Dikkat</em>: Üstteki örneklerde API anahtarları istemciye çıkarılmamalıdır. React projelerinde genellikle /api klasöründe bir sunucu işlevi (Node) oluşturularak OpenAI/AI çağrısı yapılır. Örneğin Next.js veya Express tabanlı bir route üzerinden gizli anahtarla istek yapmak sekötürde yaygındır. İstemcinin doğrudan SDK (örn. openai npm paketi) kullanmasına izin verecek bir mod kullanılabilir, ancak dangerouslyAllowBrowser: true gibi bir seçenekle anahtar ifşa olmamalıdır. DevExtreme’in Vue/React entegrasyon rehberi de tarayıcıda OpenAI kullanımı için uyarıda bulunur.</p><p>React, esneklik sağlar ve çok sayıda örnek ile topluluk kütüphanesi mevcuttur. UI bileşenleri kolaylıkla oluşturulur. Ancak React tek başına frontend odaklıdır; güvenli bir AI entegrasyonu için ek sunucu kodu (ör. Next.js, Express, AWS Lambda vb.) gereklidir. Sunucu tarafı işlemleri React veya Node ile ayrı bir serviste yönetmek gerekir. İyi bir uygulama, istemci tarafında sadece kullanıcı arayüzünü tutmak, LLM çağrılarını arka planda güvenli bir route üzerinden yapmaktır. Next.js API rotası veya bağımsız backend kullanımı tercih edilmelidir.</p><h3>Next.js</h3><p>Next.js, React tabanlı tam yığın bir framework’tür ve AI entegrasyonuna özel avantajları vardır. Yeni sürümler (Next.js 14/15) <strong>App Router</strong>, <strong>Server Components</strong> ve <strong>Edge Functions</strong> gibi özelliklerle, akışlı yanıtlama ve daha ince kontrollü sunucu tarafı iş akışları sunar. Vercel’in AI SDK’sı da Next.js’e özel kolaylıklar sağlar. Örneğin bir API rota dosyasında OpenAI çağrısı şöyle yazılabilir:</p><pre>import { NextRequest, NextResponse } from &#39;next/server&#39;;<br>export async function POST(req: NextRequest) {<br>  const { message } = await req.json();<br>  const res = await fetch(&#39;https://api.openai.com/v1/chat/completions&#39;, {<br>    method: &#39;POST&#39;,<br>    headers: {<br>      &#39;Authorization&#39;: `Bearer ${process.env.OPENAI_API_KEY}`,<br>      &#39;Content-Type&#39;: &#39;application/json&#39;<br>    },<br>    body: JSON.stringify({<br>      model: &#39;gpt-4&#39;,<br>      messages: [{ role: &#39;user&#39;, content: message }]<br>    })<br>  });<br>  const data = await res.json();<br>  return NextResponse.json({ reply: data.choices[0].message.content });<br>}</pre><p>Bu rotayı bir React bileşeni veya sayfa içinde fetch(&#39;/api/chat&#39;) ile çağırabilirsiniz. Next.js’in SSR/SSG yetenekleri, request/response akışını optimize etmenize imkân tanır; örneğin kullanıcı bir sayfayı ilk açtığında sunucu bu API’yi tetikleyip içeriği hazır dönebilir.</p><p>Next.js’in yerleşik API routes (veya route.ts dosyaları) anahtarları korumanızı sağlar, Edge Runtime performansı yükü azaltır ve React bileşenleriyle uyumludur. Çok sayıda resmi örnek ve topluluk desteği var. Ancak Next.js’e özel ve öğrenilmesi gereken bazı yapılar var; sadece client-side React kadar hafif değildir. Karmaşık AI işlevlerinde (streaming, stateful agent vs.) ek kütüphaneler (ör. Vercel AI SDK, LangChain.js) gerekebilir. En iyi uygulama, verimli cache/stream kullanımı ve hata yönetimi ile güvenli API çağrıları yapmaktır.</p><h3>Vue</h3><p>Vue 3, reaktif kompozisyon API’si sayesinde AI entegrasyonunda esneklik sunar. Vue’nun kendisi LLM’lere dair özel bir altyapı sağlamaz, ancak OpenAI’nin JavaScript SDK’sı veya Fetch ile kolayca entegre edilebilir. Örneğin script setup kullanan bir bileşende:</p><pre>&lt;script setup lang=&quot;ts&quot;&gt;<br>import { ref } from &#39;vue&#39;;<br>import { OpenAI } from &#39;openai&#39;;<br>const prompt = ref(&#39;&#39;);<br>const reply = ref(&#39;&#39;);<br>const ai = new OpenAI({ dangerouslyAllowBrowser: false, apiKey: import.meta.env.VITE_OPENAI_KEY });<br>async function sendPrompt() {<br>  const res = await ai.chat.completions.create({<br>    model: &#39;gpt-4&#39;,<br>    messages: [{ role: &#39;user&#39;, content: prompt.value }]<br>  });<br>  reply.value = res.choices[0]?.message?.content || &#39;&#39;;<br>}<br>&lt;/script&gt;<br>&lt;template&gt;<br>  &lt;input v-model=&quot;prompt&quot; placeholder=&quot;Sorunuz...&quot; /&gt;<br>  &lt;button @click=&quot;sendPrompt&quot;&gt;Gönder&lt;/button&gt;<br>  &lt;p&gt;Cevap: {{ reply }}&lt;/p&gt;<br>&lt;/template&gt;</pre><p>(Dikkat: dangerouslyAllowBrowser: true özelliği tarayıcıda API anahtarınızı açığa çıkarır. Prodüksiyonda anahtarı istemciden uzak tutmak için ya sunucu kullanın ya Nuxt gibi SSR ortamlarında Nitro API rotaları tercih edin.)</p><p>Vue’nun öğrenmesi kolaydır ve Nuxt.js ile SSR desteği vardır. DevExtreme’in örneğinde de görüldüğü gibi OpenAI SDK ile Vue’da chat tamamlama ve embedding işlemleri benzer şekilde yapılabiliyor. Ancak Anahtar güvenliği ve CORS, React’tekiyle benzer sorunlardır – genel çözüm yine sunucu katmanı eklemektir. En iyi uygulama, küçük Vue bileşenlerinde sadece UI mantığını tutmak, arka plandaki API çağrılarını uygun şekilde yönetmektir. Örneğin yukarıdaki örnek Vue bileşeni doğrudan openai modülünü kullanıyor; alternatif olarak fetch(&#39;/api/ai&#39;) şeklinde Nuxt/Express rotası kullanabilirsiniz.</p><h3>Nuxt.js</h3><p>Nuxt.js, Vue üzerine kurulmuş bir meta-framework olarak SSR/SSG özellikleriyle ön plana çıkar. Yapay zekada iki açıdan önemli gelişmeleri var:</p><ul><li><strong>Nuxt LLMs.txt / nuxt-llms modülü:</strong> Nuxt ekibi, sitenizin içeriğini LLM’ler için optimize edilmiş bir formatta sunmaya başladı. “llms.txt” belgesi, site içeriğinin yapay zeka asistanları tarafından anlaşılmasını kolaylaştırır. @nuxt/content modülü ile nuxt-llms entegre edilirse, http://site.com/llms.txt gibi rotalar otomatik üretilir ve AI araçlarına gönderilir. Örneğin nuxt.config.ts içinde şöyle ayarlanır:</li></ul><pre>export default defineNuxtConfig({<br>  modules: [&#39;@nuxt/content&#39;, &#39;nuxt-llms&#39;],<br>  llms: {<br>    domain: &#39;https://ornek.com&#39;,<br>    title: &#39;Örnek Sitem&#39;,<br>    description: &#39;AI dostu içerik üretimi örneği&#39;<br>  }<br>});</pre><p>Bu sayede ChatGPT veya Windsurf gibi AI araçları sitenizin dokümantasyonunu doğrudan öğrenebilir.</p><ul><li><strong>Nuxt AI Chat modülleri:</strong> Ayrıca Nuxt topluluğu, OpenAI ve Vercel AI SDK’sını kolayca kullanmaya yarayan modüller geliştirdi. Örneğin nuxt da modülü, useChatGPT() adında bir composable sunar. Konfigürasyonda bir satır modules: [&#39;nuxt-chatgpt&#39;] ekleyip API anahtarını belirtince, aşağıdaki gibi çağrı yapabilirsiniz:</li></ul><pre>// nuxt.config.ts<br>export default defineNuxtConfig({<br>  modules: [&#39;nuxt-chatgpt&#39;],<br>  chatgpt: { apiKey: process.env.OPENAI_KEY }<br>});</pre><p>Ardından bir Vue bileşeninde const chat = useChatGPT() ile chat() veya chatCompletion() fonksiyonlarını çağırabilirsiniz. Örneğin:</p><pre>const chat = useChatGPT();<br>const response = await chat.chat({ message: &#39;Merhaba!&#39; });<br>console.log(response); // GPT yanıtı</pre><p>Bu modül istekleri Nuxt Nitro sunucusundan yönlendirdiği için API anahtarı istemciye gitmez. Gerçek zamanlı tepki (stream) için chatCompletionStream() fonksiyonu da mevcut. <strong>Artılar:</strong> Nuxt CLI ile gelen Nitro altyapısı sayesinde, ek herhangi bir sunucu yazmadan da güvenli AI çağrıları yapabilirsiniz. Bu tip modüller Nuxt 3 ile tamamen uyumludur ve toplulukça desteklenir. <strong>Eksiler:</strong> Yeni modüller oldukları için dokümantasyon ve topluluk desteği biraz sınırlı olabilir. Yapay zeka modüllerinde karışıklığı önlemek için Nuxt yapılandırmasını (runtimeConfig vb.) iyi ayarlamak gerekir. Örneğin yukarıdaki örnekte process.env.OPENAI_KEY kullanırken Nuxt’un runtimeConfig özelliğiyle anahtarı aktarabilirsiniz.</p><h3>Nuxt LLM (LLMs.txt) Entegrasyonu</h3><p>Nuxt’un LLMs.txt özelliği, sitenizin içeriğini AI araçlarına sunmak için geliştirilmiştir.</p><p>Bu şemada Nuxt içerik modülü vasıtasıyla sayfa içerikleri toplanır, nuxt-llms modülü /llms.txt gibi formatlara dönüştürür ve böylece ChatGPT veya GitHub Copilot gibi asistanlar Nuxt bilgilerini kullanabilir. Örneğin Nuxt Docs, AI araçlarında bu dosyaları referans olarak kullanmayı önermektedir.</p><p>| <strong>Embedding (örnek)</strong> | js&lt;br&gt;fetch(&#39;/api/embed&#39;, {&lt;br&gt; method: &#39;POST&#39;,&lt;br&gt; headers: {&#39;Content-Type&#39;: &#39;application/json&#39;},&lt;br&gt; body: JSON.stringify({ text: text })&lt;br&gt;}).then(r =&gt; r.json()).then(data =&gt; console.log(data.embedding)); | ts&lt;br&gt;import OpenAI from &#39;openai&#39;;&lt;br&gt;const ai = new OpenAI({ apiKey: &#39;YOUR_KEY&#39; });&lt;br&gt;async function embed(text: string) {&lt;br&gt; const res = await ai.embeddings.create({&lt;br&gt; model: &#39;text-embedding-3-small&#39;, input: text&lt;br&gt; });&lt;br&gt; return res.data[0].embedding;&lt;br&gt;} |</p><p>Bu örnek JavaScript kodunda fetch ile kendi API rotasını çağırırken, TypeScript örneğinde openai SDK’sı kullanarak direkt model fonksiyonu çağrılıyor. Her iki durumda da API anahtarını <strong>güvenli bir şekilde</strong> sunucuda saklamak önemlidir. Buraya kadar okduğunuz için çok teşekkür ederim. Kısaca özetlemek gerekirse frameworkler AI bu kadar hızlı gelişmi ve araçların yarışında frameworkler biraz zayıf kaldı diyebiliriz. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f355f615ae18" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Nuxt 4.3.1: Yenilikleri]]></title>
            <link>https://medium.com/@oguzhancart1/nuxt-4-3-1-yenilikleri-2c76f5143e1c?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/2c76f5143e1c</guid>
            <category><![CDATA[nuxt-4]]></category>
            <category><![CDATA[nuxt-new-version]]></category>
            <category><![CDATA[nuxtjs]]></category>
            <category><![CDATA[nuxtjs-4]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Wed, 11 Feb 2026 11:41:13 GMT</pubDate>
            <atom:updated>2026-02-11T11:41:13.864Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, bu başlıktanda anlayabileceğiniz üzere nuxt 4.3.1 version inceleyeceğiz. Dört gün önce yanınlanan yeni version relase inceldiğimiz zaman Nuxt 4.3.1, Nuxt 4.3 ana sürümündeki iyileştirmeleri içeren planlı bir yama güncelemesi olduğunu anlıyoruz. Bu sürümde routeRules aracılığıyla <strong>layout</strong> yönetimi, <strong>ISR/SWR</strong> önbellekleme (<em>Stale-While-Revalidate</em>), sürüklenebilir hata penceresi ve #server alias’ı gibi önemli özellikler eklendi. Performans da önemli ölçüde arttı: derlemeyi hızlandıran hook filtreleri, SSR stil optimizasyonu ve Webpack/Rspack ile kritik CSS’in satır içi gömme desteği geldi. Ayrıca Nuxt ekibi, Nuxt v3 desteğini 31 Temmuz 2026’ya kadar uzatarak v3.21.0 ile 4.3’teki yeniliklerin bir kısmını geri taşıdı.</p><ul><li><strong>Route Rule Layouts:</strong> Artık nuxt.config.ts içinde routeRules tanımıyla belirli rotalara kolayca layout atanabiliyor. Örneğin:</li></ul><pre>export default defineNuxtConfig({<br>  routeRules: {<br>    &#39;/admin/**&#39;: { appLayout: &#39;admin&#39; },<br>    &#39;/auth/**&#39;:  { appLayout: &#39;login&#39; }<br>  }<br>})</pre><p>Bu sayede pek çok sayfada ayrı definePageMeta kullanmak yerine merkezi bir şekilde layout yönetimi yapılabiliyor.</p><ul><li><strong>Katmanlardan Modül Devre Dışı Bırakma:</strong> Ortak bir “layer” (katman) kullanılırken, istemediğiniz modülleri false atayarak devre dışı bırakabilirsiniz. Örneğin, paylaşılan katmanda @nuxt/image modülünü kapatmak için:</li></ul><pre>export default defineNuxtConfig({<br>  extends: [&#39;../shared-layer&#39;],<br>  image: false<br>})</pre><p>Bu, gereksiz modüllerin yüklenmesini önleyip derleme performansını iyileştirir.</p><ul><li><strong>Route Grupları ve Layout Props:</strong> Parantezli klasörlerle ((protected)/) tanımlanan rota grupları, useRoute().meta.groups ile yakalanabiliyor. Örneğin pages/(admin)/dashboard.vue dosyasının meta bilgisi { groups: [&#39;admin&#39;] } içerir. Ayrıca yeni setPageLayout composable’ı, layout’a ikinci parametre olarak props geçilmesini destekliyor. Örneğin:</li></ul><pre>export default defineNuxtRouteMiddleware(() =&gt; {<br>  setPageLayout(&#39;admin&#39;, { sidebar: true, theme: &#39;dark&#39; })<br>})</pre><p>Bu sayede layout’a sidebar veya theme gibi değerler verilebilir.</p><ul><li><strong>server Alias:</strong> Sunucu tarafı (server/) klasöründeki dosyalar, #server alias’ı ile sabit bir yol üzerinden içe aktarılabiliyor. Örneğin:</li></ul><pre>import { helper } from &#39;#server/utils/helper&#39;</pre><p>şeklinde kullanabilirsiniz. Bu, karmaşık nispi yolları önlüyor ve istemci kodundan sunucu koduna yanlışlıkla erişimi engelliyor.</p><ul><li><strong>Sürüklenebilir Hata Overlay’i:</strong> Geliştirme modunda gösterilen hata ekranı (error overlay) artık sürüklenebilir ve küçültülebilir. Overlay, ekran köşelerine sabitlenebiliyor ve yeniden yüklemeler arasında konumunu koruyor. Bu sayede hatayı incelerken ekranınıza tam erişiminiz oluyor.</li><li><strong>Asenkron Build Eklentileri:</strong> Nuxt modülü yazarları, derleme sırasında eklenti (plugin) eklerken async fonksiyon kullanabilir. Örneğin:</li></ul><pre>export default defineNuxtModule({<br>  async setup() {<br>    addVitePlugin(() =&gt; import(&#39;plugin-a&#39;).then(m =&gt; m.default()))<br>    addWebpackPlugin(() =&gt; import(&#39;plugin-b/webpack&#39;).then(m =&gt; m.default()))<br>  }<br>})</pre><p>Bu sayede yalnızca ihtiyaç halinde eklenti yüklemesi yapılır, böylece derleme zamanı ve kod yüklemesi azalır.</p><ul><li><strong>Inline Critical CSS:</strong> Geleneksel sadece Vite’da olan “kritik CSS satır içi gömme (inlineStyles)” özelliği artık Webpack ve Rspack için de destekleniyor. Bu, önemli stil kurallarının doğrudan HTML’ye dahil edilmesine izin vererek Core Web Vitals (ör. LCP) gibi metrikleri iyileştirmeye yardımcı olur.</li><li><strong>Performans İyileştirmeleri:</strong> Derleme süreçleri hızlandırıldı. İç plugin’ler artık gereksiz hook’ları filtreleyerek çalışıyor, SSR stil işleme eklentisi (<strong>nuxt:ssr-styles</strong>) çok daha hızlı hale getirildi ve katman alias dönüşümleri (layer alias) Vite tarafından yerel olarak yapıldığı için Nuxt tarafında atlanıyor. Ek olarak, routeRules kuralları yeni rou3 kütüphanesiyle istemci paketine derlenip radix3 ihtiyacı ortadan kaldırıldı, böylece uygulama manifesti istekleri azaltıldı. Bu değişiklikler büyük projelerde güncelleme süresini kısaltıyor.</li><li><strong>Diğer Değişiklikler:</strong> Ayrıca Nuxt 4.3.1’de pek çok hata giderildi (ör. head bileşen deduplikasyonu, async data reaktivitesi, useCookie sayısal çözümleme gibi). TypeScript tarafında, sunucu tsconfig.json’una noUncheckedIndexedAccess: true varsayılanı eklendi (daha sıkı tip kontrolü için). createError API’sinde ise eski statusCode/statusMessage yerine status/statusText kullanımı teşvik ediliyor.</li></ul><h3>Yeni Dosya Yapısı ve Nitro Mimarisi</h3><p>Nuxt 4 ile birlikte projelerin varsayılan yapısı değişti. Artık uygulama kodunuz genellikle app/, layouts/, pages/, components/, composables/, server/ ve shared/ gibi klasörlerde düzenleniyor (eskiden kök dizinde olan dosyalar app/ altına taşındı). Ancak eski yapıyı korumak da mümkün: Nuxt, eski şemayı algılayarak çalışmaya devam eder.<br>Sunucu tarafında Nuxt’un çalışma motoru <strong>Nitro</strong>’dur. Nitro, h3 altyapısını kullanır ve uygulamanızı Node.js, Deno, Cloudflare Workers, Vercel Edge gibi çok çeşitli ortamlarda çalıştırabilmenizi sağlar. Bu sayede hem klasik bir Node sunucusunda hem de &quot;edge&quot; ortamlarında (örn. Cloudflare, Netlify, Vercel) aynı kodu kullanarak SSR/SSG yapabilirsiniz.</p><h3>Yönlendirme ve ISR/SSG</h3><p>Nuxt 4’te yönlendirme hâlâ dosya (file-based) sistemi ile yönetilirken, <strong>routeRules</strong> özelliği ile her rotaya özel önbellekleme ve yönlendirme kuralları tanımlanabilir. Örneğin:</p><pre>export default defineNuxtConfig({<br>  routeRules: {<br>    &#39;/&#39;:      { prerender: true },      // Sayfayı statik oluştur<br>    &#39;/api/*&#39;: { cache: { maxAge: 3600 }},// 1 saat önbellek<br>    &#39;/old&#39;:   { redirect: { to: &#39;/new&#39;, statusCode: 301 }}<br>  }<br>})</pre><p>Nitro’daki routeRules, her rota için SSR, statik oluşturma, önbellek veya yönlendirme gibi davranışları ayarlamanızı sağlar. Nuxt 4.3 ise bu altyapıyı genişleterek ISR (Önbellek Eskiyip Yenilenme) ve SWR senaryolarında da çalışma imkânı sundu. Örneğin belirli bir rota için isr: 3600 ayarlayarak saatlik önbellek güncellemesi yapılabilir. Bu sayede navigasyonlar arasında ağ çağrıları azalarak kullanıcı deneyimi iyileşir. Yeni <strong>route group</strong> özelliğiyle (protected)/ gibi parantezli dizinlerdeki sayfalar meta bilgisine dahil edilip middleware’da kontrol edilebilir.</p><h3>Composables ve Sayfa Meta</h3><p>Nuxt 4.3 itibarıyla composable (yeniden kullanılabilir fonksiyon) setPageLayout, route grupları gibi özellikler genişletildi. setPageLayout artık ikinci parametre olarak props alabiliyor; bu, yukarıda verilen örnekteki gibi layout’ınıza dinamik değerler gönderebilmenize olanak tanır. Ayrıca, Nuxt 4 ile gelen useAsyncData ve useFetch fonksiyonları, birden fazla komponent aynı anahtarı kullandığında veriyi otomatik paylaşma, bileşen kapanınca temizlik ve reaktif anahtar kullanma gibi geliştirmeler içeriyor. Bu sayede birden fazla yerde aynı API çağrısını tekrar etmek yerine önbellekten yararlanabilir veya anahtarı değiştirerek otomatik yenileme tetikleyebilirsiniz. (Bu geliştirmeler Nuxt 3’ün ilerleyen sürümlerinde kademeli olarak sunulmuş, v4’te varsayılanları değişmiştir.)</p><h3>Modüller ve Katmanlar</h3><p>Nuxt 4 ile modül geliştirme de kolaylaşıyor. Katman (layer) sisteminde artık bazı modüller false yapılarak kapatılabiliyor. Bu, paylaşılan konfigürasyon katmanlarında ihtiyacınız olmayan modülleri kaldırmanızı sağlar. Örneğin bir layer içinde image: false yazmak, @nuxt/image modülünü tamamen devre dışı bırakır. Ayrıca Nuxt 4’te modül yazarları asenkron setup fonksiyonlarıyla eklentileri dinamik yükleyebilir, böylece yalnızca gerçekten gerekli durumlarda kod indirip çalıştırılır.</p><p>AI odaklı bir senaryo olarak Nuxt Content ile entegre çalışan <strong>Nuxt LLMs</strong> modülü öne çıkıyor. nuxt-llms paketini ekleyerek sitenizde yapay zekâ dostu içerik dosyaları (<em>llms.txt</em> gibi) oluşturabilirsiniz. Örneğin:</p><pre>npm install nuxt-llms</pre><p>şeklinde yükledikten sonra nuxt.config.ts’de:</p><pre>export default defineNuxtConfig({<br>  modules: [&#39;@nuxt/content&#39;, &#39;nuxt-llms&#39;],<br>  llms: {<br>    domain: &#39;oguzhancart.dev&#39;,<br>    title: &#39;Page Title&#39;,<br>    description: &#39;Page Descrition&#39;<br>  }<br>})</pre><p>ayarıyla /llms.txt dosyası otomatik oluşturulur. Ayrıca nuxt-llms ile content/ içeriğinizi LLM’lere uygun şekilde filtreleyebilir, sitenize raw/&lt;yol&gt;.md gibi ham Markdown endpoint’leri ekleyebilirsiniz. Bu özellikler, özellikle içerik bazlı AI iş akışları için kullanışlıdır.</p><h3>TypeScript Desteği</h3><p>Nuxt 4’te TypeScript desteği önemli ölçüde geliştirilmiştir. Artık uygulama kodu, sunucu kodu, paylaşılan kod ve Nuxt kendi builder kodu için ayrı TS projeleri oluşturulur. Böylece IDE yardımcılığı ve tip çıkarımı daha isabetli olur. Örneğin Nuxt 4’te kök dizine sadece <strong>tek bir</strong> tsconfig.json koymanız yeterlidir ve diğer konfigürasyonlar otomatik olarak oluşur. Ayrıca tsconfig.server.json’da noUncheckedIndexedAccess: true varsayılanı aktif edilerek (numaralandırılmamış erişime karşı sıkı tip kontrolleri), sunucu rotalarında tip güvenliği artırıldı. Geliştirme sırasında ihtiyaç duyarsanız bu ayarı false yapabilirsiniz. Bu dönem Nuxt 3’e kıyasla daha önceden fark edilmeyen bazı tip hataları görünebilir, ama genel olarak TS deneyimi daha güvenilir hale geldi.</p><p>Nuxt 4, Vite’ın 4.x sürümü ile uyumlu çalışır; aynı zamanda Webpack ve yeni <strong>Rspack</strong> desteklenir. Vite 4 ile derleme hızları artmış, HMR kararlılığı iyileştirilmiştir. Nuxt 4.3’te özellikle Webpack/Rspack tarafında kritik CSS’in inline (satır içi) gömülmesi desteklendi. Bu, Vite’a benzer şekilde artık inlineStyles: true ayarı verildiğinde Webpack ve Rspack projelerinde de çalışır. Geliştirme sunucusunda hata işleme de tutarlı hale getirildi: artık hem Vite hem Webpack dev sunucusunda 403/404 hataları h3’ün H3Error nesnesiyle yönetiliyor (örneğin 404 sayfalarında). Ayrıca derleme tarafında yol kodlamaları Vue Router ile uyumlu hale getirildi.</p><h3>Sunucu Tarafı ve Streaming</h3><p>Nuxt 4’ün <strong>server/</strong> dizinindeki API route’ları, Nitro/H3 kullanarak tam bir sunucu framework’ü sunar. Örneğin basit bir API şöyle tanımlanabilir:</p><pre>// server/api/hello.ts<br>export default defineEventHandler((event) =&gt; {<br>  return { message: &#39;Have a nice day&#39; }<br>})</pre><p>Bu handler JSON veya düz metin döndürebileceği gibi doğrudan bir <strong>stream</strong> de döndürebilir. Yani EventSource veya SSE (Server-Sent Events) ile gerçek zamanlı veri aktarımı mümkündür. Örneğin uzun süren LLM isteğini (ör. OpenAI chat) parçalar halinde istemciye gönderecek şekilde event.node.res.write() kullanarak bir generator akışı oluşturabilirsiniz. Sunucu fonksiyonu içinde useRuntimeConfig() ile gizli anahtarları çekip bir LLM servisini çağırabilir, gelen akışı SSE formatında istemciye yollayabilirsiniz (kod örneği aşağıda). Nitro, bu handler’ları otomatik olarak dinler ve uygun platformlar (Node.js sunucusu veya Edge Workers) için optimize eder. Özetle, Nuxt 4.3 sayesinde sunucu tarafı fonksiyonlar ve Edge işlevleri (Serverless Functions, Edge Runtimes) üzerinden yapay zekâ API’leri çağırmak ve verileri streaming ile taşımak kolaylaşmıştır.</p><h3>Migration İçin Geliştirmeler</h3><ul><li><strong>Güncelleme Komutu:</strong> Mevcut bir proje için Nuxt’u güncellemenin ilk adımı npx nuxt upgrade --dedupe komutunu çalıştırmaktır. Bu, kilit dosyasını temizleyip Nuxt ve ilgili paketlerin uyumlu son sürümlerini getirmenize yardımcı olur.</li><li><strong>Çoklu TS Konfigürasyonu:</strong> Nuxt 4’te artık kök dizine tek tsconfig.json yeterlidir. Önceki karmaşık yapı ayrı tsconfig.server.json gibi dosyalar yerine otomatik yönetilir. Gerekirse future.compatibilityVersion: 5 bayrağıyla yeni davranışları test edebilirsiniz.</li><li><strong>Nuxt 3 Ara Katmanı:</strong> Nuxt 4’e geçişte @nuxt/kit artık Nuxt 2 desteği sunmaz; eğer Nuxt 2 modülleri kullanıyorsanız Nuxt 3/4 uyumlu sürümlerine geçiş yapmanız gerekir. Ayrıca bazı eski yardımcı araçlar kaldırıldı, module API’ları güncellendi.</li><li><strong>Satır İçi Kod Güncellemeleri:</strong> Eski statusCode/statusMessage kullanımını createError({ status: ..., statusText: ... }) olarak değiştirmeniz gerekebilir. Vuex kullanıyorsanız Nuxt 4 Composition API’ye (useState, useFetch vb.) geçiş düşünülmeli.</li><li><strong>Diğer Kontroller:</strong> Nuxt katmanları (layers) kullanıyorsa kapanan modülleri yukarıdaki şekilde kapatabilirsiniz. nuxt.config.ts içindeki extends: dizisi ile paylaşılan konfigürasyonları düzenlemeyi unutmayın. Son olarak, güncelleme sonrasında mutlaka uygulamayı npm run dev ile test edin; Nuxt ekibi geriye dönük uyumluluk sağlamak için çoğu kırıcı değişiklik için konfigürasyon bayrakları eklediği için, bu bayrakları gerektiğinde nuxt.config.ts’e ekleyerek eski davranışı sürdürebilirsiniz. Detaylı adımlar için resmi <a href="https://nuxt.com/docs/guide/upgrading">Taşıma Kılavuzu</a> incelenmelidir.</li></ul><h3>Performans ve Benchmark Önerileri</h3><ul><li><strong>Cold Start ve İzleme:</strong> Nuxt 4, geliştirme sunucusunu ve build sürecini hızlandırmak için V8 derleme önbelleği, fs.watch tabanlı izleme ve soket tabanlı iletişim kullandı. Uygulamanızda başlangıç sürelerini, HMR tepki sürelerini ölçün. Örneğin npm run dev komutunu her çalışma ortamında test ederek farkı gözlemleyebilirsiniz.</li><li><strong>SSR/SSG Performansı:</strong> ISR/SWR sayfalarının performansını incelemek için Lighthouse (Google Chrome’da “Network Throttling” açık) kullanılabilir. Önceden oluşturulan _payload.json dosyalarının etkin şekilde cachelendiğinden ve navigasyon sırasında isteklerin azaldığından emin olun.</li><li><strong>Core Web Vitals:</strong> Inline kritikal CSS desteğini kullanarak LCP (Largest Contentful Paint) puanının iyileşip iyileşmediğini test edin. Bunun için <a href="https://web.dev/vitals/">Web Vitals</a> araçlarını veya Chrome DevTools’u kullanabilirsiniz.</li><li><strong>Yapı Analizi:</strong> npm run build --analyze ile Vite için paket analiz raporu alın. Bunlarla paket boyutlarını karşılaştırın. Özellikle 4.2’den 4.3.1’e geçişte radix3 bağımlılığının kalkması ve hook filtrelerinin performansa etkisi olmuştur.</li><li><strong>Sunucu Performansı:</strong> Nitro’yu Cloudflare Workers veya Vercel Edge gibi gerçek üretim ortamlarında test edin. Soğuk başlatma süresi, paralel istek işleme yeteneği gibi metrikleri ölçün. İmkân varsa, benchmark için <a href="https://github.com/mcollina/autocannon">Autocannon</a> gibi araçlarla yük testleri yapın.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lS8atDKoGb1y95oMQVpcYA.png" /></figure><p><strong>Nuxt 4.3.1 Proje Kurulumu:</strong> Yeni bir proje başlatmak için Nuxt 4 kullanıyorsanız:</p><pre>npm init nuxt@latest my-app<br>cd my-app<br># Nuxt 4.3.1’i kurar (örneğin pnpm kullanılıyorsa:)<br>pnpm add nuxt@4.3.1</pre><p>nuxt.config.ts’de yeni routeRules ve modül ayarları örneği:</p><pre>export default defineNuxtConfig({<br>  modules: [&#39;@nuxt/content&#39;, &#39;nuxt-llms&#39;],<br>  routeRules: {<br>    &#39;/admin/**&#39;:  { appLayout: &#39;admin&#39; },<br>    &#39;/blog/**&#39;:   { cache: { maxAge: 300 } },<br>    &#39;/landing&#39;:   { ssr: false, redirect: &#39;/home&#39; }<br>  },<br>  llms: {<br>    domain: &#39;example.com&#39;,<br>    title: &#39;Benim Sitem&#39;,<br>    description: &#39;Sitem açıklaması&#39;<br>  }<br>})</pre><p><strong>Composable Kullanımı:</strong> Yeni API örneği, layout props ve route grubu:</p><pre>&lt;script setup lang=&quot;ts&quot;&gt;<br>// Bu örnek bir sayfada veya bileşende kullanılabilir<br>import { useRoute, useFetch } from &#39;#imports&#39;<br>const route = useRoute()<br>// Rota gruplarını kontrol et<br>const isProtected = route.meta.groups?.includes(&#39;protected&#39;)<br><br>// API çağrısı ile veri çekme (SWR örneği)<br>const { data: userData } = await useFetch(&#39;/api/user&#39;, { key: &#39;user&#39;, swr: true })<br>&lt;/script&gt;</pre><p><strong>Nitro Server Route (Sunucusuz Fonksiyon):</strong> TypeScript ile bir AI destekli API örneği:</p><pre>// server/api/chat.ts<br>import { Configuration, OpenAIApi } from &#39;openai&#39;<br><br>export default defineEventHandler(async (event): Promise&lt;{ answer: string }&gt; =&gt; {<br>  // İstek gövdesinden kullanıcı mesajını al<br>  const { prompt } = await readBody&lt;{ prompt: string }&gt;(event)<br>  if (!prompt) throw createError({ status: 400, statusText: &#39;Eksik mesaj&#39; })<br><br>  // Çevresel değişkenden API anahtarını al<br>  const config = new Configuration({ apiKey: useRuntimeConfig().openaiApiKey })<br>  const openai = new OpenAIApi(config)<br><br>  try {<br>    // OpenAI ile sohbet tamamlanması isteği<br>    const resp = await openai.createChatCompletion({<br>      model: &#39;gpt-4o&#39;,<br>      messages: [{ role: &#39;user&#39;, content: prompt }]<br>    })<br>    const answer = resp.data.choices?.[0]?.message?.content || &#39;&#39;<br>    return { answer }<br>  } catch (err: any) {<br>    // Hata durumunda uygun status kodu ile hata fırlat<br>    throw createError({ status: 502, statusText: &#39;AI servisi yanıt vermiyor&#39; })<br>  }<br>})</pre><p>Yukarıdaki fonksiyon, Nuxt Nitro içinde çalışır ve /api/chat isteği ile OpenAI’a bağlanarak yanıt döner (tam TypeScript tipi ile birlikte).</p><p><strong>Streaming Yanıt Örneği:</strong> Server-Sent Events (SSE) kullanımı:</p><pre>// server/api/stream.ts<br>export default defineEventHandler(async (event) =&gt; {<br>  const res = event.node.res<br>  res.setHeader(&#39;Content-Type&#39;, &#39;text/event-stream&#39;)<br>  res.setHeader(&#39;Cache-Control&#39;, &#39;no-cache&#39;)<br>  // Örnek mesaj dizisi<br>  const parts = [&#39;Merhaba&#39;, &#39; &#39;, &#39;dünya&#39;, &#39;!&#39;]<br>  for (const part of parts) {<br>    res.write(`data: ${part}\n\n`)<br>    await new Promise(r =&gt; setTimeout(r, 500))<br>  }<br>  res.end()<br>})</pre><p>Bu endpoint’e tarayıcıda new EventSource(&#39;/api/stream&#39;) ile bağlanıldığında, kelime parçaları aralıklı olarak gönderilir. Buraya kadar okduğunuz için teşekkür ederim. Nuxt yeni yaynladıkları relase de aldığım notları sizinle paylaştığım için çok mutluyum. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2c76f5143e1c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AntiPattern Methodology]]></title>
            <link>https://medium.com/@oguzhancart1/antipattern-methodology-e332f5415d38?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/e332f5415d38</guid>
            <category><![CDATA[desgin-patterns]]></category>
            <category><![CDATA[antipattern]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Tue, 10 Feb 2026 15:21:49 GMT</pubDate>
            <atom:updated>2026-02-10T15:21:49.683Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar bu gün AntiPattern metodolojisini inceleyeceğiz.AntiPattern (karşıt-patern), yazılım geliştirme sürecinde sık karşılaşılan ancak yanlış uygulama sonucu ortaya çıkan çözümler bütünüdür. Tanım olarak, Andrew Koenig’in 1995’te ortaya koyduğu şekliyle “antipattern bir çözüme benzer gibi görünen ama aslında çözücü olmayan yaklaşımdır”.</p><p>Bir başka deyişle, AntiPattern’ler yüzeyde işe yarar gibi görünür, fakat uzun vadede daha büyük sorunlar çıkarır. Örneğin, koordineli şekilde yazılmayan kodlar “spagetti kodu” şeklinde bir AntiPattern oluşturabilir (isimlendirmesi gibi kod akışı spagettiye benzer şekilde düzensizleşir). Bu kavram, design patterns paralel olarak ele alınır. Design patterns sorunlara kanıtlanmış çözümler sunarken, AntiPattern’ler en iyi çözüm sanılarak yapılan uygulamalar yüzünden sorunları artırır. Martin Fowler da vurguladığı gibi, asıl tehlikesi “çözümlüyormuş gibi görünüp gerçekte daha fazla problem üretmesidir”. Kısaca AntiPattern’ler, “her soruna aynı çekiçle yaklaşmak” gibi hatalı düşünce yapılarını ifade eder (Golden Hammer), kodun aşırı karmaşık hale gelmesiyle sonuçlanır.</p><h3>Neden AntiPattern Olur, Nelere Sebep Olur?</h3><p>AntiPattern’ler genellikle aşağıdaki nedenlerle ortaya çıkar:</p><ul><li><strong>Zaman Baskısı ve Kısa Yollar:</strong> Hızlı çözüm ihtiyacı, geçici çözümlerin kalıcı hale gelmesine yol açar (örneğin kodu süsleyip geçici commit’le teslim etmek). Bu durum “lava flow” olarak bilinen eski ve anlaşılmayan kod yığını oluşturur. Özellikle döküman eksikliği ya da ekip değişimi sonrası kodun arkasındaki amacı kimse bilemez hale gelir.</li><li><strong>İyi Anlaşılmamış D</strong>esign Patterns<strong>:</strong> <strong>D</strong>esign patterns işlevi tam bilinmeden veya yanlış bağlamda kullanılması. Örneğin, desenleri sadece sınav için ezberlemek yerine gerçek gereksinimi analiz etmeden kullanmak kodun aşırı karmaşıklaşmasına yol açar.</li><li><strong>Yeniliklere Direnç/Golden Hammer:</strong> El alışkanlığı olan bir teknoloji veya yöntemi tüm problemlere uygun görme. Geliştiricilerin aşina olduğu tekniği her duruma uygulama eğilimi projenin ihtiyaçlarıyla uyumsuz çözümler doğurur. Örneğin JavaScript bilen birisi her yerde callback kullanmaya kalkışabilir (Callback Hell) ya da iyi test edilmeyen bir UI bileşenini sihirli buton gibi kullanabilir.</li><li><strong>Kötü Kod Okunabilirliği ve Bakımı:</strong> Çoğu AntiPattern’in ortak sonucu bakım maliyetlerinin artmasıdır. Örneğin kodu kopyala-yapıştırla çoğaltmak (Copy-Paste Programming) kısa vadede iş görse de, ileride tüm versiyonları güncelleme gerektiren büyük sorunlara yol açar. Benzer şekilde, çok büyük “God Object” sınıflarından oluşan tasarım, tek bir yerde çok fazla sorumluluk topladığından yeni özellik eklemeyi ve hata ayıklamayı zorlaştırır.</li><li><strong>Kötü Hata Yönetimi:</strong> Hataların bastırılması (örneğin boş catch bloklarıyla Error Hiding) sistemin gerçek durumunu gizler ve daha kalıcı sorunlara yol açar.</li></ul><p>AntiPattern’lerin etkileri şunlardır: Kod karmaşıklaşır, okunabilirlik azalır, hatalar gizlenir, teknik borç birikir ve ekip motivasyonu düşer. Yukarıdaki örneklerde görüldüğü üzere <em>özniteliklerine ve nedenlerine göre</em> AntiPattern’ler “belirti (code smells)”, olası sonuçlar (kullanılabilirlik kaybı, bakım zorlaşması, performans düşüşü) ve çözüm önerileri içerecek şekilde tanımlanır.</p><h3>Yaygın AntiPattern Türleri</h3><p>Yazılım dünyasında çok sayıda AntiPattern tanımlanmıştır; en çok bilinenlerden bazıları şunlardır. Aşağıdaki her AntiPattern adı altında kısa açıklama, tipik nedeni ve olası zararları özetlenmiştir:</p><ul><li><strong>Spagetti Kod (Spaghetti Code):</strong> Kodun kontrol akışının çok dallanıp karışması sonucu ortaya çıkan düzensiz yapı. Şöyle ki, kod akışı bir modülden diğerine karmaşık dallanma veya atlama yaptığında kod izlenemez hale gelir. Genellikle acil değişikliklerle testsiz müdahalelerden doğar. Etkileri: Kodun bakımı çok güçleşir, hata düzeltme zorlaşır. Alternatif: Modüler yapılar (fonksiyonlar, sınıflar veya katmanlar) kullanmak, döngüleri ve koşulları mantıklı bir yapıya oturtmak.</li><li><strong>Kopyala-Yapıştır Programlama (Copy-Paste Programming):</strong> Bir fonksiyonun içeriğini kopyalayıp yapıştırarak aynı kodun birden çok kopyasını oluşturmak. Kısa dönemde hızlı gelebilir, ancak aynı iş mantığındaki tüm kopyaları güncelleme ihtiyacı doğurur. Ana nedeni: Nesne yönelimli veya fonksiyonel yeniden kullanım yapılmaması. Etkisi: Bakım maliyeti artar, hata riski büyür (birini düzelttik, diğer kopyalara yansıtılmamış olabilir). Alternatif: Ortak kodu fonksiyon veya sınıf/metot haline getirip yeniden kullanmak.</li><li><strong>God Object (Tanrı Nesnesi):</strong> Tüm programın mantığını tek bir sınıfta toplamaktır. Bu sınıf çok fazla veri ve metot içerir. Nedeni genelde sorumlulukların ayrıştırılmaması veya takım içi anlaşmasızlık. Etkisi: Sınıf karmaşıklaşır, bağımlılıklar yoğunlaşır, yeni özellik eklemek veya hataları izole etmek zorlaşır. Alternatif: Sorumlulukları ilgili modüllere/sınıflara bölmek (örn. MVC gibi desenleri uygulamak).</li><li><strong>Altın Çekiç (Golden Hammer):</strong> El alışkanlığı olarak aynı aracı tüm sorunlara uygulamak. Örneğin bir kütüphaneyi her projede kullanmaya çalışmak veya tek bir design patterns her probleme uygulamak. Bunun nedeni “bana bu çözüm çok yakışıyor” düşüncesidir. Etkisi: Uygulama ihtiyaçları karşılanamaz, gereksiz karmaşıklık artar. Alternatif: Sorun analizi yapıp duruma uygun araç veya desen seçmek; farklı yaklaşımlar denemek.</li><li><strong>Lava Flow (Kökleşmiş Kod):</strong> Henüz tamamlanmamış ya da kalitesiz kodun yayına alınması ve zamanla unutulması. Bu anti-patern genelde tarihsel evrim sonucu çıkar: Başta deneysel, geçici çözüm olarak eklenen kod, ihtiyaç bitince üzerinde durulmaz. Sonuçta bu kod parçası halen sistemde kalır ve anlamı unutulur. Örneği, projede birden fazla mimari yaklaşımın iz bırakmasıdır. Etkisi: Sistem içinde gereksiz yük, teknik borç birikimi olur; kodu temizlemek çok maliyetli hale gelir. Alternatif: Kod incelemeleri, testler ve dökümantasyon sayesinde gereksiz kodu erken tespit edip kaldırmak; sürekli refactoring yapmak.</li><li><strong>Callback Hell (Çoklu İç İçe Geri Çağırmalar):</strong> Özellikle Node.js ve JavaScript’te asenkron callback’lerin ardışık ve iç içe kullanılması durumudur. Bir fonksiyonda birden fazla asenkron işlemi ardışık yazarken callback callback’in içine yazıldığında kod piramit gibi iç içe kayar (Pyramid of Doom). Neden genelde eski stil kodlamadır (Promises/async kullanılmadan). Etkisi: Kod okunamaz ve hata yönetimi zorlaşır. Alternatif: Promise, async/await gibi modern asenkron yapılar veya kontrol akışı kütüphaneleri ile kodu düzleştirmek; modüler fonksiyonlar oluşturmak.</li></ul><p>Ayrıca <strong>Boat Anchor</strong> (Artık Kullanılmayan Kod), <strong>Magic Numbers</strong>, <strong>Hard Coding</strong> gibi AntiPattern’ler de yaygındır; ancak yukarıdakiler en sık rastlanan örneklerdir. Her birinin tespitinde kod kalitesi araçları (kod kokusu/metrics analizörler) ve dikkatli kod incelemesi büyük rol oynar.</p><h3>Node.js Örneği: Callback Hell vs Async/Await</h3><p>Aşağıda Node.js ortamında sık görülen bir AntiPattern örneği yer almaktadır. Birden çok dosyanın içeriğini art arda okuyup işleyen kötü uygulama (callback iç içe) ve ardından refaktoring ile async/await kullanarak temizlenen versiyonu gösterilmiştir. Örnek Node.js 18.x veya benzer LTS sürümüyle uyumludur.</p><pre>// Kötü Örnek (Callback Hell):<br>const fs = require(&#39;fs&#39;);<br><br>// art arda 3 dosya oku ve birleştir<br>fs.readFile(&#39;file1.txt&#39;, &#39;utf8&#39;, (err, data1) =&gt; {<br>  if (err) {<br>    console.error(&#39;file1.txt okunamadı:&#39;, err);<br>    return;<br>  }<br>  fs.readFile(&#39;file2.txt&#39;, &#39;utf8&#39;, (err2, data2) =&gt; {<br>    if (err2) {<br>      console.error(&#39;file2.txt okunamadı:&#39;, err2);<br>      return;<br>    }<br>    fs.readFile(&#39;file3.txt&#39;, &#39;utf8&#39;, (err3, data3) =&gt; {<br>      if (err3) {<br>        console.error(&#39;file3.txt okunamadı:&#39;, err3);<br>        return;<br>      }<br>      const combined = data1 + data2 + data3;<br>      console.log(&#39;İçerik:&#39;, combined);<br>    });<br>  });<br>});</pre><p>Bu örnekte her readFile çağrısı bir öncekinin callback’i içinde yer alıyor. Kod okunduğunda birbirine giren if blokları ve nested callback’ler (iç içe geçmiş yapılar) net bir akış sağlanmasını zorlaştırıyor. Hata yönetimi için her seviyede tekrarlayıcı kontroller yer alıyor. Bu <strong>callback hell</strong> (darboğaz/piramit) AntiPattern’ine tipik bir örnektir. Kodun okunabilirliği ve bakım zorluğu artmıştır.</p><p>Refaktoring için modern Promise veya async/await yapıları kullanılır. Aşağıda aynı işlemi asenkron fonksiyon (async function) ile yeniden yazılmış temiz versiyon görülmektedir:</p><pre>// Doğru Yaklaşım (Async/Await):<br>const fs = require(&#39;fs&#39;).promises;<br><br>async function readFiles() {<br>  try {<br>    const data1 = await fs.readFile(&#39;file1.txt&#39;, &#39;utf8&#39;);<br>    const data2 = await fs.readFile(&#39;file2.txt&#39;, &#39;utf8&#39;);<br>    const data3 = await fs.readFile(&#39;file3.txt&#39;, &#39;utf8&#39;);<br>    const combined = data1 + data2 + data3;<br>    console.log(&#39;İçerik:&#39;, combined);<br>  } catch (error) {<br>    console.error(&#39;Dosya okunurken hata oluştu:&#39;, error);<br>  }<br>}<br><br>readFiles();</pre><p>Bu sürümde, async function içinde await kullanılarak kod düz bir hiyerarşiye kavuşur. Hata yakalama işlemi tek bir try/catch bloğunda toplandı. Performans açısından bu iki yaklaşım arasında ciddi fark yoktur (her ikisi de asenkron I/O yapar), ancak okunabilirlik ve bakım kolaylığı açısından async/await belirgin şekilde üstündür. Ayrıca daha az tekrarlı kod ve daha net hata yönetimi sağlanmıştır. Modern Node sürümleri fs.promises API’sını desteklediğinden, bu kod Node.js 18.x–20.x LTS ile sorunsuz çalışacaktır.</p><h3>AntiPattern Tespit ve Düzeltme Rehberi</h3><p>AntiPattern’lerin tespiti genelde <strong>kod kokuları (code smells)</strong> veya metriklerle başlar. Şöyle belirtilere dikkat edilebilir:</p><ul><li><strong>Tekrarlayan Kod:</strong> Aynı kod yapıları/işlemler birçok yerde yazılmışsa (Copy-Paste belirtileri). Kaynak kod analizi araçları veya kod gözden geçirme ile ortaya çıkar.</li><li><strong>Aşırı Karmaşıklık:</strong> Çok uzun fonksiyonlar, fazla parametre, derin koşul/ döngü iç içeliği (High Cyclomatic Complexity). Kod kalite araçları (ESLint, SonarQube gibi) karmaşıklık metrikleri ile gösterir.</li><li><strong>Tek Noktaya Bağımlılık:</strong> Tüm mantığı tek bir sınıf/fonksiyona yığmak (God Object). Kod incelemesi veya sınıf sorumluluklarının gözden geçirilmesiyle fark edilir.</li><li><strong>Bilinçsiz Kütüphane/Kod Kullanımı:</strong> Kendi anlamadığınız kod örneklerini direk kullanmak (Cargo Cult Programming). Kod gözden geçirme ve ekip içi iletişimle yakalanır.</li><li><strong>Zorlu Test Senaryoları:</strong> Birim test yazmanın zor veya imkansız olduğu yapıların varlığı. Karmaşık, birbirine bağlı kod blokları test yazmayı zorlaştırır; bu tür kodlar anti-paterne işaret eder.</li></ul><p>Düzeltme adımları genellikle şu şekildedir:</p><ol><li><strong>Sorunu Tanımla:</strong> Belirtiler belirlendikten sonra ilgili kod parçasını izole edin. Örneğin bir modülü tamamen gözden geçirin; kodu küçük parçalara bölün.</li><li><strong>Alternatif Deseni Seçin:</strong> Çözüm aranırken var olan başarılı design patterns (Örneğin Factory, Strategy, Observer gibi) bakın. Kodda tekrarı azaltmak için fonksiyonları veya sınıfları genişletin/yeni fonksiyonlar yazın.</li><li><strong>Kademeli Refactoring:</strong> Anında büyük değişiklik yapmak yerine, küçük adımlarla refactor edin. Önce bir modülü düzene sokun, test yazın, sonra diğerine geçin.</li><li><strong>Test ve İnceleme:</strong> Her refactor sonrası otomatik testlerle doğrulayın. Kod inceleme (code review) yaparak hataları erkenden yakalayın.</li><li><strong>Dokümantasyon ve Eğitim:</strong> Takım içindeki tüm geliştiricilerin bilgilendirilmesi önemlidir. AntiPattern’leri ve alternatifleri belgeleyin. Yapılan değişiklikleri dökümante ederek gelecekte tekrar kullanılmasını önleyin.</li></ol><blockquote><strong><em>Temel Fikir:</em></strong><em> AntiPattern’ler her zaman değiştirilemez değildir; doğru refaktoring ile kod </em><strong><em>sağlıklı</em></strong><em> hale getirilebilir. Örneğin yukarıdaki Node.js örneğinde görüldüğü gibi, iç içe geçmiş callback’leri temiz bir akışa dönüştürmek mümkündür. Orijinal kötü uygulama kötü bir çözüm sunar, ancak alternatif çözüm (Promise/async) mevcuttur.</em></blockquote><pre>      [Problem]<br>         / \<br>        /   \<br>       V     V<br>[AntiPattern]   [Pattern]<br>    |             |<br>    V             V<br>[Kötü Sonuç]   [İyi Sonuç]</pre><p>Bu ASCII şemayı makaleye kod bloğu olarak ekleyebilir veya benzer bir SVG grafik hazırlayıp bağlam açıklamasıyla yerleştirebilirsiniz. Görsel/şema, AntiPattern’in kötü sonuç doğururken iyi bir desenin sürdürülebilir sonuç ürettiğini vurgular.</p><p>AntiPattern’ler, yazılım sürecinde <em>tuzakları</em> tanımlayan önemli kavramlardır. Tanımlayıcılarına ve nedenlerine dikkat ederek kod yazmak, uzun vadede bakım kolaylığı ve performans kazandırır. Makalede hem teorik hem pratik olarak ele alındığı üzere, AntiPattern’lerin varlığını anlamak için kod kokularına dikkat edin; <strong>teşhis</strong> sonra ise işinizi refaktoring ve doğru desen seçimleriyle <strong>iyileştirin</strong>. Özellikle ekibinizle birlikte “Bu kod neden böyle?” sorusunu sormak, yeni hataları engelleyen kritik adımdır. Bir problemi çözüyor gibi görünen ama sonuçları kötü olan bir yaklaşımla karşılaştığınızda, mutlaka alternatif ve daha iyi yöntemler araştırın. Öğrendiğiniz AntiPattern kavramları, sadece <em>ne yapmamanız</em> gerektiğini değil, aynı zamanda doğru design patterns önemini de anlamanızı sağlar.</p><p>Projelerinizdeki kodu gözden geçirin; yukarıdaki örnekleri kendi kodunuza uyarlayıp benzer hatalar var mı kontrol edin. Bir sonraki adım olarak yazdığınız veya bir başkasının yazdığı kodda en az bir AntiPattern tespit ederek bunu bir desenle düzeltmeyi deneyin. <strong>Buraya kadar okuduğunuz için çok teşekkür ederim. İyi ve sağlıklı günler dilerim. ☺️</strong></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e332f5415d38" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Docker ile Nuxt 3 Projesini Paketleme Rehberi]]></title>
            <link>https://medium.com/@oguzhancart1/docker-ile-nuxt-3-projesini-paketleme-rehberi-dde5f1f3c791?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/dde5f1f3c791</guid>
            <category><![CDATA[nuxt-docker]]></category>
            <category><![CDATA[nuxt-dockerize]]></category>
            <category><![CDATA[nuxt]]></category>
            <category><![CDATA[nuxtjs]]></category>
            <category><![CDATA[dockerize]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Tue, 27 Jan 2026 15:13:14 GMT</pubDate>
            <atom:updated>2026-01-27T15:13:14.384Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar nuxt 3 kullanarak oluşturduğumuz projeyi Docker ile paketleyerek dağıtıma hazır hale getirebiliriz. Bu yazımda, sıfırdan bir nuxt projesini oluşturup, build, ardından basit bir Dockerfile ile bu projeyi konteyner imajı haline getirmeyi adım adım incelleyeceğiz.</p><p><em>Terminalde </em><em>npx nuxi init my-nuxt-app komutunu çalıştırdıktan sonra yeni nuxt projesinin başarıyla oluşturulduğunu gösteren çıktı.</em></p><p>Öncelikle <em>nuxt</em> projemizi oluşturuyoruz. Bunun için Node.js ve npm bilgisayarınızda kurulu olmalıdır. Terminalde aşağıdaki komutu çalıştırın:</p><pre>npx nuxi init my-nuxt-app</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/425/1*TFUAM_ygVm6GjU1LrIL-Kg.png" /></figure><p><em>npm install komutu ile proje için gerekli paketlerin kurulmasını gösteren terminal çıktısı. Bu adım, projenin bağımlılıklarını node_modules klasörüne indirir.</em></p><p>Yeni oluşturulan proje klasörüne girerek (cd my-nuxt-app), proje bağımlılıklarını yüklememiz gerekir. Bunun için terminalde proje dizininde aşağıdaki komutu çalıştırın:</p><pre>npm install</pre><p>Bu komut, <strong>package.json</strong> dosyasındaki tüm bağımlılıkları indirerek node_modules klasörüne kurar. Terminal çıktısında da görüldüğü gibi, npm ilgili paketleri ekler ve denetler. Kurulum tamamlandığında &quot;found 0 vulnerabilities&quot; mesajı, güvenlik taramasında sorun bulunmadığını belirtir. Artık projemiz derlemeye (build almaya) hazır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/502/1*lzHnDaAegj5BpT7jQeWQCA.png" /></figure><p><em>npm run build komutu ile Nuxt uygulamasının üretim için derlenmesini gösteren terminal çıktısı. Bu işlem sonunda optimize edilmiş statik dosyalar ve gerekiyorsa sunucu çıktısı üretilir.</em></p><p>Proje bağımlılıklarını yükledikten sonra, uygulamamızın üretim ortamı için derlemesini alırız. nuxt projelerinde üretim build’i almak için aşağıdaki komutu kullanın:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/367/1*tV6mfJ3ghNcrj3-ZUymNAg.png" /></figure><p>Bu komut aslında Nuxt’un kendi build aracını çağırır (nuxt build). Derleme sürecinde Nuxt, projenizi optimize eder ve statik dosyaları oluşturur. Eğer proje sadece bir SPA (Single Page Application) olarak veya SSG (Static Site Generation) modunda çalışacaksa, bu build işlemi sonucunda .output/public klasöründe statik dosyalarınız oluşacaktır. (nuxt’ta tamamen statik bir site oluşturmak için alternatif olarak npx nuxi generate komutu da kullanılabilir. Bu komut, tüm sayfaları derleyip dist/ klasöründe statik bir site oluşturur.)</p><p>Yukarıdaki terminal çıktısında, Nuxt’un istemci tarafı kodunu ve (gerekirse) sunucu tarafı kodunu derleyip hazır hale getirdiğini görüyoruz. Artık uygulamamız dağıtıma hazır durumda. Sıradaki adım, bu derlenmiş uygulamayı bir Docker imajı haline getirmek olacak.</p><h3>Dockerfile ile Docker İmajı Oluşturma</h3><p>Şimdi proje dosyalarımızdan bir Docker imajı oluşturacağız. Bunun için proje dizininde basit bir <strong>Dockerfile</strong> dosyası oluşturun ve aşağıdaki içerikle doldurun:</p><pre># 1. Build Stage<br>FROM node:18-alpine AS build <br>WORKDIR /app<br>COPY package*.json ./<br>RUN npm install<br>COPY . .<br>RUN npm run build<br><br># 2. Runtime Stage<br>FROM nginx:alpine<br>COPY --from=build /app/.output/public /usr/share/nginx/html<br>EXPOSE 80</pre><p>Yukarıdaki Dockerfile iki aşamalı (multistage) bir yapı kullanıyor. <strong>Birinci aşama (build)</strong> Node.js imajını kullanarak proje dosyalarımızı derliyor. Bu aşamada proje dosyaları konteynere kopyalanır, bağımlılıklar kurulup npm run build çalıştırılarak üretim derlemesi alınır. İkinci aşamada ise hafif bir Nginx imajı kullanılarak, birinci aşamadaki derleme çıktıları web sunucusuna kopyalanır. Özellikle .output/public klasöründeki statik dosyalar Nginx içinde servis edilecek dizine (/usr/share/nginx/html) kopyalanmıştır. Bu sayede son imajımızda sadece statik dosyalar ve Nginx sunucusu bulunur, gereksiz derleme araçları yer almaz. (Nuxt projesini statik yerine SSR modunda paketlemek isterseniz, Nginx yerine Node ile .output/server dosyasını çalıştırabilirsiniz, ancak bu örnekte statik ön yüzü konteynırda servis ediyoruz.)</p><p>Dockerfile hazırlandıktan sonra, aşağıdaki komutla Docker imajını oluşturalım:</p><pre>docker build -t my-nuxt-app .</pre><p>Yukarıdaki komutta -t my-nuxt-app imaja bir isim/etiket veriyor, sondaki . ise Dockerfile’ın bulunduğu geçerli dizini konteyner bağlamı olarak kullanıyor. Komut çalıştığında terminalde bir dizi adım göreceksiniz (Docker her satırı adım adım işleyecektir). Her adım, Dockerfile’da yazdığımız talimatların karşılığıdır. Örneğin, bağımlılıkların kurulması, projenin build edilmesi ve Nginx imajına kopyalanması adımlarını loglarda görebilirsiniz. İmaj boyutunu küçük tutmak için multi-stage yöntemi kullandığımızdan, son aşamada sadece gereken dosyalar kopyalanmıştır. Komut sonunda &quot;Successfully tagged my-nuxt-app:latest&quot; mesajı göründüğünde Docker imajımız başarıyla oluşturulmuş demektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/695/1*9w4_n9B_JbEROcmndpcnqg.png" /></figure><p>Terminalde docker build -t my-nuxt-app . komutunun çıktısı. Docker, adım adım imajı inşa ederek sonunda “Successfully tagged” mesajıyla işlemin başarıyla bittiğini bildiriyor.</p><h3>Docker Konteynerini Çalıştırma</h3><p>Docker imajımız hazır olduğuna göre, bu imajdan bir konteyner çalıştırabiliriz. Uygulamamızı yerel makinede (veya sunucuda) çalıştırmak için aşağıdaki komutu kullanın:</p><pre>docker run -d -p 80:80 my-nuxt-app</pre><p>Bu komutta -d bayrağı konteynerin arka planda (detached modda) çalıştırılmasını sağlar. -p 80:80 ise Docker konteynerinin 80 portunu, host (makinenizin) üzerindeki 80 portuna eşler. Yani, konteyner içindeki Nginx sunucusu 80 portunda çalışırken, bu porta gelen istekler makinenizin 80 portu üzerinden ulaşılabilir olur. Komutu çalıştırdıktan sonra konteyner ID’si çıktıda görünecektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/637/1*5GhAWLiWRrFPyTVJ8gx98A.png" /></figure><p><em>docker run -d -p 80:80 my-nuxt-app komutu çalıştırıldığında konteyner arka planda başlatılır ve uzun bir konteyner ID değeri döndürülür.</em></p><p>Artık uygulamanız Docker konteyneri içinde çalışıyor. Tarayıcınızda http://localhost:80 (veya sunucunuzda uygun IP/URL) adresine giderek Nuxt uygulamanızı görebilirsiniz. Eğer her şey doğru yapıldıysa, Nuxt projenizin anasayfası karşınıza gelecektir. Tebrikler, nuxt uygulamanızı başarıyla Docker ile paketlenmiş ve çalışmış olacaktır.. Artık nuxtta da docker kullanıyorsunuz. Unutmayın ilk defayasa herkese zor gelir. Buraya kadar okuduğunuz için çok teşekkür ederim. Herhangi bir sorununuz olur tüm sosyal medya platformlardan yazmaktan çekinmeyin. İyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dde5f1f3c791" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Angular Projesini Docker ile Paketleme]]></title>
            <link>https://medium.com/@oguzhancart1/angular-projesini-docker-ile-paketleme-68f4cf26f3e8?source=rss-8cd487756f95------2</link>
            <guid isPermaLink="false">https://medium.com/p/68f4cf26f3e8</guid>
            <category><![CDATA[docker]]></category>
            <category><![CDATA[dockerize]]></category>
            <category><![CDATA[angular-docker]]></category>
            <category><![CDATA[angular]]></category>
            <category><![CDATA[angular-dockerize]]></category>
            <dc:creator><![CDATA[OĞUZHAN ÇART]]></dc:creator>
            <pubDate>Mon, 26 Jan 2026 10:21:43 GMT</pubDate>
            <atom:updated>2026-01-26T10:21:43.337Z</atom:updated>
            <content:encoded><![CDATA[<p>Merhabalar, genelde web uygulamalarını d<strong>ocker konteynerleri</strong> içinde paketlemek, dağıtımı ve çalıştırılması çok daha kolay hale getiriyor. Ancak ilk zamanlar docker kullanımı hakkında kafamız karışabilir yada projenizi dockerize etmek konusunda çekingeniz olabilir, bu çok doğal o yüzden bu yazımda, bir <strong>Angular</strong> projesinde adım adım Docker ile nasıl paketleyeceğimizi incelleyeceğiz.</p><h3>Angular CLI ile Proje Oluşturma</h3><p>Öncelikle örnek bir Angular projesi oluşturalım. Angular’ın cli ile terminalden, yeni proje oluşturalım. Eğer Angular CLI sisteminizde yoksa npm install -g @angular/cli komutuyla global olarak yükleyebilirsiniz. Ardından aşağıdaki komutu çalıştırarak yeni bir Angular projesi başlatın:</p><pre>ng new example-angular-docker</pre><p>Bu komutu verdiğinizde Angular CLI sizden bazı ayarlar isteyecektir (örneğin, yönlendirme (routing) eklemek isteyip istemediğiniz veya hangi stil formatını kullanacağınız). Basitlik için yönlendirmeyi eklemeyip standart CSS seçebilirsiniz. CLI, projenizin temel dosyalarını oluşturup gerekli <strong>npm</strong> paketlerini otomatik olarak yükleyecektir. İşlem tamamlandığında proje klasörünüz kullanıma hazır hale gelir.</p><figure><img alt="docker-ss-1.png" src="https://cdn-images-1.medium.com/max/550/1*NcXzjdv0L1neefrJa1fzUg.png" /></figure><h3>Dockerfile Oluşturma ve Açıklaması</h3><p>Artık uygulamamızı container içinde çalıştırmak üzere bir <strong>Docker imajı</strong> oluşturabiliriz. Docker imajını oluşturmak için projemizin kök dizinine bir <strong>Dockerfile</strong> adlı dosya oluşturacağız. <strong>Dockerfile</strong>, imajı inşa etmek için Docker’a verilecek talimatları içeren basit bir metin dosyasıdır (bir nevi tarif kitabı gibi düşünebilirsiniz). Bu dosyada baz alacağımız temel imajı ve uygulamamızı içine kopyalama adımlarını tanımlayacağız.</p><p>Açık kaynak ve hafif bir web sunucusu olan <strong>Nginx</strong> kullanarak Angular uygulamamızı servis edeceğiz. Angular uygulamaları derlendikten sonra kendi başlarına bir sunucu içermezler; bu nedenle bir HTTP sunucusuna ihtiyaç duyarlar. Bu amaçla Docker imajımızın tabanında küçük boyutlu bir Nginx imajı kullanacağız.</p><p>Aşağıda basit bir Dockerfile örneği bulunmaktadır:</p><pre>FROM nginx:alpine<br>COPY dist/example-angular-docker /usr/share/nginx/html<br>EXPOSE 80</pre><p><strong>FROM nginx:alpine:</strong> Bu satır, Docker imajımızın temelinin resmi Nginx Alpine Linux imajı olacağını belirtir. Alpine tabanlı Nginx, oldukça küçük boyutludur ve Angular’ın statik dosyalarını sunmak için idealdir.<br> <strong>COPY dist/example-angular-docker /usr/share/nginx/html:</strong> Bu komut, Angular uygulamamızı derlediğimiz dist/example-angular-docker klasöründeki tüm dosyaları Docker imajındaki Nginx’in varsayılan web dizinine kopyalar. Nginx, bu dizindeki index.html dosyasını bulup sunarak Angular uygulamamızı servis edecektir.<br> <strong>EXPOSE 80:</strong> Bu satır, konteyner içinde 80 numaralı portun kullanılacağını belgeliyor. Nginx varsayılan olarak 80 portunda HTTP servisi verdiği için bu portu açıyoruz. (Not: EXPOSE komutu güvenlik veya yayınlama açısından otomatik bir etki yapmaz, ancak dokümantasyon amaçlıdır. Konteyner portunu dış dünyaya açmak için <strong>docker run</strong> komutunda -p parametresini kullanacağız.)</p><p>Gördüğünüz gibi Dockerfile oldukça sade. Bu dosyayı kaydettikten sonra artık Docker imajımızı oluşturma adımına geçebiliriz. (İpucu: Gerçek hayat projelerinde genellikle <strong>çok-aşamalı (multi-stage) build</strong> teknikleri kullanılarak Angular uygulamaları Docker içinde derlenip ardından Nginx imajına kopyalanır. Ancak, anlaşılır olması için burada derlemeyi dışarıda yapıp sonuç dosyalarını imaja koyma yöntemini tercih ettik.)</p><h3>Docker İmajı Oluşturma</h3><p>Dockerfile hazır olduğuna göre, bu tarif dosyasını kullanarak bir Docker <strong>imajı</strong> oluşturabiliriz. <em>Docker image</em>, uygulamamızı çalıştırmak için gereken her şeyi içinde barındıran bir paket gibidir. İmajı oluşturmak için Docker’ın build komutunu kullanacağız. Terminalde, proje klasörünüzün kök dizininde (yani Dockerfile’ın bulunduğu yerde) aşağıdaki komutu çalıştırın:</p><pre>docker build -t example-angular-img .</pre><p>Burada <strong>-t example-angular-img</strong> ile imajımıza bir isim ve etiket verdik. Nokta (.) ise Docker’a, mevcut dizindeki Dockerfile’ı kullanmasını ve tüm içeriği bağlam olarak almasını söylüyor. Bu komut çalıştığında Docker, imajı adım adım inşa etmeye başlayacaktır (önce temel Nginx imajını indirme, sonra bizim dosyalarımızı kopyalama gibi). İşlem başarılı bittiğinde, makinenizde example-angular-img:latest adında yeni bir Docker imajı oluşmuş olacak.</p><blockquote>docker build komutunu çalıştırdığımızda terminalde görülen çıktılar. Bu çıktıda Docker, adım adım imajı oluşturmaktadır: ilk adımda Nginx taban imajı çekiliyor (<strong>FROM</strong> satırı), ikinci adımda derlenmiş Angular dosyaları imajın içine kopyalanıyor (<strong>COPY</strong> satırı) ve son olarak imaj başarılı bir şekilde derlenip etiketleniyor. “Successfully tagged example-angular-img:latest” ifadesi, imajın belirlediğimiz isimle oluşturulduğunu gösteriyor.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/839/1*PEe3ebuF648eoD31dWNPTQ.png" /></figure><blockquote><strong><em>Not:</em></strong><em> İmajın oluşturulduğunu doğrulamak isterseniz </em><em>docker image ls komutuyla mevcut Docker imajlarınızı listeleyebilirsiniz. Yeni oluşturduğunuz imaj bu listede görünecektir.</em></blockquote><h3>Docker Container Başlatma</h3><p>Docker imajımız hazır olduğuna göre, bu imajdan bir <strong>container (konteyner)</strong> çalıştırabiliriz. Konteyner, imajın canlı ve çalışan bir örneğidir. Docker konteynerini başlatmak için docker run komutunu kullanacağız. Aşağıdaki komutla imajımızı çalıştırın:</p><pre>docker run -d -p 8080:80 example-angular-img:latest</pre><p>Bu komut birkaç parametre içeriyor:</p><ul><li><strong>-d</strong> (detached) parametresi, konteynerin arka planda çalışmasını sağlar, böylece terminali meşgul etmez.</li><li><strong>-p 8080:80</strong> parametresi, port yönlendirmesini ayarlar. Burada <strong>8080</strong> bizim bilgisayarımızın (host) portudur, <strong>80</strong> ise konteyner içindeki Nginx’in dinlediği porttur. Bu eşleme sayesinde, bilgisayarımızda 8080 portuna gelen istekler konteyner içindeki 80 portuna iletilecek. Yani, tarayıcınızda http://localhost:8080 yazarak konteyner içindeki Angular uygulamasına ulaşabileceğiz.</li><li>Son kısımda example-angular-img:latest ise çalıştırılacak imajın adını belirtiyor (:latest kısmı, etiketini belirtmezsek varsayılan olarak latest kullanılacağını gösterir).</li></ul><p>Komutu çalıştırdıktan sonra konteyner arka planda başlayacak. Terminal size çalışmaya başlayan konteynerin ID numarasını verecektir. İsterseniz docker container ls komutuyla çalışan konteynerlerin listesini görebilirsiniz. Aşağıda, konteynerin başarıyla başladığını gösteren bir terminal çıktısı örneği yer alıyor:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gROZverVXEFoB8FbV5VvQA.png" /></figure><p>Docker konteynerini başlatma komutu ve ardından konteyner listesini gösteren terminal çıktısı. İlk satırda docker run komutunun çıktısı olarak konteyner ID’si görünüyor (sistemde benzersiz bir uzun ID ile temsil edilir). Devamında docker container ls çıktısı var: burada yeni konteynerimizin çalışmakta olduğu, kullandığı imajın adı, Nginx’in komut satırı, çalışma süresi ve en önemlisi port eşlemesi görülüyor (host 8080 portu -&gt; konteyner 80 portu).</p><p>İşte şimdi angular uygulamanız bir Docker konteyneri içinde çalışıyor. Tarayıcınızda http://localhost:8080 adresine giderseniz Angular projenizin açıldığını göreceksiniz. Bu sayede uygulamanızı ister kendi bilgisayarınızda ister sunucuda olsun, aynı Docker imajını kullanarak tutarlı bir şekilde çalıştırabilirsiniz. Docker ile paketleme işlemi, “bir yerde çalışan uygulama her yerde çalışır” mottosunu gerçeğe dönüştürerek ortam bağımlılıklarını ortadan kaldırır.</p><p>Bu makalede, basit adımlarla bir Angular frontend projesini Docker ile paketlemeyi öğrendik. Önce Angular CLI kullanarak proje oluşturduk, ardından ng build ile uygulamayı üretim modunda derledik. Daha sonra bir Dockerfile yazarak Nginx üzerinde çalışacak şekilde uygulamamızı konteynerize ettik. Son adımda Docker imajını oluşturup bir konteyner olarak çalıştırdık. Tüm bu adımlar teknik terimlere boğulmadan, olabildiğince sade bir dille açıklamaya çalıştım. Umarım işinize yarayan bir kaynak olur. Unutmayın ilk seferlerde zorlanabilirsiniz bu gayet normal ancak ilerleyen zamanlarda alışınca artık reflex olacağını ve her projenizi dockerize etmek isteyeceksiniz. Buraya kadar okuduysanız çok teşekkür ederim iyi ve sağlıklı günler dilerim.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=68f4cf26f3e8" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>