Initial release of the oVirt/RHV Engine API simulator.

Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release
targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).

docs/ru/api-surface.md

@@ -0,0 +1,31 @@
+**Language / Язык:** [English](../api-surface.md) | [Русский](api-surface.md)
+
+# Поверхность API
+
+Точки входа:
+
+| Путь | Роль |
+|---|---|
+| `/ovirt-engine/api` | Корень Engine REST (v4 по умолчанию на series 4.x) |
+| `/ovirt-engine/api/v3` … `/v4` | Явный major API |
+| `/ovirt-engine/sso/oauth/*` | SSO OAuth2 |
+| `/health/live`, `/health/ready` | Liveness / readiness |
+| `/` (порт UI) | Web-консоль |
+
+## Модель маршрутизации
+
+1. Контрактные маршруты активного pack `contracts/ovirt/<series>` регистрируются
+   как отдельные OpenAPI-операции.
+2. Специализированные semantic handlers сохраняют мутации инвентаря (ВМ, диски,
+   хосты, сети, storage domains, jobs, …).
+3. Catch-all роутер Engine остаётся скрытым fallback для остальных коллекций
+   через schema engine.
+
+Packs: [`contracts/ovirt/`](../../contracts/README.ru.md). Таблица покрытия:
+[api_coverage.md](api_coverage.md). Домены: [domains/](domains/README.md).
+
+## Представления
+
+Тела запросов/ответов — JSON или XML в зависимости от `Accept` /
+`Content-Type`. Для современных клиентов предпочитайте
+`Accept: application/json`.