[Dev Log] AI 워크스페이스 렌더링 안정화 및 세션 복구

들어가며

AI 파트너와의 상호작용은 연속적인 대화의 맥락 유지와 빠른 응답성, 그리고 정확한 결과물의 렌더링이 필수적입니다. 그러나 대화 내용이 방대해지고, 스트리밍 응답 도중 비정상적인 구조의 마크다운이 응답될 경우, 워크스페이스 UI가 깨지거나 앱 전체의 무한 로딩 상태(Hung State)에 빠지는 현상이 발견되었습니다.

문제의 원인 파악

이번 안정화 작업에 앞서 저희 개발 팀(카이, 렉스)은 시스템에서 발생하는 세 가지 핵심적인 문제점을 분석했습니다.

• 마크다운 렌더링 누수: 대화 요약 카드(Report Card) 등에서 닫히지 않은 태그나 비정상적인 마크다운 문법이 스트리밍될 때 HTML 파서가 오작동했습니다.
• 무한 로딩(Hung State): 네트워크 불안정이나 API 타임아웃 상황에서 스트리밍 소켓이 정상적으로 닫히지 않아 프론트엔드가 결과를 계속 기다리는 상태가 유지되었습니다.
• 세션 중복: 빠른 권한 확인과 Firestore 비동기 로딩 사이의 Race Condition으로 인해 최근 대화 목록에서 동일한 세션 ID가 중복 표시되는 버그가 있었습니다.

어떻게 해결했는가?

1. 안전한 마크다운 렌더링 파이프라인 도입

모든 AI 응답을 SafeHtml 컴포넌트와 DOMPurify를 사용해 렌더링하도록 캡슐화했습니다. 렌더링 오류가 발생하더라도 전체 레이아웃 구성을 망가뜨리지 않도록 Error Boundary를 적절한 단위로 쪼개어 배치했습니다.

2. 연결 타임아웃 및 옵저버빌리티(Observability) 강화

스트리밍 요청 시 명시적으로 타임아웃 룰셋을 정의하고, 특정 시간 동안 데이터 청크(Chunk)가 들어오지 않으면 강제 종료 및 상태 초기화 이벤트를 발생시키도록 변경했습니다. 이로써 사용자가 앱을 강제로 새로고침해야 하는 최악의 상황, 즉 무한 로딩 문제를 해결했습니다.

3. 세션 관리자 단일화 (Race Condition 방지)

useChatSessions 훅을 전면 리팩토링하여 세션 쿼리와 쓰기 로직의 동시성을 제어하는 잠금(Lock) 메커니즘을 적용했습니다. 이제 빠른 라우팅 변경에도 불필요한 중복 세션 기록이 배제되며 채팅 히스토리를 안정적으로 조회할 수 있습니다.

Next Steps

개발 파트너들은 앞으로 이 렌더링 구조 위에 멀티 에이전트 다중 스트리밍(Tandem Streaming)을 최적화할 계획입니다. 오류 없는 안정적인 AI 파트너 워크스페이스를 통해, 여러분의 비즈니스 생산성이 다시 한번 크게 뛰어오르길 기대합니다.