d3ro-voice/docs/evidence/2026-11-05-tablet-layout-audit.md
Yun Chan 7fe49c437e chore: land in-progress workspace changes before 1.16.2
The tree carried uncommitted work from several areas (web push, mobile
screens, admin charts, test-hygiene cleanup, CI and map docs). It is landed
as one commit so the release pipeline can start from a clean tree; the
desktop transcript-correction behaviour shipped in the previous commit and
is unchanged here.
2026-11-05 21:58:44 +09:00

115 lines
7.3 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.

# 태블릿(대화면) 레이아웃 실기 감사 — 2026-11-05
**질문**: 타블렛에서 앱 레이아웃이 괜찮은가?
**답**: 기능은 동작하지만 **대화면 대응이 없다.** 모든 화면이 "넓어진 휴대폰" 한 열이다.
---
## 1. 접속 경로 (실제로 어떻게 붙었는지)
| 시도 | 결과 |
|---|---|
| `100.117.18.16:33455` (제시된 주소) | **ECONNREFUSED** — Tailscale 로 호스트는 살아 있으나 해당 포트에 리스너가 없다. |
| `adb connect 100.117.18.16:33455` | 실패 (10061). 무선 디버깅 포트는 재시작마다 바뀐다. |
| `adb mdns services` | `adb-R54Y9036G4A` @ `192.168.0.17:36769` = **tab-s11-ultra**. 현재 포트는 36769. |
| `adb connect 100.117.18.16:36769` / `192.168.0.17:36769` | 실패 — 이 PC 와 **페어링되어 있지 않다**(무선 디버깅 페어링 코드 필요). |
| `adb pair 100.117.18.16:44865 113625` | **성공** → 이후 `adb connect 100.117.18.16:40479` (port 는 페어링 직후 mDNS `_adb-tls-connect` 값). |
| 페어링된 실기기 | **SM-X930 (Galaxy Tab S11 Ultra)** — 1848×2960, density override 320 → **924dp**, 기본 가로 모드. |
| 보조 기기 | **SM-F956N (Galaxy Z Fold6)** — `device_state state 3` 로 펼침(825dp) 재현에도 사용. |
**실기기 재현 (Tab S11 Ultra)**:
```bash
ADB="$LOCALAPPDATA/Android/Sdk/platform-tools/adb.exe"
"$ADB" pair 100.117.18.16:44865 <6자리 페어링 코드>
"$ADB" mdns services # _adb-tls-connect 포트 확인 후
"$ADB" connect 100.117.18.16:40479
"$ADB" -s 100.117.18.16:40479 install -r apps/mobile-rn/android/app/build/outputs/apk/e2e/app-e2e.apk
"$ADB" -s 100.117.18.16:40479 shell am start -W -n com.d3ro.voice/.MainActivity
"$ADB" -s 100.117.18.16:40479 exec-out screencap -p > tab.png
```
**재현 방법 (페어링 없이, 실기기 변경 최소)**: Fold6 은 `device_state` 오버라이드로 "펼친(OPENED)" 상태를
시뮬레이션할 수 있다. 실제 화면을 접었다 펴지 않아도 inner display 크기(1856×2160 @ density 360 ≈ 825dp 폭)가
적용되어 태블릿 판정에 쓸 수 있다.
```bash
ADB="$LOCALAPPDATA/Android/Sdk/platform-tools/adb.exe"
S="<adb serial>"
"$ADB" -s "$S" shell cmd device_state state 3 # OPENED (inner display)
"$ADB" -s "$S" shell am start -W -n com.d3ro.voice/.MainActivity
"$ADB" -s "$S" shell dumpsys SurfaceFlinger --display-id # 캡처할 display id 확인
"$ADB" -s "$S" exec-out screencap -p -d <displayId> > shot.png
"$ADB" -s "$S" shell cmd device_state state 0 # 원상복구 (CLOSED)
```
> 캡처는 `test-results/tablet-2026-11-05/` (gitignored, 커밋 안 됨). 스크린샷에 실제 기록 데이터가 찍혀 있어
> 개인정보 보호를 위해 저장소에 넣지 않는다.
측정 조건: 물리 1856×2160, density override 360 → **약 825dp 폭**. Material large(≥600dp)·태블릿 판정 구간에 들어간다.
---
**실기기(Tab S11 Ultra 924dp 가로) 결과** — Fold6 시뮬레이션과 동일한 결론이 더 뚜렷하게 재현됐다.
| 화면 | 실측 |
|---|---|
| 온보딩/튜토리얼 1/5 | 본문 텍스트 노드 폭 **2880px(900dp)** — 한 줄이 화면 전체를 가로지른다. 카드 2개도 full-width. |
| Login | Google 버튼·이메일·비밀번호·로그인 버튼 모두 **2880px(900dp)** 폭. 태블릿에서 폼 최대 폭(400~480dp) 부재. |
| Recorder | `START RECORDING` / `IMPORT AUDIO FILE` 버튼이 **2880px(900dp)** full-width. 오류 배너도 full-width. |
| Home (가로) | `home-record-*` 행이 **40..2920px**, `See all` 이 우측 끝(2824..2920). 한 행이 900dp. |
| Records (가로) | 동일. 배지(`17 W`)·Star/Delete 가 우측 끝, 제목/본문과 800dp 이상 떨어짐. |
| Meetings (가로) | 카드 full-width + 카드마다 큰 세로 여백. 목록 4번째 카드가 화면 아래로 잘림(스크롤 필요). |
| More (가로) | 라벨 ↔ chevron 사이 ≈**800dp** 공백. `Voice actions` 아래 항목은 광고 슬롯 뒤로 스크롤해야 보임. |
| 세로(portrait) | 폰과 같은 1열 구성. 924dp 폭이라 여전히 줄 길고 카드가 넓다. |
**광고 슬롯 실측**: `free-tier-ad-slot` = `0,1472 - 2960,1654` (전체 폭, 높이 182px ≈ 91dp), 탭 바는
`1656..1752`. 슬롯은 탭 바 위에 **정상 배치**되어 있고 콘텐츠는 그 위에서 끝난다(가림 아님).
다만 슬롯이 91dp 를 차지하므로 작은 화면에서 목록 가용 높이가 줄어든다.
**성능 관찰**: Records 탭 첫 진입이 실기기에서 **5~10초 빈 스피너**였다(이후 20건 표시). 레이아웃 문제는 아니지만
대화면에서 빈 화면이 크게 보이므로 체감이 나쁘다.
## 2. 판정 (스크린별, Fold6 825dp 시뮬레이션)
| 화면 | 관찰 | 판정 |
|---|---|---|
| Home | 한 열, 폭 전체 사용. 본문 줄 길이 과다(한글/영문 혼합 전사문 1줄 100자+). 광고 배너가 콘텐츠 하단 위로 자리 이동. | ⚠ 넓어진 휴대폰 |
| Records | 동일. 카드 우측 badge(17 W)·Star/Delete 가 화면 끝(≈800dp)에 몰려 시선 이동 거리 큼. | ⚠ |
| Meetings | 카드 full-width + 카드마다 불필요한 세로 여백. **2열 그리드 후보**. | ⚠ |
| More | 9개 항목이 full-width, 라벨과 chevron 사이 ≈700dp 공백. **2열 그리드 후보**. | ⚠ |
| Dictionary | 카드 1장이 폭 전체. Edit/Delete 버튼이 각각 화면 절반 폭(≈400dp) — 모바일 버튼 크기가 아님. | ⚠ |
| Commands | 4개 카드 세로 스택. "Activate" 버튼이 카드 좌측에 작게 붙어 균형 붕괴. | ⚠ |
| Templates | "Select" 버튼이 full-width(≈800dp) — 클릭 타깃이 과대. | ⚠ |
공통 원인:
1. **화면 레벨 콘텐츠 최대 폭/그리드가 없다.** `useWindowDimensions`·breakpoint·`numColumns` 사용처가 0건.
(`maxWidth` 는 모달·입력 필드에만 존재.)
2. `supportsTablet: true` 는 iOS manifest 에만 있고 레이아웃 계획은 없다(`docs/v3/00-mobile-master-plan.md:688`).
3. 적응형 배너(`ANCHORED_ADAPTIVE_BANNER`, slot `minHeight: 50`)가 로드 후 728×90 → 468×60 으로 바뀌며
탭 바 높이가 변한다. 콘텐츠가 가려지진 않지만(끝까지 스크롤 확인) **초기 레이아웃 시프트**가 있다.
---
## 3. 개선 제안 (우선순위)
1. **공용 콘텐츠 컬럼**: `packages/ui-native` 에 `useContentWidth()`(예: `Math.min(windowWidth, 720)`)와
`ContentColumn` 을 추가하고 탭 화면 7곳에 적용. 가장 값싸고 회귀 위험이 낮다.
2. **2열 그리드**: `≥600dp` 에서 More/Meetings/Commands/Templates 를 `FlatList numColumns={2}` 로.
(More 는 섹션 헤더가 있어 섹션별 그리드 또는 `flexWrap` 카드.)
3. **버튼 폭 제한**: full-width 버튼은 `maxWidth: 320`(모바일 버튼 규격)로 제한.
4. **배너 시프트 제거**: slot 높이를 광고 실측 높이로 고정하거나, 로드 전 `minHeight` 를 90 으로 예약.
5. **실기기 회귀 방지**: Maestro 플로우에 `open`/`closed` 2회 실행을 추가하고, 대화면 스크린샷을 증거로 남긴다.
---
## 4. 재현/검증 명령 (수동)
```bash
# 대화면 시뮬레이션 후
"$ADB" -s "$S" shell cmd device_state state 3
"$ADB" -s "$S" shell cmd device_state state 0 # 반드시 원복
```
자동화로 만들 경우 `device_state` 오버라이드는 실기기 설정을 바꾸므로 CI 에 넣지 않고,
로컬 릴리스 전 점검(Maestro `open`/`closed` 2회)으로 둔다.