🐳 Add local Docker deployment functionality with health checks and error handling

code/utils/deploy-pokedex.js

@@ -199,6 +199,62 @@ async function healthCheck(host, port, retries = 5) {
   return false;
 }
 
+/**
+ * Local deployment function
+ * @param {Object} config - Deployment configuration
+ */
+async function deployLocal(config) {
+  const { execSync } = await import('child_process');
+  console.log('\n🐳 Deploying to local Docker...');
+  
+  // Create modified docker-compose
+  const modifiedCompose = createModifiedDockerCompose(config.port, config.sslPort, config.backendPort);
+  const tmpComposePath = path.join(SOURCE_DIR, 'docker-compose.tmp.yml');
+  fs.writeFileSync(tmpComposePath, modifiedCompose);
+  
+  try {
+      // Stop existing
+      console.log('  🛑 Stopping existing containers...');
+      try {
+           execSync(`docker compose -f "${tmpComposePath}" down --remove-orphans`, { cwd: SOURCE_DIR, stdio: 'inherit' });
+      } catch (e) {
+          // Ignore if file doesn't exist yet or other issues on down
+           try {
+             execSync(`docker compose -f docker-compose.production.yml down --remove-orphans`, { cwd: SOURCE_DIR, stdio: 'inherit' });
+           } catch (e2) { /* ignore */ }
+      }
+
+      // Up
+      console.log('  🚀 Starting containers...');
+      execSync(`docker compose -f "${tmpComposePath}" up -d --build`, { cwd: SOURCE_DIR, stdio: 'inherit' });
+      
+      // Health Check
+      console.log('\n🏥 Performing health checks...');
+      console.log('  Checking frontend...');
+      const frontendHealthy = await healthCheck('localhost', config.port);
+      if (!frontendHealthy) throw new Error('Frontend health check failed');
+      console.log('  ✅ Frontend healthy');
+
+      console.log('  Checking backend...');
+      const backendHealthy = await healthCheck('localhost', config.backendPort);
+      // Backend might need more time
+      if (!backendHealthy) throw new Error('Backend health check failed');
+      console.log('  ✅ Backend healthy');
+
+      console.log(`\n🎉 Local Deployment successful!`);
+      console.log(`🌐 Frontend: http://localhost:${config.port}`);
+      if (config.sslPort) console.log(`🔒 HTTPS:    https://localhost:${config.sslPort}`);
+      console.log(`🔌 Backend:  http://localhost:${config.backendPort}`);
+
+  } catch (e) {
+      console.error('❌ Local deployment failed:', e.message);
+      // Clean up tmp file? Maybe keep for debugging if failed
+      throw e;
+  } finally {
+      console.log(`\nℹ️  Docker Compose file: ${tmpComposePath}`);
+  }
+}
+
 /**
  * Main deployment function
  */