potok Šta je Potok?
Mapa domena

Od čega je Potok napravljen

Pet alata, od virtuelne mašine do oblačića poruke. Svaki rešava svoj deo aplikacije, a ovde piše koji i kako.

BEAM

Virtuelna mašina

Šta rešava

Sve što se dešava istovremeno: otvorene stranice, obaveštenja, podsetnici i veze između servera.

BEAM je virtuelna mašina Erlanga, jezika nastalog za telefonske centrale, gde hiljade razgovora teku istovremeno i nijedan ne sme da obori ostale. Razgovori u Potoku traže isto. Znak ovde je Erlangov, jer BEAM nema svoj.

Kako

Proces za svaku otvorenu stranicu

Svaka otvorena stranica ima na serveru svoj lagan proces, sa svojom memorijom. Procesi ne dele memoriju nego šalju jedni drugima poruke, a BEAM ih stalno smenjuje, pa spor posao na jednoj stranici ne zadržava ostale.

Pad ostaje u svom procesu

Kad nešto pođe naopako, pada samo taj proces. Njegova stranica se sama ponovo poveže, a ostali ne primete ništa. Stalne delove aplikacije pokreće nadzornik, koji ih vraća ako stanu.

Memorija se čisti po procesu

Svaki proces sam čisti svoju memoriju, pa čišćenje nikad ne zaustavlja ceo server. Potok to koristi: veza stranice svaki put čisti potpuno, obe se još jednom počiste dve sekunde posle učitavanja, a posle toga stranica na svakih 20 sekundi pogleda svoju vezu i počisti je ako je narasla. Stranica kojoj dve sekunde ništa ne stigne skupi se na ono što zaista drži. Tako i mali server drži mnogo otvorenih stranica.

Pozadinski poslovi su obični procesi

Obaveštenja se šalju iz posebnih procesa, pa stranica ne čeka servise za dostavu. Ko ih dobija računa se u posebnom procesu, a samo slanje upisuje se u Postgres kao poslovi do 500 naloga, koje Oban izvršava po deset odjednom. Posao preživi postavljanje nove verzije, a onaj iz kog ništa nije otišlo pokušava se ponovo, najviše tri puta ukupno. Podsetnici za događaje su proces koji se budi na svakih pola minuta, a tako rade i rokovi glasanja i koraci procesa aplikacija, koje novi odgovor budi i odmah. Jednom na sat drugi proces briše fajlove koje su aplikacije primile, a nijedan odgovor ih nije uzeo. Slike za kartice linkova i za avatare u obaveštenjima crtaju se jedna po jedna, svaka u svom procesu, a najviše tri pregleda linkova preuzimaju se odjednom. Na svakih petnaest minuta još jedan pita Fly.io šta radi i upisuje koliko je taj sat koštao, za stranu sa troškovima. Red koji traje treba samo obaveštenjima, i on je u istoj bazi, bez posrednika pored nje. Još jedan proces čuva uprošćene granice područja i linije ruta koje je mapa tražila i pušta one koje najduže nisu korišćene.

Više servera, jedan sistem

Serveri se pronalaze preko DNS-a i povezuju u klaster. Poruka poslata na jednom stiže do procesa na drugom, bez posrednika kao što je Redis. Dele jedan tajni ključ, pa se novi serveri pri postavljanju nove verzije pridružuju starima, umesto da naprave svoj klaster. Ono što mora da važi za sve njih broji se u Postgres-u: ograničenja za linkove za prijavu, lozinke, pozivnice i obaveštenja, i poslovi koji se ponavljaju, koje radi prvi server u svom periodu, dok ih ostali preskaču. Oban javlja serverima za nove poslove preko istih veza među njima.

Keš u samoj mašini

ETS je tabela u memoriji koju čitaju svi procesi. U njoj Potok drži ono što je skupo izračunati, a retko se menja, kao pristupni token za obaveštenja. Obrađene poruke idu u dve tabele koje se smenjuju: kad se jedna napuni, druga se isprazni i preuzme njeno mesto, a poruka koju je neko u međuvremenu čitao prelazi u nju, pa keš drži ono što se prikazuje i nikad ne raste preko svoje veličine. Slike koje crta, kartice linkova i avatare, čuva u fajlovima na disku, pa ne zauzimaju memoriju, a tako i pločice mape, koje idu i u skladište fajlova koje dele svi serveri. ETS broji i pretrage i preglede mape koje jedna osoba traži, pa jedna stranica ne može da zauzme server; pokušaji prijave i mejlovi koje neko traži da se pošalju broje se u Postgres-u, za sve servere zajedno.

Server meri sam sebe

Svaki server vodi brojeve o sebi: koliko upit čeka bazu, koliko se dugo stranice otvaraju, koliko je ljudi na mreži, koliko je pun red obaveštenja i koliko kasne koraci procesa aplikacija. Peep ih drži u memoriji, a da ništa ne usporava, i daje ih u formatu Prometheus na posebnom portu, koji čita samo Fly.io i od njih crta grafikone.

Elixir

Programski jezik

Šta rešava

Sva pravila aplikacije: ko sme šta, kako rade niti i nasleđivanje, šta je nepročitano, kako se događaji ponavljaju.

Elixir je jezik koji radi na BEAM-u. Od njega dobija sve gore navedeno, a dodaje čitljiv kod i dobre alate. U njemu je napisan sav serverski kod Potoka, sa svim pravilima sa mape domena.

Kako

Podaci se ne menjaju u mestu

Funkcija prima vrednost i vraća novu, a stara ostaje kakva je bila, pa niko ne može da je promeni dok je neko drugi čita. Podatak se lako prati: koraci se nižu jedan za drugim, a oblik podatka bira granu koja se izvršava.

Ecto čuva bazu

Ecto opisuje svaku tabelu u kodu, a izmene prolaze provere pre nego što stignu do PostgreSQL-a. Izmene koje idu zajedno čine jednu transakciju: upišu se sve ili nijedna.

PostGIS poznaje mesta na Zemlji

PostgreSQL pokreće PostGIS, svoje proširenje za mesta na Zemlji. On proverava da granica područja ne seče samu sebe, kroz indeks nalazi područja koja obuhvataju pin grupe ili kroz koja ruta prolazi umesto da čita svaku granicu, meri dužinu rute po površini Zemlje, i uprošćava granicu ili rutu za svaki zum mape, pa telefon dobija samo tačke koje može da prikaže. Pored njega radi pg_trgm, koji ime nalazi po bilo kom delu preko indeksa, od trećeg slova.

Deo provere radi kompajler

Šabloni i adrese proveravaju se još dok se kod gradi. Link ka nepostojećoj stranici je upozorenje, a upozorenje zaustavlja izmenu. Kompajler usput deli šablon na stalne i promenljive delove, i zato LiveView šalje samo razlike.

Kod koji čita sam sebe

Polja i ključevi na mapi domena ne prepisuju se ručno: polja dolaze iz Ecto šema, a ključevi iz kataloga baze, pa ne mogu da zaostanu za kodom. Kad se pojavi tabela bez opisa, test pada.

Alati u istom jeziku

I testovi (ExUnit) i pomoćni zadaci pisani su u Elixir-u. Jedna komanda pre svake izmene gradi kod bez upozorenja, formatira ga i pušta testove, a ćirilica ove stranice nastaje iz latinice.

Phoenix

Veb okvir

Šta rešava

Sve između pregledača i pravila: stranice, veza uživo, prijava, adrese, fajlovi.

Phoenix je veb okvir napisan u Elixir-u. Prima svaki zahtev, proverava sesiju i jezik, vodi ga do prave stranice i drži vezu sa pregledačem otvorenom.

Kako

LiveView: stranice žive na serveru

Sve stranice posle prijave su LiveView. Prikaz se računa na serveru, a pregledač preko WebSocket veze dobija samo ono što se promenilo. JavaScript ostaje za ono što ume samo pregledač, recimo skrolovanje, otpremanje fajlova i crtanje procesa, koji raspoređuje dagre, a pregledač ga učitava tek kad se crtež otvori. Aplikacije za telefon prikazuju iste stranice sa istog servera, pa nova mogućnost stiže na sve uređaje odjednom.

Razgovor je tok

Poruke razgovora su LiveView tok: server ih ne drži u memoriji stranice, nego pregledaču šalje samo novu, izmenjenu ili obrisanu. Ostatak čuva pregledač, pa dug razgovor ne opterećuje server.

PubSub: nova vrednost stiže svima

Kad neko sačuva vrednost, Phoenix PubSub je objavi na kanalu grupe, a svaki proces stranice koji ga sluša dobije je i prikaže. Nepročitano ima svoj kanal, pa je jedna vrednost jedna objava, koliko god članova grupa imala. Svoj kanal imaju i vrednosti koje aplikacije čuvaju po pravilima, a svaka stranica po tim pravilima odlučuje da li njen čitalac sme da vidi vrednost.

Presence: ko je tu

Presence prati koji profil ima otvorenu grupu i usklađuje to među serverima, bez baze. Stranica sluša samo profile koji je zanimaju, pa ulazak jednog člana ne budi celu veliku grupu.

Ruter i provera pristupa

Ruter deli adrese na one za goste, naloge i profile, a ista provera važi i za prvo učitavanje i za vezu uživo. Ono čemu veza uživo ne treba, kao naslovna strana, mapa domena, ova stranica, strana javne grupe za goste, fajlovi i avatari, ostaje običan odgovor na zahtev, pa čitalac ne drži otvoren proces. Samo aplikacija na strani za goste dobija svoj mali proces, koji s vremena na vreme proverava da li gosti još smeju da je vide.

Aplikacije u grupi

Aplikacija iz opisa grupe radi u izolovanom okviru, bez pristupa stranici oko sebe. Sa Potokom razgovara porukama koje stižu do procesa stranice, a tamo se svako pravo proverava iznova.

Tailwind

Stilovi

Šta rešava

Izgled svakog elementa: razmaci, slova, boje i raspored na telefonu i na velikom ekranu.

Tailwind je skup sitnih CSS klasa koje se pišu direktno u šablonu. Umesto posebnog stila za svaki deo ekrana, element nosi svoj izgled uza sebe.

Kako

Samo ono što se koristi

Pri gradnji Tailwind pregleda šablone i JavaScript i pravi jedan CSS fajl, samo sa klasama koje se tu pojavljuju. Klasa izbačena iz šablona sama nestaje iz fajla.

Prvo telefon

Obične klase važe za uzak ekran, a sm: i lg: dodaju šta se menja na širem. Potok je dodao svoje varijante: keyboard-open: dok je tastatura telefona otvorena i cramped: za ekrane preniske za trake oko razgovora.

Stanja i tema

Varijante phx-click-loading: i phx-submit-loading: menjaju izgled dok server obrađuje klik, pa dugme reaguje odmah. dark: prati izabranu temu ili onu sa uređaja.

Ikonice bez slika

Ikonice su Heroicons, uključene kao dodatak za Tailwind: klasa hero-bell je zvonce zapisano u samom CSS-u, pa nema slike koja se učitava, a boju nasleđuje od teksta.

Gde Tailwind staje

Složene strane, kao naslovna i mapa domena, imaju i ručno pisane stilove, u istom CSS fajlu i sa istim bojama.

daisyUI

Komponente i teme

Šta rešava

Gotovi delovi ekrana i njihove boje: oblačići poruka, polja, meniji, svetla i tamna tema.

daisyUI je dodatak za Tailwind. Česte delove interfejsa daje kao klase sa imenom i ne dodaje JavaScript.

Kako

Komponente kao klase

chat-bubble je oblačić poruke, drawer bočni meni, dropdown padajući meni, toast poruka na dnu ekrana. Sve je običan CSS, pa ne smeta LiveView-u, koji sam menja stranicu.

Boje po ulozi

Boje se zovu po ulozi, kao base-100, primary ili error, a vrednost im daje tema. Potok ima svoju svetlu i tamnu temu, sa plavom iz znaka, i menja ih jednim atributom na stranici.

Obrasci

Polja za unos, padajući izbori i potvrdna polja dolaze iz daisyUI-ja, a jedna komponenta u kodu, input, sve ih prikazuje na isti način, sa istim porukama o greškama.

Aplikacije dobijaju iste klase

Aplikacija u grupi učitava isti CSS kao Potok, pa njen autor može da koristi iste komponente i boje, a aplikacija prati temu.

Šta Potok ne koristi

Potok ne koristi sve što daisyUI nudi. Dugmad su pisana Tailwind-om, a dijalozi su izvorni <dialog> elementi, jer moraju da stoje iznad svega na stranici.

Koliko Potok košta

Sve ovo radi na Fly.io: aplikacija, baza i fajlovi. Pogledaj ovaj mesec do sada i svaki mesec pre njega, procenjeno i naplaćeno.

Pogledaj troškove

Link