From a42f104bed4daf982f2a72f0634887e4ea067dec Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Sat, 12 Sep 2026 14:45:43 +0300 Subject: [PATCH] docs: update routes to system documentation --- .ai/SOURCES.md | 10 +++++----- .ai/conventions/frontend-data.md | 4 ++-- .ai/conventions/frontend-testing.md | 2 ++ README.md | 6 +++--- 4 files changed, 12 insertions(+), 10 deletions(-) diff --git a/.ai/SOURCES.md b/.ai/SOURCES.md index 8e55914..8c296c1 100644 --- a/.ai/SOURCES.md +++ b/.ai/SOURCES.md @@ -4,11 +4,11 @@ | --- | --- | | Какое implementation-решение принять | [CONVENTIONS](CONVENTIONS.md) | | HTTP wire contract и направление генерации | Backend runtime OpenAPI → [snapshot/types workflow](../../docs/development/runtime-openapi-verification.md) | -| Error codes/validation/error envelope | [docs: HTTP API](../../docs/AI_INDEX.md#http-api) | -| Auth/session, token storage и refresh | [docs: Security](../../docs/AI_INDEX.md#security) | -| Значение Money, cached snapshot, account/position/income | [docs: Domain](../../docs/AI_INDEX.md#domain) | -| Mantine/theme/tokens и существующие stories | [docs: UI](../../docs/AI_INDEX.md#ui) | -| As-built behavior нужной feature | [docs: Features](../../docs/AI_INDEX.md#features) | +| Error codes/validation/error envelope | [docs: HTTP API](../../docs/architecture/http-api.md) | +| Auth/session, token storage и refresh | [Аутентификация](../../docs/domains/authentication/overview.md), [подключение брокера](../../docs/integrations/tbank.md) | +| Значение Money, cached snapshot, account/position/income | [docs: Domain](../../docs/glossary.md) | +| Mantine/theme/tokens и существующие stories | [Дизайн-система](../../docs/development/design-system.md), [UI-каталог](../../docs/development/ui-catalog.md) | +| As-built behavior нужной feature | [docs: Features](../../docs/README.md#предметные-области) | | Существующие behavioral requirements, если нужны по задаче | [specs index](../../specs/AI_INDEX.md) | | Действующие versions/scripts/check scope | package.json, lockfile, Biome/TS/dependency configs | diff --git a/.ai/conventions/frontend-data.md b/.ai/conventions/frontend-data.md index 7488a81..d1c0c10 100644 --- a/.ai/conventions/frontend-data.md +++ b/.ai/conventions/frontend-data.md @@ -36,10 +36,10 @@ Authorization. Auth endpoints исключены из Bearer/retry middleware. R Protected queries используют existing session-aware boundary; logout очищает session-scoped cache. При auth/token change читай [security](../../../backend/.ai/conventions/security-auth.md) -и [authentication](../../../docs/features/authentication.md). +и [authentication](../../../docs/domains/authentication/overview.md). Успешная connection mutation коммитит подтверждённый status и сбрасывает financial GET subtree; ошибка mutation не меняет generation/cache. Это отдельная граница -от обычного фонового refetch: [connection policy](../../../docs/features/tbank-connection.md#граница-финансового-кэша). +от обычного фонового refetch: [connection policy](../../../docs/integrations/tbank.md#граница-финансового-кэша). Default focus refetch выключен; freshness и retry определяются существующей [query policy](../../../docs/adr/007-react-query-fetch-policy.md) и feature source. diff --git a/.ai/conventions/frontend-testing.md b/.ai/conventions/frontend-testing.md index eddb0fd..fa78f41 100644 --- a/.ai/conventions/frontend-testing.md +++ b/.ai/conventions/frontend-testing.md @@ -28,6 +28,8 @@ MSW запускается только Vitest setup в `src/test/`, без brow Независимый case получает свой `createTestQueryClient`; rerender сохраняет экземпляр и seeded cache. Providers выбирай явно. Existing teardown выполняет RTL cleanup, auth reset и MSW reset: [test client](../../src/test/query.tsx). +Тестовый клиент отключает retries запросов и мутаций для предсказуемого исхода; +это не меняет [политику обновления приложения](../../../docs/adr/007-react-query-fetch-policy.md). ## Важные случаи diff --git a/README.md b/README.md index f41a705..eed2c6f 100644 --- a/README.md +++ b/README.md @@ -39,10 +39,10 @@ document и затем выполните `npm run openapi:generate`. - [Data/API/cache](.ai/conventions/frontend-data.md) - [Testing](.ai/conventions/frontend-testing.md) - [Поставленный UI-каталог Storybook](../docs/development/ui-catalog.md) -- [Обзор поставленной системы](../docs/architecture/system-overview.md) +- [Обзор поставленной системы](../docs/overview.md) - [Engineering governance и risk-based testing](../docs/development/engineering-governance.md) -- [Карта проектных фактов](../docs/AI_INDEX.md) -- [Frontend workflow](../docs/development/frontend-workflow.md) +- [Карта проектных фактов](../docs/README.md) +- [Границы проверки интерфейса](../docs/development/verification.md#интерфейс) - [Remediation registry](../docs/development/audit-remediation.md) Runtime OpenAPI backend сверяется с frontend snapshot отдельной read-only