48 lines
2.0 KiB
Markdown
48 lines
2.0 KiB
Markdown
# 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
|
||
```
|
||
|
||
Команда сначала отклоняет 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](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)
|
||
- [Engineering governance и risk-based testing](../docs/development/engineering-governance.md)
|
||
- [OpenSpec authority и lifecycle](../docs/development/openspec-authority-and-lifecycle.md)
|
||
- [Frontend workflow](../docs/development/frontend-workflow.md)
|
||
- [Remediation registry](../docs/development/audit-remediation.md)
|
||
|
||
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.
|