2.0 KiB
WealthLedger frontend
React/Vite-клиент WealthLedger. Клиент получает данные только через typed API backend; прямые вызовы T-Bank из frontend не допускаются.
Быстрый старт
Требуется Node 22 (.nvmrc). Создайте .env из примера и установите
зависимости строго из lockfile:
cp .env.example .env
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 и production build. Если backend-контракт изменился,
обновите src/shared/api/spec/openapi.json копированием backend OpenAPI
document и затем выполните npm run openapi:generate.
Документация
- Структура и FSD
- API layer и OpenAPI
- UI-паттерны
- Conventions и тестирование
- Обзор поставленной системы
- Engineering governance и risk-based testing
- OpenSpec authority и lifecycle
- Frontend workflow
- Remediation registry
Runtime OpenAPI backend сверяется с frontend snapshot отдельной read-only
backend командой npm run test:openapi-contract.
Полный multi-repository change проверяется из workspace командой
native OpenSpec validation and the canonical gates of each affected repository.