Web razvoj
Next.jsStvarno vrijemeWebSocketsSSEArhitekturaReact QuerySWR

Obavijesti u stvarnom vremenu u Next.js-u (App Router): SSE vs WebSockets, fanout i jamstva isporuke

AO
Adrijan Omićević
·15 min čitanja

# Što ćete izgraditi i zašto je to važno#

"Next.js obavijesti u stvarnom vremenu" zvuči jednostavno dok ne naletite na produkcijska ograničenja: serverless timeoute, troškove fanouta, oluje ponovnog spajanja i korisnike koji propuštaju događaje dok su offline.

Ovaj vodič prikazuje pragmatičnu arhitekturu koja radi s Next.js App Routerom: isporuku u stvarnom vremenu preko SSE ili WebSockets, perzistenciju kroz inbox tablicu, stanja pročitanosti i fallback strategiju pollinga uz React Query ili SWR. Također ćete naučiti kako odabrati između SSE i WebSockets za isporuku obavijesti i značajke slične presenceu, uključujući ograničenja skaliranja.

Ako želite širi pregled real-time opcija u Next.js-u, pročitajte Real-time značajke u Next.js-u s WebSockets, SSE i Supabase Realtime.

# Preduvjeti#

ZahtjevVerzijaNapomene
Next.js14 ili 15Primjeri za App Router pretpostavljaju moderne route handlere
Node.js18+20+ preporučeno u 2026. radi performansi i sigurnosnih ažuriranja
BazaPreporučen PostgresPotrebno za perzistenciju inboxa i stanje pročitanosti
Cache ili pub-subRedis ili upravljani pub-subKoristi se za fanout između instanci
Osnovna autentikacijaBilo kojaPrimjeri pretpostavljaju da na serveru možete identificirati user ID

# Pregled arhitekture: Ne isporučujte obavijesti kao “samo evente”#

Real-time transport nije proizvod. Obavijesti su produktna značajka s UX i zahtjevima pouzdanosti.

Produkcijski spreman model obično uključuje:

  1. 1
    Trajni inbox za svakog korisnika, u bazi (tablica).
  2. 2
    Real-time transport za smanjenje percipirane latencije.
  3. 3
    Idempotentnu isporuku kako reconnect ne bi stvarao duplikate.
  4. 4
    Stanje pročitano/nepročitano s vremenskim oznakama i opcionalno semantikom po uređaju.
  5. 5
    Fallback polling za okruženja gdje real-time konekcije ne rade.
  6. 6
    Observability kako biste mogli debugirati propuštene obavijesti i latenciju.

🎯 Ključna poruka: Real-time transport je optimizacija. Jamstva isporuke dolaze iz perzistencije plus usklađivanja (reconciliation).

# SSE vs WebSockets za Next.js obavijesti u stvarnom vremenu#

SSE i WebSockets rješavaju različite probleme. Obavijesti su najčešće server→klijent, dolaze u naletima (bursty) i toleriraju mala kašnjenja. Značajke nalik presenceu su dvosmjerne i zahtijevaju česte klijent→server heartbeatove.

Tablica usporedbe: obavijesti, presence i ograničenja skaliranja#

KriterijSSEWebSockets
SmjerServer prema klijentuFull duplex
Najbolje zaObavijesti, feedove, status updateovePresence, chat, kolaborativne kursore, indikatore tipkanja
Podrška u preglednicimaIzvrsnaIzvrsna
“Proxy friendliness”Vrlo dobra, koristi HTTPPonekad problematično s korporativnim proxyjima
Ponašanje pri reconnectuUgrađen retry i Last-Event-ID obrasciMorate implementirati backoff i logiku ponovne pretplate
Uokvirivanje porukaPo defaultu samo tekstBinarno i tekst
Troškovni profilJedna HTTP konekcija po klijentuJedan socket po klijentu, često više infrastrukture
Kompatibilnost sa serverlessomOvisi o podršci platforme za streaming responseČesto zahtijeva specijaliziranu WS podršku ili upravljani servis
Točnost presenceaOgraničenaSnažna, uz heartbeatove i server-side stanje
Jamstva isporukeNisu ugrađenaNisu ugrađena

SSE za obavijesti: Zašto često pobjeđuje#

SSE je tipično najjednostavniji način za isporuku "Next.js obavijesti u stvarnom vremenu" kada trebate samo server→klijent evente:

  • Radi preko HTTP-a i obično se dobro slaže s load balancerima i proxyjima.
  • Automatsko ponovno spajanje u preglednicima čini ga otpornim.
  • Mentalni model je bliži “streamu događaja” nego socket protokolu.

Gdje SSE može boljeti:

  • Skaliranje: i dalje održavate jednu otvorenu konekciju po klijentu, što utječe na memoriju i file descriptore.
  • Fanout na više instanci: trebate zajednički pub-sub sloj, inače svaka instanca zna samo za svoje povezane klijente.
  • Presence: bez klijent→server heartbeatova, sam SSE ne može pouzdano pratiti online status.

WebSockets za presence i interaktivni real-time#

Koristite WebSockets kada trebate:

  • Presence, last-seen i točne “online sada” indikatore
  • Dvosmjerne evente poput “mark as read” bez dodatnih HTTP poziva
  • Visokofrekventne klijentske evente, npr. kolaborativne promjene

Gdje WebSockets mogu boljeti:

  • Složenost infrastrukture: sticky sessions ili zajedničko stanje, plus pažljivo upravljanje backpressureom.
  • Serverless ograničenja: dugotrajni socketi ne uklapaju se u osnovni lifecycle serverless requesta.
  • Semantika reconnecta: morate dizajnirati resubscribe flow, replay i idempotentnost.

⚠️ Upozorenje: Ako implementirate WebSockets i isporučujete samo efemerne evente, korisnici će promašiti obavijesti kad su offline. Uvijek dodajte inbox i usklađivanje pri reconnectu.

# Jamstva isporuke: Što možete, a što ne možete obećati#

Većina timova želi “exactly once delivery”. U stvarnim mrežama, “exactly once” je skupo i često nepotrebno.

Pragmatičan cilj je:

  • Najmanje jednom u inbox: perzistirana obavijest postoji jednom, jedinstveno identificirana.
  • Najmanje jednom u real-timeu: UI može primiti duplikate, ali klijent deduplicira po ID-u.
  • Eventualno konzistentno stanje pročitanosti: pročitano/nepročitano je točno nakon retryja i usklađivanja.

Eksplicitno definirajte stanja obavijesti#

Ako ne modelirate isporuku, ne možete debugirati isporuku.

Uobičajena stanja i timestampovi:

PoljeTipZašto je važno
created_attimestampSortiranje i audit
delivered_attimestamp nullableOpcionalno, označava da ga je uređaj vidio
read_attimestamp nullableBroj nepročitanih i UX
archived_attimestamp nullableOpcionalno, za čišćenje inboxa
client_last_seen_idbigint ili uuidPomaže uskladiti propuštene evente

# Podatkovni model: Inbox tablica i obrasci stanja pročitanosti#

Jedna “notifications” tablica nije dovoljna kada više korisnika može primiti isti event (fanout) i kada je stanje pročitanosti po primatelju.

Provjeren pristup:

  • notification_events sprema kanonički payload eventa jednom.
  • notification_inbox sprema stanje isporuke i pročitanosti po korisniku.

Preporučene tablice#

TablicaKljučni stupciSvrha
notification_eventsid, type, payload, created_atNeizmjenjivi podaci eventa
notification_inboxid, user_id, event_id, read_at, created_atRedak inboxa po korisniku
notification_devices (opcionalno)id, user_id, device_id, last_seen_atSinkronizacija pročitanosti po uređaju i metrike isporuke

Primjer Postgres DDL-a (minimalno)#

SQL
CREATE TABLE notification_events (
  id uuid PRIMARY KEY,
  type text NOT NULL,
  payload jsonb NOT NULL,
  created_at timestamptz NOT NULL DEFAULT now()
);
 
CREATE TABLE notification_inbox (
  id uuid PRIMARY KEY,
  user_id uuid NOT NULL,
  event_id uuid NOT NULL REFERENCES notification_events(id),
  read_at timestamptz NULL,
  created_at timestamptz NOT NULL DEFAULT now(),
  UNIQUE (user_id, event_id)
);
 
CREATE INDEX notification_inbox_user_created_idx
  ON notification_inbox (user_id, created_at DESC);

Ovo omogućuje:

  • Dedupliciranje po korisniku preko UNIQUE (user_id, event_id)
  • Brze izračune nepročitanih s WHERE read_at IS NULL
  • Replay iz DB-a kada se klijent ponovno spoji

💡 Savjet: Neka notification_events.payload bude kompaktan. Veliki payloadi povećavaju troškove i u DB-u i na mreži. Spremite ID-eve i dohvaćajte detalje lijeno (lazy) kad korisnik otvori obavijest.

# Fanout obrasci: Kako obavijesti stižu do mnogo korisnika#

Fanout znači da se jedan event može isporučiti tisućama inboxova.

Imate tri uobičajene opcije:

Opcija A: Fanout pri upisu (odmah insert u inbox)#

Kada se dogodi event:

  1. 1
    Insert u notification_events
  2. 2
    Insert jednog notification_inbox retka po korisniku-primatelju
  3. 3
    Publish real-time signal po primatelju ili po kanalu

Prednosti:

  • Jednostavna čitanja: inbox query je direktan.
  • Pouzdano: DB je izvor istine.

Nedostaci:

  • Velika write amplifikacija za velike skupove primatelja.
  • Za vrlo veliki fanout trebaju background jobovi.

Opcija B: Fanout pri čitanju (dinamičko računanje)#

Spremite samo event i primatelje računate u trenutku čitanja.

Prednosti:

  • Mala write amplifikacija.

Nedostaci:

  • Složeni upiti, teže pratiti stanje pročitanosti po korisniku.
  • Teško je razumno definirati jamstva isporuke.

Opcija C: Hibrid s background jobovima#

Upišite event, enqueueajte fanout inserte i objavite real-time “hint”.

Prednosti:

  • Bolje skalira za velike publike.
  • Omogućuje rate-limit i batch inserte.

Nedostaci:

  • Više pokretnih dijelova: queue, retryji, idempotency ključevi.

Za većinu B2B aplikacija, Opcija A je dovoljna do umjerene skale. Ako redovito šaljete obavijesti za više od 10.000 korisnika po eventu, želite Opciju C s batchanjem i backpressureom.

# Implementacija SSE u Next.js App Routeru#

SSE se temelji na streamanju responsea i pisanju data: linija. Next.js route handleri to mogu na Node runtimeovima koji podržavaju streaming.

Primjer SSE route handlera#

TypeScript
// app/api/notifications/stream/route.ts
export const runtime = "nodejs";
 
export async function GET() {
  const stream = new ReadableStream({
    start(controller) {
      const encoder = new TextEncoder();
      const send = (obj: unknown) => {
        controller.enqueue(encoder.encode(`data: ${JSON.stringify(obj)}\n\n`));
      };
 
      send({ type: "connected", ts: Date.now() });
 
      const interval = setInterval(() => {
        send({ type: "ping", ts: Date.now() });
      }, 25000);
 
      const cleanup = () => clearInterval(interval);
 
      // No request abort signal in this minimal snippet
      // In production, stop on disconnect and unsubscribe from pub-sub
      return cleanup;
    },
  });
 
  return new Response(stream, {
    headers: {
      "Content-Type": "text/event-stream",
      "Cache-Control": "no-cache, no-transform",
      Connection: "keep-alive",
    },
  });
}

Ovaj primjer samo pinga. U produkciji ćete se pretplatiti na pub-sub kanal za autentificiranog korisnika i pisati obavijesti u stream.

Primjer pretplate na klijentu#

TypeScript
// client-side
export function connectNotifications() {
  const es = new EventSource("/api/notifications/stream");
  es.onmessage = (event) => {
    const msg = JSON.parse(event.data);
    console.log("notification stream message", msg);
  };
  es.onerror = () => {
    es.close();
  };
  return () => es.close();
}

Skaliranje SSE-a: limiti konekcija i fanout između instanci#

Ograničenja SSE skaliranja često se ignoriraju dok ne dođete do nekoliko tisuća istovremenih korisnika.

Važna ograničenja za planiranje:

  • Svaka otvorena konekcija troši memoriju i file descriptore.
  • Treba vam fanout između instanci preko Redis pub-sub, NATS, Kafka ili upravljanog real-time servisa.
  • Ako deployate na serverless gdje se instance skaliraju gore-dolje, povezani klijenti mogu agresivno “churnati”.

Ako trebate pomoć oko odabira real-time stacka i deployment modela, tradeoffovi su obrađeni u tekstu Real-time značajke u Next.js-u s WebSockets, SSE i Supabase Realtime.

# Implementacija WebSockets u Next.js-u: presence i dvosmjerne akcije#

Čisti Next.js route handleri često nisu dovoljni za klasične WebSocket servere na mnogim platformama. Uobičajeni pristupi su:

  • Upravljani WebSocket provideri
  • Pokretanje zasebnog Node servera za sockete
  • Platform-specifična WebSocket podrška

Značajke nalik presenceu zahtijevaju:

  • Heartbeatove od klijenta prema serveru
  • Server-side presence store s TTL-om
  • Strategiju za reconnect oluje i zastarjele sesije

Presence model (praktični minimum)#

PoljeSprema se uTTLZnačenje
user_idRedis key60 do 120 sekundiKorisnik je online ako key postoji
last_seen_atDBnoneAžurira se na disconnect ili periodični flush
connection_idRedis hashisto kao TTLDebugging i multi-device

Točnost presencea ovisi o intervalima heartbeatova i TTL-u. Na primjer, heartbeat od 30 sekundi i TTL od 90 sekundi tolerira kratke prekide mreže, a online status ostaje dovoljno svjež.

ℹ️ Napomena: Ako deployate iza proxyja koji ubija idle konekcije, presence preko WebSockets mora uključivati ping frameove ili app-level heartbeatove. Inače će korisnici “ghostati” kao online.

# Usklađivanje propuštenih obavijesti: Inbox Sync API#

Čak i s real-time transportom, klijenti će propuštati evente:

  • Uređaj je bio offline
  • Tab je bio u pozadini
  • Korporativni proxy je bufferirao stream
  • Korisnik je promijenio mrežu

Vaš UI bi uvijek trebao krenuti dohvatom inbox delta podataka od zadnjeg viđenog ID-a.

Minimalni inbox API ugovor#

EndpointSvrhaVraća
GET /api/notifications?after={{cursor}}Dohvat novih inbox stavkiStavke plus sljedeći cursor
POST /api/notifications/{{id}}/readOznači kao pročitanoAžurirani broj nepročitanih
GET /api/notifications/unread-countBrzi badge u headeruBroj

Primjer Next.js routea: dohvat inbox delta#

TypeScript
// app/api/notifications/route.ts
export const runtime = "nodejs";
 
export async function GET(request: Request) {
  const url = new URL(request.url);
  const after = url.searchParams.get("after");
 
  // Replace with your auth and DB calls
  const userId = "user-id";
 
  // Example: cursor-based pagination by created_at and id
  // Keep it deterministic to avoid duplicates
  const items = [
    { id: "n1", createdAt: Date.now(), title: "Invoice paid", readAt: null },
  ];
 
  return Response.json({ items, nextCursor: "cursor-value" });
}

Transport (SSE ili WS) bi trebao biti odgovoran samo za to da potakne klijenta na refresh ili da pošalje ID-eve obavijesti koje klijent zatim može uskladiti s inboxom.

# Stanja pročitanosti: jedan izvor istine vs optimistični UI#

Badge nepročitanih je jedna od najvidljivijih površina obavijesti. Ako “odluta”, korisnici gube povjerenje.

Preporučeni pristup:

  • DB je izvor istine za stanje pročitanosti.
  • Klijent može optimistično označiti kao pročitano, ali se mora uskladiti pri sljedećem fetchu.

Dva česta obrasca:

Obrazac 1: Timestamp pročitanosti po obavijesti#

  • Svaki inbox redak ima read_at.
  • Broj nepročitanih je COUNT(*) WHERE read_at IS NULL.

Ovo je jednostavno i podržava djelomično čitanje.

Obrazac 2: High-water mark za “pročitano do”#

  • Sprema se last_read_at ili last_read_notification_id po korisniku.
  • Sve starije od toga tretira se kao pročitano.

Ovo je brže za bulk reads, ali puca ako korisnici čitaju izvan redoslijeda ili preko više uređaja bez pažljivog upravljanja.

Za većinu aplikacija, krenite s read_at po obavijesti. Kasnije možete dodati high-water mark radi performansi, ali zadržite inbox retke kao audit trail.

# Fallback polling s React Query ili SWR (preporučeno čak i uz real-time)#

Neka okruženja neće zadržati stabilan stream. Vaša aplikacija mora ostati točna i bez real-timea.

Polling nije “old-school”, nego sigurnosna mreža. Interval od 30 do 60 sekundi često je dovoljan za obavijesti, a trošak je predvidljiv.

React Query polling primjer#

TypeScript
import { useQuery, useQueryClient } from "@tanstack/react-query";
 
export function useNotifications() {
  return useQuery({
    queryKey: ["notifications"],
    queryFn: async () => {
      const res = await fetch("/api/notifications");
      if (!res.ok) throw new Error("Failed to load notifications");
      return res.json();
    },
    refetchInterval: 30000,
    staleTime: 15000,
  });
}
 
export function useNotificationStreamBridge() {
  const qc = useQueryClient();
 
  return () => {
    const es = new EventSource("/api/notifications/stream");
    es.onmessage = () => {
      qc.invalidateQueries({ queryKey: ["notifications"] });
    };
    return () => es.close();
  };
}

Ovaj obrazac drži stream “glupim” i robusnim: stream okida invalidaciju, a inbox API ostaje autoritativan.

SWR polling primjer#

TypeScript
import useSWR from "swr";
 
const fetcher = (url: string) => fetch(url).then((r) => r.json());
 
export function useNotifications() {
  return useSWR("/api/notifications", fetcher, {
    refreshInterval: 30000,
    dedupingInterval: 5000,
  });
}

Za SWR, također možete pozvati mutate("/api/notifications") kada stigne SSE ili WS poruka.

💡 Savjet: Koristite eksponencijalni backoff kad stream padne, ali polling držite stabilnim. Tako izbjegavate reconnect oluje tijekom incidenta.

# Odabir između SSE i WebSockets: praktična matrica odluke#

Koristite ovu matricu odluke da izbjegnete stalno mijenjanje arhitekture.

ZahtjevPreporučeni transportZašto
Samo obavijesti, server prema klijentuSSEJednostavno, otporno na reconnect, manje pokretnih dijelova
Obavijesti + interaktivne akcijeSSE + HTTP za akcijeReal-time kanal ostaje jednostavan i lak za debug
Presence, indikatori tipkanja, kolaborativne značajkeWebSocketsTraži dvosmjernu komunikaciju s niskom latencijom
Jako restriktivne enterprise mrežeSSEČesto proxy-friendly
Mobilna aplikacija s background isporukomPush notifications + inboxReal-time socketi ne rade pouzdano u pozadini
Potrebna podrška za milijune konekcijaUpravljani real-time servisSelf-hosting postaje skup bez specijalizirane infrastrukture

Ako i dalje trebate presence, ali želite SSE za obavijesti, možete hibridno:

  • SSE za obavijesti
  • Lagani WebSocket kanal samo za presence i heartbeatove

To smanjuje volumen poruka na socketu, a presence ostaje točan.

# Observability: Debugiranje propuštenih obavijesti i latencije#

Real-time sustavi tiho failaju ako ih ne instrumentirate. Dodajte vidljivost prije nego skalirate.

Pratite ove metrike:

MetrikaZašto je važnaTipičan okidač alarma
Broj stream konekcijaPlaniranje kapacitetaNagli pad veći od 30%
Reconnect rateMrežni ili platform problemiSkok veći od 3x baselinea
Latencija inserta u inboxBackpressure i zdravlje DB-ap95 veći od 500 ms
Vrijeme do prve obavijestiUX i točnostp95 veći od 2 s
Stopa neslaganja broja nepročitanihBugovi u stanjuBilo kakav trajni rast

Za puni pristup instrumentaciji pročitajte Vodič za observability web aplikacija: logovi, metrike, tracing i Next.js-specifični setup u Next.js logiranje i monitoring sa Sentryjem i OpenTelemetryjem na Vercelu.

⚠️ Upozorenje: Logiranje svakog payload-a obavijesti u produkciji može procuriti PII. Logirajte ID-eve, tipove i timing, te agresivno samplajte.

# Česte zamke (i kako ih izbjeći)#

Tretiranje real-timea kao baze podataka#

Ako ne perzistirate u inbox, korisnici gube obavijesti kad su offline. Uvijek prvo perzistirajte, pa tek onda notificirajte.

Nedostatak deduplikacije eventa na klijentu#

Reconnecti i retryji uzrokovat će duplikate. Deduplicirajte po event_id ili inbox id u vašem state storeu.

Fanout po primatelju u request pathu#

Ako jedna akcija okida 5.000 inbox inserta unutar istog HTTP requesta, p95 latencija će eksplodirati. Premjestite fanout u background job kad broj primatelja poraste.

Nema fallbacka kad stream padne#

Korporativni proxyji i mobilne mreže nisu prijateljski prema dugotrajnim konekcijama. Uvijek držite polling uključen.

# Ključne poruke#

  • Odaberite SSE za većinu use caseova samo s obavijestima, a WebSockets kad trebate značajke nalik presenceu ili visokofrekventne dvosmjerne evente.
  • Jamstva isporuke gradite trajnim inboxom i usklađivanjem, a ne povjerenjem da su SSE ili WebSockets “pouzdani”.
  • Modelirajte stanje pročitanosti eksplicitno s per-user inbox redovima i read_at, te deduplicirajte s unique constraintom na (user_id, event_id).
  • Planirajte fanout rano: krenite s fanout-on-write za umjerenu skalu, a veliki fanout premjestite u background jobove s batchanjem.
  • Uvijek implementirajte fallback polling uz React Query ili SWR, i neka real-time poruke okidaju invalidaciju cachea umjesto da budu jedini izvor istine.
  • Dodajte observability za reconnect rate, latenciju inserta u inbox i mismatch nepročitanih kako biste uhvatili kvarove prije nego što ih korisnici prijave.

# Zaključak#

Real-time isporuka poboljšava UX, ali trajne obavijesti zahtijevaju perzistenciju, jasno modeliranje stanja i fallback put. Krenite s inbox-first dizajnom, dodajte SSE za jednostavne real-time updateove, a posegnite za WebSockets tek kad presence i dvosmjerne interakcije opravdaju složenost.

Ako želite da Samioda dizajnira ili implementira produkcijski spreman sustav obavijesti u stvarnom vremenu za Next.js, uključujući skaliranje i observability, kontaktirajte nas pa ćemo pregledati vaše zahtjeve i predložiti arhitekturu koja odgovara vašem prometu i hosting ograničenjima.

FAQ

Share
A
Adrijan OmićevićOsnivač i senior developer

Osnivač i senior developer u Samiodi. 8+ godina iskustva u izradi React, Next.js, Flutter i n8n rješenja za klijente diljem Europe.

Više iz kategorije Web razvoj

Sve →

Trebate pomoć s projektom?

Gradimo prilagođena rješenja koristeći tehnologije iz ovog članka. Senior tim, fiksne cijene.