29 lines
2.2 KiB
Markdown
29 lines
2.2 KiB
Markdown
## Why
|
||
|
||
Текущий WealthLedger frontend имеет базовый React/FSD-стек, но не содержит проверенный агентский workflow из `references/frontend-ai-template`: воспроизводимую среду, единый quality gate, проверку дрейфа OpenAPI и изолированные API-тесты. Это делает работу агентов зависимой от локального backend и ручной дисциплины.
|
||
|
||
## What Changes
|
||
|
||
- Выравнивается frontend toolchain с проверенным template: Node 22, фиксированные версии зависимостей, strict TypeScript, aliases, Mantine 9 и tooling для статического анализа.
|
||
- Frontend хранит версионируемый snapshot опубликованного backend OpenAPI, генерирует schema из него и проверяет отсутствие дрейфа generated artifact.
|
||
- Typed API layer переходит на `openapi-react-query`, сохраняя текущую auth-семантику Bearer token, refresh и retry.
|
||
- Добавляются MSW handlers только для unit-тестов, единый `verify`, coverage report, git hooks и Conventional Commits.
|
||
- Документация и `AGENTS.md` расширяются до agent-oriented структуры template, без переноса Todo-домена.
|
||
- Playwright, Storybook и CI не входят в это изменение.
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
<!-- None. -->
|
||
|
||
### Modified Capabilities
|
||
|
||
- `api-contract-generation`: frontend хранит проверяемый snapshot backend OpenAPI и детерминированно генерирует из него transport types.
|
||
|
||
## Impact
|
||
|
||
- Затрагивает `frontend` package/configuration, API client, тестовую инфраструктуру, локальную документацию и git hooks.
|
||
- Backend остаётся источником истины для OpenAPI и используется только командой синхронизации snapshot.
|
||
- Требует обновления зависимостей и lockfile frontend-репозитория.
|