chore(ci): зафиксированы версии инструментов окружения #3
No files matched your search
@@ -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"
|
||||
Vendored
+11
@@ -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"
|
||||
]
|
||||
}
|
||||
@@ -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` оформляются явно.
|
||||
|
||||
@@ -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) |
|
||||
@@ -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 у обоих.
|
||||
@@ -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 у обоих.
|
||||
@@ -12,7 +12,7 @@
|
||||
|
||||
## В работе
|
||||
<!-- - #ID · ветка · что осталось -->
|
||||
- —
|
||||
- #1.3 · `feat/1.3-dev-environment` · версии зафиксированы, окружение у Frontend установлено; осталось: проверка hello world (#1.3.9), окружение Максима, Linux-машина (#1.3.7)
|
||||
|
||||
## Ждём от Backend
|
||||
- —
|
||||
|
||||
@@ -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).
|
||||
|
||||
## Готово для другой стороны
|
||||
<!-- Формат: - YYYY-MM-DD · зона → зона · что готово · где (путь, эндпоинт, ADR) -->
|
||||
- —
|
||||
- 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md`
|
||||
|
||||
## Запросы между зонами
|
||||
<!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID -->
|
||||
|
||||
@@ -0,0 +1,4 @@
|
||||
[toolchain]
|
||||
channel = "1.99.1"
|
||||
components = ["rustfmt", "clippy"]
|
||||
profile = "minimal"
|
||||
Reference in new issue
Block a user