HR
Lik globusa Eco², dorađen za ovaj portfelj prema najnovijem službenom glavnom liku: nebeskoplavi globus sa zelenim kopnom, izdankom na vrhu i smeđim nasmiješenim licem
Natrag u dvoranu

Eco²

Backend · Cloud infrastructure

Upute za razvrstavanje otpada iz jedne fotografije i razgovora.

Sveobuhvatni AI asistent koji razumije kako funkcionira razvrstavanje otpada u Koreji.

2025.10.31 — 2026.02.10

Timski projekt · infrastruktura i temelj za postavljanje → domenski backend → asinkrona obrada, konverzacijski agent, verifikacija

2025 새싹 해커톤 (Saessak Hackathon)Nagrada za izvrsnost · 2025.12.02

  • Web-aplikacijaUsluga ugašena

Kako su 24 čvora stvarno povezana, tijek po tijek.

Samostalno upravljani Kubernetes izgrađen s kubeadmom. Karta smješta 24 fizička čvora i radna opterećenja na njima unutar pet slojeva iz README-a i povezuje ih stvarnim vezama. Odaberite tijek i bit će istaknut samo taj put s numeriranim koracima.

Prepoznaje otpad na fotografiji i objašnjava kako ga odložiti, a u razgovoru poziva alate za lokacije, vrijeme, cijene sekundarnih sirovina i pretraživanje weba te generira slike. U ovom timskom projektu počeo sam s klasterom i temeljem za postavljanje, a zatim proširio svoje područje na domenski backend, asinkronu obradu, konverzacijskog agenta i verifikaciju.

Od razvoja za natjecanje do jačanja backenda i rada sustava

Usluga je završila s radom; snimljeni demo i tehničko izvješće prikazuju je u radu.

Karta veza klastera · ponovno nacrtana prema manifestima i kodu na commitu a072127
Karta veza klastera Eco² · 24 čvoraKarta 24 fizička čvora unutar pet pojaseva slojeva iz README-a. Preglednik samo traži ime u Route 53; nakon što TLS završi na ALB-u na 443, Istio ingress Envoy na NodePortu šalje zahtjev domenskom API-ju. Scan API stavlja posao u red RabbitMQ i odmah vraća job_id; scan-worker u AI poolu izvodi XADD događaja napretka u Redis Streams. Event Router ih čita, ažurira State KV i objavljuje u Pub/Sub, a SSE Gateway šalje ih pregledniku. checkpoint-syncer sprema kontrolne točke Chata, a persistence consumer na čvoru Chat sprema poruke u PostgreSQL. Platform Layer nije put zahtjeva; on konfigurira, skalira i promatra.PreglednikHTTPS · SSEAWS ALB443 · ovdje završava TLSRoute 53DNSGitHub Actions · Docker Hubslika · revizija manifestaLLM APIOpenAI · GoogleLangSmithpraćenje izvođenja LLM-aFluent BitDaemonSet · svaki čvork8s-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 čvora · kubeadmEdge Layer1 čvorService Layer8 čvorova · Envoy sidecarIntegration Layer7 čvorovaPersistence Layer5 čvorovaPlatform Layer3 čvora · konfiguracija · skaliranje · promatranjeUpravlja AWSAI pooldomain: worker-aistorage pooldomain: worker-storageBez fiksnog čvora1DNS upit2 HTTPS 443 · Preglednik → AWS ALB23HTTP · NodePort4VirtualService5Zadatak Celery6 consume · RabbitMQ → scan-worker67 HTTPS · AI pool → LLM API78XADD scan:events9XREADGROUP10SETEX state11PUBLISH12SUBSCRIBE13SSE tok14Oporavak pri ponovnom povezivanju1 HTTPS 443 · Preglednik → AWS ALB12HTTP · NodePort3VirtualService4Zadatak Taskiq5 consume · RabbitMQ → chat-worker56 HTTPS · AI pool → LLM API67XADD chat:events8XREADGROUP9PUBLISH10SUBSCRIBE11SSE tok12checkpoint13čitanje kontrolne točke14sinkronizacija s PostgreSQL-om15chat-persistence group16spremanje poruka1DNS upit2 HTTPS 443 · Preglednik → AWS ALB23HTTP · NodePort4ext-authz · gRPC 500515provjera crne liste6VirtualService7gRPC8gRPC1outbox:blacklist2blacklist.events3 blacklist.events · RabbitMQ → auth-worker34spremanje crne liste5 Celery batch · RabbitMQ → users-worker56UPSERT1slika · revizija manifesta2Ingress → ALB · DNS zapisi3xDS konfiguracija4broj podova5 broj podova · KEDA → storage pool56zapisnici7 praćenje izvođenja LLM-a · AI pool → LangSmith7

Zahtjev Scan → isporuka uživo

Zahtjev za analizu fotografije postaje posao u redu, a njegovi se događaji napretka vraćaju u isti preglednik.

  1. PreglednikDNS upitRoute 53

    Iz zapisa Route 53 razrješava se samo ime. Zahtjevi ne prolaze kroz DNS.

  2. PreglednikHTTPS 443AWS ALB

    TLS završava na ALB-u.

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

    Predaje se Istio ingress Envoyju preko NodePorta EC2 instance targeta.

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

    Usmjerava se na Scan API, koji stavlja posao u red i odmah vraća job_id; upit za rezultat odgovara s 202 dok posao ne završi.

  5. Scan APIk8s-api-scanZadatak CeleryRabbitMQk8s-rabbitmq

    Zadatak Scan ide u RabbitMQ.

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

    scan-worker (Celery · gevent) u AI poolu preuzima ga i izvodi Vision → Rule → Answer → Reward. Četiri faze ulančani su zadaci Celery, a ne čvorovi.

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

    Workeri scan i chat pozivaju API-je OpenAI i Google.

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

    Događaji napretka zapisuju se u jedan od četiri sharda Streams.

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

    Event Router čita ih kao consumer group i nakon obrade izvodi XACK; pending i reclaim održavaju isporuku at-least-once.

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

    Zapisuje najnovije stanje i oznaku dvostruke obrade u State KV na istom čvoru Redis.

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

    Isporučuje se u stvarnom vremenu kanalom posla u shardiranom Pub/Subu.

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

    SSE Gateway se pretplaćuje preko jednog dijeljenog listenera po procesu i raspodjeljuje svakom povezanom pregledniku.

  13. SSE Gatewayk8s-sse-gatewaySSE tokPreglednik

    Veza otvorena istim putom kroz ALB i ingress. Isporuka je at-least-once; duplikati se obrađuju idempotentno.

  14. State KVk8s-redis-streamsOporavak pri ponovnom povezivanjuSSE Gatewayk8s-sse-gateway

    Pri ponovnom povezivanju s Last-Event-ID State KV i sačuvani Streams popunjavaju propuštene događaje.

Chat · tokeni i pohrana

Tokeni Chata idu istim putom događaja kao Scan; kontrolne točke i poruke spremaju dva različita radna opterećenja.

  1. PreglednikHTTPS 443AWS ALB

    TLS završava na ALB-u.

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

    Predaje se Istio ingress Envoyju preko NodePorta EC2 instance targeta.

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

    Usmjerava se na Chat API.

  4. Chat APIk8s-api-chatZadatak TaskiqRabbitMQk8s-rabbitmq

    Zadatak Chat ide u RabbitMQ.

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

    chat-worker (Taskiq · asyncio) s LangGraphom klasificira namjeru, zatim po potrebi izvodi vision, odabrane alate, aggregator i po potrebi sažetak te odgovara. Svaki zahtjev izvodi samo grane koje su mu potrebne.

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

    Workeri scan i chat pozivaju API-je OpenAI i Google.

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

    Tokeni i događaji faza zapisuju se u četiri sharda Streams; odatle je put isporuke isti kao kod Scana.

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

    Event Router čita ih kao consumer group i nakon obrade izvodi XACK; pending i reclaim održavaju isporuku at-least-once.

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

    Isporučuje se u stvarnom vremenu kanalom posla u shardiranom Pub/Subu.

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

    SSE Gateway se pretplaćuje preko jednog dijeljenog listenera po procesu i raspodjeljuje svakom povezanom pregledniku.

  11. SSE Gatewayk8s-sse-gatewaySSE tokPreglednik

    Veza otvorena istim putom kroz ALB i ingress. Isporuka je at-least-once; duplikati se obrađuju idempotentno.

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

    Kontrolna točka LangGrapha čuva se u Redis Cacheu.

  13. Cachek8s-redis-cachečitanje kontrolne točkecheckpoint-syncerk8s-worker-ai · k8s-worker-ai-2

    checkpoint-syncer čita kontrolnu točku iz Redisa.

  14. checkpoint-syncerk8s-worker-ai · k8s-worker-ai-2sinkronizacija s PostgreSQL-omPostgreSQLk8s-postgresql

    AsyncPostgresSaver je asinkrono sprema u PostgreSQL.

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

    persistence consumer na čvoru Chat čita događaje done kao consumer group.

  16. persistence consumerk8s-api-chatspremanje porukaPostgreSQLk8s-postgresql

    Poruke Chata spremaju se u PostgreSQL. To je drugo radno opterećenje od checkpoint-syncera.

Ulaz · autentikacija

Sinkroni put od ulaza u klaster do domenskog API-ja. Samo putovi pod politikom najprije provjeravaju autentikaciju; promet podova između čvorova ide preko Calico VXLAN-a.

  1. PreglednikDNS upitRoute 53

    Iz zapisa Route 53 razrješava se samo ime. Zahtjevi ne prolaze kroz DNS.

  2. PreglednikHTTPS 443AWS ALB

    TLS završava na ALB-u.

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

    Predaje se Istio ingress Envoyju preko NodePorta EC2 instance targeta.

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

    Samo putovi pod politikom CUSTOM najprije pitaju Go ext-authz (timeout 2 s, failOpen false). Putovi poput login, health i docs izuzeti su.

  5. ext-authzk8s-api-authprovjera crne listeblacklistk8s-redis-auth

    Token se provjerava prema crnoj listi u Redisu.

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

    Usmjerava se na Chat API.

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

    Sinkroni poziv chat → images naveden u README-u.

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

    Sinkroni poziv auth → users naveden u README-u.

Storage pool · asinkrono spremanje

Crnu listu autentikacije i vlasništvo nad likovima spremaju workeri storage poola koji preuzimaju posao iz RabbitMQ-a.

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

    auth-relay (auth-Bus u README-u) čita Redis outbox.

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

    Ponovno objavljuje u RabbitMQ, s ponovnim pokušajima i DLQ-om.

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

    auth-worker prima događaje crne liste.

  4. auth-workerk8s-worker-storage · k8s-worker-storage-2spremanje crne listeblacklistk8s-redis-auth

    Spremaju se u crnu listu u Redisu.

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

    users-worker prima poslove vlasništva nad likovima u paketima.

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

    Primjenjuju se u PostgreSQL-u.

Konfiguracija · skaliranje · promatranje

Platform Layer nije korak kroz koji prolaze zahtjevi; on postavlja, konfigurira, skalira i promatra ostale slojeve. Čvorovi su EC2 instance izrađene Terraformom, s kubeadmom i Calicom instaliranima pomoću Ansiblea; CI samo provjerava Terraform i nikad ga ne primjenjuje automatski.

  1. GitHub Actions · Docker Hubslika · revizija manifestaArgo CD image updaterk8s-master

    Argo CD usklađuje konfiguraciju klastera kroz App-of-Apps i Sync Waves. Potvrđen je samo smještaj image updatera na control-planeu.

  2. ALB Controller · ExternalDNSk8s-masterIngress → ALB · DNS zapisiUpravlja AWS

    ALB Controller i ExternalDNS konfiguriraju resurse na strani AWS-a. To nije put kojim prolaze zahtjevi.

  3. Istiodk8s-masterxDS konfiguracijaIstio ingress Envoyk8s-ingress-gateway

    Istiod šalje konfiguraciju Gateway, VirtualService i EnvoyFilter preko xDS-a ingress Envoyju i Envoy sidecaru svakog API-ja.

  4. KEDAk8s-monitoringbroj podovaAI poolk8s-worker-ai · k8s-worker-ai-2

    KEDA prilagođava broj podova workera. Broj čvorova se ne mijenja.

  5. KEDAk8s-monitoringbroj podovastorage poolk8s-worker-storage · k8s-worker-storage-2

    Podovi workera u storage poolu skaliraju se na isti način.

  6. Fluent BitzapisniciElasticsearchk8s-logging

    Fluent Bit je DaemonSet na svakom čvoru i šalje zapisnike u Elasticsearch.

  7. AI poolk8s-worker-ai · k8s-worker-ai-2praćenje izvođenja LLM-aLangSmith

    Tragovi poziva LLM-a idu u LangSmith, vanjski SaaS.

Sve veze iste debljine. Odaberite tijek kako biste istaknuli samo njegov put s numeriranim koracima.

  • Puna crta · smjer kojim teku zahtjevi, poslovi, događaji i zapisivanja
  • Točkasta crta · DNS upit; zahtjevi ne prolaze kroz njega
  • Isprekidana crta · konfiguracija ili skaliranje; nije put podataka
  • Duga crta-točka · zapisnici i praćenje izvođenja
  • Debela crna crta · odabrani tijek; brojevi daju redoslijed
  • Okvir · fizički čvor, naziv hosta u zaglavlju
  • Unutarnja pločica · radno opterećenje na tom čvoru
  • Isprekidani okvir · pool za raspoređivanje s dva čvora
  • Isprekidani okvir · izvan klastera, ne broji se kao čvor
  • Narančasti obrub · mjesto gdje model odlučuje
  • Control plane1 čvor
  • Domain API8 čvorova
  • AI pool2 čvora
  • storage pool2 čvora
  • Data5 čvorova
  • Platform6 čvorova

Pet slojeva iz README-a (pojasevi) i fizičke skupine (nijansa zaglavlja svakog čvora) različito grupiraju istih 24 čvora. State KV dijeli čvor sa Streams i ne broji se zasebno; Route 53, ALB i usluge izvan klastera nisu čvorovi. Pool je raspon raspoređivanja, a ne tvrdnja da svaki pod radi na oba čvora.

Raspored od 24 čvora · prema popisu čvorova na nadzornoj ploči od January 21, 2026

24čvorova

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

  1. 1Control plane

    role: control-plane

    kube-apiserver · scheduler · controller-manager · etcd te kontroleri platforme.

    1. k8s-master

  2. 8Domain API

    domain: <usluga>

    Jedan čvor po domeni. Interni pozivi koriste 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 poola za raspoređivanje s po dva čvora. KEDA mijenja broj podova; broj čvorova ostaje isti.

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

  4. 5Data

    Redis je prema namjeni podijeljen na četiri čvora. Pohrana za 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

    Razmjena poruka, opažljivost, ingress i isporuka u stvarnom vremenu imaju svaki svoj čvor.

    1. k8s-rabbitmq
    2. k8s-monitoring
    3. k8s-logging
    4. k8s-ingress-gateway
    5. k8s-sse-gateway
    6. k8s-event-router
Svaki čvor
  • Fluent Bit · DaemonSet
  • Calico

Konfigurirani modeli · po pružatelju

Usluga je ugašena, pa su to modeli konfigurirani u repozitoriju, a ne izbori dostupni danas. Svaka je uloga navedena zasebno; ovo nije popis provjerenih izvođenja.

  • OpenAI

    Zadani pružatelj Chata

    Chat

    • openai/gpt-5.2zadano

    Zadani model je gpt-5.2; model naveden u zahtjevu koristi se umjesto njega.

    Scan

    • gpt-5.2zadano
    • gpt-5.2-pro
    • gpt-5.1
    • gpt-5
    • gpt-5-pro
    • gpt-5-mini

    Modeli izvan mapiranja od 13 modela odbijaju se.

    Mapiranje slika

    • gpt-image-1.5

    Odvojeno od gpt-5.2, modela za orkestraciju Responses. Generiranje slika prema zadanim je postavkama isključeno.

    Evaluacija

    • gpt-4o-minizadano

    LLM grader za evaluaciju razgovora, odvojen od modela Chata.

  • Google

    Kad Chat odabere Google

    Chat

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

    Kad je odabran Google, zadan je 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

    Mapiranje slika

    • gemini-3-pro-image-preview

Izvorbackend main d8840c7Javni commit September 29, 2026 · provjereno October 8, 2026