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.
This commit is contained in:
parent
9c2b6a9782
commit
7fe49c437e
144 changed files with 3760 additions and 4523 deletions
85
docs/evidence/2026-11-04-mobile-runtime-a11y.md
Normal file
85
docs/evidence/2026-11-04-mobile-runtime-a11y.md
Normal file
|
|
@ -0,0 +1,85 @@
|
|||
# 2026-11-04 mobile runtime and accessibility evidence
|
||||
|
||||
All times are KST. This report keeps source, Android runtime, automated accessibility inspection, and manual screen-reader proof separate. No app data was cleared, no package was uninstalled, no default input method was changed, and no notification or accessibility setting was intentionally changed.
|
||||
|
||||
## Verdict
|
||||
|
||||
| Gate | Result | Boundary |
|
||||
|---|---|---|
|
||||
| Current-source Android artifact | **PASS (E2E, not production)** | `1.16.1-e2e.20261104.1` / `2026110401`, non-debuggable, arm64-v8a + x86_64. This is not a signed production AAB. |
|
||||
| State-preserving install and launch | **PASS** | `adb install -r` on a Fold6 running Android 16 and an isolated API 34 AVD. Existing app data was retained. |
|
||||
| Notifications screen | **PASS for the already-granted/registered state** | The physical-device flow opened Notifications and asserted its status, privacy, and recent-notification cards without pressing a permission action. It does not prove permission denial/request/acceptance or real FCM delivery. |
|
||||
| Automated Android accessibility | **PARTIAL PASS** | App-owned actionable nodes inspected on Home and Login were named and at least 48dp. The ad slot exposed one unlabeled clickable SDK WebView. Font scale 2.0 and portrait/landscape scrolling were checked on the AVD. |
|
||||
| Manual TalkBack | **NOT RUN** | TalkBack was installed but not enabled on the physical device. UIAutomator output is not screen-reader announcement, focus-order, or activation proof. |
|
||||
| iOS / VoiceOver | **NOT AVAILABLE** | The host is Windows. No iOS simulator/device or VoiceOver proof is claimed. |
|
||||
|
||||
## Artifact, install, launch, and logs
|
||||
|
||||
Build and verification:
|
||||
|
||||
```text
|
||||
cd apps/mobile-rn/android
|
||||
D3RO_VERSION_NAME=1.16.1-e2e.20261104.1
|
||||
D3RO_VERSION_CODE=2026110401
|
||||
gradlew.bat :app:assembleE2e -PreactNativeArchitectures=arm64-v8a,x86_64 --no-daemon
|
||||
|
||||
node scripts/ci/verify-android-artifact.mjs \
|
||||
--apk apps/mobile-rn/android/app/build/outputs/apk/e2e/app-e2e.apk \
|
||||
--mode e2e \
|
||||
--expected-version-name 1.16.1-e2e.20261104.1 \
|
||||
--expected-version-code 2026110401 \
|
||||
--expected-admob-app-id ca-app-pub-3940256099942544~3347511713
|
||||
```
|
||||
|
||||
- Gradle: `BUILD SUCCESSFUL`, 644 tasks, about 3m42s.
|
||||
- APK: 147,160,979 bytes; SHA-256 `3d2875c74b555dbcd854468e57b9b4b3a8e6c9657f210760cbe24a77ee92cf7c`.
|
||||
- Verifier: package `com.d3ro.voice`, minSdk 24, targetSdk 36, `debuggable:false`, ABIs arm64-v8a/x86_64, test AdMob application ID, expected model hash, and signer inspection all passed.
|
||||
- `adb install -r` passed on both targets. The physical device retained `firstInstallTime=2026-11-01 10:55:50`; the AVD retained `firstInstallTime=2026-11-01 10:32:43`.
|
||||
- Cold `am start -W` completed in 185ms on the physical device and 1,024ms on the AVD. `MainActivity` became the resumed activity.
|
||||
- The inspected recent logcat window contained zero `FATAL EXCEPTION`, app `AndroidRuntime` process crash, or React fatal signature matches. This is a bounded window, not a long-duration ANR/privacy-log audit.
|
||||
|
||||
## Notifications screen without permission mutation
|
||||
|
||||
The reusable flow is [`apps/mobile-rn/.maestro/notifications-permission-preserve-state.yaml`](../../apps/mobile-rn/.maestro/notifications-permission-preserve-state.yaml). It launches with `clearState:false`, opens More → Notifications, and asserts these stable cards:
|
||||
|
||||
- `notification-status-card`
|
||||
- `notification-privacy-card`
|
||||
- `notification-recent-card`
|
||||
|
||||
It contains no `setPermissions`, permission-button tap, app-data clear, or reinstall step. On the Fold6 it passed **1/1 in 30s**. Local retained output is under `apps/mobile-rn/.maestro-output/wave4-notifications-state-neutral-20261104/`, including `results.xml`, the command trace, and `artifacts/screenshots/notifications-status-preserved.png`.
|
||||
|
||||
The rendered state was already **Registered**: Firebase configured, registration bound to the current device/account, privacy copy present, and no item received in the current session. This proves the screen and the current registered-state rendering; it does not prove transport delivery.
|
||||
|
||||
An earlier read showed `POST_NOTIFICATIONS` denied, while a later read showed it granted even though neither retained flow contains a permission request command. That transition cannot be attributed from the captured evidence. Therefore permission preservation across a denied-state run, the user-facing request/deny flow, and the Android system dialog remain open gates.
|
||||
|
||||
## Automated accessibility inspection
|
||||
|
||||
The checks combined source inspection with `uiautomator dump`; they did not use TalkBack.
|
||||
|
||||
- Physical Home at font scale 1.15: 16 clickable nodes, no target smaller than 48dp at the device's override density. Fifteen app-owned actions had a text or content description. The remaining clickable node was an `android.webkit.WebView` inside the banner ad slot.
|
||||
- API 34 AVD Login: all six actionable controls (Google sign-in, email, password, Sign in, Forgot password, Sign up) had labels and met the 48dp target. A focusable `ScrollView` was excluded because it is a container, not an action.
|
||||
- API 34 AVD at font scale 2.0: the portrait login controls remained reachable. In locked landscape, upward scrolling exposed password, Sign in, Forgot password, and Sign up. The AVD was restored to its prior `font_scale=null`, portrait rotation, and accelerometer setting after the check.
|
||||
- Source scan found accessibility attributes across the React Native surface, and focused Jest coverage passed for navigation, `ScreenHeader`, ads, and notification native/runtime paths. This is evidence for the inspected routes only, not an app-wide focus-order audit.
|
||||
|
||||
### AdMob ownership boundary
|
||||
|
||||
The app-owned wrapper in `FreeTierBanner.tsx` has `testID="free-tier-ad-slot"` and the translated `mobile.ads.sponsored` accessibility label. The pinned `react-native-google-mobile-ads@16.3.4` banner API explicitly does not forward standard `View` props; its `BaseAd` renders `RNGoogleMobileAdsBannerView`, and its Android manager creates the Google Mobile Ads SDK `AdView`, which supplies the observed WebView descendant.
|
||||
|
||||
Accordingly, the one unlabeled clickable WebView is an SDK-rendered descendant inside an app-owned labeled slot. The automated tree did not expose the wrapper label on that clickable descendant. Making the wrapper a single accessibility element could also hide or change activation of the SDK ad, so no behavior-changing workaround was applied without manual TalkBack proof. The announcement and activation behavior remains open.
|
||||
|
||||
## Source gates run after the device check
|
||||
|
||||
| Command | Result |
|
||||
|---|---|
|
||||
| `npm --prefix apps/mobile-rn run lint` | PASS, zero warnings/errors |
|
||||
| `npm --prefix apps/mobile-rn run typecheck` | PASS |
|
||||
| Focused Jest: notifications, native/cold-start notifications, navigation shell, ScreenHeader, mobile ads | **6 suites / 38 tests PASS** |
|
||||
|
||||
## Open gates
|
||||
|
||||
- Manual TalkBack announcements, traversal order, gesture activation, and the AdMob descendant behavior on a physical device.
|
||||
- Android notification permission deny/request/accept/system-settings transitions without resetting personal state.
|
||||
- Real foreground/background/terminated FCM delivery and notification deep-link receipt.
|
||||
- App-wide font-scale/rotation coverage beyond the inspected Login route.
|
||||
- iOS build/device, APNs receipt, dynamic type, and VoiceOver.
|
||||
- Signed production AAB, Play distribution, and production AdMob serving.
|
||||
115
docs/evidence/2026-11-05-tablet-layout-audit.md
Normal file
115
docs/evidence/2026-11-05-tablet-layout-audit.md
Normal file
|
|
@ -0,0 +1,115 @@
|
|||
# 태블릿(대화면) 레이아웃 실기 감사 — 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회)으로 둔다.
|
||||
Loading…
Add table
Add a link
Reference in a new issue