CH05 · 실전 서비스로 키우기 (심화·보너스)

5-1. DB & 파일 저장 (Supabase)

설명 영상이 챕터를 영상으로 먼저 훑어보세요 · 7분 41초

4장에서 "DB·로그인도 에이전트에게 시키면 된다"는 걸 살짝 맛봤다면, 이번 챕터는 그 한 줄을 본격적으로 펼칩니다. 여러분이 만든 웹앱을 나 혼자 쓰는 장난감에서 여러 사람이 각자의 데이터를 쌓는 진짜 서비스로 키우는 첫걸음이에요. 오늘도 핵심은 똑같습니다. SQL 문법을 외우는 게 아니라, 에이전트에게 "저장해줘"라고 시키는 것. 다만 그렇게 시키려면 여러분이 "어떤 데이터를 어디에 담을지"는 알고 있어야 해요. 그 그림을 그려 드리는 게 이 페이지입니다.


1. 왜 LocalStorage를 넘어 "진짜 DB"가 필요할까

2장 습관 트래커, 그리고 그 이후 만든 앱들은 입력값을 LocalStorage(브라우저 한 대 안에만 데이터를 저장해 두는 작은 보관함)에 담았습니다. 빠르고 공짜라 처음엔 최고였죠. 그런데 LocalStorage에는 넘기 어려운 벽이 셋 있습니다.

LocalStorage의 한계

"내 브라우저 한 대"에 갇힘

  • 다른 기기에선 텅 빔: 집 노트북에서 쌓은 기록이 회사 PC·휴대폰엔 안 보입니다.
  • 여러 사용자 불가: 친구가 가입해 "자기 데이터"를 쓰게 할 방법이 없습니다.
  • 대량·검색에 약함: 수천·수만 줄이 쌓이거나 "지난주 기록만"처럼 골라 꺼내려면 버겁습니다. 캐시를 지우면 통째로 날아가기도 하고요.
진짜 DB로 가면

"한 곳에 모인 공용 창고"

  • 어느 기기에서든 같은 데이터: 인터넷 너머 한 창고에 저장하니, 로그인만 하면 폰에서도 똑같이 보입니다.
  • 사용자마다 자기 칸: 가입한 사람마다 자기 데이터를 갖습니다(서비스의 출발점).
  • 대량·검색·정렬에 강함: 수만 줄도 거뜬하고, 조건으로 골라 꺼내기가 쉽습니다.

정리하면 이렇습니다. 혼자, 한 기기에서, 가볍게 쓸 거면 LocalStorage로 충분합니다. 하지만 "여러 사람이, 여러 기기에서, 많은 데이터를 쌓는" 순간이 오면 — 그때가 진짜 DB로 이사할 때입니다. 4장에서 배운 대로, 먼저 LocalStorage로 빠르게 만들어 반응을 보고, 정말 쓰이기 시작하면 그때 DB로 옮기는 순서가 가장 현명합니다.

2. ★ 정형 데이터 vs 비정형 데이터 — 오늘의 핵심

"DB에 저장한다"고 하기 전에, 딱 하나 알고 가면 모든 게 쉬워지는 구분이 있습니다. 바로 정형(Structured) 데이터와 비정형(Unstructured) 데이터입니다. 이걸 알면 "내 데이터를 어디에 담아야 하지?"가 또렷해집니다.

정형 데이터 (Structured)

표(테이블)에 또박또박 들어가는 것

  • 엑셀 표처럼 행(가로 한 줄)·열(세로 칸)로 정리되는 데이터
  • 예: 회원 명단, 주문 내역, 습관 기록(날짜·항목·완료여부)
  • 담는 곳 → 데이터베이스(DB)의 "테이블"
비정형 데이터 (Unstructured)

표에 안 들어가는 "덩어리"

  • 이미지·동영상·PDF·음성처럼 칸으로 쪼갤 수 없는 파일 자체
  • 예: 프로필 사진, 업로드한 영수증 이미지, 첨부 문서
  • 담는 곳 → "Storage(스토리지)"라는 파일 창고

비유하면, 정형 데이터는 "장부"에 줄 맞춰 적는 글자고, 비정형 데이터는 "캐비닛"에 통째로 넣어 두는 사진·서류 봉투입니다. 장부(DB 테이블)에는 "사진의 위치(주소)"만 적어 두고, 사진 실물은 캐비닛(Storage)에 보관하는 식이죠. 둘은 역할이 다르니 따로 담습니다. 다행히 오늘 쓸 Supabase는 이 두 창고를 한 서비스 안에서 같이 줍니다.

정형 데이터를 담는 DB에도 크게 두 갈래가 있습니다. 이름이 어렵지만 한 줄이면 됩니다.

SQL DB (테이블형 · 관계형)

엑셀 시트처럼 열이 미리 정해진 표에 줄을 쌓는 방식. 여러 표가 서로 연결돼(예: "주문" 표가 "회원" 표를 가리킴) 빈틈없이 정돈됩니다. 대표주자가 Postgres(포스트그레스). 회원·주문·기록처럼 또박또박한 데이터에 강하고, 오늘 Supabase가 주는 DB가 바로 이것입니다.

NoSQL DB (문서형)

정해진 표 대신 메모지(문서) 한 장씩을 쌓는 방식. 줄마다 칸이 조금씩 달라도 되어 유연합니다. 형식이 들쭉날쭉한 데이터에 편합니다. 다만 비개발자 입문에는 표가 눈에 보이는 SQL(Postgres)이 더 직관적이라, 이 강의는 Supabase의 SQL DB로 갑니다.

💡 둘 중 뭐가 더 좋다가 아니라 "데이터 성격에 맞는 창고가 다르다"가 핵심입니다. 그리고 안심하세요 — 여러분은 이 선택조차 에이전트에게 물어볼 수 있습니다. "이런 데이터는 SQL이 나아 NoSQL이 나아?"라고요. 우리는 "무엇을 담을지"만 알면 됩니다.

3. Supabase — DB·파일창고·로그인을 한 번에 주는 친구

4장에서 이름만 스쳤던 Supabase(수파베이스)를 이제 제대로 만납니다. 한 문장으로요.

🗄️
Supabase = 정형 데이터용 DB(Postgres) + 비정형 파일 창고(Storage) + 로그인(Auth)을, 가입 한 번에 무료로 묶어 주는 서비스
방금 배운 "정형은 DB, 비정형은 Storage" 그리고 "누구인지 확인하는 로그인"까지 — 따로 가입할 필요 없이 한 곳에서 다 받습니다. 그래서 비개발자에게 가장 친절합니다.

무료 플랜으로도 연습용·개인 프로젝트는 충분히 굴릴 수 있습니다. 2026년 10월 기준 무료 플랜은 DB 500MB, 파일 저장 1GB, 월 활성 사용자 5만 명, 활성 프로젝트 2개까지이고, 1주일 동안 안 쓰면 프로젝트가 일시 정지됩니다(대시보드에서 다시 켜면 돼요). 한도는 바뀔 수 있으니 가입할 때 가격 페이지에서 그때의 기준을 확인하세요. 우리가 기억할 건 딱 하나, "DB·Storage·Auth를 한 군데서 준다"는 사실입니다. 오늘은 이 중 DB(정형)와 Storage(비정형 파일)에 집중하고, 본격적인 로그인은 다음 클립(5-2 소셜 로그인)에서 다룹니다.

4. 실전 흐름 — 가입부터 파일 업로드까지 4단계

전체 그림은 네 박자입니다. 코드는 여전히 에이전트가 짭니다. 여러분은 흐름만 쥐고 있으면 돼요.

①

가입 & 새 프로젝트: 브라우저로 supabase.com 접속 → 가입 → "New Project"로 프로젝트를 하나 만듭니다. 프로젝트가 생기면 그 안에 우리만의 DB와 Storage가 함께 준비됩니다.

②

연동은 에이전트에게 (키는 환경변수로): 프로젝트의 접속 주소(Project URL)와 공개 키(Publishable key, sb_publishable_로 시작)를 에이전트에게 건네 연결을 맡깁니다. 두 값은 프로젝트 화면 위쪽의 Connect 버튼이나 Settings → API Keys에서 복사합니다. 예전 화면이나 다른 자료에서는 같은 역할의 키를 anon key라고 부르는데, 이 이름은 2026년 말까지 단계적으로 없어질 예정이라 새로 만드는 앱은 Publishable key를 쓰면 됩니다. 반대로 Secret key(sb_secret_, 예전 이름 service_role)는 모든 잠금을 무시하는 마스터키라 화면 코드에 절대 넣으면 안 됩니다. 비밀스러운 값은 화면 코드에 박지 말고 환경변수(키를 코드 대신 비밀 보관함에 넣고 이름표로만 부르는 방식)로 처리하라고 꼭 한마디 덧붙입니다.

③

테이블 설계도 에이전트에게: "어떤 열(칸)이 필요한지"를 한국어로 설명하면, 에이전트가 표(테이블)를 설계하고 만들어 줍니다. 우리는 "회원, 날짜, 습관 이름, 완료여부" 같은 담을 항목만 떠올리면 됩니다.

④

파일은 Storage 버킷으로: 이미지·문서 같은 비정형 파일은 DB 테이블이 아니라 Storage의 "버킷"(파일을 담는 폴더 같은 공간)에 올립니다. 테이블에는 그 파일의 "주소"만 적어 둡니다. 버킷은 처음 만들면 비공개(Private)가 기본이고, 업로드를 허용하는 권한 정책을 따로 만들어야 파일이 올라갑니다. 누구나 주소로 볼 수 있게 하려면 공개(Public) 버킷으로 만들고, 비공개로 두려면 잠깐만 열리는 서명된 주소(Signed URL)로 보여 줍니다.

5. 복붙 프롬프트 ① — 습관 데이터를 Supabase 테이블에 저장

이제 손을 움직입니다. 아래 프롬프트는 프로젝트 폴더에서 실행 중인 코딩 에이전트(터미널의 Claude Code 등)에 붙여넣습니다. 4장에서 "LocalStorage→Supabase로 바꿔줘"를 맛봤다면, 여기서는 한 발 더 나아가 테이블의 "열(칸) 설계"까지 직접 지시합니다. 무엇을 담을지 우리가 정해 주는 거예요.

"이 습관 트래커를 Supabase에 연결해줘. 진행 순서: ① 먼저 Supabase 클라이언트를 설치·초기화하는 방법과, 프로젝트 URL·Publishable key(sb_publishable_로 시작하는 공개 키)를 어디서 복사하는지 단계별로 알려줘(이 값들은 코드에 박지 말고 환경변수로 처리하고, Secret key는 절대 쓰지 마). ② 다음 열을 가진 habits 테이블을 설계하고 만드는 SQL을 제안해줘: 기록 고유번호, 사용자 id, 습관 이름(글자), 날짜, 완료여부(참/거짓), 생성시각. ③ 마지막으로, 기존 LocalStorage 저장/불러오기 코드를 이 Supabase 테이블에 저장하도록 바꿔줘. 한 번에 다 하지 말고 ①→②→③ 순서로, 각 단계가 끝나면 내가 확인할 수 있게 멈춰줘."

성공하면 이렇게 보입니다: 에이전트가 단계별로 안내를 멈춰 주고, 마지막엔 습관을 체크할 때마다 Supabase 대시보드의 habits 테이블에 새 줄(행)이 또박또박 쌓이는 것이 보입니다. 브라우저 캐시를 지워도, 다른 기기에서 열어도 그 데이터가 그대로 살아 있습니다. LocalStorage의 벽을 넘은 순간이에요.

6. 복붙 프롬프트 ② — 이미지·파일을 Supabase Storage에 올리기

여기가 4장에선 다루지 않은 완전히 새로운 능력입니다. 사진·문서 같은 비정형 덩어리는 표가 아니라 Storage 버킷에 올린다고 했죠. 예를 들어 습관마다 "인증샷"을 첨부하고 싶다면, 이렇게 시킵니다.

"이 앱에 이미지 업로드 기능을 Supabase Storage로 붙여줘. ① 먼저 Supabase에서 이미지를 담을 버킷(예: habit-photos)을 만드는 방법과, 이 버킷에 업로드를 허용하는 Storage 권한 정책(storage.objects 테이블의 RLS 정책)을 만드는 SQL을 알려줘. 연습용이니 버킷은 공개(Public)로 만들어도 괜찮은지, 비공개로 두면 Signed URL을 어떻게 쓰는지도 같이 설명해줘. ② 화면에 사진 선택 버튼을 추가하고, 고른 이미지를 그 버킷에 업로드한 뒤, 업로드된 파일의 주소(URL)를 받아 habits 테이블의 photo_url 열에 함께 저장하도록 코드를 짜줘. ③ 업로드 중에는 '올리는 중…' 표시를, 끝나면 '사진이 저장됐어요 ✅' 안내를 보여주고, 실패하면 에러를 화면에 알려줘."

성공하면 이렇게 보입니다: 사진을 고르면 "올리는 중…"이 잠깐 뜨고, Supabase의 habit-photos 버킷에 그 이미지 파일이 실제로 들어갑니다. 동시에 테이블의 photo_url 칸에는 그 사진의 주소가 적히죠. 정형(테이블)과 비정형(파일)이 어떻게 손을 잡는지 — 표에는 "주소"만, 파일은 "창고"에 — 눈으로 확인하는 순간입니다.

7. 복붙 프롬프트 ③ — 저장한 데이터를 다시 화면에 그리기

저장은 절반입니다. 나머지 절반은 "DB에서 데이터를 불러와 화면에 다시 보여주기"예요. 앱을 새로 열었을 때 내 기록이 그대로 떠 있어야 진짜 서비스죠.

"앱을 처음 열 때 Supabase의 habits 테이블에서 내 기록을 모두 불러와 화면 목록으로 그려줘. 최신 날짜가 위로 오게 정렬하고, 각 줄에 photo_url이 있으면 작은 썸네일 이미지도 같이 보여줘. 불러오는 동안에는 '불러오는 중…'을 표시하고, 데이터가 하나도 없으면 '아직 기록이 없어요'라는 안내를 보여줘."

성공하면 이렇게 보입니다: 앱을 새로고침해도 그동안 쌓은 습관 기록이 최신순으로 쭉 떠 있고, 사진을 붙였던 기록엔 작은 썸네일까지 같이 보입니다. 저장→불러오기가 한 바퀴 돌면, 비로소 "데이터가 살아 있는 앱"이 됩니다.

8. '내 데이터만 보이게' — RLS 한 단락

여기서 아주 중요한 질문 하나. "여러 사람이 같은 DB를 쓰면, 남이 내 기록을 보거나 지울 수도 있는 거 아냐?" 맞습니다. 그래서 필요한 게 RLS(Row Level Security, 줄 단위 보안)입니다.

🔒
RLS = 테이블의 "각 줄(행)에 주인 이름표"를 붙여, 자기 줄만 보고·고치게 하는 잠금장치
공용 사물함에 칸마다 자물쇠가 달린 것과 같아요. 내 열쇠(로그인 정보)로는 내 칸만 열립니다. 남의 줄은 아예 보이지도 않죠. 이걸 켜 두지 않으면, 한 사람이 모두의 데이터를 볼 수 있는 위험한 상태가 됩니다.

참고로 Supabase 대시보드의 Table Editor에서 만든 테이블은 RLS가 기본으로 켜져 있지만, SQL Editor에서 SQL로 직접 만든 테이블은 RLS를 따로 켜야 합니다. 에이전트가 SQL로 테이블을 만들었다면 RLS가 켜졌는지 꼭 확인하세요.

RLS도 직접 설정할 필요 없이 에이전트에게 시킵니다. 단, 이건 보안 문제라 "빠뜨리지 말고 꼭 켜라"고 분명히 못 박는 게 좋아요.

"habits 테이블에 Row Level Security(RLS)를 켜고, 로그인한 사용자가 '자신의 user_id가 적힌 줄만' 읽고·추가·수정·삭제할 수 있도록 정책을 만들어줘. 남의 데이터는 조회조차 안 되게 해줘. 적용할 SQL과, Supabase 화면에서 확인하는 방법도 함께 알려줘."

★ 로그인은 다음 클립에서: RLS는 "이 줄의 주인이 누구냐"를 알아야 작동하는데, 그 "누구"를 정해 주는 게 바로 로그인(Auth)입니다. 본격적인 로그인 붙이기 — 특히 구글·카카오 같은 소셜 로그인(OAuth) — 은 바로 다음 클립 5-2에서 제대로 다룹니다. 지금은 "내 데이터만 보이게 하려면 RLS와 로그인이 짝꿍"이라는 그림만 챙겨 두세요.

9. 막히면 이렇게 — 트러블슈팅

새 도구를 붙일 때 한두 번 막히는 건 너무 정상입니다. 당황하지 말고 아래 순서로 점검하세요. 그리고 가장 강력한 무기를 잊지 마세요 — 빨간 에러 메시지를 그대로 복사해 에이전트에게 주는 것입니다.

💡 ① 연동 자체가 안 돼요 → 십중팔구 키·주소 문제입니다. Supabase의 프로젝트 URL과 Publishable key(예전 이름 anon key)를 정확히(오타·앞뒤 공백 없이) 넣었는지, 환경변수 이름이 코드와 맞는지 확인하세요.

💡 ② 저장은 되는데 데이터가 안 보여요 → 대개 RLS·로그인 상태입니다. RLS를 켰다면 "로그인한 사용자"만 자기 줄을 볼 수 있어서, 로그인이 안 된 상태면 빈 화면이 됩니다(로그인은 5-2에서 붙입니다). 테스트 중이라면 Supabase 대시보드의 테이블에서 데이터가 실제로 쌓였는지부터 확인하세요.

💡 ③ 파일 업로드가 막혀요 → 버킷이 만들어졌는지, 그리고 업로드를 허용하는 Storage 권한 정책이 있는지 확인하세요(정책이 없으면 업로드가 거부됩니다). 올라갔는데 사진이 안 보이면 비공개 버킷인데 공개 주소를 쓴 경우가 많습니다. 잘 모르겠으면 에이전트에게 "이 버킷에 업로드가 안 되는데 권한 설정을 점검해줘"라고 맡기면 됩니다.

💡 ④ 그래도 모르겠으면 → 브라우저 콘솔(맥 Cmd+Option+I / 윈도우 F12)의 빨간 에러를 통째로 복사해서 "이 에러가 뜨는데 고쳐줘"라고 주세요. 에러를 읽어 정확히 되돌려주는 습관이 곧 실력입니다.

이것만 기억하세요

데이터엔 두 종류가 있습니다. 정형(표에 들어가는 회원·기록)은 DB 테이블에, 비정형(이미지·파일 덩어리)은 Storage 버킷에 담고 — 테이블엔 파일의 "주소"만 적습니다. Supabase는 이 둘과 로그인까지 한 번에 줍니다. 여러분이 할 일은 SQL을 외우는 게 아니라 "무엇을 어디에 담을지" 정해 에이전트에게 시키는 것, 그리고 남의 데이터가 안 보이게 RLS를 꼭 켜라고 못 박는 것뿐입니다.

다음 클립
5-2. 소셜 로그인 (OAuth)
이어보기 →