자동매매 서비스 랜딩페이지 + 텔레그램 문의 접수

01서버를 두지 않은 이유

의뢰인은 이미 AWS Lightsail 인스턴스를 갖고 있었습니다. 그런데도 거기 올리지 않았습니다. 그 인스턴스가 거래소 API 키를 가진 실거래 시스템이라 공개 웹과 공격면을 같이 쓰게 할 수 없었습니다. 그리고 정적 페이지 + 함수 하나짜리 요구에 VPS를 붙이면 인증서 갱신과 OS 패치가 무유지보수 단발 건의 상시 부채가 됩니다.

• 문의는 저장하지 않는다 — 접수 즉시 텔레그램으로 전달하고 끝. 저장소가 없으니 유출도 없고 처리방침이 단순해집니다. "실시간 신청 현황" 같은 건 못 만든다는 트레이드오프를 명시적으로 골랐습니다.
• 수신자 여럿, 부분 실패 허용 — Promise.allSettled로 동시 발송하고 한 곳이라도 성공하면 접수 성공. 수신자 한 명이 봇을 차단해도 문의가 유실되지 않습니다.
• 스팸 — 허니팟 필드(채워지면 성공인 척하고 버림) + 타임트랩(3초 미만 제출 거부).
• 가짜 데이터는 갈아끼울 수 있게 — 의뢰인이 유지를 원한 "신청현황" 티커의 데이터 생성부를 함수 하나로 격리. 나중에 fetch로 바꾸면 실데이터가 됩니다.
• FAQ 35문항은 8개 + 더 보기 — 전부 펼치면 섹션이 3,453px. 854px로 줄였습니다.

// functions/api/inquiry.js — 접수 → 텔레그램, 골자만
export async function onRequestPost({ request, env }) {
  const f = await request.formData();
  if (f.get("website"))            return ok();        // 허니팟: 성공 위장 폐기
  if (Date.now() - +f.get("t") < 3000) return reject(); // 타임트랩
  const text = escapeHtml(`[문의] ${f.get("name")} / ${f.get("contact")}\n${f.get("msg")}`);
  const sends = env.CHAT_IDS.split(",").map(id => sendTelegram(env.BOT_TOKEN, id, text));
  const r = await Promise.allSettled(sends);
  return r.some(x => x.status === "fulfilled") ? ok() : fail();
}

02배포에서 밟은 것

• 함수가 배포되지 않아 405 — wrangler pages deploy는 functions 폴더를 현재 작업 디렉토리 기준으로 찾습니다. 루트에서 deploy site를 하면 site/functions는 무시되고 정적 파일만 올라갑니다. 배포 출력에 "Compiled Worker successfully"와 "Uploading Functions bundle" 두 줄이 없으면 함수가 빠진 겁니다.
• 엉뚱한 계정에 배포될 뻔 — PowerShell이 한글 경로의 토큰 파일을 못 찾아 환경변수가 빈 값이 됐고, wrangler는 저장된 개인 OAuth로 조용히 폴백해 개발자 개인 계정에 빈 프로젝트를 만들었습니다. 인증 실패가 "에러"가 아니라 "다른 계정으로 성공"이 되는 게 이 사고의 본질입니다. 이후 배포 전 wrangler whoami로 대상 계정을 먼저 확인합니다.
• 전파 전에 검증해 성공으로 오판 — 텔레그램 봇을 교체하고 바로 테스트해 ok를 받았는데 실제 알림은 옛 봇으로 갔습니다. Pages는 환경변수를 배포 단위로 묶어서 전파 전에는 운영 URL이 직전 배포로 응답합니다. 배포 전용 URL이 200을 줄 때까지 기다린 뒤 운영 URL을 봅니다.
• 토큰 권한이 모자라 중간에 멈춤 — Pages Edit 하나만 받았더니 도메인 추가와 DNS에서 인증 오류. 최소 권한은 옳지만 단계마다 의뢰인에게 다시 요청하는 비용이 더 큽니다. 배포 → 도메인 → DNS → 시크릿 여정을 먼저 그리고 한 번에 요청합니다.

03디자인은 말로 하면 네 번 돈다

"신청현황" 영역이 중앙정렬 → 12건 마퀴 → 분산배치 → 알약 카드로 네 번 바뀌었습니다. "휑하다", "정신없다" 같은 피드백을 시각 자료 없이 주고받은 탓입니다. 이후로는 디자인 방향을 2~3안 시안으로 먼저 고르게 하고, 그다음 세부 조정으로 단계를 나눕니다. 수정 횟수 상한이 있는 계약에서 이런 왕복은 곧 마진이라서요.

범위 밖 요구(회원가입·이용권·자동 쪽지)는 "별도입니다"가 아니라 "150~250만 원 규모입니다"로 답했습니다. 금액이 붙는 순간 의뢰인이 스스로 우선순위를 정리해 1단계만 선택했습니다. 반대로 링크가 헛도는 것 같은 하자는 무료 범위입니다. 그 경계를 문서로 나눠 두었습니다.

04관련 사례 · 더 보기