AI용 분할본 · 지도 7단계(운영·개정 — 필요할 때만) — 배포 뒤 결정서에 없던 새 기능·테이블이 필요해지면 연다 · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 7 보안·테스트 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

부록 E — 대성공 대비: 앱 DB에 테이블 늘리기

앱이 커져서(9-3의 신호) 저장할 것이 늘어나면, RIDM Apps가 준 앱 전용 PostgreSQL에 테이블을 추가하면 됩니다. 외부 DB 서비스를 새로 붙일 필요가 없습니다. 단 하나의 철칙: 모든 쿼리는 서버 코드에서 WHERE user_id = 세션 회원 id로 소유권을 건다. 이 DB는 브라우저가 직접 접속하지 못하고(DATABASE_URL은 서버에만 있음) 오직 여러분의 API 라우트만 읽고 쓰므로, 남의 데이터를 막는 것은 라우트의 WHERE 절입니다. 브라우저가 보낸 user_id나 다른 회원의 id로 조회하는 라우트를 만드는 순간 전 회원 데이터가 열립니다. 메모(lib/notes.ts)가 그 모범입니다 — 새 테이블은 메모와 똑같이 만듭니다.

테이블 추가는 lib/schema-extra.ts의 SCHEMA_EXTRA 문자열에 CREATE TABLE IF NOT EXISTS …를 적는 것으로 끝납니다 — lib/db.ts가 책의 테이블을 만든 다음 따로 실행하므로 배포 뒤 첫 요청 때 자동으로 만들어지고, 이미 있으면 건너뜁니다. 단, 여기 적은 문장이 틀리면 책의 테이블은 지워지지 않지만 고칠 때까지 DB 를 쓰는 모든 요청(가입·로그인·메모)이 실패합니다 — 앱 전체가 멈춘 것처럼 보이니 배포 전에 확인합니다. lib/db.ts는 책 그대로 둡니다(get-book-code --force가 책 원문으로 되돌리는 파일입니다). 내 테이블을 추가한 뒤에는 테스트용 빈 DB로 TEST_DATABASE_URL=… npx vitest run을 돌려 틀린 문장을 배포 전에 잡습니다(7-5 — Docker 가 있으면 한 줄로 구합니다). 테스트 DB 가 없으면 테스트는 경고와 함께 건너뛰니, 배포 직후 smoke-live 로 가입·메모가 되는지 바로 보고, 완료 보고에 "DB 테스트: 미실행(테스트 DB 없음)"이라고 적습니다.

책의 파일은 고치지 않습니다. 메모 라우트·lib/notes.ts·components/Notes.tsx 같은 책 코드를 고치면 verify-book-code가 영원히 "다름"을 내고, 책 개정 때 --force가 여러분 코드를 되돌립니다. 그 대신 새 파일(새 라우트·새 화면·새 lib 파일)을 만드는 것은 자유이고, 책의 lib/db.ts 의 sql·lib/get-session-user.ts·lib/same-origin.ts·lib/rate-limit.ts 를 불러 씁니다. 기존 테이블에 컬럼을 더할 때는 ALTER TABLE … ADD COLUMN IF NOT EXISTS …를 같은 문자열 끝에 붙입니다(지우거나 이름을 바꾸는 변경은 데이터가 날아가니 AI에게 먼저 말하라고 하세요 — 그 전에 앱 상세의 백업 만들기).

E-1. 두 번째 기능 붙이기 — 예: 할 일 목록 (todos)

"메모 말고 할 일도 적고 싶어요" 같은 요청이 오면 이렇게 붙입니다. 게시판·일기·북마크도 이름과 칸만 다를 뿐 같은 순서입니다. 처음부터 만들 필요는 없습니다 — 요청이 오면 그때.

[프롬프트 — 내 테이블로 두 번째 기능 붙이기: 할 일 목록]
회원마다 자기 할 일만 보이는 할 일 목록을 붙여 주세요. 메모(lib/notes.ts, app/api/notes)와 똑같은 규칙으로 만든다.

고치는 책 파일은 lib/schema-extra.ts·app/page.tsx(할 일 화면으로 가는 링크) 뿐이다. 다른 책 코드는 고치지 않는다(새 파일은 만들어도 된다).
1. lib/schema-extra.ts 의 SCHEMA_EXTRA 에 적는다(lib/db.ts 는 고치지 않는다):
   CREATE TABLE IF NOT EXISTS todos (
     id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
     user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,  -- 회원 탈퇴(5-4) 때 같이 지워진다. 빼지 않는다
     text text NOT NULL,             -- 1~200자
     done boolean NOT NULL DEFAULT false,
     created_at timestamptz NOT NULL DEFAULT now()
   );
   CREATE INDEX IF NOT EXISTS todos_user ON todos (user_id, created_at DESC);
2. 새 파일 lib/todos.ts — 쿼리는 lib/db.ts 의 sql 로, 값은 $1·$2 자리에 배열로 넘긴다 — sql('SELECT … WHERE user_id = $1', [userId]). 태그드 템플릿(sql`…`)이 아니고, 값을 문장에 이어 붙이지 않는다.
   모든 SELECT/UPDATE/DELETE 에 WHERE user_id = $… (세션 회원 id). id 는 UUID 형식이 아니면 SQL 전에 404. 남의 id 면 영향 행 0 → 404
3. 라우트 app/api/todos/route.ts (GET 목록 50개씩·POST 추가) 와 app/api/todos/[id]/route.ts (PATCH done·text, DELETE):
   - 전부 getSessionUser(req) 로 로그인 확인, 비로그인 401
   - POST·PATCH·DELETE 는 맨 앞에서 sameOrigin(req) — 아니면 403
   - 새 할 일은 allow(`todo:${user.id}`, 30, 60) — 넘으면 429. 속도만으로는 DB 가 찬다: lib/notes.ts 의 createNoteWithinCaps 처럼
     회원당 합계(예: 500개 — 할 일 한 줄은 1KB 도 안 되니 0.5MB)와 하루 개수를 DB 에서 세어 넘으면 429
   - 입력은 서버가 다시 검사: text 는 앞뒤 공백 뺀 1~200자, done 은 boolean 만 — 아니면 400
4. 화면: 새 페이지 app/todos/page.tsx + 새 컴포넌트 components/Todos.tsx. 로그인 확인은 app/page.tsx 처럼 /api/me 로, 호출은 lib/client.ts 의 sendJson 으로(Origin 은 브라우저가 붙인다). 401 이면 /login 으로. 스타일은 globals.css 토큰만. 메모 화면(app/page.tsx)에 "할 일" 링크 하나
5. 테스트 tests/todos.test.ts — tests/notes.test.ts 를 본떠 실제 PostgreSQL(TEST_DATABASE_URL, 없으면 건너뜀)로:
   만들기→목록→바꾸기→지우기 / 다른 회원의 id 로 PATCH·DELETE → 404 / Origin 없는 POST → 403 / 비로그인 401 / 201자 → 400.
   sql 을 mock 하지 않는다(가짜 sql 은 틀린 SQL 도 통과시킨다)
6. 완료 기준(스스로 실행해 증명):
   - node scripts/verify-book-code.mjs → 불일치 0개 (책 파일을 안 고쳤다는 증거)
   - TEST_DATABASE_URL 로 npx vitest run → skipped 0 (테스트 DB 가 없으면 "DB 테스트: 미실행"으로 보고)
   - 배포 뒤 node scripts/smoke-live.mjs https://이름.ridm.ai → 실패 0개 (기존 가입·메모 회귀 없음)
   - 다른 회원으로 로그인 → 앞 회원의 할 일이 안 보임

E-2. 용량과 점검

• DB 용량: 앱 카드에 DB 사용량이 보이고, 80%·100%에서 메일이 옵니다. 한도를 넘긴 채 24시간이 지나면(150%를 넘으면 즉시) DB가 읽기 전용이 되어 가입·저장은 물론 앱 화면의 삭제도 실패하고, 그 상태에서 110%를 넘으면 DB 연결이 끊깁니다. 그러니 필요 없는 행은 80% 알림 때 미리 정리합니다. 이미 읽기 전용이면 플랜 올리기가 가장 빠르고(무료 100MB · 베이직 1GB · 프로 3GB — 9-1), 행을 지우려면 그 연결에서 SET default_transaction_read_only = off 를 먼저 실행합니다. 90% 아래로 줄거나 플랜을 올리면 5분 안에 풀립니다. 회원이 직접 지운 메모와 탈퇴한 회원(5-4)의 모든 데이터는 DB 에서도 바로 지워집니다. 메모는 한 회원 200개(약 3.5MB)가 상한이라, 용량이 빠르게 늘면 여러 계정을 의심합니다(6-2)
• 백업: 큰 변경(테이블 구조 변경) 전에는 앱 상세의 백업 만들기로 내려받아 둡니다
• 소유권 점검 3종 (테이블을 추가할 때마다):
  • grep -rn "FROM \|UPDATE \|DELETE FROM" app lib → 회원 데이터 테이블을 건드리는 모든 쿼리에 user_id = $ 조건이 있는가(관리자의 개수 세기 count(*) 는 예외 — 내용을 돌려주지 않는다)
  • 로그아웃 상태로 새 라우트 전부 호출 → 401, Origin 없이 바꾸는 요청 → 403
  • 다른 테스트 회원으로 로그인해 앞 회원의 id로 조회·수정·삭제 → 404, 앞 회원 데이터는 그대로
• 연결 수: 테이블이 늘어도 Pool은 하나(lib/db.ts의 sql())만 씁니다 — 새 테이블 쿼리도 이 sql()로 합니다. 라우트마다 새 Pool을 만들면 연결 3개 한도에 바로 걸립니다
• 쿼리 시간: 쿼리 하나는 10초 한도입니다(1-4). 회원별로 모아 읽는 테이블에는 메모처럼 (user_id, …) 인덱스를 같이 만들고, 목록은 LIMIT 으로 나눠 읽습니다

E-3. 이 구조의 숨은 장점

• 회원·메모·내 테이블은 앱 DB에 — 앱 컨테이너 자체는 아무것도 저장하지 않는 "껍데기"입니다. 그래서 재배포·되돌리기·플랜 변경이 데이터에 영향을 주지 않습니다
• 코드는 표준 Next.js + PostgreSQL이고 저장소 루트의 Dockerfile로 빌드되므로, 특정 호스팅의 전용 기능에 묶여 있지 않습니다. DB는 앱 상세의 백업 만들기로 언제든 통째로 내려받을 수 있습니다
• 나중에 AI 기능을 붙이고 싶어지면 이 뼈대(회원·세션·격리·요청 제한)가 그대로 출발점이 됩니다 — HRUM(흐름) 을 쓰는 책은 전자책 고르기에 있습니다. 나중에 HRUM API 를 붙이면 만세력·궁합·평생 사주 같은 계산형·풀이형 결과는 1회 호출 후 이 DB 에 저장해 재사용하세요 — 같은 입력의 두 번째 호출부터 비용 0원입니다(대화형 채팅은 매번 새로 생성되어 저장 대상이 아닙니다)

AI용 분할본 · 지도 7단계(운영·개정 — 필요할 때만) — 배포 뒤 결정서에 없던 새 기능·테이블이 필요해지면 연다 · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 7 보안·테스트 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)