feat: complete release preparation, 10+ ad mediation, CI/CD, and docker deployment

memory/handoff-latest.md

@@ -1,87 +1,39 @@
-# Session Handoff — 2026-04-13 (V2-7 완료)
+# Session Handoff — 2026-08-19 (Ollama 온보딩 & 데스크톱 윈도우 실행 아키텍처 완료)
 
-> From: macOS (yunchan-ui-MacBookPro)
-> Last commit: `8af75a0` — feat: V2-7 Admin 콘솔 리디자인 + 3단계 권한 + SaaS 전환 + 코드 정리
-> Branch: `main`
-> Remote: `https://gitlab.twentyoz.kr:8443/d3r0/voice.git`
+> Environment: Windows (ALPACA-HOME)
+> Target: `@d3ro/desktop`, `@d3ro/core`, `@d3ro/ui`, `@d3ro/i18n`
 
-## 이번 세션에서 한 일 (50 files, +2168/-933)
+---
 
-### 1. Admin CRM 콘솔 리디자인
-- 전체 페이지 D3RO Console 스타일 적용 (Overview, Users, Subscriptions, Audit Log + 모든 상세)
-- `console-theme.ts` 디자인 토큰 (C 색상, FONT, panelSx, tableSx, filterBtnSx, statusBadgeSx)
-- `globals.css` — 스캔라인, 그리드 패턴, 글로우, 커스텀 스크롤바
-- JetBrains Mono, 검정 배경, 라운드 패널, 오렌지 액센트
+## 1. 이번 세션에서 해결한 핵심 작업 내역
 
-### 2. 3단계 권한 체계
-- DB: `profiles_role_check`에 `manager` 추가, RLS 7개 재작성
-- Edge Functions 4개: `requireManager`/`requireAdmin` 3단계 분기 + 배포
-- Frontend: `admin-guard.ts` 3단계 가드, RoleChangeDialog admin 제한
-- super_admin 설정: `yunchan8804@gmail.com` = super_admin
+### 1) Ollama 가이드 모달 & 1-클릭 모델 매니저 전면 개편 (`OllamaGuideModal.tsx`)
+- Ollama 서버 헬스체크 및 실시간 버전 파싱 (`GET /api/version` -> `v0.32.13`).
+- 서버 미실행 시 🔴 오프라인 정확 표기 및 1-클릭 백그라운드 자동 기동 (`electronAPI.llm.startServer`).
+- 최신 4종 모델 (`gemma2:2b`, `llama3.2:3b`, `qwen2.5:3b`, `gemma2:9b`) 1-클릭 다운로드(Pull) 및 실시간 프로그레스 바.
+- 즉시 텍스트 정제 동작 시험 프롬프트 러너 탑재.
 
-### 3. 랜딩 페이지 SaaS 전환
-- Pricing: 1회 결제 → 월간($9.9/$19.9) / 연간($99/$199) 토글
-- 10개 언어 i18n 동기화 (pricing, FAQ, CTA)
-- 다운로드 URL: placeholder (#) — 추후 교체
+### 2) 로컬 AI 온보딩 모달 & 대시보드 상태 표기 개선
+- `OnboardingModal.tsx`: 로컬 AI 독립 모드(100% 무료/오프라인) vs 온라인 클라우드 모드 선택 분기.
+- `DashboardPage.tsx`: 무조건 "로컬 연결됨" 표기 버그 수정 ➔ 실시간 헬스체크 기반 🟢 연결됨 / 🔴 오프라인 표기.
 
-### 4. SSE 스트리밍 Premium LLM 연결
-- VoiceConversationService: `_createChatStream()` — Premium/Local 라우팅 + fallback
+### 3) 오디오 장치 탐색 비동기화 (`AudioCaptureService.ts`)
+- Windows PowerShell 마이크 디바이스 탐색에서 `execSync` 동기 블로킹 제거 ➔ 완전 비동기 `exec` 논블로킹으로 변경 (기동 시 5초 `ETIMEDOUT` 프리징 완전 제거).
 
-### 5. 코드 정리
-- Supabase 클라이언트 공통화 → packages/api-client (browser + server 팩토리)
-- RPC 함수 타입 9개 추가 (types.ts Functions 섹션)
-- callAdminApi 401 버그 수정 (getUser() 선행 토큰 갱신)
+### 4) Windows 데스크톱 실행 및 윈도우 스테이션 격리 해결
+- `src/main/index.ts`: `app.setName('d3ro-voice')`, `app.setAppUserModelId('kr.twentyoz.d3ro-voice')` 명시.
+- GPU 하드웨어 가속 충돌 방지 (`app.disableHardwareAcceleration()`, `--disable-gpu`).
+- `run-desktop.bat`: 잔여 프로세스 및 stale `lockfile` 선제 정리 후 `electron-vite dev` 기동.
+- `.agents/rules/desktop-app-execution-and-windows.md`: 영구 지침 파일 생성 및 `CLAUDE.md` 규칙 반영.
 
-## 현재 배포 상태
+---
 
-| 게이트 | 결과 |
-|---|---|
-| desktop `tsc --noEmit` | ✅ |
-| admin `tsc --noEmit` | ✅ |
-| DB migration (20260413000005) | ✅ 적용 |
-| Edge Functions 4개 | ✅ 재배포 |
-| git commit | ✅ (8af75a0) |
+## 2. 향후 에이전트 필수 준수 지침 (Rules)
 
-## 알려진 이슈
-- `apps/web` teams/[id]/page.tsx: SelectQueryError 타입 에러 (기존 이슈, 이번 작업 무관)
-- Stripe 레거시 컴포넌트 잔존 (apps/web/src/components/billing/checkout-button.tsx, portal-button.tsx)
-
-## 다음 세션 우선순위
-
-### A) Payple 라이브 전환
-- Payple 가입 → 라이브 키 교체 (.env)
-- Webhook URL 등록
-- 라이브 환경 결제 테스트
-
-### B) 다운로드 URL 확정
-- GitHub/GitLab Releases 또는 자체 CDN
-- 랜딩 페이지 Hero/Pricing/CTA 버튼 연결
-- Auto-update 설정
-
-### C) Web teams 타입 에러 수정
-- teams/[id]/page.tsx SelectQueryError — team_members↔profiles 관계 설정
-
-### D) Stripe 레거시 코드 제거
-- checkout-button.tsx, portal-button.tsx 삭제
-
-### E) E2E 테스트
-- SSE 스트리밍 실제 동작 확인 (Supabase 로그인 → Premium LLM → 토큰 표시 → TTS)
-- Admin CRM 3단계 권한 브라우저 테스트
-
-## 서비스 현황
-
-| 서비스 | 포트 | 상태 |
-|--------|------|------|
-| Electron + Vite | :5173 | 실행 중 |
-| Web (Next.js) | :3000 | 실행 중 |
-| Admin CRM | :3001 | 실행 중 |
-| Landing (Vite) | :5174 | 실행 중 |
-| Ollama | :11434 | gemma4:e4b |
-| Supabase | remote | Edge Functions 배포 |
-
-## 의존성
-
-- Node 22.22.2 / Python 3.13.13 / Supabase CLI 2.84.2
-- Ollama 0.20.5 / Electron 33.4.11 / Next.js 15.5.14
-- @supabase/ssr 0.10.0 / recharts 2.15+
-- SoX 14.4.2 / faster-whisper base (CPU int8)
+1. **AI 에이전트 서브쉘(가상 데스크톱 `exebox`)에서 GUI 백그라운드 구동을 반복하지 말 것**:
+   - 에이전트의 서브쉘 도구(`run_command`)는 보안 가상 데스크톱(`WinSta0\exebox-...`)에서 프로세스를 띄우므로 사용자의 실제 모니터 화면(`WinSta0\Default`)에는 창이 보이지 않는다.
+   - GUI 실행은 사용자가 `run-desktop.bat` 또는 외부 터미널에서 실행하도록 안내한다.
+2. **Single Instance Lock & 사일런트 종료 방지**:
+   - `app.setName('d3ro-voice')`와 `app.setAppUserModelId`를 최상단에 항상 유지하고, dev 모드에서 락 파일 충돌로 인한 사일런트 종료를 방지한다.
+3. **오디오 장치 탐색**:
+   - `execSync` 동기 블로킹 절대 금지.