2.2 KiB
2.2 KiB
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
Modified Capabilities
api-contract-generation: frontend хранит проверяемый snapshot backend OpenAPI и детерминированно генерирует из него transport types.
Impact
- Затрагивает
frontendpackage/configuration, API client, тестовую инфраструктуру, локальную документацию и git hooks. - Backend остаётся источником истины для OpenAPI и используется только командой синхронизации snapshot.
- Требует обновления зависимостей и lockfile frontend-репозитория.