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

@@ -0,0 +1,9 @@
+**Language / Язык:** [English](README.md) | [Русский](README.ru.md)
+
+# vSphere stub contracts
+
+Versioned JSON matrices generated from `app/vsphere/contracts/matrix.py`.
+Hot-swap (`POST /ui/api/contract/apply?major=N`) switches the active **catalog**
+major for Web UI / evidence only; runtime still serves the full registered
+surface (no HTTP 501 from version floor). Regenerate with
+`make vsphere-bundles`.