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

@@ -0,0 +1,20 @@
+**Language / Язык:** [English](perl.md) | [Русский](../ru/examples/perl.md)
+
+# Perl
+
+`HTTP::Tiny` + `JSON` cookbook using a Basic-auth session
+(`vmware-api-session-id`) against `https://localhost`.
+
+```bash
+cd examples/perl
+cpanm --installdeps .   # or install HTTP::Tiny, JSON, IO::Socket::SSL manually
+perl cookbook.pl
+```
+
+Override defaults with `VSPHERE_BASE`, `VSPHERE_USER`, `VSPHERE_PASSWORD`,
+`VSPHERE_VM_NAME` environment variables. See
+[`cookbook.pl`](../../examples/perl/cookbook.pl) for the session → list →
+create → power → wait-task → delete flow.
+
+`HTTP::Tiny` is constructed with `verify_SSL => 0` for the local self-signed
+development gateway certificate only.