테마
Story: 업무노트 연동
메타
| 항목 | 값 |
|---|---|
| Story ID | E-04-S-06 |
| Epic | E-04 AI 진단 엔진 |
| 상태 | draft |
| 우선순위 | P1 |
| 규모 | S |
| 담당 개발자 | FE (수민님) |
사용자 스토리
As a Pro10+ 셀러, I want AI 진단 제안이 업무노트에 자동 기록, So that 제안을 검토하고 적용 여부를 결정할 수 있다.
수락 기준 (Acceptance Criteria)
AC-01: AI 제안 자동 기록
| 항목 | 내용 |
|---|---|
| Given | AI 진단 생성 시 제안(suggestion) 포함 |
| When | 진단 결과 표시 |
| Then | 업무노트에 AI 제안 항목 자동 추가 |
업무노트 항목 형태:
┌─────────────────────────────────────────────────────────┐
│ 📋 업무노트 01/27 │
├─────────────────────────────────────────────────────────┤
│ │
│ 🤖 AI 제안 오늘 10:30 │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 캠페인: 신상품_런칭 │ │
│ │ │ │
│ │ 💡 비검색 입찰가 15% 인하 │ │
│ │ 예상 효과: 순이익 +12% │ │
│ │ │ │
│ │ [적용했어요] [나중에] [맞지 않아요] │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ✏️ 메모 추가... │
└─────────────────────────────────────────────────────────┘AC-02: [적용했어요] 버튼
| 항목 | 내용 |
|---|---|
| Given | AI 제안 항목에서 [적용했어요] 클릭 |
| When | 클릭 |
| Then | 적용 API 호출 (E-04-S-04) + 상태 업데이트 |
상태 변경 후 UI:
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✅ 적용 완료 01/27 14:20 │ │
│ │ 캠페인: 신상품_런칭 - 비검색 입찰가 15% 인하 │ │
│ │ │ │
│ │ 📊 7일 후 성과를 알려드릴게요 (02/03 예정) │ │
│ └─────────────────────────────────────────────────────┘ │AC-03: [맞지 않아요] 버튼
| 항목 | 내용 |
|---|---|
| Given | AI 제안 항목에서 [맞지 않아요] 클릭 |
| When | 클릭 |
| Then | 거절 API 호출 + (선택) 피드백 입력 모달 |
피드백 모달 (선택):
┌─────────────────────────────────────┐
│ 이 제안이 맞지 않은 이유가 있나요? │
├─────────────────────────────────────┤
│ │
│ ○ 이미 적용해봤어요 │
│ ○ 상황이 달라요 │
│ ○ 다른 이유 │
│ [ ] │
│ │
│ [건너뛰기] [제출] │
└─────────────────────────────────────┘AC-04: 성과 결과 표시
| 항목 | 내용 |
|---|---|
| Given | 적용 후 7일 경과, 성과 측정 완료 |
| When | 업무노트 조회 |
| Then | 성과 결과 표시 |
성과 표시 UI:
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✅ 적용 완료 01/27 14:20 │ │
│ │ 캠페인: 신상품_런칭 - 비검색 입찰가 15% 인하 │ │
│ │ │ │
│ │ 📊 성과 (7일 후) 02/03 측정 │ │
│ │ ROAS: 150% → 175% (+17%) ✅ │ │
│ │ 순이익: +12만원 │ │
│ └─────────────────────────────────────────────────────┘ │태스크 분해
Task 1: 업무노트 AI 제안 항목 AC-01
- [ ] 1.1: AISuggestionNote 컴포넌트 생성
- [ ] 1.2: 업무노트 목록에 AI 제안 타입 추가
- [ ] 1.3: 자동 기록 로직 (진단 생성 시)
Task 2: 적용 버튼 연동 AC-02
- [ ] 2.1: [적용했어요] 버튼 클릭 핸들러
- [ ] 2.2: 적용 API 호출 (E-04-S-04)
- [ ] 2.3: 상태 업데이트 + UI 변경
Task 3: 거절 버튼 연동 AC-03
- [ ] 3.1: [맞지 않아요] 버튼 클릭 핸들러
- [ ] 3.2: 피드백 모달 (선택)
- [ ] 3.3: 거절 API 호출
Task 4: 성과 표시 AC-04
- [ ] 4.1: 성과 데이터 조회 로직
- [ ] 4.2: 성과 결과 UI 컴포넌트
Task 5: 마무리
- [ ] 5.1: 업무노트 E-11과 통합 테스트
- [ ] 5.2: PR 생성
Dev Notes (AI Agent 최적화)
영향 받는 소스 트리
src/
├── app/
│ └── dashboard/
│ └── worknote/ # S52 E-11 업무노트
│ └── components/
│ ├── AISuggestionNote.tsx # 🆕 AI 제안 노트 컴포넌트
│ └── OutcomeDisplay.tsx # 🆕 성과 표시
├── hooks/
│ └── useAISuggestion.ts # 🆕 제안 관리 훅
└── types/
└── worknote.ts # 🔧 AI 제안 타입 추가S52 E-11 업무노트 연동 포인트
typescript
// 업무노트 항목 타입 확장
interface WorkNoteItem {
type: "memo" | "task" | "ai_suggestion"; // ai_suggestion 추가
// ...
}
// AI 제안 전용 필드
interface AISuggestionItem extends WorkNoteItem {
type: "ai_suggestion";
suggestionId: string;
campaignId: string;
campaignName: string;
action: string;
expectedEffect: string;
status: "pending" | "applied" | "rejected";
outcome?: SuggestionOutcome;
}충돌 감지
| 항목 | 상태 | 설명 |
|---|---|---|
| S52 E-11 충돌 | 🟡 주의 | 업무노트 컴포넌트 확장 필요 |
| 타입 충돌 | 🟡 확인필요 | WorkNoteItem 타입 확장 |
의존성
| 의존 | 설명 | 상태 |
|---|---|---|
| S52 E-11 | 업무노트 기본 기능 | 개발 중 |
| E-04-S-04 | 적용/거절/성과 API | 선행 필요 |
| E-04-S-05 | Surface Layer UI (CTA 연결) | 병행 |
Dev Agent Record
| 항목 | 값 |
|---|---|
| 생성 Agent | Claude Opus 4.5 |
| 생성일 | 2026-01-27 |
| 마지막 수정 | 2026-01-27 |
| 검증자 | - |
검증 결과: 🔄 PENDING (PO 승인 대기) 검증일: -
생성일: 2026-01-27마지막 수정: 2026-01-27