# Frontend

React/Vite-клиент; общие правила работы — в root `AGENTS.md`.
До frontend-решения прочитай [router](.ai/CONVENTIONS.md) и
[sources](.ai/SOURCES.md), затем только применимые документы/разделы.

## Проверка

Перед Node-командами: `nvm use --silent` по `.nvmrc`.
После lockfile install `npm ci` полный gate — `npm run verify`.
Он проверяет OpenAPI drift, TypeScript, Biome, Vitest/coverage, Knip,
dependency boundaries и сборки приложения/Storybook без backend.
Точные scripts принадлежат `package.json`; targeted checks — у выбранного convention.

HTTP contract changes дополнительно проходят общий
[contract workflow](../docs/development/runtime-openapi-verification.md).
Generated types редактируются через их source; T-Bank доступен только через backend.
Frontend dependencies используют exact versions. Pre-commit запускает staged
formatting и FSD checks; сообщения commits — Conventional Commits.
Заголовок каждого коммита заканчивай номером реальной issue этого репозитория:
`<type>[optional scope]: <description> #<issue>`, например
`ci: run full frontend verification #1`. Номер бери из текущей задачи;
если issue не указана, уточни её перед коммитом. Ссылка в body не заменяет
суффикс в заголовке. Формат проверяет `commitlint.config.cjs`.

Code/style checks автоматические только в scope конфигурации. i18n, props,
semantic placement и выбор полезных тестов обязательны при review.
Storybook уже доступен как reference; ожидаемый UI и его состояния определяет
задача, а визуальное соответствие проверяется отдельно от сборки.