refactor: migrate server provisioning to Cloud Orchestrator service

- Remove Queue-based server provisioning (moved to cloud-orchestrator)
- Add manage_server tool with Service Binding to Cloud Orchestrator
- Add CDN cache hit rate estimation based on tech_stack
- Always display bandwidth info (show "포함 범위 내" when no overage)
- Add language auto-detection (ko, ja, zh, en)
- Update system prompt to always call tools fresh
- Add Server System documentation to CLAUDE.md

BREAKING: Server provisioning now requires cloud-orchestrator service

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

src/routes/handlers/message-handler.ts

@@ -4,15 +4,6 @@ import { handleCommand } from '../../commands';
 import { UserService } from '../../services/user-service';
 import { ConversationService } from '../../services/conversation-service';
 import { ERROR_MESSAGES } from '../../constants/messages';
-import {
-  createSession,
-  updateSession,
-  deleteSession,
-  getUserActiveSession,
-  ServerOrderSessionData,
-} from '../../utils/session';
-import { getServerSpec } from '../../services/cloud-spec-service';
-import { getRegionDisplay, getOSDisplayName, NUM_EMOJIS } from '../../constants/server';
 import type { Env, TelegramUpdate } from '../../types';
 
 /**
@@ -63,458 +54,7 @@ export async function handleMessage(
   }
 
   try {
-    // 4. 세션 기반 대화형 서버 주문 플로우 처리
-    const serverSession = await getUserActiveSession<ServerOrderSessionData>(
-      env.SESSION_KV,
-      userId,
-      'server_order'
-    );
-
-    if (serverSession) {
-      const { sessionId, session } = serverSession;
-      const { step } = session;
-      const lowerText = text.toLowerCase().trim();
-
-      // 취소 패턴 (모든 단계에서)
-      if (/^(취소|그만|중단|cancel|stop)/.test(lowerText)) {
-        // pending 주문 있으면 취소
-        if (session.data.orderId) {
-          await env.DB.prepare(
-            "UPDATE server_orders SET status = 'cancelled' WHERE id = ? AND user_id = ? AND status = 'pending'"
-          ).bind(session.data.orderId, userId).run();
-        }
-        await deleteSession(env.SESSION_KV, sessionId);
-        await sendMessage(env.BOT_TOKEN, chatId,
-          '❌ 서버 주문이 취소되었습니다.\n\n다시 시작하려면 "서버 추천해줘"라고 말씀해주세요.'
-        );
-        return;
-      }
-
-      // Step 1: recommend - 추천 목록에서 선택
-      if (step === 'recommend' && session.data.recommendations) {
-        // 숫자 패턴: "1", "1번", "첫번째", "첫 번째"
-        const numPatterns: Record<string, number> = {
-          '1': 0, '1번': 0, '첫번째': 0, '첫 번째': 0, '일번': 0,
-          '2': 1, '2번': 1, '두번째': 1, '두 번째': 1, '이번': 1,
-          '3': 2, '3번': 2, '세번째': 2, '세 번째': 2, '삼번': 2,
-          '4': 3, '4번': 3, '네번째': 3, '네 번째': 3, '사번': 3,
-          '5': 4, '5번': 4, '다섯번째': 4, '다섯 번째': 4, '오번': 4,
-        };
-
-        const matchedIndex = numPatterns[lowerText];
-        if (matchedIndex !== undefined && matchedIndex < session.data.recommendations.length) {
-          const selected = session.data.recommendations[matchedIndex];
-
-          // 세션 업데이트
-          await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-            step: 'spec_confirm',
-            plan: selected.plan,
-            region: selected.region,
-            provider: selected.provider,
-            recommendations: undefined
-          });
-
-          // 사양 조회
-          const spec = await getServerSpec(
-            env.CLOUD_DB,
-            selected.plan,
-            selected.region,
-            selected.provider
-          );
-
-          if (!spec) {
-            await sendMessage(env.BOT_TOKEN, chatId, '❌ 사양을 찾을 수 없습니다. 다시 시도해주세요.');
-            return;
-          }
-
-          await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-            priceKrw: spec.monthly_price_krw
-          });
-
-          const ramGB = (spec.memory_mb / 1024).toFixed(1);
-          await sendMessage(env.BOT_TOKEN, chatId,
-            `📦 <b>${matchedIndex + 1}번 사양 선택</b>
-
-<b>컴퓨팅</b>
-• vCPU: ${spec.vcpu}개
-• RAM: ${ramGB}GB
-• 스토리지: ${spec.storage_gb}GB SSD
-• 트래픽: ${spec.transfer_tb}TB/월
-
-<b>요금</b>
-• 월 ${spec.monthly_price_krw.toLocaleString()}원
-
-🖥️ <b>OS를 선택해주세요:</b>
-• "우분투" 또는 "ubuntu 22"
-• "우분투 24" 또는 "ubuntu 24"
-• "데비안" 또는 "debian"
-• "센토스" 또는 "centos"
-
-💡 "뒤로"로 추천 목록으로, "다시"로 새 추천, "취소"로 중단할 수 있습니다.`
-          );
-          return;
-        }
-      }
-
-      // Step 2: spec_confirm - OS 선택
-      if (step === 'spec_confirm') {
-        // "뒤로" 패턴 - 추천 목록으로 돌아가기
-        if (/^(뒤로|back)$/.test(lowerText)) {
-          await sendMessage(env.BOT_TOKEN, chatId, '🔄 추천 목록을 다시 불러오는 중...');
-
-          try {
-            const requestBody = {
-              tech_stack: ['nginx'],
-              expected_users: 100,
-              use_case: 'general purpose server',
-              lang: 'ko'
-            };
-
-            const response = env.SERVER_RECOMMEND
-              ? await env.SERVER_RECOMMEND.fetch('https://internal/api/recommend', {
-                  method: 'POST',
-                  headers: { 'Content-Type': 'application/json' },
-                  body: JSON.stringify(requestBody),
-                })
-              : await fetch(env.SERVER_RECOMMEND_API_URL || 'https://server-recommend.kappa-d8e.workers.dev/api/recommend', {
-                  method: 'POST',
-                  headers: { 'Content-Type': 'application/json' },
-                  body: JSON.stringify(requestBody),
-                });
-
-            if (!response.ok) throw new Error(`API error: ${response.status}`);
-
-            const result = await response.json() as {
-              recommendations?: Array<{
-                server: {
-                  instance_id: string;
-                  region_code: string;
-                  provider_name: string;
-                  vcpu: number;
-                  memory_mb: number;
-                  storage_gb: number;
-                  monthly_price: number;
-                };
-                score: number;
-              }>;
-            };
-
-            if (!result.recommendations || result.recommendations.length === 0) {
-              throw new Error('No recommendations');
-            }
-
-            const topRecs = result.recommendations.slice(0, 5);
-
-            // 세션 업데이트 (step: recommend, recommendations 다시 저장)
-            await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-              step: 'recommend',
-              plan: undefined,
-              region: undefined,
-              provider: undefined,
-              priceKrw: undefined,
-              recommendations: topRecs.map(rec => ({
-                plan: rec.server.instance_id,
-                region: rec.server.region_code,
-                provider: rec.server.provider_name.toLowerCase()
-              }))
-            });
-
-            let responseText = `🎯 <b>서버 추천</b>\n\n`;
-            topRecs.forEach((rec, index) => {
-              const server = rec.server;
-              const ramGB = (server.memory_mb / 1024).toFixed(1);
-              const priceKrw = Math.round(server.monthly_price);
-              const regionDisplay = getRegionDisplay(server.region_code);
-              responseText += `${NUM_EMOJIS[index]} <b>${server.vcpu} vCPU / ${ramGB}GB RAM / ${server.storage_gb}GB SSD</b>\n`;
-              responseText += `   ${regionDisplay} | 💰 ${priceKrw.toLocaleString()}원/월 | 🎯 점수: ${rec.score}/100\n\n`;
-            });
-            responseText += `💬 <b>원하시는 번호를 입력해주세요</b>\n예: "1번" 또는 "첫번째"\n\n💡 "취소"로 언제든 중단할 수 있습니다.`;
-
-            await sendMessage(env.BOT_TOKEN, chatId, responseText);
-          } catch (error) {
-            console.error('[back] 추천 API 오류:', error);
-            await sendMessage(env.BOT_TOKEN, chatId,
-              '❌ 추천 목록을 불러오는 중 오류가 발생했습니다.\n\n💡 "서버 추천해줘"라고 다시 말씀해주세요.'
-            );
-            await deleteSession(env.SESSION_KV, sessionId);
-          }
-          return;
-        }
-
-        // "다시" 패턴 - 새로 추천받기 (기존 세션 유지하면서 새 추천)
-        if (/^(다시|다른)/.test(lowerText)) {
-          await sendMessage(env.BOT_TOKEN, chatId, '🔄 새로운 추천을 받는 중...');
-
-          try {
-            const requestBody = {
-              tech_stack: ['nginx'],
-              expected_users: 100,
-              use_case: 'general purpose server',
-              lang: 'ko'
-            };
-
-            const response = env.SERVER_RECOMMEND
-              ? await env.SERVER_RECOMMEND.fetch('https://internal/api/recommend', {
-                  method: 'POST',
-                  headers: { 'Content-Type': 'application/json' },
-                  body: JSON.stringify(requestBody),
-                })
-              : await fetch(env.SERVER_RECOMMEND_API_URL || 'https://server-recommend.kappa-d8e.workers.dev/api/recommend', {
-                  method: 'POST',
-                  headers: { 'Content-Type': 'application/json' },
-                  body: JSON.stringify(requestBody),
-                });
-
-            if (!response.ok) throw new Error(`API error: ${response.status}`);
-
-            const result = await response.json() as {
-              recommendations?: Array<{
-                server: {
-                  instance_id: string;
-                  region_code: string;
-                  provider_name: string;
-                  vcpu: number;
-                  memory_mb: number;
-                  storage_gb: number;
-                  monthly_price: number;
-                };
-                score: number;
-              }>;
-            };
-
-            if (!result.recommendations || result.recommendations.length === 0) {
-              throw new Error('No recommendations');
-            }
-
-            const topRecs = result.recommendations.slice(0, 5);
-
-            // 세션 업데이트 (새 추천으로 교체)
-            await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-              step: 'recommend',
-              plan: undefined,
-              region: undefined,
-              provider: undefined,
-              priceKrw: undefined,
-              recommendations: topRecs.map(rec => ({
-                plan: rec.server.instance_id,
-                region: rec.server.region_code,
-                provider: rec.server.provider_name.toLowerCase()
-              }))
-            });
-
-            let responseText = `🎯 <b>새로운 서버 추천</b>\n\n`;
-            topRecs.forEach((rec, index) => {
-              const server = rec.server;
-              const ramGB = (server.memory_mb / 1024).toFixed(1);
-              const priceKrw = Math.round(server.monthly_price);
-              const regionDisplay = getRegionDisplay(server.region_code);
-              responseText += `${NUM_EMOJIS[index]} <b>${server.vcpu} vCPU / ${ramGB}GB RAM / ${server.storage_gb}GB SSD</b>\n`;
-              responseText += `   ${regionDisplay} | 💰 ${priceKrw.toLocaleString()}원/월 | 🎯 점수: ${rec.score}/100\n\n`;
-            });
-            responseText += `💬 <b>원하시는 번호를 입력해주세요</b>\n예: "1번" 또는 "첫번째"\n\n💡 "취소"로 언제든 중단할 수 있습니다.`;
-
-            await sendMessage(env.BOT_TOKEN, chatId, responseText);
-          } catch (error) {
-            console.error('[다시] 추천 API 오류:', error);
-            await sendMessage(env.BOT_TOKEN, chatId,
-              '❌ 새 추천을 받는 중 오류가 발생했습니다.\n\n💡 "서버 추천해줘"라고 다시 말씀해주세요.'
-            );
-            await deleteSession(env.SESSION_KV, sessionId);
-          }
-          return;
-        }
-
-        // OS 패턴 매칭
-        let osImage: string | null = null;
-        if (/우분투\s*22|ubuntu\s*22|우분투$|ubuntu$/.test(lowerText)) {
-          osImage = 'ubuntu-22.04';
-        } else if (/우분투\s*24|ubuntu\s*24/.test(lowerText)) {
-          osImage = 'ubuntu-24.04';
-        } else if (/데비안|debian/.test(lowerText)) {
-          osImage = 'debian-12';
-        } else if (/센토스|centos/.test(lowerText)) {
-          osImage = 'centos-stream-9';
-        }
-
-        if (osImage) {
-          const { plan, region, provider } = session.data;
-
-          // 사양 재조회
-          const spec = await getServerSpec(
-            env.CLOUD_DB,
-            plan!,
-            region!,
-            provider!
-          );
-
-          if (!spec) {
-            await sendMessage(env.BOT_TOKEN, chatId, '❌ 사양 정보를 찾을 수 없습니다.');
-            return;
-          }
-
-          // 잔액 확인
-          const deposit = await env.DB.prepare(
-            "SELECT balance FROM user_deposits WHERE user_id = ?"
-          ).bind(userId).first<{ balance: number }>();
-          const balance = deposit?.balance || 0;
-
-          if (balance < spec.monthly_price_krw) {
-            const shortage = spec.monthly_price_krw - balance;
-            await sendMessage(env.BOT_TOKEN, chatId,
-              `❌ <b>잔액 부족</b>
-
-• 필요 금액: ${spec.monthly_price_krw.toLocaleString()}원
-• 현재 잔액: ${balance.toLocaleString()}원
-• 부족 금액: ${shortage.toLocaleString()}원
-
-💳 <b>입금 계좌</b>
-하나은행 427-910018-27104 (주식회사 아이언클래드)
-
-입금 후 다시 시도해주세요.`
-            );
-            return;
-          }
-
-          // 주문 생성
-          const label = `server-${Date.now()}`;
-          const orderResult = await env.DB.prepare(`
-            INSERT INTO server_orders (user_id, spec_id, status, label, region, image, price_paid, billing_type, created_at)
-            VALUES (?, ?, 'pending', ?, ?, ?, ?, 'monthly', datetime('now'))
-          `).bind(userId, spec.pricing_id, label, region, osImage, spec.monthly_price_krw).run();
-
-          const orderId = orderResult.meta?.last_row_id;
-
-          await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-            step: 'final_confirm',
-            image: osImage,
-            orderId: orderId
-          });
-
-
-          const ramGB = (spec.memory_mb / 1024).toFixed(1);
-          await sendMessage(env.BOT_TOKEN, chatId,
-            `✅ <b>최종 확인</b>
-
-• 사양: ${spec.vcpu} vCPU / ${ramGB}GB RAM / ${spec.storage_gb}GB SSD
-• OS: ${getOSDisplayName(osImage)}
-• 가격: ${spec.monthly_price_krw.toLocaleString()}원/월
-• 현재 잔액: ${balance.toLocaleString()}원
-
-⚠️ <b>요금 안내</b>
-월 선불제이며, 중도 해지 시 시간당 요금으로 정산 후 환불됩니다.
-
-🚀 서버를 생성하시려면 "<b>확인</b>" 또는 "<b>생성</b>"이라고 입력하세요.
-❌ 취소하시려면 "<b>취소</b>"라고 입력하세요.`
-          );
-          return;
-        }
-      }
-
-      // Step 3: final_confirm - 최종 확인
-      if (step === 'final_confirm') {
-        // "뒤로" 패턴 - OS 선택으로
-        if (/^(뒤로|back|os)/.test(lowerText)) {
-          // pending 주문 삭제
-          if (session.data.orderId) {
-            await env.DB.prepare(
-              "DELETE FROM server_orders WHERE id = ? AND user_id = ? AND status = 'pending'"
-            ).bind(session.data.orderId, userId).run();
-          }
-
-          await updateSession<ServerOrderSessionData>(env.SESSION_KV, sessionId, {
-            step: 'spec_confirm',
-            image: undefined,
-            orderId: undefined
-          });
-
-          // 선택된 사양 정보 표시
-          const { priceKrw } = session.data;
-          const priceInfo = priceKrw ? `${priceKrw.toLocaleString()}원/월` : '?';
-
-          await sendMessage(env.BOT_TOKEN, chatId,
-            `🖥️ <b>OS를 다시 선택해주세요:</b>
-
-현재 선택된 사양: ${priceInfo}
-
-• "우분투" 또는 "ubuntu 22"
-• "우분투 24" 또는 "ubuntu 24"
-• "데비안" 또는 "debian"
-• "센토스" 또는 "centos"
-
-💡 "뒤로"로 사양 선택으로 돌아가거나, "취소"로 중단할 수 있습니다.`
-          );
-          return;
-        }
-
-        // 확인 패턴 - 서버 생성
-        if (/^(확인|진행|생성|네|예|ok|yes|confirm)/.test(lowerText)) {
-          const { orderId } = session.data;
-
-          if (!orderId) {
-            await sendMessage(env.BOT_TOKEN, chatId, '❌ 주문 정보가 없습니다. 다시 시작해주세요.');
-            await deleteSession(env.SESSION_KV, sessionId);
-            return;
-          }
-
-          await sendMessage(env.BOT_TOKEN, chatId, '⏳ 서버를 생성하고 있습니다... (1-3분 소요)');
-
-          // 서버 생성 실행은 webhook.ts에서 executeServerProvision 임포트
-          const { executeServerProvision } = await import('../../server-provision');
-          const result = await executeServerProvision(env, userId, telegramUserId, orderId);
-
-          // 세션 삭제
-          await deleteSession(env.SESSION_KV, sessionId);
-
-          if (result.success) {
-            await sendMessage(env.BOT_TOKEN, chatId,
-              `✅ <b>서버 생성 완료!</b>
-
-• IP 주소: <code>${result.ip_address}</code>
-• Root 비밀번호: <code>${result.root_password}</code>
-
-📌 <b>접속 방법</b>
-<code>ssh root@${result.ip_address}</code>
-
-⚠️ <b>보안 권고</b>
-1. 즉시 비밀번호를 변경하세요: <code>passwd</code>
-2. SSH 키 인증 설정을 권장합니다.
-
-🎉 서버가 성공적으로 생성되었습니다!`
-            );
-          } else {
-            await sendMessage(env.BOT_TOKEN, chatId,
-              `❌ <b>서버 생성 실패</b>
-
-${result.error}
-
-다시 시도하시려면 "서버 추천해줘"라고 말씀해주세요.`
-            );
-          }
-          return;
-        }
-      }
-
-      // 세션은 있지만 매칭되는 입력이 아닌 경우 - 힌트 제공
-      // (AI 응답으로 넘어가도록 여기서 return 하지 않음)
-      // 단, 명확한 서버 관련 질문이면 힌트 제공
-      if (/서버|사양|os|운영체제/.test(lowerText) && !/추천|알려/.test(lowerText)) {
-        let hint = '';
-        if (step === 'recommend') {
-          hint = '💡 추천 목록에서 번호를 선택해주세요. (예: "1번", "두번째")';
-        } else if (step === 'spec_confirm') {
-          hint = '💡 OS를 선택해주세요. (예: "우분투", "debian")';
-        } else if (step === 'final_confirm') {
-          hint = '💡 "확인"으로 서버를 생성하거나, "취소"로 주문을 취소할 수 있습니다.';
-        }
-        if (hint) {
-          await sendMessage(env.BOT_TOKEN, chatId, hint);
-          return;
-        }
-      }
-    }
-    // === 세션 기반 대화형 플로우 처리 끝 ===
-
-    // 5. 명령어 처리
+    // 4. 명령어 처리
     if (text.startsWith('/')) {
       const [command, ...argParts] = text.split(' ');
       const args = argParts.join(' ');
@@ -560,39 +100,6 @@ ${result.error}
             { text: '❌ 취소', callback_data: 'domain_cancel' }
           ]
         ]);
-      } else if (result.keyboardData.type === 'server_order') {
-        const { order_id } = result.keyboardData;
-        const confirmData = `server_order:${order_id}`;
-        const cancelData = `server_cancel:${order_id}`;
-
-        await sendMessageWithKeyboard(env.BOT_TOKEN, chatId, finalResponse, [
-          [
-            { text: '✅ 생성하기', callback_data: confirmData },
-            { text: '❌ 취소', callback_data: cancelData }
-          ]
-        ]);
-      } else if (result.keyboardData.type === 'server_recommend') {
-        const { specs } = result.keyboardData;
-
-        // 세션 생성 (기존 세션 있으면 덮어씀) - 추천 목록 저장
-        await createSession<ServerOrderSessionData>(
-          env.SESSION_KV,
-          userId,
-          'server_order',
-          {
-            recommendations: specs.map(spec => ({
-              plan: spec.plan,
-              region: spec.region,
-              provider: spec.provider
-            }))
-          },
-          'recommend'
-        );
-
-        // 대화형 안내 추가 (버튼 없이 메시지만)
-        const guideText = `\n\n💬 <b>원하시는 번호를 입력해주세요</b>\n예: "1번" 또는 "첫번째"\n\n💡 "취소"로 언제든 중단할 수 있습니다.`;
-
-        await sendMessage(env.BOT_TOKEN, chatId, finalResponse + guideText);
       } else {
         // TypeScript exhaustiveness check - should never reach here
         console.warn('[Webhook] Unknown keyboard type:', (result.keyboardData as { type: string }).type);