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.md

@@ -0,0 +1,21 @@
+**Language / Язык:** [English](README.md) | [Русский](README.ru.md)
+
+# Contract store
+
+## Native vSphere stub matrices (`contracts/vsphere/`)
+
+Versioned `manifest.json` files for majors **6–9** (vSphere 7.0 → 8.0 U2).
+They are **stub OpenAPI stand-ins** derived from
+`app/vsphere/contracts/matrix.py` (handler registry + per-path floors), not
+Broadcom OpenAPI dumps.
+
+- Catalog browse and compatibility UI read these bundles.
+- `POST /ui/api/contract/apply?major=N` hot-swaps the active **catalog** major
+  for Web UI / evidence only; runtime still serves the full registered surface
+  (no HTTP 501 from version floor).
+- Regenerate: `python scripts/write_vsphere_bundles.py` / `make vsphere-bundles`
+
+## Legacy Proxmox SHA directories
+
+SHA-addressed snapshot directories remain for optional `ENABLE_PVE_STUB=true`
+lab mode only. They are **not** used when the native vSphere plane is default.