feat: 카카오 로그인 기능 구현

[evenif99]

1. 작업 내용

• 카카오 OAuth 로그인 기능 구현 (버튼 signIn 연결)
• @auth/prisma-adapter 설치 및 authOptions 적용
• 최초 로그인 시 kakaoId, nickname, termsAgreedAt 자동 설정 (signIn 콜백)
• 닉네임 자동 생성 유틸 추가 (~하는부엉이 + 랜덤 4자리, 20개 동사 pool)
• 닉네임 유니크 제약(@unique) 추가 및 충돌 재시도 로직 구현 (최대 10회, fallback도 랜덤 8자리)
• middleware.ts 추가: /login, /api/auth/* 외 비인증 접근 차단 (경계 패턴 보완)
• SCSS import 절대경로(@/) 수정, .disclaimer에 text-caption mixin 적용
• 캐릭터 이미지 Next/Image fill → img 태그 변경
• 이용약관/개인정보처리방침 링크(/terms, /privacy) 및 스타일(underline, cursor:pointer) 적용

2. 담당 작업 영역

• identity-access
• room-ai-chat
• invite-participation
• statement
• judgement-result
• result-card-media
• records-lifecycle
• calendar-diary
• statistics
• gift-recommendation
• profile-mypage
• ops-common

3. 관련 Issue

• close #

4. 관련 기능 요구사항

• FR-AUTH-001
• FR-AUTH-002
• FR-AUTH-003

5. 관련 비기능 요구사항

• NFR-

6. 변경 사항

파일	작업
src/app/(page)/login/page.tsx	로그인 UI, signIn 버튼 연결, 캐릭터 img 태그 변경, 약관 링크 추가
src/app/(page)/login/login.module.scss	SCSS 절대경로, text-caption mixin 적용, character/disclaimerLink 클래스
src/lib/auth/index.ts	PrismaAdapter, signIn 콜백, 닉네임 재시도 로직 (fallback 랜덤화)
src/lib/auth/nickname.ts	닉네임 자동 생성 + fallback 유틸
src/middleware.ts	라우트 인증 보호 (경계 패턴 보완)
prisma/schema.prisma	nickname @unique 제약 추가
package.json / package-lock.json	@auth/prisma-adapter 의존성 추가

7. 테스트 결과

• 로컬 실행 확인
• 기능 동작 확인
• 에러 케이스 확인
• 모바일 화면 확인
• 빌드 확인
• lint 확인
• type-check 확인 (작업 파일 기준 오류 없음)

8. 작업 범위 확인

• Issue에 정의된 작업 범위 안에서 수정함
• 다른 팀원 담당 영역을 불필요하게 수정하지 않음
• 공통 파일 변경 시 팀에 공유함 — middleware.ts 신규 추가로 전체 라우트에 인증 보호 적용됨. 팀 확인 필요
• 관련 문서 수정 필요 여부를 확인함

9. 보안 / 개인정보 확인

• 환경변수 노출 없음
• API Key 노출 없음
• Supabase Service Role Key 클라이언트 노출 없음
• 권한 검증 적용
• 개인정보/진술/감정일기 원문 로그 저장 없음
• 공유 이미지에 민감정보 포함 없음

10. DB/API/Storage 변경 여부

• DB 변경 없음
• DB 변경 있음 → nickname 컬럼 @unique 제약 추가 (prisma db push 필요, DB 담당자 확인 요청)
• API 변경 없음
• API 변경 있음 → /api/auth/[...nextauth] PrismaAdapter 연동 (기존 엔드포인트 유지, 동작 변경)
• Storage 변경 없음
• Storage 변경 있음 → Supabase Storage 정책 확인

11. 스크린샷

필요 시 첨부

12. 추가 공유 사항

• DB에 kakao_id, nickname(@unique), terms_agreed_at 컬럼 반영 필요. DB 담당자에게 prisma db push 반영 여부 확인 필요.
• middleware.ts 신규 추가로 인증이 필요한 모든 페이지에 영향. 각 담당자 로컬 테스트 시 참고.
• /terms, /privacy 페이지는 미구현 상태. 추후 페이지 구현 시 링크 자동 연결.

Summary by CodeRabbit

릴리스 노트

• New Features
  • 카카오 로그인 연동 및 로그인 처리 경로를 정비
  • 로그인 페이지 UI 추가(로고/캐릭터, 이용약관 및 개인정보 처리방침 링크 포함)
  • 첫 로그인 시 자동 닉네임 생성 및 닉네임 중복 발생 시 재시도/대체 닉네임 적용
• Chores
  • 인증 데이터 저장을 위한 Prisma 어댑터 연동

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
talky-owl	Ready	Preview, Comment	Jun 18, 2026 5:16am

[coderabbitai]

📝 Walkthrough

Walkthrough

@auth/prisma-adapter 의존성을 추가하고, DB 스키마의 nickname 필드에 유니크 제약을 추가한다. authOptions에 PrismaAdapter·JWT 세션 전략·페이지 라우트·signIn 콜백(최초 로그인 시 kakaoId/닉네임/약관동의 시각 DB 기록, 닉네임 충돌 시 재시도)을 설정한다. Next.js 미들웨어로 인증이 필요한 라우트를 보호하고, 카카오 로그인 버튼이 포함된 로그인 페이지 UI를 새로 추가한다.

Changes

Kakao 로그인 전체 플로우

Layer / File(s)	Summary
닉네임 생성 유틸 및 PrismaAdapter 의존성 추가 package.json, src/lib/auth/nickname.ts	@auth/prisma-adapter 패키지를 의존성에 등록하고, 동사와 4자리 숫자를 조합해 닉네임을 생성하는 generateNickname(), 재시도 한계 도달 시 사용할 generateFallbackNickname() 함수를 추가한다.
DB 스키마 업데이트: 닉네임 유니크 제약 prisma/schema.prisma	Prisma User 모델의 nickname 필드에 @unique 제약을 추가해 닉네임 중복을 방지한다.
authOptions 확장: PrismaAdapter·세션·signIn 콜백 src/lib/auth/index.ts	PrismaAdapter, session.strategy: jwt, /login 페이지 매핑을 authOptions에 추가한다. callbacks.signIn에서 최초 Kakao 로그인 시 kakaoId, 생성된 닉네임, termsAgreedAt을 DB에 기록하며, 닉네임 유니크 제약 위반 시 재시도 로직으로 대응한다.
Next.js 미들웨어 라우트 보호 설정 src/middleware.ts	next-auth/middleware를 재내보내고 config.matcher의 부정 전방탐색 패턴으로 /login, /api/auth, 정적 에셋 경로를 제외한 모든 경로에 인증 미들웨어를 적용한다.
로그인 페이지 UI 및 스타일 src/app/(page)/login/page.tsx, src/app/(page)/login/login.module.scss	로고·캐릭터 이미지와 카카오 로그인 버튼을 렌더링하는 LoginPage 클라이언트 컴포넌트와 KakaoIcon SVG를 추가한다. CSS Module로 플렉스 레이아웃, 버튼 상태별 스타일링, 면책 문구와 이용약관·개인정보처리방침 링크 타이포그래피를 정의한다.

Sequence Diagram(s)

sequenceDiagram
  participant 사용자
  participant LoginPage
  participant NextAuth
  participant signInCallback
  participant PrismaDB as Prisma DB

  rect rgba(99, 179, 237, 0.5)
    사용자->>LoginPage: 카카오 로그인 버튼 클릭
    LoginPage->>NextAuth: signIn('kakao', { callbackUrl: '/home' })
  end

  rect rgba(154, 230, 180, 0.5)
    NextAuth->>signInCallback: callbacks.signIn(user, account) 호출
    signInCallback->>PrismaDB: findUnique — kakaoId 존재 여부 조회
    alt 최초 로그인 (kakaoId 없음)
      signInCallback->>signInCallback: generateNickname() 실행
      signInCallback->>PrismaDB: update — kakaoId, nickname, termsAgreedAt 기록
      alt 닉네임 충돌 (P2002)
        signInCallback->>signInCallback: 새 닉네임으로 재시도 (최대 10회)
        signInCallback->>PrismaDB: update — 재시도
      end
      alt 재시도 한계 도달
        signInCallback->>signInCallback: generateFallbackNickname() 실행
        signInCallback->>PrismaDB: update — fallback 닉네임 기록
      end
      PrismaDB-->>signInCallback: 업데이트 완료
    end
    signInCallback-->>NextAuth: return true
  end

  NextAuth-->>사용자: /home으로 리다이렉트

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~28 minutes

Poem

🦉 달빛 아래 부엉이가 키보드를 두드리며,
카카오 버튼 하나로 문을 열었네.
처음 온 친구엔 이름을 선물하고,
DB에 발자국을 살짝 남겨 두었지.
이제 로그인 걱정은 훌훌~ 날려 버렸어! 🍀

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목이 변경 사항의 주요 내용(카카오 로그인 기능)을 명확하고 간결하게 설명하고 있습니다.
Description check	✅ Passed	PR 설명이 리포지토리 템플릿의 대부분 섹션을 포함하며, 작업 내용, 담당 영역, 변경 사항, 테스트 결과, 보안 확인 등이 상세히 기술되어 있습니다.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/common-component-jw

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/lib/auth/index.ts`:
- Around line 33-35: The current nickname generation at the `generateNickname()`
call in the user creation block does not guarantee uniqueness and lacks retry
logic for collision handling. Create a helper function (for example,
`generateUniqueNicknameWithRetry`) that accepts the prisma client and attempts
to generate a unique nickname by repeatedly calling `generateNickname()` and
checking if the nickname already exists in the database using `findFirst`,
retrying up to a specified maximum number of times before throwing an error.
Replace the direct `generateNickname()` call with this new helper function to
ensure the PR goal of creating unique nicknames is satisfied. Additionally,
ensure the nickname column has a unique constraint in the database schema.

In `@src/middleware.ts`:
- Line 5: The matcher pattern in the middleware config file uses a negative
lookahead that only matches path prefixes, allowing unintended paths like
`/login-help` or `/images-private` to bypass authentication. Update the pattern
to add word boundaries `(?:/|$)` after each excluded path name in the negative
lookahead (such as after login, api/auth, _next/static, _next/image,
favicon.ico, and images) to ensure only exact path matches or directory
boundaries are excluded, preventing partial prefix matches from creating
security vulnerabilities.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 9c3f39b7-8df9-4c80-a137-ec6f164f66a1

📥 Commits

Reviewing files that changed from the base of the PR and between e2384b2 and 29b612f.

⛔ Files ignored due to path filters (2)

• package-lock.json is excluded by !**/package-lock.json
• public/images/common/login_character.png is excluded by !**/*.png

📒 Files selected for processing (6)

• package.json
• src/app/(page)/login/login.module.scss
• src/app/(page)/login/page.tsx
• src/lib/auth/index.ts
• src/lib/auth/nickname.ts
• src/middleware.ts

[juahcheon]

팀장님 이것도 절대경로로 수정 부탁드려요 ㅎㅎ

[evenif99]

오우 죄송함다

[juahcheon]

이걸 이미지 처리했네요....?!?! 충분히 코드로 처리 가능할 것 같은뎁...

[lyla-bae]

해당 폰트를 쓰는곳이 로고밖에 없기때문에 이미지가 맞을거같아서 제가 미리 만들어둔거에요!
웹폰트로 처리하는게 더비용이 크지않을까요?

[juahcheon]

아 비용이 들어가는 폰트라면 그게 나을 것 같네요.

[juahcheon]

이용약관이랑 개인정보 처리방침은 text-decoration: underline 추가하고 cursor: point, 하고 두 개 각각 doc 링크로 연결되어야해용

[evenif99]

넵 수정하겠슴다

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/lib/auth/index.ts`:
- Around line 9-30: The saveFirstLoginFields function lacks error handling when
all retry attempts are exhausted. After the for loop completes without returning
early (meaning all MAX_NICKNAME_RETRIES attempts failed with P2002 errors), the
function implicitly returns undefined instead of throwing an error, causing
silent failures where the user is created with incomplete data. Add a throw
statement after the for loop in saveFirstLoginFields to raise an error when all
nickname generation attempts fail, ensuring the signIn callback properly detects
and rejects failed user creation operations.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c3cc1464-554a-4d31-8da7-6de5bdc3c512

📥 Commits

Reviewing files that changed from the base of the PR and between 29b612f and 1f30c28.

📒 Files selected for processing (5)

• prisma/schema.prisma
• src/app/(page)/login/login.module.scss
• src/app/(page)/login/page.tsx
• src/lib/auth/index.ts
• src/middleware.ts

🚧 Files skipped from review as they are similar to previous changes (3)

• src/middleware.ts
• src/app/(page)/login/login.module.scss
• src/app/(page)/login/page.tsx

[coderabbitai]

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

모든 재시도 실패 시 오류가 발생하지 않습니다.

루프가 10회 모두 P2002 오류로 실패하면 함수가 정상 종료되어 signIn 콜백이 true를 반환합니다. 이 경우 사용자는 로그인되지만 kakaoId, nickname, termsAgreedAt 필드가 설정되지 않은 채로 남습니다.

🐛 재시도 실패 시 오류를 던지도록 수정

       throw e
     }
   }
+  throw new Error('고유 닉네임 생성 실패: 재시도 한도 초과')
 }

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	async function saveFirstLoginFields(userId: string, kakaoId: string): Promise<void> {
	for (let attempt = 0; attempt < MAX_NICKNAME_RETRIES; attempt++) {
	const isLastAttempt = attempt === MAX_NICKNAME_RETRIES - 1
	const nickname = isLastAttempt
	? `부엉이${Date.now()}`
	: generateNickname()
	try {
	await prisma.user.update({
	where: { id: userId },
	data: { kakaoId, nickname, termsAgreedAt: new Date() },
	})
	return
	} catch (e) {
	const err = e as { code?: string; meta?: { target?: string[] } }
	if (err.code === 'P2002' && err.meta?.target?.includes('nickname')) {
	continue
	}
	throw e
	}
	}
	}
	async function saveFirstLoginFields(userId: string, kakaoId: string): Promise<void> {
	for (let attempt = 0; attempt < MAX_NICKNAME_RETRIES; attempt++) {
	const isLastAttempt = attempt === MAX_NICKNAME_RETRIES - 1
	const nickname = isLastAttempt
	? `부엉이${Date.now()}`
	: generateNickname()
	try {
	await prisma.user.update({
	where: { id: userId },
	data: { kakaoId, nickname, termsAgreedAt: new Date() },
	})
	return
	} catch (e) {
	const err = e as { code?: string; meta?: { target?: string[] } }
	if (err.code === 'P2002' && err.meta?.target?.includes('nickname')) {
	continue
	}
	throw e
	}
	}
	throw new Error('고유 닉네임 생성 실패: 재시도 한도 초과')
	}

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/lib/auth/index.ts` around lines 9 - 30, The saveFirstLoginFields function
lacks error handling when all retry attempts are exhausted. After the for loop
completes without returning early (meaning all MAX_NICKNAME_RETRIES attempts
failed with P2002 errors), the function implicitly returns undefined instead of
throwing an error, causing silent failures where the user is created with
incomplete data. Add a throw statement after the for loop in
saveFirstLoginFields to raise an error when all nickname generation attempts
fail, ensuring the signIn callback properly detects and rejects failed user
creation operations.

[lyla-bae]

mixin 사용 부탁드립니다

[lyla-bae]

아이콘이 깨져보이는데 확인부탁드려요