DOCS/ideas/250924_happybell80_oauth_jsonb_multi_provider.md

OAuth 다중 프로바이더 지원을 위한 JSONB 구조 개선안

작성일: 2025-09-24

작성자: happybell80

---

현재 문제점

1. 단일 OAuth 구조의 한계

• oauth_id VARCHAR: 하나의 프로바이더만 지원
• oauth_provider VARCHAR: 단일 값만 저장 가능
• 사용자가 여러 플랫폼(Slack + Google + 네이버웍스) 동시 사용 불가

2. 실제 발생한 문제 사례

• 김종태: Google(100176844464607664427) + Slack(U0925SXQFDK) 분리된 계정
• JWT에는 Slack ID 포함되지만 DB에서 변환 실패
• 테스트 시 실제 사용자 ID 찾기 어려움

해결책: JSONB 다중 프로바이더 구조

제안 스키마

ALTER TABLE "user"
DROP COLUMN oauth_id,
DROP COLUMN oauth_provider,
ADD COLUMN oauth_providers JSONB DEFAULT '{}';

데이터 구조 예시

{
  "slack": "U0925SXQFDK",
  "google": "100176844464607664427",
  "works": "네이버웍스_사용자ID"
}

장점

1. 확장성

• 새 OAuth 프로바이더 추가 용이
• 기존 데이터 마이그레이션 가능
• 향후 Microsoft, Apple 등 추가 지원

2. 사용자 편의성

• 하나의 계정으로 다중 플랫폼 접근
• 플랫폼별 기능 제한 없음
• 통합된 사용자 경험

3. 시스템 안정성

• UUID 중심 아키텍처 유지
• 프로바이더 장애 시 다른 방법으로 접근 가능

구현 고려사항

1. 마이그레이션 스크립트

UPDATE "user" SET oauth_providers =
  json_build_object(oauth_provider, oauth_id)::jsonb
WHERE oauth_id IS NOT NULL;

2. 코드 수정 영역

• slack_user_to_uuid(): JSONB 쿼리로 변경
• JWT 생성: 다중 프로바이더 정보 포함
• 인증 로직: 프로바이더별 처리

3. 인덱스 최적화

CREATE INDEX idx_user_oauth_slack ON "user"
USING GIN ((oauth_providers->'slack'));

마이그레이션 전략

1. 기존 데이터 백업
2. JSONB 컬럼 추가
3. 데이터 변환 스크립트 실행
4. 애플리케이션 코드 수정
5. 테스트 및 검증
6. 기존 컬럼 제거

이 구조로 변경하면 사용자 경험 향상과 시스템 확장성을 동시에 확보할 수 있습니다.