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/vsphere/README.ru.md

@@ -0,0 +1,9 @@
+**Language / Язык:** [English](README.md) | [Русский](README.ru.md)
+
+# vSphere stub-контракты
+
+Версионированные JSON-матрицы, сгенерированные из `app/vsphere/contracts/matrix.py`.
+Hot-swap (`POST /ui/api/contract/apply?major=N`) переключает активный **catalog**
+major только для Web UI / evidence; runtime по-прежнему обслуживает полную
+зарегистрированную поверхность (без HTTP 501 из-за version floor).
+Перегенерация: `make vsphere-bundles`.