frontend/README.md

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.

Проверка

npm run verify

Команда сначала отклоняет runtime вне Node 22, затем проверяет committed OpenAPI snapshot, repository hygiene, strict TypeScript, Biome, один coverage-backed запуск Vitest, Knip, dependency rules, production build и bundle budget. Для обновления OpenAPI artifacts применяется только npm run openapi:sync; обычный openapi:check обращается лишь к committed snapshot.

Документация

• Структура и 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 командой из workspace: bash specs/scripts/verify-runtime-openapi.sh. Полный multi-repository change проверяется из workspace командой bash specs/scripts/verify-workspace-change.sh <change>.