회원목록

docs/deployment_checklist.md

@@ -0,0 +1,127 @@
+# 볼링 매니저 앱 배포 체크리스트
+
+## 1. 앱 준비
+
+### 1.1 코드 준비
+- [ ] 모든 디버그 코드 및 로그 제거
+- [ ] 릴리스 모드로 빌드 설정 확인
+- [ ] 앱 버전 및 빌드 번호 업데이트
+- [ ] 프로덕션 API 엔드포인트 설정 확인
+- [ ] 코드 최적화 및 성능 검토 완료
+
+### 1.2 자산 및 리소스
+- [ ] 모든 이미지 및 아이콘 최적화
+- [ ] 앱 아이콘 모든 크기 준비 완료
+- [ ] 스플래시 화면 준비 완료
+- [ ] 다국어 지원 텍스트 검토 완료
+
+### 1.3 인앱 결제 설정
+- [ ] App Store Connect에 인앱 결제 상품 등록 완료
+- [ ] Google Play Console에 구독 상품 등록 완료
+- [ ] 샌드박스 테스트 완료
+- [ ] 실제 결제 테스트 완료 (필요시)
+
+## 2. iOS 배포 준비
+
+### 2.1 App Store Connect 설정
+- [ ] 앱 정보 입력 완료 (이름, 설명, 키워드 등)
+- [ ] 스크린샷 및 프리뷰 비디오 업로드
+- [ ] 개인정보 처리방침 URL 등록
+- [ ] 앱 리뷰 정보 준비 (테스트 계정 등)
+- [ ] 연령 등급 설정
+
+### 2.2 인증서 및 프로비저닝
+- [ ] 배포용 인증서 유효성 확인
+- [ ] 프로비저닝 프로파일 설정 확인
+- [ ] 앱 ID 및 기능 활성화 확인
+
+### 2.3 빌드 및 제출
+- [ ] Archive 빌드 생성
+- [ ] TestFlight 업로드 및 테스트
+- [ ] 앱 심사 제출 준비
+
+## 3. Android 배포 준비
+
+### 3.1 Google Play Console 설정
+- [ ] 스토어 등록정보 입력 완료 (이름, 설명, 카테고리 등)
+- [ ] 스크린샷 및 그래픽 자산 업로드
+- [ ] 개인정보 처리방침 URL 등록
+- [ ] 콘텐츠 등급 설정
+- [ ] 가격 및 배포 국가 설정
+
+### 3.2 서명 및 보안
+- [ ] 앱 서명 키 확인
+- [ ] Play App Signing 설정 확인
+- [ ] ProGuard 설정 확인 (코드 난독화)
+
+### 3.3 빌드 및 제출
+- [ ] 릴리스 APK/AAB 생성
+- [ ] 내부/외부 테스트 트랙 업로드 및 테스트
+- [ ] 프로덕션 출시 준비
+
+## 4. 백엔드 배포 준비
+
+### 4.1 서버 환경 설정
+- [ ] 프로덕션 서버 환경 구성 완료
+- [ ] 데이터베이스 마이그레이션 계획 수립
+- [ ] 백업 및 복구 전략 확인
+
+### 4.2 API 및 보안
+- [ ] 모든 API 엔드포인트 프로덕션 환경에서 테스트 완료
+- [ ] HTTPS 설정 확인
+- [ ] API 키 및 인증 설정 검토
+- [ ] 속도 제한 및 보안 설정 확인
+
+### 4.3 모니터링 및 로깅
+- [ ] 서버 모니터링 도구 설정
+- [ ] 오류 로깅 및 알림 설정
+- [ ] 성능 모니터링 설정
+
+## 5. 법적 요구사항
+
+### 5.1 개인정보 보호
+- [ ] 개인정보 처리방침 최신화
+- [ ] 데이터 수집 및 사용에 대한 동의 절차 확인
+- [ ] GDPR/CCPA 등 관련 법규 준수 확인
+
+### 5.2 이용 약관
+- [ ] 이용 약관 최신화
+- [ ] 구독 및 결제 관련 조항 포함 확인
+- [ ] 환불 정책 명시 확인
+
+### 5.3 지적 재산권
+- [ ] 사용된 모든 라이브러리 및 자산의 라이선스 확인
+- [ ] 제3자 콘텐츠 사용 권한 확인
+
+## 6. 마케팅 및 출시 준비
+
+### 6.1 마케팅 자료
+- [ ] 보도 자료 준비
+- [ ] 소셜 미디어 콘텐츠 준비
+- [ ] 프로모션 계획 수립
+
+### 6.2 사용자 지원
+- [ ] 고객 지원 채널 설정
+- [ ] FAQ 및 도움말 문서 준비
+- [ ] 사용자 피드백 수집 방법 설정
+
+### 6.3 출시 계획
+- [ ] 출시 일정 확정
+- [ ] 단계적 출시 전략 수립 (필요시)
+- [ ] 출시 후 모니터링 계획 수립
+
+## 7. 최종 검토
+
+### 7.1 품질 보증
+- [ ] 모든 주요 기능 최종 테스트 완료
+- [ ] 다양한 기기 및 OS 버전에서 테스트 완료
+- [ ] 성능 및 배터리 사용량 테스트 완료
+
+### 7.2 사용자 경험
+- [ ] 온보딩 프로세스 검토
+- [ ] 오류 처리 및 피드백 검토
+- [ ] 접근성 기능 검토
+
+### 7.3 최종 승인
+- [ ] 모든 이해관계자의 최종 승인 획득
+- [ ] 출시 결정 확인

docs/subscription_qa_checklist.md

@@ -0,0 +1,133 @@
+# 볼링 매니저 구독 및 인앱 결제 QA 체크리스트
+
+## 1. 구독 기능 테스트
+
+### 1.1 구독 정보 조회
+- [ ] 앱 시작 시 현재 구독 정보 로드 확인
+- [ ] 구독이 없는 경우 기본(무료) 플랜 표시 확인
+- [ ] 구독 상세 정보 표시 확인 (플랜 유형, 시작일, 만료일, 자동 갱신 상태 등)
+
+### 1.2 구독 플랜 목록
+- [ ] 사용 가능한 모든 구독 플랜 표시 확인
+- [ ] 각 플랜의 가격, 기능, 제한 사항 등 정확히 표시 확인
+- [ ] 월간/연간 요금제 전환 기능 확인
+
+### 1.3 구독 상태별 기능 제한
+- [ ] 무료 플랜 사용자의 기능 제한 확인
+- [ ] 기본 플랜 사용자의 기능 접근 확인
+- [ ] 프리미엄 플랜 사용자의 기능 접근 확인
+- [ ] 프로 플랜 사용자의 기능 접근 확인
+- [ ] 제한된 기능 접근 시 업그레이드 안내 대화상자 표시 확인
+
+### 1.4 회원 및 이벤트 제한
+- [ ] 플랜별 최대 회원 수 제한 확인
+- [ ] 플랜별 최대 이벤트 수 제한 확인
+- [ ] 제한 초과 시 적절한 안내 메시지 표시 확인
+
+## 2. 인앱 결제 테스트
+
+### 2.1 구독 구매
+- [ ] 각 플랜별 구독 구매 버튼 작동 확인
+- [ ] 인앱 결제 다이얼로그 표시 확인
+- [ ] 결제 진행 중 로딩 표시 확인
+- [ ] 결제 성공 시 구독 정보 업데이트 확인
+- [ ] 결제 실패 시 적절한 오류 메시지 표시 확인
+
+### 2.2 구독 복원
+- [ ] 구독 복원 버튼 작동 확인
+- [ ] 복원 진행 중 로딩 표시 확인
+- [ ] 복원 성공 시 구독 정보 업데이트 확인
+- [ ] 복원할 구독이 없는 경우 적절한 메시지 표시 확인
+
+### 2.3 플랜 변경
+- [ ] 현재 구독에서 다른 플랜으로 변경 기능 확인
+- [ ] 업그레이드/다운그레이드 시 적절한 안내 메시지 표시 확인
+- [ ] 플랜 변경 후 구독 정보 업데이트 확인
+
+### 2.4 자동 갱신 설정
+- [ ] 자동 갱신 설정 변경 기능 확인
+- [ ] 설정 변경 후 상태 업데이트 확인
+
+## 3. 백엔드 API 테스트
+
+### 3.1 구독 관련 API
+- [ ] `/subscriptions/current` - 현재 구독 정보 조회 API 테스트
+- [ ] `/subscriptions/plans` - 구독 플랜 목록 조회 API 테스트
+- [ ] `/subscriptions/subscribe` - 구독 생성 API 테스트
+- [ ] `/subscriptions/change-with-features` - 플랜 변경 API 테스트
+
+### 3.2 인앱 결제 검증 API
+- [ ] `/subscriptions/verify-receipt` - 영수증 검증 API 테스트
+  - [ ] iOS 영수증 검증 테스트
+  - [ ] Android 영수증 검증 테스트
+  - [ ] 잘못된 영수증 데이터 처리 테스트
+
+## 4. 샌드박스 테스트
+
+### 4.1 iOS 샌드박스 테스트
+- [ ] App Store Connect에서 샌드박스 테스터 계정 설정
+- [ ] 샌드박스 환경에서 구독 구매 테스트
+- [ ] 샌드박스 환경에서 구독 복원 테스트
+- [ ] 샌드박스 환경에서 플랜 변경 테스트
+
+### 4.2 Android 샌드박스 테스트
+- [ ] Google Play Console에서 테스트 트랙 설정
+- [ ] 테스트 환경에서 구독 구매 테스트
+- [ ] 테스트 환경에서 구독 복원 테스트
+- [ ] 테스트 환경에서 플랜 변경 테스트
+
+## 5. 오류 처리 테스트
+
+### 5.1 네트워크 오류
+- [ ] 오프라인 상태에서 구독 관련 기능 동작 확인
+- [ ] 네트워크 재연결 시 상태 복구 확인
+
+### 5.2 서버 오류
+- [ ] 서버 응답 오류 시 적절한 메시지 표시 확인
+- [ ] 재시도 메커니즘 확인
+
+### 5.3 결제 오류
+- [ ] 결제 취소 시 적절한 처리 확인
+- [ ] 잘못된 결제 정보 입력 시 오류 처리 확인
+
+## 6. UI/UX 테스트
+
+### 6.1 구독 화면 UI
+- [ ] 구독 화면의 레이아웃 및 디자인 확인
+- [ ] 다양한 화면 크기에서의 반응형 디자인 확인
+- [ ] 다크 모드 지원 확인
+
+### 6.2 사용자 피드백
+- [ ] 로딩 상태 표시 확인
+- [ ] 오류 메시지 명확성 확인
+- [ ] 성공 메시지 표시 확인
+
+## 7. 보안 테스트
+
+### 7.1 영수증 검증
+- [ ] 위조된 영수증 거부 확인
+- [ ] 만료된 영수증 처리 확인
+
+### 7.2 인증 및 권한
+- [ ] 인증되지 않은 사용자의 구독 API 접근 차단 확인
+- [ ] 권한이 없는 사용자의 관리자 기능 접근 차단 확인
+
+## 8. 통합 테스트
+
+### 8.1 전체 구독 흐름
+- [ ] 구독 생성 → 플랜 변경 → 자동 갱신 설정 → 구독 취소의 전체 흐름 테스트
+
+### 8.2 다중 기기 동기화
+- [ ] 여러 기기에서 동일한 계정으로 로그인 시 구독 정보 동기화 확인
+
+## 9. 배포 준비
+
+### 9.1 스토어 설정
+- [ ] App Store 인앱 결제 상품 설정 확인
+- [ ] Google Play 구독 상품 설정 확인
+- [ ] 스토어 스크린샷 및 설명에 구독 정보 포함 확인
+
+### 9.2 법적 요구사항
+- [ ] 개인정보 처리방침에 구독 관련 내용 포함 확인
+- [ ] 이용 약관에 구독 조건 포함 확인
+- [ ] 환불 정책 명시 확인

docs/subscription_requirements_flow.md

@@ -0,0 +1,204 @@
+# 볼링 매니저 구독 및 인앱 결제 요구사항 및 사용자 플로우
+
+## 1. 요구사항
+
+### 1.1 기능적 요구사항
+
+#### 구독 관리
+- 사용자는 다양한 구독 플랜(기본, 프리미엄, 프로) 중에서 선택할 수 있어야 함
+- 사용자는 월간 또는 연간 구독 옵션을 선택할 수 있어야 함
+- 사용자는 현재 구독 상태를 확인할 수 있어야 함
+- 사용자는 구독을 업그레이드/다운그레이드할 수 있어야 함
+- 사용자는 자동 갱신 설정을 변경할 수 있어야 함
+- 사용자는 이전에 구매한 구독을 복원할 수 있어야 함
+
+#### 인앱 결제
+- 앱은 플랫폼별(iOS, Android) 인앱 결제를 지원해야 함
+- 결제 과정은 안전하고 사용자 친화적이어야 함
+- 결제 오류 발생 시 적절한 피드백을 제공해야 함
+- 결제 완료 후 즉시 구독 상태가 업데이트되어야 함
+
+#### 기능 제한
+- 구독 플랜에 따라 사용 가능한 기능이 차등 적용되어야 함
+- 무료 사용자는 기본 기능만 사용할 수 있어야 함
+- 구독 만료 시 접근 가능한 기능이 제한되어야 함
+- 제한된 기능 접근 시 업그레이드 안내가 표시되어야 함
+
+#### 백엔드 연동
+- 구독 정보는 서버에 안전하게 저장되어야 함
+- 인앱 결제 영수증은 서버에서 검증되어야 함
+- 구독 상태는 여러 기기에서 동기화되어야 함
+- 구독 만료 및 갱신은 서버에서 처리되어야 함
+
+### 1.2 비기능적 요구사항
+
+#### 보안
+- 결제 정보는 안전하게 처리되어야 함
+- 영수증 검증은 서버 측에서 수행되어야 함
+- 사용자 인증 및 권한 관리가 적절히 구현되어야 함
+
+#### 성능
+- 구독 상태 확인은 빠르게 이루어져야 함
+- 결제 처리는 최소한의 지연으로 완료되어야 함
+- 오프라인 상태에서도 기본적인 기능은 사용 가능해야 함
+
+#### 사용성
+- 구독 및 결제 UI는 직관적이고 사용하기 쉬워야 함
+- 오류 메시지는 명확하고 이해하기 쉬워야 함
+- 구독 혜택 및 제한 사항이 명확하게 표시되어야 함
+
+#### 확장성
+- 새로운 구독 플랜 추가가 용이해야 함
+- 새로운 기능 및 제한 사항 추가가 용이해야 함
+- 다양한 결제 방식 추가가 가능해야 함
+
+## 2. 사용자 플로우
+
+### 2.1 구독 구매 플로우
+
+1. **구독 화면 접근**
+   - 사용자가 앱에서 '구독' 또는 '프리미엄' 메뉴를 탭함
+   - 또는 제한된 기능 접근 시 표시되는 업그레이드 안내에서 '구독하기' 버튼을 탭함
+
+2. **구독 플랜 선택**
+   - 사용 가능한 구독 플랜(기본, 프리미엄, 프로) 목록이 표시됨
+   - 각 플랜의 가격, 기능, 제한 사항 등이 표시됨
+   - 사용자가 원하는 플랜을 선택함
+
+3. **월간/연간 선택**
+   - 선택한 플랜의 월간 또는 연간 구독 옵션이 표시됨
+   - 사용자가 원하는 구독 기간을 선택함
+
+4. **결제 진행**
+   - 플랫폼별 인앱 결제 다이얼로그가 표시됨
+   - 사용자가 결제 정보를 입력하고 결제를 확인함
+   - 결제 진행 중 로딩 표시가 나타남
+
+5. **결제 완료**
+   - 결제가 성공적으로 완료되면 성공 메시지가 표시됨
+   - 구독 정보가 업데이트되고 구독 상세 화면으로 이동함
+   - 결제 실패 시 오류 메시지가 표시되고 재시도 옵션이 제공됨
+
+### 2.2 구독 관리 플로우
+
+1. **구독 정보 확인**
+   - 사용자가 '내 구독' 또는 '계정' 메뉴를 탭함
+   - 현재 구독 상태, 플랜, 시작일, 만료일, 자동 갱신 상태 등이 표시됨
+
+2. **플랜 변경**
+   - 사용자가 '플랜 변경' 버튼을 탭함
+   - 사용 가능한 다른 플랜 목록이 표시됨
+   - 사용자가 새 플랜을 선택하고 확인함
+   - 플랜 변경이 처리되고 구독 정보가 업데이트됨
+
+3. **자동 갱신 설정**
+   - 사용자가 '자동 갱신' 토글 버튼을 탭함
+   - 설정 변경 확인 다이얼로그가 표시됨
+   - 사용자가 확인하면 설정이 변경되고 구독 정보가 업데이트됨
+
+4. **구독 취소**
+   - 사용자가 '구독 취소' 버튼을 탭함
+   - 취소 확인 다이얼로그가 표시됨
+   - 사용자가 확인하면 구독이 취소되고 만료일까지 사용 가능함을 안내함
+
+### 2.3 구독 복원 플로우
+
+1. **복원 시작**
+   - 사용자가 '구독 복원' 버튼을 탭함
+   - 복원 진행 중 로딩 표시가 나타남
+
+2. **복원 결과**
+   - 복원 가능한 구독이 있으면 구독이 복원되고 성공 메시지가 표시됨
+   - 구독 정보가 업데이트되고 구독 상세 화면으로 이동함
+   - 복원할 구독이 없으면 안내 메시지가 표시됨
+
+### 2.4 제한된 기능 접근 플로우
+
+1. **기능 접근 시도**
+   - 사용자가 현재 구독 플랜에서 제한된 기능에 접근을 시도함
+
+2. **업그레이드 안내**
+   - 해당 기능에 접근하기 위해 필요한 구독 플랜 정보가 포함된 대화상자가 표시됨
+   - '구독하기' 버튼과 '취소' 버튼이 제공됨
+
+3. **사용자 선택**
+   - 사용자가 '구독하기'를 선택하면 구독 화면으로 이동함
+   - 사용자가 '취소'를 선택하면 이전 화면으로 돌아감
+
+## 3. 구독 플랜 및 기능
+
+### 3.1 무료 플랜
+- **기능**:
+  - 기본 볼링 점수 추적
+  - 최대 10명의 회원 관리
+  - 최대 5개의 이벤트 관리
+
+### 3.2 기본 플랜
+- **기능**:
+  - 모든 무료 기능
+  - 최대 30명의 회원 관리
+  - 최대 10개의 이벤트 관리
+  - 기본 통계 분석
+
+### 3.3 프리미엄 플랜
+- **기능**:
+  - 모든 기본 기능
+  - 최대 100명의 회원 관리
+  - 최대 50개의 이벤트 관리
+  - 고급 통계 분석
+  - 커스터마이징 옵션
+
+### 3.4 프로 플랜
+- **기능**:
+  - 모든 프리미엄 기능
+  - 최대 500명의 회원 관리
+  - 최대 200개의 이벤트 관리
+  - 우선 지원
+  - 모든 고급 기능 접근
+
+## 4. 오류 처리 시나리오
+
+### 4.1 결제 오류
+- **시나리오**: 사용자가 결제를 시도했으나 결제가 실패함
+- **처리**: 
+  - 오류 원인에 따른 명확한 메시지 표시
+  - 재시도 옵션 제공
+  - 문제 해결을 위한 안내 제공
+
+### 4.2 네트워크 오류
+- **시나리오**: 구독 정보 로드 또는 결제 중 네트워크 연결이 끊김
+- **처리**:
+  - 네트워크 오류 메시지 표시
+  - 자동 재연결 시도
+  - 오프라인 모드로 전환 (가능한 경우)
+
+### 4.3 서버 오류
+- **시나리오**: 서버에서 구독 정보 처리 중 오류 발생
+- **처리**:
+  - 서버 오류 메시지 표시
+  - 관리자에게 오류 보고
+  - 재시도 옵션 제공
+
+### 4.4 영수증 검증 오류
+- **시나리오**: 인앱 결제는 성공했으나 영수증 검증에 실패함
+- **처리**:
+  - 검증 오류 메시지 표시
+  - 자동 재검증 시도
+  - 수동 복원 옵션 제공
+
+## 5. 배포 및 유지보수 계획
+
+### 5.1 배포 준비
+- App Store 및 Google Play에 인앱 결제 상품 등록
+- 스토어 설명 및 스크린샷에 구독 정보 포함
+- 개인정보 처리방침 및 이용 약관 업데이트
+
+### 5.2 모니터링 및 분석
+- 구독 전환율 모니터링
+- 구독 취소율 및 원인 분석
+- 플랜별 사용자 행동 분석
+
+### 5.3 향후 개선 계획
+- 사용자 피드백에 기반한 구독 플랜 조정
+- 새로운 프리미엄 기능 추가
+- 추가 결제 방식 통합 검토