ERD: 데이터베이스 스키마 설계

users (사용자)
├── id (UUID, PK)
├── email (UNIQUE)
├── name
├── created_at

subscriptions (구독)
├── id (UUID, PK)
├── user_id (FK → users)
├── plan (free/pro/team)
├── stripe_customer_id
├── current_period_end

generations (AI 생성 이력)
├── id (UUID, PK)
├── user_id (FK → users)
├── prompt
├── result
├── tokens_used
├── created_at

templates (템플릿)
├── id (UUID, PK)
├── name
├── category
├── prompt_template
├── is_premium

usages (사용량)
├── id (UUID, PK)
├── user_id (FK → users)
├── month (yyyy-mm)
├── count

projects (프로젝트 그룹화)
├── id (UUID, PK)
├── user_id (FK → users)
├── name
└── settings (JSONB)

users 1—N subscriptions
users 1—N generations
users 1—N usages
users 1—N projects
projects 1—N generations
templates N—M generations (사용 이력)

-- users (Supabase Auth가 자동 생성하는 auth.users 확장)
create table public.users (
  id uuid primary key references auth.users(id) on delete cascade,
  email text unique not null,
  name text,
  created_at timestamptz default now()
);

create table public.subscriptions (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references public.users(id) on delete cascade,
  plan text not null check (plan in ('free','pro','team')),
  stripe_customer_id text,
  stripe_subscription_id text,
  current_period_end timestamptz,
  created_at timestamptz default now()
);

create table public.generations (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references public.users(id) on delete cascade,
  template_id uuid references public.templates(id),
  prompt text not null,
  result text,
  tokens_used int,
  created_at timestamptz default now()
);

-- 인덱스 (성능)
create index idx_generations_user on public.generations(user_id, created_at desc);
create index idx_subscriptions_user on public.subscriptions(user_id);

alter table public.generations enable row level security;

create policy "users see own generations"
on public.generations for select
using (auth.uid() = user_id);

create policy "users insert own"
on public.generations for insert
with check (auth.uid() = user_id);

정규화 (3NF)
- 데이터 무결성 ↑
- 조인 많음 → 느림 가능
- AI SaaS 6엔터티는 정규화로 충분

비정규화 (성능)
- usage_count를 users 테이블에 캐싱
- 트레이드오프: 동기화 비용 vs 빠른 조회

- PK는 자동 인덱스
- FK 컬럼 → 인덱스 (조인 빠름)
- WHERE 자주 쓰는 컬럼 → 인덱스
- 너무 많으면 INSERT 느림 (균형)

EXPLAIN ANALYZE
SELECT * FROM generations
WHERE user_id = $1
ORDER BY created_at DESC
LIMIT 20;
→ Index Scan 확인