# Zapisnik sestanka ## Prisotni Tomaž, Matija, Rafa, Ana Marija ## Namen sestanka Pregled do sedaj pripravljene dokumentacije ## Vsebina sestanka Analysis postane Inteligence. (popraviti je potrebno pri Rafi in Matiji) Serial production gre ven in se bo delil. Nadomestijo ga specializacije, npr. Food and Beverage, Metals etc. Rafa je vzel osnovo in popravil primere, da ustrezajo industriji. Matija pojasni, da se je nekaj stvari spremenilo. Vsaka industrija ima svoj API. Vsaka industrija ima svoje specifike in svoj set izrazov za entitete. Tomaž želi, da so izrazi bolj marketinški, ne tehnični. Povedati je potrebno, da ima lahko ena naročnina več Tennantov. En Tennat ima samo en model, ki ga ni mogoče spremenit. Najprej imamo Models > Manufacturing > FoodAndBeverage. Najprej moramo opisat kaj Food and Beverige je. Opisno. Predstavljajmo si, da smo integrator, ki ne ve nič o Pulse. Najprej mora vedeti kaj to kot industrija pomeni. Ne predvidevajmo, da integratorji poznajo posamezne panoge. Potrebno je napisat kaj je specifika tega modela - da je tukaj zelo pomembna sledljivost, roki uporabe... Važno, da se prepozna v modelu. Zato na začetku opišemo čemu ta model služi. Integration se odstrani, ker se ve, da je to Api dokumentacija. Dokumentiramo Api klice in Excel. Verjetno bi bilo potrebno vlečt paralelno. Pulse deluje ali preko integracije ali preko Excel-a, ki ga naložimo. Potrebno je dokumentirat kako se vsebina povezuje med sabo. Pri F&B imamo Run (PRO), ki ima operacije. Ko pogledaš Execl piše Runs in Optimisations. Ko to gledaš morda niti ne veš kaj to pomeni. Potrebno je razčistit kaj kateri atribut v modelu pomeni. Opisat je potrebno povezave in zakaj je nekaj pomembno. To, da nekomu razložimo katere podatke je bolj pomembno vpisat, če se želimo ukvarjat bolj s tem. To so domenska znanja, ki jih je potrebno polnit - za to so odgovorni vsebinski člani ekipe. Za interni Know-How mora obstajat ločena dokumentacija. Prodajali bomo strokovno znanje - Enis gre do stranke in jim pove: Začeli bomo s tem, nadaljevali bomo s tem in nadaljevali tam. To je naloga konzultacije. Excel, ki se izpolnjuje je na voljo na linku od Rafa dokumentacije. ### Pregled Api: Potrebno je dodat Scalar opis kaj to je in kako se uporablja. Matija pravi, da imamo Open Api na URL, kjer se samo stisne Run. Posamezne entitete so prikazane ok. Vsi podprti klici morajo biti opisani. Rafa potrebuje informacije, kateri podatki imajo katere klice in kaj vračajo. Potrebno je dodat metode. Tam je potrebno opisat... Tomaž predlaga, da se sklicujemo na Stripe dokumentacijo, ker je odličen primer. Matija prikaže Api dokumentacijo, ki se sama zdokumentira. pulse-tompitapp.net/api, tu so popisani Servisi, opise mora dodat en izmed programerjev. Za vsako entiteto je potrebno dodat podrejen dokument Opis entitete, ustvari entiteto, posodobi entiteto... ### Drugo Začnemo na Index > Gettings started > izbira modela. Potrebno je povedat, da kjer potrebuje token je potrebno dodat, kako se token dobi. Matija predlaga, da se dokumentacija validira skozi testiranje. Na Git Pulse je mapa z dokumentacijo (/dev, scr>Connectivity>Docs). To se pregleda in ugotovi, če je notri kaj pomembnega za uporabnika. ## Zaključki - Matija posreduje trenutno dokumentacijo. - Matija validira vsebino. - Rafa naj malo počaka z Api, fokus naj ostane na vsebini. Lep, razumljiv dokument naj bo rezultat. ## Ostalo 20-08-2026 10:10 - 10:50 Avtor zapisnika: Ana Marija Pritržnik