2026-11-08 18:08:46 +03:00
# Окружение разработчика
Задача #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` | Последний стабильный |
2026-11-08 15:35:13 +00:00
| lefthook | 2.2.2 | `.mise.toml` | Git-хуки: формат коммитов, gofmt, gitleaks (`lefthook.yml` ) |
| gitleaks | 8.30.1 | `.mise.toml` | Поиск секретов перед коммитом |
2026-11-08 18:08:46 +03:00
| 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` ):
```powershell
$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`):
` ``bash
eval "$("$LOCALAPPDATA/mise/bin/mise.exe" activate bash)"
` ``
5. **В папке проекта**:
` ``
mise trust
mise install
2026-11-08 15:35:13 +00:00
lefthook install
2026-11-08 18:08:46 +03:00
` ``
6. **VS Code**: открыть проект и поставить рекомендуемые расширения (` .vscode/extensions.json`).
7. **Перезапустить редактор и терминалы.**
## Установка на Linux (Astra 1.8 / Debian 12)
` ``bash
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
2026-11-08 15:35:13 +00:00
cd shtil && mise trust && mise install && lefthook install
2026-11-08 18:08:46 +03:00
` ``
## Проверка
В папке проекта (новый терминал):
` ``
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
` ``
2026-11-09 16:44:45 +03:00
### Проверка #1.3.9: «hello world» Tauri и Go
Делается в ` tmp/` (папка в ` .gitignore`), чтобы версии Node и Rust брались из настроек проекта. В git ничего не попадает.
**Tauri** (первая сборка 5–10 минут — компилируются зависимости Rust):
` ``bash
mkdir -p tmp && cd tmp
pnpm dlx create-tauri-app@4.7.5 hello-tauri --manager pnpm --template vue-ts --identifier ru.tbsoft.shtil.hello --yes
cd hello-tauri && pnpm install
pnpm tauri build --bundles nsis # Linux: --bundles deb
` ``
Готово, если собрался ` src-tauri/target/release/hello-tauri(.exe)`, установщик в ` src-tauri/target/release/bundle/` и приложение открывает окно.
**Go:**
` ``bash
mkdir -p tmp/hello-go && cd tmp/hello-go && go mod init hello
# main.go: package main; import "fmt"; func main() { fmt.Println("hello") }
go build -o hello.exe . # Windows
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o hello-linux . # Linux
` ``
**Результаты:**
| Кто | ОС | Tauri | Go | Дата |
|---|---|---|---|---|
| Frontend | Windows 11 | ✓ exe 4,2 МБ, установщик NSIS 1,4 МБ, окно открывается | ✓ windows/amd64, ✓ сборка linux/amd64 | 2026-11-08 |
| Frontend | Linux | — нужна машина #1 .3.7 | запуск linux-бинарника — на машине #1 .3.7 | — |
| Backend | Windows | — | — | — |
| Backend | Linux | — | — | — |