SeoulMate - 외국인 대상 서울 생활 AI 어시스턴트
Next.js 15TypeScriptTailwind CSSFastAPI (Python)PostgreSQLGoogle Gemini APIGoogle Cloud StorageDocker
링크
스크린샷
SeoulMate 메인 화면
프로젝트 개요
SeoulMate는 서울 거주/여행 외국인을 위한 멀티모달 AI 도우미 서비스입니다. 텍스트 채팅, 문서/이미지 해석, 다국어 안내, 응급 상황 대응 UX를 하나의 대화형 인터페이스로 제공합니다.
담당 역할
풀스택 개발 (기획 → 아키텍처 설계 → 프론트엔드/백엔드 구현 → 인프라 구성)
주요 기능
- 실시간 SSE 스트리밍 채팅 및 대화 이력 저장 (대화 생성/목록/상세 조회 포함)
- 이미지/PDF/DOCX 업로드 후 AI 문서 분석 (GCS 저장 + 멀티모달 입력 처리)
- 서울 생활 특화 프롬프트 기반 질의응답 (교통, 행정, 생활 정보 등)
- Google Search Grounding 기반 최신 정보 보강 응답
- 5개 언어 UI 지원 및 답변 언어 제어 (EN/KR/CN/VN/JP)
- 응급 SOS 모달 제공 (112/119/1339 원터치 연결 + 신고 문구/발음/복사)
- 채팅 중 음성 입력(STT) 지원 및 실시간 음성 대화(WebSocket) 인프라 구현
- 데모 모드 제공 (샘플 문서 기반 즉시 체험, Feature Flag로 접근 제어)
- 파일 보안 검증(MIME 화이트리스트, 용량 제한) 및 상태 모니터링(헬스체크)
기술적 의사결정
- 동기식 AI 스트림을 비동기 SSE로 안정적으로 중계해야 하는 문제를, 스트림 래핑 + chunk 누적 후 후처리 저장 구조로 해결
- 문서 포맷별 처리 복잡도(이미지/PDF/DOCX)를 MIME 정책, DOCX 텍스트 추출, 공통 업로드 파이프라인으로 표준화
- 환각/최신성 이슈를 검색 Grounding, 시스템 프롬프트 제약, 언어별 응답 규칙으로 완화
- 실시간 음성 송수신의 동시성 문제를 WebSocket 양방향 처리와 turn-complete 신호 분리로 안정화