From d4fc28cbbf0bb76a8c11a68f09bbe41151067d88 Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 14 Sep 2026 05:51:54 +0300 Subject: [PATCH] docs: update system documentation references --- .ai/CONVENTIONS.md | 4 ++-- .ai/conventions/backend-http-api.md | 3 +-- .ai/conventions/backend-testing.md | 3 ++- AGENTS.md | 6 +++--- README.md | 8 ++------ 5 files changed, 10 insertions(+), 14 deletions(-) diff --git a/.ai/CONVENTIONS.md b/.ai/CONVENTIONS.md index 3cc14fe..73d81bd 100644 --- a/.ai/CONVENTIONS.md +++ b/.ai/CONVENTIONS.md @@ -14,8 +14,8 @@ | JWT, cookie, login/refresh/logout, guard/access, token encryption, sensitive logs | [Security](conventions/security-auth.md) | | External client/integration boundary; T-Bank/gRPC/proto, retry/rate limit/cache | [Integrations](conventions/backend-integrations.md) | | Logging/request context без изменения secrets/auth | [Logging](conventions/backend-architecture.md#logging) | -| Новый abstraction/dependency, refactor, неясный scope | [Общий выбор реализации](../../docs/development/engineering-governance.md#выбор-реализации) | -| Изменение request/response/route/status/error shape или Swagger metadata | HTTP API + [общий contract workflow](../../docs/development/runtime-openapi-verification.md) | +| Новый abstraction/dependency, refactor, неясный scope | [Общий выбор реализации](../../AGENTS.md) | +| Изменение request/response/route/status/error shape или Swagger metadata | HTTP API + [Источник HTTP-контракта](../../docs/architecture/http-api.md#источник-контракта) | Новый endpoint обычно требует HTTP API + Testing; Architecture/Data/Security добавляются по новым ответственности, persistence или access rules. diff --git a/.ai/conventions/backend-http-api.md b/.ai/conventions/backend-http-api.md index 52e6f48..850edcd 100644 --- a/.ai/conventions/backend-http-api.md +++ b/.ai/conventions/backend-http-api.md @@ -4,8 +4,7 @@ Сначала определи, меняется wire contract или только реализация существующего use case. Для route/request/response/status/error shape читай -[HTTP semantics](../../../docs/architecture/http-api.md) и -[общий contract workflow](../../../docs/development/runtime-openapi-verification.md). +[HTTP semantics и источник контракта](../../../docs/architecture/http-api.md). | Проверка | Где выполнять | | --- | --- | diff --git a/.ai/conventions/backend-testing.md b/.ai/conventions/backend-testing.md index 9dc0863..b86e45c 100644 --- a/.ai/conventions/backend-testing.md +++ b/.ai/conventions/backend-testing.md @@ -2,7 +2,8 @@ ## Выбор уровня -Применяй [общие testing risks](../../../docs/development/engineering-governance.md#risk-based-testing). +Проверяй риски доступа, денежных расчётов, целостности данных, конкурентных +изменений, публичного контракта и подтверждённых регрессий. Тесты должны различать правильное и неправильное наблюдаемое поведение. | Что меняется | Проверка | diff --git a/AGENTS.md b/AGENTS.md index 3a1c6b2..581edbf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,9 +12,9 @@ zero-warning ESLint, application/test TypeScript, Jest и build. `lint:fix`/`format` пишут файлы и запускаются отдельно от доказательства проверки. `test:cov` — диагностика без общего threshold; scripts принадлежат `package.json`. -HTTP contract changes дополнительно проходят общий -[contract workflow](../docs/development/runtime-openapi-verification.md). -Общий e2e запускается на отдельных временных DB; применимость и маршрут проверки +HTTP contract changes сохраняют [направление контракта](../docs/architecture/http-api.md#источник-контракта) +и проходят contract check. Общий e2e запускается на отдельных временных DB; +применимость и маршрут проверки описаны в [backend testing](.ai/conventions/backend-testing.md). Generated Prisma client не редактируется вручную. Credentials, авторизация доступа к счетам и внешние интеграции остаются server-side. diff --git a/README.md b/README.md index 2315311..737a68f 100644 --- a/README.md +++ b/README.md @@ -34,8 +34,7 @@ application/test typechecks, Jest и build. `npm run lint:fix` — отдель записывающая команда, `npm run test:cov` — диагностика без общего числового threshold. `npm run test:e2e` отдельно проверяет все HTTP suites на новых базах и runtime OpenAPI с соседним frontend checkout. Для полной backend-проверки -выполните обе команды. Результаты — в -[remediation registry](../docs/development/audit-remediation.md). +выполните обе команды. Nest 12 поставляется как ESM. Скрипты Jest включают `--experimental-vm-modules`, включая watch/coverage/debug; SQLite runner включает тот же флаг. TypeScript 6 @@ -83,13 +82,10 @@ runtime-валидацию. В обычном коде нужны инициал - [HTTP API](.ai/conventions/backend-http-api.md), [data](.ai/conventions/backend-data.md) и [testing](.ai/conventions/backend-testing.md) - [Security/auth](.ai/conventions/security-auth.md) и [integrations](.ai/conventions/backend-integrations.md) -- [Границы проверки API и данных](../docs/development/verification.md#api-и-хранение-данных) -- [Engineering governance и risk-based testing](../docs/development/engineering-governance.md) - [Карта проектных фактов](../docs/README.md) -- [API contract и runtime OpenAPI](../docs/development/runtime-openapi-verification.md) +- [API contract и runtime OpenAPI](../docs/architecture/http-api.md#источник-контракта) - [Обзор поставленной системы](../docs/overview.md) - [Архитектурные решения](../docs/adr/README.md) -- [Remediation registry](../docs/development/audit-remediation.md) Из backend runtime OpenAPI можно read-only сверить с frontend snapshot: