바이브 코더를 위한 시스템 아키텍처: 시니어 엔지니어 가이드

10년 경력의 시니어 소프트웨어 엔지니어가 r/ClaudeAI에 올린 글에서, 만약 지금 처음부터 다시 시작한다면 Claude Code를 사용해 앱을 빌드하는 방법을 어떻게 접근할지 공유했습니다. 그의 조언: 코드로 시작하지 마세요. 가장 높은 수준인 시스템 아키텍처부터 시작하세요.

네 가지 구성 요소

이 글은 모든 애플리케이션을 네 가지 계층으로 나눕니다:

• 프론트엔드 — 사용자가 보는 것 (웹사이트, 모바일 앱 등)
• 백엔드 — 앱의 주요 로직과 규칙
• 데이터베이스 — 데이터가 저장되는 곳
• 연결부(플럼빙) — 모든 것이 연결되고 유지되는 방법

저자는 연결부에 초점을 맞춥니다. Claude Code와 같은 AI 에이전트는 프론트엔드, 백엔드, 데이터베이스를 쉽게 구성할 수 있지만, 명시적으로 요청하지 않으면 연결부를 생략하기 때문입니다.

연결부: 반드시 답해야 할 네 가지 질문

1. 모든 것이 서로 어떻게 통신하나요?

프론트엔드, 백엔드, 데이터베이스는 서로 메시지를 주고받는 별개의 조각입니다. 대부분의 애플리케이션에서 이는 API를 통해 이루어집니다. API는 프론트엔드가 백엔드에 요청할 때 사용하는 일종의 문입니다 (예: "이 사용자의 주문을 알려줘"). 다른 방법도 있지만, API가 가장 먼저 집중해야 할 것입니다.

2. 어디에 있으며, 어떻게 온라인에 올리나요?

앱을 노트북에서 인터넷으로 가져오려면 다음이 필요합니다:

• 호스팅 — 앱이 실제로 실행되어 전 세계가 접근할 수 있는 곳 (서버).
• 도메인 & DNS — 사용자 정의 주소 (yourapp.com)와 이를 서버에 연결하는 방법.
• 배포 — 코드를 가져와 사용자가 안전하게 볼 수 있도록 게시하는 파이프라인.
• 환경 변수 및 비밀 키 — 비밀번호와 API 키를 코드에 두지 않고 보관하는 곳. 사람들이 자주 실수하는 부분입니다.

3. 누가 접근할 수 있으며, 안전한가요?

저자가 절대 건너뛰지 말라고 당부하는 부분입니다. 바이브 코딩은 실수로 안전하지 않은 것을 출시하기 쉽게 만듭니다. 이 글은 기존의 처리 방법 (처음부터 만드는 것이 아닌)을 암시합니다 — 아마도 인증 프레임워크, OAuth, JWT, 또는 관리형 ID 제공자 — 하지만 원문은 이러한 해결책이 존재한다고만 언급합니다.

핵심 요점

이 글은 이러한 연결부 개념을 이름으로 아는 것이 주말 장난감과 실제 사람들이 데이터와 돈을 믿고 맡길 수 있는 것을 구분짓는다고 강조합니다. 앱에 대해 위 네 가지 질문에 답할 수 있다면, 현재 출시하는 대부분의 바이브 코더보다 앞서 있는 것입니다.