SK
Postava glóbusu Eco², upravená pre toto portfólio podľa najnovšej oficiálnej hlavnej postavy: blankytne modrý glóbus so zelenou pevninou, klíčkom na temene a hnedou usmiatou tvárou
Späť do sály

Eco²

Backend · Cloud infrastructure

Rady k triedeniu odpadu z jednej fotky a rozhovoru.

Univerzálny asistent AI, ktorý rozumie tomu, ako funguje triedenie odpadu v Kórei.

2025.10.31 — 2026.02.10

Tímový projekt · základ infraštruktúry a nasadenia → doménový backend → asynchrónne spracovanie, konverzačný agent, overovanie

2025 새싹 해커톤 (Saessak Hackathon)Cena za excelentnosť · 2025.12.02

  • Webová aplikáciaSlužba ukončená

Ako sa 24 uzlov skutočne prepája, tok po toku.

Samostatne spravovaný Kubernetes zostavený pomocou kubeadm. Mapa umiestňuje 24 fyzických uzlov a workloady na nich do piatich vrstiev z README a spája ich skutočnými spojeniami. Výber toku zvýrazní len túto cestu s očíslovanými krokmi.

Rozpozná odpad na fotografii a vysvetlí, ako s ním naložiť, a v konverzácii volá nástroje pre miesta, počasie, výkupné ceny druhotných surovín a vyhľadávanie na webe a generuje obrázky. V tomto tímovom projekte sa môj rozsah začal pri klastri a základe nasadenia a postupne sa rozšíril o doménový backend, asynchrónne spracovanie, konverzačného agenta a overovanie.

Od súťažného vývoja po spevnenie backendu a prevádzky

Služba ukončila prevádzku; nahraté demo a technická správa ju ukazujú v činnosti.

Mapa spojení klastra · prekreslené z manifestov a kódu v commite a072127
Mapa spojení klastra Eco² · 24 uzlovMapa 24 fyzických uzlov v piatich pásoch vrstiev z README. Prehliadač len vyhľadá názov v Route 53; po ukončení TLS na ALB na porte 443 odovzdá ingress Envoy Istio na NodePort požiadavku doménovému API. Scan API zaradí prácu do RabbitMQ a okamžite vráti job_id; scan-worker v poole AI zapisuje (XADD) udalosti o postupe do Redis Streams. Event Router ich číta, aktualizuje State KV a publikuje do Pub/Sub a SSE Gateway ich posiela do prehliadača. checkpoint-syncer ukladá checkpointy Chat a persistence consumer na uzle Chat ukladá správy do PostgreSQL. Platform Layer nie je cestou požiadaviek; konfiguruje, škáluje a pozoruje.PrehliadačHTTPS · SSEAWS ALB443 · tu končí TLSRoute 53DNSGitHub Actions · Docker Hubobraz · revízia manifestuLLM APIOpenAI · GoogleLangSmithtrasovanie behov LLMFluent BitDaemonSet · každý uzolk8s-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-memoryKlaster Kubernetes24 uzlov · kubeadmEdge Layer1 uzolService Layer8 uzlov · Envoy sidecarIntegration Layer7 uzlovPersistence Layer5 uzlovPlatform Layer3 uzly · konfigurácia · škálovanie · pozorovanieSpravované AWSPool AIdomain: worker-aipool storagedomain: worker-storageBez pripnutého uzla1dopyt DNS2 HTTPS 443 · Prehliadač → AWS ALB23HTTP · NodePort4VirtualService5Úloha Celery6 consume · RabbitMQ → scan-worker67 HTTPS · Pool AI → LLM API78XADD scan:events9XREADGROUP10SETEX state11PUBLISH12SUBSCRIBE13Stream SSE14Obnova po opätovnom pripojení1 HTTPS 443 · Prehliadač → AWS ALB12HTTP · NodePort3VirtualService4Úloha Taskiq5 consume · RabbitMQ → chat-worker56 HTTPS · Pool AI → LLM API67XADD chat:events8XREADGROUP9PUBLISH10SUBSCRIBE11Stream SSE12checkpoint13čítanie checkpointu14synchronizácia do PostgreSQL15chat-persistence group16uloženie správ1dopyt DNS2 HTTPS 443 · Prehliadač → AWS ALB23HTTP · NodePort4ext-authz · gRPC 500515vyhľadanie v blackliste6VirtualService7gRPC8gRPC1outbox:blacklist2blacklist.events3 blacklist.events · RabbitMQ → auth-worker34uloženie blacklistu5 Celery batch · RabbitMQ → users-worker56UPSERT1obraz · revízia manifestu2Ingress → ALB · záznamy DNS3konfigurácia xDS4počet podov5 počet podov · KEDA → pool storage56logy7 trasovanie behov LLM · Pool AI → LangSmith7

Požiadavka Scan → živé doručenie

Požiadavka na analýzu fotografie sa stane prácou vo fronte a jej udalosti o postupe sa vracajú do toho istého prehliadača.

  1. Prehliadačdopyt DNSRoute 53

    Zo záznamov Route 53 sa prekladá len názov. Požiadavky cez DNS neprechádzajú.

  2. PrehliadačHTTPS 443AWS ALB

    TLS končí na ALB.

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

    Odovzdané ingress Envoy Istio cez NodePort cieľa typu inštancia EC2.

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

    Smerované do Scan API, ktoré prácu zaradí do frontu a okamžite vráti job_id; dopyt na výsledok odpovedá 202, kým úloha neskončí.

  5. Scan APIk8s-api-scanÚloha CeleryRabbitMQk8s-rabbitmq

    Úloha Scan ide do RabbitMQ.

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

    scan-worker (Celery · gevent) v poole AI ju prevezme a spustí Vision → Rule → Answer → Reward. Štyri fázy sú zreťazené úlohy Celery, nie uzly.

  7. Pool AIk8s-worker-ai · k8s-worker-ai-2HTTPSLLM API

    Workery scan a chat volajú API OpenAI a Google.

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

    Udalosti o postupe sa zapisujú do jedného zo štyroch shardov Streams.

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

    Event Router ich číta ako consumer group a po spracovaní vykoná XACK; pending a reclaim udržiavajú doručenie typu at-least-once.

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

    Zapisuje najnovší stav a značku duplicitného spracovania do State KV na tom istom uzle Redis.

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

    Doručované v reálnom čase na kanáli úlohy v shardovanom Pub/Sub.

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

    SSE Gateway sa prihlasuje na odber cez jeden zdieľaný listener na proces a rozosiela do každého pripojeného prehliadača.

  13. SSE Gatewayk8s-sse-gatewayStream SSEPrehliadač

    Spojenie otvorené tou istou cestou cez ALB a ingress. Doručenie typu at-least-once; duplicity sa spracúvajú idempotentne.

  14. State KVk8s-redis-streamsObnova po opätovnom pripojeníSSE Gatewayk8s-sse-gateway

    Po opätovnom pripojení s Last-Event-ID doplnia State KV a uchované Streams zmeškané udalosti.

Chat · tokeny a ukladanie

Tokeny Chat idú tou istou cestou udalostí ako Scan; checkpointy a správy ukladajú dva rôzne workloady.

  1. PrehliadačHTTPS 443AWS ALB

    TLS končí na ALB.

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

    Odovzdané ingress Envoy Istio cez NodePort cieľa typu inštancia EC2.

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

    Smerované do Chat API.

  4. Chat APIk8s-api-chatÚloha TaskiqRabbitMQk8s-rabbitmq

    Úloha Chat ide do RabbitMQ.

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

    chat-worker (Taskiq · asyncio) klasifikuje zámer pomocou LangGraph, potom podľa potreby spustí vision, vybrané nástroje, aggregator a podľa potreby zhrnutie a odpovie. Každá požiadavka spúšťa len vetvy, ktoré potrebuje.

  6. Pool AIk8s-worker-ai · k8s-worker-ai-2HTTPSLLM API

    Workery scan a chat volajú API OpenAI a Google.

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

    Tokeny a udalosti fáz sa zapisujú do štyroch shardov Streams; odtiaľ je cesta doručenia rovnaká ako pri Scan.

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

    Event Router ich číta ako consumer group a po spracovaní vykoná XACK; pending a reclaim udržiavajú doručenie typu at-least-once.

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

    Doručované v reálnom čase na kanáli úlohy v shardovanom Pub/Sub.

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

    SSE Gateway sa prihlasuje na odber cez jeden zdieľaný listener na proces a rozosiela do každého pripojeného prehliadača.

  11. SSE Gatewayk8s-sse-gatewayStream SSEPrehliadač

    Spojenie otvorené tou istou cestou cez ALB a ingress. Doručenie typu at-least-once; duplicity sa spracúvajú idempotentne.

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

    Checkpoint LangGraph sa uchováva v Redis Cache.

  13. Cachek8s-redis-cachečítanie checkpointucheckpoint-syncerk8s-worker-ai · k8s-worker-ai-2

    checkpoint-syncer číta checkpoint z Redis.

  14. checkpoint-syncerk8s-worker-ai · k8s-worker-ai-2synchronizácia do PostgreSQLPostgreSQLk8s-postgresql

    AsyncPostgresSaver ho asynchrónne ukladá do PostgreSQL.

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

    Persistence consumer na uzle Chat číta udalosti done ako consumer group.

  16. persistence consumerk8s-api-chatuloženie správPostgreSQLk8s-postgresql

    Správy Chat sa ukladajú do PostgreSQL. Je to iný workload ako checkpoint-syncer.

Vstup · autentifikácia

Synchrónna cesta od vstupu do klastra k doménovému API. Autentifikáciu najprv kontrolujú len cesty chránené politikou; prevádzka podov medzi uzlami beží na Calico VXLAN.

  1. Prehliadačdopyt DNSRoute 53

    Zo záznamov Route 53 sa prekladá len názov. Požiadavky cez DNS neprechádzajú.

  2. PrehliadačHTTPS 443AWS ALB

    TLS končí na ALB.

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

    Odovzdané ingress Envoy Istio cez NodePort cieľa typu inštancia EC2.

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

    Len cesty pod politikou CUSTOM sa najprv pýtajú Go ext-authz (timeout 2 s, failOpen false). Cesty ako prihlásenie, health a docs sú vylúčené.

  5. ext-authzk8s-api-authvyhľadanie v blacklisteblacklistk8s-redis-auth

    Token sa kontroluje voči blacklistu v Redis.

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

    Smerované do Chat API.

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

    Synchrónne volanie chat → images uvedené v README.

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

    Synchrónne volanie auth → users uvedené v README.

Pool storage · asynchrónne zápisy

Blacklist autentifikácie a vlastníctvo postáv ukladajú workery poolu storage, ktoré berú prácu z RabbitMQ.

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

    auth-relay (auth-Bus z README) číta outbox v Redis.

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

    Znova publikuje do RabbitMQ, s opakovaním a DLQ.

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

    auth-worker prijíma udalosti blacklistu.

  4. auth-workerk8s-worker-storage · k8s-worker-storage-2uloženie blacklistublacklistk8s-redis-auth

    Ukladajú sa do blacklistu v Redis.

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

    users-worker prijíma prácu na vlastníctve postáv v dávkach.

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

    Tá sa premieta do PostgreSQL.

Konfigurácia · škálovanie · pozorovanie

Platform Layer nie je krokom, ktorým prechádzajú požiadavky; nasadzuje, konfiguruje, škáluje a pozoruje ostatné vrstvy. Uzly sú inštancie EC2 vytvorené pomocou Terraform, s kubeadm a Calico nainštalovanými cez Ansible; CI Terraform len validuje a nikdy ho automaticky neaplikuje.

  1. GitHub Actions · Docker Hubobraz · revízia manifestuArgo CD image updaterk8s-master

    Argo CD zosúlaďuje konfiguráciu klastra cez App-of-Apps a Sync Waves. Potvrdené bolo len umiestnenie image updatera na control-plane.

  2. ALB Controller · ExternalDNSk8s-masterIngress → ALB · záznamy DNSSpravované AWS

    ALB Controller a ExternalDNS konfigurujú prostriedky na strane AWS. Nejde o cestu, ktorou prechádzajú požiadavky.

  3. Istiodk8s-masterkonfigurácia xDSIstio ingress Envoyk8s-ingress-gateway

    Istiod posiela konfiguráciu Gateway, VirtualService a EnvoyFilter cez xDS do ingress Envoy a do sidecaru Envoy každého API.

  4. KEDAk8s-monitoringpočet podovPool AIk8s-worker-ai · k8s-worker-ai-2

    KEDA upravuje počet podov workerov. Počet uzlov sa nemení.

  5. KEDAk8s-monitoringpočet podovpool storagek8s-worker-storage · k8s-worker-storage-2

    Pody workerov v poole storage sa škálujú rovnako.

  6. Fluent BitlogyElasticsearchk8s-logging

    Fluent Bit je DaemonSet na každom uzle a posiela logy do Elasticsearch.

  7. Pool AIk8s-worker-ai · k8s-worker-ai-2trasovanie behov LLMLangSmith

    Stopy volaní LLM idú do LangSmith, externej služby SaaS.

Každé spojenie s rovnakou váhou. Výber toku zvýrazní len jeho cestu s očíslovanými krokmi.

  • Plná čiara · smer toku požiadaviek, práce, udalostí a zápisov
  • Bodkovaná · dopyt DNS; požiadavky ním neprechádzajú
  • Prerušovaná čiara · konfigurácia alebo škálovanie; nie je to dátová cesta
  • Dlhá bodkočiarkovaná · logy a trasovanie behov
  • Hrubá čierna čiara · zvolený tok; čísla udávajú poradie
  • Rámček · fyzický uzol, názov hostiteľa v hlavičke
  • Vnútorný štítok · workload bežiaci na tomto uzle
  • Prerušovaný rám · dvojuzlový plánovací pool
  • Prerušovaný rámček · mimo klastra, nepočíta sa ako uzol
  • Oranžový obrys · miesto, kde rozhoduje model
  • Control plane1 uzol
  • Domain API8 uzlov
  • Pool AI2 uzly
  • pool storage2 uzly
  • Data5 uzlov
  • Platform6 uzlov

Päť vrstiev z README (pásy) a fyzické skupiny (odtieň hlavičky každého uzla) zoskupujú tie isté 24 uzly inak. State KV zdieľa uzol so Streams a nepočíta sa osobitne; Route 53, ALB a služby mimo klastra nie sú uzly. Pool je rozsah plánovania, nie tvrdenie, že každý pod beží na oboch uzloch.

Rozvrhnutie 24 uzlov · podľa zoznamu uzlov z dashboardu z January 21, 2026

24uzlov

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

  1. 1Control plane

    role: control-plane

    kube-apiserver · scheduler · controller-manager · etcd a platformové kontroléry.

    1. k8s-master

  2. 8Domain API

    domain: <služba>

    Jeden uzol na doménu. Interné volania používajú gRPC.

    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

    Dva plánovacie pooly po dvoch uzloch. KEDA mení počet podov; počet uzlov zostáva rovnaký.

    pool storagedomain: worker-storage
    1. k8s-worker-storage
    2. k8s-worker-storage-2
    Pool AIdomain: worker-ai
    1. k8s-worker-ai
    2. k8s-worker-ai-2

  4. 5Data

    Redis je rozdelený podľa účelu na štyri uzly. Úložisko PostgreSQL je EBS CSI · gp3.

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

  5. 6Platform

    Zasielanie správ, pozorovateľnosť, ingress a doručovanie v reálnom čase majú každé vlastný uzol.

    1. k8s-rabbitmq
    2. k8s-monitoring
    3. k8s-logging
    4. k8s-ingress-gateway
    5. k8s-sse-gateway
    6. k8s-event-router
Každý uzol
  • Fluent Bit · DaemonSet
  • Calico

Nastavené modely · podľa poskytovateľa

Služba bola ukončená, takže ide o modely nastavené v repozitári, nie o dnes dostupné voľby. Každá rola je uvedená osobitne; nejde o zoznam overených behov.

  • OpenAI

    Predvolený poskytovateľ Chat

    Chat

    • openai/gpt-5.2predvolený

    Predvoleným modelom je gpt-5.2; model uvedený v požiadavke má prednosť.

    Scan

    • gpt-5.2predvolený
    • gpt-5.2-pro
    • gpt-5.1
    • gpt-5
    • gpt-5-pro
    • gpt-5-mini

    Modely mimo mapovania 13 modelov sa odmietajú.

    Mapovanie obrázkov

    • gpt-image-1.5

    Oddelený od gpt-5.2, orchestračného modelu Responses. Generovanie obrázkov je predvolene vypnuté.

    Evaluácia

    • gpt-4o-minipredvolený

    Hodnotiteľ LLM na evaluáciu konverzácií, oddelený od modelu Chat.

  • Google

    Keď Chat zvolí Google

    Chat

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

    Pri zvolenom Google je predvolený gemini-3-flash-preview.

    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

    Mapovanie obrázkov

    • gemini-3-pro-image-preview

Zdrojbackend main d8840c7Verejný commit September 29, 2026 · overené October 8, 2026