Merge gitea/main, preserving release v0.2.2 stability and CLI documentation

scripts/deployment/deploy/.env.deploy.example

@@ -0,0 +1,36 @@
+# AITBC Deployment Configuration Template
+# Copy this file to .env.deploy and fill in your actual values
+# NEVER commit the actual .env.deploy file with real credentials
+
+# === REQUIRED DEPLOYMENT SETTINGS ===
+CONTAINER_NAME="aitbc"
+CONTAINER_IP="YOUR_CONTAINER_IP"
+PROJECT_DIR="/path/to/your/aitbc"
+SSH_ALIAS="your-ssh-alias"
+SSH_KEY_PATH="/path/to/your/private/key"
+
+# === OPTIONAL SECURITY SETTINGS ===
+# SSH connection timeout (seconds)
+SSH_TIMEOUT=30
+
+# Backup settings
+CREATE_BACKUP=true
+BACKUP_RETENTION_DAYS=7
+
+# Service restart settings
+RESTART_SERVICES=true
+SERVICE_STARTUP_TIMEOUT=60
+
+# === EXAMPLE VALUES ===
+# CONTAINER_NAME="aitbc"
+# CONTAINER_IP="192.168.1.100"
+# PROJECT_DIR="/home/user/aitbc"
+# SSH_ALIAS="user@container-ip"
+# SSH_KEY_PATH="/home/user/.ssh/id_rsa"
+
+# === SECURITY NOTES ===
+# 1. Never commit this file with real credentials
+# 2. Use SSH keys instead of passwords
+# 3. Restrict file permissions: chmod 600 .env.deploy
+# 4. Use SSH config file for complex connection settings
+# 5. Consider using a secrets management system for production