01 Čo vás čaká
Školenie sú tri hodiny praktickej práce, počas ktorých si váš tím postaví jeden konkrétny nástroj. Taký, ktorý vám dnes chýba a nahrádzate ho tabuľkou, e-mailami alebo ručnou prácou. Na konci beží a používate ho.
Cieľ je jeden: aby vám na konci poobedia bežal nástroj, ktorý ste predtým nemali. Výklad, bezpečnosť aj teória sú len prostriedkom k tomuto výsledku.
Aby sa to stihlo, musíme začať stavbou, nie inštaláciou. Príprava podľa tohto návodu zaberie zhruba tridsať minút na človeka a dá sa spraviť kedykoľvek v týždni pred termínom.
Čo si odnesiete
- Funkčný nástroj, ktorý používate hneď v ten deň.
- Kód aj dáta. Sú vaše od prvej minúty, u nás nezostáva nič.
- Postup, ktorým si nabudúce postavíte ďalší nástroj sami.
- Písomné poznámky a zadania zo školenia.
02 Kto má prísť
Dvaja až ôsmi ľudia. Pri väčšej skupine sa na každého nedostane a časť ľudí sa bude len prizerať.
| Kto | Prečo práve on |
|---|---|
| Majiteľ alebo konateľtakmer povinné | Rozhoduje o tom, čo staviame. Bez neho sa prvá polhodina strávi hádaním, čo by asi chcel, a výsledok potom nikto nenasadí. |
| Človek, ktorý ten proces robí | Ten, kto dnes tabuľku vypĺňa alebo e-maily prepisuje. Pozná problém do detailu a od neho pochádza zadanie. |
| Niekto z ITak ho máte | Kvôli právam, sieti a firemným pravidlám. Keď je pri tom, potrebné veci väčšinou povolí na mieste a po školení nevzniknú spory o tom, čo sa smie. |
| Kolega, ktorý sa nebojí skúšať | V každej firme sa taký nájde. Po školení sa naňho budú ostatní obracať. |
Vlastný notebook, na ktorom človek bežne pracuje, s nabíjačkou. Stolový počítač v inej miestnosti ani zdieľaný počítač nestačia. Kto príde bez notebooku, bude sa celé poobedie len prizerať.
03 Čo si premyslieť vopred
Táto časť prípravy sa nedá odbaviť inštaláciou a je najdôležitejšia. Odpovedzte si na tri otázky. Odpovede nemusia byť definitívne, stačí, keď o nich niekto premýšľal ešte pred školením.
Tri otázky
- Ktorá vec vo firme sa robí ručne a nemala by? Napríklad: každý pondelok niekto prepisuje objednávky z e-mailov do tabuľky. Alebo: technik po výjazde vypĺňa papier a v kancelárii ho niekto prepisuje do systému.
- Kto to dnes robí a ako dlho mu to trvá? Keď to viete v hodinách za mesiac, viete aj to, či sa nástroj oplatí.
- Ako vyzerá výsledok, keď je hotový? Tabuľka na obrazovke? Dokument na tlač? E-mail zákazníkovi? Od toho sa odvíja, čo budeme stavať.
Evidencia, prehľad, kalkulačka, formulár, generovanie dokumentu, kontrola dát alebo malý interný nástroj pre jedno oddelenie. Za tri hodiny sa naopak nedá nahradiť účtovný či skladový systém, napojiť sa na softvér bez rozhrania ani postaviť systém pre tridsať súbežných používateľov. Ak je vaše zadanie z tejto kategórie, povieme si to už na úvodnom hovore.
Prineste vzorku dát
Nástroj postavený na vymyslených dátach sa ťažko používa. Pripravte si export skutočných dát:
- Formát: CSV alebo Excel. Stačí dvadsať až dvesto riadkov, nie celá databáza.
- Hlavičku nechajte, názvy stĺpcov sú polovica zadania.
- Osobné údaje môžete zameniť za vymyslené mená, dôležitá je štruktúra. Ak to nejde, prejdeme si na mieste, ako s takými dátami narábať.
- Majte to na svojom notebooku, nie v systéme, do ktorého sa z pracovnej siete nedostanete.
04 Čo nainštalovať
Prejdite si tento zoznam aspoň dva dni pred termínom. Inštalácia netrvá dlho, ale ak niečo zablokuje firemný antivírus alebo správca siete, potrebujete to vedieť skôr, než sedíme v zasadačke. Riadok cez oba stĺpce znamená, že postup je na Windowse aj na Macu rovnaký.
| Čo | Windows | Apple (macOS) |
|---|---|---|
| Bez tohto sa nedá začať | ||
| Účet Claudepredplatné | oba systémyRegistrácia na claude.ai, stačí plán Pro. Dohodnite sa vopred, kto predplatné platí, aby sa to neriešilo v deň školenia. |
|
| Terminálokno, do ktorého sa píše | PowerShell už v počítači máte. Nájdete ho tak, že stlačíte kláves Windows a napíšete PowerShell. |
Terminal už v počítači máte. Otvorí sa cez ⌘ + medzerník a napísanie slova Terminal. |
| Node.jsverzia LTS | Z nodejs.org stiahnite verziu označenú LTS a nainštalujte ju. Bežná klikacia inštalácia, práva administrátora zvyčajne netreba. |
Z nodejs.org stiahnite verziu označenú LTS a nainštalujte ju. Kto používa Homebrew, stačí mu brew install node. |
| Claude Code | oba systémyDo terminálu napíšte npm install -g @anthropic-ai/claude-code a stlačte Enter. Trvá to pol minúty až dve. Presný postup v ďalšej kapitole. |
|
| Pracovný priečinok | oba systémyPrázdny priečinok na ploche, napríklad naklikane. Claude Code pracuje len s priečinkom, v ktorom je spustený, do zvyšku počítača nevidí. Je to zároveň vaša bezpečnostná hranica. |
|
| Odporúčané, ale nie nutné | ||
| Visual Studio Codeeditor | oba systémycode.visualstudio.com, zadarmo. Nemusíte ho vedieť používať, slúži len ako okno, v ktorom vidíte vznikajúce súbory. |
|
| Githistória zmien | Git for Windows z git-scm.com, klikacia inštalácia. |
Do terminálu xcode-select --install. Nič sa nekupuje, sú to nástroje od Apple. |
| Ak chcete, aby nástroj bežal aj mimo vášho notebooku | ||
| Účet GitHub | oba systémygithub.com, zadarmo. Sem sa ukladá kód, aby nebol len na jednom počítači. Súkromný projekt je bezplatný a nič sa nezverejňuje. Účet si založte vopred, overenie e-mailu na mieste zdržuje. |
|
| Účet Vercelzverejnenie | oba systémyvercel.com, prihlásenie cez GitHub. Nič sa neinštaluje, Vercel prevezme kód z GitHubu a sprístupní ho na vlastnej adrese. Bezplatný plán stačí na interný nástroj pre celý tím. |
|
| Účet Supabasedatabáza | oba systémysupabase.com, prihlásenie cez GitHub. Potrebujete ho, keď má s nástrojom pracovať viac ľudí naraz a dáta nemôžu zostať len vo vašom prehliadači. Lokálne sa nič neinštaluje. |
|
Nástroj zo školenia funguje aj ako jeden súbor na vašom počítači. Účty potrebujete až vtedy, keď k nemu má mať prístup celý tím alebo má byť dostupný z mobilu. Založenie trvá dve minúty a je zadarmo, ale ak sa k tomu nedostanete, nič sa nedeje.
05 Otestujte, že to funguje
Po inštalácii si prejdite týchto sedem krokov až po odpoveď na konci. Trvá to päť minút a je to jediný spôsob, ako vopred zistiť, či vám niečo neblokuje firemné nastavenie.
Krok za krokom
-
Otvorte terminál.
Windows: kláves Windows → napíštePowerShell→ Enter.
Mac:⌘ + medzerník→ napíšteTerminal→ Enter. -
Overte Node.js. Napíšte
node --versiona stlačte Enter.Má sa vypísať číslo verzie, napríklad
v22.11.0. Keď sa namiesto toho vypíše, že príkaz nie je rozpoznaný, Node.js nie je nainštalovaný. Vráťte sa ku kapitole 4. -
Overte npm. Napíšte
npm --version. Aj tu sa má vypísať číslo, napríklad10.9.0. -
Nainštalujte Claude Code.
npm install -g @anthropic-ai/claude-codeBeží to pol minúty až dve a vypisuje pritom veľa riadkov, to je v poriadku. Dôležité je, aby na konci nebolo slovo
error. -
Vytvorte pracovný priečinok a prejdite doň.
Windows:mkdir $HOME\Desktop\naklikanea potomcd $HOME\Desktop\naklikane
Mac:mkdir ~/Desktop/naklikanea potomcd ~/Desktop/naklikane -
Spustite Claude Code. Napíšte
claudea Enter.Pri prvom spustení sa otvorí prehliadač a vypýta prihlásenie do vášho účtu Claude. Prihláste sa a vráťte sa do terminálu, kde má byť pripravený riadok na písanie.
-
Skúste, či odpovedá. Napíšte do terminálu vetu a stlačte Enter:
Napíš mi jednu vetu o tom, že všetko funguje.Keď dostanete odpoveď, ste pripravení. Terminál môžete zavrieť.
Keď node --version vypísal číslo, príkaz claude sa
spustil a dostali ste odpoveď na svoju vetu. Vtedy je prostredie pripravené
a na školení sa ním nebudeme zdržiavať.
Skopírujte alebo odfoťte celý text chyby a pošlite nám ho na info@foreqa.st. Vopred sa väčšina problémov vyrieši za pár minút, na mieste zaberú aj hodinu. Prehľad najčastejších je v kapitole 9.
06 Čo potrebuje vedieť vaše IT
Ak máte správcu siete alebo externú IT firmu, pošlite im túto kapitolu. Konkrétny zoznam adries sa schvaľuje ľahšie než všeobecná požiadavka na prístup na internet. Nič z toho nevyžaduje zásah do serverov ani nové licencie.
| Na čo | Čo povoliť |
|---|---|
| Inštalácianutné | nodejs.org, registry.npmjs.org |
| Prihlásenie a behnutné | claude.ai a anthropic.com vrátane console.anthropic.com a api.anthropic.com. Prihlásenie sa dokončuje návratom na localhost, ten nesmie byť blokovaný. |
| Ukladanie kódu | github.com, objects.githubusercontent.com, raw.githubusercontent.com |
| Zverejnenie a databáza | vercel.com a *.vercel.app, supabase.com a *.supabase.co |
| Výnimky antivírusu | Priečinok s balíkmi %USERPROFILE%\AppData\Roaming\npm, medzipamäť %LOCALAPPDATA%\npm-cache a pracovný priečinok na ploche. Na Macu priečinok, ktorý vypíše npm config get prefix. |
| Písma na stránkachnepovinné | fonts.googleapis.com, fonts.gstatic.com. Bez nich sa použije systémové písmo a nič sa nepokazí. |
Server, virtuálny stroj, Docker, databáza na notebooku, platený hosting ani práva administrátora domény. Nástroj, ktorý postavíme, je priečinok so súbormi. Ak niekto z IT navrhne pripraviť infraštruktúru, predstavuje si iný typ projektu. Ukážte mu tento odsek.
Do modelu ide len to, čo doň sami napíšete alebo vložíte. Súbory z vášho počítača sa nikam samy neodosielajú a nástroj, ktorý postavíme, drží dáta u vás. Jednu časť školenia venujeme tomu, čo sa smie posielať a čo nie, a ako postaviť nástroj tak, aby citlivé údaje zostali vo vašej sieti. Ak spracúvate osobné údaje, prejdeme aj to, čo z toho vyplýva pre GDPR.
07 Zasadačka a technika
| Čo | Prečo |
|---|---|
| Miestnosť na tri hodiny | Bez presúvania a bez toho, aby cez ňu niekto chodil. Stôl, pri ktorom sedia všetci a vidia na jednu obrazovku. |
| Projektor alebo veľká obrazovka | Stavia sa naživo a všetci musia vidieť to isté. Dajte vedieť, či máte HDMI alebo USB-C, redukcie prinesieme. |
| Wi-Fi a heslo | Pripravte vopred. Ak máte oddelenú sieť pre hostí, overte, či cez ňu prejdú adresy z kapitoly 6. |
| Predlžovačka a zásuvky | Až osem notebookov na tri hodiny, batérie to nevydržia. |
| Káva a vodanepovinné | Uprostred je desaťminútová prestávka. Keď sa na kávu chodí o poschodie nižšie, natiahne sa na dvadsať. |
08 Kontrolný zoznam
Zoznam si pamätá stav v tomto prehliadači, takže sa k nemu môžete vrátiť. Nikam sa neodosiela.
Každý účastník sám za seba
0 z 0 hotovýchZa firmu to niekto zastreší
0 z 0 hotových09 Keď niečo nejde
Väčšinu problémov pri inštalácii spôsobuje bezpečnostný softvér alebo firemná sieť, nie chyba počítača. Najprv sa prepnite na hotspot z mobilu a krok zopakujte. Keď cez hotspot prejde, problém je v sieti a IT podľa kapitoly 6 vie, čo má povoliť. Keď neprejde ani cez hotspot, je to v počítači.
| Čo vidíte | Čo urobiť |
|---|---|
| „Windows ochránil váš počítač“ pri spustení inštalátora | Systém len nepozná podpis súboru, o vírus nejde. Kliknite na Ďalšie informácie a potom Spustiť aj tak. |
| Stiahnutý inštalátor zmizol z priečinka Stiahnuté | Antivírus ho dal do karantény. Otvorte v ňom karanténu, súbor obnovte a pridajte výnimku. Ak na to nemáte práva, napíšte IT. |
Inštalácia beží dlho a skončí chybou ETIMEDOUT alebo ECONNRESET |
Sieť zahadzuje spojenie. Skúste hotspot z mobilu. Ak cezeň prejde, pošlite IT kapitolu 6. |
Chyba obsahuje SELF_SIGNED_CERT_IN_CHAIN alebo UNABLE_TO_VERIFY_LEAF_SIGNATURE |
Firemná brána kontroluje šifrované spojenia vlastným certifikátom. Vyrieši to len IT, vypýtajte si od nich firemný koreňový certifikát. |
| „spúšťanie skriptov je v tomto systéme zakázané“ | Napíšte do PowerShellu Set-ExecutionPolicy -Scope CurrentUser RemoteSigned a potvrďte. Platí len pre vás, práva administrátora netreba. |
claude nie je rozpoznaný ako príkaz |
Zavrite terminál a otvorte ho znova, zoznam príkazov sa načítava pri štarte. Ak to nepomôže, napíšte nám. |
| Prihlásenie sa otvorí v prehliadači, ale terminál čaká donekonečna | Bezpečnostný softvér blokuje návrat na localhost. Skúste to cez hotspot alebo napíšte IT. |
| Mac: „aplikáciu nemožno otvoriť, pochádza od neidentifikovaného vývojára“ | Systémové nastavenia → Súkromie a bezpečnosť a pri hlásení kliknúť na Otvoriť napriek tomu. |
Ani na chvíľu. Vo väčšine firiem je to porušenie interných pravidiel a centrálna politika ho aj tak o pár minút zapne späť. Správne riešenie je výnimka pre konkrétne priečinky zo zoznamu v kapitole 6, IT ju nastaví za minútu.
Napíšte nám na info@foreqa.st alebo zavolajte na +421 918 957 504 a pošlite text chyby. Vyriešime to pred termínom. Ak by sa to nepodarilo, na školení sa dá pracovať vo dvojici.
10 Časté otázky
Musíme vedieť programovať?
Nie. Zadanie píšete po slovensky, celými vetami. Kto vie napísať zrozumiteľný e-mail o tom, čo má nástroj robiť, zvládne to. Školenie je určené ľuďom, ktorí denne pracujú s tabuľkami a procesmi.
Čo ak nemáme práva niečo inštalovať?
Dajte nám vedieť vopred. Väčšina vecí sa dá nainštalovať do používateľského profilu bez práv administrátora. Ak to nejde, pomôže jednorazové povolenie od IT alebo práca vo dvojici.
Musí to byť môj vlastný notebook?
Áno, najlepšie ten, na ktorom bežne pracujete. Nástroj, ktorý vznikne, zostáva na ňom, teda tam, kde ho budete používať.
Koľko nás to bude stáť mesačne?
Predplatné Claude pre človeka, ktorý nástroje stavia. Hotové nástroje väčšinou nestoja nič, bežia vo vašom prehliadači alebo na bezplatnom pláne Vercelu. Náklady teda nie sú nulové, ale sú rádovo nižšie než pri softvéri, ktorý nahrádzajú.
Čo ak sa to za tri hodiny nestihne?
Práve preto trváme na pripravenom prostredí a premyslenom zadaní, to sú dve veci, ktoré berú najviac času. Ak sa ukáže, že zadanie je na tri hodiny priveľké, rozdelíme ho a postavíme prvú časť tak, aby fungovala samostatne.
Zostane nám niečo, keď odídete?
Kód, dáta aj prístupy sú vaše od prvej minúty. Nič nezostáva u nás a nič nie je viazané na náš účet. Dostanete aj písomné zadania a poznámky zo školenia.
Napíšte na info@foreqa.st alebo zavolajte na +421 918 957 504. Otázky vyriešené vopred šetria v deň školenia čas celej skupine.