Pre účastníkov školenia · prepošlite to celému tímu

Pred školením

Polhodina prípravy rozhodne o tom, či z troch hodín odídete s hotovým nástrojom, alebo len s rozpracovaným. Prejdite si tento návod aspoň dva dni pred termínom.

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ľ školenia

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ť.

KtoPreč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ť.
Každý so svojím notebookom

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

  1. 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.
  2. 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í.
  3. 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ť.
Čo sa dá naklikať za tri hodiny

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ý.

ČoWindowsApple (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.
Účty GitHub, Vercel a Supabase nie sú povinné

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

  1. Otvorte terminál.
    Windows: kláves Windows → napíšte PowerShell → Enter.
    Mac: ⌘ + medzerník → napíšte Terminal → Enter.

  2. Overte Node.js. Napíšte node --version a 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.

  3. Overte npm. Napíšte npm --version. Aj tu sa má vypísať číslo, napríklad 10.9.0.

  4. Nainštalujte Claude Code.
    npm install -g @anthropic-ai/claude-code

    Beží 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.

  5. Vytvorte pracovný priečinok a prejdite doň.
    Windows: mkdir $HOME\Desktop\naklikane a potom cd $HOME\Desktop\naklikane
    Mac: mkdir ~/Desktop/naklikane a potom cd ~/Desktop/naklikane

  6. Spustite Claude Code. Napíšte claude a 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.

  7. 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ť.

Kedy je prostredie pripravené

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ť.

Keď niektorý krok zlyhá

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í.
Čo naopak netreba

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.

Kam idú vaše dáta

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

ČoPreč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ých

Za firmu to niekto zastreší

0 z 0 hotových

09 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.
Antivírus nevypínajte

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.

Po dvadsiatich minútach prestaňte

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.

Ešte niečo?

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.