chore: document and adopt Node 24 LTS
This commit is contained in:
@@ -249,6 +249,42 @@ authority.
|
||||
| WL-P3-07 | Защитить рабочий `.env` от случайного commit. | frontend, specs, docs | done | [`2026-08-24-address-dependency-advisories-and-repo-hygiene`](../../specs/openspec/changes/archive/2026-08-24-address-dependency-advisories-and-repo-hygiene/) | — | 2026-08-24; frontend `826936c`, specs `8897bd9`, docs `60a1c33`; hygiene check passed. |
|
||||
| WL-P3-08 | Исключить runtime SQLite DB из Git. | backend, specs, docs | done | [`2026-08-24-address-dependency-advisories-and-repo-hygiene`](../../specs/openspec/changes/archive/2026-08-24-address-dependency-advisories-and-repo-hygiene/) | — | 2026-08-24; backend `6052565`, specs `8897bd9`, docs `60a1c33`; hygiene check passed. |
|
||||
|
||||
### 2026-09-13 — WL-P2-11: переход на Node 24 LTS
|
||||
|
||||
Продолжение bootstrap policy из WL-P2-11, части 14.backend/frontend/docs
|
||||
[рабочего TODO](../../todo/wealthledger-engineering-improvements.md).
|
||||
Node 24.21.0 / npm 11.19.0 выбран по [официальному каталогу релизов](https://nodejs.org/dist/index.json)
|
||||
и [расписанию поддержки](https://github.com/nodejs/Release#release-schedule):
|
||||
ветка Krypton LTS поддерживается до 30.04.2028.
|
||||
|
||||
`.nvmrc` frontend/backend/docs фиксируют 24.21.0, engines — 24.x.
|
||||
Backend `@types/node` обновлён до 24.13.3; runtime dependencies не обновлялись.
|
||||
Npm дополнил backend lockfile платформенными optional dependencies существующего
|
||||
resolver. Для npm 11.19 явно разрешены install scripts сборочных зависимостей
|
||||
с pin версий. Инструкция переустановки и отката — в
|
||||
[локальном окружении](local-workspace.md#версия-node).
|
||||
Specs продолжает наследовать frontend runtime; самостоятельный bootstrap CLI
|
||||
из части 14.specs и CI остаются отдельными незавершёнными задачами.
|
||||
|
||||
Проверки относятся к frontend `53c852b`, backend `ce24a84`, docs `c74c573`,
|
||||
specs `834f2d1` с текущим diff перехода Node:
|
||||
|
||||
- `npm ci` в frontend/backend/docs — PASS; backend native modules установлены
|
||||
под Node 24, `npm run build` с генерацией Prisma client — PASS.
|
||||
- Frontend `npm run verify` — PASS: 46 files, 268 tests, coverage, OpenAPI drift,
|
||||
TypeScript, Biome, Knip, dependency boundaries, приложение и Storybook.
|
||||
Прогон одновременно с установкой backend упирался в UI timeout; отдельный
|
||||
повтор полного gate прошёл без изменения тестов или их таймаутов.
|
||||
- Backend `npm run verify` — PASS: 35 suites, 257 tests, lint, оба typecheck и build.
|
||||
- Backend `npm run test:e2e` — PASS: 8 suites, 98 tests; новая SQLite и штатные
|
||||
migrations для каждой suite, включая runtime OpenAPI. Для HTTP-портов нужен
|
||||
запуск вне sandbox. Рабочая БД не использовалась.
|
||||
- Docs `npm run verify` — PASS: 54 Markdown-файла, 0 issues;
|
||||
`git diff --check` во всех четырёх repos — PASS.
|
||||
- OpenSpec CLI 1.10.0, существующая установка, исполненная Node 24.21.0:
|
||||
`schema validate wealth-ledger-sdd --verbose` и
|
||||
`validate --specs --strict --store wealth-ledger-specs` — PASS, 25 specs.
|
||||
|
||||
## История registry
|
||||
|
||||
Terminal evidence добавляется сюда только после завершения соответствующего change.
|
||||
|
||||
@@ -6,9 +6,24 @@ WealthLedger поставляется как локальное приложен
|
||||
исходного кода. Описано локальное окружение; production-топология по нему
|
||||
не подтверждается.
|
||||
|
||||
## Версия Node
|
||||
|
||||
Все локальные проверки используют Node 24 LTS; `.nvmrc` в frontend, backend
|
||||
и docs фиксирует 24.21.0. Specs использует frontend `.nvmrc`.
|
||||
По [официальному расписанию Node](https://github.com/nodejs/Release#release-schedule)
|
||||
поддержка Node 24 завершается 30.04.2028.
|
||||
В каждом npm-репозитории выполните `nvm install`, `nvm use --silent` и `npm ci`;
|
||||
в backend затем `npm run build` для генерации Prisma client.
|
||||
Поставляемый npm 11.19 запускает dependency install scripts только по
|
||||
`allowScripts` в package.json; разрешения привязаны к версиям сборочных
|
||||
зависимостей и пересматриваются при их обновлении.
|
||||
После смены major обязательна переустановка native modules через `npm ci`.
|
||||
Для отката верните прежние runtime/package/lockfile-конфигурации, выберите Node 22
|
||||
и повторите `npm ci` и backend build. Сам переход Node не меняет схему или данные.
|
||||
|
||||
## Подготовка backend
|
||||
|
||||
Локальная серверная среда использует Node 22 и SQLite. Для работы нужны:
|
||||
Локальная серверная среда использует Node 24 и SQLite. Для работы нужны:
|
||||
|
||||
| Параметр | Назначение и ограничение |
|
||||
| --- | --- |
|
||||
|
||||
Generated
+1
-1
@@ -12,7 +12,7 @@
|
||||
"markdownlint-rule-relative-links": "5.1.2"
|
||||
},
|
||||
"engines": {
|
||||
"node": "22.x"
|
||||
"node": "24.x"
|
||||
}
|
||||
},
|
||||
"node_modules/@nodelib/fs.scandir": {
|
||||
|
||||
+1
-1
@@ -3,7 +3,7 @@
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"engines": {
|
||||
"node": "22.x"
|
||||
"node": "24.x"
|
||||
},
|
||||
"scripts": {
|
||||
"lint": "markdownlint-cli2 \"**/*.md\" \"#node_modules\"",
|
||||
|
||||
Reference in New Issue
Block a user