potok Šta je Potok?
Nazad na pomoć

Kako Potok radi iznutra

Arhitektura Potok aplikacije

Potok aplikacija je jedan HTML fajl u opisu grupe. Radi u okviru koji ne vidi Potokovu stranicu, a sve što joj treba traži porukama koje server proveri pre nego što bilo šta upiše. Primer je Mleko (potok-mleko), aplikacija kojom komšije zajedno poručuju mleko i sir od jednog proizvođača.

Od koda do okvira

Slika se pomera levo-desno.
potok-vite šablon projekta index.html HTML, ide body src/main.ts tvoj kod src/style.css Tailwind src/potok.ts tipovi API-ja src/potok-dev.ts mock, van builda Mleko dodaje store/ i model/, i testove za njih (vitest). U pregledaču radi uz mock, bez Potoka. npm run build tsc + vite dist/potok-build.html jedan fajl, sve unutra <style> sav CSS </style> sadržaj <body> iz index.html <script type="module"> čeka da okvir bude spreman pa pokrene tvoj bundle </script> potokBuildPlugin u vite.config.ts dodaje i licence zavisnosti otpremiš u Uredi grupu kao ZIP ili HTML Grupa primer: Komšijsko mleko Opis HTML aplikacije Mleko Aplikacija (API): da Alternativni opis tekst „Kako poručujemo“ Aplikacija (API): ne Svaki opis označen kao aplikacija je jedna aplikacija, sa svojim podacima. za svakog gledaoca srcdoc iframe sandbox, bez allow-same-origin <head> sastavi Potok potok-app koji opis potok-viewer ko gleda app.css izgled i tema potok_app_sdk.js daje window.potok <body> #group-panel-description tvoj HTML
Aplikacija je jedan HTML fajl koji otpremiš u opis, sam ili u ZIP-u. Ostatak okvira Potok dodaje za svakog gledaoca. Okvir nema allow-same-origin, pa ne vidi Potokovu stranicu, kolačiće ni sesiju, i sa Potokom razgovara samo porukama. Kad se promeni HTML ili pristup gledaoca (članstvo, uloge), okvir se učita ponovo, jer aplikacija svoje podatke čita jednom, na početku. U aplikaciju može da stane i sajt sa druge adrese, u svom okviru unutar ovog: SDK mu javlja temu i jezik i prosleđuje samo pozive koje opis navede na tom okviru (data-potok-api). Pamti i stranicu na kojoj je čitalac sajta, pa se okvir napravljen iznova otvara tamo, a ?page= u adresi grupe imenuje poglavlje.

Put jednog upisa

Komšinica u turi 812 poruči 3 litra mleka i dodirne „Sačuvaj porudžbinu“. Mleko pozove insertValue za kolekciju orders. Evo kroz šta taj poziv prolazi i kako stiže komšiji koji ima istu turu otvorenu na svom telefonu.

Slika se pomera levo-desno.
Kod aplikacije u okviru (iframe) SDK potok_app_sdk.js Stranica grupe hook GroupAppFrame pregledač server · WebSocket LiveView grupe proces po gledaocu Domen pravila, upis, procesi Baza Postgres Komšinica poručuje 3 l mleka u turi 812 Komšija gleda turu 812 ista aplikacija, drugi telefon Na drugom opisu druga aplikacija grupe „Sačuvaj porudžbinu“ insertValue(data, {collection}) postMessage({potok: 1, id, …}) čeka odgovor sa istim id proveri izvor i metodu doda app_id opisa na ekranu AppApi.call isti opis? token za upis (30 / 10 s) AppData.insert, transakcija config FOR SHARE, pravilo „orders“ upis i procesi kolekcije, zajedno red u tabeli values is_data, collection, data do 64 KB pushEvent('app_api') {ok: true, value} objavi PubSub groups:<id>:app_values na svim serverima svakoj stranici AppValues.announce ova aplikacija? sme da vidi? handleEvent('app_value') prosledi u svoj okvir event: 'app_value' SDK zove slušaoce kolekcije Tura 812 dobije porudžbinu onValues(change) push_event('app_value') druga aplikacija ne čuje ovaj upis AppValues.announce nije njen opis: ništa
Upis ide nadole kroz četiri provere. Hook propušta samo metode sa svog spiska, AppApi samo aplikaciju koja je na ekranu i samo dok ima tokena, AppData samo ono što pravilo kolekcije dozvoljava, a baza samo celu transakciju, zajedno sa procesima koji kreću na tu vrednost. Posle upisa PubSub javlja svakoj otvorenoj stranici grupe, i komšinicinoj, a svaka sama odlučuje šta njen gledalac sme da vidi, bez pitanja bazi. Anonimna vrednost tuđim očima stiže bez autora.

Gde Mleko drži podatke

Mleko nema svoju bazu. Sve što pamti su vrednosti grupe označene kao podaci, svaka u jednoj kolekciji, a podešavanja su jedna vrednost u kolekciji config.

Slika se pomera levo-desno.
Podešavanja collection: 'config' · jedna vrednost menjaju ih urednici; revision sprečava da se pregaze producer: {name: 'Farma Ilić', …} products: [mleko · l, sir · kg] split: 'equal' roles: {organize: [admin], order: [everyone]} rules: Potok ih čita pri svakom upisu rounds write [admin] read [everyone] edit_own orders write [everyone] read [everyone] edit_own drivers write [everyone] read [everyone] edit_own secret: {} čitaju samo urednici Mleko pravila sastavlja iz uloga koje urednik izabere. svaki upis Potok proverava po pravilu njegove kolekcije rounds ture; otvara ih organizator orders porudžbine; svako svoju drivers ko vozi i ko je šta preuzeo #812 autor: organizator status: 'open' closes_at: 14. 11. 18:00 products: kopija cena split: 'equal' #815 autor: komšinica round: 812 lines: {mleko: 3} note: 'posle 17h' #817 autor: komšija round: 812 · lines: {sir: 0.5} #816 autor: vozač round: 812 cost: 1200 handover: {815: got, 817: paid} round: 812 je samo broj u podacima; baza tu vezu ne proverava. Drži Potok, po pravilima ko sme da upiše: uloge iz rules svako menja samo svoju vrednost (edit_own) vrednost do 64 KB, podešavanja do 512 KB Drži aplikacija sama rok ture i jedna porudžbina po osobi (važi najranija) otkazivanje je prazna porudžbina, jer autor ne briše vozi onaj ko se prvi javio; samo on čekira preuzeto
Pravila iz podešavanja Potok čita u istoj transakciji kao i upis, pa porudžbina posle zatvaranja kolekcije ne prolazi. Veze između vrednosti, kao round: 812, postoje samo u podacima, pa ono što zavisi od njih (rok ture, jedna porudžbina po osobi) Mleko proverava samo. Vozač čekira preuzeto u svojoj vrednosti, pa to po pravilu edit_own može samo on. Imena, brojevi i podešavanja su primer.

Šta aplikacija može da traži

getConfig koristi Mleko getGroupgost radi i za gosta javne grupe

Podaci u kolekcijama

insertValue listValues updateValue deleteValue deleteValues aggregateValues summarizeValues gradeValue onValues onNewValue

Podešavanja i ljudi

getConfig saveConfig listRoles getCurrentProfile getGroupgost setNotifications

Grupe ispod

listSubgroupsgost listChildren getChild createChild createChildren updateChild withdrawChild previewDescription openGroupgost showGroupgost onGroupSheetClose onSubgroupsChange

Mapa

getMapConfiggost listPlacesgost listPlacesAtgost placeShapesgost createPlace openMap

Procesi

listProcesses completeTask retryProcess cancelProcess listWaiting openProcessForm listStartable openProcessStart onWaiting

Ankete

listPollsgost getPollgost openPoll openPollForm onPollChange

Reakcije, deljenje, link

toggleGroupReaction pickEmoji shareGroupgost linkGroup getLinkedGroup

Lična memorija

listPersonalgost getPersonalgost setPersonalgost deletePersonalgost

Fajlovi, opis, prijava

uploadFile uploadImage ensureFileGroups fileUrl getDescription updateDescription openLogin

Sve su to metode objekta window.potok. Svaka postaje jedna poruka okviru stranice, a server je proverava iznova. Za gosta server propušta označena čitanja, getDescription i ono što javna pravila kolekcije pokazuju svima. linkGroup, getLinkedGroup, openLogin i pickEmoji stranica rešava sama, bez servera. Stari API (insertGroupValue, getGroupDataValues) i dalje radi za aplikacije pisane pre okvira.

Granice koje drži server

  • 30 / 10 s Upisa zaredom po otvorenoj stranici, pa se tokeni dopunjuju za 10 s.
  • 64 KB · 512 KB Najviše jedna vrednost u kolekciji i podešavanja aplikacije.
  • 10 / min Vrednosti nečlana javne grupe, gde ga pravilo pušta da piše, u jednoj grupi kroz sve njene aplikacije.
  • 256 KB localStorage aplikacije, kopija u Potokovoj stranici, posebno za svaku aplikaciju.
  • 100 · 16 KB Ključevi koje aplikacija čuva u ličnoj memoriji za jednu osobu, i koliko najviše drži jedan. Čita ih samo ta osoba; gostu ostaju u pregledaču.
  • 100 Grupa jednim createChildren, sve ili nijedna, za jedan token.
  • 120 / min summarizeValues i aggregateValues čitaju sve vrednosti aplikacije, pa su ograničeni po gledaocu, zajedno sa listWaiting, placeShapes i listPlaces.
  • stale_app Odgovor na poziv aplikacije koju je gledalac u međuvremenu zatvorio.

Izvori u kodu:

  • assets/js/potok_app_sdk.js
  • assets/js/app.js
  • lib/potok_ide_web/live/group_live/show/components.ex
  • lib/potok_ide_web/live/group_live/show/app_api.ex
  • lib/potok_ide_web/live/group_live/show/app_values.ex
  • lib/potok_ide/social/app_data.ex
  • lib/potok_ide/social/value_rules.ex

Šablon je projekat potok-vite, a primer projekat potok-mleko.

Iz iste serije

Nazad na vrh

Link