부록: 바로 찾아 쓰는 기본 용어 사전

바이브 코딩을 하다 보면 도구가 갑자기 낯선 말을 던질 때가 있습니다. "데이터베이스를 연결하세요", "환경변수를 설정하세요", "API 키가 필요합니다", "배포가 실패했습니다" 같은 문장을 만나면 앱 만들기의 흐름이 뚝 끊기는 느낌이 듭니다.

이 부록은 그럴 때마다 돌아와 확인하는 초보자용 개발 용어 지도입니다. 외우려고 읽을 필요는 없습니다. 앱을 만들다가 막히는 단어가 보이면 찾아보면 됩니다. 중요한 것은 개발자가 쓰는 모든 말을 완벽히 아는 것이 아니라, AI 앱 빌더에게 내가 원하는 것을 설명할 만큼 이해하는 것입니다.

앱과 웹앱을 이해하는 기본 용어

앱

한 줄 정의: 사용자가 어떤 일을 할 수 있도록 만든 프로그램입니다.

쉬운 비유: 가위, 계산기, 다이어리처럼 특정 목적을 가진 도구입니다.

초보자 포인트: 앱이라고 해서 꼭 스마트폰에 설치하는 것만 뜻하지는 않습니다. 할 일 관리, 독서 기록, 예약 문의, 후기 수집처럼 사용자가 입력하고 결과를 확인할 수 있으면 넓은 의미의 앱이라고 볼 수 있습니다.

웹앱

한 줄 정의: 설치하지 않고 웹브라우저에서 접속해 사용하는 앱입니다.

쉬운 비유: 가게에 따로 물건을 사러 가지 않고, 주소만 입력해 들어가는 온라인 매장입니다.

초보자 포인트: Lovable, Replit Agent, Bolt.new 같은 도구로 처음 만드는 앱은 대부분 웹앱에 가깝습니다. 링크를 공유하면 다른 사람이 브라우저로 열 수 있다는 점이 장점입니다.

프론트엔드

한 줄 정의: 사용자가 직접 보고 클릭하는 화면 부분입니다.

쉬운 비유: 식당으로 치면 손님이 보는 메뉴판, 인테리어, 테이블 배치입니다.

초보자 포인트: 버튼, 입력창, 카드, 색상, 글자 크기, 목록 화면처럼 눈에 보이는 것은 대부분 프론트엔드에 해당합니다. "화면을 더 보기 좋게 바꿔줘", "버튼을 크게 만들어줘" 같은 요청은 프론트엔드 수정 요청입니다.

백엔드

한 줄 정의: 화면 뒤에서 데이터를 처리하고 저장하며 필요한 일을 수행하는 부분입니다.

쉬운 비유: 식당에서 손님에게 보이지 않는 주방입니다.

초보자 포인트: 예약 정보를 저장하거나, 로그인한 사용자를 확인하거나, 검색 결과를 불러오는 일은 백엔드와 관련됩니다. 초보자는 처음부터 백엔드를 깊게 알 필요는 없지만, "화면 뒤에서 처리되는 일"이 있다는 감각은 필요합니다.

데이터베이스

한 줄 정의: 앱에서 사용하는 정보를 체계적으로 저장하는 공간입니다.

쉬운 비유: 장부 또는 엑셀 파일입니다.

초보자 포인트: 독서 기록 앱의 책 목록, 예약 문의 앱의 고객 문의, 운동 기록 앱의 날짜별 기록은 모두 데이터베이스에 저장할 수 있습니다. 처음 MVP에서는 로컬 저장으로 시작할 수 있지만, 여러 사람이 함께 쓰거나 오래 운영하려면 데이터베이스가 필요해지는 경우가 많습니다.

API

한 줄 정의: 내 앱이 다른 서비스나 기능과 대화할 수 있게 해주는 연결 방식입니다.

쉬운 비유: 다른 가게와 연결해주는 배달 기사입니다.

초보자 포인트: 날씨 정보를 가져오기, AI 답변 생성하기, 지도 정보 불러오기, 결제 서비스 연결하기는 API를 통해 이루어지는 경우가 많습니다. API를 쓰면 강력해지지만 API 키, 비용, 보안 같은 문제가 함께 따라옵니다.

인증

한 줄 정의: 사용자가 누구인지 확인하는 과정입니다.

쉬운 비유: 건물 입구에서 출입증을 확인하는 일입니다.

초보자 포인트: "이 사람이 우리 앱에 들어와도 되는 사람인가?"를 확인하는 절차입니다. 이메일 로그인, 소셜 로그인, 비밀번호 확인, 인증번호 입력 등이 인증에 해당합니다.

로그인

한 줄 정의: 사용자가 자신의 계정으로 앱에 들어가는 기능입니다.

쉬운 비유: 헬스장 회원카드를 찍고 입장하는 일입니다.

초보자 포인트: 로그인은 단순해 보이지만 초보자에게는 난이도가 꽤 있습니다. 사용자 정보, 비밀번호 보안, 권한 관리, 데이터 분리까지 연결되기 때문입니다. 첫 앱에서는 로그인을 빼고 시작해도 괜찮습니다.

만들고 고치고 공개할 때 자주 만나는 용어

배포

한 줄 정의: 만든 앱을 다른 사람이 접속할 수 있게 공개하는 일입니다.

쉬운 비유: 가게 문을 열고 손님이 들어올 수 있게 하는 것입니다.

초보자 포인트: 내 컴퓨터나 작업 화면에서만 보이는 앱은 아직 배포된 것이 아닙니다. 링크로 접속할 수 있어야 공유가 가능합니다. 배포 전에는 버튼 작동, 모바일 화면, 개인정보 노출 여부를 꼭 확인해야 합니다.

버그

한 줄 정의: 앱이 의도한 대로 작동하지 않는 문제입니다.

쉬운 비유: 주문한 메뉴와 다른 음식이 나오는 상황입니다.

초보자 포인트: 버튼을 눌렀는데 아무 일도 일어나지 않거나, 입력한 내용이 저장되지 않거나, 화면이 깨지는 것이 버그입니다. 버그가 생겼다고 실패한 것이 아닙니다. 앱 만들기에서는 자연스럽게 만나는 수정 대상입니다.

디버깅

한 줄 정의: 버그의 원인을 찾아 고치는 과정입니다.

쉬운 비유: 주문이 어디서 꼬였는지 확인하는 일입니다.

초보자 포인트: AI에게 "안 돼요"라고만 말하면 원인을 찾기 어렵습니다. 어떤 화면에서, 어떤 버튼을 눌렀고, 기대한 결과와 실제 결과가 무엇인지 알려주면 디버깅이 쉬워집니다.

예약 문의 앱에서 제출 버튼을 눌러도 목록에 문의가 추가되지 않습니다.
현재 상황은 다음과 같습니다.
1. 이름, 연락처, 희망 날짜를 입력했습니다.
2. 제출 버튼을 눌렀습니다.
3. 기대한 결과는 아래 목록에 새 문의가 보이는 것입니다.
4. 실제 결과는 아무 변화가 없는 것입니다.
원인을 추정하지 말고 가능한 원인을 3가지로 나눈 뒤, 가장 가능성 높은 것부터 수정해 주세요.

CRUD

한 줄 정의: 만들기, 읽기, 수정하기, 삭제하기를 뜻하는 기본 데이터 기능입니다.

쉬운 비유: 엑셀에서 새 행을 추가하고, 목록을 보고, 내용을 고치고, 필요 없는 행을 지우는 일입니다.

초보자 포인트: CRUD는 Create, Read, Update, Delete의 앞글자입니다. 독서 기록 앱에서 책을 추가하고, 목록을 보고, 별점을 수정하고, 기록을 삭제하는 기능이 바로 CRUD입니다. 초보자의 첫 앱은 대부분 CRUD만 잘 되어도 쓸모가 생깁니다.

MVP

한 줄 정의: 핵심 기능만 담은 가장 작은 첫 버전입니다.

쉬운 비유: 정식 매장을 열기 전 잠깐 운영해보는 팝업스토어입니다.

초보자 포인트: MVP는 허술한 앱이라는 뜻이 아닙니다. 가장 중요한 기능 하나가 실제로 작동하는지 확인하는 앱입니다. 처음부터 로그인, 결제, 알림, 관리자 페이지를 모두 넣으려 하지 말고 입력, 저장, 목록 보기부터 확인하세요.

프로토타입

한 줄 정의: 아이디어를 빠르게 확인하기 위해 만든 시험용 결과물입니다.

쉬운 비유: 집을 짓기 전에 만들어보는 종이 모형입니다.

초보자 포인트: 프로토타입은 완성품이 아닙니다. "이런 화면이면 사람들이 이해할까?", "이 기능 흐름이 자연스러울까?"를 확인하기 위한 단계입니다. Bolt.new나 v0는 프로토타입을 빠르게 잡을 때 특히 유용합니다.

반응형

한 줄 정의: 화면 크기에 맞게 앱의 모양이 자동으로 조정되는 방식입니다.

쉬운 비유: 작은 방에서는 접이식 책상이 되고, 넓은 방에서는 큰 책상이 되는 가구입니다.

초보자 포인트: PC에서는 괜찮은데 스마트폰에서 글자가 잘리거나 버튼이 너무 작으면 반응형 처리가 부족한 것입니다. 한국 독자는 모바일로 앱을 여는 경우가 많으므로, 배포 전에는 반드시 휴대폰 화면에서 확인해야 합니다.

이 앱을 모바일 우선 반응형 디자인으로 수정해 주세요.
스마트폰 화면에서 입력창과 버튼이 너무 작지 않게 하고,
목록 카드는 한 줄에 하나씩 보이게 해 주세요.
PC 화면에서는 여백을 넓게 두고 중앙 정렬된 레이아웃으로 보여 주세요.

연결, 보안, 개발 흐름에서 만나는 용어

환경변수

한 줄 정의: 앱이 실행될 때 따로 불러와 사용하는 설정값이나 비밀값입니다.

쉬운 비유: 금고 비밀번호를 종이에 붙여두지 않고 금고 안쪽 설정함에 따로 보관하는 것입니다.

초보자 포인트: API 키, 데이터베이스 주소, 비밀 토큰처럼 공개되면 안 되는 값은 코드에 직접 적지 않고 환경변수로 관리해야 합니다. 도구에 따라 Secrets, Environment Variables, Config 같은 이름으로 표시될 수 있습니다.

API 키

한 줄 정의: 특정 외부 서비스를 사용할 수 있게 해주는 비밀 열쇠입니다.

쉬운 비유: 제휴 가게 창고에 들어갈 수 있는 출입 카드입니다.

초보자 포인트: API 키가 노출되면 다른 사람이 내 이름으로 서비스를 사용해 비용이 발생할 수도 있습니다. 화면, 공개 코드, GitHub 저장소, 공유 문서에 API 키를 그대로 붙여넣지 마세요.

이 앱에서 API 키가 코드나 화면에 직접 노출되지 않도록 점검해 주세요.
API 키가 필요한 부분은 환경변수로 분리하고,
초보자가 설정해야 할 환경변수 이름과 용도를 표로 정리해 주세요.

GitHub

한 줄 정의: 코드를 저장하고 변경 이력을 관리하며 다른 사람과 협업할 수 있는 온라인 공간입니다.

쉬운 비유: 앱 제작 과정을 보관하는 클라우드 작업 노트이자 버전별 보관함입니다.

초보자 포인트: 개발자형 도구를 쓰거나 개발자와 협업할 때 GitHub를 자주 만나게 됩니다. 초보자는 처음부터 깊게 배울 필요는 없지만, 공개 저장소에 비밀 정보가 올라가면 위험하다는 점은 꼭 기억해야 합니다.

컴포넌트

한 줄 정의: 화면을 구성하는 재사용 가능한 작은 조각입니다.

쉬운 비유: 레고 블록입니다.

초보자 포인트: 버튼, 카드, 입력창, 상단 메뉴, 목록 아이템이 컴포넌트가 될 수 있습니다. "예약 카드 컴포넌트를 더 보기 좋게 바꿔줘"처럼 말하면 AI가 화면을 더 구조적으로 이해할 수 있습니다.

UI

한 줄 정의: 사용자가 앱을 보고 조작하는 화면 요소입니다.

쉬운 비유: 리모컨의 버튼 배치와 TV 메뉴 화면입니다.

초보자 포인트: UI는 User Interface의 줄임말입니다. 버튼 모양, 입력창 위치, 색상, 아이콘, 메뉴 구조가 UI에 해당합니다. 보기 좋은 UI는 사용자가 무엇을 해야 할지 빨리 알게 해줍니다.

UX

한 줄 정의: 사용자가 앱을 쓰면서 느끼는 전체 경험입니다.

쉬운 비유: 식당에서 예약하고, 들어가고, 주문하고, 식사하고, 계산할 때까지의 전체 느낌입니다.

초보자 포인트: UX는 User Experience의 줄임말입니다. UI가 예뻐도 사용하기 어렵다면 UX가 좋지 않은 앱입니다. 예를 들어 삭제 버튼이 너무 가까워 실수로 누르게 된다면 UI는 멀쩡해 보여도 UX에는 문제가 있습니다.

호스팅

한 줄 정의: 앱이나 웹사이트가 인터넷에서 열릴 수 있도록 파일과 실행 환경을 올려두는 서비스입니다.

쉬운 비유: 가게를 열기 위해 빌리는 실제 매장 공간입니다.

초보자 포인트: 앱을 만들었다고 자동으로 인터넷에 공개되는 것은 아닙니다. 호스팅이 되어야 다른 사람이 링크로 들어올 수 있습니다. 앱 빌더형 도구는 배포와 호스팅을 비교적 쉽게 연결해주는 경우가 많습니다.

도메인

한 줄 정의: 웹앱에 접속하기 위해 사용하는 사람이 읽기 쉬운 주소입니다.

쉬운 비유: 가게의 간판 이름과 주소입니다.

초보자 포인트: 예를 들어 mybookapp.com 같은 것이 도메인입니다. 처음에는 도구가 제공하는 기본 주소로 충분합니다. 나중에 외부 사용자에게 안정적으로 공유하고 싶을 때 내 도메인을 연결하면 됩니다.

저장, 권한, 운영 화면에서 만나는 용어

로컬 저장

한 줄 정의: 사용자의 기기나 브라우저 안에 데이터를 저장하는 방식입니다.

쉬운 비유: 내 책상 서랍에 메모지를 넣어두는 것입니다.

초보자 포인트: 로컬 저장은 간단한 개인용 MVP에 좋습니다. 독서 기록, 운동 기록, 프롬프트 보관함처럼 혼자 쓰는 앱이라면 시작점으로 충분할 수 있습니다. 다만 다른 기기에서 이어서 쓰거나 여러 사람이 함께 쓰기에는 한계가 있습니다.

클라우드 저장

한 줄 정의: 인터넷 서버에 데이터를 저장해 여러 기기나 사용자와 연결할 수 있는 방식입니다.

쉬운 비유: 집 서랍이 아니라 온라인 창고에 자료를 보관하는 것입니다.

초보자 포인트: 가족 일정 공유 앱, 강의 후기 수집 앱, 예약 문의 앱처럼 여러 사람이 데이터를 입력하거나 관리자가 확인해야 하는 앱은 클라우드 저장이 필요할 수 있습니다. 대신 보안, 비용, 권한 관리도 함께 고려해야 합니다.

권한 관리

한 줄 정의: 사용자마다 볼 수 있는 정보와 할 수 있는 행동을 다르게 정하는 일입니다.

쉬운 비유: 회사에서 직원증 등급에 따라 들어갈 수 있는 방이 다른 것과 같습니다.

초보자 포인트: 일반 사용자는 문의만 남기고, 관리자는 문의 목록을 볼 수 있게 만드는 것이 권한 관리입니다. 초보자에게는 생각보다 어려운 영역이므로, 첫 MVP에서는 관리자 링크를 숨기는 수준으로 시작하고 실제 운영 전에는 신중히 점검해야 합니다.

관리자 페이지

한 줄 정의: 앱 운영자가 데이터를 확인하고 관리하는 별도 화면입니다.

쉬운 비유: 손님이 보는 매장 홀이 아니라 사장님이 보는 사무실 화면입니다.

초보자 포인트: 예약 문의 앱에서 고객이 보는 신청 화면과 사장님이 보는 문의 목록 화면은 다릅니다. 관리자 페이지에는 개인정보나 운영 데이터가 보일 수 있으므로 아무나 접속할 수 없게 해야 합니다.

대시보드

한 줄 정의: 중요한 상태와 숫자를 한눈에 보여주는 요약 화면입니다.

쉬운 비유: 자동차 운전석의 계기판입니다.

초보자 포인트: 이번 주 예약 수, 누적 후기 수, 완료한 할 일 비율, 운동 횟수 같은 정보를 한 화면에서 보여주면 대시보드입니다. 처음부터 복잡한 그래프를 넣기보다 핵심 숫자 3개 정도로 시작하는 것이 좋습니다.

랜딩페이지

한 줄 정의: 사용자가 처음 들어와 앱이나 서비스의 목적을 이해하는 소개 페이지입니다.

쉬운 비유: 가게 앞 입간판과 첫 안내문입니다.

초보자 포인트: 랜딩페이지는 기능이 많은 앱 화면과 다릅니다. "무엇을 제공하는지", "누구에게 필요한지", "어떻게 시작하는지"를 짧고 분명하게 알려주는 것이 핵심입니다. 강의 모집, 예약 문의, 뉴스레터 신청, 서비스 소개에 자주 사용됩니다.

이 앱의 랜딩페이지를 만들어 주세요.
대상 사용자는 1인 공방을 운영하는 소상공인입니다.
첫 화면에는 앱이 해결하는 문제, 핵심 기능 3가지, 예약 문의 버튼을 보여 주세요.
문장은 과장하지 말고 신뢰감 있는 한국어로 작성해 주세요.
모바일에서도 읽기 쉽게 섹션을 짧게 나눠 주세요.

초보자가 함께 기억하면 좋은 연결 관계

용어는 따로 외우는 것보다 서로 어떻게 연결되는지 이해할 때 훨씬 쉬워집니다. 예를 들어 예약 문의 앱을 만든다고 생각해보겠습니다. 손님이 보는 입력 화면은 프론트엔드입니다. 문의 내용을 저장하고 목록으로 불러오는 뒤쪽 처리는 백엔드입니다. 저장된 문의 목록은 데이터베이스에 들어갑니다. 운영자가 보는 문의 목록 화면은 관리자 페이지입니다. 만든 앱을 링크로 공유하려면 배포와 호스팅이 필요합니다. 외부 문자 발송 서비스나 AI 요약 기능을 붙인다면 API와 API 키가 등장합니다. 이때 API 키는 환경변수로 숨겨야 합니다.

이렇게 보면 개발 용어는 시험 단어가 아니라 앱의 어느 부분을 가리키는 이름입니다. 이름을 알면 AI에게 더 정확히 말할 수 있습니다.

내가 만들고 있는 앱을 기준으로 다음 용어가 각각 어디에 해당하는지 설명해 주세요.
앱 이름: [앱 이름]
앱 목적: [앱 목적]
주요 기능: [기능 3개]

설명해 줄 용어:
프론트엔드, 백엔드, 데이터베이스, 배포, 관리자 페이지, 권한 관리, API, 환경변수

초보자가 이해할 수 있게 생활 비유와 함께 설명해 주세요.

이 용어 사전을 쓰는 방법

앱을 만들다가 낯선 단어를 만나면 먼저 이 부록에서 뜻을 확인하세요. 그다음 AI에게 이렇게 물어보면 됩니다.

방금 설명에 나온 [낯선 용어]가 무엇인지 초보자도 이해할 수 있게 설명해 주세요.
제가 만들고 있는 앱은 [앱 이름]이고,
현재 하려는 작업은 [작업 내용]입니다.
이 용어가 제 앱의 어느 부분과 관련되는지,
지금 꼭 알아야 하는 것과 나중에 알아도 되는 것을 나눠서 알려 주세요.

바이브 코딩에서 중요한 것은 모든 용어를 개발자처럼 깊게 아는 것이 아닙니다. 지금 내 앱에서 무엇이 화면이고, 무엇이 저장이고, 무엇이 공개이고, 무엇이 보안인지 구분하는 힘입니다. 이 정도만 알아도 AI에게 훨씬 더 좋은 요청을 할 수 있습니다.

한 장 요약

앱은 특정 목적을 가진 프로그램이고, 웹앱은 브라우저에서 접속해 쓰는 앱입니다. 프론트엔드는 사용자가 보는 화면, 백엔드는 보이지 않는 처리 공간, 데이터베이스는 정보를 저장하는 장부입니다.

배포는 앱을 다른 사람이 접속할 수 있게 공개하는 일입니다. 버그는 의도와 다르게 작동하는 문제이고, 디버깅은 그 원인을 찾아 고치는 과정입니다. CRUD는 대부분의 초보 앱에서 가장 먼저 익히는 기본 기능입니다.

환경변수와 API 키는 보안과 연결됩니다. 특히 API 키는 비밀 열쇠이므로 코드나 화면에 노출하지 않아야 합니다. GitHub, 호스팅, 도메인은 앱을 저장하고 공개하고 주소를 붙이는 과정에서 자주 등장합니다.

로컬 저장은 개인용 MVP에 적합하고, 클라우드 저장은 여러 사람과 함께 쓰는 앱에 적합합니다. 권한 관리, 관리자 페이지, 대시보드는 실제 운영 단계에서 중요해집니다.

용어를 외우려고 애쓰지 않아도 됩니다. 막힐 때마다 찾아보고, 내 앱의 상황에 맞게 AI에게 다시 설명해 달라고 요청하면 됩니다. 초보자에게 필요한 것은 완벽한 암기가 아니라, 원하는 앱을 더 정확히 설명하기 위한 최소한의 지도입니다.