30 lines
2.1 KiB
Markdown
30 lines
2.1 KiB
Markdown
# 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 и его состояния определяет
|
||
задача, а визуальное соответствие проверяется отдельно от сборки.
|