Supabase RLS·Claude Code 프로덕션 운영 가이드

목차

1. 0장 이 책의 사용법 — 운영할 수 있는 상태란 무엇인가

   "메모를 저장할 수 있었다. 이제 공개해도 되겠다."

   읽기링크 복사
   절 6개 보기

   • 메모 하나를 공개부터 복구까지 따라간다
   • 누구를 위한 책인가
   • 읽는 방법 고르기
   • 본문 읽는 법
   • 이번 판에서 확인한 것
   • 연습 문제: 첫 질문을 내 말로 바꾸기

2. 1장 "동작했다"에서 "공개할 수 있다"로

   "제 계정으로는 전부 동작했습니다." 이 보고를 받고 공개 버튼을 누르기 전에, 누구의 어떤 조작을 확인했는지 다시 물어봅시다. 여기서는 대응 메모의 공개 판단을 표 한 장으로 만듭니다.

   읽기링크 복사
   절 5개 보기

   • 성공한 조작에서 업무상의 약속으로
   • 통과와 미확인을 구분한다
   • 기록은 작게 시작한다
   • 작성 예: 통과는 조사한 범위에만 붙인다
   • 연습 문제: "미확인"을 가려내기

3. 2장 환경과 키를 분리한다

   검증 화면에서 저장한 가상의 메모가 프로덕션 데이터베이스에 나타났다면 어떨까요. 화면 URL만 달라서는 환경이 나뉘지 않습니다. 이 장에서는 한 번의 저장이 어디에 도달하는지 따라가 봅니다.

   읽기링크 복사
   절 5개 보기

   • URL만 보고 환경을 판단하지 않는다
   • API 키와 사용자 인증은 역할이 다르다
   • 키를 헷갈려 쓰지 않게 한다
   • 저장 한 번에서 접속 대상을 따라간다
   • 연습 문제: 설정 이름을 증거로 삼지 않기

4. 3장 권한표로 RLS를 설계한다

   A와 B는 둘 다 로그인한 상태입니다. 그래도 A에게 보여 줘도 되는 메모를 B에게는 보여 줄 수 없습니다. 이 차이를 화면의 표시 조건에만 맡기지 않고 데이터베이스가 판단할 수 있는 형태로 만듭니다.

   읽기링크 복사
   절 6개 보기

   • "로그인함"보다 세밀하게 정한다
   • GRANT와 RLS를 함께 설계한다
   • 소유자 모델 교재 SQL
   • 다른 경로도 확인한다
   • SQL을 세 가지 질문으로 나눠 읽는다
   • 연습 문제: 공유로 바꾼다면 무엇이 부족한가

5. 4장 남의 데이터에 손대지 않는다는 것을 테스트한다

   B로 A의 메모를 업데이트했는데 오류가 나지 않았습니다. 이건 권한 버그일까요, 아니면 제대로 거부된 걸까요? 답을 내려면 응답과, A가 본 메모 상태를 함께 살펴봐야 합니다.

   읽기링크 복사
   절 9개 보기

   • 관리자로 읽을 수 있다는 건 사용자 테스트가 아니다
   • 허용과 거부를 짝짓는다
   • HTTP의 성공과 업무의 성공을 구분한다
   • 배포 패키지의 DB 단독 테스트를 다시 실행한다
   • 실제 앱으로 확인할 때의 조작 예
   • 자동화해도 관측할 대상은 같다
   • 기록을 읽고 판정해 본다
   • 예상과 다를 때 조사하는 법
   • 연습 문제: 0건의 의미를 판단하기

6. 5장 Claude Code에 맡길 범위를 정한다

   Claude Code에서 "수정했습니다. 테스트도 성공입니다"라는 답이 돌아왔습니다. 이 보고만 보고 A와 B의 메모가 분리됐다고 판단할 수 있을까요? 이 장에서는 요청과 보고 양쪽에 확인하고 싶은 동작을 넣습니다.

   읽기링크 복사
   절 6개 보기

   • 작업 지시와 실행 권한을 따로 준비한다
   • 첫 요청을 구체적으로 만든다
   • MCP를 연결할 때 볼 것
   • 완료 보고를 읽는 순서
   • 보고에서 "부족한 증거"를 찾는다
   • 연습 문제: 보고를 보완하는 한 문장 쓰기

7. 6장 데이터베이스를 안전하게 변경한다

   메모의 항목명을 바꾼 뒤 앱만 어제 버전으로 되돌렸습니다. 어제 코드는 오늘 데이터베이스를 읽을 수 있을까요? 변경을 작은 단계로 나누고, 어디까지 되돌릴 수 있는지 먼저 생각합니다.

   읽기링크 복사
   절 5개 보기

   • 변경은 앱과 데이터베이스의 조합으로 생각한다
   • 추가, 이전, 정리를 나눈다
   • 이력으로 남긴다
   • 롤백할 수 있는 지점을 표로 만든다
   • 연습 문제: 빈 컬럼으로는 돌아오지 않는 것 생각하기

8. 7장 장애를 발견하고 복구를 확인한다

   화면은 열리는데 메모를 저장할 수 없다. 이런 상황에서 처음 볼 것이 정해져 있으면 조사를 시작할 수 있습니다. 이 장에서는 사용자의 조작을 출발점으로 발견·초동 대응·복구 순서를 정리합니다.

   읽기링크 복사
   절 5개 보기

   • 업무가 멈췄다는 것을 관측한다
   • 첫 행동을 정해 둔다
   • 백업 범위를 확인한다
   • 사실과 가설을 나누는 연습
   • 연습 문제: 복구의 증거 고르기

9. 8장 공개일에 쓰는 운영 체크리스트

   권한을 시험했고, 변경 절차를 썼고, 복구 준비도 조사했습니다. 마지막으로 그 증거가 "지금부터 공개할 버전"을 기준으로 갖춰져 있는지 확인합니다. 과거 테스트 결과를 이번 통과로 착각하지 않기 위한 마무리입니다.

   읽기링크 복사
   절 5개 보기

   • 공개 전
   • 공개 직후
   • 다음 날·운영 중
   • 1회분 공개 기록
   • 연습 문제: 최종 과제 — 공개 판단을 한 장으로 만들기