feat: add server ordering system with session-based flow

- Add server recommendation integration (SERVER_RECOMMEND worker)
- Implement KV-based session management for multi-step ordering
- Add Linode/Vultr API clients for server provisioning
- Add server-tool for Function Calling support

refactor: major code reorganization (Phase 1-3)

- Remove 443 lines of deprecated callback handlers
- Extract handlers to separate files (message-handler, callback-handler)
- Extract cloud-spec-service, server-recommend-service
- Centralize constants (OS_IMAGES, REGION_FLAGS, NUM_EMOJIS)
- webhook.ts reduced from 1,951 to 30 lines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
kappa
2026-01-24 21:01:38 +09:00
parent dab279c765
commit 6563ee0650
14 changed files with 4019 additions and 241 deletions

View File

@@ -0,0 +1,613 @@
import { sendMessage, sendMessageWithKeyboard } from '../../telegram';
import { checkRateLimit } from '../../security';
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';
/**
* 메시지 처리 핸들러
*/
export async function handleMessage(
env: Env,
update: TelegramUpdate
): Promise<void> {
if (!update.message?.text) return;
const { message } = update;
const chatId = message.chat.id;
const chatIdStr = chatId.toString();
const text = message.text!;
const telegramUserId = message.from.id.toString();
// 1. Rate Limiting 체크
if (!(await checkRateLimit(env.RATE_LIMIT_KV, telegramUserId))) {
await sendMessage(
env.BOT_TOKEN,
chatId,
'⚠️ 너무 많은 요청입니다. 잠시 후 다시 시도해주세요.'
);
return;
}
// 2. 서비스 인스턴스 초기화
const userService = new UserService(env.DB);
const conversationService = new ConversationService(env);
// 3. 사용자 조회/생성
let userId: number;
try {
userId = await userService.getOrCreateUser(
telegramUserId,
message.from.first_name,
message.from.username
);
} catch (dbError) {
console.error('[handleMessage] 사용자 DB 오류:', dbError);
await sendMessage(
env.BOT_TOKEN,
chatId,
ERROR_MESSAGES.TEMPORARY_ERROR
);
return;
}
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. 명령어 처리
if (text.startsWith('/')) {
const [command, ...argParts] = text.split(' ');
const args = argParts.join(' ');
const responseText = await handleCommand(env, userId, chatIdStr, command, args);
// /start 명령어는 미니앱 버튼과 함께 전송
if (command === '/start') {
const hostingUrl = env.HOSTING_SITE_URL || 'https://hosting.anvil.it.com';
await sendMessageWithKeyboard(env.BOT_TOKEN, chatId, responseText, [
[{ text: '🌐 서비스 보기', web_app: { url: hostingUrl } }],
[{ text: '💬 문의하기', url: 'https://t.me/AnvilForgeBot' }],
]);
return;
}
await sendMessage(env.BOT_TOKEN, chatId, responseText);
return;
}
// 5. 일반 대화 처리 (ConversationService 위임)
const result = await conversationService.processUserMessage(
userId,
chatIdStr,
text,
telegramUserId
);
let finalResponse = result.responseText;
if (result.isProfileUpdated) {
finalResponse += '\n\n<i>👤 프로필이 업데이트되었습니다.</i>';
}
// 6. 응답 전송 (키보드 포함 여부 확인)
if (result.keyboardData) {
console.log('[Webhook] Keyboard data received:', result.keyboardData.type);
if (result.keyboardData.type === 'domain_register') {
const { domain, price } = result.keyboardData;
const callbackData = `domain_reg:${domain}:${price}`;
await sendMessageWithKeyboard(env.BOT_TOKEN, chatId, finalResponse, [
[
{ text: '✅ 등록하기', callback_data: callbackData },
{ 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);
await sendMessage(env.BOT_TOKEN, chatId, finalResponse);
}
} else {
await sendMessage(env.BOT_TOKEN, chatId, finalResponse);
}
} catch (error) {
console.error('[handleMessage] 처리 오류:', error);
await sendMessage(
env.BOT_TOKEN,
chatId,
'⚠️ 메시지 처리 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.'
);
}
}