From ce06be801cdd342f93defc196b4cf34e8ce736aa Mon Sep 17 00:00:00 2001 From: BrowenSiz Date: Sun, 8 Nov 2026 18:08:46 +0300 Subject: [PATCH] =?UTF-8?q?chore(ci):=20=D0=B7=D0=B0=D1=84=D0=B8=D0=BA?= =?UTF-8?q?=D1=81=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D1=8B=20=D0=B2=D0=B5?= =?UTF-8?q?=D1=80=D1=81=D0=B8=D0=B8=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83?= =?UTF-8?q?=D0=BC=D0=B5=D0=BD=D1=82=D0=BE=D0=B2=20=D0=BE=D0=BA=D1=80=D1=83?= =?UTF-8?q?=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Одинаковые версии у обоих разработчиков и в CI: Go 1.27.3, Node 26 LTS, pnpm 12.17, Task 3.54, Rust 1.99.1. Выбор и установка описаны в docs/environment.md. Refs: 1.3.6 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .mise.toml | 6 ++ .vscode/extensions.json | 11 +++ AGENTS.md | 2 + docs/README.md | 1 + docs/environment.md | 72 +++++++++++++++++++ .../2026-11-08-shared-1.3-dev-environment.md | 37 ++++++++++ docs/status/frontend.md | 2 +- docs/status/shared.md | 5 +- rust-toolchain.toml | 4 ++ 9 files changed, 138 insertions(+), 2 deletions(-) create mode 100644 .mise.toml create mode 100644 .vscode/extensions.json create mode 100644 docs/environment.md create mode 100644 docs/journal/2026-11-08-shared-1.3-dev-environment.md create mode 100644 rust-toolchain.toml diff --git a/.mise.toml b/.mise.toml new file mode 100644 index 0000000..c231c8d --- /dev/null +++ b/.mise.toml @@ -0,0 +1,6 @@ +# Версии инструментов проекта. Меняются только PR с записью в docs/environment.md. +[tools] +go = "1.27.3" +node = "26.13.0" +pnpm = "12.17.0" +task = "3.54.0" diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..ea34d4e --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,11 @@ +{ + "recommendations": [ + "golang.go", + "Vue.volar", + "rust-lang.rust-analyzer", + "tauri-apps.tauri-vscode", + "dbaeumer.vscode-eslint", + "bradlc.vscode-tailwindcss", + "EditorConfig.EditorConfig" + ] +} diff --git a/AGENTS.md b/AGENTS.md index b72648a..90388c4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -47,6 +47,8 @@ | Наблюдаемость | `log/slog` (JSON), OpenTelemetry, Prometheus-метрики | | Dev-окружение | Docker Compose, Taskfile, mise | +Версии инструментов (Go, Node LTS, pnpm, Task, Rust, Tauri) зафиксированы в `.mise.toml` и `rust-toolchain.toml`, объяснение и установка — `docs/environment.md`. + ## 4. Архитектурные принципы (обязательны) 1. **Мультиарендность с первого дня.** У каждой таблицы организации есть `tenant_id`. Изоляция двойная: проверка в коде (организация берётся из контекста запроса) и Row-Level Security в Postgres. Доступ к данным организации — только через `WithTenantTx`. Системные таблицы без `tenant_id` оформляются явно. diff --git a/docs/README.md b/docs/README.md index 62058de..69e6695 100644 --- a/docs/README.md +++ b/docs/README.md @@ -23,6 +23,7 @@ | `research/` | shared | Интервью, исследования рынка | | `frontend/` | frontend | Внутренние правила Frontend: дизайн-система, компоненты, соглашения | | `backend/` | backend | Внутренние правила Backend: области сервера, агент, эксплуатация | +| `environment.md` | shared | Версии инструментов и установка окружения (#1.3) | | `glossary.md` | shared | Словарь терминов (#2.1) | | `features.md` | shared | Каталог функций и лимитов (#2.3) | | `contributing.md` | shared | Ветки, коммиты, PR, версии (#1.2.9) | diff --git a/docs/environment.md b/docs/environment.md new file mode 100644 index 0000000..8fc2089 --- /dev/null +++ b/docs/environment.md @@ -0,0 +1,72 @@ +# Окружение разработчика + +Задача #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` | Последний стабильный | +| 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 + ``` +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 +cd shtil && mise trust && mise 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 у обоих. diff --git a/docs/journal/2026-11-08-shared-1.3-dev-environment.md b/docs/journal/2026-11-08-shared-1.3-dev-environment.md new file mode 100644 index 0000000..b8a0bb0 --- /dev/null +++ b/docs/journal/2026-11-08-shared-1.3-dev-environment.md @@ -0,0 +1,37 @@ +--- +date: 2026-11-08 +zone: shared +task: "1.3" +items: ["1.3.1", "1.3.2", "1.3.3", "1.3.4", "1.3.5", "1.3.6", "1.3.8"] +branch: feat/1.3-dev-environment +pr: — +impact: shared +status: на проверке +author: Frontend +--- + +# [1.3] Окружение разработчика: версии инструментов + +## Сделано +- `.mise.toml`: Go 1.27.3, Node 26.13.0 (LTS), pnpm 12.17.0, Task 3.54.0. +- `rust-toolchain.toml`: Rust 1.99.1 с rustfmt и clippy. +- `.vscode/extensions.json`: Go, Vue, rust-analyzer, Tauri, ESLint, Tailwind, EditorConfig. +- `docs/environment.md`: таблица версий с причинами выбора, установка на Windows и Linux, проверка. +- У Frontend-разработчика (Windows) окружение установлено и проверено: mise 2026.10.25, Docker 29.1, VS 2022 C++, WebView2. + +## Решения +- Node 26 LTS вместо 22/24: самая долгая поддержка (до 04.2029). +- Tauri остаётся на 2.x, Tauri 3 alpha не используем. +- Новые версии — не раньше 7 дней после выхода; обновление отдельным PR. +- Tauri CLI не ставится глобально, фиксируется в `package.json` приложений (#2.14). + +## Для другой стороны +- Максиму: `git pull`, затем по `docs/environment.md` поставить mise, подключить его в терминале, `mise trust && mise install`. +- На Windows системные Node и Go из `C:\Program Files` перекрывают mise, если не подключить `mise activate` в профиле терминала. + +## Проверка +- `node -v`, `pnpm -v`, `go version`, `task --version`, `rustc --version` в папке проекта показывают зафиксированные версии (Git Bash и PowerShell). + +## Осталось +- [ ] #1.3.7 Linux-машина или VM для сборки. +- [ ] #1.3.9 hello world Tauri и Go под Windows и Linux у обоих. diff --git a/docs/status/frontend.md b/docs/status/frontend.md index 16d808f..6a5ff37 100644 --- a/docs/status/frontend.md +++ b/docs/status/frontend.md @@ -12,7 +12,7 @@ ## В работе -- — +- #1.3 · `feat/1.3-dev-environment` · версии зафиксированы, окружение у Frontend установлено; осталось: проверка hello world (#1.3.9), окружение Максима, Linux-машина (#1.3.7) ## Ждём от Backend - — diff --git a/docs/status/shared.md b/docs/status/shared.md index a83d687..a3b7841 100644 --- a/docs/status/shared.md +++ b/docs/status/shared.md @@ -20,9 +20,12 @@ ## Принятые решения (кратко, со ссылкой) - — +## Окружение +- Go 1.27.3 · Node 26.13.0 LTS · pnpm 12.17.0 · Task 3.54.0 · Rust 1.99.1 · Tauri 2.x — `docs/environment.md` (#1.3). + ## Готово для другой стороны -- — +- 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md` ## Запросы между зонами diff --git a/rust-toolchain.toml b/rust-toolchain.toml new file mode 100644 index 0000000..955e964 --- /dev/null +++ b/rust-toolchain.toml @@ -0,0 +1,4 @@ +[toolchain] +channel = "1.99.1" +components = ["rustfmt", "clippy"] +profile = "minimal" -- 2.54.0