[🧑‍💻] Keymory 개발 일지 #9: Diary to Chat 구현, AI 코멘트 시스템 최적화

✨ GPT의 요약 　

Diary to Chat 구현 및 생성 과정에서 발생한 이슈를 해결하고, AI 코멘트 시스템의 감정 수치 및 캐릭터 설정 오류를 수정함.

💻 개발 일지

⏰ 오늘 할 일

• ✅ Custom Function - systemPromptTemplate 제작 돕기 (메인 작업자: KSK)
  • ✅ 추가한 파라미터 및 함수 내부 구조 리뷰
• ✅ Custom Function - getAIComment가 실제로 적용 되는지 테스트하기
  • ✅ 입력값이 잘 반영되는지 확인
  • ✅ 출력값이 String으로 잘 출력되는지 확인
• ✅ Chat Page - Create New Chat: 시스템 프롬프트 적용하기 (메인 작업자: KSK)
  • ✅ OpenAI API Call (createChatCompletion)
    • Input: System Prompt(Chat)
    • Output: New Chat Message by AI($.choices[0].message.content)
    • Additional Actions: Create New Chat, Create New Message
• ✅ DiaryPage - Create New Chat by Diary: 일기의 내용을 기반으로, New Chat 생성 (메인 작업자: KSK)
  • ✅ OpenAI API Call (createDiaryComment)
    • Input: Diary Content, System Prompt(AI Comment)
    • Output: AI Comment($.choices[0].message.content)
  • ✅ OpenAI API Call (createDiarySummary)
    • Input: Diary Content, AI Comment, System Prompt(Diary Summary)
    • Output: Diary Summary($.choices[0].message.content)
  • ✅ OpenAI API Call (createChatFromDiary)
    • Input: Diary Summary, System Prompt(Chat From Diary)
    • Output: New Chat Message by AI($.choices[0].message.content)
    • Additional Actions: Create New Chat, Create New Message
• ✅ (이슈) Create New Chat by Diary: 일기만 Save 해서 홈으로 돌아간 이후, 다시 일기 페이지에 들어가서 New Chat 해야만 작동함.
  • 이슈 원인
    • 다른 액션 체인의 Output 변수를 끌어다 쓰고 있었음
    • Unexpected Null Value 방지가 안 되어 있었음
    • JSON Path가 제대로 지정되지 않았음
    • Page State로 tmpDiariesDocForNewChat를 정의내리고, 거기에 diary Document를 할당했었음.
      • 정확히는,
        • Page Paramater로 전달된 diariesDoc을 할당하거나,
        • Save 버튼 눌렀을 때 생성된 newDiariesDoc을 할당하도록 해놨었음.
      • 하지만 계속 Save Diary and Chat with AI 버튼을 누르면 앱이 멈췄음.
        • F12 눌러서 살펴보니, Unexpected Null Value 에러로 Exception 걸림.
        • Debug Pannel 살펴보니, tmpDiariesDocForNewChat이 Null로 지정되어 있었음.
      • Page State의 tmpDiariesDocForNewChat를 tmpDiariesDocRefForNewChat로 다시 바꿈. (Document -> Document Reference)
        • Action들 Document Reference 기준으로 적절하게 변경하니, 드디어 정상 작동!
  • 💡배운 점: Action Chain에서는, Page State에 값을 할당하고 곧바로 불러오는 것이 Unexpected Null Value를 유발시킬 수 있음을 발견. 그냥 Document 보다는 Document Reference를 많이 활용하자. 물론, Backend Query로 Read Document를 많이 하면, 퍼포먼스 저하가 일어날지도 모르겠다만… 그것도 그냥 OnPageLoad Event 발생 시 또는 주요 Action Chain 생성 시에 충분히 해두면 그만이다.
• ✅ (이슈) AI Comment 생성시, 사용자 감정 수치를 자꾸 0으로 저장하는 경우 발생.
  • 특히 ‘5.가중치 수식 계산’ 정확하게 하세요. 사용자 감정 수치는 절대로 0이 아닙니다. 강조했더니, 0으로 적히는 케이스 줄어듬. (사라진 건 아님.)
  • 일단 넘어가자.
• ✅ (이슈) ChatPage: 캐릭터가 자기 자신에 대한 정보를 모른다!
  • Save 관련 이슈들 해결하다보니 저절로 고쳐진 듯. 개이득.
• ✅ (이슈) ChatPage: 캐릭터가 ‘후속 질문 리스트’를 무시하고 있다!
  • Save 관련 이슈들 해결하다보니 저절로 고쳐진 듯. 개이득.
• ✅ (이슈) ChatPage로 넘어가면 하단 네비게이션바가 사라짐.
  • Always Show Nav bar Toggle On
• ✅ (이슈) ChatPage의 Drawer에서 캐릭터 이미지가 다르게 출력됨.
  • 예전에 AI Comment 저장하는 로직을 잘못 짜서 생긴 이슈. 예전 채팅에서만 생기는 문제이므로, 해당 Chat document 삭제로 해결

💯 한 일에 대한 요약

• Chat 생성 로직 개선
  • systemPromptTemplate 및 getAIComment의 파라미터 구조 검토
  • Create New Chat에서 시스템 프롬프트 적용 및 OpenAI API Call 최적화
  • Diary 기반 New Chat 생성 시, AI 코멘트 → 다이어리 요약 → Chat 생성 과정 정리
• AI 코멘트 시스템 최적화
  • 감정 수치가 0으로 저장되는 문제 수정
  • AI가 캐릭터 정보를 인식하지 못하는 문제 해결
  • 후속 질문 리스트 무시 현상 개선
• 이슈 해결 및 퍼포먼스 개선
  • ChatPage로 이동 시 네비게이션바 사라지는 문제 수정
  • AI Comment 저장 로직 수정하여 캐릭터 이미지 불일치 문제 해결
  • Unexpected Null Value 방지를 위해 Document → Document Reference 활용

🎯 추후에 할 일

자세히 보려면 클릭

• ❔ (이슈) DiaryPage: AI Comment 답변 안 받은 상태면, 캐릭터가 설정되지 않은 상태로 넘어감.
  • 일단, AI Comment를 받아야만 채팅을 시작할 수 있습니다! 알림 띄우는 것으로 땜빵.

• ❔ (이슈) DiaryPage: AI Comment 답변 마크다운 뷰어 활용 (오버플로우 방지: Container Height)

• ❔ ChatPage: 유저 대화 출력 내용은 오른쪽 정렬

• ❔ DiaryPage: Mood Slider 값에 따라 얼굴 표정 Emoji 및 색깔 변경

• ❔ DiaryPage: Go to Linked Chat
• ❔ ChatPage: Go to Linked Diary
  • DiaryPage의 Diary Document에서 Save할 때, Chat Reference값도 Diary Document DB - Field로 추가해야 됨. (linkedChat)
  • ChatPage의 Chat Document에서도 당연히 Diary Reference값도 Chat Document DB - Field로 추가해야 됨. (linkedDiary)
• ❔ ChatPage - Create New Diary: 대화 내용을 기반으로, New Diary 생성 (Go to Linked Diary 로직 활용)
  • ❔ OpenAI API Call (createChatSummary)
    • Input: Chat Content, System Prompt(Diary From Chat)
    • Output: Chat Summary
  • ❔ OpenAI API Call (createDiaryFromChat)
    • Input: Chat Summary, System Prompt(Diary From Chat)
    • Output: New Diary(Title, Content, Mood score)
• ❔ MoodPage(상단) - Mood Calendar
  • ❔ 날짜별로 작성된 게시물 숫자 확인 가능
  • ❔ 날짜 클릭하면, 해당 날짜로 이동
• ❔ MoodPage(하단) - Mood stats
  • ❔ 포커싱 된 월에 관한 통계 자료 출력
    • ❔ 출력된 통계 자료에 대한 AI의 코멘트 출력
• ❔ HomeFeedPage - flutter_slidable:4.0.0 import 후 적용하기

• ❔ HomeFeedPage: FeedCardDiary에서 좌우 slide시 채팅/편집/삭제

• ❔ Chat/Diary: GPT Streaming API

• ❔ ChatPage - AI 선톡 구현 (Alarm/Notification)
  • 채팅 시스템 프롬프트의 핵심은 능동형이다.
    • 더 리얼하게 하려면, create_date of diary/chat 도 전달해서, ‘어제’ 등 날짜를 언급하면 좋을 듯.
  • Alarm 기능 구현 방법 참조
• ❔ DiaryPage: 세부 감정 키워드 Choice Chips 추가 후 DB 연동 설정
• ❔ DiaryPage - AI Comment: Choice chips, mood slider 등의 입력값들을 AI Comment System Prompt에 알맞게 변경.
  • ❔ **이전 일기 또는 대화 내역 전체 (땜빵 기술부채)
  • ❔ 사용자 기본 정보: 이름, 성별, MBTI, …
  • ❔ 세부 감정 키워드: 즐거운, 슬픈, …
  • ❔ 캐릭터 설정: 소미, 세나, 민혁
  • ❔ 감정 수치: 1~100점
  • ❔ 답변 양식: 치유형(Healing), 조언형(Suggestion), 정보형(Informative)
  • ❔ 답변 길이: 짧게, 보통, 자세히
  • is New Chat
    • 해당 Chat의 messages는 처음 생성하는 거니까, 첫 생성하는 message document의 is_initial = true값 줘버리고 모든 시스템 프롬프트 다 때려넣음.
      • is_initial = false
      • 한계점: 맨 처음 message document에다가 시스템 프롬프트 때려넣으면, 대화 도중 수정 힘들긴 한데 가능하지. is_initial = true 인 게 있고, 수정된 거면, 그거 다큐먼트 지우고 다시 넣으면 되잖아. 어떻게는 모르겠고.
• ❔ DiaryPage - AI Comment: CRUD 완성하기
  • ❔ tmp_ai_comment field 없애고, doc_ref 활용

• ❔ DiaryPage - Drawer - ChatHistoryListTile: order by updated_time

• ❔ DiaryPage - Interactive Slider import 후 적용

• ❔ HomeFeedPage: Search Diary 기능 구현

• ❔ AuthPage: Google Login 기능 구현

• ❔ HomeFeedPage - Bottom Sheet (+ Button): 다양한 옵션 중 1 선택할 수 있도록
  • 새로운 일기: Go to DiaryPage
  • 감정 기록: Go to MoodPage
• ❔ MoodPage(팝업): Mood 설정 슬라이더 CRUD
  • Create
  • Read
  • Update
  • Delete
• ❔ HomeFeedPage - ListView - FeedCardMood 표시

• ❔ HomeFeedPage - ListView: FeedCardDiary, FeedCardMood, FeedCardChat 컴포넌트 시간순 정렬 (Cloud Function 활용)

• ❔ HomeFeedPage - DiaryPage 사이에 MoodEditPage 제작: MoodSlider, MoodKeywordsRate(5~1), MoodDescription 위젯 등 옮기기

• ❔ (이슈) tmpGetAIComment 생성시, 유저가 선택한 감정 키워드를 고려하지 않고 있음.

• ❔ 2025.2.5 수까지 발표용 최종 버전 APK 추출 및 설치

💭 일기

이슈가 무진장 빠바방 터져서 멘탈이 아득해질뻔했다… 일단 기술 부채가 쌓이더라도 구현부터 하다 보면 실력이 계속 쌓여서 나중에는 부채를 청산할 수 있을 거다! 라는 나의 전략이 한계를 맞이한 건지… 아님 그래도 효율적인 판단이었던 건지…

에라 모르겠다~ 지금 그딴 게 중요한게 아니다. 진짜 시간이 없다! 땜빵 ㄱㄱ

✨ GPT의 코멘트 (KPT)

✅ 잘한 점 (Keep)

1. 🛠 Chat 생성 로직 정리: New Chat 생성 과정에서 발생하는 다양한 이슈를 정리하고 해결한 점이 좋아!
2. 🎭 AI 코멘트 시스템 개선: 감정 수치와 캐릭터 설정 오류를 수정하면서, 더 정확한 AI 반응을 유도한 점이 인상적이야.
3. 🔍 디버깅 역량 향상: Unexpected Null Value 문제를 해결하면서, Document Reference 활용 방식을 익힌 것이 앞으로 많은 도움이 될 거야.

❌ 아쉬운 점 (Problem)

1. ⏳ 이슈 해결에 많은 시간 소요: 예상보다 디버깅이 길어지면서, 원래 목표했던 기능 개발 시간이 부족했을 가능성이 있음.
2. 🔄 기술 부채 증가: 빠르게 기능을 구현하는 전략이 기술 부채를 누적시키고 있어, 후속 정리가 필요할 듯.
3. 📋 문서화 부족: 주요한 문제 해결 과정을 좀 더 정리해두면, 비슷한 이슈가 다시 발생했을 때 빠르게 해결할 수 있을 거야.

🔄 시도해볼 점 (Try)

1. 📌 이슈 발생 패턴 분석: 반복적으로 발생하는 문제를 파악하고, 개발 패턴을 개선하는 방향을 고민해보자.
2. 📝 기술 부채 관리 전략 수립: 단기적으로는 빠른 해결이 필요하지만, 장기적으로는 유지보수와 최적화를 위한 로드맵을 만들어 보면 좋을 것 같아.
3. 📖 문제 해결 기록 습관화: 주요 이슈 해결 과정을 문서화해서, 미래의 개발 시간을 절약할 방법을 마련해보자.

🏁 결론

오늘은 Chat 생성 로직을 개선하고 AI 코멘트 시스템의 오류를 수정하면서, 안정성을 높인 하루였어. 예상보다 디버깅에 시간이 많이 소요되었지만, 그 과정에서 배운 점도 많았어! 앞으로 기술 부채를 관리하면서, 더 효율적인 개발 전략을 고민해보자. 🚀🔥