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
|
|
@ -1,7 +1,7 @@
|
|||
# D3RO-VOICE 리팩토링 정책 (SSOT)
|
||||
|
||||
> 마지막 갱신: 2026-07-22 — Wave 1 정책 수립
|
||||
> 적용 범위: `apps/desktop` + `packages/{core,ui,i18n}` (web/admin/site/server/mobile은 별도 wave)
|
||||
> 마지막 갱신: 2026-11-04 — Wave 4 전체 모노레포 위생 점검 정책 확정
|
||||
> 적용 범위: `apps/*` + `packages/*` + `server/*` + `site/` + 빌드·배포 스크립트 (기능 변경은 별도 요청)
|
||||
|
||||
## 0. 전제: 기존 3계층 규칙 SSOT와의 관계
|
||||
|
||||
|
|
@ -51,7 +51,7 @@ D3RO는 이미 3계층 강제 규칙 체계를 가진다. 본 정책은 이를 *
|
|||
- **확정: 3회** (2026-07-22 합의)
|
||||
|
||||
### DP8. 자동화 — typecheck + lint + test + 강제 규칙 훅
|
||||
- WS 통합 후 반드시 GREEN: `npm run typecheck`(turbo) · `npm run lint` · `npm run test` · `npm run build`(빌드 영향 WS).
|
||||
- WS 통합 후 반드시 GREEN: `npm run typecheck`(npm workspaces) · `npm run lint` · `npm run test` · `npm run build`(빌드 영향 WS).
|
||||
- UI 변경: `npm run dev`로 화면 1회 확인. (WS3은 화면별 즉시)
|
||||
|
||||
---
|
||||
|
|
@ -122,3 +122,35 @@ D3RO는 이미 3계층 강제 규칙 체계를 가진다. 본 정책은 이를 *
|
|||
| W3-8 | 사이트 배포 | Cloudflare Pages 한 경로. GitHub Pages·NAS wwwroot 복사 경로 삭제 | — |
|
||||
|
||||
DRY 원칙 보강: Deno처럼 정본을 직접 import할 수 없는 런타임은 **생성 사본 + `--check` 게이트**로만 복제를 허용한다(`version:sync` 패턴과 같음). 손으로 옮겨 적은 사본은 금지.
|
||||
|
||||
---
|
||||
|
||||
## Wave 4 (2026-11-04) — 두 번째 전체 위생 점검
|
||||
|
||||
사용자 지시: "두 번째 소스코드 정리, 대대적인 위생 점검." 기존 DP1~DP11과 Wave 3 정본 결정을 그대로 계승한다.
|
||||
|
||||
### W4-1. 목표와 비목표
|
||||
|
||||
- 목표: 전체 모노레포에서 증거가 확인된 데드코드·데드 스텁·중복 선언/동작·의존성 잔여물·계약 드리프트·빌드/스크립트 중복을 줄인다.
|
||||
- 비목표: 새 기능, UI/UX·문구 변경, DB 마이그레이션, 공개 API/IPC/payload의 breaking 변경, 비밀값·운영 서버 변경, 릴리스·배포는 제외한다. 실제 DB와 어긋난 공유 타입의 additive 정합화는 소비자 전체 typecheck를 조건으로 허용한다.
|
||||
- 추측만으로 대형 파일을 쪼개거나 이름을 바꾸지 않는다. 삭제 우선 → 계약 안정화 → 중복 통합 순서를 지키고, 의미 있는 중복 제거 없이는 새 추상화를 만들지 않는다.
|
||||
|
||||
### W4-2. 유지 불변량
|
||||
|
||||
- 공개 API·IPC 채널, 오류 코드/메시지, 결과 순서, 보안 경계, 저장·동기화 의미, 광고·결제 fail-closed 동작은 유지한다.
|
||||
- 화면 상태와 시각 결과는 유지한다. UI 동작 변경이 필요한 발견은 이번 Wave에서 기능 변경 후보로 분리하고 순수 정리와 섞지 않는다.
|
||||
- 기존 사용자 변경과 무관한 파일을 되돌리지 않으며, 현재 정책 문서 변경 외에는 감사 단계에서 소스를 수정하지 않는다.
|
||||
|
||||
### W4-3. 감사와 실행 분리
|
||||
|
||||
- 감사 A: 데스크톱 main/preload + `packages/core` — 서비스 경계, IPC·타입 SSOT, 데드코드/스텁, 중복 워크플로, any/console, 캐시 소유권.
|
||||
- 감사 B: desktop renderer + web/admin/mobile/site + `packages/ui`/`ui-native` — 디자인 토큰, i18n, 중복 UI/스타일, 미사용 컴포넌트와 export, any/console.
|
||||
- 감사 C: `packages/i18n` + server + 빌드/CI/의존성/스크립트 — 로케일 정합, 계약 사본, 미사용 의존성, 설정 중복, 문서-코드 드리프트.
|
||||
- 모든 후보는 `file:line`, 참조/호출 증거, HIGH/MED/LOW 확신도, DELETE/REPLACE/REFACTOR/KEEP 판정과 예상 게이트를 가져야 한다. KEEP도 이유를 명시하고, HIGH라도 구현 전에 다시 읽어 false positive를 걸러낸다.
|
||||
|
||||
### W4-4. 패치 그룹과 검증
|
||||
|
||||
- 파일이 겹치지 않는 P1 삭제/잔여물, P2 중복·SSOT, P3 설정/의존성 그룹으로 나눈다. 순수 리팩토링과 불가피한 기능 수정은 절대 같은 그룹에 두지 않는다.
|
||||
- 그룹마다 잔여 식별자 grep, 최소 표적 테스트, 변경 파일 lint를 먼저 실행하고, 통합 후 루트 `typecheck`·`test`·`lint`, 모바일 `typecheck`·`test`·`lint`, 영향받은 빌드와 `version:check`·`contract:check`를 실행한다.
|
||||
- packages 공유 계약 변경은 모든 소비 앱을 검사한다. UI 시각 변경은 원칙적으로 제외하며, 예외가 생기면 별도 합의와 시각 증거가 필요하다. 에이전트 서브쉘에서 Electron GUI를 백그라운드 실행하지 않는다.
|
||||
- 커밋·푸시는 사용자가 별도로 명시할 때만 수행한다. 이번 Wave는 패치 그룹별 diff와 검증 증거를 보존하고, `docs/REFACTOR_WAVE4_REPORT.md`에 변경/검증/SKIP/잔여 위험을 기록한다.
|
||||
|
|
|
|||
111
docs/REFACTOR_WAVE4_REPORT.md
Normal file
111
docs/REFACTOR_WAVE4_REPORT.md
Normal file
|
|
@ -0,0 +1,111 @@
|
|||
# Refactor Wave 4 Report — 두 번째 모노레포 위생 점검
|
||||
|
||||
> 기준일: 2026-11-04
|
||||
> 기준 버전: 1.16.1 (버전 변경 없음)
|
||||
> 범위: `apps/*`, `packages/*`, `server/*`, `site/`, CI/build 설정과 현재 맵
|
||||
> 정책: [`REFACTOR_POLICY.md`](./REFACTOR_POLICY.md) Wave 4
|
||||
|
||||
## 1. 결론
|
||||
|
||||
Wave 4는 공개 API·IPC와 사용자 데이터 계약을 유지하면서, 실제 참조가 없는 코드·의존성·도구 설정을 제거하고 중복된 quota/DB 계약을 정본에 연결했다. 감사 중 드러난 기능 결함은 source-only repair로 분리했으며, 실행 환경이나 외부 시스템 증거가 없는 항목은 완료로 올리지 않았다.
|
||||
|
||||
커밋, 푸시, 배포, 릴리스, linked/운영 DB migration 적용, 사용자 데이터 변경은 수행하지 않았다. 런타임 증거는 별도 project id·포트·볼륨의 격리 로컬 Supabase에서 throwaway fixture로만 만들었다.
|
||||
|
||||
## 2. 불변 조건과 감사 방식
|
||||
|
||||
- 공개 IPC, preload, 서비스 singleton, 외부 소비 가능 export는 이름 검색만으로 삭제하지 않았다.
|
||||
- 삭제 후보는 정의→생산자→소비자→테스트/문서 순서로 확인하고, 각 묶음 뒤 잔여 참조를 다시 검색했다.
|
||||
- 순수 삭제·타입 정리(P1/P2)와 동작을 바꾸는 source repair(P3/P4)를 분리했다.
|
||||
- UI 구조·높이·행동은 바꾸지 않았다. `site` LED shadow는 같은 값을 theme token으로 옮겼다.
|
||||
- feature/runtime 상태는 자동화 통과만으로 `[x]`로 올리지 않았다.
|
||||
|
||||
## 3. Changed
|
||||
|
||||
### P1 — 순수 삭제와 의존성 위생
|
||||
|
||||
- 참조가 없던 web meeting trend chart 1개와 admin chart 3개를 삭제하고 web/admin의 `recharts` 및 lockfile 전이 의존성을 제거했다.
|
||||
- 참조가 없던 desktop `feature-gate.ts`와 내부 getter/helper 7종을 삭제했다. 공개 IPC·테스트 seam·singleton API는 유지했다.
|
||||
- 사용되지 않던 `turbo.json`, `pnpm-workspace.yaml`, api-client의 `@d3ro/core` 의존성을 제거하고 npm workspaces 하나만 남겼다.
|
||||
- api-client 의존성 제거 뒤 mobile의 독립 lockfile도 같은 해상도로 다시 생성해 제거된 `@d3ro/core` 전이 항목을 남기지 않았다.
|
||||
- 현재 실행 규칙과 Claude 보조 스킬에 남은 pnpm/Turbo 명령도 npm workspace 기준으로 교정했다.
|
||||
- web login/sidebar의 도달 불가능한 `t(...) ?? fallback` 15곳을 제거했다.
|
||||
|
||||
### P2 — 타입과 경계 정리
|
||||
|
||||
- mobile 11개 화면의 `useNavigation<any>`/`useRoute<any>`와 임시 route param list를 `RootStackParamList` 기반 exact type으로 교체했다.
|
||||
- `TalkScreen`의 직접 `console.warn`을 공용 logger로 이동했다.
|
||||
- api-client에 실제 DB와 맞는 `PushProvider`, `PushToken`, device-bound register/unregister RPC, `consume_quota.p_period` 타입을 추가했다.
|
||||
- web push는 `deviceId`를 필수로 하고 RLS/NOT NULL 계약과 충돌하던 직접 `push_tokens` upsert를 제거했다. 활성 device를 검증하는 `register_push_registration` RPC만 사용한다. Opt-out은 disabled intent를 먼저 기록하고 서버 unregister와 local unsubscribe를 bounded/parallel로 실행하며, logout의 sign-out은 cleanup을 기다리지 않는다.
|
||||
|
||||
### P3 — SSOT와 i18n 정합화
|
||||
|
||||
- `knowledge_embedding` quota를 `packages/core/src/plan-catalog.ts`의 `PLAN_QUOTA`에 편입하고 Deno generated contract를 재생성했다. `embedding-quota.ts`의 수기 tier 상수는 제거했다.
|
||||
- updater native dialog 16키를 12 locale catalog에 추가했다. prompt마다 현재 locale translator를 다시 읽어 같은 prompter의 ko→en 변경도 반영한다.
|
||||
- `site` LED의 raw box-shadow 3개를 Tailwind theme token으로 이동했다. 시각 값은 유지했다.
|
||||
|
||||
### P4 — 분리된 기능/인프라 repair
|
||||
|
||||
- root `test:mobile`을 mobile `test:ci`(`jest --runInBand`)에 고정했다.
|
||||
- root `build:all`과 Forgejo build-validation에 web production build를 추가했다.
|
||||
- web/admin typecheck는 clean checkout에서도 Next route/root-param 타입을 먼저 생성하도록 `next typegen && tsc --noEmit` 순서로 고정했다.
|
||||
- Forgejo quality job에 migration checker self-test와 실제 metadata/order 검사를 연결했다. 이 검사는 DB replay나 remote drift 검사가 아니다.
|
||||
- pg_cron service credential을 handler에서 검증하는 `audio-purge`에 `verify_jwt = false`를 명시해 gateway가 먼저 차단하지 않도록 했다. handler의 fail-closed 인증은 유지했다.
|
||||
- Supabase CLI 3.x가 제거한 `[inbucket]` 설정명을 `[local_smtp]`로 교체했다. 포트와 메일 동작 계약은 유지했다.
|
||||
- Web Push production sidebar를 explicit user-gesture permission → stable active web device → device-bound register RPC로 연결했다. Persistence 실패는 local subscription을 rollback하고, stale local subscription은 서버 재등록이 성공하기 전까지 connected로 표시하지 않으며, missing build-time VAPID key는 unavailable로 fail-closed한다. Standalone Docker 이미지에는 `public/sw.js`를 명시적으로 포함한다.
|
||||
- updater native dialog는 `--preview-update-dialogs` packaged-QA entry에서 실제 prompter의 네 분기를 updater/feed/download/install/settings 부작용 없이 순서대로 띄울 수 있게 했다. entry/prompt 계약과 12-locale parity는 자동화했고, GUI 외형은 외부 터미널 수동 게이트로 남겼다.
|
||||
- packaged native verifier는 실제 `uiohook-napi/prebuilds/<platform>-<arch>/uiohook-napi.node`를 필수로 검사하고, 누락/존재 fixture self-test와 상대·절대 package 경로를 검증한다. better-sqlite3 ABI repair와 N-API prebuild 존재 계약을 분리했다.
|
||||
|
||||
### 문서와 상태 교정
|
||||
|
||||
- 12개 catalog의 2,742키 parity와 실제 surface 노출을 분리했다. Desktop은 12 locale이지만 web은 selector가 없고 mobile은 ko/en만 노출하므로 `SHELL-03`의 W/M은 `[~]`다.
|
||||
- Web Push production call site와 build-time public-key 계약을 추가했지만 provider secrets·배포된 drain·실브라우저 수신 증거가 없으므로 ACC-12 W와 GAP-PUSH-03은 `[~]`로 유지했다.
|
||||
- meeting memo의 content 기반 CAS가 A→B→A를 감지하지 못할 수 있는 문제를 `GAP-SYNC-08`로 등록했다.
|
||||
- audio-purge는 격리 로컬 pg_cron/Vault/객체 삭제까지 검증했고, 운영 배포·스케줄 실행만 `GAP-OPS-04`에 남겼다. surface locale 확대는 `GAP-I18N-03`으로 남겼다.
|
||||
- release SSOT는 현재 `1.16.1` / `1160100` / `2026-11-04`로, site deploy는 삭제된 GitHub 경로 없이 Forgejo→Cloudflare Pages 정본으로 교정했다. 손상된 INFRA-19 설명도 실제 GitLab/Forgejo native/updater gate에 맞췄다.
|
||||
|
||||
## 4. KEEP / DEFER 결정
|
||||
|
||||
- 공개 IPC/TTS/history/service 메서드는 현재 내부 호출이 적어도 compatibility surface일 수 있어 유지했다.
|
||||
- STT driver DTO와 유사 타입은 공급자별 의미가 달라 이번 wave에서 억지로 합치지 않았다.
|
||||
- `MeetingMemo` revision 추가는 DB migration과 동시성 통합 증거가 필요해 구현하지 않고 gap으로 분리했다.
|
||||
- Web Push의 provider 설정·실브라우저 수신, locale selector/routing, updater packaged GUI, audio-purge 운영 deploy/cron은 로컬 증거만으로 완료 처리하지 않았다.
|
||||
- updater의 ko 이외 신규 키는 기존 locale 정책과 같은 English parity다. 번역 품질 확대는 별도 작업이다.
|
||||
|
||||
## 5. Verification
|
||||
|
||||
최종 통합 게이트 결과는 모든 변경을 합친 worktree 기준으로 기록한다.
|
||||
|
||||
| Gate | Result |
|
||||
|---|---|
|
||||
| Root typecheck/test + desktop/admin/web builds (`npm run build:all`) | PASS — 233 files / 3,383 tests; desktop build; admin 18/18; web 18/18 |
|
||||
| Root lint | PASS — warnings 0 |
|
||||
| Mobile typecheck/lint/test (`test:ci`) | PASS — 87 suites / 599 tests, lint warnings 0 |
|
||||
| Root/mobile lock install dry-run | PASS — `npm ci --dry-run --ignore-scripts`; removed dependencies do not survive in either lock |
|
||||
| Core generated contract + version + design token gates | PASS — contract current; 1.16.1 / 1160100; design violations 0 |
|
||||
| .NET API tests | PASS — 28/28, skipped 0 |
|
||||
| Migration checker self-test/actual | PASS — 73 migrations |
|
||||
| Isolated Supabase runtime/shadow | PASS — empty + reset replay 73/73; `pg-delta --strict-coverage` diff 0; audio purge direct + pg_cron/Vault HTTP/storage path |
|
||||
| Edge CI-equivalent Deno check/test | PASS — 24 function entrypoints; Supabase 263 tests; Cloudflare drain 5 tests (268 total) |
|
||||
| Site production build | PASS — client/SSR + 10 locale prerender and sitemap/robots/llms outputs |
|
||||
| `git diff --check` + residual searches | PASS — CRLF→LF notices only; deleted identifiers/dependencies/current toolchain commands 0 residual |
|
||||
|
||||
이미 묶음별로 확인한 증거:
|
||||
|
||||
- updater preview/startup/i18n 4 files / 7 tests, locale parity 15 tests; native ABI self-test and the current package's relative/absolute `--dir` verification
|
||||
- api-client 4 files / 31 tests
|
||||
- web push device/RPC/permission/rollback/reconciliation/logout contract 17 tests
|
||||
- core plan quota matrix test와 `contract:check`
|
||||
- mobile route/logger targeted suites, strict typecheck, lint
|
||||
- embedding quota/embed/search/audio-purge 표적 31 tests와 전체 Edge CI-equivalent 268 tests
|
||||
- web/admin production build, site build, design-token scan
|
||||
- migration checker 73 files + self-test
|
||||
- 격리 Supabase: missing/non-service key 401, service 200; queue/`audio_files`/Storage fixture `1|1|1`→`0|0|0`; cron run `succeeded`, pg_net HTTP 200
|
||||
|
||||
## 6. 검증 경계와 남은 위험
|
||||
|
||||
- Supabase local migration replay, shadow diff, `audio-purge` direct/pg_cron/object deletion은 격리 stack에서 검증했다. linked remote drift와 배포된 운영 함수·Vault·cron은 실행하거나 변경하지 않았다.
|
||||
- Electron GUI를 agent subshell에서 실행하지 않았다. updater dialog의 packaged-app 시각/상호작용 증거는 없다.
|
||||
- current-source E2E APK의 state-preserving 설치·cold launch와 제한된 Notifications/status/UIA 경로는 물리 Fold6에서 검증했다. 이것은 fresh first-run, manual TalkBack/focus order, notification permission transition/real FCM, app-wide accessibility, production artifact 또는 iOS/VoiceOver 증거가 아니다. Web Push는 격리 local browser에서 device/token/outbox/drain 및 provider-accepted `delivered` row까지 확인했지만 service-worker/browser receipt는 확인하지 못했다. Production standalone은 build/serve 후 throwaway login navigation timeout으로 dashboard 전 단계에서 중단돼 production 1440/390, accessibility tree/hit target, permission/subscription journey도 미검증이다.
|
||||
- npm install은 현재 Node 23에 대한 React Native engine 경고와 기존 audit 이슈를 보고했다. 범위를 벗어난 `npm audit fix`는 실행하지 않았다.
|
||||
- 빌드 산출물 배포, 버전 변경, 릴리스 publication은 수행하지 않았다.
|
||||
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
# Push transport without Firebase — analysis
|
||||
|
||||
> Status: decision note (2026-09-13)
|
||||
> Scope: `send-push` Edge Function, `server/supabase/migrations` push outbox, `apps/mobile-rn` notification stack
|
||||
> Status: decision note (2026-09-13; implementation status updated 2026-11-04)
|
||||
> Scope: `send-push` Edge Function, `server/supabase/migrations` push outbox, web/mobile notification clients
|
||||
> Question: we already pay for Supabase. Can it replace Firebase for notifications?
|
||||
|
||||
---
|
||||
|
|
@ -9,7 +9,7 @@
|
|||
## 0. TL;DR
|
||||
|
||||
- **Supabase already is the push backend.** Tokens, devices, durable outbox, leases, retries, and delivery audit all live in Supabase (`push_tokens`, `devices`, `push_deliveries`, `push_dispatch_attempts`, `send-push`). Firebase is only the **last hop** to the device.
|
||||
- **Web and iOS are now Firebase-free on the server side.** Web Push (VAPID + RFC 8291 aes128gcm) and Apple APNs (`.p8` token) transports are implemented in `send-push` (`_shared/webpush.ts`, `_shared/apns.ts`, 10 unit tests). Client registration for those providers is the remaining work.
|
||||
- **Web and iOS are Firebase-free in source.** Web Push (VAPID + RFC 8291 aes128gcm) and Apple APNs (`.p8` token) transports are implemented in `send-push`; the web sidebar and mobile client contain provider-specific registration paths. This does not prove production delivery: matching provider secrets, a deployed drain, authenticated browser/device permission, and real receipt are still open gates.
|
||||
- **Android cannot drop Firebase without changing transport.** Google Play Services only delivers push through FCM, and the FCM registration token is minted by the Firebase Messaging SDK, which requires `google-services.json` (a Firebase project). Supabase cannot substitute for that hop.
|
||||
- **The scheduled drain was missing and is now added.** Nothing in the repo triggered `send-push?mode=drain`, so transactionally enqueued notifications never left the outbox. A Cloudflare Cron Trigger now drains it every minute.
|
||||
- **Firebase-free Android is possible but is a different product decision:** UnifiedPush + a self-hosted distributor (e.g. ntfy). Third-party push services (OneSignal, Pusher) do **not** remove the Firebase dependency; they wrap FCM.
|
||||
|
|
@ -23,14 +23,10 @@
|
|||
| Token + device registry | Supabase | `push_tokens`, `devices`; writes via `register_push_registration` RPC; RLS denies direct access |
|
||||
| Durable outbox + retry/lease | Supabase | `push_deliveries`, `push_dispatch_attempts`, `claim_due_push_dispatches`, `finalize_push_delivery` |
|
||||
| Dispatch orchestration | Supabase Edge `send-push` | Auth, event resolution, batching, stale-token handling |
|
||||
| **Transport** | **FCM** | `_shared/push-contract.ts` → `https://fcm.googleapis.com/v1/projects/<id>/messages:send`, OAuth2 via `FCM_SERVICE_ACCOUNT_JSON` |
|
||||
| **Transports** | **FCM / Web Push / APNs** | `_shared/push-contract.ts`, `_shared/webpush.ts`, `_shared/apns.ts`; all route through `send-push` |
|
||||
| Android client | Firebase Messaging SDK | `com.google.firebase:firebase-messaging`, `D3ROFirebaseMessagingService`, `google-services.json`; `FIREBASE_CONFIGURED` build flag |
|
||||
|
||||
Provider values accepted but unimplemented (`send-push/index.ts`):
|
||||
```
|
||||
const unsupported = deliveries.filter((delivery) => delivery.provider !== 'fcm')
|
||||
→ finalizeDelivery(..., 'permanent_failure', 'push_provider_not_supported')
|
||||
```
|
||||
| Web client | Browser Push API | `/app/sw.js`; sidebar opt-in/out binds a stable active web device to the `webpush` registration through RPCs |
|
||||
| iOS client | Native APNs bridge | Mobile registration chooses `provider: 'apns'` on iOS and unregisters through the shared RPC |
|
||||
|
||||
So: the only Firebase-specific pieces are (a) the FCM HTTP v1 send + service account, and (b) the Android client token source.
|
||||
|
||||
|
|
@ -41,15 +37,17 @@ So: the only Firebase-specific pieces are (a) the FCM HTTP v1 send + service acc
|
|||
### Desktop — no change needed
|
||||
In-app events use IPC/EventEmitter and Supabase Realtime. No push transport, no Firebase.
|
||||
|
||||
### Web — Firebase-free, implementable now
|
||||
### Web — Firebase-free, implemented in source
|
||||
- Standard **Web Push** with **VAPID** keys. The browser Push API + service worker handles delivery; the server signs with a VAPID private key and POSTs to the subscription endpoint.
|
||||
- Supabase plan: store `push_subscriptions` (endpoint + keys per browser), send from `send-push` with a VAPID JWT (ES256).
|
||||
- The sidebar requests permission from an explicit user gesture, creates/checks in a stable active `platform='web'` device, and stores the serialized subscription in `push_tokens` through `register_push_registration`. Opt-out records a per-user disabled intent before bounded parallel server/local cleanup; an existing local subscription is re-registered through the server RPC before the UI may call it connected. Logout starts cleanup without waiting and always proceeds to sign-out.
|
||||
- `NEXT_PUBLIC_VAPID_PUBLIC_KEY` is baked into the browser bundle and must match the Edge Function's `WEBPUSH_VAPID_PUBLIC_KEY`; a missing browser key leaves the control unavailable.
|
||||
- No Firebase, no Google account. APNs not involved.
|
||||
|
||||
### iOS — Firebase-free, implementable now
|
||||
### iOS — Firebase-free, implemented in source
|
||||
- **APNs** directly: `.p8` key + Key ID + Team ID → JWT (ES256) → `https://api.push.apple.com/3/device/<token>`.
|
||||
- Needs an Apple Developer membership (already needed for App Store), **not** a Firebase project.
|
||||
- Supabase Edge Function can hold the `.p8` as a secret and sign the JWT with WebCrypto.
|
||||
- The mobile notification service chooses `provider: 'apns'` for iOS. A signed-device run with real APNs credentials and receipt is still required.
|
||||
|
||||
### Android — Firebase-free only via UnifiedPush
|
||||
- Google Play Services delivers notifications through FCM. The official `FirebaseMessaging` SDK mints the registration token, and it requires `google-services.json`. There is no supported way to obtain an FCM token without a Firebase project.
|
||||
|
|
@ -75,23 +73,25 @@ If the goal is "no Firebase at all", the decision reduces to: replace Android tr
|
|||
|
||||
1. **Keep Supabase as the SSOT/outbox** (already true). Do not move token/outbox logic.
|
||||
2. **[done] Implement `webpush` + `apns` transports** in `send-push` (`_shared/webpush.ts`, `_shared/apns.ts`).
|
||||
3. **For Android, offer two modes behind config:**
|
||||
3. **[source done] Register web/APNs clients through the device-bound RPCs.** Keep provider configuration and real delivery as runtime gates.
|
||||
4. **For Android, offer two modes behind config:**
|
||||
- `fcm` (default): minimal Firebase project, push-only usage.
|
||||
- `unifiedpush` (opt-in): self-hosted ntfy distributor; documented UX and battery caveats.
|
||||
4. **Do not adopt OneSignal/Pusher** as a "Firebase replacement" — it does not remove the dependency.
|
||||
5. **Do not adopt OneSignal/Pusher** as a "Firebase replacement" — it does not remove the dependency.
|
||||
|
||||
### Effort sketch
|
||||
| Item | Effort | Risk |
|
||||
|---|---|---|
|
||||
| Web Push (VAPID) transport + tests | S–M | low — **done** |
|
||||
| APNs (JWT ES256 `.p8`) transport + tests | M | medium — **server done**, Apple key + client registration pending |
|
||||
| Web browser device/subscription flow | M | medium — **source + contract tests done**, live configuration/delivery pending |
|
||||
| APNs (JWT ES256 `.p8`) transport + client registration | M | medium — **source + unit tests done**, Apple key/live delivery pending |
|
||||
| Cloudflare cron drain | S | low — **done** |
|
||||
| UnifiedPush Android (client lib + distributor + server transport) | L | high (UX, battery, distributor dependency) |
|
||||
| Minimal Firebase project for Android FCM | S (external action) | low |
|
||||
|
||||
---
|
||||
|
||||
## 5. Implemented (2026-09-13)
|
||||
## 5. Implemented (2026-09-13; client update 2026-11-04)
|
||||
|
||||
| Piece | Where | Notes |
|
||||
|---|---|---|
|
||||
|
|
@ -100,16 +100,24 @@ If the goal is "no Firebase at all", the decision reduces to: replace Android tr
|
|||
| Provider routing | `send-push/index.ts` | `fcm` / `webpush` / `apns` dispatched with per-delivery stale → `stale`, payload → `permanent_failure`, else retryable; unknown providers stay `push_provider_not_supported` |
|
||||
| Cloudflare cron drain | `server/cloudflare-worker/src/push-drain.ts` + `scheduled()` + `wrangler.toml [triggers] crons` | POSTs `send-push?mode=drain&limit=…` with the service-role bearer every minute |
|
||||
| Tests | `_shared/webpush.test.ts`, `_shared/apns.test.ts`, `push-drain.test.ts`, `push-contract.test.ts` | 10 new tests incl. an RFC 8291 decrypt round-trip; CI runs the edge suite and the worker drain test |
|
||||
| Web client | `apps/web/public/sw.js`, `src/lib/{web-device,web-push,web-push-session}.ts`, `web-push-control.tsx` | Explicit opt-in/out, stable active device, device-bound RPCs, persistence rollback, disabled-intent reconciliation, bounded parallel cleanup, non-blocking logout; standalone image copies the service worker |
|
||||
| Web contract tests | `apps/web/e2e/web-push.spec.ts` | 17 tests for installation identity, revoked-device refusal, permission/VAPID gate, register/unregister RPCs, rollback, stale-subscription reconciliation, bounded cleanup, and logout independence |
|
||||
| iOS client registration | `apps/mobile-rn/src/features/notifications/*` | Platform-aware APNs/FCM registration and unregister path; unit-tested, not live-delivery verified |
|
||||
|
||||
### Local runtime evidence (2026-11-04)
|
||||
|
||||
An ephemeral VAPID pair, throwaway user, isolated Supabase project, and throwaway Chrome profile proved browser opt-in, one active web device, one device-bound `webpush` token, one pending dispatch, a completed local drain, and a `push_deliveries.status='delivered'` result. That last state means the Web Push endpoint accepted the request; it does **not** prove that the service worker displayed or received a notification. No browser receipt was observed. A later production-standalone attempt built and served successfully but timed out during throwaway login navigation before the dashboard, so production-rendered desktop/mobile accessibility, permission/subscription, and receipt remain explicit gates. All ephemeral keys, rows, user data, and the browser profile were removed; the isolated stack was restored without VAPID configuration and then deleted.
|
||||
|
||||
### Required configuration
|
||||
| Secret / var | Consumer | Purpose |
|
||||
|---|---|---|
|
||||
| `WEBPUSH_VAPID_PUBLIC_KEY` / `WEBPUSH_VAPID_PRIVATE_KEY` / `WEBPUSH_SUBJECT` | Supabase Edge Function | VAPID signing; subject must be `mailto:` or `https:` |
|
||||
| `NEXT_PUBLIC_VAPID_PUBLIC_KEY` | Web image build | Public half of the same VAPID pair, baked into the client bundle; missing means unavailable/fail-closed |
|
||||
| `APNS_KEY_ID` / `APNS_TEAM_ID` / `APNS_PRIVATE_KEY` / `APNS_TOPIC` / `APNS_ENVIRONMENT` | Supabase Edge Function | APNs token auth; topic is the bundle id (`com.d3ro.voice`) |
|
||||
| `SUPABASE_URL` / `SUPABASE_SERVICE_ROLE_KEY` / `PUSH_DRAIN_BATCH_LIMIT` | Cloudflare Worker | Cron drain target + auth (service role key as `wrangler secret`) |
|
||||
|
||||
### Remaining work
|
||||
- **Client registration:** the mobile app currently registers only `fcm`. Web needs a service worker + `pushManager.subscribe` → store the JSON subscription as the registration id; iOS needs an APNs device token and `provider: 'apns'`.
|
||||
- **Runtime proof:** configure matching web/server VAPID values and APNs credentials, build/deploy the web image and Edge/cron code, then prove authenticated browser/iOS registration, outbox drain, and real receipt. Source and automated contract tests alone do not satisfy this gate.
|
||||
- **Android decision:** keep FCM or adopt UnifiedPush (see §2/§3).
|
||||
|
||||
---
|
||||
|
|
@ -121,6 +129,7 @@ If the goal is "no Firebase at all", the decision reduces to: replace Android tr
|
|||
- `server/supabase/functions/_shared/apns.ts` — APNs (.p8 token)
|
||||
- `server/supabase/functions/send-push/index.ts` — dispatch orchestration
|
||||
- `server/cloudflare-worker/src/push-drain.ts` — cron drain
|
||||
- `apps/web/src/lib/web-push-session.ts` + `apps/web/src/components/layout/web-push-control.tsx` — browser device/subscription orchestration
|
||||
- `apps/mobile-rn/src/features/notifications/*` — client token/provider contract
|
||||
- `docs/map/11-gap-backlog.md` `GAP-PUSH-01` / `GAP-PUSH-02` / `EXT-FIREBASE-01`
|
||||
- `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` `EXT-011`
|
||||
|
|
|
|||
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회)으로 둔다.
|
||||
|
|
@ -2,7 +2,11 @@
|
|||
|
||||
> Status: ACTIVE
|
||||
> Last full audit: 2026-09-13
|
||||
> Last update: 2026-11-04 — **Windows v1.16.1 패치 배포.** 빠른 한영 자판 교정이 다음 키 입력과 백스페이스 배치 사이에서 경합하지 않도록 140ms 입력 간격 게이트와 유휴 후 현재 영역 일괄 교정을 적용했다. 데스크톱 2,773개 테스트·typecheck·프로덕션 빌드·변경 범위 lint가 GREEN이며, 설치본과 서명된 업데이트 메타데이터를 Forgejo에 게시하고 공개 피드와 설치 파일 HTTP 200을 확인했다. 1.16.1 설치 후 Latin 대조군 GUI와 물리 키보드·Chromium/terminal 검증은 남아 있다.
|
||||
> Last update: 2026-11-04 — **테스트 위생 재편.** 버그헌팅 E2E(red-team cycle) 스펙과 중복·죽은 스펙 11개를 삭제하고, 데스크톱 E2E 를 공용 Electron 픽스처 + 5개 보호 여정으로 통합했다. 루트 `tests/e2e` 와 일회성 Playwright 러너 7개도 제거. 새 게이트 `npm run test:hygiene`(+`:test`)를 CI 두 파이프라인에 넣어 `.only`/이유 없는 skip/가짜 단정/머신 경로/`waitForTimeout`/`.e2e.test.ts` 를 막는다. 정본: [`docs/tdd-red/06-repo-application.md`](../tdd-red/06-repo-application.md).
|
||||
>
|
||||
> Previous update: 2026-11-04 — **Wave 4 모노레포 위생 점검.** 사용되지 않는 chart/recharts·feature gate·내부 선언·Turbo/pnpm 잔여를 제거하고, mobile navigation 타입/로깅, push·quota 계약, embedding quota SSOT, updater dialog i18n, CI web build·migration metadata gate, `audio-purge` 함수 설정을 정합화했다. Web Push production call site, 12-locale 표면 노출, meeting memo ABA conflict, audio-purge 배포/pg_cron은 완료로 올리지 않고 `11`에 남겼다. 제품 버전은 1.16.1 그대로이며 커밋·푸시·배포·릴리스는 수행하지 않았다. 상세: [`REFACTOR_WAVE4_REPORT.md`](../REFACTOR_WAVE4_REPORT.md).
|
||||
>
|
||||
> Previous update: 2026-11-04 — **Windows v1.16.1 패치 배포.** 빠른 한영 자판 교정이 다음 키 입력과 백스페이스 배치 사이에서 경합하지 않도록 140ms 입력 간격 게이트와 유휴 후 현재 영역 일괄 교정을 적용했다. 데스크톱 2,773개 테스트·typecheck·프로덕션 빌드·변경 범위 lint가 GREEN이며, 설치본과 서명된 업데이트 메타데이터를 Forgejo에 게시하고 공개 피드와 설치 파일 HTTP 200을 확인했다. 1.16.1 설치 후 Latin 대조군 GUI와 물리 키보드·Chromium/terminal 검증은 남아 있다.
|
||||
>
|
||||
> Previous update: 2026-11-02 — Windows 1.16.0 실GUI에서 회의 파일 선택→전사→로컬 요약 생성을 확인했다. 네이티브 한글 IME는 100% CPU 및 `gemma4:e4b` 콜드 로딩 중 7/7 정확히 통과했다. 한영 자판 교정 대조군은 다음 키가 백스페이스에 섞이는 결함을 재현했고, 소스에서는 140ms 입력 간격 게이트와 유휴 후 현재 영역 일괄 교정으로 수정했다. 데스크톱 2,773개 테스트·빌드는 GREEN이지만 수정본 설치 GUI와 모바일 운영 배포는 남아 있다. 상세 증거: [2026-11-02 verification](../evidence/2026-11-02-verification.md).
|
||||
>
|
||||
|
|
@ -29,7 +33,7 @@
|
|||
> Previous update: 2026-09-22 — **Gemma/Ollama 폭주 방어 계약을 기록했다.** 19:14:12 부팅 워밍업이 `keep_alive: 30m`으로 `gemma4:e4b`를 19:44:12까지 VRAM 3,226,342,521 bytes / context 4096으로 강제 상주시킨 것이 관측됐으며, 같은 시점 Windows GPU Engine PID 표본에는 Ollama의 활성 compute가 없었다. 즉 당시 상태는 무한 추론이 아니라 강제 residency였다. 19:11:17~19:11:58의 자동 제안 연속 생성은 기존 900 ms·12/min·5 candidates·128 tokens·한 글자 재생성 정책이 허용한 burst였다. 현재 구현 계약은 부팅 warmup 제거, `keep_alive: 2m`, 제안 600 ms / 최소 5 s 간격 / 기본 6회·hard max 12회 per min / 3 candidates / 64 tokens / 12-char growth / 8 s timeout, 그리고 요청별 취소·상한·종료 정리다. 독립 표적 검증은 6 test files / 69 tests passed / 0 failed, 변경 코드·테스트 ESLint와 `git diff --check`도 exit 0이다. Raw Ollama에서는 cold bounded 요청이 client hard timeout 15.044 s에 취소된 뒤 `/api/ps`가 비었고 `/api/version`은 80 ms에 회복했다. 명시 warmup은 HTTP 200 / 16.639 s, 후속 warm 요청은 body `options.num_predict=1`, `keep_alive='2m'`로 553 ms HTTP 200 / `done:true` / `eval_count:1` / `done_reason:length`였고 `/api/ps` expiry는 약 119.9 s였다. **19:48:59 +09:00에는 새 generate/unload/kill/retry 없이 충분히 지난 뒤 한 번의 `/api/ps`가 HTTP 200 / 45.8 ms / `{models:[]}`였고 `/api/version`은 HTTP 200 / 7.3 ms / `0.32.13`이었다.** 이는 raw API 수준의 expiry 뒤 unload 확인일 뿐 앱 재시작·GUI·실제 타이핑 증거는 아니므로 상태는 `[~]`로 유지한다 (`11` GAP-LLM-04, GAP-INPUT-06).
|
||||
>
|
||||
> Previous update: 2026-09-21 — **Input intelligence (입력 레메트리 + 다음 문장 제안) 신규**. 데스크톱에 입력 수집기(`InputTelemetryService`), UIA 컨텍스트 브리지(사이드카 `GET /uia/focus`), 제안 서비스(`SuggestionService`), 어렛 커 오버레이, 설정 > 입력 탭(동의·정책·주간 인사이트·개인 문구)을 추가했다. 카탈로그에 `INPUT-01`~`INPUT-08`(전부 데스크톱 `[~]` — 유닛 48건은 GREEN 이지만 **실앱 타이핑 검증 전**), 백로그에 GAP-INPUT-01~05 + GAP-LLM-03, §7 에 CONSTRAINT-INPUT-01(키 내용 미저장 — ActivityWatch 정책 채택)을 기록. 설계 근거는 조사 기반이다: 어렛은 `GetGUIThreadInfo` 가 아니라 UIA `TextPattern.GetSelection`(Chromium 은 `TextPattern2` 미구현), 타이핑 스트는 키코드 복원이 아니라 UIA 스냅샷 diff(한/일 IME 대응), 디바운스/토큰 한도는 인라인 컴플리션 실측값(Continue 350 / Tabby 250 / twinny 300 ms, 출력 64~256 토큰). 의존성: `koffi` 3.3.1(포그라운드 창 FFI), 사이드카 `uiautomation` 2.0.29 + `comtypes`. 데스크톱 유닛 총계 1409(+49), Electron ABI 실행에서 신규 실패 0건. 당시의 24.7초/4.9초 지연 설명과 `keep_alive: 30m`·부팅 워밍업 처방은 **현재 상태가 아닌 과거 가설/완화 이력**이며, 최신 운영 결론은 위 2026-09-22 항목과 `11` GAP-LLM-04를 따른다. 직전: LLM instruction-prompt fix (`9c2b4d4`): the custom-instruction path inserted the instruction's own wording instead of the processed result and had **never worked in any shipped release** (`v0.1.0-alpha`..`v1.4.0`, introduced `fea923d` 2026-04-05, not a regression). `llm-prompts.ts` is now the SSOT for prompt resolution and placeholder substitution, shared by `VoiceModeService` / `ChainService` / `LLM.PROCESS`. AI-04/05/06/07 are demoted to `[~]` on desktop — fixed with unit tests, but **not verified in a running app** and the four related `tests/red/*.usecase.test.ts` could not execute (`better-sqlite3` ABI). New: GAP-LLM-01 (no target-language setting), GAP-LLM-02 (this fix unverified); GAP-INFRA-06 amended (the ABI masks verification, not just dev-env switching cost); GAP-I18N-01 amended (`popup.error.default` missing in 10 locales). Earlier the same day: CAP-16 (desktop key bindings rebuilt on one `@d3ro/core/keybinding` SSOT — multiple bindings per action, mouse buttons, `HOTKEY` → `KEYBINDING` IPC group), verified on Windows by a manual run, so CAP-16 and CAP-02 are `[x]` and GAP-KEY-01 is closed. Still open: GAP-KEY-02/03, GAP-QA-02, GAP-I18N-01/02, GAP-INFRA-06, GAP-LLM-01/02, GAP-INPUT-01~05; `11` §7 holds accepted design constraints (things deliberately kept, not gaps)
|
||||
> Scope: entire monorepo `D:/workspace/D3ROVoice` at product version `1.14.0` (`release/product-version.json`, released 2026-10-29)
|
||||
> Scope: entire monorepo `D:/workspace/D3ROVoice` at product version `1.16.1` (`release/product-version.json`, released 2026-11-04)
|
||||
> Purpose: let any agent (or human) answer two questions in under a minute:
|
||||
> 1. **What infrastructure exists?** (build, CI, services, APIs, data, packages, deploy)
|
||||
> 2. **How far is each feature developed?** (per surface, with file anchors and status)
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# 02 — Repository & Infrastructure Map
|
||||
|
||||
> Surface: whole repo
|
||||
> Last updated: 2026-11-04 — Windows 1.16.1 installer and signed update metadata published; public feed and installer availability verified
|
||||
> Last updated: 2026-11-04 — Wave 4 toolchain/CI map reconciliation; Windows 1.16.1 release evidence remains unchanged
|
||||
> Source of truth for: layout, workspaces, build/test commands, CI/CD, Docker, deploy, scripts, resources
|
||||
|
||||
---
|
||||
|
|
@ -34,20 +34,20 @@ D:/workspace/D3ROVoice
|
|||
├── scripts/ ~145 automation scripts + scripts/ci/ (31) + scripts/lib/
|
||||
├── docs/ Design, phases, v2/v3 plans, deployment, map/ (this map)
|
||||
├── memory/ Project status, handoffs, archive
|
||||
├── tests/e2e/, test-results/ Root-level e2e + last-run artifacts
|
||||
├── test-results/ Last-run artifacts (root tests/e2e removed 2026-11-04 — orphaned duplicates)
|
||||
├── scratch/ Large local evidence (APKs, screenshots, DBs) — not build input
|
||||
├── supabase/ Empty scaffolding (.branches/, snippets/) — real project is server/supabase
|
||||
├── .gitlab-ci.yml GitLab CI (primary desktop/mobile release pipeline)
|
||||
├── .forgejo/workflows/ Forgejo Actions (CI, site deploy to Cloudflare Pages, payple-renew cron, portable/release)
|
||||
├── docker-compose.yml, docker-compose.nas.yml
|
||||
├── apps/api-server/Dockerfile, apps/admin/Dockerfile, apps/web/Dockerfile
|
||||
├── turbo.json, tsconfig.json, tsconfig.base.json, pnpm-workspace.yaml
|
||||
├── tsconfig.json, tsconfig.base.json
|
||||
├── package.json monorepo root, npm workspaces
|
||||
├── CLAUDE.md Claude-specific project rules
|
||||
└── AGENTS.md Cross-agent entry: rules + map obligation (this map's anchor)
|
||||
```
|
||||
|
||||
Note: root `package.json` declares npm workspaces `apps/desktop`, `apps/web`, `apps/admin`, `packages/*`. `pnpm-workspace.yaml` also exists (`apps/*`, `packages/*`) but npm is the active toolchain. **Mobile is intentionally outside the workspace.**
|
||||
Note: root `package.json` is the only workspace manifest and declares npm workspaces `apps/desktop`, `apps/web`, `apps/admin`, `packages/*`. The unused `turbo.json` and `pnpm-workspace.yaml` manifests were removed in Wave 4. **Mobile is intentionally outside the workspace.**
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -58,13 +58,12 @@ Note: root `package.json` declares npm workspaces `apps/desktop`, `apps/web`, `a
|
|||
| Node | 24.19.0 | `.nvmrc` |
|
||||
| TypeScript | 5.7 | root `package.json` |
|
||||
| .NET SDK | 10.0.300 (rollForward latestPatch) | `global.json` |
|
||||
| Deno | 2.8.1 | CI (`edge-functions-quality`) |
|
||||
| Deno | 2.8.1 | CI (`edge-functions`) |
|
||||
| JDK | 17 | mobile CI |
|
||||
| Electron | 33.4.11 | `apps/desktop/electron-builder.yml` |
|
||||
| koffi | 3.3.1 | `apps/desktop/package.json` — FFI into user32/kernel32 for foreground window title/pid/exe/bounds (`utils/win32-foreground.ts`). Chosen over `get-windows` because that package needs an install script this repo does not run; koffi ships N-API 8 prebuilds as optional deps. `asarUnpack` covers `koffi`/`@koromix`. |
|
||||
| uiautomation / comtypes | 2.0.29 / 1.4.17 | `apps/desktop/sidecar/requirements.txt` (Windows only) — UI Automation snapshot behind `GET /uia/focus` (`sidecar/uia_bridge.py`). Dev install: `apps/desktop/sidecar/.venv/Scripts/python.exe -m pip install uiautomation comtypes`. |
|
||||
| React Native | 0.85 | `apps/mobile-rn/package.json` |
|
||||
| Turborepo | turbo.json tasks: build/typecheck/test/lint/dev | `turbo.json` |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -78,7 +77,7 @@ When required sidecar changes ship, run `node --env-file-if-exists=.env scripts/
|
|||
npm run dev # desktop dev (electron-vite)
|
||||
npm run build # desktop production build
|
||||
npm run build:admin # admin production build
|
||||
npm run build:all | npm run ci # scripts/ci/build-all.mjs
|
||||
npm run build:all | npm run ci # typecheck + test + desktop/admin/web production builds
|
||||
npm run checksum # scripts/ci/generate-checksums.mjs
|
||||
npm run version:check | version:sync
|
||||
npm run release:metadata[:test]
|
||||
|
|
@ -86,22 +85,23 @@ npm run release:forgejo[:check] # canonical Forgejo publisher/feed
|
|||
npm run release:tag # annotated/signed immutable release tag
|
||||
npm run security:secrets[:test] # hardcoded-secret scanner
|
||||
npm run check:desktop-renderer[:test] # built renderer pages reference only assets on disk
|
||||
npm run check:migrations[:test] # Supabase migration ordering, naming & optional remote drift check
|
||||
npm run check:migrations[:test] # Supabase migration filename/order/non-empty metadata checks; no DB replay or remote drift
|
||||
npm run rebuild:app # rebuild better-sqlite3 in-place for Electron ABI
|
||||
npm run rebuild:test # rebuild better-sqlite3 in-place for host Node ABI (Vitest)
|
||||
node scripts/ci/verify-native-abi.mjs --self-test # required packaged N-API prebuild missing/present fixture
|
||||
node scripts/ci/sync-i18n-locales.mjs # synchronize 12 locales against ko/en SSOT
|
||||
npm run test:e2e:red # content-report red e2e
|
||||
npm run release:mobile:boundary[:test]
|
||||
npm run release:mobile:config[:test]
|
||||
npm run release:mobile:build-config:test
|
||||
npm run release:play:assets[:test]
|
||||
npm run typecheck # all workspaces
|
||||
npm run typecheck # all workspaces; web/admin run `next typegen` before `tsc`
|
||||
npm run test # all workspaces
|
||||
npm run lint # eslint apps/desktop apps/web apps/admin packages
|
||||
npm run format # prettier
|
||||
npm run typecheck:mobile # apps/mobile-rn tsc (outside npm workspaces)
|
||||
npm run lint:mobile # apps/mobile-rn eslint --max-warnings=0
|
||||
npm run test:mobile # apps/mobile-rn jest
|
||||
npm run test:mobile # apps/mobile-rn test:ci (jest --runInBand)
|
||||
npm run verify:all # aggregate: workspaces + mobile (typecheck/lint/test)
|
||||
```
|
||||
|
||||
|
|
@ -110,10 +110,10 @@ Per-app commands that matter:
|
|||
| App | Commands |
|
||||
|---|---|
|
||||
| desktop | `npm run dev --workspace=@d3ro/desktop`, `build`, `typecheck`, `test` (vitest), playwright e2e; local STT engine: `npm --prefix apps/desktop run sidecar:setup` then `sidecar:build` (PyInstaller → `sidecar-dist/sidecar`), full local Windows package: `npm --prefix apps/desktop run dist:win:full`; `setup:sox` re-downloads the bundled SoX |
|
||||
| mobile-rn | `npm run typecheck:mobile` / `lint:mobile` / `test:mobile` (root), or `npm --prefix apps/mobile-rn run lint/typecheck/test`; android gradle builds, Maestro E2E |
|
||||
| mobile-rn | `npm run typecheck:mobile` / `lint:mobile` / `test:mobile` (root; Jest uses `test:ci`/`--runInBand`), or `npm --prefix apps/mobile-rn run lint/typecheck/test`; android gradle builds, Maestro E2E |
|
||||
| api-server | `dotnet build`, `dotnet test` (also `apps/api-server.Tests`) |
|
||||
| web | `next build`, playwright e2e in `apps/web/e2e` |
|
||||
| admin | `next build` (`build:admin`) |
|
||||
| web | `next typegen && tsc --noEmit`, `next build`, `test` (vitest, `apps/web/tests`), playwright e2e in `apps/web/e2e` |
|
||||
| admin | `next typegen && tsc --noEmit`, `next build` (`build:admin`) |
|
||||
|
||||
Desktop Vitest uses one `apps/desktop/vitest.config.ts` SSOT with mode-specific include globs:
|
||||
|
||||
|
|
@ -155,11 +155,11 @@ See [`03-shared-packages.md`](./03-shared-packages.md). Summary:
|
|||
|
||||
| Package | Provides |
|
||||
|---|---|
|
||||
| `@d3ro/core` | Domain types, `D3ROError`/`ErrorCode`, IPC channel SSOT, key-binding SSOT (`./keybinding`), constants, `crypto-license`, `pii-redactor`, `secure-memory`, `supabase-config`, `meeting-markdown`, `markdown-to-docx`; has vitest tests (`packages/core/vitest.config.ts`, `npm run test --workspace=@d3ro/core`) |
|
||||
| `@d3ro/core` | Domain types, `D3ROError`/`ErrorCode`, IPC channel SSOT, key-binding SSOT (`./keybinding`), plan/quota catalog including `knowledge_embedding`, constants, `crypto-license`, `pii-redactor`, `secure-memory`, `supabase-config`, `meeting-markdown`, `markdown-to-docx`; Deno consumes the generated contract checked by `contract:check`; has vitest tests (`packages/core/vitest.config.ts`, `npm run test --workspace=@d3ro/core`) |
|
||||
| `@d3ro/ui` | Theme tokens, CSS vars, MUI DS components (web/desktop) |
|
||||
| `@d3ro/ui-native` | RN design system (MetalCard, PhosphorText, Led, PhysicalButton, WaveBars, …) |
|
||||
| `@d3ro/i18n` | 12 locales, `I18nProvider`, `t()`, date/number/relative formatters |
|
||||
| `@d3ro/api-client` | Supabase browser/server clients, meetings/history/usage/transcribe wrappers, shared types; has vitest tests |
|
||||
| `@d3ro/i18n` | 12 locales / 2,742 parity-checked keys, `I18nProvider`, `t()`, date/number/relative formatters; includes native updater-dialog keys |
|
||||
| `@d3ro/api-client` | Supabase browser/server clients, meetings/history/usage/transcribe wrappers, canonical push-token/provider + push/quota RPC types; has vitest tests |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -174,7 +174,7 @@ See [`03-shared-packages.md`](./03-shared-packages.md). Summary:
|
|||
Stages `validate → test → build → e2e → package → publish → deploy`. Primary pipeline for desktop Windows/macOS releases (Forgejo Generic Registry is the canonical updater feed; GitLab project 1172 is a legacy mirror) and production mobile releases (`mobile-production-release`, manual/protected). Admin NAS deploy job is intentionally **disabled**. `package-windows`/`package-macos` build the faster-whisper sidecar (`sidecar:setup` → `sidecar:build`) and run `scripts/ci/verify-sidecar-bundle.mjs` before electron-builder, so a release can never ship without the local STT engine. Every pipeline that runs `npm run build --workspace=@d3ro/desktop` (`.forgejo` CI/release/portable) then runs `scripts/ci/verify-desktop-renderer-bundles.mjs`, which fails packaging when a renderer page references an asset the build did not emit (GAP-INFRA-05).
|
||||
|
||||
### Forgejo Actions (`.forgejo/workflows/`)
|
||||
`ci.yml` — CI is now Forgejo-only (`.github/workflows` deleted 2026-09-26, Wave 3, dc43884). Jobs: `quality` (`version:check`, `contract:check`, `release:metadata:test`, secret scan, mobile release/config/build-config self-tests, Play asset contract, lint, typecheck, Vitest), `build-validation`, `mobile-quality`, `edge-functions` (Deno), `api-server-tests`.
|
||||
`ci.yml` — CI is now Forgejo-only (`.github/workflows` deleted 2026-09-26, Wave 3, dc43884). Jobs: `quality` (`version:check`, `contract:check`, `release:metadata:test`, migration checker self-test + actual filename/order/non-empty check, secret scan, mobile release/config/build-config self-tests, Play asset contract, lint, typecheck, Vitest), `build-validation` (desktop renderer verification + admin + web production builds), `mobile-quality`, `edge-functions` (Deno), `api-server-tests`. Web/admin typecheck runs Next 16 `typegen` before `tsc`, so a clean checkout generates and checks route/root-param declarations instead of relying on a prior dev/build artifact. The migration checks are file metadata/order gates only; Supabase replay, shadow DB, and remote drift remain separate runtime/integration gates. A separate isolated local run on 2026-11-04 applied all 73 migrations from empty and after reset, then returned an empty `pg-delta --strict-coverage` shadow diff; that runtime gate is not yet part of CI and says nothing about linked remote drift.
|
||||
|
||||
`payple-renew.yml` — daily cron (+ manual dispatch) → `payple-renew` edge function; ported from the never-run `.github/workflows/payple-renew.yml` because the repository has no GitHub remote. Requires Forgejo secrets `SUPABASE_URL`, `CRON_SECRET`. 2026-09-26~10-11 `SUPABASE_URL` 시크릿이 로컬 주소(`127.0.0.1:55321`)라 한 번도 성공하지 못했다(GAP-OPS-03).
|
||||
|
||||
|
|
@ -207,9 +207,9 @@ Public endpoints (production): `https://d3ro.chanpaca.net` — **랜딩/다운
|
|||
|
||||
## 7. `server/supabase` (backend)
|
||||
|
||||
- `config.toml` — project `d3ro-voice`, ports 55321-55324, DB major 17, auth redirects (localhost, `d3ro.chanpaca.net`, `d3ro-voice://auth-callback`), providers Google/GitHub/Apple.
|
||||
- `migrations/` — **63 SQL migrations** (schema, RLS, auth triggers, storage, team invites, knowledge/pgvector, push outbox, Payple billing (legacy Stripe columns/provider values kept for history), admin roles, mobile platform/monetization, atomic command reorder, device revocation, content reporting, audit log, meeting documents, STT quota reservations, ad reward replay protection, team activity feed).
|
||||
- `functions/` — **~24 Deno Edge Functions** (`stt-proxy`, `llm-proxy`, `content-report`, `generate-meeting-document`, `embed-chunks`, `search-knowledge`, `realtime-token`, `team-invite`, `team-accept`, `send-push`, `account-delete`, `admin-users`, `admin-subscriptions`, `admin-payments`, `admin-audit-log`, billing `billing-catalog`/`payple-checkout`/`payple-manage`/`payple-renew`/`payple-webhook`, `iap-verify`, `admob-ssv`, `google-play-rtdn`; Stripe functions removed 2026-09-26). Shared contracts in `functions/_shared/` — push transports now include `webpush.ts` (VAPID + RFC 8291) and `apns.ts` (.p8 token) alongside FCM. CI (`edge-functions-quality`) runs `deno check` + `deno test` and also the Cloudflare worker drain test.
|
||||
- `config.toml` — project `d3ro-voice`, ports 55321-55324, DB major 17, Supabase CLI 3.x `[local_smtp]`, auth redirects (localhost, `d3ro.chanpaca.net`, `d3ro-voice://auth-callback`), providers Google/GitHub/Apple. `audio-purge` has an explicit function stanza with gateway JWT verification disabled because its handler verifies the exact pg_cron service credential. An isolated local stack proved missing/non-service key 401, service 200, and pg_cron/Vault/pg_net removal of the queue row, `audio_files` row, and Storage object; deployment and the production schedule remain unverified.
|
||||
- `migrations/` — **73 SQL migrations** (schema, RLS, auth triggers, storage, team invites, knowledge/pgvector, push outbox, Payple billing (legacy Stripe columns/provider values kept for history), admin roles, mobile platform/monetization, atomic command reorder, device revocation, content reporting, audit log, meeting documents, STT quota reservations, ad reward replay protection, team activity feed).
|
||||
- `functions/` — **24 Deno Edge Functions** (`stt-proxy`, `llm-proxy`, `content-report`, `generate-meeting-document`, `embed-chunks`, `search-knowledge`, `realtime-token`, `team-invite`, `team-accept`, `send-push`, `audio-purge`, `account-delete`, `admin-users`, `admin-subscriptions`, `admin-payments`, `admin-audit-log`, billing `billing-catalog`/`payple-checkout`/`payple-manage`/`payple-renew`/`payple-webhook`, `iap-verify`, `admob-ssv`, `google-play-rtdn`; Stripe functions removed 2026-09-26). Shared contracts in `functions/_shared/` — push transports now include `webpush.ts` (VAPID + RFC 8291) and `apns.ts` (.p8 token) alongside FCM. CI (`edge-functions`) runs `deno check` + `deno test` and also the Cloudflare worker drain test.
|
||||
- `tests/` — integration/E2E for content report, mobile platform/recording/reward-race, payments, mobile release preflight, push, team push security, STT quota.
|
||||
|
||||
Full detail: [`09-supabase-backend.md`](./09-supabase-backend.md).
|
||||
|
|
@ -219,11 +219,12 @@ Full detail: [`09-supabase-backend.md`](./09-supabase-backend.md).
|
|||
## 8. `scripts/` groups
|
||||
|
||||
- **CI (`scripts/ci/`, 33 files):** build/version/release (`build-all`, `sync-version`, `generate-checksums`, `verify-release-metadata`, `create-release-tag`, `extract-release-notes`), security (`check-no-hardcoded-secrets`), mobile release gates (`verify-mobile-release-boundary/-config/-build-config`, `verify-android-artifact/-app-links`, `verify-play-store-assets`, `prepare-whisper-model`, `create-mobile-release-evidence`, `prepare-mobile-release-publication`, emulator/CSPRNG gates), keys (`create-desktop-license-keypair`, `create-release-evidence-key`, etc.), publish (`publish-forgejo-release` canonical, `publish-gitlab-release` mirror; the legacy `sync-and-publish-forgejo-release`/`upload-asset-to-forgejo-release` scripts were deleted 2026-09-26, Wave 3, cd9d199), env/tooling (`bootstrap-linux-toolchain.sh`, `audit-nas-stt-config.ps1`, mobile local E2E scripts).
|
||||
- **Packaged native gate:** `verify-native-abi.mjs` rejects a packaged `better_sqlite3.node` that the host Node runtime can load (wrong ABI) and requires the target-specific `uiohook-napi/prebuilds/<platform>-<arch>/uiohook-napi.node`. `--self-test` proves the missing/present N-API fixture; relative and absolute `--dir` inputs resolve to the same package. `build-desktop-installer.mjs` and `build-portable.mjs` repair only the better-sqlite3 ABI, verify both native contracts, and require `resources/app-update.yml` before publication.
|
||||
- **Deploy/release:** `deploy-nas.ps1/.sh`, `nas-control.sh`, `publish-gh.ps1`, `gen-keystore.js` (`deploy-site-to-nas.js` deleted 2026-09-26, Wave 3, cd9d199 — site deploy is Cloudflare Pages only).
|
||||
- **Android artifact verification (2026-11-01):** `verify-android-artifact.mjs` parses both legacy `Signer #1` and Build Tools 37 `V2/V3.x Signer` certificate output. Self-test and the actual universal E2E APK verification pass with Build Tools `37.0.0`.
|
||||
- **GCP/Google OAuth automation + inspection (~70 `*.mjs`):** `auto-configure-oauth`, `automate-google-oauth`, `setup-consent`, `create-*-client`, `check-*`, `inspect-*` — mostly one-off/browser-driven console automation.
|
||||
- **AdMob console automation:** `admob-probe.mjs` (read-only login/app/ad-unit probe), `admob-login.mjs` + `run-admob-login.bat` (one interactive headful Chrome login into a persistent profile), `admob-automate.mjs` (dry-run by default; `--apply` creates/verifies banner+rewarded units and reports Play-store link). Uses `playwright` with `channel: 'chrome'` and the gitignored `.chrome-playwright-profile`.
|
||||
- **E2E / verification:** `e2e-desktop-*.js`, `real-app-multi-tab-e2e.js`, `test-and-capture-all-10-ad-services.js`, `verify-live-production-d3ro.js`.
|
||||
- **E2E / verification:** `test-and-capture-all-10-ad-services.js`, `verify-live-production-d3ro.js`. The old ad-hoc `e2e-desktop-*.js` / `real-app-multi-tab-e2e.js` / `run_e2e_*.cjs` runners were deleted 2026-11-04 (machine-specific paths, no references); Playwright specs under `apps/desktop/tests/e2e` are the E2E path.
|
||||
- **Screenshots/captures:** `capture-*.js`.
|
||||
- **Forgejo ops:** `check-forgejo-actions-runs.js`, `capture-forgejo-*.js`.
|
||||
|
||||
|
|
@ -235,7 +236,7 @@ Full detail: [`09-supabase-backend.md`](./09-supabase-backend.md).
|
|||
|
||||
| File | Purpose |
|
||||
|---|---|
|
||||
| `release/product-version.json` | version `1.9.0`, `androidVersionCode`/`iosBuildNumber` `1090000`, releaseDate `2026-09-27`, desktop license keyId |
|
||||
| `release/product-version.json` | version `1.16.1`, `androidVersionCode`/`iosBuildNumber` `1160100`, releaseDate `2026-11-04`, desktop license keyId |
|
||||
| `release/android-release-identity.json` | package `com.d3ro.voice`, Play app ID, app-signing SHA-256, upload cert SHA-256, evidence keyId, AdMob unit IDs |
|
||||
| `release/desktop-license-public.pem` | Ed25519 public key for desktop offline licenses |
|
||||
| `release/mobile-release-evidence-public.pem` | Ed25519 public key for mobile release evidence |
|
||||
|
|
@ -256,11 +257,12 @@ Version sync is enforced by `scripts/ci/sync-version.mjs` and `verify-release-me
|
|||
- `resources/ffmpeg/` — optional bundled ffmpeg (CI or manual); `getFfmpegPath()` also resolves the `@ffmpeg-installer/ffmpeg` binary from `app.asar.unpacked`.
|
||||
- `apps/desktop/sidecar-dist/` — PyInstaller sidecar bundle consumed by `extraResources` (gitignored; built by `npm --prefix apps/desktop run sidecar:build`).
|
||||
- `resources/icons/` — empty; electron-builder falls back to `build/icon.ico|png`.
|
||||
- Desktop tests: `apps/desktop/tests/` (vitest unit + playwright e2e), `apps/desktop/test-results/`.
|
||||
- Desktop tests: `apps/desktop/tests/` — `unit/`, `main/`, `red/`, `shared/`, `integration/`, `eval/` run under Vitest; `e2e/` holds Playwright specs plus the shared `e2e/support/electron-app.ts` fixture (per-test temp user-data dir). Artifacts in `apps/desktop/test-results/`.
|
||||
- Test taxonomy + hygiene gate: `docs/tdd-red/06-repo-application.md`. `npm run test:hygiene` (+ `:test`) rejects `.only`, reason-less `.skip()`, trivial assertions, `isVisible()`-gated assertions, machine-specific paths, `waitForTimeout`, and `.e2e.test.ts` names; wired into CI `quality`.
|
||||
- Mobile tests: `apps/mobile-rn/__tests__/` (57 suites / 353 tests per mobile SSOT), `.maestro/` + `.maestro-output/` E2E evidence. Note: a full parallel Jest run can hit the 5s render timeout on slow machines; re-run the failing spec in isolation before treating it as a regression.
|
||||
- Web tests: `apps/web/e2e/` (playwright).
|
||||
- Web tests: `apps/web/tests/` (vitest pure-logic contracts: billing catalog, Web Push client, web STT client — now part of root `npm test`) and `apps/web/e2e/` (playwright: `smoke.spec.ts` owns the unauthenticated surface contract; billing/payple/dashboard/history are fixture-based browser journeys). Web declares its own `@playwright/test` + `vitest` devDeps (2026-11-04) instead of relying on the desktop workspace's hoisted copies.
|
||||
- API tests: `apps/api-server.Tests/` (xUnit).
|
||||
- Root: `tests/e2e/`, `test-results/.last-run.json`.
|
||||
- Root: `test-results/.last-run.json` (no root-level e2e suite).
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -282,7 +284,7 @@ See [`11-gap-backlog.md`](./11-gap-backlog.md) for the maintained list (`INFRA-*
|
|||
| Payple 정기 갱신 cron | `CRON_SECRET` | Supabase 함수 시크릿 `CRON_SECRET`, Forgejo 시크릿 `CRON_SECRET` |
|
||||
| NAS 배포(ssh 별칭 `yunchan-nas`) | `NAS_HOST`, `NAS_USER`, `NAS_SSH_PORT`, `NAS_DEPLOY_PATH` | — |
|
||||
| NAS compose 필수 값 | `SUPABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY`, `ADMIN_BOOTSTRAP_TOKEN`, `API_SERVER_URL` 외 | NAS `/volume1/docker/d3ro/.env` |
|
||||
| 웹앱 이미지 build arg | `NEXT_PUBLIC_SUPABASE_URL`, `NEXT_PUBLIC_SUPABASE_ANON_KEY` (`NEXT_PUBLIC_PAYPLE_CLIENT_KEY`는 보류, GAP-BILL-02) | — |
|
||||
| 웹앱 이미지 build arg | `NEXT_PUBLIC_SUPABASE_URL`, `NEXT_PUBLIC_SUPABASE_ANON_KEY`; 선택적 `NEXT_PUBLIC_PAYPLE_CLIENT_KEY`와 `NEXT_PUBLIC_VAPID_PUBLIC_KEY` (`WEBPUSH_VAPID_PUBLIC_KEY`와 같은 공개키). VAPID 공개키 누락 시 알림 UI는 unavailable로 fail-closed | `.env` / NAS build environment; `NEXT_PUBLIC_*`는 이미지 build-time에 고정 |
|
||||
| Forgejo API | `FORGEJO_TOKEN` | Forgejo 시크릿 `FORGEJO_TOKEN` |
|
||||
|
||||
- 공개 라우팅: `d3ro.chanpaca.net` → 브리지 워커 → `/app`·`/api`·`/health`는 터널 kd-nas(NAS 3002·5050), 그 밖은 Pages `d3ro`. 터널 ingress `d3ro.chanpaca.net` path `^/app` → `http://192.168.0.39:3002`.
|
||||
|
|
|
|||
|
|
@ -26,6 +26,7 @@ The canonical place for types and cross-surface logic. Both desktop and web/mobi
|
|||
| PII | `pii-redactor`, `secure-memory` | Redaction + secure memory helpers |
|
||||
| Supabase config | `supabase-config` | Shared Supabase config shape |
|
||||
| Entitlement | `./entitlement` | `EntitlementTier`, `AdminRole`, `EntitlementSnapshot`, `resolveEntitlement`, `normalizeEntitlementTier`/`normalizeAdminRole` — canonical tier/role contract across Supabase, desktop license, and .NET |
|
||||
| Plan catalog | `./plan-catalog` | Tier/price/quota SSOT. `knowledge_embedding` is explicit per tier (Free 5,000/week; Pro 50,000/day; Pro+ 150,000/day; Team 300,000/day; Enterprise unlimited), generated into `server/supabase/functions/_shared/core-contract.generated.ts`, and guarded by `contract:check` |
|
||||
| Doc utils | `./utils/meeting-markdown`, `./utils/markdown-to-docx` | Meeting Markdown export + DOCX generation (dep: `docx`) |
|
||||
|
||||
**When to change:** new cross-surface type, new error code, new IPC channel, license format. Add here first, then consume.
|
||||
|
|
@ -63,7 +64,7 @@ App-specific `ScreenHeader`, `RecordFab`, and `UnifiedSearchResultRow` stay unde
|
|||
|
||||
| Provides | Notes |
|
||||
|---|---|
|
||||
| 12 locales | `ko` (master), `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th` in `src/locales/` |
|
||||
| 12 locales | `ko` (master), `en`, `ja`, `zh`, `zh-TW`, `es`, `fr`, `de`, `pt`, `ru`, `vi`, `th` in `src/locales/`; 2,742 parity-checked keys, including the 16 native `update.dialog.*` keys |
|
||||
| Type-safe keys | `TranslationKey` derived from `ko.json` |
|
||||
| React context | `I18nProvider`, `useI18n`, `TFunction` |
|
||||
| Fallback chain | locale → `en` → `ko` → key |
|
||||
|
|
@ -86,9 +87,9 @@ Electron-independent. Rule: no hardcoded Korean/English strings in UI; use `t()`
|
|||
| `transcribe` | STT calls |
|
||||
| `supabase-browser` | Browser client (`getSupabaseBrowserClient`, `isSupabaseConfigured`) |
|
||||
| `supabase-server` | Server client (`createSupabaseServerClient`) |
|
||||
| `types` | Shared DB/domain types — **canonical; do not redefine table types per app** |
|
||||
| `types` | Shared DB/domain types — **canonical; do not redefine table types per app**. Includes `PushProvider`, device-bound `PushToken`, `push_tokens` row/insert/update shapes, `register_push_registration`/`unregister_push_registration`, and period-aware `consume_quota` RPC contracts |
|
||||
|
||||
Deps: `@d3ro/core`, `@supabase/supabase-js`; optional peer `@supabase/ssr`. Tests: `__tests__/` (client, transcribe, types) via vitest.
|
||||
Deps: `@supabase/supabase-js`; optional peer `@supabase/ssr`. The unused `@d3ro/core` dependency was removed in Wave 4. Tests: `__tests__/` (client, transcribe, types) via vitest.
|
||||
|
||||
Consumed by `apps/web`, `apps/admin` (via re-exports), `apps/mobile-rn`, and desktop cloud paths.
|
||||
|
||||
|
|
@ -100,7 +101,7 @@ Consumed by `apps/web`, `apps/admin` (via re-exports), `apps/mobile-rn`, and des
|
|||
@d3ro/i18n (standalone)
|
||||
@d3ro/ui → @d3ro/core
|
||||
@d3ro/ui-native(standalone, peers react-native)
|
||||
@d3ro/api-client → @d3ro/core
|
||||
@d3ro/api-client(standalone; depends on Supabase SDK)
|
||||
@d3ro/core (standalone)
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -43,13 +43,12 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
|---|---|
|
||||
| `actions/` | `action-runner.tsx` (LLM parse → action: create_meeting/search_knowledge/create_memo/send_team_invite) |
|
||||
| `record/` | `mic-recorder.tsx` (MediaRecorder + level analyser → `transcribeWebAudio`) |
|
||||
| `dashboard/` | `meetings-trend-chart.tsx` (recharts) |
|
||||
| `billing/` | `billing-checkout-options`, `payple-checkout-button`, `payple-client`, `payple-manage-button` |
|
||||
| `meetings/` | `document-editor`, `generate-document-button`, `live-transcript-list` (Realtime), `markdown-preview` (Mermaid), `meeting-audio-player` (signed URL), `memo-form` |
|
||||
| `chat/` | `chat-panel.tsx` |
|
||||
| `teams/` | `create-team-form`, `invite-member-form`, `activity-feed` (team notes + realtime) |
|
||||
| `knowledge/` | `add-knowledge-form` (text or `.txt`/`.md` file, newline-aware chunking, `embed-chunks` on submit), `knowledge-search` (semantic via `search-knowledge`) |
|
||||
| `layout/` | `sidebar.tsx` (nav, theme selector, logout, i18n) |
|
||||
| `layout/` | `sidebar.tsx` (nav, theme selector, logout, i18n) + `web-push-control.tsx` (permission/subscription status and explicit opt-in/out switch) |
|
||||
| `providers/` | `auth-provider`, `i18n-provider`, `theme-mode-context`, `theme-provider` |
|
||||
|
||||
---
|
||||
|
|
@ -65,13 +64,19 @@ Root layout: `ThemeProvider → I18nProvider → AuthProvider`.
|
|||
| `history-client.ts` | History list/get/update/delete, revision-safe |
|
||||
| `supabase-browser.ts` | Re-export `@d3ro/api-client/supabase-browser` |
|
||||
| `supabase-server.ts` | Next `cookies()` wrapper |
|
||||
| `web-device.ts` | Stable browser installation identity + active `platform='web'` device lookup/create/check-in; revoked rows are never resurrected |
|
||||
| `web-push.ts` | Web Push service-worker/VAPID subscribe/unsubscribe helper. Requires a valid active `deviceId`, persists only through register/unregister RPCs, rolls back a failed registration, re-registers an existing browser subscription before reporting it connected, and runs bounded server cleanup independently from local unsubscribe |
|
||||
| `web-push-session.ts` | Production orchestration boundary used by the sidebar and logout: user-gesture permission → device registration → subscription, plus per-user disabled intent, fail-closed reconciliation, and non-blocking logout cleanup |
|
||||
| `web-stt-client.ts` | Web STT via `stt-proxy`, 25 MB limit, `WebSttError` codes |
|
||||
|
||||
---
|
||||
|
||||
## 4. Tests
|
||||
|
||||
Playwright specs in `apps/web/e2e/`: billing, payple-checkout, dashboard-dictionary-commands, history, web-stt-client, smoke.
|
||||
Two layers:
|
||||
|
||||
- **Vitest** (`apps/web/tests/`, `npm --prefix apps/web run test`, part of root `npm test`): pure-logic contracts — `billing-catalog`, `web-push` (device/RPC/rollback/reconciliation/logout, 17 cases), `web-stt-client`.
|
||||
- **Playwright** (`apps/web/e2e/`): `smoke.spec.ts` (unauthenticated surface + fail-closed redirects + `/download` handoff), `billing`, `payple-checkout`, `dashboard-dictionary-commands`, `history` (fixture-based browser journeys).
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -84,4 +89,5 @@ Playwright specs in `apps/web/e2e/`: billing, payple-checkout, dashboard-diction
|
|||
- Action runner team-invite uses a manual redirect safety path instead of a live invite (`action-runner.tsx`).
|
||||
- `/download` shows "artifact not yet published" for the current desktop release.
|
||||
- Knowledge file upload, semantic search, dictionary import/export, and the team activity feed are now implemented (`[x]` in the catalog).
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed the unreferenced dashboard trend chart and the web `recharts` dependency. Web Push now has a production sidebar opt-in/out flow, stable web-device registration, device-bound register/unregister RPCs, disabled-intent reconciliation, bounded local/server cleanup, logout-independent sign-out, and a Docker-copied service worker. An isolated local browser run with ephemeral VAPID proved one active web device, one `webpush` token, one pending outbox attempt, a completed drain, and a `delivered` provider result; that result proves provider acceptance, not service-worker/browser receipt. A later production-standalone run built and served successfully but timed out during throwaway login navigation before the dashboard, so production-rendered 1440/390, accessibility-tree, hit-target, permission/subscription, and receipt gates remain open. No production secrets or deployment were changed.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** All 15 routes and shared components aligned with `design.md` v4 ("조용한 계기"): undefined `--d3-text-inverse` replaced with `--d3-accent-ink`, minimum font size raised to `11px` (`0.6875rem`), `uppercase` and positive `letterSpacing` removed from Korean UI copy, raw `monospace` replaced with `var(--d3-font-mono)`, single `component="h1"` hierarchy enforced per route, and native form controls equipped with `:focus-visible` rings and `<label htmlFor>` / `aria-label` attributes.
|
||||
|
|
|
|||
|
|
@ -92,8 +92,9 @@ Source of truth for status is `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` sections 0
|
|||
| Area | Status |
|
||||
|---|---|
|
||||
| Auth / account | `[~]` Implemented + Jest GREEN; external OAuth consent→callback and logout/delete/provider device E2E pending |
|
||||
| Onboarding | `[x]` current fresh auth/signup/invite and small-screen journeys GREEN on physical Fold6; this does not verify the new v4 shell on every viewport/theme |
|
||||
| v4 shell / theme / accessibility | `[x]` shell journey at 320dp dark and 411dp light; `[~]` broader design-system/a11y proof because TalkBack/font-scale/rotation remain |
|
||||
| Onboarding | `[~]` unit coverage and the current `.3` isolated API 34 AVD fresh auth/signup journeys are GREEN; the historical `.2` Fold6 fresh journeys passed, but current `.3` Fold6 first-run failed twice at onboarding visibility. The 2026-11-04 `1.16.1` Fold6 result is a state-preserving upgrade/cold launch, not current physical-device first-run proof |
|
||||
| v4 shell / theme / accessibility | `[x]` shell journey at 320dp dark and 411dp light; `[~]` broader design-system/a11y proof. 2026-11-04 Android automation added current-source physical/AVD install+launch, inspected-route labels/48dp, and AVD font-scale 2.0 + rotation/scroll evidence; manual TalkBack/focus order, the SDK ad WebView, app-wide coverage, and iOS remain |
|
||||
| Large screen (tablet / unfolded foldable) | `[ ]` No adaptation. 2026-11-05 audit at ≈825dp (Fold6 OPENED) shows every screen as a single stretched phone column (no `useWindowDimensions`, breakpoints, or `numColumns`), full-width Edit/Delete/Select buttons, and an adaptive-banner height shift. See `11` GAP-UX-08 and `docs/evidence/2026-11-05-tablet-layout-audit.md` |
|
||||
| Recording / transcription / Talk | `[x]` core path GREEN on API 34 (FGS, recovery, local Whisper, cloud fail-closed, TTS) |
|
||||
| Data portability | `[x]` export/restore + share E2E GREEN |
|
||||
| History / meetings | `[x]` real data + meeting creation contract GREEN; audio timestamp/speaker + cross-app E2E pending |
|
||||
|
|
@ -123,6 +124,7 @@ The v4 shell also removed `DashScreen` and `WorksHubScreen`. Home replaces the d
|
|||
- Historical `.2` Fold6 physical-device gate (Android 16, `SM-F956N`): fresh auth **60 s PASS**, fresh signup **67 s PASS**, warm/cold invite **31 s PASS**, and small-screen signup **61 s PASS** on 2026-11-01. Fatal/Metro matches 0; evidence is `apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`. Authenticated parity was not run because test credentials are absent.
|
||||
- v4 local runtime: `apps/mobile-rn/.maestro/navigation-shell-search-local.yaml`; 320dp dark **1/1 PASS, 88 s** at `scratch/design-audit/wave45/navigation-shell-search-320-dark-verified.xml`, and 411dp light **1/1 PASS, 100 s** at `scratch/design-audit/wave45/navigation-shell-search-411-light-verified.xml`.
|
||||
- Current runtime APK: `com.d3ro.voice`, `1.15.4-e2e.20261101.3` / `2026110103`, 147158575 bytes, SHA-256 `937d2a0b3fb6b810516f07e91dd97ffe99d34c5885a72f21805a51e8a408027f`. Build Tools 37 verifier PASS; installed identity matches. Import entry and metadata editor rendered on Fold6 without saving new data. Earlier `.3` fresh-auth + retry both FAILED at onboarding visibility (black screenshots); those failures are retained. No data reset was performed, so `.2` historical passes are not current first-run proof. Production configuration fails with `firebase_expected_project_id_missing`, including with root `.env`. [Evidence](../evidence/2026-11-01-completion.md).
|
||||
- 2026-11-04 current-source E2E runtime: `1.16.1-e2e.20261104.1` / `2026110401`, SHA-256 `3d2875c74b555dbcd854468e57b9b4b3a8e6c9657f210760cbe24a77ee92cf7c`, verifier PASS, then state-preserving `adb install -r` and cold launch PASS on Fold6 Android 16 and API 34 AVD. Physical Notifications status/privacy/recent cards passed a `clearState:false` Maestro flow without a permission action. UIAutomator and AVD font-scale 2.0/rotation are automated evidence only; manual TalkBack, notification permission transitions/FCM receipt, app-wide a11y, and iOS remain. [Evidence](../evidence/2026-11-04-mobile-runtime-a11y.md).
|
||||
- Committed evidence summary: [`docs/evidence/wave45-mobile-shell-search-2026-09-28.md`](../evidence/wave45-mobile-shell-search-2026-09-28.md).
|
||||
- Android instrumentation: `apps/mobile-rn/android/app/src/androidTest` (CSPRNG + incoming share).
|
||||
- Build verifiers: `scripts/ci/verify-android-artifact.mjs` (legacy + Build Tools 37 signer output), `verify-android-app-links.mjs`, `verify-mobile-build-config.mjs`, `verify-mobile-release-boundary.mjs`.
|
||||
|
|
|
|||
|
|
@ -74,7 +74,7 @@ Root files: `instrumentation.ts` (startup security validation), `proxy.ts` (edge
|
|||
|
||||
## 4. Components (`src/components/`)
|
||||
|
||||
`admin-sidebar` (nav island: Core Platform / Customer & Revenue / Intelligence & Security), `unavailable-admin-panel` (reusable "NOT CONNECTED", no sample data), `audit-diff-viewer`, `payment-history`, `subscription-form`, `role-change-dialog` + `role-change-button`, `memo-dialog`, `license-issuer-button` + `license-issuer-dialog`, `checksum-copy`, charts (`dau-chart`, `feature-usage-chart`, `top-users-chart`).
|
||||
`admin-sidebar` (nav island: Core Platform / Customer & Revenue / Intelligence & Security), `unavailable-admin-panel` (reusable "NOT CONNECTED", no sample data), `audit-diff-viewer`, `payment-history`, `subscription-form`, `role-change-dialog` + `role-change-button`, `memo-dialog`, `license-issuer-button` + `license-issuer-dialog`, `checksum-copy`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -89,4 +89,5 @@ Root files: `instrumentation.ts` (startup security validation), `proxy.ts` (edge
|
|||
- `UnavailableAdminPanel` whenever Supabase env absent; writes disabled, no sample metrics.
|
||||
- `/pipelines` and dashboard node/error sections render only measured data.
|
||||
- Deploy: `apps/admin/Dockerfile` → GHCR + NAS compose; the duplicate root `Dockerfile.admin` was deleted 2026-09-26 (Wave 3, cd9d199) since `apps/admin/Dockerfile` is the one actually used. GitLab admin NAS deploy job disabled.
|
||||
- **2026-11-04 Wave 4 hygiene:** Removed three unreferenced chart components (`dau-chart`, `feature-usage-chart`, `top-users-chart`) and the admin `recharts` dependency; no active admin route imported them.
|
||||
- **2026-10-28 designpaca audit (`SHELL-15`):** `console-theme.ts` `C.dim` upgraded from `#67789e` to `#7e8eb0` (WCAG AA 4.94:1 on dark card surface), `panelSx`/`innerCoreSx`/`filterBtnSx`/`statusBadgeSx`/`primaryButtonSx` flattened (removed `backdropFilter` blur, decorative gradients, `uppercase`, and positive `letterSpacing`), 1.0:1 foreground/background token collisions (`--d3-status-successBg`, `--d3-status-dangerBg`, `--d3-tag-cyanBg`) fixed across `admin-sidebar.tsx`, `ads`, `releases`, `subscriptions`, `usage`, `users`, and `login`, sub-11px font sizes raised to `11px`, and keyboard navigation (`role="button"`, `tabIndex={0}`) + `aria-label` added to sidebar and dialog controls.
|
||||
|
|
|
|||
|
|
@ -7,12 +7,12 @@
|
|||
|
||||
## 1. Supabase project (`server/supabase/`)
|
||||
|
||||
- `config.toml` — project_id `d3ro-voice`; local ports API 55321 / DB 55322 / Studio 55323 / Inbucket 55324; DB major v17; storage 50 MiB; auth `site_url` localhost:5173, redirects include `https://d3ro.chanpaca.net` and `d3ro-voice://auth-callback`; external providers Google/GitHub/Apple; per-function `verify_jwt` settings; analytics off.
|
||||
- `seed.sql`, `migrations/` (66; production at `20260927000036` — it lagged at `0028` until 2026-09-27, GAP-OPS-01), `functions/` (23, all redeployed 2026-09-27), `functions/_shared/`, `tests/`, `deno.json`.
|
||||
- `config.toml` — project_id `d3ro-voice`; local ports API 55321 / DB 55322 / Studio 55323 / local SMTP UI 55324; DB major v17; storage 50 MiB; auth `site_url` localhost:5173, redirects include `https://d3ro.chanpaca.net` and `d3ro-voice://auth-callback`; external providers Google/GitHub/Apple; per-function `verify_jwt` settings; analytics off. The mail section uses the Supabase CLI 3.x `[local_smtp]` name rather than the removed `[inbucket]` alias.
|
||||
- `seed.sql`, `migrations/` (73 source files; last confirmed production state was `20260927000036`), `functions/` (24 source functions; the 23 functions present on 2026-09-27 were redeployed that day), `functions/_shared/`, `tests/`, `deno.json`.
|
||||
|
||||
> Note: root `supabase/` contains only empty scaffolding (`.branches/`, `snippets/`). The real project lives under `server/supabase/`.
|
||||
|
||||
### 1.1 Migrations (62) — thematic groups
|
||||
### 1.1 Migrations (73) — thematic groups
|
||||
|
||||
| Theme | Examples |
|
||||
|---|---|
|
||||
|
|
@ -32,9 +32,9 @@
|
|||
| STT quota | atomic quota reservations (00026) |
|
||||
| Ads | ad reward receipt replay protection (00028) |
|
||||
|
||||
Migration numbering referenced in SSOT goes up to `00028`; CI verifies `migration-up` + shadow replay.
|
||||
Forgejo CI runs `check:migrations:test` and `check:migrations`. These gates validate filename format, unique and monotonically increasing timestamps, and non-empty files; they do **not** apply SQL to a local/shadow database or compare remote migration state. Separately on 2026-11-04, an isolated `d3ro-voice-wave4-runtime` stack applied all 73 migrations from empty and after `db reset`; `db diff --use-pg-delta --strict-coverage` replayed the same history into a shadow DB and returned no schema changes. This local proof does not establish linked/production drift.
|
||||
|
||||
### 1.2 Edge Functions (~27)
|
||||
### 1.2 Edge Functions (24)
|
||||
|
||||
| Function | Purpose |
|
||||
|---|---|
|
||||
|
|
@ -42,7 +42,8 @@ Migration numbering referenced in SSOT goes up to `00028`; CI verifies `migratio
|
|||
| `llm-proxy` | LLM gateway (Claude/OpenAI) |
|
||||
| `realtime-token` | OpenAI Realtime ephemeral token (tier-gated, session quota) |
|
||||
| `generate-meeting-document` | AI document generation (minutes/report/idea-note/mindmap) |
|
||||
| `embed-chunks` / `search-knowledge` | RAG embeddings + semantic search |
|
||||
| `embed-chunks` / `search-knowledge` | RAG embeddings + semantic search. `knowledge_embedding` budgets are read from generated `PLAN_QUOTA`, whose source is `packages/core/src/plan-catalog.ts` |
|
||||
| `audio-purge` | Service-only audio object purge worker invoked by pg_cron. `config.toml` sets `verify_jwt = false` so modern service keys reach the handler; the handler then authorizes the exact service credential before queue/storage work. Isolated local runtime proof on 2026-11-04 covered missing/non-service key 401, service-key 200, direct drain, and `pg_cron` → Vault → `pg_net` → Edge → Storage deletion |
|
||||
| `content-report` | AI content reporting |
|
||||
| `team-invite` / `team-accept` | Team invitations |
|
||||
| `send-push` | Push delivery |
|
||||
|
|
@ -54,7 +55,7 @@ Migration numbering referenced in SSOT goes up to `00028`; CI verifies `migratio
|
|||
| `admob-ssv` | AdMob server-side verification + reward ledger |
|
||||
| `google-play-rtdn` | Play Real-time Developer Notifications |
|
||||
|
||||
Shared contracts in `functions/_shared/`: admin, auth, audit, cors, quota, payple, push, llm, stt, team, generation-receipt, google-play, pubsub, generative-ai-safety (+ `*.test.ts`).
|
||||
Shared contracts in `functions/_shared/`: admin, auth, audit, cors, quota, embedding-quota, payple, push, llm, stt, team, generation-receipt, google-play, pubsub, generative-ai-safety (+ `*.test.ts`).
|
||||
|
||||
### 1.3 Tests (`server/supabase/tests/`)
|
||||
|
||||
|
|
@ -98,5 +99,6 @@ Shared TS types for these live in `packages/api-client` (SSOT).
|
|||
- Push: Supabase owns tokens/devices/outbox/retries. Transports implemented for **FCM, Web Push (VAPID + RFC 8291), and APNs (.p8 token)**; the Cloudflare Worker cron drains the outbox every minute. Android still requires FCM at the device. Details: `docs/deployment/push-transport-without-firebase.md`.
|
||||
- Content safety: generation receipts + `content-report` **implemented**.
|
||||
- Data portability (`account-delete`, export/restore): **implemented**.
|
||||
- Audio purge source wiring, unit tests, and an isolated local pg_cron/Vault invocation are verified: the fixture queue, `audio_files` row, and Storage object each changed from one to zero and `net._http_response` recorded HTTP 200. Deployment and the production schedule/Vault/object path remain unverified.
|
||||
|
||||
External gates are enumerated in `docs/v3/MOBILE_APP_COMPLETION_SSOT.md` §0/§6 and mirrored in `11-gap-backlog.md` (`EXT-*`, `BE-*`).
|
||||
|
|
|
|||
|
|
@ -18,6 +18,7 @@
|
|||
| `03-cleanup-and-consolidation.md` | 없는/가짜 RED **삭제**, 테크닉 **통폐합**·구조화 | 핵심 산출물 2 |
|
||||
| `04-long-scenarios.md` | RED를 **긴 시나리오**(행위 사양)로 재구성 | 핵심 산출물 3 |
|
||||
| `05-framework.md` | 실행 프레임워크: 제어 루프·AGENTS.md·체크리스트·게이트 | 핵심 산출물 4 |
|
||||
| `06-repo-application.md` | **이 저장소 적용본**: 계층·경로·명령·게이트·삭제/통폐합 기록 | 실행 정본 |
|
||||
| `SOURCES.md` | 100개 정보 항목(약 94 외부) + 1차 소스 14개 | 증거 자료실 |
|
||||
|
||||
---
|
||||
|
|
@ -72,6 +73,7 @@ docs/tdd-red/
|
|||
├── 03-cleanup-and-consolidation.md
|
||||
├── 04-long-scenarios.md
|
||||
├── 05-framework.md
|
||||
├── 06-repo-application.md ← 이 저장소 경로·명령·게이트 (실행 정본)
|
||||
└── SOURCES.md (100개 정보 항목: 약 94 외부 출처)
|
||||
└── 레드팀 검증 → `scratch/tdd-red/redteam/01~05*.md` (5방면)
|
||||
```
|
||||
|
|
|
|||
215
docs/tdd-red/06-repo-application.md
Normal file
215
docs/tdd-red/06-repo-application.md
Normal file
|
|
@ -0,0 +1,215 @@
|
|||
# 06 · 이 저장소 적용 — D3RO Voice 테스트 포트폴리오
|
||||
|
||||
**목적**: `01`~`05` 는 일반 프레임워크다. 이 문서는 그 프레임워크를 **실제 D3RO Voice 경로·명령·게이트**에 고정한 적용본이다.
|
||||
새 테스트를 쓰거나 지울 때 이 문서가 맞는지 먼저 본다. (2026-11-04 작성)
|
||||
|
||||
---
|
||||
|
||||
## 1. 디자인 방법론 선택 (외부 조사 → 이 저장소 적용)
|
||||
|
||||
세 축을 조합했다. 하나로는 이 저장소를 덮지 못한다.
|
||||
|
||||
| 방법론 | 핵심 주장 | 이 저장소에 적용한 방식 |
|
||||
|---|---|---|
|
||||
| **Testing Trophy** (Kent C. Dodds) | "정적 > 단위 > **통합** > E2E" 순으로 투자 대비 신뢰도가 높다. 테스트는 소프트웨어가 쓰이는 방식에 가까울수록 신뢰를 준다. | 정적(TS strict + eslint + 디자인 토큰 검사)을 최하단에 두고, **서비스 단위**보다 **서비스+DB/IPC 경계 통합**(`tests/main`, `tests/red`)에 비중을 둔다. E2E 는 임계 여정만. |
|
||||
| **Practical Test Pyramid** (Ham Vocke / Martin Fowler) | 계층마다 피드백 속도가 다르다. **E2E 는 최소**, 같은 시나리오를 전 계층에 복제하지 말 것. 경계는 **계약 테스트**로. | Supabase Edge ↔ 앱, `.NET API` ↔ 클라이언트, IPC 채널 타입은 `packages/core` 계약으로 검증. 데스크톱 E2E 는 5개 여정 파일로 축소(§4). |
|
||||
| **Playwright Best Practices** (Microsoft) | 사용자에게 보이는 행위만 단정, 테스트는 서로 격리, locator 는 role/testid, 진단은 trace. | 공용 픽스처 `tests/e2e/support/electron-app.ts` 가 **테스트마다 새 user-data 디렉터리**를 만들고 창을 띄우고 trace 로 실패를 남긴다. `waitForTimeout`·스크린샷 경로 하드코딩 금지(게이트가 막는다). |
|
||||
|
||||
**이 저장소의 좋은 예시 (그대로 따라 쓸 것)**
|
||||
|
||||
| 예시 | 무엇이 좋은가 |
|
||||
|---|---|
|
||||
| `apps/web/e2e/dashboard-dictionary-commands.spec.ts` | Supabase fixture 사용자 2명(owner/other)으로 RLS 경계까지 검증. 데이터를 직접 시드하고 화면은 사용자 표면만 본다. |
|
||||
| `apps/desktop/tests/main/db-open-atomic-redteam-r2-1.test.ts` | 결함 재현(회귀 RED) — 원자적 DB open 실패를 먼저 실패로 고정. |
|
||||
| `apps/desktop/tests/red/ads/admob-ssv.test.ts` | 목업 대신 실제 ECDSA 키쌍으로 서명/위조/변조를 실측. "전부 목" 안티패턴 회피. |
|
||||
| `apps/desktop/tests/e2e/navigation.spec.ts` | `test.step(route, ...)` 로 실패 지점을 경로명으로 남기고, `aria-current` 라는 사용자 표면만 단정. |
|
||||
| `apps/mobile-rn/__tests__/e2e-runtime-bootstrap.test.ts` | 경계 입력(릴리스 빌드·LAN 호스트·secret key·iOS)을 표로 열거 — 경계 RED 의 좋은 형태. |
|
||||
|
||||
**디자인 시스템 관점**: 이 앱의 UI는 `packages/ui` 의 DS(CRT 계기판)가 SSOT다. 그래서 "디자인 검증"을 스크린샷 비교가 아니라
|
||||
**토큰/구조 계약**(`npm run check:design`, role·`aria-current`·`aria-selected` 단정)으로 한다. 픽셀 비교는 flaky 비용이 크고,
|
||||
이 저장소에는 시각 회귀 인프라가 없다. 시각 탐색이 필요한 변경은 `05 §7` 대로 **test-last**(컴포넌트/접근성/E2E 강조)로 처리한다.
|
||||
|
||||
> 2026 에이전트 시대의 결론은 "테스트를 먼저 쓰게 프롬프트하기"가 아니라 **"인간이 정한 수용 기준을 완료 게이트로 강제"** 다(`00`, `05 §2`).
|
||||
> 그래서 이 문서의 산출물은 문서가 아니라 **명령**이다: `npm run test:hygiene`, `npm run verify:all`.
|
||||
|
||||
---
|
||||
|
||||
## 2. 테스트 포트폴리오 (정본 경로)
|
||||
|
||||
| 계층 | 도구 | 경로 | 실행 | 게이트 |
|
||||
|---|---|---|---|---|
|
||||
| 정적 | tsc strict, eslint, 디자인 토큰 | `apps/*/src`, `packages/*` | `npm run typecheck`, `npm run lint`, `npm run check:design` | CI `quality` |
|
||||
| 테스트 위생 | node 스크립트 | 위 패턴의 모든 테스트 파일 | `npm run test:hygiene` (+ `:test` 셀프테스트) | CI `quality` |
|
||||
| 단위 | Vitest | `apps/desktop/tests/{unit,main,shared,renderer}`, `apps/web/tests`, `packages/*/__tests__` | `npm --prefix apps/desktop run test:unit`, `npm --prefix apps/web run test` | CI `test` |
|
||||
| 서비스 통합 | Vitest | `apps/desktop/tests/{main,red}` | `npm --prefix apps/desktop run test:service` | CI `test` |
|
||||
| 계약(E2E-ish, 결정적) | Vitest | `apps/desktop/tests/red/*.test.ts`, `apps/desktop/tests/integration/*.test.ts` | `npm --prefix apps/desktop run test:integration` | CI `test` |
|
||||
| E2E (데스크톱) | Playwright `_electron` | `apps/desktop/tests/e2e/*.spec.ts` | `npm --prefix apps/desktop run test:e2e` | 로컬/릴리스 전 |
|
||||
| E2E (웹) | Playwright | `apps/web/e2e/*.spec.ts` | `npm --prefix apps/web run test:e2e` | 로컬/릴리스 전 |
|
||||
| E2E (모바일) | Maestro + 계약 스크립트 | `apps/mobile-rn/.maestro`, `apps/mobile-rn/__tests__/*.e2e.mjs` | `docs/map/02-infrastructure.md §3` | 로컬/릴리스 전 |
|
||||
| 모바일 단위 | Jest | `apps/mobile-rn/__tests__/*.test.ts(x)` | `npm run test:mobile` | CI `mobile-quality` |
|
||||
| API | xUnit | `apps/api-server.Tests/` | `dotnet test` | CI |
|
||||
| Edge Functions | Deno test | `server/supabase/functions/**/*.test.ts` | `docs/map/02-infrastructure.md §3` | CI `edge-functions` |
|
||||
|
||||
**이름 규칙**: E2E(브라우저/Electron)만 `*.spec.ts`. 나머지는 전부 `*.test.ts(x)`.
|
||||
`.e2e.test.ts` 는 금지다(게이트 `misnamed-e2e`) — Vitest 로 도는 계약 테스트를 E2E 로 오해하게 만든다.
|
||||
|
||||
---
|
||||
|
||||
## 3. 이 저장소의 의미 있는 RED 기준
|
||||
|
||||
`02` 의 5축을 그대로 쓰되, 이 앱에서 관찰 가능한 결과는 다음으로 고정한다.
|
||||
|
||||
| 대상 | 관찰 가능한 결과 (단정할 것) | 단정하지 말 것 |
|
||||
|---|---|---|
|
||||
| 데스크톱 셸 | `aria-current="page"`, role=navigation, testid(`nav-*`, `settings-tab-*`) | CSS 클래스, 컴포넌트 내부 state |
|
||||
| 설정 | `role="tab"` 개수 = `SETTINGS_TAB_ORDER.length`, `aria-selected` | MUI 내부 `.MuiTab-root` |
|
||||
| 온보딩 | dialog 존재, 모드 카드 2개, 온라인 선택 → email/password 입력 노출 | 실제 로그인 성공/실패(백엔드 의존) |
|
||||
| 서비스 | `EventEmitter` 로 방출된 이벤트, `IPCResult`(success/error code) | 프라이빗 메서드 호출 순서 |
|
||||
| IPC | `IPC_CHANNELS` 상수와 preload 시그니처 | 문자열 채널 하드코딩 |
|
||||
| i18n | `t()` 키 집합의 정합(모든 locale) | 특정 언어 문구 하드코딩 |
|
||||
|
||||
- 서비스 테스트는 `resetForTest()` 로 싱글톤 상태를 비운 뒤 시작한다(`05 §7`).
|
||||
- UI 텍스트는 가능한 한 role/testid 로 잡는다. 텍스트가 필요하면 `t()` 키가 아니라 사용자가 보는 결과를 단정한다.
|
||||
- 회귀(결함 재현)는 RED 정의의 예외다. 버그를 고치기 전에 **실패를 먼저 출력으로 남긴다.**
|
||||
|
||||
---
|
||||
|
||||
## 4. 삭제·통폐합 기록 (2026-11-04, Wave 기준)
|
||||
|
||||
### 4-1. 삭제 (의미 없는 RED / 죽은 테스트)
|
||||
|
||||
| 삭제 | 이유 (02 분류) |
|
||||
|---|---|
|
||||
| `apps/desktop/tests/e2e/red_team_cycle1,2,3,5.spec.ts` | 비대(#9)·비결정(#8)·인공(#4). 개발 머신 스크린샷 경로, 고정 sleep, 조건부 catch 로 "실패해도 초록". |
|
||||
| `apps/web/e2e/red_team_cycle4_web.spec.ts` | `smoke.spec.ts` 와 중복(#9). 보호 라우트·/download 계약은 smoke 로 흡수. |
|
||||
| `apps/desktop/tests/e2e/dashboard.spec.ts` | `navigation.spec.ts` 와 중복(#9). |
|
||||
| `apps/desktop/tests/e2e/pages_crud.spec.ts` | 이름은 CRUD, 실제로는 "input 이 보인다"만 단정 — 이름이 행위를 속임(#10 설명력). |
|
||||
| `apps/desktop/tests/e2e/launch_readiness.spec.ts` | 광고 문구("Cursor AI")·개발 머신 경로 의존(#8). 고객지원 계약만 `customer-support.spec.ts` 로. |
|
||||
| `apps/desktop/tests/e2e/voice_pipeline.spec.ts` | `waitForEvent(...).catch(()=>null)` + `if (window) expect(...)` — 실패 경로가 없다(#1 가짜). |
|
||||
| `apps/desktop/tests/e2e/onboarding.spec.ts` (구) | v4 온보딩(모드 선택)과 불일치 + `isVisible()` 조건부 단정(#3/#1). 새 계약으로 재작성. |
|
||||
| `apps/desktop/tests/e2e/history.spec.ts` | 시드 없이 "전체 삭제"를 검증 — 실제로는 아무것도 지우지 않는다(#1). |
|
||||
| `tests/e2e/*` (루트) | 어떤 설정도 실행하지 않는 고아 사본. 앱 내 스펙과 중복 + .NET API 스펙은 `apps/api-server.Tests` 와 중복. |
|
||||
| `scripts/e2e-desktop-app.js`, `e2e-desktop-settings.js`, `e2e-desktop-full-journey.js`, `real-app-multi-tab-e2e.js`, `capture-launch-sandbox-e2e.js` | 참조 없는 일회성 스크립트. 하드코딩된 `C:/Users/.../.gemini/...` 스크린샷 경로. Playwright 스펙이 대체. |
|
||||
| `apps/desktop/run_e2e_cdp.cjs`, `run_e2e_full_suite.cjs` | 수동 CDP 러너. 위 Playwright 스펙이 대체. |
|
||||
|
||||
### 4-2. 통폐합
|
||||
|
||||
| 이전 | 이후 |
|
||||
|---|---|
|
||||
| 9개 스펙에 복붙된 Electron launch/온보딩 우회/창 탐색 | `tests/e2e/support/electron-app.ts` 픽스처 하나 |
|
||||
| dashboard + navigation | `navigation.spec.ts` (노출 계약 + aria-current 이동) |
|
||||
| 설정 모달 탭 순회(구 settings) | `settings.spec.ts` (정본 `SETTINGS_TAB_ORDER` import, 딥링크, 탭 전환) |
|
||||
| onboarding(구) + red_team_cycle5 온보딩 | `onboarding.spec.ts` |
|
||||
| launch_readiness 고객지원 부분 | `customer-support.spec.ts` |
|
||||
| history(구) | `records.spec.ts` (새 설치 빈 상태만 — 삭제 흐름은 훅/서비스 테스트가 이미 덮음) |
|
||||
| web cycle4 + smoke | `apps/web/e2e/smoke.spec.ts` |
|
||||
| `tests/red/ads/*.e2e.test.ts` | `*.test.ts` (Vitest 계약 테스트임을 이름에 맞춤) |
|
||||
| 웹 순수 로직 스펙 3개(`billing-catalog`, `web-push`, `web-stt-client`) | `apps/web/tests/*.test.ts` + Vitest. 브라우저가 필요 없는데 Playwright 로만 돌아 **CI 에서 아예 실행되지 않던** 테스트였다. 이제 `npm test` 에 포함. |
|
||||
| `tests/unit/AdMediationEngine.spec.ts`, `license-open-billing.spec.ts` | `*.test.ts` (Vitest 인데 spec 이름을 쓰던 마지막 2건) |
|
||||
|
||||
---
|
||||
|
||||
## 5. 보호 수용 경로 (에이전트가 약화·삭제 금지)
|
||||
|
||||
임계 여정 5개만 보호한다. 나머지 스펙은 일반 리뷰 대상.
|
||||
|
||||
```
|
||||
apps/desktop/tests/e2e/navigation.spec.ts
|
||||
apps/desktop/tests/e2e/settings.spec.ts
|
||||
apps/desktop/tests/e2e/onboarding.spec.ts
|
||||
apps/desktop/tests/e2e/customer-support.spec.ts
|
||||
apps/desktop/tests/e2e/records.spec.ts
|
||||
apps/web/e2e/smoke.spec.ts
|
||||
```
|
||||
|
||||
규칙:
|
||||
0. 저장소 루트 `CODEOWNERS` 가 이 경로들(와 `docs/tdd-red/`, hygiene 스크립트)의 소유자를 지정한다.
|
||||
1. 이 파일의 **단정 삭제·약화·skip** 은 사람 승인 없이 금지(`05 §2`의 '보호' 다운그레이드).
|
||||
2. 새 수용 계약이 필요하면 이 목록에 추가하고 **이 문서 §4 에 근거를 남긴다.**
|
||||
3. 여정이 바뀌면 먼저 "왜 사용자가 하는 일이 바뀌었는가"를 커밋 본문에 적는다. 테스트만 고치지 않는다.
|
||||
|
||||
---
|
||||
|
||||
## 6. 게이트와 명령
|
||||
|
||||
```bash
|
||||
# 커밋 전 (빠름)
|
||||
npm run test:hygiene:test && npm run test:hygiene
|
||||
|
||||
# 통합 전 (워크스페이스)
|
||||
npm run verify:all
|
||||
|
||||
# 보호 수용 경로만 (릴리스 전)
|
||||
npm run test:acceptance:web # smoke: 인증 없는 표면 계약
|
||||
npm run test:acceptance:desktop # 5개 보호 여정 (빌드 산출물 + GUI 세션 필요)
|
||||
|
||||
# 전체 E2E
|
||||
npm run build --workspace=@d3ro/desktop
|
||||
npm run test:e2e --workspace=@d3ro/desktop
|
||||
|
||||
# 웹 E2E (서버 없이: E2E_NO_SERVER=1, 대상 지정: E2E_BASE_URL=...)
|
||||
npm run test:e2e --workspace=@d3ro/web
|
||||
```
|
||||
|
||||
`test:hygiene` 가 막는 것: `.only`, 이유 없는 `.skip()`, 항상 참인 단정, `isVisible()` 조건부 단정,
|
||||
개발 머신 경로(Antigravity/.gemini/AppData Temp), `waitForTimeout`, `.e2e.test.ts` 오명명,
|
||||
`e2e/` 밖의 `*.spec.ts`, 단정이 한 줄도 없는 테스트 파일.
|
||||
규칙을 늘릴 때는 `--self-test` 에 unsafe/safe fixture 를 **함께** 추가한다(오탐 방지).
|
||||
|
||||
> 데스크톱 E2E 는 CI 러너에 X 디스플레이가 없어 상시 잡으로 돌리지 않는다. 릴리스 전 로컬/Windows 러너에서 돌린다.
|
||||
> (이 저장소 규칙: 에이전트 서브셸에서 Electron GUI 를 백그라운드 실행하지 않는다.)
|
||||
|
||||
---
|
||||
|
||||
## 7. 예시 — 같은 여정, 다른 품질
|
||||
|
||||
### 삭제된 형태 (red_team_cycle 류)
|
||||
|
||||
```ts
|
||||
// 하드코딩된 개발 머신 경로, 앱당 1회만 실행, 조건부 단정
|
||||
const SCREENSHOT_DIR = 'C:/Users/<user>/.gemini/antigravity/.../screenshots'
|
||||
test.beforeAll(async () => { /* launch + 1.5s sleep + reload */ })
|
||||
test('RT-16: ...', async () => {
|
||||
if (await navButton.isVisible()) {
|
||||
await navButton.click()
|
||||
await window.waitForTimeout(300)
|
||||
}
|
||||
expect(uncaughtExceptions).toEqual([]) // 아무 것도 증명하지 않는 단정
|
||||
})
|
||||
```
|
||||
|
||||
### 보호되는 형태
|
||||
|
||||
```ts
|
||||
// 격리된 앱, 사용자 표면(aria-current), 실패 시 trace
|
||||
import { expect, expectNoRuntimeErrors, goToRoute, test } from './support/electron-app'
|
||||
|
||||
test('각 항목을 누르면 현재 화면 표시가 정확히 하나로 옮겨간다', async ({ mainWindow }) => {
|
||||
const nav = mainWindow.window.getByRole('navigation')
|
||||
for (const route of NAV_ROUTES) {
|
||||
await test.step(route, async () => {
|
||||
await goToRoute(mainWindow, route)
|
||||
await expect(nav.locator('[aria-current="page"]')).toHaveCount(1)
|
||||
})
|
||||
}
|
||||
expectNoRuntimeErrors(mainWindow)
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 갱신 규칙
|
||||
|
||||
- 테스트 계층/경로/명령이 바뀌면 이 문서 §2 를 먼저 고친다.
|
||||
- E2E 여정을 추가·삭제하면 §4(이유)와 §5(보호 목록)를 같은 커밋에서 갱신한다.
|
||||
- `test:hygiene` 규칙을 추가하면 `--self-test` fixture 와 `02-meaningful-vs-meaningless-red.md` 를 함께 갱신한다.
|
||||
- 맵 문서(`docs/map/10`, `11`, `02`)의 테스트 인프라 행도 같은 커밋에서 갱신한다(`AGENTS.md §4`).
|
||||
|
||||
---
|
||||
|
||||
## 9. 출처
|
||||
|
||||
- Kent C. Dodds, *The Testing Trophy and Testing Classifications* — https://kentcdodds.com/blog/the-testing-trophy-and-testing-classifications
|
||||
- Ham Vocke / Martin Fowler, *The Practical Test Pyramid* — https://martinfowler.com/articles/practical-test-pyramid.html
|
||||
- Microsoft, *Playwright Best Practices* — https://playwright.dev/docs/best-practices
|
||||
- 저장소 내부: `docs/tdd-red/01`~`05`, `docs/tdd-red/SOURCES.md` (2026 RED 원론·증거 94 항목)
|
||||
|
|
@ -95,8 +95,8 @@
|
|||
| 묶음 | 현재 판정 | 확인된 증거 / 남은 게이트 |
|
||||
|---|---|---|
|
||||
| Auth·계정 | 구현·자동화 GREEN, 외부 OAuth·privacy purge 기기 E2E 대기 | auth/signup/invite 경계는 2026-11-01 Fold6 `1.15.4-e2e.20261101.2`에서 PASS. Keychain 세션, 중앙 `purgeAllAccountLocalData`, cold no-session·SIGNED_OUT·refresh session loss·A→B 전환·실패 재시도 경계는 Jest GREEN. 실제 token-expiry 강제 로그아웃·logout/delete/provider 연결/해제 기기 E2E와 Google/GitHub/Apple 동의→callback은 남음 |
|
||||
| 온보딩 | 현재 구현·Fold6 journey GREEN | 신규 사용자 목적지를 persistence 전에 준비하도록 수정한 뒤 fresh auth/signup/invite/small-screen 4/4 PASS. 이 증거를 v4 셸의 전 테마·viewport 또는 로그아웃 완료 증거로 재사용하지 않는다 |
|
||||
| v4 셸·테마·접근성 | 셸 `[x]`, 디자인 시스템·접근성 `[~]` | visible Home/Records/Meetings/More 4탭, hidden Record route, 세 동작 FAB, Home/More, 새/전환된 v4 흐름의 `ScreenHeader`, ui-native dark/light 의미 토큰과 48dp control을 구현했다. 전체 Jest 87 suites/599 tests, 320dp dark 1/1 PASS(88초), 411dp light 1/1 PASS(100초). 기존 stack 화면 전부의 헤더 전환을 뜻하지 않으며 실제 TalkBack/font-scale/rotation은 남음 |
|
||||
| 온보딩 | `[~]` 구현·회귀 테스트 GREEN, current physical first-run 미증명 | 신규 사용자 목적지를 persistence 전에 준비하도록 수정했고 historical `.2` Fold6 fresh auth/signup/invite/small-screen 4/4는 PASS했다. 이후 current `.3` Fold6 fresh-auth와 retry는 onboarding visibility에서 실패했고, 같은 `.3`의 격리 API 34 AVD fresh auth/signup은 PASS했다. 2026-11-04 `1.16.1` Fold6 결과는 state-preserving upgrade/cold launch이므로 current physical first-run 증거로 재사용하지 않는다 |
|
||||
| v4 셸·테마·접근성 | 셸 `[x]`, 디자인 시스템·접근성 `[~]` | visible Home/Records/Meetings/More 4탭, hidden Record route, 세 동작 FAB, Home/More, 새/전환된 v4 흐름의 `ScreenHeader`, ui-native dark/light 의미 토큰과 48dp control을 구현했다. 전체 Jest 87 suites/599 tests, 320dp dark 1/1 PASS(88초), 411dp light 1/1 PASS(100초). 2026-11-04 current-source Fold6/API 34 upgrade+launch, inspected-route UIA labels/48dp, AVD font-scale 2.0 + rotation/scroll, physical Notifications cards를 확인했다. 이는 자동 Android 경로 증거이며 기존 stack 전체, 수동 TalkBack/focus order, SDK AdMob WebView, iOS를 완료했다는 뜻은 아님 |
|
||||
| 녹음·전사·Talk | 핵심 경로 GREEN | API 34 microphone FGS, 지속 알림, pause/resume/discard, 실제 통화 audio-focus, 프로세스 kill 후 WAV 복구, 파일 import, cloud STT fail-closed, on-device Whisper, Claude SSE, Android TTS를 통합 APK에서 확인. STT provider 호출 전 원자 quota reservation·실패 환불은 20-way 동시성으로 검증. Android `ACTION_SEND` 수신은 허용 MIME·크기·provider 예외·MP4 AAC 추출을 fail-closed로 구현했고 API 34 instrumentation 4/4(CSPRNG 1 + share 3)와 별도 UID 외부 ContentProvider APK→`ACTION_SEND`→Record→durable queue→cancel cleanup E2E가 GREEN |
|
||||
| 데이터 portability | 구현·공유 E2E GREEN | 00021 atomic export/restore, 손상/타 사용자/충돌 rollback, legacy import를 local integration으로 확인. `portable_exports`→FileProvider `shared_exports` 경계와 PDF Print/DOCX chooser·30초 cleanup을 실제 기기에서 확인 |
|
||||
| History·회의 | 실제 데이터·회의 생성 계약 GREEN, 녹음 파일→회의 `[~]` | Supabase history pagination/search/favorite/CAS, Web↔mobile history E2E, meetings/memos/documents RLS/CAS, meeting recording lifecycle 구현. 00025의 제목·참석자·4개 언어·소유 템플릿 원자 생성은 2계정 43 assertions와 competing-payload PT409로 검증. H-017 기존 파일 회의 import는 생성 라우팅·durable meeting pipeline Jest가 GREEN이지만 실제 파일의 Fold6 전사·회의록 E2E는 NOT_RUN. speaker/audio timestamp와 최종 교차 앱 E2E도 남음 |
|
||||
|
|
@ -104,7 +104,7 @@
|
|||
| Teams·Push | 팀 GREEN, 외부 Push 대기 | production 17 assertions와 local 36 assertions로 원자 팀/초대/RLS/role/device token 계약 확인. durable push outbox 00015~00020과 logout device `1→0` 확인. 실제 FCM 수신은 Firebase/FCM 자격 증명·cron 배포가 필요 |
|
||||
| Billing·Ads | test 광고와 production AdMob identity/SSV 준비, store·실제 지급 E2E RED | Google Play restore는 실제 store list→모든 token 서버 검증→entitlement snapshot 일치 후에만 성공. Google 공식 test adaptive banner와 rewarded `AdActivity` 완주를 실측했다. production app `ca-app-pub-1039714767792854~6427959892`, banner `/9840591290`, rewarded `/2255790918`, `50 cloud_ai_tokens`, SSV URL, Edge v13, durable receipt 원장은 SSOT에 반영했다. 그러나 live는 `검토 필요`, `광고 게재 제한`, store 미연결, 결제 프로필 미완료다 |
|
||||
| Admin | 서버·Web·모바일 E2E와 production DB·Edge 배포 GREEN | .NET 21/21, 00023 관리 integration 25 assertions, Edge/JWT 47 assertions와 TLS Chromium E2E GREEN. 모바일 API 34에서 ordinary/manager/admin/super_admin 및 stale 강등을 55 assertions로 실측: Free test 광고, Pro 광고 미요청, 관리자 메뉴/API 차단, 구독 수정, 역할 경계·변경, 삭제 확인·취소, stale JWT 403와 민감 state purge가 모두 PASS. fixture 잔존 0. production 00023 및 admin Edge 4개 배포 후 익명 GET은 모두 `401 authentication_required` + `Cache-Control: no-store`로 재검증 |
|
||||
| 품질·배포 | source GREEN; current first-run unverified; production RED | 2026-11-01: Jest 87 suites/599 tests, lint/typecheck GREEN. 현재 Fold6 APK `.3` / `2026110103`, 147158575 B, SHA-256 `937d2a0b3fb6b810516f07e91dd97ffe99d34c5885a72f21805a51e8a408027f`는 artifact verifier GREEN이며 import 버튼·폼이 표시된다. `.2`의 4/4 PASS와 달리 `.3` 첫 실행 시험 2회는 실패했고 재초기화 없이 보존했다. production config는 `firebase_expected_project_id_missing`; AAB/Play 미배포. |
|
||||
| 품질·배포 | source GREEN; current upgrade/launch GREEN; first-run unverified; production RED | 2026-11-04: `1.16.1-e2e.20261104.1` / `2026110401`, 147160979 B, SHA-256 `3d2875c74b555dbcd854468e57b9b4b3a8e6c9657f210760cbe24a77ee92cf7c` dual-ABI artifact verifier GREEN; Fold6/API 34에 `adb install -r`, cold launch, bounded crash signature 0. 모바일 lint/typecheck와 focused Jest 6 suites/38 tests도 GREEN. 기존 데이터를 보존했으므로 first-run은 재검증하지 않았고, 2026-11-01 `.3` Fold6 실패/AVD PASS 경계는 그대로다. production config/AAB/Play는 여전히 RED. |
|
||||
|
||||
**v4 제거 범위:** `DashScreen`과 `WorksHubScreen`을 삭제했다. Home과 1급 탭/More가 기존 목적지를 보존하며 사용자 콘텐츠는 삭제하지 않았다. WorksHub 전용 로컬 도구 검색·고정은 복잡도 축소를 위해 의도적으로 종료했고, 비활성 `works-hub-pins.v1` AsyncStorage 키는 업그레이드 설치에 남을 수 있다.
|
||||
|
||||
|
|
@ -131,8 +131,8 @@
|
|||
- [x] G-003 모바일 환경 설정 스키마 작성: Supabase URL/anon key, API origin, OAuth redirect, AdMob app/unit IDs, Play product IDs
|
||||
- [x] G-004 debug/test/prod 설정 분리와 시작 시 구성 진단 화면 구현
|
||||
- [x] G-005 하드코딩된 release signing 자격 증명을 로컬/CI secret 주입으로 이동
|
||||
- [ ] G-006 공용 API·DB 타입을 `packages/api-client`에서 소비하고 화면별 임시 타입 제거
|
||||
- [ ] G-007 오류 코드·사용자 메시지·관찰 가능 로그를 공용 규약으로 통일
|
||||
- [~] G-006 공용 API·DB 타입을 `packages/api-client`에서 소비하고 화면별 임시 타입 제거 — 2026-11-04: push token/provider와 register/unregister RPC·quota period 계약을 공용 타입에 맞추고, 11개 화면의 `useNavigation<any>`/`useRoute<any>`를 `RootStackParamList`로 교체했다. 프로필 등 화면별 임시 DB DTO와 나머지 feature-local 계약은 계속 정리해야 한다.
|
||||
- [~] G-007 오류 코드·사용자 메시지·관찰 가능 로그를 공용 규약으로 통일 — 2026-11-04: `TalkScreen`의 직접 `console.warn`을 공용 `createLogger('Talk')`로 전환했다. 앱 전체 오류 코드·번역 메시지·구조화 로그 계약 감사와 통합은 남아 있다.
|
||||
- [ ] G-008 legacy bundle/APK 생성물을 소스 변경과 분리하고 재현 가능한 build script 확정
|
||||
- [ ] G-009 Supabase Auth/profile/subscription을 단일 사용자·entitlement SSOT로 확정하고 .NET 계정은 제거 또는 명시적 매핑
|
||||
- [ ] G-010 Android application ID, iOS bundle ID, OAuth client, 딥링크 scheme을 하나의 제품 식별자로 통일
|
||||
|
|
@ -171,7 +171,7 @@
|
|||
- [ ] O-007 튜토리얼 다시 보기·건너뛰기·완료 상태 동기화
|
||||
- [~] O-008 system/light/dark 테마와 D3RO 토큰 기반 렌더링 — ui-native v4 dark/light palette parity·provider/component Jest, 320dp dark·411dp light runtime GREEN. 새/전환된 v4 흐름 밖의 앱 전체 테마 적용 감사까지 완료했다는 뜻은 아님
|
||||
- [ ] O-009 테마·언어·햅틱·자동 교정·STT 옵션 저장 및 기기간 동기화
|
||||
- [~] O-010 글자 확대, TalkBack label/role, focus order, 48dp 터치 영역, 색 대비 검증 — touched controls/ScreenHeader 48dp와 theme contrast source tests GREEN, 실제 TalkBack·focus order·font scale·rotation은 대기
|
||||
- [~] O-010 글자 확대, TalkBack label/role, focus order, 48dp 터치 영역, 색 대비 검증 — touched controls/ScreenHeader 48dp와 theme contrast source tests GREEN. 2026-11-04 physical Home/API 34 Login의 inspected app-owned action label·48dp와 AVD font scale 2.0 portrait/landscape scroll는 자동 검사 GREEN. AdMob SDK WebView 한 개는 clickable label이 UIA에 노출되지 않았고, 실제 TalkBack announcement/activation·focus order·앱 전체 경로·iOS는 대기 ([evidence](../evidence/2026-11-04-mobile-runtime-a11y.md))
|
||||
- [ ] O-011 reduced motion과 애니메이션 비활성 경로
|
||||
- [~] O-012 한국어/영어 필수 전체 번역과 하드코딩 문자열 제거 — v4 셸·FAB·통합 검색과 touched enum label은 ko/en typed keys 사용, 앱 전체 감사 대기
|
||||
|
||||
|
|
@ -266,8 +266,8 @@
|
|||
- [x] T-008 role 변경·구독 수정 등 파괴적 관리 동작은 재확인·감사 로그·서버 권한 검증 — admin role 범위·delete confirm/cancel, super manager→admin, RPC readback과 cleanup 0 E2E PASS
|
||||
- [ ] T-009 push token 등록/교체/로그아웃 삭제와 중복 방지
|
||||
- [ ] T-010 전사 완료·팀 초대·댓글·결제 상태 push 수신과 해당 화면 딥링크
|
||||
- [ ] T-011 알림 카테고리 설정·OS 권한 미허용 fallback
|
||||
- [ ] T-012 foreground/background/terminated 상태 알림 E2E
|
||||
- [ ] T-011 알림 카테고리 설정·OS 권한 미허용 fallback — 2026-11-04 physical device의 이미 granted/Registered 상태에서 status/privacy/recent cards만 확인했다. denied fallback·permission request/system dialog는 상태를 바꾸지 않아 미검증
|
||||
- [ ] T-012 foreground/background/terminated 상태 알림 E2E — Notifications 화면 진입은 확인했지만 current-session receipt는 비어 있었고 실제 FCM 전달/딥링크 proof는 없음
|
||||
- [x] T-013 Admin API 장애 때 realistic mock 운영 데이터를 반환하지 않고 명시 오류·stale 상태 표시 — stale-role 403 실측에서 `admin-error` 노출 및 기존 민감 state 제거
|
||||
|
||||
### M — 구독·구매·결제·Free tier 광고
|
||||
|
|
@ -324,10 +324,10 @@
|
|||
- [x] Q-018 Free banner/rewarded test ad와 Pro 광고 미요청 E2E — official Google test ad 실측, ordinary Free 광고 노출과 manager/admin Pro 광고 비노출·미요청 API 34 PASS
|
||||
- [ ] Q-019 Play Billing test purchase/restore/manage E2E
|
||||
- [ ] Q-020 모든 탭·설정·팀·관리·실패 복구 journey E2E — v4 4탭/FAB/More/통합 검색의 320dp dark·411dp light 부분 journey만 GREEN; 전체 범위를 대신하지 않음
|
||||
- [~] Q-021 회전·폰트 확대·TalkBack·dark/light·작은/큰 화면 visual gate — 이 v4 journey의 320dp dark·411dp light는 GREEN; 회전·폰트 확대·TalkBack 실기기 증거는 대기
|
||||
- [~] Q-021 회전·폰트 확대·TalkBack·dark/light·작은/큰 화면 visual gate — v4 journey의 320dp dark·411dp light와 2026-11-04 API 34 Login font scale 2.0 portrait/landscape scroll는 GREEN. 후자는 자동 AVD route proof이며 physical TalkBack/focus order, app-wide 확대/회전, SDK ad, iOS는 대기
|
||||
- [ ] Q-022 airplane mode·process kill·token expiry·server 5xx·중복 tap 회복 E2E
|
||||
- [~] Q-023 앱 로그 crash/ANR/React error/민감정보 0건 확인 — exact `.9` auth/signup/invite/small-screen 및 admin role journeys에서 fatal/ANR/React fatal 0, production provider journey 민감정보 로그 감사 대기
|
||||
- [x] Q-024 APK package/version/signature/SHA-256와 설치된 앱 버전 증거
|
||||
- [~] Q-023 앱 로그 crash/ANR/React error/민감정보 0건 확인 — exact `.9` auth/signup/invite/small-screen 및 admin role journeys에서 fatal/ANR/React fatal 0. 2026-11-04 current-source Fold6/API 34 cold launch 뒤 bounded recent logcat도 crash/React fatal signature 0; 장시간 ANR·production provider journey·민감정보 로그 감사는 대기
|
||||
- [x] Q-024 APK package/version/signature/SHA-256와 설치된 앱 버전 증거 — 2026-11-04 E2E `1.16.1-e2e.20261104.1` / `2026110401`, SHA-256 `3d2875c7…cf7c`, verifier 및 Fold6/API 34 installed identity 일치. Production artifact 증거로 재사용하지 않음
|
||||
- [x] Q-025 최종 증거 표에 명령·결과·artifact·스크린샷/영상 경로 기록
|
||||
- [ ] Q-026 Node 24 LTS/JDK 17/Gradle 환경을 로컬·CI에서 통일
|
||||
- [~] Q-027 debug x86_64+arm64, release arm64 APK/AAB ABI 정책과 에뮬레이터 호환성 검증 — universal E2E APK 정책 GREEN, 실제 production arm64 APK/AAB CI 검증 대기
|
||||
|
|
@ -358,7 +358,7 @@
|
|||
- [x] EXT-007 개인정보 처리방침·이용약관·계정 삭제 공개 URL — NAS host/runtime에 동일 해시로 좁게 배포, `/privacy/`, `/terms/`, `/delete-account/` 외부 HTTPS 200·정확한 title·삭제 요청 링크 확인. 모바일 Settings와 Paywall에서 canonical URL 진입
|
||||
- [!] EXT-008 local upload key·Ed25519 evidence keypair는 ACL/readback/roundtrip GREEN. production Firebase/AdMob/signing/evidence secret의 CI 보관·보호 환경 승인·복구 백업 및 `1.2.0`/`1020001` production AAB workflow는 대기
|
||||
- [!] EXT-011 Firebase Console `u/0`, `u/1` 모두 D3RO project 0개 — 사용자 action-time 승인 후 production project·Android app·Play fingerprint·FCM 생성/연결
|
||||
- [!] EXT-009 Fold6 physical-device install/share/OAuth/purchase 증거 — exact `.11` APK Taildrop 전송 완료, 사용자 설치·실행·공유/OAuth/구매 확인 필요
|
||||
- [!] EXT-009 Fold6 physical-device share/OAuth/purchase 증거 — 2026-11-04 current-source E2E APK의 state-preserving `adb install -r`와 cold launch는 확인했다. 실제 파일 공유/OAuth/구매 및 production artifact 사용자 설치는 여전히 필요
|
||||
- [!] EXT-010 Play closed test 12명·연속 14일 완료와 production access 승인 — 2026-08-29 현재 0명, access disabled
|
||||
|
||||
## 7. 검증 증거 표
|
||||
|
|
@ -371,6 +371,7 @@
|
|||
| Historical mobile unit | `npm --prefix apps/mobile-rn test` | 당시 전체 통합 tree 57 suites / 353 tests GREEN; 현재 tree 수치가 아님 | `apps/mobile-rn/__tests__` | 2026-08-24 |
|
||||
| Current mobile unit | `npm --prefix apps/mobile-rn test` | 전체 tree **87 suites / 599 tests PASS**. 온볼딩 목적지 순서와 H-017 회의 생성→녹음 파일 import→durable meeting pipeline 회귀를 고정하고 lint/typecheck도 GREEN | `apps/mobile-rn/__tests__/{onboarding-fresh-route.test.tsx,meeting-creation-screen.test.tsx,record-screen-redteam-r2-27.test.tsx}` | 2026-11-01 |
|
||||
| Current local runtime APK | metadata + SHA-256 + installed identity + Build Tools 37 verifier | `.3` / `2026110103`, 147158575 B, SHA-256 `937d2a0b3fb6b810516f07e91dd97ffe99d34c5885a72f21805a51e8a408027f`; local E2E artifact, production 아님. import entry/editor 실기 표시 확인; 저장·전사·회의록은 미검증 | `test-results/recovery-2026-11-01/android-artifact.json`, `mobile-import.xml`, `mobile-import.png` | 2026-11-01 |
|
||||
| Wave 4 current-source Android runtime/a11y | dual-ABI E2E build+verifier → `adb install -r` → cold launch/logcat → UIAutomator/font-scale/rotation → state-neutral Notifications Maestro | `1.16.1-e2e.20261104.1` / `2026110401`, 147160979 B, SHA-256 `3d2875c7…cf7c`; verifier, Fold6/API 34 upgrade install and launch GREEN. Notifications status/privacy/recent 1/1 PASS without permission command; inspected route a11y automation partial GREEN. Manual TalkBack/iOS/permission transition/FCM receipt/production artifact는 미검증 | `docs/evidence/2026-11-04-mobile-runtime-a11y.md`, `apps/mobile-rn/.maestro/notifications-permission-preserve-state.yaml`, local `.maestro-output/wave4-notifications-state-neutral-20261104/` | 2026-11-04 |
|
||||
| Historical `.2` Fold6 first-run gate | bundled E2E APK fresh install + canonical auth/signup/invite + `840x1490` signup | **4/4 PASS**: auth 60초, signup 67초, invite 31초, small-screen signup 61초. 신규 사용자가 SignUp으로 진입하고 cold restart 후 Login이 유지된다. fatal/Metro matches 0. 계정 필요 authenticated parity는 credentials 부재로 NOT_RUN | `apps/mobile-rn/.maestro-output/fold6-20261101-fix1/`, `apps/mobile-rn/.maestro/{fresh-install-auth,fresh-install-signup,small-screen-signup}.junit.xml` | 2026-11-01 |
|
||||
| Mobile v4 320dp dark runtime | `apps/mobile-rn/.maestro/navigation-shell-search-local.yaml` | **1/1 PASS, 0 failure, 88초**: visible 4 tabs, FAB open/back close, Home unified search, record+meeting results→both details, Records/Meetings/More navigation | `scratch/design-audit/wave45/navigation-shell-search-320-dark-verified.xml`, `docs/evidence/wave45-mobile-shell-search-2026-09-28.md` | 2026-09-28 |
|
||||
| Mobile v4 411dp light runtime | same journey on 411dp light | **1/1 PASS, 0 failure, 100초**. 두 보고서는 shell/viewport/theme runtime proof이며 TalkBack/font-scale/rotation 또는 production release proof가 아니다 | `scratch/design-audit/wave45/navigation-shell-search-411-light-verified.xml`, `docs/evidence/wave45-mobile-shell-search-2026-09-28.md` | 2026-09-28 |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue