chore: 빅뱅 사이클 wrap-up — 핸드오프 + 상세 다음 세션 프롬프트

이번 세션에서 한 일:
- Mac 부트스트랩 + Supabase llnocwyqvhgwpdjcqqyw 배포
- V2-6차 고도화 [W][A~D] (웹 테마/Mermaid/오디오/Dashboard 차트)
- V2-6차 데스크톱 안정화 [E~L] (Mac 단축키, sidecar venv, beep, paste, qwen3 등)
- SaaS [1] 빌드 타임 Supabase env 주입 (electron.vite + ConfigService)
- SaaS [2] OAuth 첫 실행 강제 게이트 (LoginScreen + AuthGate + saasMode)

다음 세션 (빅뱅 사이클):
- memory/big-bang-prompt.md: 사용자가 다음 세션에 그대로 붙여넣을 상세 프롬프트
- Phase 1: 사용자별 SQLite 격리 (필수)
- Phase 2: 회원가입/온보딩 흐름 (profiles.onboarded_at)
- Phase 3: cloud-first 정책 (write queue + Supabase source of truth)
- Phase 4: 티어 enforcement (free quota)
- Phase 5: 데스크톱/웹/모바일 데이터 일원화 검증
- Phase 6: wrap-up

핸드오프:
- 이전 handoff-latest.md를 archive/2026-04-10-2300-windows-to-mac.md로 이동
- 새 handoff-latest.md: 이번 세션 결과 + 다음 세션 시작 명령
- project_status.md: SaaS 데스크톱 클라이언트 1차 섹션 추가

memory/handoff-latest.md

@@ -1,173 +1,136 @@
-# Session Handoff — 2026-04-10
+# Session Handoff — 2026-04-11 09:40 (Mac, Big Bang 사이클 직전)
 
-> From: Windows 11 Pro (Yun Chan PC)
-> Last commit: b386733 — "feat(V2-5차): pgvector 시맨틱 검색 + chat 스트리밍 + doc 편집 + VoiceAction + Realtime + storage + 메모"
-> Branch: main
-> Remote: https://gitlab.twentyoz.kr:8443/d3r0/voice.git
-> 총 push 대기: 20 commits (이전 origin/main 대비)
+> From: macOS (yunchan-ui-MacBookPro)
+> Last commit: `dd1c305` — feat(desktop): SaaS [1+2] 빌드 타임 env + OAuth 강제 로그인 게이트
+> Branch: `main`
+> Remote: `https://gitlab.twentyoz.kr:8443/d3r0/voice.git`
 
-## ✅ 이번 세션에서 한 일 (1M 세션 5 사이클)
+## ✅ 이번 세션에서 한 일 (1M 컨텍스트, 데스크톱 Mac 안정화 + SaaS 1차)
 
-### 1차 사이클: V2-1 ~ V2-8 전체 1차 구현
-- V2-1a/b/c/d — Monorepo 전환 (npm workspaces + Turborepo 설정, packages/core/ui/i18n 추출)
-- V2-2 — Supabase 인프라 (12 테이블 + RLS + triggers + storage + 4 Edge Functions)
-- V2-3 — Web App MVP (Next.js 15, 11 라우트)
-- V2-4 — Desktop ↔ Supabase 동기화 (CloudSyncService, OAuth deep link, push only)
-- V2-5 — macOS 빌드 (paths.ts 플랫폼 분기, electron-builder mac, entitlements, CI workflow)
-- V2-6 — Mobile MVP (Expo, workspace 제외)
-- V2-7 — 팀 기능 (web /teams)
-- V2-8 — 결제 (Stripe Edge Functions + /billing)
+### 환경
+- Mac 부트스트랩: Node 22 (brew), sox 14, supabase CLI 2.84
+- `npm install --force` (rollup win32 옵셔널 dep 충돌 우회)
+- `@electron/rebuild@3 --version=33.4.11` 완료
+- Sanity build: desktop/web typecheck, web `next build`, api-client vitest 19 passed
 
-### 2차 사이클: 고도화 A~D
-- Settings CloudSyncSection 통합
-- Web Sidebar 공유 layout (app/(app)/)
-- 11개 locale 번역
-- V2-4b pull 동기화 (history/dictionary)
-- V2-8b Stripe webhook HMAC-SHA256 검증 + Customer Portal
-- packages/ui-native (RN DS 컴포넌트)
+### Supabase 배포
+- 프로젝트: `yunchan8804-blip's Project` (`llnocwyqvhgwpdjcqqyw`)
+- `supabase link` + `db push` (8개 마이그레이션)
+- `supabase functions deploy` (10개 Edge Functions)
+- `apps/web/.env.local` + `server/supabase/.env.local` 작성
 
-### 3차 사이클: E~J
-- V2-4b pull 확장 (meetings/memos/documents)
-- api-client types interface→type 전환
-- apps/mobile을 @d3ro/ui-native로 실제 교체
-- V2-7b 이메일 invite flow (team_invites 테이블 + team-invite/accept Edge Functions + /accept-invite)
-- Realtime transcripts 구독 (LiveTranscriptList)
-- api-client 유닛 테스트 19 passed + web E2E 스캐폴딩
+### V2-6차 [W][A~D] — 웹 고도화
+- W. fix: AppRouterCacheProvider Emotion key `'d3ro-mui'` → `'mui'` (숫자 3 → SSR 500)
+- A. Dark/Light/Theme 토글 (`theme-mode-context.tsx`, 12개 locale `theme.*`)
+- B. DocumentEditor Mermaid + Markdown 렌더 (`markdown-preview.tsx`)
+- C. 회의 오디오 재생 (`meeting-audio-player.tsx`, Storage signed URL 1h)
+- D. Dashboard 14일 추이 차트 (recharts)
 
-### 4차 사이클: K~P
-- @supabase/ssr 0.10 + supabase-js 2.103 bump → **Database 제네릭 완전 주입**
-- /chat 페이지 (ChatPanel + llm-proxy 호출)
-- /knowledge 페이지 (knowledge_documents/chunks + tsvector + AddKnowledgeForm)
-- team-invite Resend 이메일 발송
-- Expo Push notification (push_tokens + send-push + expo-notifications)
-- meetings/[id] AI 문서 생성 (GenerateDocumentButton 4종 템플릿)
+### V2-6차 [E~L] — 데스크톱 Mac 안정화
+- E. macOS 단축키 표기 ⌘⇧⌃⌥ (`format-hotkey.ts` + 호출 위치 4개)
+- F. Sidecar `apps/desktop/sidecar/.venv/` 생성 + paths.ts venv 우선
+- G. HotkeyRecordModal 칩 'WIN' → ⌘ 표기 (getKeyName 플랫폼 분기)
+- H. `bootstrap.ts` `hideRecordingTip` import 누락 → ReferenceError 픽스
+- I. macOS 시스템 beep 차단 — Electron `globalShortcut` 통합 (HotkeyService)
+- J. Sidecar 동적 포트 (`_findFreePort`, orphan EADDRINUSE 회피)
+- K. macOS Cmd+V paste — `TextInsertService` `LeftSuper`/`LeftControl` 분기
+- L. qwen3 reasoning 39초 — `/no_think` 토큰 + `stripReasoningBlocks` + 빈 응답 fallback
 
-### 5차 사이클: Q~V
-- **pgvector** 활성화 + embedding(1536) + match_knowledge_chunks RPC + embed-chunks/search-knowledge Edge Functions + /knowledge 검색 UI
-- **/chat SSE 스트리밍** — llm-proxy가 Anthropic 스트림 프록시, chat-panel progressive 렌더
-- **DocumentEditor** — MUI Dialog 기반 마크다운 편집/삭제
-- **/actions** (VoiceAction 이식) — 자연어 → JSON 파싱 → 실행
-- **Desktop CloudSync Realtime** — meetings/history/dictionary 변경 구독 + 자동 pullAll
-- **Record → Storage 업로드** + 자동 meetings INSERT
-- **MemoForm** — 회의 상세에서 메모 작성
-- **11개 locale** nav.chat/knowledge/actions 키
+### SaaS [1+2] — 데스크톱 fat client → 진짜 SaaS 클라이언트 변환
+- [1] **빌드 타임 Supabase env 주입**
+  - `electron.vite.config.ts`: `loadEnv('D3RO_')` + main `define`
+  - `apps/desktop/.env.local`: `D3RO_SUPABASE_URL/ANON_KEY`
+  - `ConfigService`: `BUILD_TIME_*` 상수, `configGet/Set`이 빌드 타임 우선 + 변경 차단
+- [2] **OAuth 첫 실행 강제 게이트**
+  - `CloudSyncState.saasMode: boolean` 추가
+  - `LoginScreen.tsx` 신규 (Google/GitHub만)
+  - `App.tsx` `AuthGate` 상태머신
+  - `CloudSyncSection` saasMode일 때 URL/Key 입력 필드 숨김
 
-## 🚧 미완 / 남은 것
+### 미완 / 확실히 알려진 이슈
+- Ollama `qwen3:4b`가 4B reasoning 모델이라 CPU에서 느림 → 사용자가 더 빠른 모델로 교체 권장 (`gemma3:1b` 또는 `qwen2.5:3b`)
+- Accessibility 권한 첫 실행 시 macOS 권한 다이얼로그가 떠야 함 (안 뜨면 시스템 설정 → 손쉬운 사용에 Electron 추가)
+- 데스크톱 SQLite는 여전히 단일 파일 (`userData/d3ro-voice/d3ro.db`) — 한 PC에 여러 사용자가 OAuth 로그인 시 데이터 섞일 위험 ← **빅뱅 핵심 작업**
 
-### 사용자 액션 필요 (환경 작업)
-1. **Supabase 프로젝트 생성 + `db push`** — `docs/v2/phase-V2-2-setup.md`
-2. **Google/GitHub OAuth Provider** 등록
-3. **Google Cloud STT API 키** + **Anthropic API 키** + **OpenAI API 키** (임베딩용)
-4. **Stripe** 계정 + Price ID + Webhook secret
-5. **Resend** API 키 (초대 이메일)
-6. Mac에서 `npm run dev` 검증 — `docs/v2/phase-V2-5-mac-guide.md`
+## 🚧 다음 세션: 빅뱅 사이클 (Desktop SaaS Client 완성)
 
-### 코드 레벨 후보 (6차 사이클)
-1. E2E 실제 실행 (Playwright browsers install)
-2. Mermaid 렌더 (DocumentEditor에 마크다운 미리보기)
-3. 회의 오디오 재생 (audio_storage_key → signed URL + 플레이어)
-4. Dashboard 위젯 차트 (회의 시간/문서 수 추이)
-5. Knowledge 파일 업로드 (PDF/docx 파싱)
-6. Voice Input (/actions에 마이크 아이콘)
-7. 다크모드 토글 (현재 다크 고정)
-8. 팀 대시보드 + 알림 센터
+자세한 단계별 계획은 아래 "다음 세션 시작 프롬프트" 참조.
 
-## 🔑 Mac에서 이어받을 때 즉시 확인할 것
+요약 목표:
+1. **사용자별 SQLite 격리** — `userData/users/${userId}/d3ro.db`
+2. **회원가입/온보딩 흐름** — OAuth 첫 가입 시 환영 + 마이그레이션
+3. **cloud-first 정책** — Supabase source of truth, local read-through cache
+4. **멀티 디바이스 sync 강화**
+5. **티어 enforcement** — 데스크톱에서도 free quota 차단
+6. **데스크톱 ↔ 웹 ↔ 모바일 데이터 일원화 검증**
+
+## 🔑 다음 세션 시작 시 즉시 할 일
 
 ```bash
-# 1. Git pull
-git clone https://gitlab.twentyoz.kr:8443/d3r0/voice.git  # 또는 git pull
-cd voice
-git log --oneline -5  # b386733 까지 있는지
+# 1. git pull
+git pull origin main   # 마지막 커밋 dd1c305 또는 그 이후 확인
 
-# 2. 시스템 의존성
-brew install sox node@22 python@3.11
-# Ollama 선택 (로컬 LLM)
-brew install ollama && ollama pull qwen3:4b
+# 2. 환경 검증 (이미 mac에 다 있음)
+node --version          # v22.x
+which sox supabase      # /opt/homebrew/bin/...
+ls apps/desktop/sidecar/.venv/bin/python3   # exists
+ls apps/desktop/.env.local                  # gitignored, exists
 
-# 3. npm workspace 설치
-npm install
+# 3. 워크스페이스 재설치 필요 시
+npm install --force
 
-# 4. native 모듈 재빌드
-npx @electron/rebuild@3 --version=33.4.11
-
-# 5. 검증
-cd apps/desktop && npx tsc --noEmit  # desktop
-cd ../web && npx tsc --noEmit && npm run build  # web
-cd ../.. && npx vitest run --root packages/api-client  # tests
-
-# 6. dev 실행
-npm run dev  # Electron 앱 뜸
-# 별도 터미널: cd apps/web && npm run dev  # Next.js 앱 http://localhost:3000
-
-# 7. mobile (선택)
-cd apps/mobile && npm install  # workspace 제외라 별도
-npm start  # Expo dev
+# 4. 데스크톱 dev 띄워서 LoginScreen 보이는지 확인
+npm run dev
+# → 첫 화면이 LoginScreen이어야 함 (Google/GitHub 버튼)
 ```
 
-## ⚠️ 환경 차이 주의
+## ⚠ 환경 / 주의사항
 
-- **Windows 전용 코드 없음** — V2-5에서 플랫폼 감사 완료
-- Mac: **Accessibility/마이크/Apple Events 권한** 첫 실행 시 다이얼로그
-- `resources/sox/`는 gitignored — `bash scripts/install-sox.sh`로 Homebrew sox 번들 (dist 빌드 시)
-- `resources/icons/`에 실제 아이콘 파일 없음 — `docs/v2/phase-V2-5-mac-guide.md` §5 참고
-- Mac에서 `npm run dist` 하려면 아이콘 + sidecar 빌드 필요 (`python scripts/build-sidecar.py`)
-- `apps/mobile/`은 workspace 제외 — 별도 `cd apps/mobile && npm install`
+- **gitlab 푸시는 사용자 명시 후에만**: 이번 세션에선 push 안 했음. 다음 세션에서 빅뱅 작업 끝나면 사용자 확인 후 `git push origin main`
+- **Ollama 모델**: `qwen3:4b` 설치됨, 느리면 `ollama pull gemma3:1b` 권장
+- **Accessibility 권한**: 데스크톱 핫키 동작에 필수 — macOS 시스템 설정에서 수동 허용
+- **Supabase 외부 키**: ANTHROPIC/OPENAI/RESEND/STRIPE는 아직 안 주입됨 → web의 `/chat`, `/knowledge`, `/billing`은 키 채워지기 전엔 동작 안 함 (사용자가 키 줄 때 `supabase secrets set`)
+- **데스크톱 .env.local**: gitignored, 이번 세션에서 작성. 만약 다음 세션이 다른 PC에서 시작하면 `apps/desktop/env.example`을 보고 직접 작성 필요
+- **DB 마이그레이션**: 빅뱅 [1] 사용자별 SQLite 격리 시 기존 단일 DB의 데이터를 첫 로그인 사용자에게 귀속시키는 마이그레이션 필요. 데이터 손실 주의
 
-## 📦 의존성 버전
-
-| 패키지 | 버전 |
-|---|---|
-| Node.js | 22.12.0 |
-| @supabase/supabase-js | 2.103.0 |
-| @supabase/ssr | 0.10.2 |
-| Next.js | 15.5.14 |
-| Expo SDK | ~51 |
-| Electron | 33.4.11 |
-| React | 19 |
-| MUI | 7 |
-| TypeScript | 5.7+ |
-
-## 🧪 마지막 검증 상태
+## 📦 의존성 / 도구
+- Node 22.22.2 (brew)
+- Python 3.13 (Framework) + venv at `apps/desktop/sidecar/.venv`
+- Supabase CLI 2.84.2
+- Ollama (사용자가 별도 설치, qwen3:4b 모델)
+- @electron/rebuild@3 33.4.11
+- Electron 33.4.11
 
+## 🧪 마지막 검증
 | 게이트 | 상태 |
 |---|---|
-| desktop typecheck | ✅ |
-| desktop build | ✅ |
-| web typecheck | ✅ |
-| web build | ✅ (15 라우트) |
-| api-client test | ✅ (19 passed) |
-| mobile | workspace 제외 (별도 install 필요) |
+| desktop tsc | ✅ |
+| desktop build (electron-vite) | ✅ |
+| desktop dev (실제 실행) | ✅ Main window shown |
+| Hotkey ⌘⇧1 + globalShortcut | ✅ accelerator=Shift+Cmd+1 등록 |
+| Sidecar venv spawn | ✅ 한국어 96% 1.5초 오디오 → 426ms 전사 |
+| Cmd+V paste | ✅ (사용자 확인 "되긴한다") |
+| LLM refine | ⚠ qwen3:4b reasoning 끄기 후 첫 시도 미확인 — 사용자 검증 필요 |
+| LoginScreen | ⚠ 이번 세션 마지막에 빌드만, 사용자 시각 확인 미수행 |
 
-## 📊 누적 통계
+## 📊 누적 통계 (이번 세션 포함)
+- 신규 커밋: 13개 (V2-6차 [A~L] + SaaS [1+2])
+- 신규 파일:
+  - apps/web: theme-mode-context, markdown-preview, meeting-audio-player, meetings-trend-chart
+  - apps/desktop: format-hotkey, LoginScreen, sidecar/.venv, .env.local, env.example
+- 수정: ConfigService(빌드 타임), CloudSyncService(saasMode), CloudSyncSection, App.tsx, HotkeyService(globalShortcut), LocalSTTService(_findFreePort), LocalLLMService(/no_think + stripReasoning), TextInsertService(Cmd+V), bootstrap(hideRecordingTip), ...
 
-- 총 커밋: 20개 (V2 시작 이후)
-- Edge Functions: 12개
-- SQL 마이그레이션: 8개
-- 웹 라우트: 15개
-- 모바일 화면: 5개
-- 패키지: 6개 (core/ui/ui-native/i18n/api-client + 앱)
-- 테스트: 19 passed
-- 코드 추가: ~15,000줄+
+## 🔗 참고
+- `memory/project_status.md` — 전체 현황 + V2-6차 [A~L] + SaaS [1+2]
+- `docs/v2/00-v2-master-plan.md` — V2 마스터 플랜
+- `docs/v2/phase-V2-4.md` — 데스크톱 동기화 설계
+- `apps/desktop/.env.local` — 빌드 타임 Supabase env (gitignored)
+- `apps/desktop/env.example` — 템플릿
+- `memory/handoff-archive/2026-04-10-2300-windows-to-mac.md` — 이전 핸드오프
 
-## 🔗 참고 문서
+---
 
-| 파일 | 내용 |
-|---|---|
-| `memory/project_status.md` | 프로젝트 전체 현황 (SSOT) |
-| `docs/v2/00-v2-master-plan.md` | V2 마스터 플랜 + 로드맵 |
-| `docs/v2/phase-V2-5-mac-guide.md` | Mac 환경 전체 가이드 |
-| `docs/v2/phase-V2-2-setup.md` | Supabase 배포 가이드 |
-| `docs/v2/phase-V2-2.md` | Supabase 상세 설계 |
-| `docs/v2/phase-V2-3.md` | Web App 설계 |
-| `docs/v2/phase-V2-4.md` | 데스크톱 동기화 설계 |
-| `.claude/skills/session-handoff/` | 이 핸드오프 스킬 |
-| `.claude/skills/implement-phase/` | 구현 스킬 |
+# 🎯 다음 세션 시작 프롬프트 (사용자가 그대로 복사해서 붙여넣기)
 
-## 🏁 Mac에서 재개 시 첫 명령
-
-```
-/session-handoff resume
-```
-
-이 skill이 `memory/handoff-latest.md` → `project_status.md` → `CLAUDE.md`를 순서대로 읽고, 환경 검증 후 다음 작업을 제안합니다.
+다음 세션에서 그대로 붙여넣을 프롬프트는 별도 파일에:
+**`memory/big-bang-prompt.md`**