Priručnik za potok aplikacije
Za programere koji prave aplikacije za potok grupe. Priručnik je napisan iz izvornog koda šablona potok-vite: tipova API-ja (src/potok.ts), README-a, uputstva za agente, build konfiguracije i dev mock-a. Uz naslove i okvire stoji oznaka koja otvara tačnu liniju izvora.
Dev mock i build nisu potok. Aplikacija koja radi u npm run dev i prolazi npm run build i dalje može da pukne u potok-u: top-level await, slika iz public/, metoda pozvana na pogrešnom API-ju, niz umesto objekta u data. Poglavlje 4 ih nabraja, a poglavlje 14 je kontrolna lista pre objave.
Sadržaj
Šta – gde
| Hoću da… | Pozivi | Poglavlje |
|---|---|---|
| napravim i otpremim prvu aplikaciju | npm run dev, npm run build, Otpremi ZIP | 2 |
| upišem i pročitam podatke, i pratim ih uživo | insertValue, listValues, onNewValue | 5 |
| izračunam zbir bez čitanja svih vrednosti | aggregateValues | 5 |
| znam ko gleda i šta sme | getCurrentProfile, getGroup, openLogin | 6 |
| prikažem podatke druge aplikacije iste grupe | scope: "group" | 7 |
| zapamtim nešto samo za gledaoca | setPersonal, getPersonal | 8 |
| napravim anketu, prijavu sa fajlom ili kviz | getConfig, saveConfig, insertValue(…, {collection}), uploadFile | 9 |
| pokrenem odobravanje za svaki unos | process u pravilu, completeTask | 10 |
| prikažem objave, događaje ili zapise kao podgrupe | listSubgroups, createChildren, showGroup | 11 |
| nacrtam mapu ili prikažem glasanja | listPlaces, listPolls, openPoll | 12 |
| probam aplikaciju kao gost ili druga aplikacija | ?viewer=guest, ?app=2 | 13 |
Kako čitati
Okviri u tekstu imaju četiri vrste:
Pravilo bez kog aplikacija ne radi.
Prolazi npm run dev i npm run build, a pukne kad se aplikacija otpremi u grupu.
Objašnjenje, izuzetak ili savet.
Gde se dev mock ponaša drugačije od potok-a.
Oznaka potok.ts:961 uz naslov, okvir ili pasus otvara na GitHub-u liniju izvornog koda potok-vite iz koje je tekst napisan, na commit-u za koji je priručnik pisan. Oznaka Dopuna: potok-ide README znači da tekst dolazi iz dopunskog izvora: dokumentacije potok-ide ili pomoći na potok.rs. U sukobu važi potok-vite. Okvir ili pasus bez oznake je objašnjenje ili savet priručnika, izveden iz izvora.
TypeScript primeri bez oznake „ovako ne“ su provereni kompajlerom protiv src/potok.ts sa istog commit-a. Primer sa oznakom ovako ne pokazuje grešku i ne kopira se.
O priručniku
Priručnik je nezvaničan pratilac šablona, napravljen po uputstvu za pretvaranje izvora u sajt za učenje. Šablon potok-vite je pod MIT licencom. Kad se šablon promeni, priručnik prati njegov novi commit; ako se negde razilaze, merodavan je kod.