TR
Bu portfolyo için en güncel resmî ana karakterden uyarlanan Eco² dünya karakteri: yeşil kıtalı, tepesinde bir filiz olan, kahverengi gülen yüzlü gök mavisi bir dünya
Salona dön

Eco²

Backend · Cloud infrastructure

Tek bir fotoğraf ve bir sohbetle geri dönüşüm rehberliği.

Kore'de geri dönüşümün nasıl işlediğini bilen hepsi bir arada bir yapay zekâ asistanı.

2025.10.31 — 2026.02.10

Ekip projesi · altyapı ve dağıtım temeli → alan arka ucu → eşzamansız işleme, sohbet ajanı, doğrulama

2025 새싹 해커톤 (Saessak Hackathon)Üstün Başarı Ödülü · 2025.12.02

  • Web uygulamasıHizmet kapandı

24 düğümün gerçekte nasıl bağlandığı, her seferinde bir akış.

kubeadm ile kurulmuş, kendi kendine yönetilen Kubernetes. Harita 24 fiziksel düğümü ve üzerlerindeki iş yüklerini README'nin beş katmanı içine yerleştirir ve gerçek bağlantılarıyla birleştirir. Bir akış seçildiğinde yalnızca o yol numaralı adımlarla vurgulanır.

Bir fotoğraftan atığı tanır ve nasıl atılacağını açıklar; sohbette yerler, hava durumu, geri dönüşüm fiyatları ve web araması için araçları çağırır ve görsel üretir. Bu ekip projesinde küme ve dağıtım temeliyle başladım; sorumluluğumu alan arka ucuna, eşzamansız işlemeye, sohbet ajanına ve doğrulamaya genişlettim.

Yarışma geliştirmesinden arka uç ve operasyonların sağlamlaştırılmasına kadar

Hizmet faaliyetini tamamladı; kaydedilmiş bir demo ve teknik rapor onu çalışırken gösterir.

Küme bağlantı haritası · a072127 commit'indeki manifest'ler ve koddan yeniden çizildi
Eco² küme bağlantı haritası · 24 düğümREADME'nin beş katman bandı içindeki 24 fiziksel düğümün haritası. Tarayıcı adı yalnızca Route 53'te arar; TLS 443'teki ALB'de sonlandıktan sonra, bir NodePort üzerindeki Istio ingress Envoy isteği bir alan API'sine gönderir. Scan API işi RabbitMQ kuyruğuna koyar ve hemen bir job_id döndürür; AI havuzundaki scan-worker ilerleme olaylarını XADD ile Redis Streams'e yazar. Event Router bunları okur, State KV'yi günceller ve Pub/Sub'a yayımlar; SSE Gateway de tarayıcıya gönderir. checkpoint-syncer Chat checkpoint'lerini, Chat düğümündeki persistence consumer da mesajları PostgreSQL'e kaydeder. Platform Layer bir istek yolu değildir; yapılandırır, ölçekler ve gözlemler.TarayıcıHTTPS · SSEAWS ALB443 · TLS burada sonlanırRoute 53DNSGitHub Actions · Docker Hubimage · manifest revizyonuLLM APIOpenAI · GoogleLangSmithLLM çalıştırma izlemeFluent BitDaemonSet · her düğümk8s-masterALB Controller · ExternalDNSArgo CD image updaterIstiodcontrol planek8s-ingress-gatewayIstio ingress Envoyk8s-api-scanScan APIk8s-api-chatChat APImessage consumerpersistence consumerk8s-api-authauth APIext-authzk8s-api-infoInfo APIinfo-workerk8s-api-charactercharacter APIk8s-api-imageimages APIk8s-api-usersusers APIk8s-api-locationlocation APIk8s-sse-gatewaySSE Gatewayk8s-event-routerEvent Routerk8s-rabbitmqRabbitMQk8s-worker-aik8s-worker-ai-2k8s-worker-storagek8s-worker-storage-2k8s-redis-pubsubPub/Subk8s-redis-streamsStreamsState KVk8s-redis-cacheCachek8s-postgresqlPostgreSQLk8s-redis-authblacklistk8s-monitoringKEDAPrometheusGrafanaAlertmanagerk8s-loggingElasticsearchKibanascan-workerchat-workercheckpoint-syncerauth-relayauth-workerusers-workercharacter-workercharacter-match-workerKialiJaeger · dev in-memoryKubernetes kümesi24 düğüm · kubeadmEdge Layer1 düğümService Layer8 düğüm · Envoy sidecarIntegration Layer7 düğümPersistence Layer5 düğümPlatform Layer3 düğüm · yapılandır · ölçekle · gözlemleAWS yönetimliAI havuzudomain: worker-aistorage havuzudomain: worker-storageSabit düğüm yok1DNS sorgusu2 HTTPS 443 · Tarayıcı → AWS ALB23HTTP · NodePort4VirtualService5Celery görevi6 consume · RabbitMQ → scan-worker67 HTTPS · AI havuzu → LLM API78XADD scan:events9XREADGROUP10SETEX state11PUBLISH12SUBSCRIBE13SSE akışı14Yeniden bağlanmada kurtarma1 HTTPS 443 · Tarayıcı → AWS ALB12HTTP · NodePort3VirtualService4Taskiq görevi5 consume · RabbitMQ → chat-worker56 HTTPS · AI havuzu → LLM API67XADD chat:events8XREADGROUP9PUBLISH10SUBSCRIBE11SSE akışı12checkpoint13checkpoint oku14PostgreSQL'e eşitle15chat-persistence group16mesajları kaydet1DNS sorgusu2 HTTPS 443 · Tarayıcı → AWS ALB23HTTP · NodePort4ext-authz · gRPC 500515blacklist sorgusu6VirtualService7gRPC8gRPC1outbox:blacklist2blacklist.events3 blacklist.events · RabbitMQ → auth-worker34blacklist'i kaydet5 Celery batch · RabbitMQ → users-worker56UPSERT1image · manifest revizyonu2Ingress → ALB · DNS kayıtları3xDS yapılandırması4pod sayısı5 pod sayısı · KEDA → storage havuzu56günlükler7 LLM çalıştırma izleme · AI havuzu → LangSmith7

Scan isteği → canlı iletim

Bir fotoğraf analizi isteği kuyruğa alınmış bir işe dönüşür ve ilerleme olayları aynı tarayıcıya geri gelir.

  1. TarayıcıDNS sorgusuRoute 53

    Route 53 kayıtlarından yalnızca ad çözümlenir. İstekler DNS'ten geçmez.

  2. TarayıcıHTTPS 443AWS ALB

    TLS, ALB'de sonlanır.

  3. AWS ALBHTTP · NodePortIstio ingress Envoyk8s-ingress-gateway

    EC2 instance hedefinin NodePort'u üzerinden Istio ingress Envoy'a aktarılır.

  4. Istio ingress Envoyk8s-ingress-gatewayVirtualServiceScan APIk8s-api-scan

    İşi kuyruğa koyup hemen bir job_id döndüren Scan API'ye yönlendirilir; sonuç sorgusu iş bitene kadar 202 yanıtını verir.

  5. Scan APIk8s-api-scanCelery göreviRabbitMQk8s-rabbitmq

    Scan görevi RabbitMQ'ya konur.

  6. RabbitMQk8s-rabbitmqconsumescan-workerk8s-worker-ai · k8s-worker-ai-2

    AI havuzundaki scan-worker (Celery · gevent) onu alır ve Vision → Rule → Answer → Reward çalıştırır. Dört aşama zincirlenmiş Celery görevleridir, düğüm değildir.

  7. AI havuzuk8s-worker-ai · k8s-worker-ai-2HTTPSLLM API

    scan ve chat worker'ları OpenAI ve Google API'lerini çağırır.

  8. scan-workerk8s-worker-ai · k8s-worker-ai-2XADD scan:eventsStreamsk8s-redis-streams

    İlerleme olayları dört Streams shard'ından birine yazılır.

  9. Streamsk8s-redis-streamsXREADGROUPEvent Routerk8s-event-router

    Event Router bunları bir consumer group olarak okur ve işledikten sonra XACK eder; pending ve reclaim iletimi at-least-once tutar.

  10. Event Routerk8s-event-routerSETEX stateState KVk8s-redis-streams

    En son durumu ve bir yinelenen işleme işaretini aynı Redis düğümündeki State KV'ye yazar.

  11. Event Routerk8s-event-routerPUBLISHPub/Subk8s-redis-pubsub

    Shard Pub/Sub'da işin kanalında gerçek zamanlı iletilir.

  12. Pub/Subk8s-redis-pubsubSUBSCRIBESSE Gatewayk8s-sse-gateway

    SSE Gateway süreç başına tek bir paylaşılan listener ile abone olur ve bağlı her tarayıcıya dağıtır.

  13. SSE Gatewayk8s-sse-gatewaySSE akışıTarayıcı

    Aynı ALB ve ingress yolu üzerinden açılan bir bağlantı. İletim at-least-once'tır; kopyalar idempotent biçimde işlenir.

  14. State KVk8s-redis-streamsYeniden bağlanmada kurtarmaSSE Gatewayk8s-sse-gateway

    Last-Event-ID ile yeniden bağlanıldığında State KV ve saklanan Streams kaçırılan olayları tamamlar.

Chat · token'lar ve depolama

Chat token'ları Scan ile aynı olay yolunu izler; checkpoint'ler ve mesajlar iki farklı iş yükü tarafından kaydedilir.

  1. TarayıcıHTTPS 443AWS ALB

    TLS, ALB'de sonlanır.

  2. AWS ALBHTTP · NodePortIstio ingress Envoyk8s-ingress-gateway

    EC2 instance hedefinin NodePort'u üzerinden Istio ingress Envoy'a aktarılır.

  3. Istio ingress Envoyk8s-ingress-gatewayVirtualServiceChat APIk8s-api-chat

    Chat API'ye yönlendirilir.

  4. Chat APIk8s-api-chatTaskiq göreviRabbitMQk8s-rabbitmq

    Chat görevi RabbitMQ'ya konur.

  5. RabbitMQk8s-rabbitmqconsumechat-workerk8s-worker-ai · k8s-worker-ai-2

    chat-worker (Taskiq · asyncio) niyeti LangGraph ile sınıflandırır, ardından gerekirse vision'ı, seçilen araçları, aggregator'ı ve gerekirse bir özeti çalıştırıp yanıtlar. Her istek yalnızca ihtiyaç duyduğu dalları çalıştırır.

  6. AI havuzuk8s-worker-ai · k8s-worker-ai-2HTTPSLLM API

    scan ve chat worker'ları OpenAI ve Google API'lerini çağırır.

  7. chat-workerk8s-worker-ai · k8s-worker-ai-2XADD chat:eventsStreamsk8s-redis-streams

    Token'lar ve aşama olayları dört Streams shard'ına yazılır; oradan sonra iletim yolu Scan'inkiyle aynıdır.

  8. Streamsk8s-redis-streamsXREADGROUPEvent Routerk8s-event-router

    Event Router bunları bir consumer group olarak okur ve işledikten sonra XACK eder; pending ve reclaim iletimi at-least-once tutar.

  9. Event Routerk8s-event-routerPUBLISHPub/Subk8s-redis-pubsub

    Shard Pub/Sub'da işin kanalında gerçek zamanlı iletilir.

  10. Pub/Subk8s-redis-pubsubSUBSCRIBESSE Gatewayk8s-sse-gateway

    SSE Gateway süreç başına tek bir paylaşılan listener ile abone olur ve bağlı her tarayıcıya dağıtır.

  11. SSE Gatewayk8s-sse-gatewaySSE akışıTarayıcı

    Aynı ALB ve ingress yolu üzerinden açılan bir bağlantı. İletim at-least-once'tır; kopyalar idempotent biçimde işlenir.

  12. chat-workerk8s-worker-ai · k8s-worker-ai-2checkpointCachek8s-redis-cache

    LangGraph checkpoint'i Redis Cache'te tutulur.

  13. Cachek8s-redis-cachecheckpoint okucheckpoint-syncerk8s-worker-ai · k8s-worker-ai-2

    checkpoint-syncer, checkpoint'i Redis'ten okur.

  14. checkpoint-syncerk8s-worker-ai · k8s-worker-ai-2PostgreSQL'e eşitlePostgreSQLk8s-postgresql

    AsyncPostgresSaver onu PostgreSQL'e eşzamansız olarak kaydeder.

  15. Streamsk8s-redis-streamschat-persistence grouppersistence consumerk8s-api-chat

    Chat düğümündeki persistence consumer, done olaylarını bir consumer group olarak okur.

  16. persistence consumerk8s-api-chatmesajları kaydetPostgreSQLk8s-postgresql

    Chat mesajları PostgreSQL'e kaydedilir. Bu, checkpoint-syncer'dan farklı bir iş yüküdür.

Giriş · kimlik doğrulama

Kümenin girişinden bir Domain API'ye uzanan eşzamanlı yol. Yalnızca politikayla korunan yollar önce kimlik doğrulamayı kontrol eder; düğümler arası Pod trafiği Calico VXLAN üzerinde çalışır.

  1. TarayıcıDNS sorgusuRoute 53

    Route 53 kayıtlarından yalnızca ad çözümlenir. İstekler DNS'ten geçmez.

  2. TarayıcıHTTPS 443AWS ALB

    TLS, ALB'de sonlanır.

  3. AWS ALBHTTP · NodePortIstio ingress Envoyk8s-ingress-gateway

    EC2 instance hedefinin NodePort'u üzerinden Istio ingress Envoy'a aktarılır.

  4. Istio ingress Envoyk8s-ingress-gatewayext-authz · gRPC 50051ext-authzk8s-api-auth

    Yalnızca CUSTOM politikası altındaki yollar önce Go ext-authz'a sorar (2 sn zaman aşımı, failOpen false). login, health ve docs gibi yollar hariç tutulur.

  5. ext-authzk8s-api-authblacklist sorgusublacklistk8s-redis-auth

    Token, Redis blacklist'ine karşı kontrol edilir.

  6. Istio ingress Envoyk8s-ingress-gatewayVirtualServiceChat APIk8s-api-chat

    Chat API'ye yönlendirilir.

  7. Chat APIk8s-api-chatgRPCimages APIk8s-api-image

    README'de adı geçen chat → images eşzamanlı çağrısı.

  8. auth APIk8s-api-authgRPCusers APIk8s-api-users

    README'de adı geçen auth → users eşzamanlı çağrısı.

Storage havuzu · eşzamansız yazmalar

Kimlik doğrulama blacklist'i ve karakter sahipliği, işlerini RabbitMQ'dan alan storage havuzu worker'ları tarafından saklanır.

  1. blacklistk8s-redis-authoutbox:blacklistauth-relayk8s-worker-storage · k8s-worker-storage-2

    auth-relay (README'deki auth-Bus) Redis outbox'ını okur.

  2. auth-relayk8s-worker-storage · k8s-worker-storage-2blacklist.eventsRabbitMQk8s-rabbitmq

    Yeniden denemeler ve bir DLQ ile RabbitMQ'ya yeniden yayımlar.

  3. RabbitMQk8s-rabbitmqblacklist.eventsauth-workerk8s-worker-storage · k8s-worker-storage-2

    auth-worker blacklist olaylarını alır.

  4. auth-workerk8s-worker-storage · k8s-worker-storage-2blacklist'i kaydetblacklistk8s-redis-auth

    Redis blacklist'ine kaydedilirler.

  5. RabbitMQk8s-rabbitmqCelery batchusers-workerk8s-worker-storage · k8s-worker-storage-2

    users-worker karakter sahipliği işlerini toplu olarak alır.

  6. users-workerk8s-worker-storage · k8s-worker-storage-2UPSERTPostgreSQLk8s-postgresql

    PostgreSQL'e uygulanır.

Yapılandır · ölçekle · gözlemle

Platform Layer isteklerin geçtiği bir adım değildir; diğer katmanları dağıtır, yapılandırır, ölçekler ve gözlemler. Düğümler Terraform ile oluşturulmuş EC2 örnekleridir; kubeadm ve Calico'yu Ansible kurar. CI yalnızca Terraform'u doğrular, asla otomatik olarak apply etmez.

  1. GitHub Actions · Docker Hubimage · manifest revizyonuArgo CD image updaterk8s-master

    Argo CD, küme yapılandırmasını App-of-Apps ve Sync Wave'ler aracılığıyla hizalar. Control-plane yerleşimi yalnızca image updater için doğrulandı.

  2. ALB Controller · ExternalDNSk8s-masterIngress → ALB · DNS kayıtlarıAWS yönetimli

    ALB Controller ve ExternalDNS AWS tarafındaki kaynakları yapılandırır. Bu, isteklerin izlediği bir yol değildir.

  3. Istiodk8s-masterxDS yapılandırmasıIstio ingress Envoyk8s-ingress-gateway

    Istiod, Gateway, VirtualService ve EnvoyFilter yapılandırmasını xDS üzerinden ingress Envoy'a ve her API'nin Envoy sidecar'ına iletir.

  4. KEDAk8s-monitoringpod sayısıAI havuzuk8s-worker-ai · k8s-worker-ai-2

    KEDA worker pod sayılarını ayarlar. Düğüm sayısı değişmez.

  5. KEDAk8s-monitoringpod sayısıstorage havuzuk8s-worker-storage · k8s-worker-storage-2

    storage havuzundaki worker pod'ları da aynı şekilde ölçeklenir.

  6. Fluent BitgünlüklerElasticsearchk8s-logging

    Fluent Bit her düğümde bir DaemonSet'tir ve günlükleri Elasticsearch'e gönderir.

  7. AI havuzuk8s-worker-ai · k8s-worker-ai-2LLM çalıştırma izlemeLangSmith

    LLM çağrı izleri harici bir SaaS olan LangSmith'e gider.

Her bağlantı aynı kalınlıkta. Yalnızca yolunu numaralı adımlarla vurgulamak için bir akış seçin.

  • Düz çizgi · isteklerin, işlerin, olayların ve yazmaların akış yönü
  • Noktalı · DNS sorgusu; istekler buradan geçmez
  • Kesikli · yapılandırma ya da ölçekleme; bir veri yolu değil
  • Uzun çizgi-nokta · günlükler ve çalıştırma izleme
  • Kalın siyah çizgi · seçilen akış; numaralar sırayı verir
  • Kutu · fiziksel bir düğüm, ana makine adı başlığında
  • İç çip · o düğümde çalışan bir iş yükü
  • Kesikli çerçeve · iki düğümlü bir zamanlama havuzu
  • Kesikli kutu · kümenin dışı, düğüm olarak sayılmaz
  • Turuncu çerçeve · bir modelin karar verdiği yer
  • Control plane1 düğüm
  • Domain API8 düğüm
  • AI havuzu2 düğüm
  • storage havuzu2 düğüm
  • Data5 düğüm
  • Platform6 düğüm

README'nin beş katmanı (bantlar) ve fiziksel gruplar (her düğüm başlığının tonu) aynı 24 düğümü farklı biçimde gruplar. State KV, Streams düğümünü paylaşır ve ayrıca sayılmaz; Route 53, ALB ve küme dışındaki hizmetler düğüm değildir. Bir havuz bir zamanlama aralığıdır; her pod'un iki düğümde de çalıştığı iddiası değildir.

24 düğümlü yerleşim · January 21, 2026 tarihli pano düğüm listesinden

24düğüm

24 = 1 control plane + 8 API + 4 worker + 5 data + 6 platform

  1. 1Control plane

    role: control-plane

    kube-apiserver · scheduler · controller-manager · etcd ile platform denetleyicileri.

    1. k8s-master

  2. 8Domain API

    domain: <hizmet>

    Alan başına bir düğüm. İç çağrılar gRPC kullanır.

    1. k8s-api-auth
    2. k8s-api-users
    3. k8s-api-scan
    4. k8s-api-character
    5. k8s-api-location
    6. k8s-api-image
    7. k8s-api-chat
    8. k8s-api-info

  3. 4Execution worker

    Her biri iki düğümlü iki zamanlama havuzu. KEDA pod sayılarını değiştirir; düğüm sayısı aynı kalır.

    storage havuzudomain: worker-storage
    1. k8s-worker-storage
    2. k8s-worker-storage-2
    AI havuzudomain: worker-ai
    1. k8s-worker-ai
    2. k8s-worker-ai-2

  4. 5Data

    Redis amaca özgü dört düğüme bölünmüştür. PostgreSQL depolaması EBS CSI · gp3'tür.

    1. k8s-postgresql
    2. k8s-redis-auth
    3. k8s-redis-streams
    4. k8s-redis-cache
    5. k8s-redis-pubsub

  5. 6Platform

    Mesajlaşma, gözlemlenebilirlik, ingress ve gerçek zamanlı iletimin her birinin kendi düğümü vardır.

    1. k8s-rabbitmq
    2. k8s-monitoring
    3. k8s-logging
    4. k8s-ingress-gateway
    5. k8s-sse-gateway
    6. k8s-event-router
Her düğüm
  • Fluent Bit · DaemonSet
  • Calico

Yapılandırılmış modeller · sağlayıcıya göre

Hizmet kapatıldığı için bunlar bugün seçilebilecek modeller değil, depoda yapılandırılmış modellerdir. Her rol ayrı listelenir; doğrulanmış çalıştırmaların listesi değildir.

  • OpenAI

    Chat varsayılan sağlayıcısı

    Chat

    • openai/gpt-5.2varsayılan

    Varsayılan model gpt-5.2'dir; istekte bir model belirtilirse o kullanılır.

    Scan

    • gpt-5.2varsayılan
    • gpt-5.2-pro
    • gpt-5.1
    • gpt-5
    • gpt-5-pro
    • gpt-5-mini

    13 modellik eşlemenin dışındaki modeller reddedilir.

    Görsel eşlemesi

    • gpt-image-1.5

    Responses orkestrasyon modeli gpt-5.2'den ayrıdır. Görsel üretimi varsayılan olarak kapalıdır.

    Değerlendirme

    • gpt-4o-minivarsayılan

    Konuşma değerlendirmesi için LLM puanlayıcı; Chat modelinden ayrıdır.

  • Google

    Chat Google'ı seçtiğinde

    Chat

    • google/gemini-3-pro-preview
    • google/gemini-3-flash-preview

    Google seçildiğinde varsayılan gemini-3-flash-preview'dur.

    Scan

    • gemini-3-pro-preview
    • gemini-3-flash-preview
    • gemini-2.5-pro
    • gemini-2.5-flash
    • gemini-2.5-flash-lite
    • gemini-2.0-flash
    • gemini-2.0-flash-lite

    Görsel eşlemesi

    • gemini-3-pro-image-preview

Kaynakbackend main d8840c7Herkese açık commit September 29, 2026 · kontrol October 8, 2026