hgzero/claude/userstory-comparison-v2.2.0-to-v2.3.0.md

# 유저스토리 v2.2.0 → v2.3.0 변경사항 분석 보고서

**분석 일시**: 2025-10-25
**이전 버전**: v2.2.0 (2025-10-23)
**현재 버전**: v2.3.0 (2025-10-24)
**분석자**: Claude (AI Assistant)

---

## 📊 주요 통계

| 항목 | v2.2.0 | v2.3.0 | 변화 |
|------|--------|--------|------|
| **총 유저스토리 수** | 25개 | 27개 | +2개 |
| **신규 추가** | - | 5개 | - |
| **삭제 (AFR → UFR 전환)** | 2개 | - | - |
| **AFR 코드** | 2개 | 0개 | -2개 |
| **UFR 코드** | 23개 | 27개 | +4개 |
| **평균 상세도** | 20-30줄 | 60-100줄 | 약 3배 증가 |

---

## 🏗️ 문서 구조 변경

### v2.2.0 구조
```
1. 차별화 전략
2. 마이크로서비스 구성
3. 유저스토리 (자유 형식)
4. 논리 아키텍처 반영 사항 요약
5. 문서 이력
```

### v2.3.0 구조 (개선)
```
1. 차별화 전략
2. 마이크로서비스 구성
3. 유저스토리 v2.3.0 - USER & MEETING 서비스 (표준 형식)
   - 수행절차
   - 입력
   - 출력/결과
   - 예외처리
   - 관련 유저스토리
4. 문서 이력
```

### 주요 구조 변경사항
- ✅ **논리 아키텍처 반영 사항 요약 섹션 삭제**: 설계 문서로 이관
- ✅ **유저스토리 형식 표준화**: 모든 유저스토리에 5개 필수 섹션 적용
- ✅ **AFR 코드 폐지**: UFR로 통일하여 코드 체계 단순화
- ✅ **프로토타입 연계 강화**: 화면 번호, 파일명 명시

---

## ✨ 신규 추가 유저스토리 (5개)

### 1. UFR-USER-010: [로그인]
**이전**: AFR-USER-010 (아키텍처 참조 코드)
**변경**: UFR-USER-010 (사용자 기능 요구사항 코드)

**주요 개선사항**:
- 프로토타입 `01-로그인.html` 기반 재작성
- 상세 수행절차 6단계 추가
- 입력 검증 규칙 명시 (비밀번호 최소 8자, Enter 키 자동 이동)
- 예외처리 5가지 추가
- 로그인 상태 유지 체크박스 추가

**관련 프로토타입**: `01-로그인.html`

---

### 2. UFR-USER-020: [대시보드]
**이전**: AFR-USER-020
**변경**: UFR-USER-020

**주요 개선사항**:
- 프로토타입 `02-대시보드.html` 기반 전면 재설계
- 통계 블록 2열 그리드 (예정된 회의, 나의 Todo)
- 최근 회의 목록 (최대 3개, 회의록 미생성 우선)
- 나의 Todo 목록 (최대 3개, 미완료 우선, D-day 표시)
- 나의 회의록 2x2 그리드 (최대 4개)
- FAB 메뉴 (회의예약, 바로시작)
- 반응형 네비게이션 (데스크톱 사이드바, 모바일 하단 탭)

**관련 프로토타입**: `02-대시보드.html`

---

### 3. UFR-MEET-015: [회의진행] 참석자 실시간 초대 🆕
**완전 신규 추가**

**기능 설명**:
- 회의 진행 중 추가 참석자가 필요할 때 실시간으로 초대
- 검색 모달을 통한 사용자 검색 및 선택
- 초대된 참석자 실시간 표시
- Notification 서비스 연동 (초대 알림 발송)
- 모든 참석자에게 WebSocket 기반 실시간 동기화

**의미**:
- 프로토타입 `05-회의진행.html`의 "참석자" 탭 기능 구현
- 회의 진행 중 동적 참석자 관리로 유연성 향상

**관련 유저스토리**:
- UFR-MEET-030 (회의시작)
- UFR-COLLAB-010 (회의록수정동기화)
- UFR-NOTI-010 (알림발송)

**관련 프로토타입**: `05-회의진행.html`

---

### 4. UFR-AI-030: [실시간AI제안] 🆕 🎯
**완전 신규 추가** - **차별화 핵심 기능**

**기능 설명**:
- 회의 진행 중 STT 텍스트 실시간 분석
- AI가 주요 내용 감지 시 제안 카드 자동 생성
- 제안 제목, 내용 (1-2문장), 타임스탬프 표시
- "메모에 추가" 버튼으로 회의 메모에 즉시 반영
- 모든 참석자에게 실시간 동기화
- 로컬 캐시를 통한 네트워크 오류 대응

**의미**:
- 프로토타입 `05-회의진행.html`의 "AI 제안" 탭 핵심 기능
- **차별화 전략의 "지능형 회의 진행 지원" 실현**
- 회의 중 놓치는 내용 최소화로 회의록 품질 향상

**관련 유저스토리**:
- UFR-STT-020 (텍스트변환)
- UFR-MEET-030 (회의시작)
- UFR-COLLAB-010 (회의록수정동기화)

**관련 프로토타입**: `05-회의진행.html`

---

### 5. UFR-NOTI-010: [알림발송] 🆕
**완전 신규 추가** - **알림 아키텍처 정의**

**기능 설명**:
- 주기적 폴링 방식 (1분 간격) 알림 발송
- Notification 테이블에서 발송 대기 알림 조회
- 이메일 발송 실패 시 최대 3회 재시도
- 알림 유형별 템플릿 적용
- 6가지 알림 유형 지원:
  - Todo 할당
  - Todo 완료
  - 회의 시작 (10분 전)
  - 회의록 확정
  - 참석자 초대
  - 회의록 수정

**의미**:
- **알림 아키텍처를 실시간 발송에서 폴링 방식으로 통일**
- Notification 서비스의 독립성과 안정성 확보
- 마이크로서비스 간 느슨한 결합 실현

**관련 유저스토리**:
- UFR-TODO-010 (Todo할당)
- UFR-TODO-030 (Todo완료처리)
- UFR-MEET-015 (참석자 실시간 초대)
- UFR-MEET-050 (최종확정)

---

## ❌ 삭제된 유저스토리 (2개)

### 1. AFR-USER-010: [사용자관리]
**삭제 이유**: UFR-USER-010으로 전환 (AFR 코드 체계 폐지)
**영향**: 기능은 UFR-USER-010으로 승계되어 유지됨

### 2. AFR-USER-020: [대시보드]
**삭제 이유**: UFR-USER-020으로 전환 (프로토타입 기반 재작성)
**영향**: 기능은 강화되어 UFR-USER-020으로 승계됨

---

## 🔄 주요 수정된 유저스토리

### 1. UFR-MEET-010: [회의예약]
**변경사항**:
- 프로토타입 `03-회의예약.html` 기반 전면 재작성
- 상세한 수행절차 10단계 추가
- 입력 필드 상세 명세 (종일 회의 토글, 온라인/오프라인 회의 토글, 회의 링크 자동 생성)
- 예외처리 8가지 추가 (과거 날짜 선택, 뒤로가기 확인 모달 등)
- 임시저장 기능 추가
- 참석자 검색 모달 UI 상세화

**의미**: 프로토타입과의 정확한 매칭으로 개발 시 명확한 가이드 제공

---

### 2. UFR-MEET-020: [템플릿선택]
**변경사항**:
- 프로토타입 `04-템플릿선택.html` 기반 재작성
- 4가지 템플릿 내용 상세 명세:
  - 일반 회의: 회의 개요, 논의 사항, 결정 사항, 액션 아이템
  - 스크럼 회의: 어제 한 일, 오늘 할 일, 블로커/이슈
  - 킥오프 회의: 프로젝트 개요, 목표 및 범위, 역할 및 책임, 일정 및 마일스톤
  - 주간 회의: 지난주 성과, 이번주 계획, 주요 이슈, 다음 액션
- 건너뛰기 옵션 추가
- 템플릿 미리보기 구성 명시

**의미**: 템플릿별 섹션 구성이 구체화되어 일관된 회의록 작성 지원

---

### 3. UFR-MEET-030: [회의시작]
**변경사항**:
- 프로토타입 `05-회의진행.html` 기반 전면 재작성
- 8단계 상세 수행절차 추가
- **4개 탭 네비게이션 명시**:
  - 참석자: 참석자 목록 및 실시간 초대
  - **AI 제안**: 실시간 AI 분석 결과 및 메모 추가 (신규)
  - 용어사전: 자동 추출된 용어 및 검색
  - 관련회의록: 자동 연결된 이전 회의록
- 웨이브폼 애니메이션, 타이머, 녹음 상태 UI 추가
- 하단 고정 메모 영역 추가
- 일시정지 및 종료 확인 모달 추가

**의미**: 회의 진행 화면의 핵심 UX가 상세히 정의되어 실시간 협업 기능 구현 가이드 제공

---

### 4. UFR-MEET-040: [회의종료]
**변경사항**:
- 프로토타입 `07-회의종료.html` 기반 재작성
- 통계 카드 4개 명시 (참석자, 시간, 안건, Todo)
- 주요 키워드 태그 표시 추가
- 안건별 아코디언 카드 구조 명시:
  - AI 한줄 요약 (30자 이내, 편집 불가)
  - AI 상세 요약 (편집 가능, 재생성 가능)
  - 자동 추출된 Todo 목록
- 읽기 전용 안내 표시
- **하단 액션 바 3가지 옵션**:
  - 옵션 1: 회의록 수정 → 회의록 수정 화면으로 이동
  - 옵션 2: 바로 최종 확정 → 모든 안건 자동 검증 완료 처리
  - 옵션 3: 대시보드 → 대시보드로 이동

**의미**: 회의 종료 후 워크플로우가 명확해져 사용자 선택권 확대 및 UX 개선

---

### 5. UFR-MEET-050: [최종확정]
**변경사항**:
- **2가지 시나리오로 분리**:
  - 시나리오 1: 회의록 수정 화면에서 최종 확정
  - 시나리오 2: 회의 종료 화면에서 바로 확정
- 각 시나리오별 수행절차 5-6단계 상세화
- 확인 모달 메시지 구체화
- 바로 확정 시 모든 안건 자동 검증 완료 처리 로직 추가
- 확정 후 편집 권한 정책 명시 (회의 생성자만 잠금 해제 후 수정 가능)

**의미**: 유연한 확정 워크플로우 제공으로 사용자 편의성 향상

---

### 6. UFR-MEET-046: [회의록목록조회]
**변경사항**:
- 프로토타입 `12-회의록목록조회.html` 기반 재작성
- **데이터 소스 명시**: `common.js` → `SAMPLE_MINUTES` 배열 (30개 샘플 데이터)
- 필터링 옵션 상세화:
  - 상태별: 전체 / 작성중 / 확정완료
  - 정렬: 최근수정순 / 최근회의순 / 제목순
  - 참여 유형: 참석한 회의 / 생성한 회의
  - 검색: 회의 제목, 참석자, 키워드
- 통계 표시 추가
- 페이지네이션 방식 명시 (초기 10개, "10개 더보기" 버튼)
- 목록 표시 정보 8가지 추가
- **우선순위 변경**: M (Must) → S (Should) - MVP 집중

**의미**: 프로토타입 연계 강화, 샘플 데이터 30개 기반 개발 가능

---

### 7. UFR-MEET-047: [회의록상세조회]
**변경사항**:
- 프로토타입 `10-회의록상세조회.html` 기반 재작성
- 회의 기본 정보 표시 항목 7가지 상세화
- 섹션별 상세 내용 표시 구조 추가
- **관련 회의록 섹션 추가** (최대 3개, 관련도 % 표시)
- 탭 네비게이션 구성 명시 (대시보드, 회의록 2개 탭)

**의미**: 회의록 조회 화면 정보 구조 명확화 및 관련 회의록 연결 강화

---

### 8. UFR-MEET-055: [회의록수정]
**변경사항**:
- 프로토타입 `11-회의록수정.html` 기반 전면 재작성
- **3가지 시나리오로 확장**:
  - 시나리오 1: 작성중 회의록 수정
  - 시나리오 2: 확정완료 회의록 수정 (잠금 해제 필요)
  - 시나리오 3: 안건 검증
- 각 시나리오별 상세 수행절차 추가
- 잠금 해제 메커니즘 명시 (확정완료 회의록의 경우)
- 검증 완료 프로세스 상세화 (안건별 체크 버튼, 검증률 표시)

**의미**: 회의록 수정 워크플로우가 상태별로 명확해져 협업 시나리오 지원 강화

---

## 🎯 전체 영향 분석

### 1. 사용자 경험 (UX) 개선

#### 주요 개선사항
- ✅ **프로토타입 기반 유저스토리**로 실제 사용 흐름과 정확히 일치
- ✅ **상세한 수행절차**로 사용자 작업 흐름 명확화
- ✅ **예외처리 시나리오 추가**로 에러 상황 대응 개선
- ✅ **실시간 AI 제안 기능**으로 회의 중 놓치는 내용 최소화 (차별화)
- ✅ **유연한 확정 워크플로우**로 사용자 선택권 확대
- ✅ **회의 진행 중 참석자 실시간 초대**로 협업 유연성 향상

#### 핵심 UX 강화
- **대시보드 재설계**: 통계 블록, 최근 회의, Todo, 회의록 4개 섹션으로 정보 접근성 향상
- **회의 진행 화면 4개 탭**: 참석자, AI 제안, 용어사전, 관련회의록으로 기능 분리
- **회의 종료 화면 3가지 액션 옵션**: 회의록 수정, 바로 최종 확정, 대시보드로 워크플로우 유연성 확보

---

### 2. 기능성 (Functionality) 개선

#### 신규 기능
1. **UFR-MEET-015**: 회의 진행 중 참석자 실시간 초대
2. **UFR-AI-030**: 실시간 AI 제안 (차별화 핵심)
3. **UFR-NOTI-010**: 알림 발송 (폴링 방식)

#### 아키텍처 정렬
- **알림 아키텍처 폴링 방식으로 통일**: 실시간 발송 → 주기적 폴링 (1분 간격)
- **Notification 서비스 독립성 강화**: 마이크로서비스 간 느슨한 결합
- **프로토타입 10개 화면과 유저스토리 1:1 매핑**: 개발 명확성 확보
- **WebSocket 기반 실시간 동기화 시나리오 명확화**: 협업 기능 강화

#### API 설계 가이드 제공
- 모든 유저스토리에 **입력/출력 명세** 추가
- **예외처리 시나리오** 추가로 에러 핸들링 강화
- **관련 유저스토리** 명시로 기능 간 연계성 파악 용이

---

### 3. 문서화 (Documentation) 개선

#### 표준화 및 일관성
- ✅ **유저스토리 형식 표준화**: 5개 필수 섹션 (수행절차, 입력, 출력/결과, 예외처리, 관련 유저스토리)
- ✅ **AFR/UFR 혼용 제거**: UFR로 통일하여 코드 체계 단순화
- ✅ **프로토타입 파일명 명시**: 개발 시 참조 용이성 향상
- ✅ **관련 유저스토리 섹션 추가**: 추적성 확보
- ✅ **문서 구조 간소화**: 논리 아키텍처 섹션 제거 (설계 문서로 이관)

#### 품질 향상
| 지표 | v2.2.0 | v2.3.0 | 개선율 |
|------|--------|--------|--------|
| 유저스토리 수 | 25개 | 27개 | +8% |
| 평균 상세도 | 20-30줄 | 60-100줄 | **약 3배** |
| 코드 체계 통일 | AFR/UFR 혼용 | UFR로 통일 | 100% 통일 |
| 프로토타입 연계 | 부분적 | 1:1 매핑 | 100% 매핑 |

---

## 💡 핵심 시사점 (Key Takeaways)

1. **v2.3.0은 프로토타입 분석을 통해 유저스토리를 전면 재정비한 버전**
2. **신규 기능 3개 추가**: 참석자 실시간 초대, 실시간 AI 제안, 알림 발송
3. **알림 아키텍처를 폴링 방식으로 통일**하여 시스템 안정성 확보
4. **유저스토리 형식 표준화**로 개발 가이드 역할 강화
5. **프로토타입 10개 화면과 유저스토리 1:1 매핑**으로 개발 명확성 확보
6. **기존 24개 유저스토리 ID 승계**하여 연속성 유지
7. **평균 유저스토리 상세도 약 3배 증가**로 품질 대폭 향상

---

## 📋 권장 후속 조치 (Recommended Actions)

### 1. 설계 문서 업데이트
- [ ] **API 설계서**를 v2.3.0 유저스토리 기반으로 업데이트 (입력/출력 명세 반영)
- [ ] 신규 추가된 **UFR-MEET-015, UFR-AI-030, UFR-NOTI-010** 기반 API 및 시퀀스 설계
- [ ] **알림 아키텍처 폴링 방식** 반영하여 물리 아키텍처 업데이트

### 2. 프로토타입 검증
- [ ] 프로토타입과 유저스토리 간 **1:1 매핑 검증**
- [ ] 프로토타입 화면별 유저스토리 커버리지 확인

### 3. 테스트 계획
- [ ] 각 유저스토리의 **예외처리 시나리오를 테스트 케이스로 전환**
- [ ] **관련 유저스토리 섹션**을 활용하여 통합 테스트 시나리오 작성
- [ ] 신규 기능 3개에 대한 우선 테스트 계획 수립

### 4. 개발 가이드
- [ ] 유저스토리별 개발 우선순위 재평가
- [ ] 신규 기능 3개 개발 일정 수립
- [ ] 프로토타입 기반 개발 가이드 작성

---

## 📎 참조 파일

- **v2.2.0**: `C:\Users\yabo0\home\workspace\HGZero\design\userstory_v2.2.0_backup.md`
- **v2.3.0**: `C:\Users\yabo0\home\workspace\HGZero\design\userstory.md`
- **상세 분석 (JSON)**: `C:\Users\yabo0\home\workspace\HGZero\claude\userstory-comparison-v2.2.0-to-v2.3.0.json`

---

**분석 완료** ✅