spt-launcher/docs/ui-ux.md

화면 목록(Screens)

1. 홈(Home)
   • 서버 상태(Health)
   • 로그인 상태
   • 모드 동기화 상태
   • 게임 실행 버튼
2. 로그인(Login)
   • 계정 입력/로그인 버튼
   • 실패 메시지 영역
3. 모드 동기화(Mod Sync)
   • 최신 버전 표시
   • 동기화 진행률
   • 로그/오류 출력
4. 설정(Settings)
   • 서버 URL(읽기 전용, 빌드 고정)
   • 모드 Git URL(읽기 전용, 빌드 고정)
   • 로그 폴더 열기

핵심 플로우(Flows)

앱 시작(App Launch)

1. 서버 상태(Health) 체크
2. 로그인 상태 확인(토큰 존재 여부 등)
3. 모드 상태 표시(로컬/원격 버전 비교는 추후 결정)
4. 사용자가 필요한 동작(로그인/동기화) 수행 후 실행

로그인(Login)

1. 로그인 화면 진입
2. 자격 증명 입력
3. 성공 시 홈으로 복귀, 실패 시 메시지 표시

모드 동기화(Sync)

1. 모드 동기화 화면 진입
2. 진행률 표시 및 결과 표시
3. 실패 시 재시도 제공

게임 실행(Launch)

1. 사전 조건 확인(서버/로그인/동기화)
2. 클라이언트 실행
3. 실패 시 오류 메시지 표시

상태/메시지 기준(States)

• 서버 상태: 정상/지연/불가
• 로그인 상태: 로그인됨/로그아웃됨/오류
• 동기화 상태: 최신/진행중/실패
• 실행 상태: 준비됨/차단됨/실행중

UX 원칙(UX Principles)

• 홈에서 현재 상태와 다음 행동을 즉시 알 수 있어야 함
• 실패는 즉시 이유와 해결 방법을 제시
• 동작 중에는 진행률과 남은 작업을 보여줌