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

@@ -0,0 +1,57 @@
+**Language / Язык:** [English](../faq.md) | [Русский](faq.md)
+
+# FAQ
+
+## Это настоящий vCenter / ESXi?
+
+Нет. Это симулятор API и состояния. Хосты, VM, datastores и сети —
+устойчивые модели PostgreSQL, а не ESXi-хосты или процессы KVM/vmkernel.
+
+## Вы действительно покрываете vSphere Automation API?
+
+**Runtime** всегда обслуживает полную зарегистрированную route table (1077 маршрутов:
+104 deep handlers + DB-backed stub surface для остальных) — см.
+[Поверхность API](api-surface.md). **Catalog** majors 6–8 — намеренно
+низкопокрытые исторические floors (2.9%–9.6%); только major 9 (8.0 U2 / Automation
+9.1 surface) объявлен как 100% в catalog. См.
+[Версии API](api-versions.md) и [Совместимость](compatibility.md).
+
+## Можно ли использовать это в CI для Terraform / Ansible / pyvmomi / custom clients?
+
+Да. Это основной сценарий использования. Засейте профиль и направьте клиентов на
+HTTPS gateway `:443` (REST `/api`/`/rest` или SOAP `/sdk`). См.
+[Клиенты](clients.md).
+
+## Почему некоторые NSX / Supervisor / vSAN / SAML calls «успешны» без remotes?
+
+Эти области сохраняют **локальное, засеянное** состояние симулятора (см. таблицу
+«Platform surfaces» в [Покрытие API](api-coverage.md)). Они намеренно не
+обращаются к реальному NSX Manager, Tanzu Supervisor или IdP.
+
+## Означает ли registry coverage perfect vSphere parity?
+
+Это означает, что каждый зарегистрированный маршрут имеет устойчивый обработчик
+или DB-backed stub и проходит verification suites проекта. Точное совпадение
+краевых случаев с физическим ESXi-кластером может отличаться; используйте
+`/ui/api/compatibility` и собственные client tests для certification claims.
+
+## Где Web UI?
+
+[https://localhost/](https://localhost/) после `make up` (gateway).
+
+## Можно ли развернуть в Kubernetes?
+
+Да. Используйте Helm chart в `helm/vmware-api-simulator` с опубликованным
+образом Hub. Поддерживаются Ingress + cert-manager Let's Encrypt — см.
+[Kubernetes / Helm](kubernetes.md).
+
+## Что такое `ENABLE_PVE_STUB`?
+
+Опциональная, выключенная по умолчанию legacy Proxmox VE `/api2/*` stub-плоскость,
+унаследованная из общей platform lineage. Нативная vSphere REST/SOAP всегда
+включена и является основной поверхностью проекта независимо от этого флага.
+
+## Какие VM использует seed `small`?
+
+`web-01`, `web-02`, `db-01`, `app-01`, `jumpbox` — см.
+[Профили seed](seed-profiles.md).