바이브코딩 101

바이브코딩 기초지식 정리

서비스 개발에 자주 나오는 용어를 캠핑 용품 검색 흐름으로 설명합니다. 데이터베이스와 테이블에 상품을 저장하고 SQL·색인·임베딩으로 검색하는 과정까지 연결해 정리했어요.

데이터베이스

서비스 데이터를 저장하고 조회·수정·삭제하는 프로그램

  • 캠핑 검색 데이터 상품 ID, 상품명, 설명을 저장합니다

  • 데이터 작업 상품 추가, 설명 수정, 판매가 끝난 상품 삭제를 처리해요

  • 테이블과 SQL 테이블은 저장 형태를 정하고 SQL은 저장·조회 작업을 전달합니다

테이블

행과 열로 같은 형식의 데이터를 정리하는 단위

  • camping_products 테이블의 행 하나가 상품 하나를 나타냅니다

  • id, name, description이 모든 상품에 공통으로 저장할 항목을 정해요

  • 데이터 규칙 id로 상품을 구분하고 열마다 데이터 형식과 필수 여부를 지정합니다

SQL

데이터베이스에 필요한 작업을 요청하는 언어

  • 조회 예시 SELECT name, description FROM camping_products LIMIT 5는 상품 다섯 개의 이름과 설명을 조회합니다

  • 조건과 순서 WHERE는 조회 조건, ORDER BY는 표시 순서, LIMIT은 반환할 상품 수를 정해요

  • 실행 전 확인 클로드나 코덱스가 SQL을 작성해도 수정·삭제 대상과 조건을 먼저 확인합니다

색인

검색할 내용과 데이터 위치를 연결하는 자료

  • 검색 범위 색인에서 검색어와 관련된 후보를 먼저 찾아 모든 상품을 차례로 검사하는 작업을 줄여요

  • 색인 종류 단어 검색은 search_text의 GIN 색인을, 의미 검색은 embedding의 HNSW 색인을 사용합니다

  • 데이터 변경 상품을 추가하거나 수정하면 색인도 갱신되며 저장 공간과 적재 시간을 사용해요

임베딩

텍스트의 의미를 표현한 같은 길이의 숫자 배열

  • 텍스트 변환 임베딩 모델이 문장과 상품 설명을 벡터로 변환합니다

  • 의미 비교 겨울 야영용 따뜻한 이불동계용 침낭처럼 용도가 가까운 표현은 벡터 거리도 가까워져요

  • 비교 조건 검색어와 상품 설명에 같은 모델·차원 수·변환 설정을 적용하고, 설명을 수정하면 임베딩도 다시 생성합니다

로컬 프로젝트

현재 컴퓨터에서 개발하고 실행하는 작업 공간

  • 프로젝트 파일 소스 코드, 설정 파일, 이미지를 현재 컴퓨터에서 관리합니다

  • 데이터베이스 선택 정적 소개 페이지는 데이터베이스 없이 실행할 수 있고, 데이터 저장이 필요하면 파일·SQLite·PostgreSQL 등을 선택해요

  • 배포 환경 배포한 웹 앱은 개발자 컴퓨터에 직접 연결할 수 없어 필요한 파일과 서비스를 별도로 준비합니다

클라우드 프로젝트

인터넷에 연결된 원격 환경에서 실행하는 프로젝트

  • 실행 위치 코드와 설정을 원격 실행 환경에 배포해 사용자가 인터넷으로 접근할 수 있게 합니다

  • 프로젝트 형태 웹 앱, API, 자동화 작업으로 운영하며 데이터 저장 기능이 없는 프로젝트도 있어요

  • 데이터 저장 필요하면 원격 데이터베이스·파일 저장소·외부 API를 선택하고 실행 시간과 접근 범위는 호스팅에서 관리합니다

백업

특정 시점의 데이터를 보관하는 복원용 사본

  • 백업 대상 소스 코드, 설정 파일, 업로드 파일, 데이터베이스 데이터 등 복원에 필요한 자료를 보관합니다

  • 생성 시점 많은 데이터를 수정하거나 삭제하기 전에 백업해 작업 전 상태로 복원할 수 있게 해요

  • 보관과 복원 원본과 다른 저장 위치에 백업하고 실제 복원 절차로 필요한 자료가 정상적으로 복구되는지 확인합니다