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.

docs/README.md

@@ -0,0 +1,31 @@
+**Language / Язык:** [English](README.md) | [Русский](ru/README.md)
+
+# Documentation
+
+Guides for the VMware vSphere API simulator. Switch language with the header on each
+page. Russian mirrors live under [`ru/`](ru/README.md).
+
+| Guide | Description |
+|---|---|
+| [Getting started](getting-started.md) | First successful lab session |
+| [Configuration](configuration.md) | Environment variables and Compose |
+| [Authentication](authentication.md) | Sessions, `vmware-api-session-id`, privileges |
+| [API versions](api-versions.md) | Catalog majors 6–9 and hot-swap |
+| [API surface](api-surface.md) | REST/SOAP routing, coverage registry, stubs |
+| [API coverage](api-coverage.md) | Broadcom universe vs implemented surface |
+| [Clients & examples](clients.md) | Python, Go, Java, Perl, Ansible, Terraform, Pulumi |
+| [Seed profiles](seed-profiles.md) | Deterministic inventory fixtures |
+| [Domains](domains/README.md) | Session, inventory, VM, storage, networking, tagging, SOAP, tasks, … |
+| [Web UI](web-ui.md) | Interactive console and catalogs |
+| [Operations](operations.md) | Reseed, migrate, release, upgrade |
+| [Kubernetes / Helm](kubernetes.md) | Hub image + Ingress + Let's Encrypt |
+| [Security](security.md) | Lab threat model and credentials |
+| [Observability](observability.md) | Health endpoints and logging |
+| [Ports](ports.md) | Published host ports and internal services |
+| [Troubleshooting](troubleshooting.md) | Common failure modes |
+| [FAQ](faq.md) | Short answers |
+| [Architecture](architecture.md) | Component boundaries |
+| [Compatibility](compatibility.md) | Evidence model and release matrix |
+
+Runnable cookbooks: [`examples/`](../examples/README.md).
+Integration suites: [`pulumi-tests/`](../pulumi-tests/README.md) (`make pulumi-tests`).