Skip to content

[Feat/#229] 챗봇 답변의 출처 링크로 공지·행사 상세 이동과 돌아올 때 대화 복원 - #230

Open
overhyeon wants to merge 2 commits into
mainfrom
feat/#229-chat-source-link
Open

overhyeon wants to merge 2 commits into
mainfrom
feat/#229-chat-source-link

Conversation

@overhyeon

Copy link
Copy Markdown

#️⃣연관된 이슈

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

챗봇이 공지·행사를 근거로 답하면, 마지막 줄에 출처: [사물함 추가 신청 안내](/notices/11) (2026-11-14)처럼 마크다운 링크를 보내요(billilge/stream-ai#82). 지금 말풍선은 **굵게**만 처리해서 이 링크가 [...](/notices/11) 글자 그대로 보여요.

❓ 왜 해결해야 하나요?

학생이 답을 보고 원문 공지를 바로 확인할 수 있어야 해요. 특히 학사·신청 기간처럼 틀리면 피해가 큰 정보는 챗봇이 "원문을 확인해 주세요"로 안내하는데, 그 원문으로 가는 길이 없었어요.

⭐ 어떻게 해결했나요?

1. 링크 렌더링 (ChatBotMessageBubble.tsx)

  • [글자](/경로)를 react-router <Link viewTransition>으로 그려요. 공지 목록에서 상세로 갈 때와 같은 앱 안 이동이에요.
  • 앱 웹뷰에서도 웹 안에서 화면만 바뀌어요. 그래서 stream-client-app의 외부 링크 처리(handleShouldStartLoad)에 걸리지 않고, 안드로이드 뒤로 버튼으로 돌아올 수 있어요.
  • 링크 글자와 링크 바깥 글자 모두 **굵게**를 그대로 처리해요.

2. 돌아오면 대화 복원 (utils/chatSnapshot.ts, useChatStream.ts, ChatEntryScreen.tsx)

  • 대화는 화면 상태라, 링크로 상세에 갔다가 돌아오면 사라져요. 그래서 링크를 누르기 직전에 대화를 sessionStorage에 맡겨 두고, 뒤로 돌아오면 되살린 뒤 지워요.
  • 저장 키에 location.key를 붙였어요.
    • 뒤로 돌아오면 떠날 때와 같은 key라 대화가 되살아나요.
    • 홈에서 챗봇을 새로 열면 새 key라 지금처럼 새 대화예요. "들어올 때마다 새 대화"라는 기존 동작은 그대로예요.
  • conversationId도 같이 되살려요. 돌아와서 이어 묻는 질문도 서버가 앞 대화 이력을 붙여요.
  • 읽기와 지우기를 나눴어요. StrictMode가 useState 초기값 함수를 두 번 불러서, 읽으면서 지우면 두 번째 호출이 빈 값을 받기 때문이에요. 지우기는 useEffect에서 해요.

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

  • 답변을 받는 중에 링크를 누르면 받다 만 답변이 그대로 보관돼요. 출처 줄은 답변의 맨 끝에 오니까, 링크가 보일 때는 답변이 거의 끝난 상태예요. 그래서 따로 막지 않았어요.
  • 스트리밍 중 )가 아직 안 온 링크는 잠깐 [제목](/noti처럼 글자로 보였다가, 닫히는 조각이 오면 링크로 바뀌어요.
  • 링크 스타일은 Figma 시안이 없어서 밑줄만 넣었어요(색은 본문과 같아요). 디자인이 정해지면 바꿀게요.

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

  • 챗봇 화면만 바뀌어요. useChatStream에 restored 옵션(선택)이 생겼고, 반환 값에 conversationId가 추가됐어요.
  • 링크가 없는 답변은 이전과 똑같이 그려져요.

🔀 Edge Case & 실패 시나리오

  • 모델이 외부 주소를 쓴 경우: /로 시작하는 앱 안 경로만 링크로 만들어요. https://..., //다른사이트, javascript:는 글자 그대로 보여요. 답변은 모델이 쓴 글이라 눌리는 외부 링크가 섞이면 안 돼요.
  • sessionStorage를 쓸 수 없는 환경(시크릿 모드 등): 경고 로그만 남겨요. 돌아왔을 때 새 대화가 될 뿐 이동은 정상이에요.
  • 저장된 값의 모양이 다를 때(이전 버전이 쓴 값 등): zod로 검사해서 안 맞으면 새 대화로 시작해요.

📋 검토한 대안과 선택 이유

  • AI 서버가 event: source로 출처를 따로 보내는 방식: 카드로 예쁘게 그릴 수 있어요. 대신 백엔드 중계(StreamAiChatClient)가 모르는 이벤트를 버리고 있어서 세 저장소를 다 고쳐야 해요. 슬랑제(11/21) 전이라 마크다운 링크를 골랐어요.
  • 대화를 history.state에 넣는 방식: 링크를 누를 때마다 지금 항목을 replace로 한 번 더 바꿔야 해서 이동이 두 번 일어나요. sessionStorage는 탭(웹뷰)을 닫으면 사라지는 것도 장점이에요.

💬 리뷰 포인트

  • [c] 링크 스타일(밑줄만)이 괜찮은지 봐 주세요.
  • [c] location.key로 새 대화와 돌아온 대화를 가르는 방식이 다른 화면 흐름과 어긋나지 않는지 봐 주세요.

확인한 것

  • pnpm check: 통과(경고 1건은 기존 src/main.tsx), pnpm build: 통과.
  • 개발 서버에서 챗봇 응답을 가짜로 꾸며 확인했어요(fetch 가로채기).
    • 출처 링크만 밑줄 링크가 되고, https://·// 주소는 글자 그대로였어요.
    • 링크를 누르면 /notices/11로 이동하고, 뒤로 가면 대화가 그대로 되살아났어요. 보관본은 지워졌어요.
    • 돌아와서 이어 물은 질문이 같은 conversationId로 갔어요.
  • 실제 앱(웹뷰)과 dev 서버 실데이터로는 아직 확인하지 않았어요.

@overhyeon overhyeon self-assigned this Nov 16, 2026
@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

  • Trigger review

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

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 49664711-2074-48eb-b30c-741c23be138e
  • 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

챗봇 답변의 출처 링크를 눌러 공지·행사 상세로 이동

1 participant