guardia-docs/33_GUARDiA_Messenger_앱_스토어_등록_가이드.md
DESKTOP-TKLFCPRython 820820ae1c docs(app): update store guide with screenshot paths and regen instructions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-31 20:42:11 +09:00

278 lines
6.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# GUARDiA Messenger 앱 스토어 등록 가이드
> **앱명**: GUARDiA Messenger
> **패키지**: kr.co.zioinfo.guardia
> **버전**: 1.0.0
> **작성일**: 2026-05-31
---
## 1. 사전 준비
### 1-1. 필요 계정
| 스토어 | 계정 | 비용 | 등록 링크 |
|--------|------|------|----------|
| **Google Play** | Google Play Developer | $25 (1회) | play.google.com/console |
| **Apple App Store** | Apple Developer Program | $99/년 | developer.apple.com |
| **Expo EAS** | Expo 계정 (무료) | 무료 | expo.dev |
### 1-2. 환경 준비
```bash
# EAS CLI 설치
npm install -g eas-cli
# Expo 로그인
eas login
# 프로젝트 초기화
cd C:\GUARDiA\app
eas init --id guardia-messenger-zioinfo
```
---
## 2. EAS Build — 클라우드 빌드 (Mac 불필요)
### 2-1. Android APK/AAB 빌드
```bash
cd C:\GUARDiA\app
# 테스트용 APK (내부 배포)
eas build --platform android --profile preview
# 스토어 배포용 AAB
eas build --platform android --profile production
```
빌드 완료 후 `.aab` 파일 다운로드 → Google Play Console에 업로드
### 2-2. iOS IPA 빌드
```bash
# App Store Connect용 IPA (Mac 없이 클라우드 빌드)
eas build --platform ios --profile production
```
> Apple Developer 계정이 필요하며 EAS가 자동으로 인증서와 프로파일을 관리합니다.
---
## 3. Google Play Store 등록
### 3-1. 앱 생성
1. **play.google.com/console** 접속 → Google Play Developer 로그인
2. [앱 만들기] 클릭
3. 정보 입력:
| 항목 | 값 |
|------|-----|
| 앱 이름 | GUARDiA Messenger |
| 기본 언어 | 한국어 |
| 앱 유형 | 앱 |
| 무료/유료 | 무료 |
### 3-2. 스토어 등록 정보
**앱 이름**: GUARDiA Messenger
**간략한 설명** (80자 이내):
```
AI 기반 IT 인프라 자율 운영 플랫폼 — GUARDiA ITSM 모바일 앱
```
**자세한 설명** (4000자 이내):
```
GUARDiA Messenger는 (주)지오정보기술의 AI 기반 레거시 인프라 자율 운영 플랫폼
GUARDiA ITSM과 연동하는 공식 모바일 앱입니다.
주요 기능:
• 서비스 요청(SR) 실시간 조회 및 등록
• AI 챗봇을 통한 자연어 인프라 명령
• 인시던트 및 긴급 알림 즉시 수신
• SLA 위반 경고 및 배포 상태 모니터링
• 라이선스 현황 확인
GUARDiA ITSM 서버 주소 입력 후 사용 가능합니다.
[지원]: guardia@zioinfo.co.kr
[회사]: (주)지오정보기술
```
**카테고리**: 비즈니스
**키워드**: ITSM, 인프라관리, IT운영, 서버관리, ChatOps, 모니터링
### 3-2-1. Play Store 스크린샷
**생성된 스크린샷 위치:**
```
C:\GUARDiA\app\store_screenshots\
├── play_01_login.png (1080×1920) — 로그인 화면
├── play_02_dashboard.png (1080×1920) — 대시보드
├── play_03_sr.png (1080×1920) — SR 관리
└── play_04_chat.png (1080×1920) — AI 챗봇
```
> ⚠️ Play Store 요구사항:
> - 최소 2장, 최대 8장
> - 크기: 320~3840px (16:9 또는 9:16)
> - JPEG 또는 24비트 PNG (알파 없음)
**스크린샷 재생성:**
```bash
python C:\GUARDiA\capture_store_screenshots.py
```
### 3-3. 콘텐츠 등급 설문
- 폭력: 없음
- 성인 콘텐츠: 없음
- 도박: 없음
-**모든 연령** 등급
### 3-4. AAB 업로드
```
프로덕션 트랙 → 새 버전 만들기
→ eas build에서 다운로드한 .aab 업로드
→ 버전 노트 (한국어):
"GUARDiA Messenger 첫 번째 릴리즈
- 대시보드, SR 관리, AI 챗봇, 알림"
→ 검토 시작 (2~7일 소요)
```
---
## 4. Apple App Store 등록
### 4-1. App Store Connect 앱 생성
1. **appstoreconnect.apple.com** 접속
2. [나의 앱] → [+] → [새 앱]
3. 정보 입력:
| 항목 | 값 |
|------|-----|
| 플랫폼 | iOS |
| 이름 | GUARDiA Messenger |
| 기본 언어 | 한국어 |
| 번들 ID | kr.co.zioinfo.guardia |
| SKU | guardia-messenger-kr |
### 4-2. 앱 정보
**카테고리**: 비즈니스 (Business)
**부제**: AI 기반 IT 인프라 운영 플랫폼
**프라이버시 정책 URL**:
```
https://zioinfo.co.kr/privacy
```
> ⚠️ App Store는 Privacy Policy URL이 필수입니다. 홈페이지에 개인정보처리방침 페이지를 추가해야 합니다.
### 4-3. 스크린샷
각 기기별 최소 1개 스크린샷 필요:
- iPhone 6.7인치 (1290×2796): **필수**
- iPhone 6.5인치 (1242×2688): 필수
- iPad Pro 12.9인치: 선택
**생성된 스크린샷 위치:**
```
C:\GUARDiA\app\store_screenshots\
├── ios67_01_login.png (1290×2796) — 로그인 화면
├── ios67_02_dashboard.png (1290×2796) — 대시보드
├── ios67_03_sr.png (1290×2796) — SR 관리
└── ios67_04_chat.png (1290×2796) — AI 챗봇
```
> ⚠️ 스크린샷은 실제 앱 화면과 일치해야 합니다. 앱 디자인 변경 시 `python C:\GUARDiA\capture_store_screenshots.py`로 재생성하세요.
**iPhone 6.5" 추가 생성 필요 시 (1242×2688):**
```python
# capture_store_screenshots.py 수정
IOS_W, IOS_H = 1242, 2688 # 6.7" 대신 6.5"
```
### 4-4. IPA 업로드 및 심사
```bash
# EAS Submit으로 자동 업로드
eas submit --platform ios --profile production
# 또는 Transporter 앱 사용 (Mac에서)
```
심사 기간: **1~3일** (영업일 기준)
---
## 5. 전체 진행 순서
```
1. Expo 계정 생성 (expo.dev)
2. eas login / eas init
3. Google Play Console 개발자 등록 ($25)
4. Apple Developer Program 등록 ($99/년)
5. eas build --platform android --profile production
6. eas build --platform ios --profile production
7. 각 스토어에 메타데이터 등록
8. 빌드 업로드 (eas submit 또는 수동)
9. 심사 대기 (Android 2~7일, iOS 1~3일)
10. 출시 🎉
```
---
## 6. 개인정보처리방침 (홈페이지 추가 필요)
App Store 필수 요구사항:
```
zioinfo.co.kr/privacy 페이지에 아래 내용 추가:
1. 수집 정보: 이메일, 사용자명 (JWT 인증 목적)
2. 보관 기간: 앱 삭제 시 즉시 삭제 (기기 내 보관)
3. 제3자 제공: 없음
4. 문의: guardia@zioinfo.co.kr
```
---
## 7. 빠른 시작 명령어
```bash
# 1. EAS 설정
cd C:\GUARDiA\app
npm install -g eas-cli
eas login
eas init
# 2. Android 빌드 (바로 가능)
eas build --platform android --profile preview
# → APK 다운로드 URL 생성 (테스트 설치 가능)
# 3. 정식 빌드
eas build --platform android --profile production
eas build --platform ios --profile production
```
---
*GUARDiA Messenger v1.0.0 | (주)지오정보기술 | 2026-05-31*