# WealthLedger frontend

React/Vite-клиент WealthLedger. Клиент получает данные только через typed API
backend; прямые вызовы T-Bank из frontend не допускаются.

## Быстрый старт

Требуется Node 22 (`.nvmrc`). Создайте `.env` из примера и установите
зависимости строго из lockfile:

```bash
cp .env.example .env
npm ci
npm run dev
```

`VITE_API_BASE_URL` по умолчанию указывает на `http://localhost:3000`.

## Проверка

```bash
npm run verify
```

Команда проверяет committed OpenAPI snapshot, strict TypeScript, Biome, unit
tests и coverage, Knip, dependency rules и production build. Для обновления
OpenAPI artifacts применяется только `npm run openapi:sync`; обычный
`openapi:check` обращается лишь к committed snapshot.

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

- [Структура и FSD](docs/STRUCTURE.md)
- [API layer и OpenAPI](docs/API-LAYER.md)
- [UI-паттерны](docs/UI-PATTERN.md)
- [Conventions](docs/CONVENTIONS.md) и [тестирование](docs/TESTING.md)
- [Обзор поставленной системы](../docs/architecture/system-overview.md)
- [Frontend workflow](../docs/development/frontend-workflow.md)
- [Remediation registry](../docs/development/audit-remediation.md)

Runtime OpenAPI backend сверяется с frontend snapshot отдельной read-only
командой из workspace: `bash specs/scripts/verify-runtime-openapi.sh`.