diff --git a/@platform/infrastructure/.env.ports b/@platform/infrastructure/.env.ports
new file mode 100644
index 0000000..e27188f
--- /dev/null
+++ b/@platform/infrastructure/.env.ports
@@ -0,0 +1,51 @@
+# atlilith V3 platform — service port registry
+# Sourced by manage-apps before every service start.
+# Edit ports.yaml (human-readable source), keep this file in sync.
+
+# ── Infrastructure ────────────────────────────────────────────────────────────
+PLATFORM_MAIL_PORT=1026
+PLATFORM_MAIL_UI_PORT=8026
+PLATFORM_DB_PORT=25440
+PLATFORM_MACSYNC_DB_PORT=25442
+PLATFORM_M_DB_PORT=25441
+PLATFORM_ANALYTICS_DB_PORT=25443
+PLATFORM_ANALYTICS_REDIS_PORT=26380
+PLATFORM_MINIO_PORT=9100
+PLATFORM_MINIO_CONSOLE_PORT=9101
+
+# ── LLM gateway ───────────────────────────────────────────────────────────────
+PLATFORM_AI_GATEWAY_PORT=8091
+
+# ── API backends ──────────────────────────────────────────────────────────────
+PLATFORM_DATA_API_PORT=3042
+PLATFORM_ADMIN_API_PORT=3043
+PLATFORM_PORTAL_API_PORT=3044
+PLATFORM_SSO_PORT=3045
+PLATFORM_NEWSLETTER_API_PORT=3046
+PLATFORM_AI_API_PORT=3048
+PLATFORM_API_PORT=3050
+PLATFORM_IMAGE_PROTECTION_PORT=3052
+PLATFORM_M_SYNC_PORT=3140
+PLATFORM_M_API_PORT=3145
+PLATFORM_M_RELATIONSHIP_PORT=3813
+
+# ── Analytics cluster (org-analytics) ─────────────────────────────────────────
+PLATFORM_ANALYTICS_COLLECTOR_PORT=4201
+PLATFORM_ANALYTICS_PROCESSOR_PORT=4202
+PLATFORM_ANALYTICS_QUERY_API_PORT=4203
+PLATFORM_ANALYTICS_WEBSITE_API_PORT=4205
+PLATFORM_ANALYTICS_PLATFORM_API_PORT=4310
+
+# ── Frontends ─────────────────────────────────────────────────────────────────
+PLATFORM_ANALYTICS_FRONTEND_PORT=5211
+PLATFORM_WWW_PORT=5220
+PLATFORM_ADMIN_PORT=5221
+PLATFORM_ANALYTICS_WEBSITE_PORT=5222
+PLATFORM_NEWSLETTER_PORT=5226
+PLATFORM_PORTAL_PORT=5274
+PLATFORM_M_PORT=5275
+PLATFORM_AI_PORT=5276
+PLATFORM_VIP_PORT=5278
+
+# ── Tooling ───────────────────────────────────────────────────────────────────
+PLATFORM_DOCS_PORT=3091