# Clerk + Supabase 통합 설정 가이드

## 1. Clerk 대시보드 설정

### JWT Template 생성
1. [Clerk 대시보드](https://clerk.com)에 로그인
2. 프로젝트 선택 (joint-cheetah-86)
3. **JWT Templates** 섹션으로 이동
4. **Create Template** 클릭
5. 다음 설정 적용:

```json
{
  "name": "supabase",
  "claims": {
    "aud": "authenticated",
    "role": "authenticated",
    "email": "{{user.primary_email_address}}",
    "email_verified": true,
    "phone": "{{user.primary_phone_number}}",
    "app_metadata": {
      "provider": "clerk",
      "providers": ["clerk"]
    },
    "user_metadata": {
      "name": "{{user.full_name}}",
      "username": "{{user.username}}",
      "avatar_url": "{{user.image_url}}"
    }
  },
  "lifetime": 3600
}
```

### 소셜 로그인 설정 (Task 11.3 예정)
1. **Social Connections** 섹션
2. 다음 제공자 활성화:
   - Google
   - GitHub
   - 카카오 (Custom OAuth)
   - 네이버 (Custom OAuth)

## 2. Supabase 설정

### JWT Secret 설정
1. Supabase 대시보드에서 **Settings** → **API**
2. **JWT Secret** 섹션에서 Clerk의 JWT 공개 키 설정
3. Clerk 대시보드에서 **API Keys** → **JWT Public Key** 복사

### RLS 정책 수정
```sql
-- Clerk JWT를 위한 함수 생성
CREATE OR REPLACE FUNCTION auth.clerk_user_id() 
RETURNS TEXT AS $$
  SELECT COALESCE(
    current_setting('request.jwt.claims', true)::json->>'sub',
    (current_setting('request.jwt.claims', true)::json->'raw_user_meta_data'->>'sub')
  )::text;
$$ LANGUAGE SQL STABLE;

-- RLS 정책 업데이트 (이미 생성된 정책 수정)
ALTER POLICY "사용자는 자신의 프로필만 조회 가능" ON user_profiles
  USING (clerk_user_id = auth.clerk_user_id());
```

## 3. 환경 변수 설정

`.env`:
```bash
# Clerk
VITE_CLERK_PUBLISHABLE_KEY=pk_test_am9pbnQtY2hlZXRhaC04Ni5jbGVyay5hY2NvdW50cy5kZXYk

# Supabase
VITE_SUPABASE_URL=https://qnerebtvwwfobfzdoftx.supabase.co
VITE_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

## 4. 코드 통합 체크리스트

### 완료된 작업
- [x] Supabase 클라이언트 설정 (`src/lib/supabase/client.ts`)
- [x] Clerk 인증 훅 생성 (`src/lib/supabase/auth.ts`)
- [x] AuthGuard 컴포넌트 생성
- [x] SignIn/SignUp 컴포넌트 생성
- [x] 라우팅 설정

### 다음 단계
- [ ] Clerk 대시보드에서 JWT 템플릿 생성
- [ ] Supabase에서 Clerk JWT 공개 키 설정
- [ ] RLS 정책 업데이트
- [ ] 기존 Appwrite 코드 제거 (Task 11.4)
- [ ] 데이터 마이그레이션 (Task 11.5)

## 5. 테스트

1. 애플리케이션 실행
2. `/sign-up`에서 새 계정 생성
3. Supabase 대시보드에서 `user_profiles` 테이블 확인
4. 프로필이 자동 생성되었는지 확인

## 6. 트러블슈팅

### JWT 토큰 오류
- Clerk 대시보드에서 JWT 템플릿 이름이 'supabase'인지 확인
- Supabase에 Clerk JWT 공개 키가 올바르게 설정되었는지 확인

### RLS 오류
- `auth.clerk_user_id()` 함수가 생성되었는지 확인
- RLS 정책이 업데이트되었는지 확인

### 프로필 생성 실패
- Clerk 사용자 ID가 올바르게 전달되는지 확인
- Supabase 연결이 정상인지 확인