From f5d3640168b6f622d2526fdcb06c0a893b4c0987 Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 14 Sep 2026 05:52:28 +0300 Subject: [PATCH] docs: update workspace documentation routes --- AGENTS.md | 3 --- README.md | 17 ++++++++--------- 2 files changed, 8 insertions(+), 12 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 398344e..253d4c4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -20,6 +20,3 @@ Root — отдельный Git-репозиторий `WealthLedger/main`; ко 7. Проверь результат по задаче, рискованным случаям и local gates. Сохрани краткие команды/результаты; сообщи оставшиеся ограничения. Успех lint/tests не заменяет semantic review. Перед Node-командой активируй `.nvmrc` affected repo через `nvm use --silent`. -Полные [общие правила](docs/development/engineering-governance.md) читай по их -triggers; [context discipline](docs/development/agent-token-efficiency.md) — при -вопросе о routing, recovery или проверке эффективности инструкций. diff --git a/README.md b/README.md index 9d6f6b3..b2f3891 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ Workspace состоит из пяти независимых Git-репозит | `.` | `WealthLedger/main` | Вход в workspace, инструкции и правила root tracking | | `frontend/` | `WealthLedger/frontend` | [React/Vite UI](frontend/README.md) | | `backend/` | `WealthLedger/backend` | [NestJS API, Prisma и SQLite](backend/README.md) | -| `docs/` | `WealthLedger/docs` | [Объяснение системы и сопровождение](docs/README.md) | +| `docs/` | `WealthLedger/docs` | [Объяснение системы](docs/README.md) | | `specs/` | `WealthLedger/specs` | [Требования и OpenSpec](specs/README.md) | ### Получение checkout @@ -55,8 +55,8 @@ Root отслеживает только `.gitignore`, `AGENTS.md`, `README.md` Нужны nvm и Node из `.nvmrc` каждого npm-repo (сейчас 24.21.0, npm 11.19). Root не содержит npm-проекта. В frontend, backend и docs отдельно выполните `nvm install`, `nvm use --silent`, `npm ci`. -Предпосылки native dependencies и разрешения install scripts описаны в -[локальном окружении](docs/development/local-workspace.md). +После смены major Node переустановите native dependencies через `npm ci`. +Разрешения install scripts заданы в `package.json` соответствующего repo. Для нового backend создайте `.env` по [backend README](backend/README.md), замените оба placeholder-секрета и проверьте `DATABASE_URL`. @@ -71,11 +71,11 @@ npm run start:dev Build генерирует Prisma client. Перед миграцией существующей базы сохраните согласованный backup и ключ шифрования; процедуру и ограничения отката смотрите -в [локальном окружении](docs/development/local-workspace.md#сохранение-данных-и-откат). +в [описании хранения](docs/architecture/containers.md#сохранение-и-восстановление-данных). Известная ошибка fresh migration при `RUST_LOG=warn/error` устранена в `backend/prisma.config.ts`: CLI удаляет унаследованную переменную. Используйте штатный `prisma migrate deploy` из backend; прежний Prisma blocker -снят. [Подробности и границы проверки](docs/development/verification.md#известное-ограничение-сквозной-проверки). +снят. [Подробности и границы проверки](backend/README.md#реальная-sqlite-и-сохранность-данных). В другом терминале подготовьте `.env` по [frontend README](frontend/README.md), затем из frontend: @@ -96,8 +96,7 @@ npm run dev OpenSpec не нужен для запуска приложения и применяется по явному запросу. Specs использует Node из `frontend/.nvmrc`; проверенная версия CLI — 1.10.0. Store `wealth-ledger-specs` расположен в `specs/openspec/`. -[Роль и необязательный lifecycle](docs/development/openspec-authority-and-lifecycle.md), -[команды validation](specs/README.md#проверка). +[Работа с OpenSpec](specs/AGENTS.md), [команды validation](specs/README.md#проверка). ## Проверки @@ -114,6 +113,6 @@ Store `wealth-ledger-specs` расположен в `specs/openspec/`. Python 3 нужен только для проверки root tracking. Backend e2e использует временные базы; verify отдельно не доказывает HTTP/DB-сценарии или доступность -T-Bank. Полные команды и ограничения принадлежат repo README и -[руководству по проверке](docs/development/verification.md). +T-Bank. Полные команды и ограничения принадлежат README +[frontend](frontend/README.md#проверка) и [backend](backend/README.md#проверка). Для изменения проекта начните с [AGENTS](AGENTS.md).