add: refactor foundation

2026-08-14 09:49:55 +03:00
parent e3cc3d540b
commit 972356ee69
6 changed files with 202 additions and 3 deletions
@@ -0,0 +1,28 @@
+## 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-репозитория.