68 lines
3.4 KiB
Markdown
68 lines
3.4 KiB
Markdown
# 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 |