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

---

분석 완료 ✅