Study Decks

Supabase 완전 정복

왜 Supabase인가부터 Vercel과의 역할 배분, Auth/RLS/Realtime/Storage/Edge Functions 실전까지

이 덱은 누구를 위한 것인가 · 이 덱에서 다루는 것과 다루지 않는 것 · 전체 로드맵 +302

3이 덱은 누구를 위한 것인가
4이 덱에서 다루는 것과 다루지 않는 것
5전체 로드맵
6미리 잡아두면 좋은 멘탈 모델 3가지
7실습 환경 준비물
8자주 나올 용어 미리보기
10백엔드를 처음부터 만들 때 반복되는 일들
11BaaS라는 선택지
12Supabase의 한 줄 정의
13"그냥 Postgres다"가 왜 중요한가
14Firebase와의 결정적 차이 (1) 데이터 모델
15Firebase와의 결정적 차이 (2) 쿼리
16Firebase와의 결정적 차이 (3) 종속성
17비교표: Supabase vs Firebase vs 직접 구축
18제품 구성 한눈에 보기
19개발 속도가 실제로 빨라지는 지점
20오픈소스와 셀프호스팅이라는 탈출구
21Supabase를 쓰면 좋은 경우
22Supabase를 쓰면 안 되는(신중해야 할) 경우
23자주 나오는 오해 (1) "SQL 몰라도 되죠?"
24자주 나오는 오해 (2) "백엔드가 아예 필요 없다"
25자주 나오는 오해 (3) "RLS만 켜면 안전하다"
26도입 판단 체크리스트
27비용 감각 미리 잡기
281장 요약
30전체 아키텍처 한 장
31요청 하나가 지나가는 길
32Envoy — API 게이트웨이
33PostgREST — 테이블을 REST로
34PostgREST가 만드는 엔드포인트
35Auth (GoTrue) — JWT 발급기
36Realtime — WAL 구독 + 브로드캐스트
37Storage API — 메타데이터는 Postgres에
38Edge Functions — Deno 런타임
39Supavisor — 커넥션 풀러
40pg_meta와 Studio
41스키마 지도: 무엇이 어디에 있나
42API 키와 Postgres 역할의 연결
43세 가지 접근 경로 비교
44이 구조에서 나오는 결론들
452장 요약
47두 갈래 시작 경로
48대시보드로 프로젝트 만들기
49대시보드 둘러보기 — 어디에 뭐가 있나
50프로젝트 자격 증명 확인하기
51첫 테이블 만들기 (SQL Editor)
52supabase-js 설치와 클라이언트 생성
53첫 조회 / 삽입
54여기서 멈추면 안 되는 이유
55CLI 설치
56supabase init — 프로젝트 구조
57supabase start — 로컬 스택
58로컬 스택 구성 요소와 포트
59첫 마이그레이션 만들기
60supabase db reset — 재현 가능한 DB
61seed.sql — 개발용 데이터
62원격 프로젝트와 연결하기
63타입 생성 — 여기서 개발 경험이 갈린다
64config.toml 훑어보기
653장 요약 + 권장 워크플로
67왜 Postgres를 따로 짚는가
68스키마 설계의 출발점 — auth.users
69profiles 패턴 — 가장 먼저 만드는 테이블
70profiles 패턴이 필요한 이유
71자주 쓰는 데이터 타입
72uuid vs bigint — 기본 키 선택
73timestamptz를 반드시 써야 하는 이유
74관계 표현 (1) 1:N
75관계 표현 (2) N:M
76제약 조건 — DB가 대신 지켜주는 것
77enum vs check vs 참조 테이블
78인덱스 기초
79인덱스를 언제 어디에 만드나
80뷰와 머티리얼라이즈드 뷰
81트랜잭션과 원자성
82데이터베이스 함수 (RPC) 맛보기
83트리거 — updated_at 자동 갱신
844장 요약
86Data API의 정체
87클라이언트 생성 옵션
88select 기본
89필터 연산자 총정리
90복합 조건 — or, and, not
91정렬과 페이지네이션
92개수 세기
93단일 행 — single / maybeSingle
94관계 조회 (1) 기본 조인
95관계 조회 (2) 별칭과 다중 외래 키
96관계 조회 (3) inner join과 자식 필터
97관계 조회의 한계
98insert
99update / delete
100upsert
101RPC — 데이터베이스 함수 호출
102JSON 컬럼 다루기
103전문 검색 (textSearch)
104에러 처리 패턴
105타입 안전성 활용
1065장 요약 + 안티패턴
108Auth가 해결하는 문제
109인증과 인가는 다르다
110auth.users 테이블 구조
111JWT 구조 뜯어보기
112access token과 refresh token
113세션 생명주기
114이메일 + 비밀번호 가입
115이메일 확인 플로우
116로그인과 로그아웃
117매직 링크 / OTP
118소셜 로그인 (OAuth) 설정
119소셜 로그인 코드와 콜백
120PKCE 플로우
121익명 로그인
122전화번호 인증
123SSO / SAML
124비밀번호 재설정
125사용자 메타데이터 — user vs app
126커스텀 클레임과 RBAC
127커스텀 클레임 활용
128Auth Hooks
129MFA (다중 인증)
130서명 키와 getClaims
131getClaims vs getUser vs getSession
132Admin API — 서버에서 사용자 관리
133흔한 Auth 함정 모음
1346장 요약
136RLS 한 문장 정의
137RLS가 없으면 벌어지는 일
138RLS 켜기와 기본 거부
139권한(GRANT)과 정책(POLICY)은 다른 층이다
140정책 문법 해부
141using vs with check
142연산별 정책 4종 세트
143헬퍼 함수 — auth.uid(), auth.jwt()
144패턴 1 — 소유자만 (가장 기본)
145패턴 2 — 공개 읽기 + 소유자 쓰기
146패턴 3 — 팀 / 조직 멤버십
147패턴 4 — 역할 기반 (RBAC)
148패턴 5 — 가시성 범위 (public / friends / private)
149permissive vs restrictive
150security definer 헬퍼 함수
151성능 (1) — 함수를 select로 감싸기
152성능 (2) — 인덱스와 명시적 필터
153성능 (3) — 역할 지정과 조인 회피
154RLS 우회 경로 점검
155RLS 테스트하는 법
1567장 요약 + 체크리스트
158Storage의 구조
159버킷 만들기 — public vs private
160업로드
161다운로드와 URL 3종
162Storage RLS 정책
163폴더 구조로 권한 나누기
164이미지 변환
165재개 가능 업로드 (TUS)
166S3 호환 접근
167파일 메타데이터를 앱 테이블과 연결하기
168대용량 · 보안 업로드 패턴
169Storage 함정 모음
1708장 요약
172Realtime의 세 가지 기능
173채널이라는 공통 추상
174Broadcast 기초
175Broadcast — self / ack / HTTP 전송
176Presence
177Postgres Changes 설정
178Postgres Changes 구독과 필터
179Postgres Changes와 RLS
180Broadcast from Database — 두 방식의 장점 합치기
181무엇을 언제 쓰나 — 선택 가이드
182확장성 — 반드시 알아야 할 차이
183private 채널과 인가
184실전 — 낙관적 UI와 재연결
185Realtime 함정 모음
1869장 요약
188Edge Functions란
189첫 함수 만들기
190로컬 실행과 배포
191호출 방법
192시크릿(환경 변수) 관리
193함수 안에서 DB 접근 — 두 가지 방식
194JWT 검증과 인가
195의존성 관리
196CORS 처리
197Database Webhooks와 연동
198언제 Edge Function을 쓰나
199제약과 함정
20010장 요약
202확장(extension)이라는 개념
203확장 설치하기
204pgvector (1) — 임베딩 검색이란
205pgvector (2) — 스키마와 인덱스
206pgvector (3) — 검색 함수와 호출
207pg_cron — 스케줄 작업
208pg_net — DB에서 HTTP 호출
209pgmq — 메시지 큐
210Foreign Data Wrappers
211Vault — 시크릿 저장
212기타 알아둘 확장들
213조합 패턴 — cron + queue + edge function
21411장 요약
216흔한 오해 — 둘은 경쟁 관계인가
217한 문장 역할 배분
218Vercel이 잘하는 것
219Supabase가 잘하는 것
220겹치는 영역 지도
221표준 아키텍처 한 장
222요청 흐름 3종
223판단 기준 (1) — 서버 로직을 어디에 둘까
224판단 기준 (2) — 비교표
225판단 기준 (3) — 실제 사례로 배치해보기
226데이터 접근 경로 선택 — Data API vs 직접 연결
227리전 배치 — 지연 시간의 핵심
228캐싱 역할 분담
229환경 변수 배치
230Vercel 통합 — 두 가지 연결 방식
231프리뷰 배포와 Supabase 브랜치 매핑
232Auth Redirect URL과 프리뷰 문제
233비용 관점의 역할 배분
234파일 업로드 경로 설계
235Vercel 없이 Supabase를 쓰는 경우
236안티패턴 모음
23712장 요약
239왜 별도 패키지가 필요한가
240환경 변수
241브라우저 클라이언트
242서버 클라이언트
243쿠키 처리 규칙
244middleware.ts — 세션 갱신
245middleware.ts — 라우트 보호까지
246middleware 주의사항
247Server Component에서 데이터 조회
248라우트 보호 패턴
249Server Action으로 로그인
250Server Action으로 데이터 변경
251Route Handler
252클라이언트 컴포넌트에서 조회
253Realtime을 클라이언트 컴포넌트에서
254캐싱과 동적 렌더링
255관리자 클라이언트 분리
256타입 공유 구조
257로그아웃과 세션 정리
258디렉터리 구조 예시
259Next.js 통합 함정 모음
26013장 요약
262환경 분리 전략
263마이그레이션의 규칙
264마이그레이션 작성 요령
265파괴적 변경 다루기
266무중단 스키마 변경 순서
267브랜칭 개요
268브랜칭 워크플로
269CI/CD 파이프라인 설계
270GitHub Actions — 검증
271GitHub Actions — 배포
272시크릿 관리
273백업과 복구
274모니터링과 로그
275Advisors 활용
276프로덕션 체크리스트 — 보안
277프로덕션 체크리스트 — 안정성
278사고 대응 시나리오
279팀 규칙으로 만들 것들
28014장 요약
282성능 문제의 지도
283진단 도구 — EXPLAIN ANALYZE
284인덱스로 해결되는 것들
285RLS 성능 재점검
286N+1 제거
287페이지네이션 최적화
288커넥션 관리
289컴퓨트 크기와 한계
290캐싱 전략
291비용 구조 이해 (1) — 무엇에 돈이 나가나
292비용 구조 이해 (2) — 대역폭이 조용한 킬러
293비용 절감 체크리스트
294확장 한계 — 언제 벽에 부딪히나
295읽기 부하 분산
296쓰기 부하 대응
297언제 Supabase를 벗어나야 하나
29815장 요약
300시나리오 1 — 멀티테넌트 SaaS (스키마)
301시나리오 1 — RLS 헬퍼 함수
302시나리오 1 — 정책 적용
303시나리오 1 — 초대 플로우
304시나리오 2 — 실시간 채팅 (스키마와 정책)
305시나리오 2 — 전송과 구독
306시나리오 3 — 결제 연동 (Stripe)
307시나리오 3 — 웹훅 처리와 멱등성
308시나리오 4 — 파일 기반 문서 앱
309시나리오 5 — AI 챗봇 (RAG)
310감사 로그 패턴 (1) — 테이블
311감사 로그 패턴 (2) — 트리거
312소프트 삭제 패턴
313알림 패턴
314안티패턴 총정리 (1) — 보안
315안티패턴 총정리 (2) — 설계와 성능
31616장 요약
318전체 그림 되짚기
319꼭 기억할 10가지
320첫 프로젝트 시작 순서
321학습 로드맵
322참고 자료
323자주 받는 질문
324마무리

324 slides

스터디 자료

Supabase 완전 정복

웹게임 개발 with Phaser 4