Initial commit: VMware vSphere API simulator scaffold.

Add the FastAPI app, PostgreSQL migrations, Docker/Helm packaging, API
contracts, docs, client examples, and the unit/integration/compatibility
test suite for local client and tooling labs without a real vCenter.

contracts/README.ru.md

@@ -0,0 +1,22 @@
+**Language / Язык:** [English](README.md) | [Русский](README.ru.md)
+
+# Хранилище контрактов
+
+## Нативные vSphere stub-матрицы (`contracts/vsphere/`)
+
+Версионированные файлы `manifest.json` для majors **6–9** (vSphere 7.0 → 8.0 U2).
+Это **stub OpenAPI stand-in'ы**, выведенные из
+`app/vsphere/contracts/matrix.py` (реестр обработчиков + per-path floors), а не
+дампы Broadcom OpenAPI.
+
+- Browse каталога и UI совместимости читают эти bundles.
+- `POST /ui/api/contract/apply?major=N` hot-swap'ает активный **catalog** major
+  только для Web UI / evidence; runtime по-прежнему обслуживает полную
+  зарегистрированную поверхность (без HTTP 501 из-за version floor).
+- Перегенерация: `python scripts/write_vsphere_bundles.py` / `make vsphere-bundles`
+
+## Legacy-каталоги Proxmox SHA
+
+SHA-адресованные каталоги snapshot остаются только для опционального lab-режима
+`ENABLE_PVE_STUB=true`. Они **не** используются, когда нативная плоскость
+vSphere включена по умолчанию.