AutoCoder.cc로 AI 앱을 만들고 백엔드를 프로덕션에 대비하는 방법

화면 목록보다 검증 가능한 사용자 여정을 작성하기

AutoCoder 공식 개요는 프론트엔드와 UI, 백엔드 API와 로직, 데이터 영속성, 사용자 인증, 배포, 소스 코드 내보내기를 지원 범위로 설명합니다. Build 과정에서는 자연어 설명을 Requirement List로 바꾸고 데모 생성 전에 요구사항을 다듬을 수 있습니다.

로그인 화면, 대시보드, 업로드 화면만 나열하는 대신 완료 조건이 있는 흐름을 적는 편이 좋습니다. 문서 분석 서비스라면 다음과 같습니다.

1. 사용자가 계정을 만들고 허용된 형식의 파일을 업로드합니다.
2. 백엔드가 파일 크기, 형식, 문서 소유권을 확인합니다.
3. 분석 작업에 고유 ID와 표시 가능한 상태가 부여됩니다.
4. 모델 API는 브라우저가 아니라 백엔드에서만 호출됩니다.
5. UI는 결과 또는 통제된 오류를 보여 주고 API key나 공급자의 내부 응답을 노출하지 않습니다.

생성 후에는 정상 파일, 잘못된 파일, 반복 제출을 각각 실행해 보세요. 첫 화면의 완성도만 봐서는 권한 누락, 중복 작업, 빠져나올 수 없는 오류 상태를 발견하기 어렵습니다.

플랫폼 게시와 소스 내보내기를 구분하기

AutoCoder에는 편집기에서 실제 URL로 넘어가는 두 방식이 있습니다. 내장 publish는 Website URL과 Backend URL을 생성합니다. 인프라 일부가 플랫폼 경계 안에 남으므로 데모나 초기 가설 검증에 적합합니다.

저장소, 환경, CI/CD, secret, 서버, rollback을 팀이 직접 관리해야 한다면 소스 내보내기를 선택합니다. 현재 Plans & Credits와 Deploy & Hosting 문서에 따르면 Source Code Export는 유료 플랜 기능이며 Free에서는 제공되지 않습니다. 가격과 credit은 달라질 수 있으므로 오래된 숫자를 아키텍처에 고정하지 말고 구매 전에 현재 페이지를 확인하세요.

선택할 때는 네 가지를 묻습니다.

• 아이디어 검증용 URL이 빨리 필요한가?
• dev, staging, production 환경을 분리해야 하는가?
• CI/CD, secret, rollback을 자체 절차로 통제해야 하는가?
• 팀이 앱의 운영, 수정, 모니터링을 책임질 수 있는가?

소스 코드를 확보하는 것은 기술 검수의 시작입니다. 의존성 검토, 권한 설정, migration의 가역성, 예상 트래픽 대응까지 증명하지는 않습니다.

모델 API는 백엔드 안쪽에 배치하기

이 구조에서 AutoCoder는 인터페이스, 서버 로직, 데이터 구조 등 애플리케이션 계층을 생성하고 내보냅니다. BetterToken은 요약, 분류, 추출 같은 기능을 위한 모델 API로 백엔드에 연결됩니다. API key는 프론트엔드 bundle, HTML, 모바일 패키지, 공개 저장소에 들어가면 안 됩니다.

현재 공개된 BetterToken API Reference는 OpenAI 호환 Chat Completions를 설명합니다.

Base URL: https://www.bettertoken.ai/v1
Request URL: https://www.bettertoken.ai/v1/chat/completions
Authorization: Bearer YOUR_API_KEY
Model: YOUR_MODEL_ID

YOUR_MODEL_ID는 설정값으로 유지하세요. 현재 모델 카탈로그나 해당 API key의 Console Setup에서 ID를 복사합니다. 예전 튜토리얼에 나온 모델 이름은 영구적인 의존성이 아닙니다.

내보낸 Node.js 백엔드의 환경 변수는 다음처럼 시작할 수 있습니다.

OPENAI_BASE_URL=https://www.bettertoken.ai/v1
BETTERTOKEN_API_KEY=your_api_key_here
BETTERTOKEN_MODEL_ID=copy_current_model_id_here

실제 값은 Git에 commit하지 말고 환경별 secret manager를 통해 runtime에 제공합니다. 호환 client의 초기화도 서버 모듈 안에만 둡니다.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: process.env.OPENAI_BASE_URL,
  apiKey: process.env.BETTERTOKEN_API_KEY,
});

export async function summarizeDocument(text: string) {
  const response = await client.chat.completions.create({
    model: process.env.BETTERTOKEN_MODEL_ID!,
    messages: [
      { role: "system", content: "Return a concise factual summary." },
      { role: "user", content: text },
    ],
  });

  return response.choices[0]?.message?.content ?? "";
}

이 코드는 모듈 경계를 보여 주는 예시이지 완성된 프로덕션 middleware가 아닙니다. 누락된 변수 검사, 입력 크기 제한, timeout, 오류 분류, 문서 본문과 key를 제외하는 안전한 logging을 추가해야 합니다.

실제 트래픽 전에 스모크 테스트하기

첫 번째 최소 요청은 앱의 주요 비즈니스 로직 밖에서 보냅니다. API 설정 오류와 생성된 프로젝트의 버그를 분리하기 위해서입니다.

curl "https://www.bettertoken.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Reply with: API connected"}
    ]
  }'

성공 응답에는 choices[0].message.content가 포함됩니다. 다음으로 앱의 서버 route에서 같은 작은 시나리오를 실행하고 아래를 확인합니다.

• 요청이 브라우저가 아니라 백엔드에서 출발합니다.
• 실제 key가 소스나 브라우저 network trace에 보이지 않습니다.
• upstream 오류가 통제된 애플리케이션 응답으로 변환됩니다.
• BetterToken Dashboard에 모델, 시간, 상태, input/output/cache token 사용량이 기록됩니다.

직접 호출한 curl은 성공하지만 서버 route가 실패한다면 환경 로딩, 변수 이름, proxy, body 직렬화, 응답 파싱을 확인하세요. 둘 다 실패한다면 프론트엔드를 바꾸기 전에 key, 현재 Model ID, URL, 반환된 오류를 점검해야 합니다.

프로덕션 전 기술 검수

의존성과 빌드. lockfile을 보존하고 clean install과 production build를 실행합니다. 라이선스를 검토하고 사용하지 않는 패키지를 제거합니다.

인증과 권한. 사용자가 자신의 객체만 읽고 수정할 수 있는지 확인합니다. 비로그인 요청, 일반 계정, 관리자 계정을 따로 테스트합니다.

데이터베이스. schema 변경을 migration으로 보존하고 데이터 복사본에서 upgrade를 시험하며 복구 절차를 준비합니다. 기록 없이 시작 시점에 테이블을 바꾸면 rollback이 어려워집니다.

Secrets. 개발, staging, production의 key를 분리합니다. runtime에는 필요한 값만 주고 사고 전에 rotation 절차를 문서화합니다.

Timeout과 retry. 모델 호출 시간에 상한을 둡니다. 멱등성을 이해한 작업만 재시도해야 하며, 무제한 retry는 queue와 비용을 함께 늘릴 수 있습니다.

관측성과 예산. 비공개 입력을 log에 남기지 않으면서 내부 task ID를 API 시간과 상태에 연결합니다. Dashboard로 모델, 상태, 실제 token 사용량을 대조하고 앱의 입력·재시도 제한으로 예산을 보호합니다.

Rollback. 이전에 동작한 artifact와 되돌릴 수 있는 설정을 보관합니다. 코드를 되돌릴 때 이미 적용된 database migration과 충돌하지 않는지 확인합니다.

핵심 사용자 여정이 staging에서 통과하고, 권한이 검증되고, 모델 API가 독립적인 스모크 테스트에 성공하며, 데이터 유출 없이 장애가 보이고, rollback을 실제로 수행한 뒤에 제한적인 프로덕션 파일럿을 시작할 수 있습니다. 생성된 코드만으로는 이를 증명할 수 없습니다.

AI 호출을 통제된 백엔드 경로로 옮기려면 별도 API key를 만들고 현재 Model ID를 복사한 다음 BetterToken API Reference에 따라 첫 요청을 실행하세요. 실제 트래픽을 활성화하기 전에 Dashboard 기록을 앱의 task ID와 대조합니다.

참고 자료

• AutoCoder 기능 개요
• AutoCoder Build 과정
• AutoCoder 플랜과 소스 내보내기
• AutoCoder 배포와 호스팅
• BetterToken API Reference