[Feat/#87] OAuth 로그인 API 추가

[tnals0924]

#️⃣연관된 이슈

• Closes OAuth 로그인 API 추가 #87
• 상위 이슈: KConnect OAuth 로그인 구현 #82 — 5개 PR 중 마지막
• base: feat/#86-kconnect-client ([Feat/#83] OAuth 로그인 auth 도메인과 계정 연결 구성 #88·[Feat/#84] 로그인용 회원 가입·갱신·약관 동의 조회·학적 상태 추가 #89·#91이 머지된 뒤 머지)

🎯 해결하려는 문제가 무엇인가요?

POST /v1/auth/login/{provider} 로그인 API를 추가합니다. 앱·웹이 { code, codeVerifier, redirectUri }를 보내면 서비스 JWT와 약관 동의 필요 여부를 내려줍니다.

{ "accessToken": "…", "termsAgreementRequired": true }

❓ 왜 해결해야 하나요?

지금까지 PR로 만든 auth 도메인·member·KConnect 구현체를 하나의 로그인 흐름으로 조립해야 실제로 로그인할 수 있습니다.

⭐ 어떻게 해결했나요?

• AppAuthController·AppAuthApi (app-api): 경로는 /v1/app/** 밖인 /v1/auth/login/{provider}. 학생 앱과 운영진 콘솔이 같이 쓰고, 접근 범위는 토큰의 role로 나뉩니다. PublicEndpoints.AUTH로 permitAll·Swagger 공개 표기를 함께 맞췄습니다.
• 요청 검증: 세 필드 @NotBlank, codeVerifier는 PKCE 규격(43~128자, A-Z a-z 0-9 - . _ ~)
• OAuthLoginUseCase: authenticate → 연결된 계정으로 회원 찾기 → 있으면 프로필 갱신, 없으면 학번 기준 가입·갱신 후 계정 연결 → 토큰 발급 → 약관 동의 여부
• 트랜잭션: 전체를 한 트랜잭션으로 묶지 않습니다. 묶으면 provider를 호출하는 동안(최대 8초) DB 커넥션을 잡게 됩니다. 가입 후 연결이 실패해도 다음 로그인에서 학번으로 찾아 다시 연결합니다.
• AuthTokenIssuer (gateway:auth의 security 최상위 패키지): JwtProvider는 Modulith가 내부로 보는 security.jwt에 있어 api가 직접 부를 수 없어 파사드를 뒀습니다. ADMIN 회원에게는 {ADMIN, STUDENT}를 주고(운영진도 학생 앱 사용), 학생회 부서는 ADMIN에게만 싣습니다.
• config-and-auth.md의 공개 경로 예시를 실제 경로로 갱신

🧩 이 PR의 한계 & 트레이드오프

• Refresh Token·약관 동의 API는 없습니다(별도 작업).
• 같은 사용자가 거의 동시에 첫 로그인을 두 번 하면(더블 탭 등) 유니크 위반으로 한쪽이 500이 됩니다. 다시 시도하면 정상 로그인됩니다.

⛓️ 기존 기능에 미치는 영향

• 새 공개 경로 /v1/auth/login/*
• app-api가 core:domain:auth·core:domain:member에 의존합니다.
• 기존 JwtAuthFilter는 공개 경로라도 만료된 Authorization 헤더가 붙으면 401을 냅니다. 앱·웹은 로그인 요청에 토큰 헤더를 붙이지 않아야 합니다.

🔀 Edge Case & 실패 시나리오

상황	응답
요청 값 누락·PKCE 형식 위반	400 INVALID_INPUT
지원하지 않는 provider	400 UNSUPPORTED_OAUTH_PROVIDER
redirect URI가 허용 목록에 없음	400 REDIRECT_URI_NOT_ALLOWED
code 만료·재사용·verifier 불일치	401 INVALID_AUTHORIZATION_CODE
SW·AI 전공이 아님	403 DEPARTMENT_NOT_ALLOWED
KConnect 응답 없음·5xx	502 OAUTH_PROVIDER_UNAVAILABLE
KConnect 설정 오류(invalid_client, 설정 누락)	500

📋 검토한 대안과 선택 이유

• UseCase 전체에 @Transactional: provider 호출 동안 커넥션을 점유해 제외했습니다.
• 외부 호출 뒤 구간만 TransactionTemplate: 컨벤션에 없는 새 패턴이라 보류하고, 학번 조회로 복구하는 방식을 택했습니다.
• /v1/app/auth/...: 운영진 콘솔도 같은 로그인을 써서 공용 경로로 뒀습니다.

💬 리뷰 포인트

• 트랜잭션 경계와 연결 실패 시 복구 흐름
• 토큰 role 부여 규칙(ADMIN → ADMIN + STUDENT)
• 공개 경로 범위(/v1/auth/login/*)

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)

• main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository: billilge/stream-server/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: de1043fc-690e-41f3-a882-d75b623f0763

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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