====== Vývojové prostředí: Instalace Node, Javy a NX Console ======

Tato stránka popisuje postup, jak si vývojář může připravit vývojové prostředí se správnými verzemi **Node.js** a **Javy**, jak používat soubory `.nvmrc` a `.sdkmanrc`, a jak v IDE používat nástroj **Nx Console**.

===== tl;dr =====
  * Aktualni navod: https://git.bcvsolutions.eu/czechidm/IdStory-IdM/-/blob/develop/README.md
  * Formatovani backendu: ''npx nx format-backend''
  * Formatovani frontendu: ''npx nx format-frontend''
  * Build aplikace (war): ''npx nx build aggregator''
  * Build docker image: ''npx nx container app''
  * Instalace git hooku (automaticke formatovani): ''npm i''


===== Instalace a nastavení fnm (Fast Node Manager) =====

==== macOS / Linux ====
<code bash>
curl -fsSL https://fnm.vercel.app/install | bash
# nebo přes Homebrew (macOS):
brew install fnm
</code>

Poté přidej do `~/.bashrc`, `~/.zshrc` nebo `~/.config/fish/config.fish`:

<code bash>
eval "$(fnm env --use-on-cd)"
</code>

==== Windows ====
<code powershell>
winget install Schniz.fnm
# nebo
scoop install fnm
# nebo
choco install fnm
</code>

Do PowerShell profilu přidej:
<code powershell>
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression
</code>

Pokud profil neexistuje:
<code powershell>
if (!(Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
Set-ExecutionPolicy Unrestricted
</code>

==== Použití fnm ====
<code bash>
fnm install 18
fnm default 18
fnm use          # použije verzi z .nvmrc pokud existuje
</code>

===== Instalace SDKMAN! a JDK =====

==== SDKMAN! pro macOS / Linux / WSL ====
<code bash>
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk version
</code>

==== Instalace Javy ====
<code bash>
sdk install java
sdk install java 21.0.2-tem
sdk default java 21.0.2-tem
</code>

==== Vlastní JDK ====
<code bash>
sdk install java moje-jdk-18 /cesta/k/jdk-18
sdk use java moje-jdk-18
</code>

==== Použití .sdkmanrc ====
Vytvoř soubor `.sdkmanrc` v kořenovém adresáři projektu:
<code>
java=21.0.2-tem
</code>

Pak spusť:
<code bash>
sdk env
</code>

===== Nastavení IDE: Nx Console pro IntelliJ IDEA / WebStorm =====

==== Instalace pluginu ====
  * Otevři **Settings → Plugins**
  * Vyhledej **"Nx Console"**
  * Nainstaluj, restartuj IDE

==== Použití ====
  * Otevři Nx Console přes **View → Tool Windows → Nx Console**
  * Zde můžeš:
    * Spouštět příkazy (build, test, lint…)
    * Generovat nové moduly pomocí GUI
    * Zobrazit závislosti (`nx graph`)

===== Nx v CLI =====
Pokud je Nx již v projektu:
<code bash>
npx nx --help
npx nx list
npx nx graph
npx nx run-many --target=build --all
npx nx affected --target=test
</code>

===== Shrnutí kroků pro vývojáře =====

^ Co                                   ^ Příkaz                                                  ^
| Instalace fnm                        | `curl ... | bash` nebo `winget install Schniz.fnm`       |
| Shell setup                         | `eval "$(fnm env --use-on-cd)"`                         |
| Použití verze z .nvmrc              | `fnm use`                                               |
| Instalace SDKMAN!                   | `curl ... | bash` a `source ~/.sdkman/bin/sdkman-init.sh` |
| Instalace konkrétní verze Javy     | `sdk install java 17.0.8-tem`                           |
| Použití .sdkmanrc                   | `sdk env`                                               |
| Instalace Nx Console do IDE        | Přes pluginy v IntelliJ/WebStorm                        |
| Prohlížení/spouštění Nx tasků      | V Nx Console nebo pomocí CLI                            |

===== Doporučení =====
  * Automaticky načítej `.sdkmanrc` pomocí:
    <code bash>
    source "$HOME/.sdkman/bin/sdkman-init.sh"
    sdk env install
    </code>
  * Automatické použití Node verze:
    <code bash>
    eval "$(fnm env --use-on-cd)"
    </code>
  * Formatovani backendu:
    <code bash>
    npx nx format-backend
    </code>
  * Formatovani frontendu:
    <code bash>
    npx nx format-frontend
    </code>
  * Build aplikace (WAR):
    <code bash>
    npx nx build aggregator --skip-nx-cache
    </code>
  * Build backendu (WAR):
    <code bash>
    npx nx dev-build aggregator --skip-nx-cache
    </code>
  * Build docker image pro buildeni aplikace:
    <code bash>
    docker buildx bake
    </code>
  * V IDE použij **Run Anything** (Ctrl+Ctrl nebo Shift+Shift) → napiš `nx` a použij autocomplete.