대시보드 개요
tapflow 대시보드의 각 섹션을 간략히 설명합니다.
App Center
경로: /app-center
QA의 주요 작업 공간입니다. 업로드된 모든 빌드를 앱별로 정리해 보여줍니다.
| UI 요소 | 기능 |
|---|---|
| 앱 카드 | bundle ID + 플랫폼으로 빌드를 그룹화합니다. 클릭하면 빌드 목록이 펼쳐집니다. |
| 빌드 행 | 버전, 빌드 번호, 상태 배지, 업로드 날짜, 업로더를 표시합니다. |
| 상태 배지 | Backlog · In Progress · Done · Rejected — 클릭해서 변경 가능 (Developer 또는 Admin). |
| Upload Build | 빌드 업로드 다이얼로그를 엽니다. .app.zip (iOS) 또는 .apk (Android)를 허용합니다. |
| 댓글 | 빌드별 스레드 댓글. 스크린샷 첨부 가능. 팀 전체에 공개됩니다. |
| 디바이스 카드 | 사용 가능한 디바이스를 보여줍니다. ● = 부팅됨, ○ = 사용 가능. 클릭하면 세션이 시작됩니다. |
QA 세션
경로: /app-center/build
디바이스 전체 화면 뷰입니다. App Center에서 디바이스 카드를 클릭하면 열립니다.
| 조작 | 설명 |
|---|---|
| 터치 | 시뮬레이터 화면 어디서나 클릭 또는 탭으로 터치 이벤트를 전송합니다. |
| 스와이프 | 클릭한 채로 드래그합니다. |
| 핀치 | 트랙패드에서 두 손가락 핀치 제스처를 사용합니다. |
| Home / Back | 컨트롤 바의 버튼 (플랫폼별로 다름). |
| FPS 표시 | 우측 상단에서 현재 프레임레이트를 확인합니다. |
| 세션 종료 | 브라우저와 디바이스의 연결을 끊고 디바이스를 사용 가능 상태로 되돌립니다. |
화면은 ~30fps의 스트리밍으로 제공됩니다. 프레임레이트는 네트워크 상태에 따라 자동으로 조절됩니다.
녹화
경로: /app-center/build (세션 중)
QA 세션을 녹화하고 팀과 공유할 수 있습니다.
| 요소 | 설명 |
|---|---|
| 녹화 시작/중지 | 세션 컨트롤 바에서 녹화를 시작하고 멈춥니다. |
| 녹화 목록 | 빌드별로 저장된 녹화 파일 목록을 확인합니다. |
| 다운로드 | 녹화 파일을 로컬에 저장합니다. |
녹화 보관 기간
녹화 파일은 생성 후 72시간 동안 보관됩니다. 장기 보관이 필요하면 다운로드해 별도로 저장하세요.
Mac Resources
경로: /mac-resources
연결된 모든 Mac 에이전트의 CPU·RAM 사용량을 확인합니다. 세션 배정 전에 과부하된 호스트를 미리 파악하는 데 유용합니다.
| 요소 | 설명 |
|---|---|
| 에이전트 카드 | 연결된 Mac 한 대당 카드 한 장. 호스트명과 현재 CPU·RAM을 표시합니다. |
| 시계열 차트 | CPU %(파란색)와 RAM %(회색) 히스토리. |
| 범위 선택 | 1h / 6h / 24h / 7d — 표시 기간을 전환합니다. |
데이터는 1분마다 샘플링되며 30일간 보관됩니다.
Settings
왼쪽 사이드 내비게이션에서 접근할 수 있는 세 개의 하위 페이지가 있습니다.
Default
현재 로그인한 사용자의 개인 프로필 설정입니다.
- Display name — 댓글과 세션 히스토리에 표시됩니다.
- Avatar — 아바타의 연필 아이콘을 클릭해 이미지를 업로드합니다 (PNG 또는 JPEG, 최대 2MB).
- Change password — 현재 비밀번호가 필요합니다.
Team
Admin 전용으로 표시됩니다.
- Members list — 전체 계정 목록 (이메일, 역할, 가입 날짜).
- Invite member — 이메일 초대 발송 또는 직접 공유용 링크 생성. 초대는 7일 후 만료됩니다.
- Change role — 멤버의 역할 재지정 (Admin / Developer / QA / Viewer).
- Remove member — 계정을 영구 삭제합니다. 자기 자신은 삭제할 수 없습니다.
- Reset password — 특정 멤버에게 비밀번호 재설정 이메일을 발송합니다.
Tokens
CI/CD 스크립트와 API 접근을 위한 Personal Access Token (PAT)을 관리합니다.
- Create token — 이름과 선택적 만료일을 입력합니다. 토큰은 생성 직후 한 번만 표시됩니다. 즉시 복사하세요.
- Revoke — 즉시 토큰을 무효화합니다.
CI에서 빌드를 업로드할 때 Authorization: Bearer tflw_pat_<token> 헤더로 사용합니다. 빌드 업로드 (CI/CD)를 참고하세요.