// src/renderer/components/OnboardingModal.tsx // 첫 실행 온보딩 — 3단계: ① 사용 방식 선택(로컬 Ollama / 온라인 계정) ② 준비(Ollama 연결·모델 또는 로그인) ③ 완료. // v4(2026-09-28): 평면 다이얼로그 + 단계 표시(n/3, 진행 막대) + "나중에 설정" 건너뛰기. // 첫 실행은 Esc·배경 클릭으로 닫히지 않는다(onboarding-dismiss 정책) — 대신 명시적인 건너뛰기 버튼이 있다. import { useState, useEffect, useCallback } from 'react' import { Dialog, DialogTitle, DialogContent, DialogActions, Button, Typography, Box, LinearProgress, TextField, Tab, Tabs, Alert, } from '@mui/material' import { CheckCircle2, Cloud, Download, Play, RefreshCw, ExternalLink, Cpu, Check } from 'lucide-react' import { d3roPalette, d3roRadius, d3roNumeralSx, d3roTransition, typoSx } from '@d3ro/ui/theme' import { Led, TactileBadge } from '@d3ro/ui/components/ds' import { useI18n } from '@d3ro/i18n' import type { TranslationKey } from '@d3ro/i18n' import type { LLMModel, LLMStatus } from '@d3ro/core/types' import { useOllamaModelPull } from '../hooks/useOllamaModelPull' import { canDismissOnboarding } from './onboarding-dismiss' import type { OnboardingPhase } from './onboarding-dismiss' type Phase = OnboardingPhase interface OnboardingModalProps { open: boolean onClose: () => void } /** 첫 실행에서 받는 기본 로컬 모델 */ const DEFAULT_LOCAL_MODEL = 'gemma4:e4b' const AUTH_FORM_ID = 'onboarding-auth-form' const TOTAL_STEPS = 3 const STEP_OF_PHASE: Readonly> = { select_mode: 1, local_ollama_setup: 2, online_auth: 2, failed: 2, success: 3, } const LOCAL_POINTS: readonly TranslationKey[] = [ 'onboarding.mode.local.point1', 'onboarding.mode.local.point2', 'onboarding.mode.local.point3', ] const ONLINE_POINTS: readonly TranslationKey[] = [ 'onboarding.mode.online.point1', 'onboarding.mode.online.point2', 'onboarding.mode.online.point3', ] interface ModeCardProps { icon: React.ReactNode title: string badge?: string description: string points: readonly string[] action: React.ReactNode onSelect: () => void testId: string } /** 사용 방식 카드 — 카드 전체를 눌러도, 안의 버튼(키보드 포커스·Enter)으로도 고를 수 있다. */ function ModeCard({ icon, title, badge, description, points, action, onSelect, testId }: ModeCardProps): React.ReactElement { return ( {icon} {title} {badge && {badge}} {description} {points.map((point) => ( {point} ))} {action} ) } export function OnboardingModal({ open, onClose }: OnboardingModalProps): React.ReactElement { const { t } = useI18n() const [internalOpen, setInternalOpen] = useState(false) const [phase, setPhase] = useState('select_mode') // 이미 온보딩을 마친 사용자면 모달을 언제든 닫을 수 있다(첫 실행만 진행을 강제). const [onboardingCompleted, setOnboardingCompleted] = useState(false) // Local Ollama State const [ollamaStatus, setOllamaStatus] = useState(null) const [installedModels, setInstalledModels] = useState([]) const [activeModel, setActiveModel] = useState(DEFAULT_LOCAL_MODEL) const [checkingOllama, setCheckingOllama] = useState(false) const [startingOllama, setStartingOllama] = useState(false) const [ollamaMsg, setOllamaMsg] = useState(null) // Auth State const [authTab, setAuthTab] = useState<'login' | 'register'>('login') const [email, setEmail] = useState('') const [password, setPassword] = useState('') const [authError, setAuthError] = useState('') const [authLoading, setAuthLoading] = useState(false) // Error State — 'failed' 단계는 현재 진입 경로가 없다(호환용으로 유지) const errorMsg = '' const isVisible = open || internalOpen const checkOllama = useCallback(async () => { setCheckingOllama(true) try { const res = await window.electronAPI.llm.checkConnection() if (res.success && res.data) { setInstalledModels(res.data.models) } const st = await window.electronAPI.llm.getStatus() if (st.success) { setOllamaStatus(st.data) } } finally { setCheckingOllama(false) } }, []) useEffect(() => { window.electronAPI.config.getAll().then((res) => { if (!res.success) return setOnboardingCompleted(res.data.onboardingCompleted) if (!res.data.onboardingCompleted) { setInternalOpen(true) setPhase('select_mode') } }) }, []) // 모델 받기 — 받기에 성공한 경우에만 활성 모델로 저장 (autoSelect) const { pullingModelId: pullingModel, progress: pullProgress, error: pullError, pull, } = useOllamaModelPull({ enabled: isVisible, autoSelect: true, onPulled: checkOllama }) useEffect(() => { if (!isVisible) return const unsubStatus = window.electronAPI.llm.onStatusChanged((e) => { setOllamaStatus(e.status) }) return () => { unsubStatus() } }, [isVisible]) const handleSelectLocalMode = async () => { setPhase('local_ollama_setup') await window.electronAPI.config.set({ key: 'appUsageMode', value: 'local' }) await window.electronAPI.config.set({ key: 'llmBackend', value: 'local' }) await window.electronAPI.config.set({ key: 'sttProvider', value: 'local' }) await checkOllama() // 자동으로 Ollama 기동 시도 await window.electronAPI.llm.startServer() setTimeout(() => checkOllama(), 1500) } const handleStartOllama = async () => { setStartingOllama(true) setOllamaMsg(null) try { const res = await window.electronAPI.llm.startServer() if (res.success) { if (res.data === 'running') { setOllamaMsg(t('ollamaGuide.start.running')) } else if (res.data === 'starting') { setOllamaMsg(t('ollamaGuide.start.starting')) setTimeout(() => checkOllama(), 2000) } else if (res.data === 'not-installed') { setOllamaMsg(t('ollamaGuide.start.notInstalled')) } else { setOllamaMsg(t('ollamaGuide.start.failed')) } } } finally { setStartingOllama(false) } } const handlePullModel = async (modelId: string) => { const outcome = await pull(modelId) if (outcome === 'selected') setActiveModel(modelId) } const handleCompleteLocalSetup = async () => { await window.electronAPI.config.set({ key: 'onboardingCompleted', value: true }) setPhase('success') } const handleAuthSubmit = async (e: React.FormEvent) => { e.preventDefault() setAuthError('') setAuthLoading(true) try { const res = authTab === 'login' ? await window.electronAPI.onlineAuth.login({ email, password }) : await window.electronAPI.onlineAuth.register({ email, password }) if (res.success) { await window.electronAPI.config.set({ key: 'appUsageMode', value: 'online' }) await window.electronAPI.config.set({ key: 'llmBackend', value: 'online' }) await window.electronAPI.config.set({ key: 'onboardingCompleted', value: true }) setPhase('success') } else { setAuthError(res.error?.message ?? t('onboarding.auth.failed')) } } catch (err) { setAuthError(t('onboarding.auth.error', { message: err instanceof Error ? err.message : String(err) })) } finally { setAuthLoading(false) } } const handleClose = () => { setInternalOpen(false) onClose() } // 첫 실행 건너뛰기 — 기본값(로컬 모드)으로 시작하고 다시 묻지 않는다. 설정 › 정보에서 다시 열 수 있다. // Ollama 도 온라인 계정도 없는 사용자가 첫 실행에서 갇히지 않게 하는 출구. const handleSkip = async () => { await window.electronAPI.config.set({ key: 'onboardingCompleted', value: true }) setOnboardingCompleted(true) handleClose() } const dismissible = canDismissOnboarding(phase, onboardingCompleted) const isOllamaConnected = ollamaStatus?.connectionState === 'connected' const hasInstalledLlm = installedModels.length > 0 const step = STEP_OF_PHASE[phase] const stepLabel = t('onboarding.step', { current: step, total: TOTAL_STEPS }) if (!isVisible) return <> const sectionBox = { p: 2, borderRadius: d3roRadius.inner, border: `1px solid ${d3roPalette.border.subtle}`, } as const return ( {}} maxWidth="sm" fullWidth aria-labelledby="onboarding-title" > {t('onboarding.wizard.title')} {/* 단계 표시 — 숫자 + 진행 막대 */} {stepLabel} {/* ── 1. 사용 방식 선택 ── */} {phase === 'select_mode' && ( {t('onboarding.mode.intro')} } title={t('onboarding.mode.local.title')} badge={t('onboarding.mode.local.badge')} description={t('onboarding.mode.local.desc')} points={LOCAL_POINTS.map((key) => t(key))} onSelect={handleSelectLocalMode} testId="onboarding-mode-local" action={ // 첫 포커스 — Enter 로 권장 경로를 바로 시작한다. 클릭은 카드 onClick 으로 전파된다. } /> } title={t('onboarding.mode.online.title')} description={t('onboarding.mode.online.desc')} points={ONLINE_POINTS.map((key) => t(key))} onSelect={() => setPhase('online_auth')} testId="onboarding-mode-online" action={ } /> )} {/* ── 2a. 로컬 Ollama 준비 ── */} {phase === 'local_ollama_setup' && ( {/* 연결 상태 — 실제로 조회한 값만 쓴다 */} {isOllamaConnected ? ollamaStatus?.serverVersion ? t('onboarding.local.connectedVersion', { version: ollamaStatus.serverVersion }) : t('onboarding.local.connected') : t('onboarding.local.disconnected')} {isOllamaConnected ? t('onboarding.local.connectedDetail', { count: installedModels.length, model: activeModel }) : t('onboarding.local.disconnectedDetail')} {!isOllamaConnected && ( )} {ollamaMsg && ( {ollamaMsg} )} {/* Ollama 미설치 시 안내 */} {!isOllamaConnected && ( {t('onboarding.local.installTitle')} {t('onboarding.local.installStep1')} {t('onboarding.local.installStep2')} )} {/* 기본 모델 받기 */} {t('onboarding.local.modelTitle', { model: DEFAULT_LOCAL_MODEL })} {t('onboarding.local.modelDesc')} {pullingModel ? ( {pullProgress.status || t('onboarding.statusPreparing')} {pullProgress.percent}% ) : ( {pullError && ( {pullError.stage === 'pull' ? t('onboarding.failed', { message: pullError.message }) : pullError.message} )} {hasInstalledLlm && ( {t('onboarding.local.modelReady')} )} )} {!isOllamaConnected && ( {t('onboarding.local.finishHint')} )} )} {/* ── 2b. 온라인 계정 로그인 ── */} {phase === 'online_auth' && ( {t('onboarding.auth.intro')} setAuthTab(v)} sx={{ mb: 2, borderBottom: `1px solid ${d3roPalette.border.subtle}` }} > {authError && ( {authError} )} setEmail(e.target.value)} required sx={{ mb: 2 }} /> setPassword(e.target.value)} required /> )} {/* ── 3. 완료 ── */} {phase === 'success' && ( {t('onboarding.done.title')} {t('onboarding.done.desc')} )} {phase === 'failed' && ( {t('onboarding.failedPhase', { message: errorMsg })} )} {/* ── 하단 행동: 왼쪽 = 뒤로·건너뛰기·닫기, 오른쪽 = 이 단계의 주 행동 하나 ── */} {(phase === 'local_ollama_setup' || phase === 'online_auth') && ( )} {phase !== 'success' && !dismissible && ( )} {phase !== 'success' && dismissible && ( )} {phase === 'local_ollama_setup' && ( )} {phase === 'online_auth' && ( )} {phase === 'failed' && ( )} {phase === 'success' && ( )} ) }