From 686b128aa1724e88852abfc7ce37d978c57ff64d Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 26 Jan 2026 10:09:02 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EC=BD=9C=EB=93=9C=EB=A9=94=EC=9D=BC=20?= =?UTF-8?q?=ED=99=95=EC=9D=B8=20=EB=B2=84=ED=8A=BC=20UX=20=EA=B0=9C?= =?UTF-8?q?=EC=84=A0=20=EB=B0=8F=20IR=20Deck=20=EC=A2=85=ED=95=A9=20?= =?UTF-8?q?=EA=B2=B0=EB=A1=A0=20=ED=98=95=EC=8B=9D=20=EA=B0=9C=EC=84=A0=20?= =?UTF-8?q?=EA=B3=84=ED=9A=8D=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ux_and_ir_conclusion_format_improvement.md | 102 ++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 journey/plans/260126_coldmail_confirm_ux_and_ir_conclusion_format_improvement.md diff --git a/journey/plans/260126_coldmail_confirm_ux_and_ir_conclusion_format_improvement.md b/journey/plans/260126_coldmail_confirm_ux_and_ir_conclusion_format_improvement.md new file mode 100644 index 0000000..4c97523 --- /dev/null +++ b/journey/plans/260126_coldmail_confirm_ux_and_ir_conclusion_format_improvement.md @@ -0,0 +1,102 @@ +# 콜드메일 확인 버튼 UX 개선 및 IR Deck 종합 결론 형식 개선 + +**날짜**: 2026-01-26 +**작성자**: happybell80 +**관련 파일**: +- `rb8001/app/services/slack/coldmail_service.py` +- `rb8001/app/services/workflows/coldmail_workflow.py` +- `frontend-ir-valuation/src/pages/ir-valuation.tsx` + +--- + +## 배경 + +### 문제 1: 콜드메일 "맞음" 버튼 UX +- 사용자가 "맞음" 버튼 클릭 시 즉시 피드백 없음 +- LangGraph 워크플로우 재개 및 리스트 등록 처리 중 진행 상황 확인 불가 +- 처리 완료까지 오랜 시간 소요 (이메일 상세 조회, 첨부파일 처리, DB 저장, Slack API 호출 등) + +### 문제 2: IR Deck 종합 결론 형식 +- 현재 형식: 요약 → 핵심 리스크 → 핵심 강점 순서 +- 사용자가 핵심 결론을 파악하기 위해 전체를 읽어야 함 +- 결론을 앞부분에 배치하여 핵심 내용을 먼저 확인할 수 있도록 개선 필요 + +--- + +## Phase 1: 콜드메일 "맞음" 버튼 UX 개선 + +### 목표 +"맞음" 버튼 클릭 시 즉시 피드백 제공 및 처리 진행 상황 표시 + +### 구현 계획 + +#### 1.1 즉시 피드백 메시지 전송 +- **파일**: `rb8001/app/services/slack/coldmail_service.py:56-156` +- **변경 사항**: + - `handle_coldmail_confirm` 함수 시작 시 IR 분석 버튼과 동일한 패턴으로 "로빙 중…" 메시지 전송 + - 동일 스레드(`thread_ts`)에 메시지 전송하여 컨텍스트 유지 + - 메시지 타임스탬프(`loading_ts`) 저장하여 이후 업데이트에 사용 + +#### 1.2 처리 완료 후 메시지 업데이트 +- **파일**: `rb8001/app/services/workflows/coldmail_workflow.py:200-241` +- **변경 사항**: + - `confirm_node`에서 리스트 등록 완료 후 "로빙 중…" 메시지를 "리스트 등록 완료" 메시지로 업데이트 + - `skill-slack`의 `/api/v1/update` 엔드포인트 사용 (메시지 타임스탬프 필요) + - 최종 요약 메시지는 기존대로 `send_node`에서 전송 + +#### 1.3 에러 처리 +- 워크플로우 재개 실패 시 "로빙 중…" 메시지를 에러 메시지로 업데이트 +- 폴백 처리 시에도 동일한 피드백 제공 + +### 참고 패턴 +- IR 분석 버튼: `coldmail_service.py:158-206` (로딩 메시지 전송 패턴) +- 뉴스 게시: `news_service.py:13-54` (진행 상황 업데이트 패턴) + +--- + +## Phase 2: IR Deck 종합 결론 형식 개선 + +### 목표 +종합 결론 섹션에서 핵심 내용을 먼저 표시하여 사용자가 빠르게 파악 가능하도록 개선 + +### 구현 계획 + +#### 2.1 프론트엔드 형식 변경 +- **파일**: `frontend-ir-valuation/src/pages/ir-valuation.tsx:515-539` +- **변경 사항**: + - 현재 순서: 요약 → 핵심 리스크 → 핵심 강점 + - 변경 순서: **요약(결론) → 핵심 강점 → 핵심 리스크** + - 요약 문단을 맨 앞에 배치하여 핵심 결론을 먼저 확인 가능하도록 변경 + +#### 2.2 마크다운 형식 유지 +- 기존 마크다운 형식 유지 (## 헤더, 리스트 등) +- 섹션 순서만 변경하여 기존 스타일과 호환성 유지 + +--- + +## 구현 순서 + +1. Phase 1.1: 즉시 피드백 메시지 전송 구현 +2. Phase 1.2: 처리 완료 후 메시지 업데이트 구현 +3. Phase 1.3: 에러 처리 추가 +4. Phase 2.1: IR Deck 종합 결론 형식 변경 + +--- + +## 검증 방법 + +### 콜드메일 UX 개선 +- "맞음" 버튼 클릭 시 즉시 "로빙 중…" 메시지 확인 +- 리스트 등록 완료 후 메시지 업데이트 확인 +- 최종 요약 메시지 정상 전송 확인 + +### IR Deck 형식 개선 +- 프론트엔드에서 종합 결론 섹션 순서 확인 +- 요약(결론)이 맨 앞에 표시되는지 확인 +- 핵심 강점 → 핵심 리스크 순서 확인 + +--- + +## 참고 문서 +- `DOCS/journey/troubleshooting/260121_coldmail_multi_confirm_loop_fix.md`: 콜드메일 확인 워크플로우 +- `DOCS/journey/scenarios/ir_deck_evaluation_scenario.md`: IR Deck 평가 시나리오