Priručnik za potok aplikacije
Šablon potok-vite · Vite, TypeScript, Tailwind

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.

Najvažnije

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…PoziviPoglavlje
napravim i otpremim prvu aplikacijunpm run dev, npm run build, Otpremi ZIP2
upišem i pročitam podatke, i pratim ih uživoinsertValue, listValues, onNewValue5
izračunam zbir bez čitanja svih vrednostiaggregateValues5
znam ko gleda i šta smegetCurrentProfile, getGroup, openLogin6
prikažem podatke druge aplikacije iste grupescope: "group"7
zapamtim nešto samo za gledaocasetPersonal, getPersonal8
napravim anketu, prijavu sa fajlom ili kvizgetConfig, saveConfig, insertValue(…, {collection}), uploadFile9
pokrenem odobravanje za svaki unosprocess u pravilu, completeTask10
prikažem objave, događaje ili zapise kao podgrupelistSubgroups, createChildren, showGroup11
nacrtam mapu ili prikažem glasanjalistPlaces, listPolls, openPoll12
probam aplikaciju kao gost ili druga aplikacija?viewer=guest, ?app=213

Kako čitati

Okviri u tekstu imaju četiri vrste:

Važno

Pravilo bez kog aplikacija ne radi.

Pukne tek u potok-u

Prolazi npm run dev i npm run build, a pukne kad se aplikacija otpremi u grupu.

Napomena

Objašnjenje, izuzetak ili savet.

Dev mock

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.