Files
shtil/docs/environment.md
T
TMSHandDevin dcee1faf7d chore: добавлены правила git, шаблон PR и проверочные хуки (#4)
Правила работы с ветками, коммитами и PR в docs/contributing.md. Lefthook проверяет формат коммита, форматирует Go и ищет секреты перед коммитом.

Refs: 1.2.8, 1.2.9, 1.2.10, 1.13.4

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Reviewed-on: #4
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-08 15:35:13 +00:00

4.7 KiB
Raw Blame History

Окружение разработчика

Задача #1.3. Версии одинаковые у обоих разработчиков и в CI. Источник истины — .mise.toml и rust-toolchain.toml, этот документ объясняет выбор.

Версии

Зафиксировано 2026-11-08.

Инструмент Версия Где зафиксирована Почему эта
Go 1.27.3 .mise.toml Последний стабильный выпуск; Go поддерживает две последние версии, патчи безопасности выходят ежемесячно
Node.js 26.13.0 .mise.toml Active LTS «Lithium», поддержка до апреля 2029 — самая долгая из доступных
pnpm 12.17.0 .mise.toml Последняя мажорная, выпуску больше 7 дней
Task 3.54.0 .mise.toml Последний стабильный
lefthook 2.2.2 .mise.toml Git-хуки: формат коммитов, gofmt, gitleaks (lefthook.yml)
gitleaks 8.30.1 .mise.toml Поиск секретов перед коммитом
Rust 1.99.1 rust-toolchain.toml Последний stable; rustup ставит его сам при первой сборке в папке проекта
Tauri 2.x (CLI 2.12.4) package.json приложений (#2.14) Стабильная ветка. Tauri 3 пока alpha — не используем
mise 2026.10.25 вручную Менеджер версий, ставит Go, Node, pnpm, Task по .mise.toml
Docker 29.x вручную Для deploy/dev (PostgreSQL, NATS, MinIO, Mailpit)

Правила:

  • Обновление версии — отдельным PR chore(ci): … с правкой этой таблицы. Оба обновляются в тот же день.
  • Новые версии берём не раньше чем через 7 дней после выхода (кроме срочных исправлений безопасности).
  • Не используем alpha, beta, rc и версии Node без LTS (нечётные).
  • Версии фронтенд-библиотек (Vue, Vite, TypeScript, Tailwind, Reka UI) фиксируются в pnpm-lock.yaml в шаге 2 (#2.14).

Установка на Windows

  1. Системные программы (один раз):
    • Git, Docker Desktop (с WSL2);
    • Visual Studio 2022 Build Tools или Community с компонентом «Desktop development with C++»;
    • WebView2 Runtime (в Windows 11 уже есть);
    • Rust через rustup (https://rustup.rs).
  2. mise: скачать mise-v<версия>-windows-x64.zip из релизов jdx/mise на GitHub, сверить SHA256 с SHASUMS256.txt, распаковать mise.exe и mise-shim.exe в %LOCALAPPDATA%\mise\bin.
  3. PATH пользователя: добавить в начало %LOCALAPPDATA%\mise\shims и %LOCALAPPDATA%\mise\bin.
  4. Подключить mise в терминалах — иначе системные Node и Go, установленные в C:\Program Files, перекрывают версии проекта:
    • PowerShell ($PROFILE):
      $env:MISE_PWSH_CHPWD_WARNING = 0   # только для Windows PowerShell 5.1
      (& "$env:LOCALAPPDATA\mise\bin\mise.exe" activate pwsh) | Out-String | Invoke-Expression
      
    • Git Bash (~/.bashrc):
      eval "$("$LOCALAPPDATA/mise/bin/mise.exe" activate bash)"
      
  5. В папке проекта:
    mise trust
    mise install
    lefthook install
    
  6. VS Code: открыть проект и поставить рекомендуемые расширения (.vscode/extensions.json).
  7. Перезапустить редактор и терминалы.

Установка на Linux (Astra 1.8 / Debian 12)

sudo apt install build-essential curl git libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev
curl https://sh.rustup.rs -sSf | sh
curl https://mise.run | sh     # затем подключить: eval "$(~/.local/bin/mise activate bash)" в ~/.bashrc
cd shtil && mise trust && mise install && lefthook install

Проверка

В папке проекта (новый терминал):

node -v          # v26.13.0
pnpm -v          # 12.17.0
go version       # go1.27.3
task --version   # 3.54.0
rustc --version  # 1.99.1

Итоговая проверка #1.3.9 — «hello world» Tauri и Go собираются под Windows и Linux у обоих.