Merge pull request usnavy13#82 from usnavy13/dev

feat: improve execution continuity, PTC contracts, and deployment workflows

Author: usnavy13

.env.example

@@ -32,12 +32,26 @@ MINIO_SECRET_KEY=minioadmin
 # SANDBOX_UID=1002         # Shared host UID for all sandbox languages
 
 # ── Port ──────────────────────────────────────────────────────
-# PORT=8000                # External port the API is reachable on
+# PORT=8000                # External host port published by docker compose
 
 # ── SSL/HTTPS ──────────────────────────────────────────────────
-# ENABLE_HTTPS=false
-# SSL_CERT_FILE=/path/to/cert.pem
-# SSL_KEY_FILE=/path/to/key.pem
+# HTTPS works the same with docker-compose.yml and docker-compose.prod.yml:
+# 1. SSL_CERTS_PATH is a host path mounted to /app/ssl inside the container
+# 2. SSL_CERT_FILE and SSL_KEY_FILE must be container paths under /app/ssl
+#
+# Simple local/self-managed cert directory:
+# PORT=443
+# ENABLE_HTTPS=true
+# SSL_CERTS_PATH=./ssl
+# SSL_CERT_FILE=/app/ssl/fullchain.pem
+# SSL_KEY_FILE=/app/ssl/privkey.pem
+#
+# Let's Encrypt on the host:
+# PORT=443
+# ENABLE_HTTPS=true
+# SSL_CERTS_PATH=/etc/letsencrypt
+# SSL_CERT_FILE=/app/ssl/live/example.com/fullchain.pem
+# SSL_KEY_FILE=/app/ssl/live/example.com/privkey.pem
 
 # ── Logging ────────────────────────────────────────────────────
 # LOG_LEVEL=INFO             # INFO = clean (1 log per execution); DEBUG = full detail