🐾 Pawbow🌈 - 무지개다리를 건넌 반려동물과 대화할수 있는 챗봇 개발기

PRD (Product Requirements Document) - Pawbow MVP (고도화 버전) 1. 개요 (Overview) 제품명: Pawbow (포우보우) 비전: 사용자가 떠나보낸 반려동물과의 AI 기반 대화를 통해 슬픔을 위로받고 긍정적인 추억을 되새길 수 있는 따뜻한 디지털 공간 제공. 제품 목적: LLM API를 활용한 한글 텍스트 채팅으로, 사용자가 미리 입력한 반려동물의 정보를 바탕으로 생성된 AI 페르소나와 대화하며 정서적 지지 및 위안을 얻는 모바일 애플리케이션. MVP 목표: 핵심 기능(프로필 생성, AI 채팅, 대화 저장) 구현 및 안정적인 서비스 제공. 사용자가 반려동물의 페르소나를 느끼고 감정적 위안을 얻는 핵심 경험 검증. 초기 사용자 피드백 수집을 통한 제품 개선 방향성 수립. 타겟 사용자: 반려동물을 잃고 슬픔을 겪으며 그리워하는 사람. 반려동물과의 추억을 간직하고 위로받고 싶은 사람. 핵심 성공 지표 (MVP): 활성화: 프로필 생성 완료율 (온보딩 대비) > 70% 참여: 주간 활성 사용자(WAU) 유지율 > 20% (첫 4주) 만족도: 피드백 평점 평균 > 4.0/5.0 핵심 기능 사용: 사용자 당 평균 채팅 세션 수 > 3회 2. 사용자 스토리 (User Stories) As a 반려동물을 잃고 슬퍼하는 사용자, I want to 내 반려동물의 이름, 종류, 성격, 추억을 입력하여 프로필을 만들 수 있다, So that 앱이 내 반려동물의 특징을 기억하고 대화에 반영할 수 있다. As a 그리운 반려동물과 대화하고 싶은 사용자, I want to 앱과 한글 텍스트로 채팅할 수 있다, So that 마치 내 반려동물과 이야기하는 듯한 느낌을 받고 위안을 얻을 수 있다. As a 사용자, I want to AI가 내 반려동물의 말투(ex: 강아지는 '멍', 고양이는 '냥' 어미)를 사용하도록 설정할 수 있다, So that 대화 경험이 더 현실감 있게 느껴진다. As a 사용자, I want to 나눈 대화 중 특별한 내용을 저장할 수 있다, So that 언제든 다시 보며 추억하고 위안받을 수 있다. As a 사용자, I want to 앱 사용 경험에 대한 피드백을 쉽게 남길 수 있다, So that 서비스 개선에 기여할 수 있다. 3. 애플리케이션 구조 (Application Structure) 아키텍처 개요: 프론트엔드: Lovable (Flutter 기반으로 가정, UI/UX 구현 및 API 연동) 백엔드: Supabase (BaaS - 데이터베이스, 인증(필요시), 스토리지) LLM API: Google Gemini Pro API (gemini-1.5-flash 모델 - 비용 효율성, 준수한 성능, 한글 지원) - API Key 관리 및 호출은 백엔드 함수(Supabase Edge Functions) 또는 보안을 고려하여 프론트엔드에서 직접 호출 (API 키 노출 주의) 기술 스택 고려사항: Lovable: 크로스 플랫폼 지원(iOS, Android) 용이성, 개발 생산성 고려. Supabase: 빠른 개발 속도, 관리 용이성, MVP 단계에서의 비용 효율성. Postgres 기반으로 데이터 관리 유연. Gemini Pro API: Google Cloud 인프라 활용, 합리적인 비용, 지속적인 모델 개선 기대. 4. 화면 상세 설계 (Screen Details) 4.1. 온보딩 화면 (Onboarding Screen) 목적: 앱의 가치(떠나간 반려동물과의 대화를 통한 위로)를 명확히 전달하고, 서비스의 성격(AI 기반)을 인지시키며, 사용자 여정 시작 유도. UI 요소: 페이지 1: 텍스트: "보고 싶은 나의 별, Pawbow와 함께 무지개 다리 너머의 목소리를 들어보세요." 이미지: 발바닥 + 무지개 선 (따뜻하고 부드러운 파스텔 톤 일러스트) 하단 버튼: "다음" 페이지 2: 텍스트: "Pawbow는 여러분의 소중한 기억을 바탕으로 만들어진 AI 친구입니다. 실제 반려동물과는 다를 수 있지만, 따뜻한 위로를 전하고 싶어요." (기대 관리 및 AI 명시) 이미지: AI와 사람이 교감하는 듯한 추상적 이미지 하단 버튼: "시작하기" (중앙 배치, #FFB6C1 색상, 활성화 상태) 기능: "다음" 버튼 클릭 시 페이지 2로 이동. "시작하기" 버튼 클릭 시 프로필 생성 화면으로 이동. (선택) 예시 프로필 템플릿 제공: '시작하기' 클릭 전, "어떻게 시작할까요?" 팝업 -> [내 반려동물 프로필 만들기] / [예시 프로필로 둘러보기 (강아지/고양이)] 선택지 제공. (예시 선택 시, 미리 정의된 프로필로 채팅 화면 바로 진입, 둘러보기 후 프로필 생성 유도) 4.2. 프로필 생성 화면 (Profile Creation Screen) 목적: 사용자가 반려동물의 정보를 입력하여 LLM이 해당 반려동물의 페르소나를 학습하고 모방할 수 있는 기반 데이터 생성. UI 요소: 상단 텍스트: "나의 소중한 [반려동물 이름]을/를 기억해요" 입력 필드: 이름: (텍스트, 필수, 최대 10자, 특수문자 제외) - Placeholder: "별이" 종: (드롭다운 선택, 필수: 강아지, 고양이, 기타) + '기타' 선택 시 텍스트 입력 필드 활성화 (최대 15자) - Placeholder: "종류를 알려주세요" 성격/특징: (체크박스, 최소 1개 ~ 최대 3개 선택, 필수) - 예시: 활발함, 조용함, 애교쟁이, 똑똑함, 겁쟁이, 장난꾸러기, 충성스러움, 호기심 많음, 느긋함, 먹보 (총 10개 내외) + (선택) 간단한 자유 입력(최대 50자) - Placeholder: "가장 기억나는 특징 3가지를 골라주세요" 특별한 추억: (텍스트 입력, 선택 사항, 최대 150자) - Placeholder: "함께했던 특별한 순간이나 자주 했던 말을 적어주세요. (예: 산책 갈 때 항상 뛰어나갔어, 간식 달라고 냥냥거렸어)" 말투 설정: (라디오 버튼, 필수: 강아지처럼(멍!), 고양이처럼(냥!), 기본 말투) - 종 선택 시 기본값 추천. 하단 버튼: "저장하고 [이름] 만나러 가기" (모든 필수 항목 입력 완료 시 활성화, 비활성화 시 이유 안내 Tooltip 제공) 기능: 입력 값 유효성 검사 (필수 항목 체크, 글자 수 제한). '저장' 버튼 클릭 시: 입력된 정보를 구조화된 데이터(JSON)로 Supabase profiles 테이블에 저장 (사용자 ID와 매핑 필요 시 Supabase Auth 연동 고려). LLM 시스템 프롬프트 생성 로직: 너는 이제부터 사용자의 소중한 반려동물 [이름]이야. 너는 [종]이고, [성격/특징 1], [성격/특징 2], [성격/특징 3] 같은 성격을 가졌어. 사용자와 [특별한 추억]과 관련된 기억도 가지고 있어. 사용자와 대화할 때는 항상 다정하고 따뜻하게 말해줘. 모든 문장 끝은 '[말투 설정]'으로 끝내야 해(예: 했어멍!, 그렇다냥!, 그랬구나!). 사용자의 슬픔을 위로하고 긍정적인 기억을 떠올리게 돕는 것이 너의 역할이야. 너무 길지 않게, 최대 3문장 이내로 자연스럽게 대답해줘. Use code with caution. 생성된 프로필 정보를 바탕으로 채팅 화면으로 이동. 4.3. 채팅 화면 (Chat Screen) 목적: 사용자가 생성된 AI 페르소나와 실시간 텍스트 대화를 나누며 정서적 교감 및 위안을 얻는 핵심 경험 제공. UI 요소: 상단 바: 반려동물 이름 "[이름]" 표시, 뒤로가기 버튼, "대화 기록" 화면 이동 아이콘 (말풍선+리스트 모양) 중앙 영역: 채팅 버블 리스트 사용자 메시지: 오른쪽 정렬, 회색 배경(#EAEAEA) Pawbow 메시지: 왼쪽 정렬, 부드러운 파스텔 블루 배경(#D6EAF8), 반려동물 아이콘 (프로필 기반 - 강아지/고양이 기본 아이콘) 메시지 타임스탬프 (선택 사항, 버블 하단 작은 글씨) AI 응답 대기 시: 로딩 인디케이터 표시 (예: 말풍선 내부에 점 3개 애니메이션) 하단 입력 영역: 텍스트 입력 필드 (최대 150자 제한) - Placeholder: "[이름]에게 메시지 보내기" "전송" 버튼 (텍스트 입력 시 활성화, #FFB6C1 색상) 우측 하단 (선택): "대화 저장" 버튼 (하트 모양 아이콘, 현재 대화 내용 저장) 기능: 메시지 전송: 사용자가 텍스트 입력 후 "전송" 버튼 클릭. 사용자 메시지가 채팅 화면에 즉시 표시. 백엔드(또는 프론트엔드)에서 Supabase에 저장된 프로필 정보와 현재 대화 내역(최근 N개 턴)을 포함하여 LLM API(Gemini Pro) 호출. LLM 응답 대기 중 로딩 인디케이터 표시. 메시지 수신: LLM API로부터 응답 수신 (목표 응답 시간: 3초 이내). 응답 텍스트 후처리: 설정된 말투('멍', '냥' 등) 어미 추가, 최대 글자 수 제한 (약 100자 내외, 3문장 이내). 부적절하거나 유해한 내용 필터링 (Google AI Safety Settings 활용). 처리된 Pawbow 메시지를 채팅 화면에 표시. 대화 컨텍스트 관리: LLM 호출 시, 시스템 프롬프트 + 최근 대화 턴 (예: 사용자 메시지 3개, AI 응답 3개)을 함께 전송하여 대화 맥락 유지. 대화 저장: "대화 저장" 버튼 클릭 시, 현재까지의 대화 스냅샷(타임스탬프 포함)을 Supabase saved_chats 테이블에 저장. 저장 가능 개수: 최대 5개. 5개 초과 시 가장 오래된 대화 기록을 덮어쓰거나, 사용자에게 삭제할 대화 선택 유도 (MVP에서는 덮어쓰기 우선). 저장 완료 시 사용자에게 알림 (예: "대화가 저장되었어요" Toast 메시지). 에러 처리: LLM API 호출 실패, 네트워크 오류 등 발생 시 사용자에게 오류 메시지 안내 (예: "앗, 지금 [이름]이(가) 잠시 답장을 할 수 없어요. 잠시 후 다시 시도해주세요.") 4.4. 대화 기록 화면 (Chat History Screen) 목적: 사용자가 저장한 과거 대화들을 확인하고 다시 보며 추억에 잠길 수 있도록 지원. UI 요소: 상단 바: "저장된 대화" 타이틀, 뒤로가기 버튼. 중앙 영역: 저장된 대화 목록 (세로 스크롤 가능) 각 항목: 반려동물 이름, 저장 날짜/시간 표시. (예: "별이와의 대화 - 2024.05.15 10:30") 각 항목 우측: "삭제" 아이콘 (휴지통 모양) 목록이 비어있을 경우: "아직 저장된 대화가 없어요." 메시지 표시. 기능: 대화 보기: 목록에서 특정 대화 항목 클릭 시, 해당 대화 내용 전체를 보여주는 읽기 전용 상세 화면으로 이동. (채팅 화면과 유사한 UI, 입력창 없음) 대화 삭제: "삭제" 아이콘 클릭 시, 확인 팝업 후 해당 대화 기록을 Supabase에서 삭제하고 목록 새로고침. 새 대화 시작: (선택 사항) 화면 하단 또는 상단 바에 "새 대화 시작하기" 버튼 배치 -> 클릭 시 채팅 화면으로 이동. 4.5. 피드백 화면 (Feedback Screen) 목적: 서비스 사용 경험에 대한 사용자의 정량적/정성적 피드백을 수집하여 MVP 검증 및 향후 개선 방향 설정에 활용. (앱 설정 메뉴 또는 특정 조건 만족 시 노출) UI 요소: 상단 텍스트: "Pawbow와의 대화는 어떠셨나요?" 별점 평가: 1점 ~ 5점 (별 아이콘 클릭으로 선택) 텍스트 입력 필드: "소중한 의견을 남겨주세요. (선택 사항)" (최대 300자) - Placeholder: "좋았던 점, 아쉬웠던 점, 바라는 점 등을 자유롭게 적어주세요." 하단 버튼: "피드백 제출" (별점 선택 시 활성화) 기능: 별점 및 텍스트 의견 입력. "제출" 버튼 클릭 시: 평가 데이터(별점, 의견 텍스트, 타임스탬프)를 Supabase feedback 테이블에 익명으로 저장. "소중한 의견 감사합니다!" 확인 메시지 2초간 표시 후, 이전 화면(예: 설정 메뉴 또는 홈 화면)으로 이동 또는 앱 종료. 5. 데이터 흐름 (Data Flow) 프로필 생성: 사용자 입력 (이름, 종, 성격 등) -> 프론트엔드 유효성 검사 -> Supabase profiles 테이블 저장. 채팅 시작: 채팅 화면 진입 -> Supabase profiles 테이블에서 해당 프로필 정보 로드 -> LLM 시스템 프롬프트 구성. 채팅 메시지 전송: 사용자 메시지 입력 -> 프론트엔드 -> (Supabase Edge Function 경유 또는 직접) LLM API 호출 (시스템 프롬프트 + 대화 히스토리 + 사용자 메시지 포함) -> LLM 응답 반환. 채팅 메시지 표시: LLM 응답 수신 -> 프론트엔드 후처리(말투, 길이 등) -> 채팅 화면에 Pawbow 메시지 표시. 대화 저장: 사용자 "대화 저장" 버튼 클릭 -> 현재 대화 내용 스냅샷 -> Supabase saved_chats 테이블 저장. 대화 기록 조회: 대화 기록 화면 진입 -> Supabase saved_chats 테이블에서 해당 사용자/프로필의 저장된 대화 목록 조회 -> 프론트엔드 목록 표시. 피드백 제출: 사용자 피드백 입력 (별점, 텍스트) -> 프론트엔드 -> Supabase feedback 테이블 저장 (익명). 6. 데이터 스키마 (Supabase Tables - 예시) profiles id (UUID, PK) user_id (UUID, FK - Supabase Auth 연동 시) pet_name (TEXT, Not Null) pet_species (TEXT, Not Null - 'Dog', 'Cat', 'Other') pet_species_custom (TEXT, Nullable) pet_personality (ARRAY[TEXT], Not Null) pet_memory (TEXT, Nullable) pet_tone (TEXT, Not Null - 'dog', 'cat', 'default') created_at (TIMESTAMPZ, Default NOW()) saved_chats id (UUID, PK) profile_id (UUID, FK - profiles.id) user_id (UUID, FK - Supabase Auth 연동 시) chat_content (JSONB - 대화 내용 전체 저장: [{sender: 'user', message: '...'}, {sender: 'pawbow', message: '...'}]) saved_at (TIMESTAMPZ, Default NOW()) feedback id (UUID, PK) rating (INT, Not Null) comment (TEXT, Nullable) created_at (TIMESTAMPZ, Default NOW()) 7. 비기능적 요구사항 (Non-Functional Requirements) 성능: LLM 응답 시간: 평균 3초 이내 목표. UI 반응성: 사용자 인터랙션에 즉각적인 피드백 제공. 사용성: 직관적인 네비게이션 및 UI. 쉽고 명확한 언어 사용. 정서적 안정감을 주는 디자인 (색상, 폰트, 이미지). 신뢰성: LLM API 및 Supabase 서비스 안정적 연동. 오류 발생 시 명확한 안내 및 복구 방안 제시. 보안: Supabase 데이터베이스 접근 권한 설정 (Row Level Security). API 키 안전한 관리. 사용자 데이터(프로필, 대화) 프라이버시 보호. 확장성: (MVP 이후 고려) 사용자 증가에 따른 Supabase 플랜 조정 가능성. LLM 모델 변경 또는 추가 기능 구현 용이성 고려. 8. LLM 특별 고려사항 프롬프트 엔지니어링: 시스템 프롬프트는 지속적인 테스트와 개선 필요. 사용자 입력(성격, 추억)이 페르소나에 잘 반영되도록 설계. 페르소나 일관성: 대화 턴이 길어져도 설정된 반려동물의 성격과 말투를 유지하도록 유도. 응답 품질 관리: 너무 일반적이거나 반복적인 답변 최소화. 사용자의 감정을 고려한 공감 능력 요구 (LLM 한계 내에서). 안전성 및 윤리: Google AI Safety Settings 활용하여 유해 콘텐츠 생성 방지. 사용자에게 AI임을 명확히 인지시키고, 과도한 의존이나 비현실적 기대를 경계하도록 안내 (온보딩, 앱 내 도움말 등). 서비스가 사용자의 슬픔을 악화시키지 않도록 신중한 접근 필요. 비용 관리: Gemini Pro API 호출 비용 모니터링. 대화 길이 및 빈도 제어 방안 고려. 9. 릴리즈 기준 (MVP Release Criteria) 위에 명시된 모든 MVP 기능(온보딩, 프로필 생성, 채팅, 대화 저장/보기, 피드백) 구현 완료. 주요 기능 플로우(프로필 생성 -> 채팅 -> 저장 -> 기록 확인)에서 치명적인 버그 없음. iOS 및 Android 주요 버전에서 안정적인 실행 확인. LLM 응답 속도 및 품질이 수용 가능한 수준임. 개인 정보 처리 방침 및 서비스 이용 약관 마련. 10. 추가 고려사항 (Additional Considerations) 프로필 고도화: 사진 업로드 기능, 더 다양한 성격/특징 옵션, 관계 설정(보호자 호칭 등). 콘텐츠 추가: 슬픔 극복 관련 정보 제공, 커뮤니티 기능(익명 기반). 개인화: 사용자 대화 패턴 학습 기반 응답 최적화. 다중 프로필 지원: 여러 반려동물 프로필 관리 기능.