[overhyeon]

#️⃣연관된 이슈

• Closes 챗봇 중계 시 학생 JWT를 AI 서버에 함께 전달 #309

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

챗봇의 빌릴게 재고 조회가 아직 AI 서버 안의 가짜 데이터다. 백엔드 API는 모두 학생 JWT가 있어야 부를 수 있고, AI 서버 전용 API는 없어서 AI 서버가 실데이터를 읽을 길이 없다.

❓ 왜 해결해야 하나요?

발표 시나리오의 "실시간 조회" 장면을 실데이터로 보여줘야 한다. 이후 "내 대여" 같은 개인 조회와 에이전트 기능도 같은 길을 쓴다.

⭐ 어떻게 해결했나요?

중계할 때 그 학생의 JWT를 X-User-Token 헤더로 AI 서버에 함께 보낸다. AI 서버는 이 토큰으로 기존 학생 API(GET /v1/app/billilge/items)를 조회만 한다.

• StreamAiChatClient가 현재 요청의 Authorization: Bearer ...에서 토큰을 꺼내 헤더로 싣는다. 없으면 헤더를 생략한다
• 요청 헤더를 읽기 위해 infrastructure:client에 jakartaServletApi 의존성을 추가했다 (gateway:logging과 같은 방식)

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

• 토큰을 인자로 넘기지 않고 RequestContextHolder로 요청에서 직접 꺼낸다. 숨은 의존이라 주석으로 이유를 남겼다. 중계를 비동기로 바꾸면 요청이 보이지 않아 토큰 없이 나간다
• 학생 JWT는 권한을 나눌 수 없어, AI 서버는 기술적으로 그 학생의 쓰기 권한까지 받는다. "조회만"은 AI 서버 코드로 지킨다(AI 서버에 쓰기 호출 코드를 두지 않는다)

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

• 중계 요청에 헤더 하나가 추가될 뿐이다. 지금 배포된 AI 서버는 모르는 헤더를 무시하므로 이 PR만 먼저 머지해도 챗봇은 그대로 동작한다
• 도메인(ChatService, ChatClient) 시그니처는 바뀌지 않는다

🔀 Edge Case & 실패 시나리오

• 요청 컨텍스트가 없거나 Bearer 형식이 아니면 헤더 없이 보낸다. AI 서버는 재고를 "확인할 수 없어요"로 답한다
• 토큰 원문은 로그에 남기지 않는다

📋 검토한 대안과 선택 이유

• 인자로 컨트롤러 → ChatService → ChatClient까지 넘기기: 흐름은 보이지만 5개 파일을 고치고 도메인 인터페이스가 토큰을 알게 된다(config-and-auth.md 4-4절과 어긋남)
• 챗봇 전용 장기 토큰 발급: 새면 막으려면 JWT 비밀키를 바꿔 전원 로그아웃해야 하고, 개인 조회가 불가능하다
• AI 서버 전용 내부 API(api/ai-api): 정석이지만 새 모듈·보안 설정이라 발표 전에는 무겁다

💬 리뷰 포인트

• [c] RequestContextHolder로 꺼내는 방식이 괜찮은지
• 확인: :infrastructure:client:compileJava, ModularityTests, DomainImplAccessTests 통과
• AI 서버 쪽 PR: billilge/stream-ai ([Feat/#68] 빌릴게 물품·대여 이력·반납 필요 조회 API 추가 #69)

[coderabbitai]

Important

• Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

• Source mode: Auto
• Repository: billilge/stream-server
• Branch: main
• File: .coderabbit.yaml
• Commit: 206e3ad
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 38f0fbae-53f3-451b-92f5-8e66d7055067

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn