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

@@ -0,0 +1,32 @@
+**Language / Язык:** [English](../README.md) | [Русский](README.md)
+
+# Документация
+
+Руководства по симулятору VMware vSphere API. Переключайте язык с помощью заголовка на
+каждой странице. Русские версии находятся в каталоге [`ru/`](README.md).
+
+| Руководство | Описание |
+|---|---|
+| [Быстрый старт](getting-started.md) | Первая успешная лабораторная сессия |
+| [Конфигурация](configuration.md) | Переменные окружения и Compose |
+| [Аутентификация](authentication.md) | Сессии, `vmware-api-session-id`, привилегии |
+| [Версии API](api-versions.md) | Catalog majors 6–9 и hot-swap |
+| [Поверхность API](api-surface.md) | Маршрутизация REST/SOAP, coverage registry, stubs |
+| [Покрытие API](api-coverage.md) | Broadcom universe vs реализованная поверхность |
+| [Клиенты и примеры](clients.md) | Python, Go, Java, Perl, Ansible, Terraform, Pulumi |
+| [Профили seed](seed-profiles.md) | Детерминированные фикстуры инвентаря |
+| [Домены](domains/README.md) | Session, inventory, VM, storage, networking, tagging, SOAP, tasks, … |
+| [Web UI](web-ui.md) | Интерактивная консоль и каталоги |
+| [Эксплуатация](operations.md) | Reseed, migrate, release, upgrade |
+| [Kubernetes / Helm](kubernetes.md) | Образ Hub + Ingress + Let's Encrypt |
+| [Безопасность](security.md) | Модель угроз лаборатории и учётные данные |
+| [Наблюдаемость](observability.md) | Эндпоинты health и логирование |
+| [Порты](ports.md) | Опубликованные порты хоста и внутренние сервисы |
+| [Устранение неполадок](troubleshooting.md) | Типичные сбои |
+| [FAQ](faq.md) | Краткие ответы |
+| [Архитектура](architecture.md) | Границы компонентов |
+| [Совместимость](compatibility.md) | Модель evidence и матрица релизов |
+
+Исполняемые cookbook'и: [`examples/`](../../examples/README.ru.md).
+Интеграционные наборы: [`pulumi-tests/`](../../pulumi-tests/README.ru.md)
+(`make pulumi-tests`).