WealthLedger frontend
React/Vite-клиент WealthLedger. Клиент получает данные только через typed API backend; прямые вызовы T-Bank из frontend не допускаются.
Быстрый старт
Требуется Node 24 (.nvmrc). Создайте .env из примера и установите
зависимости строго из lockfile:
cp .env.example .env
nvm use --silent
npm ci
npm run dev
VITE_API_BASE_URL по умолчанию указывает на http://localhost:3000.
Проверка
nvm use --silent
npm run verify
Команда проверяет, что generated OpenAPI types соответствуют committed snapshot,
затем запускает strict TypeScript, Biome, один coverage-backed запуск Vitest,
Knip, dependency rules приложения и stories, сборки приложения и Storybook.
Если backend-контракт изменился,
обновите src/shared/api/spec/openapi.json копированием backend OpenAPI
document и затем выполните npm run openapi:generate.
Документация
- Router conventions и источники
- Выбор owner/FSD
- UI, state, формы и компоненты
- Data/API/cache
- Testing
- Поставленный UI-каталог Storybook
- Обзор поставленной системы
- Engineering governance и risk-based testing
- Карта проектных фактов
- Границы проверки интерфейса
- Remediation registry
Runtime OpenAPI backend сверяется с frontend snapshot отдельной read-only
backend командой npm run test:openapi-contract.
Разработка идёт напрямую по задаче пользователя. Каждый affected repo проходит
свой verify; при изменении wire contract дополнительно выполняется contract check.
Обязательного OpenSpec/SDD lifecycle нет.