7. Više aplikacija u grupi
Poglavlje 7

Više aplikacija u grupi

Grupa ima po jednu aplikaciju za svaki opis koji je aplikacija: podrazumevani opis i svaki takav alternativni opis. Ovo poglavlje objašnjava kako se aplikacije jedne grupe razlikuju, kako jedna vidi podatke druge i kako aplikacija čita i menja sopstveni opis.

7.1. Jedna aplikacija po opisu

7.2. Vrednosti cele grupe: scope: "group"

Uz scope: "group", listValues i onNewValue daju i vrednosti ostalih aplikacija grupe koje gledalac sme da otvori. Tako jedna aplikacija može da prikazuje ono što druga piše (npr. pregled nad formom).

import type { PotokValue } from './potok';

function appLabel(value: PotokValue): string {
  return value.description_id === null ? 'podrazumevani opis' : `opis ${value.description_id}`;
}

async function everyApp() {
  const reply = await window.potok.listValues({ scope: 'group', orderDir: 'desc', limit: 50 });
  if (!reply.ok) return console.error(reply.error);
  for (const value of reply.values) console.log(appLabel(value), value.data);
}

const stop = window.potok.onNewValue((value) => console.log('nova u', appLabel(value)), { scope: 'group' });

void everyApp();
window.addEventListener('pagehide', stop, potok.eventListenerOptions);

README navodi scope samo za listValues i onNewValue. Legacy setNewValueCallback nema opcije i uvek dobija samo vrednosti svoje aplikacije; za vrednosti cele grupe koristi window.potok.

7.3. Opis ograničen na uloge

Alternativni opis ograničen na uloge vide samo članovi sa tim ulogama i oni koji smeju da menjaju grupu. Ostali ne vide ni tu aplikaciju ni njene vrednosti, ni kroz scope: "group" druge aplikacije.

getConfig() vraća visible_role_keys: uloge na koje je opis ograničen, ili [] kad ga vide svi (poglavlje 9).

7.4. „Postavi kao podrazumevani“

„Postavi kao podrazumevani“ menja mesta dvema aplikacijama: njihov sadržaj, imena i vrednosti. Aplikacija ne primeti razliku u podacima, jer vrednosti idu sa njom.

Pukne tek u potok-u

Kopija localStorage-a pripada mestu, ne aplikaciji. Kad „Postavi kao podrazumevani“ zameni dve aplikacije, svaka nađe kopiju one druge. Zato localStorage čitaj oprezno: proveri oblik onoga što nađeš i pretpostavi da može biti tuđe (poglavlje 8).

Svaka aplikacija pri zameni nosi sa sobom i procese, ličnu memoriju i fajlove poslate sa njenim vrednostima. Opis ograničen na uloge postaje vidljiv svima koji vide grupu kad postane podrazumevani.

7.5. Poziv iz aplikacije koja više nije na ekranu

Pozivi rade nad opisom koji je na ekranu. Poziv iz aplikacije koju je korisnik upravo napustio (prešao na drugu karticu opisa) server odbija sa stale_app. To nije greška koju treba prikazati: aplikacija ionako više nije na ekranu.

async function save(data: { text: string }) {
  const reply = await window.potok.insertValue(data);
  if (reply.ok || reply.error === 'stale_app') return;   // gone from the screen: nothing to show
  console.error(reply.message ?? reply.error);
}

void save({ text: 'zdravo' });

7.6. Sopstveni opis

window.potok.getDescription()
{ok: true, group}, gde je group {id, description_id, name, description, description_format}: id je id grupe, description_id je null za podrazumevani opis, a name natpis podrazumevanog opisa (ako postoji) ili ime alternativnog.
window.potok.updateDescription(html, {descriptionFormat?})
Menja opis ove aplikacije i vraća {ok: true, group}. Traži pravo na izmenu grupe i troši limit upisa.
potok.getGroupDescription()
Legacy: vraća {description, descriptionFormat}, bez ok.
potok.updateGroupDescription(html, {descriptionFormat?})
Legacy: isto što i updateDescription; vraća {ok: true, group}.
Važno

Opis aplikacije je njen izvorni kod. Nov opis je nova aplikacija, pa se posle updateDescription ona ponovo pokreće. Poziv menja samo opis te aplikacije (podrazumevani ili alternativni) i nije mesto za stanje (poglavlje 4).

7.7. Više aplikacija u dev-u

Bez parametara aplikacija u npm run dev radi kao podrazumevani opis. Sa ?app=<id> (npr. http://localhost:5173/?app=2) radi kao alternativni opis sa tim id-jem. Vrednosti svih aplikacija stoje pod istim ključem potok-dev:values, pa scope: "group" vidi sve.

Dev mock

Nove vrednosti ne prelaze iz jednog taba u drugi: aplikacija na /?app=2 ne dobija uživo vrednosti upisane na /. Posle osvežavanja ih vidi u listi.