13. Dev mock
Poglavlje 13

Dev mock

U npm run dev nema potok-a, pa šablon donosi lažni: src/potok-dev.ts odgovara na pozive isto kao potok, sa podacima u localStorage. Ovo poglavlje kaže šta mock radi, kako glumi drugog gledaoca ili drugu aplikaciju i gde se razlikuje od potok-a.

13.1. Kako se uključuje

if (import.meta.env.DEV) {
  const { installDevPotok } = await import('./potok-dev');
  installDevPotok();
}

installDevPotok() pravi #group-panel-description, na njega stavlja legacy API (kao potok), a na globalThis postavlja potok sa oba API-ja. Ako potok već postoji, ne radi ništa. Build ovaj blok izbacuje, pa mock nikad ne stiže u potok-build.html.

Pukne tek u potok-u

U dev-u su potok i window.potok isti objekat sa oba API-ja; u potok-u su odvojeni, i tipovi to poštuju. Zato metoda pozvana na pogrešnom API-ju radi u dev-u, a u potok-u ne (poglavlje 4).

13.2. Šta mock radi kao potok

13.3. Drugi gledalac: ?viewer=

Bez parametra trenutni profil je dev-user, sa admin pravima. Parametar ?viewer= u adresi dev servera glumi drugog gledaoca:

VrednostGledalac
editor (podrazumevano)admin; uređuje aplikaciju
readerčlan sa ulogom „pregled“
memberčlan sa ulogom „ispitanik“
outsiderprijavljen, nije član
guestgost: nema profil (getCurrentProfile() vraća null), getGroup() ima signed_in: false i nijedno pravo; podgrupe dobija bez autora i reakcija, a openLogin samo piše u konzolu

Uloge „pregled“ i „ispitanik“ imaju stalne UUID-ove (DEV_READER_ROLE, DEV_FILLER_ROLE u mock-u), pa pravila u dev konfiguraciji mogu da ih navedu i da se proveri ko šta vidi.

13.4. Druga aplikacija: ?app=

Bez parametara aplikacija 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, pa scope: "group" vidi sve. Parametri se kombinuju: /?app=2&viewer=guest.

13.5. Ključevi u localStorage

KljučŠta drži
potok-dev:valuesvrednosti svih aplikacija
potok-dev:configkonfiguracija svake aplikacije (potok-dev:config:<app>)
potok-dev:notifyuključena obaveštenja (setNotifications)
potok-dev:processesinstance procesa kolekcija
potok-dev:personallična memorija, po gledaocu i aplikaciji
potok-dev:subgroupsgrupe za listSubgroups, kao {"<ime podgrupe>": PotokSubgroup[]}; puni ih aplikacija
potok-dev:childrenpodgrupe aplikacije (listChildren, createChild…)
potok-dev:grouppolja koja menjaju odgovor getGroup, npr. {"can_manage_children": false}
potok-dev:pollsglasanja, kao PotokPoll[]
potok-dev:placesmesta mape, kao PotokPlace[]
potok-dev:place-shapesgranice oblasti i linije ruta, po id-ju
potok-dev:map-configodgovor getMapConfig

Za početak od nule obriši ključeve u konzoli pregledača. Jedan ključ: localStorage.removeItem('potok-dev:values'). Sve ključeve mock-a:

Object.keys(localStorage)
  .filter((key) => key.startsWith('potok-dev:'))
  .forEach((key) => localStorage.removeItem(key));
localStorage.setItem('potok-dev:subgroups', JSON.stringify({
  Objave: [{ id: 101, name: 'Prva objava', description_html: '<p>Zdravo</p>', app_description: null,
    uses_api: false, picture_url: '', is_public: true, inherits_members: true, creator_id: 1,
    inserted_at: '2026-11-01T10:00:00Z', published_at: null, last_value_at: null,
    comment_count: 0, reactions: [], can_react: true }],
}));

13.6. Gde se mock razlikuje od potok-a

Važno

Mock je dovoljan da se aplikacija napiše, ali nije dovoljan da se proveri. Pre nego što je pustiš ljudima, otvori je u pravoj grupi, kao član i kao nečlan, i prođi kontrolnu listu iz poglavlja 14.