d3ro-voice/docs/evidence/2026-11-17-backlog-operations.md

118 lines
16 KiB
Markdown

# 2026-11-17 백로그 운영·검증 증거
## 전체 게이트
- `npm run verify:all` GREEN: desktop Vitest 212 files / 2,890 tests, mobile Jest 103 suites / 651 tests, workspace/mobile/site typecheck·lint 및 위생·계약 게이트 통과.
- `dotnet test apps/api-server.Tests` 55/55 PASS.
- Cloudflare Worker Deno 15/15, Site Bridge Deno 5/5 PASS.
- 모바일 release boundary/config/build-config self-tests, `test:hygiene`, `check:protected-tests`, `security:secrets`, `contract:check`, `check:migrations`(74), `check:i18n`, `check:ds-contract`, `check:design`, `version:check` GREEN.
## Wave 7 운영 반영
- 롤백 태그 시점: NAS `20261117-173718`.
- 원격 Docker 이미지: API `12580b023110…`, Admin `2b7a31b0959a…`, Web(VAPID 포함) `cfaa99bc17f2…`.
- `scripts/deploy-nas.ps1 -BuildOnly`로 SSH 원격 빌드 후 NAS compose로 교체했다. 로컬 패키징은 로컬 `JWT_SECRET` 부재로 첫 시도에서 중단됐지만 이미지 빌드는 완료됐고, NAS의 기존 `.env`를 유지해 배포했다.
- 라이브 확인: `/`, `/app/login`, `/health`, `https://d3ro-admin.chanpaca.net/login`, Worker `/worker-health` 및 프록시 `/health` 모두 HTTP 200.
- Worker `d3ro-voice-api` 현재 코드 배포 ID `b9e68793-b061-481f-a620-dab73a91a9d8`; Site Bridge `cca39627-c96e-4164-892e-6ffb3a1b54bf`. 기존 사설 IP `BACKEND_ORIGIN`은 제거됐다.
## Push drain 복구
1. 최초 scheduled 로그는 `push_drain_http_401`이었다.
2. `push-drain.test.ts`에 현대식 서비스 키의 `apikey` 계약을 먼저 추가해 RED를 확인하고, `push-drain.ts`가 Bearer + `apikey`를 모두내도록 수정했다. Deno 15/15 GREEN.
3. Worker에는 현재 Supabase 프로젝트의 default secret을 주입했다. 값이나 저장 파일 내용은 출력하지 않았다.
4. 직접 drain HTTP 200 `claimed=1 completed=1 pending=0` 및 실제 Cloudflare scheduled 로그 `claimed=1 completed=1 pending=0`을 확인했다.
5. `send-push`를 VAPID 설정 후 운영 재배포하고 drain HTTP 200 `claimed=0 completed=0 pending=0`을 재확인했다.
6. `WEBPUSH_VAPID_PUBLIC_KEY`/`WEBPUSH_VAPID_PRIVATE_KEY`/`WEBPUSH_SUBJECT`는 Supabase에만 존재 여부를 확인했다. 공개키는 `release/webpush-vapid-public.key`, 개인키는 저장소에 없다.
## 운영 audio-purge 실제 스케줄
- `cron.job`: `purge-orphaned-audio` active, `*/10 * * * *`.
- 초기 Vault에는 `project_url`/`service_role_key`가 없어 cron이 no-op이었다. 현재 프로젝트 URL과 default secret으로 Vault를 복구했다.
- 고립된 임의 UUID의 queue row와 실제 WAV Storage 객체를 만들고 09:00 UTC 스케줄을 관찰했다.
- 결과: queue `1 → 0`, Storage object `1 → 0`, `net._http_response.status_code=200`. 사용자 데이터는 대상이 아니며 임시 객체는 삭제됐다.
## 결제·레거시·App Links
- 운영 Supabase 함수 목록에 Stripe 함수 3종이 없고 `STRIPE_*` 시크릿 5종도 모두 absent다. Stripe 대시보드의 과거 webhook 비활성화만 외부 확인으로 남는다.
- 운영 구독은 `provider=none,status=active` 6건이며 Payple 갱신·만료 대상은 0건이다. `payple-renew` 직접 호출은 실결제 없이 HTTP 200 `{renewed:0,failed:0,expired:0}`이었다. Forgejo 스케줄 이력은 기존 API 토큰 401로 미확인이다.
- `node scripts/ci/verify-android-app-links.mjs` GREEN: live `assetlinks.json`이 package `com.d3ro.voice`, Play app-signing SHA-256 `01001921…0DAB`와 정확히 일치하고 upload certificate를 포함하지 않는다.
## 모바일 현재 소스 빌드·E2E
- 현재 `main` + 이번 검증 스크립트 수정으로 `1.17.1-e2e.20261117.1` / `1170101` APK를 빌드했다. SHA-256 `4FAF848A04A5B77CAFB1197E31472FB60F31B379C59CFA7E802935D617F33B4A`.
- `verify-android-artifact.mjs`는 기본적으로 release/E2E cleartext를 거부하고, 로컬 E2E만 `--allow-local-cleartext true`를 명시할 때 허용한다. Self-test와 실제 universal APK 검증 GREEN.
- 다중 기기 환경에서 Maestro가 다른 기기를 선택하는 문제를 재현하고, `run-mobile-emulator-gate.sh`의 모든 Maestro 호출에 `--udid`를 적용했다.
- `emulator-5582`에서 fresh-install auth, fresh-install signup, invite deep-link가 각각 PASS했다. 작은 화면 `840x1490`도 스크롤 경합을 보정한 뒤 독립 실행에서 3분 6초 PASS했다.
- 후속 전체 실행의 small-screen 단계에서는 에뮬레이터의 `package`/`activity`/`window` 서비스가 사라지는 환경 오류가 발생했다. 앱 어설션 실패가 아니며, 동일 small-screen의 독립 PASS와 구분한다.
## Cloud STT 경계
- 운영 `stt-proxy`를 임시 계정과 4.7초 로컬 TTS WAV로 호출하면 HTTP 502 `gateway/http_504`이고 direct provider는 시도되지 않았다.
- NAS Whisper 재시작 후 직접 전사는 정확한 한국어 문장을 반환했지만 콜드 로딩 포함 약 101초였다. 운영 공개 경로의 30초 경계에서는 여전히 실패한다.
- 유효한 OpenAI/Groq 키 또는 상시 GPU가 없으므로 외부 차단을 유지한다. 임시 STT 계정은 삭제 HTTP 200을 확인했다.
## 운영 Web Push 실제 브라우저 경계
- VAPID 공개키를 포함한 Web 이미지를 NAS에 재빌드·배포하고 `/app/login` HTTP 200을 확인했다.
- 일반 Chrome persistent profile에서 임시 운영 사용자의 로그인·알림 권한·service worker·Push 구독·outbox 등록이 성공했다.
- Headless와 visible Chrome의 두 실행 모두 `push_deliveries.status='delivered'`를 기록했지만 `registration.getNotifications()`는 0이었다. 따라서 provider acceptance는 GREEN이지만 실제 알림 표시 수신은 계속 미검증이다.
- 두 실행 모두 임시 사용자 삭제 HTTP 200, 브라우저 임시 profile 삭제를 완료했다.
### 모바일 취소 조작 보정
- 녹음 중 `record-cancel`은 광고 아래에 있어 자동 탐색이 실패했다. 광고·탭 바가 아닌 본문 내부에서 `70% → 30%`로 스와이프한 뒤 ID를 탭하니 `record-start` 복귀가 성공했다. 이 동작을 `authenticated-parity.yaml`에 적용했다.
### Authenticated parity 최종 경계
- 로컬 격리 계정으로 로그인·Home·Free 테스트 광고·녹음 진입·권한 거부/허용·실제 녹음까지는 재현됐다.
- `record-cancel`은 짧은 paused-state 회복 플로우에서 한 번 성공했지만, 전체 recording 경로에서는 반복 실행 시 안정적으로 선택되지 않았다. 최종 전체 실행은 `record-cancel` 미선택으로 RED다. 이를 완료로 기록하지 않는다.
- 추가 시도에서 More의 Settings 진입까지 도달한 실행도 있었으나 전체 플로우는 완료하지 못했다. Maestro 스크롤·안정화·다중 기기 조합 문제를 추가 조사해야 한다.
- 로컬 임시 사용자는 삭제 HTTP 200, 로컬 Supabase는 중지하고 Docker Desktop도 기존 상태로 종료했다.
## 2026-11-18 후속 모바일·보안 작업
### 모바일 공식 게이트 복구
- `record-cancel`은 광고 위의 사용 가능한 본문에서 대상 ID가 보일 때까지 스크롤하도록 바꿨다. 고정 좌표 탭이나 한 번의 스와이프에 의존하지 않는다.
- Account 로그아웃은 실제로 화면 밖에 있어 스크롤을 추가했다. More는 방문 위치가 유지되므로 Data portability → Dictionary → Commands 경로의 스크롤 방향을 실제 목록 순서에 맞춰 위로 정정했다.
- `1.17.1-e2e.20261118.1` / `1170102` 공식 실행에서 fresh auth, signup, invite, 840x1490 small-screen signup, authenticated parity가 모두 PASS했다. 인증 플로우는 2분 37초였고 fatal/Metro signature 0건, `external-gates.json`의 `authenticatedParity=PASS`다. 임시 로컬 계정은 매 실행 HTTP 200으로 삭제했다.
- `build-mobile-local-e2e.ps1`은 pinned Supabase CLI 3.2.0을 사용한다. PowerShell 5.1이 CLI의 stderr 경고를 오류로 승격하던 문제는 상태 조회 구간의 종료 코드를 별도 검사하도록 바꿨고, 이 시스템의 PowerShell 7 모듈 우선순위 때문에 `Get-FileHash`를 찾지 못한 문제는 Desktop edition에서 시스템 Utility 모듈을 명시 로드해 해결했다. 두 수정 후 스크립트 자체가 APK 생성과 SHA-256 대조까지 완료했다.
- Android `applicationId`와 iOS `PRODUCT_BUNDLE_IDENTIFIER`는 `com.d3ro.voice`, canonical auth/invite scheme은 `d3ro-voice`다. iOS의 사용하지 않는 `d3ro` 별칭을 제거하고 `verify-mobile-build-config.mjs --self-test`가 ID·scheme 변형을 거부함을 확인했다.
### 기록 파일·원본 오디오 공유
- `HistoryDetailScreen`에 기존 텍스트 공유 외에 Markdown 파일 공유와 원본 오디오 공유를 연결했다. `history-share.ts`는 다듬은 전사/원문·요약을 TXT/Markdown으로 만들고, 원본 오디오는 신선한 signed URL로만 내려받는다.
- 원본 공유는 사용자의 별도 버튼 탭에서만 시작하고 50 MiB 상한·MIME 확장자·빈 파일·HTTP 오류를 검사한다. Android는 기존 `D3ROFileShareModule`의 FileProvider 임시 읽기 권한과 수명주기 정리를 사용한다. iOS는 파일 URI의 명시적 Share 시트를 사용한다.
- `history-share.test.ts` 5개와 기존 화면 테스트 확장 4개가 통과했다. 특히 준비 중 언마운트 시 늦은 공유 시트가 열리던 경로는 테스트에서 먼저 RED를 재현한 뒤 파일 정리와 미표시를 GREEN으로 확인했다. 전체 모바일 Jest는 104 suites / 658 tests였고, 언마운트 테스트 1개 추가 후 최종 게이트에서 다시 집계한다.
- 실제 외부 앱의 파일 수신은 `external-gates.json`에서 계속 `NOT_RUN_TARGET_APP_REQUIRED`다. 공급자 수신 증거 없이 `[x]`로 올리지 않는다.
- R-019의 강제 재처리는 아직 연결하지 않았다. 기존 오디오 경로는 완료된 동일 파일을 중복 제거해 기존 transcript를 반환하므로, 이를 우회하는 버튼을 실제 재처리처럼 표시하지 않았다.
### 의존성·도구·데스크톱 경계
- Next.js 16.4.6, Mermaid 12.3.0, Electron 43.8.10, electron-vite 6.0.0, Vite 8.3.8, Vitest 5.1.0으로 갱신했다. Electron 44의 Clipboard 재작성은 채택하지 않고, 43에서 비동기화된 `readText`/`writeText`를 실제로 await한다. 새 비동기 원본 복원 회귀 테스트를 포함한다.
- Web/Admin의 Vite 8 OXC JSX 설정과 Admin·root의 명시적 Vitest 의존성을 정리했다. 기존 테스트의 중복 import 하나는 새 파서가 거부해 중복만 제거했다.
- Node는 `.nvmrc` 24.19.0 및 root/mobile `engines.node=24.x`로 맞췄다. 현재 기본 셸은 Node 23이므로 전역 설치를 바꾸지 않고 격리된 Node 24.19.0 실행 파일로 검증했고, `npm run rebuild:test`로 better-sqlite3 ABI 137을 맞췄다.
- `npm run build:all` GREEN(115.78초). 데스크톱 212 files / 2,891 tests, Web 52, Admin 6 tests가 포함됐다. 루트 audit은 critical 0이며 나머지 high 25 / moderate 12를 0으로 위장하지 않는다. 특히 picomatch는 현재 최신 4.0.7도 공개 권고 대상이라 안전한 상위 수정 버전이 아직 없다.
- 실행 중인 설치본 프로세스는 있었지만 모든 main window handle이 0이고 `orca` CLI도 없었다. Electron은 agent subshell에서 새로 실행하지 않았으므로 실제 GUI·제안·클립보드·긴 회의 검증은 여전히 외부 터미널 수동 게이트다.
- 후속 `npm run verify:all`은 Node 24.19.0에서 GREEN이다: desktop 212 files / 2,891 tests, mobile 104 suites / 659 tests, typecheck·lint·i18n·테스트 위생·품질·디자인 계약 포함.
- 최종 E2E APK는 `1.17.1-e2e.20261118.3` / `1170104`, SHA-256 `2AE6BAE279DD507B73D0F1DEE03C11D0649CFC554A4BDFD0FC9BCEFD94912057`다. `verify-android-artifact.mjs --mode e2e`에서 서명·bundle·model·arm64-v8a/x86_64·버전 계약 GREEN.
- 같은 최종 APK로 공식 전체 게이트를 다시 실행해 6분 15초 만에 fresh auth 34초, signup 42초, invite 15초, small-screen signup 48초, authenticated parity 2분 28초 모두 PASS했다. fatal/Metro signature 0, 임시 계정 삭제 HTTP 200이다.
- `navigation-shell-search-local.yaml`은 임시 사용자의 실제 history row와 공식 `mobile_create_meeting_workspace_v2` RPC로 만든 meeting을 사용해 1분 17초 PASS했다. 두 검색 결과, 각 상세 이동과 Markdown 파일 버튼을 확인했다. 종료 시 삭제 요청의 로컬 소켓 오류는 Node 24 정리 실행에서 해당 계정 1건을 HTTP 200으로 삭제하고 잔여 0건을 재조회해 해결했다.
- Electron 버전은 root launcher·desktop·lock·`electron-builder.yml`·`sync-version.mjs`를 모두 43.8.10으로 맞췄다. `version:check` GREEN, `release:metadata:test` 18 negative cases GREEN, root/mobile `npm ci --dry-run --ignore-scripts` PASS다. 최종 `build:all`은 113.61초 만에 GREEN이었다.
### NAS 보안 이미지 최종 반영
- 첫 전체 SSH 빌드는 30분 실행 제한으로 중단됐고, 이어서 `-BuildOnly -Services web`으로 Web만 재빌드했다. Admin은 이미 완료된 이미지를 재사용했다.
- 운영 Web 이미지·실행 컨테이너: `sha256:f36c466137ff5b34fc320d3194dfae58f361ba91527e82934154e1761c3906d3`; Admin: `sha256:1a98f25dc9662aef804fa75076bc0c0dbaeae67e8ab335d407a646d77836ca58`. 둘 다 Next.js 16.4.6 빌드다.
- 롤백 태그는 Web/Admin 모두 `rollback-20261118-044054`다. NAS 기존 `.env`와 API 컨테이너는 유지했다.
- 컨테이너 시작 직후 Web localhost의 첫 curl은 connection reset이었지만, 이후 NAS Web/Admin localhost와 공개 `/app/login`, admin `/login`, `/health`가 모두 HTTP 200이다. 롤백 없이 현재 이미지를 유지한다.
## 2026-11-20 데스크톱 업데이트 미표시·릴리스 복구
- 설치된 `D3RO Voice.exe`의 ProductVersion은 `1.17.1.0`이다. 실행 중인 앱의 자동 업데이트는 활성이며 19:36의 로그는 원격 정책 `killSwitch=false`, `staging=100%`, `latest version: 1.17.1`을 기록했다. 대화상자 구현이나 요청 실패가 이번 미표시의 원인이 아니다.
- 공개 `latest/latest.yml`은 무인증 HTTP 200으로 `version: 1.17.1`을 반환한다. 로컬 소스는 `1.18.1`(`bed83f7`)이지만 canonical remote에 해당 태그가 없고 공개 피드에도 게시되지 않았다.
- 미게시 `1.18.1` 설치본은 `120,821,996 bytes`(115.2 MiB), `.blockmap`과 `latest.yml`이 생성된 후 `build-desktop-installer.mjs`의 100 MiB 제한에서 중단됐다. `release-artifacts.json` 체크포인트가 없으므로 임의로 재빌드·재게시하지 않고 원본 산출물을 보존한다.
- `apps/desktop/electron-builder.yml`의 최대 압축, 번들된 renderer 전용 의존성 및 미사용 SQLite 소스 제외를 정식 `1.18.2` 빌드로 검증한다. 앱을 종료하거나 개인 설정·DB를 바꾸지 않고 공개 피드와 기존 설치본의 제안을 확인한다.
- `1.18.2`도 동일한 패키징에서 `120,821,907 bytes`라 업로드 전 크기 게이트가 중단했다. `release:metadata`, `version:check`, 전 workspace typecheck와 네이티브 DB 열기·질의는 GREEN이었고, 태그만 로컬에 있고 원격 push·upload는 실행되지 않았다.
- 차분 친화적 archive는 빌더가 compression을 normal로 재설정하므로 `compression: maximum`만으로는 줄지 않았다. 분리된 `differentialPackage=false` 시험 설치본은 `108,504,875 bytes`였고 `.blockmap`을 만들지 않았다. 이것만으로는 부족해 게시하지 않았다.
- `1.18.3`은 Windows full-only(`nsis.differentialPackage=false`, `fullInstallVersionGap=0`)로 전환하고 Windows에서 사용하지 않는 nut-js, 다른 플랫폼의 SQLite 바이너리, 번들된 shared packages의 중복 복사본을 제외한다. macOS 패키지는 변경하지 않는다. 기존 차분 모드의 기본 smoke 검사는 유지하면서 full-only의 `.blockmap` 부재를 명시적 계약으로 검사한다.