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

7.3 KiB
Raw Blame History

태블릿(대화면) 레이아웃 실기 감사 — 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):

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 폭)가 적용되어 태블릿 판정에 쓸 수 있다.

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. 재현/검증 명령 (수동)

# 대화면 시뮬레이션 후
"$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회)으로 둔다.