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/examples/perl.md

@@ -0,0 +1,20 @@
+**Language / Язык:** [English](../../examples/perl.md) | [Русский](perl.md)
+
+# Perl
+
+Cookbook на `HTTP::Tiny` + `JSON` с Basic-auth сессией
+(`vmware-api-session-id`) против `https://localhost`.
+
+```bash
+cd examples/perl
+cpanm --installdeps .   # или установите HTTP::Tiny, JSON, IO::Socket::SSL вручную
+perl cookbook.pl
+```
+
+Переопределите значения по умолчанию переменными окружения `VSPHERE_BASE`,
+`VSPHERE_USER`, `VSPHERE_PASSWORD`, `VSPHERE_VM_NAME`. См.
+[`cookbook.pl`](../../../examples/perl/cookbook.pl) для потока session → list →
+create → power → wait-task → delete.
+
+`HTTP::Tiny` создаётся с `verify_SSL => 0` только для локального самоподписанного
+сертификата разработческого шлюза.