docs: establish architecture records

adr/002-nest-generated-openapi-contract.md

@@ -0,0 +1,15 @@
+# 002. OpenAPI, генерируемый NestJS, как контракт API
+
+**Status:** Accepted, baseline decision
+
+## Context
+
+Ручные frontend-типы и описания маршрутов расходятся с backend и создают дублирование.
+
+## Decision
+
+NestJS генерирует OpenAPI из контроллеров и DTO для API с префиксом `/api/v1`. Frontend локальной воспроизводимой командой генерирует и хранит API-клиент в своем репозитории; runtime использует только этот клиент, а не OpenAPI endpoint.
+
+## Consequences
+
+Изменение HTTP-контракта требует регенерации клиента. Swagger/OpenAPI публикуется для локальной разработки и не является runtime-зависимостью frontend.