feat: Add GitHub Actions auto-deploy with zero-downtime restarts

DEPLOYMENT AUTOMATION:
- GitHub Actions workflow for automatic deployment on push to main
- Zero-downtime deployments with Puma phased restarts
- Health check verification after deployment
- Manual trigger support via Actions tab

PRODUCTION CONFIGURATION:
- Puma production config with 2 workers and preload_app
- Worker-specific setup for database reconnection
- Phased restart support (SIGUSR1 signal)
- Zero-downtime deployment capabilities

SYSTEMD SERVICES:
- core-puma.service: Puma web server with reload support
- core-solidqueue.service: Background job worker
- Both configured with auto-restart and logging

COMPREHENSIVE DOCUMENTATION:
- Complete deployment guide (docs/DEPLOYMENT.md)
- Initial setup instructions (VPS, Ruby, PostgreSQL, Nginx, SSL)
- GitHub Actions CI/CD setup with secrets
- Manual deployment procedures
- Troubleshooting guide and maintenance tasks

DEPLOYMENT FLOW:
1. Push to main → GitHub Actions triggered
2. SSH to VPS → Pull + Bundle + Assets + Migrate
3. Reload Puma (zero-downtime) → Restart Solid Queue
4. Health check → Production live

Benefits:
- Automatic deployments (no manual SSH needed)
- Zero-downtime (Puma phased restart)
- Quick deployments (~2-3 minutes)
- Rollback capability
- Production-ready configuration

Ready for VPS deployment!

Author: rz1989s

.github/workflows/deploy.yml

@@ -0,0 +1,103 @@
+name: Deploy to Production
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch: # Allow manual trigger
+
+jobs:
+  deploy:
+    name: Deploy to VPS
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Install SSH key
+        uses: shimataro/ssh-key-action@v2
+        with:
+          key: ${{ secrets.VPS_SSH_KEY }}
+          known_hosts: unnecessary
+          if_key_exists: replace
+
+      - name: Add VPS to known hosts
+        run: ssh-keyscan -H ${{ secrets.VPS_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Deploy to VPS
+        env:
+          VPS_HOST: ${{ secrets.VPS_HOST }}
+          VPS_USER: ${{ secrets.VPS_USER }}
+        run: |
+          ssh $VPS_USER@$VPS_HOST << 'ENDSSH'
+            set -e
+
+            echo "🚀 Starting deployment..."
+
+            cd ~/core
+
+            # Pull latest changes
+            echo "📥 Pulling latest code from main..."
+            git fetch origin
+            git reset --hard origin/main
+
+            # Install dependencies
+            echo "📦 Installing dependencies..."
+            bundle install --deployment --without development test
+
+            # Precompile assets
+            echo "🎨 Precompiling assets..."
+            RAILS_ENV=production bundle exec rails assets:precompile
+
+            # Run database migrations
+            echo "🗄️  Running database migrations..."
+            RAILS_ENV=production bundle exec rails db:migrate
+
+            # Restart services (zero-downtime)
+            echo "🔄 Restarting Puma (zero-downtime)..."
+            sudo systemctl reload core-puma
+
+            echo "🔄 Restarting Solid Queue..."
+            sudo systemctl restart core-solidqueue
+
+            # Verify deployment
+            echo "✅ Deployment complete!"
+            echo "📊 App status:"
+            sudo systemctl status core-puma --no-pager -l
+
+          ENDSSH
+
+      - name: Verify deployment
+        env:
+          VPS_HOST: ${{ secrets.VPS_HOST }}
+          VPS_USER: ${{ secrets.VPS_USER }}
+        run: |
+          # Wait for app to be ready
+          sleep 5
+
+          # Check if site is responding
+          if curl -f -s -o /dev/null https://rectorspace.com/up; then
+            echo "✅ Production site is healthy!"
+          else
+            echo "❌ Production site health check failed!"
+            exit 1
+          fi
+
+      - name: Notify deployment success
+        if: success()
+        run: |
+          echo "✅ Deployment successful!"
+          echo "🌐 Visit: https://rectorspace.com"
+
+      - name: Notify deployment failure
+        if: failure()
+        run: |
+          echo "❌ Deployment failed!"
+          echo "Check logs: https://github.com/${{ github.repository }}/actions"

config/puma.rb

@@ -40,3 +40,25 @@
 # Specify the PID file. Defaults to tmp/pids/server.pid in development.
 # In other environments, only set the PID file if requested.
 pidfile ENV["PIDFILE"] if ENV["PIDFILE"]
+
+# Production-specific configuration
+if ENV["RAILS_ENV"] == "production"
+  # Run 2 worker processes for production
+  workers ENV.fetch("WEB_CONCURRENCY", 2)
+
+  # Preload application for memory efficiency
+  preload_app!
+
+  # Allow phased restarts for zero-downtime deployments
+  # When you run `systemctl reload core-puma`, Puma will:
+  # 1. Start new workers with updated code
+  # 2. Gradually kill old workers after requests complete
+  # 3. No requests are dropped during deployment
+  worker_timeout 30
+  worker_boot_timeout 30
+
+  # Worker-specific setup (e.g., reconnect to database)
+  on_worker_boot do
+    ActiveRecord::Base.establish_connection if defined?(ActiveRecord)
+  end
+end