@realtimex/email-automator 2.22.1 → 2.22.2

package/docs/ja/user-guide/GLOSSARY.md

@@ -0,0 +1,160 @@
+# 用語集
+
+Email Automator およびセットアップウィザードで使用される一般的な用語の定義。
+
+## Supabase
+ホストされた Postgres データベース、認証、ストレージ、および API を提供するバックエンドプラットフォーム。Email Automator は、Supabase をデータベースおよび認証レイヤーとして使用します。
+
+## BYOK (Bring Your Own Key)
+共有バックエンドを使用する代わりに、独自の Supabase プロジェクトを接続するセットアップモデル。これにより、データはあなた自身のインフラストラクチャ内に保持されます。
+
+## Supabase プロジェクト ID
+Supabase プロジェクトの一意の識別子（多くの場合、プロジェクト URL または設定に表示されます）。
+
+## Supabase プロジェクト URL
+アプリがデータベースや API に接続するために使用する、Supabase プロジェクトのベース URL。
+
+## Anon キー (公開 API キー)
+Supabase プロジェクトの公開 API キー。クライアント側での使用は安全ですが、行レベルセキュリティ (RLS) の対象となります。
+
+## アクセストークン
+セットアップウィザードがあなたに代わってプロジェクトを作成または管理できるようにする、Supabase アカウントからのトークン（クイックスタートで使用）。
+
+## マネージド・プロビジョニング (クイックスタート)
+セットアップウィザードがアクセストークンを使用して、Supabase プロジェクトの作成、マイグレーションの適用、Edge Functions のデプロイ、およびナレッジベースの取り込みを自動的に行います。
+
+## 手動同期 (既存のプロジェクトに接続)
+プロジェクト URL と Anon キーを提供して、既存の Supabase プロジェクトに接続します。アクセストークンが提供されている場合は、ウィザードでマイグレーションを実行できます。
+
+## マネージド・プロビジョニング vs 手動同期
+**マネージド・プロビジョニング**は、アクセストークンを使用して新しい Supabase プロジェクトを作成します。
+**手動同期**は、プロジェクト URL と Anon キーを使用して既存の Supabase プロジェクトに接続します。
+
+## マイグレーション
+テーブル、ビュー、関数、およびポリシーを作成または更新するデータベースの変更。マイグレーションにより、データベーススキーマがアプリと整合した状態に保たれます。
+
+## スキーマ
+テーブル、列、タイプ、インデックス、関数、およびポリシーなど、データベースの構造。
+
+## SQL
+データベースの構造やデータを定義およびクエリするために使用される言語。
+
+## バージョンの不一致 (Version Mismatch)
+アプリが期待するスキーマバージョンと、データベースの実際のバージョンが異なる状態。セットアップウィザードまたはマイグレーションツールから正規化を求められます。
+
+## データベースバージョン (アカウント設定)
+アカウント設定に表示されるデータベースのメジャーバージョン。マイグレーションのガイドに使用され、Supabase プロジェクトの Postgres バージョンと一致する必要があります。
+
+## ロールバック
+マイグレーションを元に戻すこと。Supabase ではロールバックは手動であり、慎重に使用する必要があります。
+
+## RLS (行レベルセキュリティ)
+ユーザーが読み書きできる行を制限する Postgres のセキュリティ機能。Supabase は RLS を使用してデータを保護します。
+
+## Edge Functions
+Supabase によってホストされるサーバーレス関数。Email Automator は、OAuth フローや安全な操作のためにこれらを使用します。
+
+## サービスロールキー (Service Role Key)
+RLS をバイパスする強力な Supabase キー。クライアントに公開してはいけません。
+
+## Anon キー vs サービスロールキー
+**Anon キー**はクライアントでの使用に安全で、RLS を尊重します。**サービスロールキー**は RLS をバイパスし、信頼できるサーバー上でのみ使用する必要があります。
+
+## RealTimeX Desktop
+Email Automator が使用する AI サービス (LLM、埋め込み、TTS) を提供するローカルアプリ。
+
+## デジタルペルソナ
+AI が生成するドラフトや返信のトーン、スタイル、好みを定義するプロファイル。
+
+## ペルソナのトーン
+返信の感情的な特徴（例：フレンドリー、フォーマル、直接的）。
+
+## ペルソナのスタイル
+文章スタイルの好み（例：簡潔、詳細、箇条書き）。
+
+## ペルソナのボイス
+言い回しやリズムを含む、あなたの文章全体の「響き」。
+
+## ペルソナの署名
+返信で使用される標準化された結びの言葉（名前、役職、会社名）。
+
+## ペルソナの役割
+返信の枠組みを形作るために使用される、あなたの役職や役割。
+
+## ペルソナの会社
+適切な場合に返信で使用される組織名。
+
+## ペルソナの言語
+生成されるドラフトの主要言語。
+
+## Express API
+メールの同期、 AI 処理、および自動化の実行を処理するローカルバックエンド。
+
+## Realtime (Supabase)
+データベースからアプリへのライブアップデート。リフレッシュすることなく、新しいメール、同期ステータス、またはアクティビティを反映するために使用されます。
+
+## LLM (大規模言語モデル)
+分析や回答の生成（例：カテゴリ分け、返信のドラフト作成）に使用される AI モデル。
+
+## 埋め込みモデル
+テキストを意味検索用のベクトルに変換するモデル。ナレッジベースと RAG で使用されます。
+
+## 埋め込み (Embeddings)
+ナレッジベースでの意味検索に使用されるテキストのベクトル表現。
+
+## RAG (検索拡張生成)
+関連するドキュメントを検索して AI に提供することで、回答がドキュメントに基づいた内容になるようにする手法。
+
+## ナレッジベースの取り込み
+ドキュメントを検索可能な埋め込みに変換し、データベースに保存するプロセス。
+
+## TTS (テキスト読み上げ)
+AI の回答を音声に変換します。
+
+## TTS プロバイダー vs 音声
+プロバイダーは音声を生成するサービスであり、音声はそのプロバイダー内の特定のスピーカー/ペルソナです。
+
+## OAuth
+パスワードを保存せずに、アプリがあなたのメールアカウントにアクセスできるようにする認可標準。
+
+## OAuth 同意画面
+Email Automator にメールアカウントへのアクセス許可を与える画面。
+
+## アクセストークン (OAuth)
+メールプロバイダーの API を呼び出すために使用される短期間のトークン。期限が切れると自動的にリフレッシュされます。
+
+## リフレッシュトークン
+再認証することなく新しいアクセストークンを取得するために使用される長期間のトークン。
+
+## Gmail API
+Gmail のデータにアクセスし、メールを送信するための Google の公式 API。
+
+## Microsoft Graph
+Outlook および Microsoft 365 のデータ（メール、カレンダー、連絡先）にアクセスするための Microsoft の API。
+
+## IMAP / SMTP
+メールプロトコル。IMAP はメールを読み取り、SMTP はメールを送信します（Email Automator は生の IMAP/SMTP ではなく、プロバイダーの API を使用します）。
+
+## アプリの登録 (Microsoft)
+Microsoft Graph へのアクセスのための認証情報を提供する Azure 内のアプリ構成。
+
+## クライアント ID
+OAuth アプリ（Google/Microsoft）の公開識別子。
+
+## クライアントシークレット
+OAuth アプリのプライベートな秘密鍵。パスワードのように扱ってください。
+
+## リダイレクト URI
+OAuth 認可後にメールプロバイダーがユーザーをリダイレクトするコールバック URL。
+
+## デバイスコードフロー
+ブラウザで短縮コードを使用して認証する OAuth フロー。デスクトップアプリでよく使用されます。
+
+## テナント ID
+Microsoft のテナント識別子。マルチテナントの場合は「common」を、組織限定アクセスの場合は特定のテナント ID を使用します。
+
+## 同期範囲
+同期する履歴の量（例：過去 X 日分）や、含まれるアカウントを定義します。
+
+## ラベル (Gmail) / フォルダ (Outlook)
+メールプロバイダーにおける整理の仕組み。ラベルはメッセージにタグを付け、フォルダはメッセージをコンテナに整理します。

package/docs/ja/user-guide/TROUBLESHOOTING.md

@@ -0,0 +1,65 @@
+# トラブルシューティングとサポート
+
+問題が発生した場合は、このガイドで最も一般的な落とし穴とその解決策を確認してください。
+
+---
+
+## 📡 同期の不具合
+
+### ダッシュボードにメールが表示されない
+*   **「同期開始日」の確認**: AI はこの日付より*後*に受信したメールのみを処理します。
+*   **チェックポイントのリセット**: 開始日を変更し、古いメールを再スキャンしたい場合は、同期範囲パネルの **Reset Checkpoint** ボタンをクリックしてください。
+*   **バッチ制限**: **最大メール数**設定により、1 回の実行で処理されるメール数が制限されます。大量の未処理メールがある場合、追いつくまでに数回の同期サイクルが必要になることがあります。
+*   **手動トリガー**: ダッシュボードの **Run Sync Now** をクリックして、即座にチェックを強制します。
+
+### 「同期失敗」または「バックエンド未接続」
+*   **ローカルサーバー**: Email Automator アプリケーションが開いていて、実行中であることを確認してください。
+*   **ライブアクティビティフィード**: **Live Activity** ターミナルを開きます。多くの場合、「Network Error」や「401 Unauthorized」などの具体的な技術的エラーメッセージが含まれています。
+
+---
+
+## 🔑 認証と権限
+
+### Google/Gmail: `redirect_uri_mismatch`
+*   **修正方法**: Google Cloud Console のリダイレクト URI が、Email Automator に表示されているものと*正確に*一致している必要があります。
+*   **例**: `https://your-ref.supabase.co/functions/v1/auth-gmail/callback`（末尾のスラッシュやスペースがないことを確認してください）。
+
+### Microsoft/Outlook: ログイン失敗またはタイムアウト
+*   **アプリの登録**: Azure のアプリ登録で「パブリック クライアント フローを許可する」が**はい**に設定されていることを確認してください。
+*   **アカウントの種類**: 登録時に「任意の組織ディレクトリ内のアカウントと、個人の Microsoft アカウント」を選択したことを確認してください。
+
+### Supabase: 「Invalid API Key」
+*   **修正方法**: 必ず **anon (public)** キーを使用してください。**service_role** キーは、セキュリティ上の理由からアプリによって拒否されます。
+
+---
+
+## 🤖 AI と RealTimeX の統合
+
+### AI の反応が遅い、または応答しない
+*   **ローカルモデル**: Ollama や LM Studio を使用している場合は、マシンに十分な RAM があり、GPU に過度な負荷がかかっていないことを確認してください。
+*   **検出**: ドロップダウンにモデルが表示されない場合は、**RealTimeX Desktop** が実行されており、その中で少なくとも 1 つの AI プロバイダーが設定されていることを確認してください。
+
+### 「スマートドラフト」が作成されない
+*   **システムトグル**: オートパイロットタブで **Smart Drafts** が **ON** に設定されていることを確認してください。
+*   **ルールの競合**: メールに一致するルールに、実際に**下書き (Draft)** アクションが含まれているか確認してください。
+*   **セーフティフィルター**: AI は、「ボットループ」を防ぐために、`no-reply` アドレスや特定の自動通知に対する下書き作成を自動的にスキップします。
+
+---
+
+## 🗄️ データベースとマイグレーション
+
+### 「データベースのマイグレーションが必要」バナー
+*   **発生理由**: ローカルアプリが更新され、新機能をサポートするために Supabase データベーススキーマを更新する必要があります。
+*   **修正方法**: バナーの **Update Now** をクリックします。自動更新を実行するには、**Supabase アクセストークン**が必要です。
+
+### ライブターミナルが空であるか「404」を表示する
+*   **Realtime 権限**: 最新のマイグレーションを実行したことを確認してください。`processing_events` テーブルが存在し、正しい RLS（行レベルセキュリティ）ポリシーが有効になっている必要があります。
+
+---
+
+## 🆘 それでも解決しない場合
+
+問題が解決しない場合：
+1.  技術的なスタックトレースを確認するために、アカウント設定の**システムログ (System Logs)** を確認してください。
+2.  詳細なセットアップについては、[開発者ドキュメント](../docs-dev/README.md)を確認してください。
+3.  プロジェクトのリポジトリでチケットを作成するか、ディスカッションを開始してください。

package/docs/ko/README.md

@@ -0,0 +1,23 @@
+# Email Automator 문서
+
+AI 기반 개인 이메일 비서인 **Email Automator** 문서에 오신 것을 환영합니다. 이 도구는 로컬 머신에서 실행되어 데이터의 프라이버시를 보장하는 동시에 AI의 힘을 활용하여 이메일 수신함을 정리하고 우선순위를 지정하며 자동화합니다.
+
+## 📖 사용자 가이드
+
+AI 이메일 에이전트 설정 및 숙달을 위한 종합 가이드입니다.
+
+1.  [**시작하기**](./user-guide/GETTING-STARTED.md) - 사전 요구 사항, 설치 및 설정 마법사.
+2.  [**구성**](./user-guide/CONFIGURATION.md) - Gmail/Outlook 연결 (BYOK) 및 동기화 제한.
+3.  [**대시보드 및 실시간 활동**](./user-guide/DASHBOARD.md) - AI 모니터링, 실시간 터미널 및 AI 추적.
+4.  [**오토파일럿 및 규칙**](./user-guide/AUTOMATION.md) - AI 기반 규칙 생성, 고스트라이팅 및 보존 정책.
+5.  [**계정 및 개인정보 보호**](./user-guide/ACCOUNT.md) - 페르소나 관리, 보안 및 데이터 주권.
+6.  [**문제 해결 및 지원**](./user-guide/TROUBLESHOOTING.md) - 일반적인 문제와 해결 방법.
+7.  [**용어 사전**](./user-guide/GLOSSARY.md) - 일반적인 용어 및 정의.
+
+## 🚀 주요 기능
+
+*   **개인정보 보호 우선**: 이메일이 저희 서버에 절대 닿지 않습니다. 처리는 로컬 또는 귀하의 AI 키를 통해 이루어집니다.
+*   **지능형 분석**: 자동 카테고리 분류, 감정 분석 및 요약.
+*   **"글래스 박스" AI**: 실시간 터미널 및 AI 추적 모달을 통한 완벽한 투명성.
+*   **오토파일럿**: AI 기반 "If This Then That" 규칙을 위한 중앙 집중식 관리.
+*   **다감각 피드백**: 백그라운드 활동을 위한 고품질 오디오 및 햅틱 신호.

package/docs/ko/marketplace/listing.md

@@ -0,0 +1,34 @@
+# RealTimeX Marketplace 목록: Email Automator
+
+## 메타데이터
+- **표시 이름**: Email Automator
+- **짧은 설명**: 편지함 관리 방법을 학습하는 에이전트 기반의 AI 구동 이메일 관리 플랫폼입니다. 클라우드 비용 없이 완전한 개인정보 보호와 함께 "귀하의 편지함을 소유"하세요.
+- **태그**: 생산성, 이메일, 자동화, AI 에이전트, 개인정보 보호
+
+---
+
+## 상세 설명
+
+### 📧 귀하의 편지함을 소유하세요
+**Email Automator**는 귀하의 개인 이메일 집사입니다. 단순히 스팸을 필터링하는 것이 아니라, 귀하의 편지함을 관리해야 할 작업 목록으로 처리합니다. 로컬 AI를 활용하여 데이터가 귀하의 통제를 벗어나지 않고도 이메일을 분류하고, 우선순위를 지정하고, 답장 초안을 작성합니다.
+
+### 🚀 주요 기능
+
+-   **스마트 카테고리 분류**: AI가 시각적 헤더와 콘텐츠 분석을 기반으로 수신 이메일을 카테고리(뉴스레터, 거래, 소셜 등) 및 우선순위(높음, 중간, 낮음)로 자동 분류합니다.
+-   **인박스 제로(Inbox Zero) 엔진**: "7일 후 뉴스레터 보관" 또는 "스팸 즉시 삭제"와 같은 자동화 규칙을 정의하세요. 엔진은 백그라운드에서 지칠 줄 모르고 작동하여 편지함을 깨끗하게 유지합니다.
+-   **문맥 인식 에이전트**: 편지함과 대화하세요. **에이전트**를 사용하여 음성으로 초안을 검토("내 초안 읽어줘", "이거 보내줘")하거나, 구성 도움말을 요청하거나, 복잡한 규칙에 대한 설명을 들을 수 있습니다.
+-   **승리하는 답변(Winning Responses)**: 중요한 이메일의 경우, 오토파일럿이 귀하의 톤과 의도를 포착하여 사전 작성된 "승리하는 답변" 초안을 생성하며, 귀하의 승인만 받으면 즉시 전송될 수 있습니다.
+-   **실시간 터미널**: AI가 생각하는 과정을 지켜보세요. 내장된 실시간 터미널은 에이전트가 무엇을 분석하고, 결정하고, 수행하는지 실시간으로 정확하게 보여줍니다.
+
+### 🛡️ 개인정보 보호 우선: 귀하의 데이터, 귀하의 인프라
+**"귀하의 데이터를 소유하세요"**라는 철학을 바탕으로 구축되었습니다.
+-   **제로 클라우드 비용**: 귀하의 무료 티어 Supabase 인스턴스와 로컬 시스템에서 전적으로 실행됩니다.
+-   **로컬 AI**: **RealTimeX SDK**를 사용하여 로컬 모델(또는 API 키)에 안전하게 연결합니다. 특정 공급업체에 종속되지 않습니다.
+
+### 🔌 원활한 통합
+**RealTimeX Desktop**과 함께 실행되도록 설계되었습니다. 로컬 AI 제공업체를 자동으로 감지하고 RealTimeX 생태계를 통해 동기화합니다.
+
+---
+
+## 시각적 자산
+- **가로형 커버**: `../../images/cover-landscape.webp`

package/docs/ko/user-guide/ACCOUNT.md

@@ -0,0 +1,52 @@
+# 계정 및 개인정보 보호
+
+**계정 설정** 페이지(오른쪽 상단 모서리의 프로필 아이콘을 통해 액세스) 내에서 프로필, AI 페르소나 및 보안 설정을 관리하세요.
+
+---
+
+## 👤 프로필 및 환경
+애플리케이션과의 상호 작용을 개인화합니다.
+*   **ID**: 표시 이름을 업데이트하고 사용자 지정 아바타를 업로드합니다.
+*   **감각 피드백**: 새 이메일 분석 또는 동기화 완료와 같은 백그라운드 활동에 대한 **사운드 효과** 및 **햅틱 피드백**을 토글합니다.
+
+---
+
+## 🧬 AI 페르소나
+**페르소나**는 고품질의 **스마트 초안**을 얻기 위한 가장 중요한 설정입니다. AI가 답장을 대필할 때 사용하는 "ID" 역할을 합니다.
+
+*   **역할 및 문맥**: 직함과 근무하는 산업을 정의합니다.
+*   **목소리 톤**: 소리가 어떻게 들리길 원하는지 지정합니다(예: "전문적이지만 친근한", "간결하고 직접적인").
+*   **응답 스타일**: 응답 길이 및 서명 사용에 대한 기본 설정을 지정합니다.
+*   **신뢰할 수 있는 엔티티**: AI가 올바르게 우선순위를 지정할 수 있도록 VIP 보낸 사람 및 신뢰할 수 있는 도메인을 나열합니다.
+
+---
+
+## 🗄️ Supabase 연결 (BYOK)
+**"Bring Your Own Key"** 모델의 일부로 전용 데이터베이스에 대한 연결을 모니터링하고 관리할 수 있습니다.
+*   **상태**: 현재 Supabase 프로젝트 URL 및 스키마 버전을 확인합니다.
+*   **마이그레이션 센터**: 데이터베이스 스키마가 최신 버전인지 확인합니다.
+*   **연결 끊기**: 프로젝트를 전환해야 하는 경우 여기에서 구성을 지울 수 있습니다(이 경우 로그아웃되고 로컬 앱 상태가 재설정됩니다).
+
+---
+
+## 🔐 보안
+*   **비밀번호 관리**: 언제든지 로컬 계정 비밀번호를 업데이트할 수 있습니다.
+*   **암호화**: 모든 이메일 제공업체 자격 증명(Gmail/Outlook 토큰)은 Supabase 프로젝트에 저장되기 전에 암호화됩니다.
+
+---
+
+## 🛡️ 개인정보 보호 및 데이터 주권
+Email Automator는 **개인정보 보호 우선** 아키텍처로 설계되었습니다. 귀하의 데이터는 다음과 같이 분산됩니다.
+
+| 데이터 유형 | 위치 | 액세스 권한 |
+| :--- | :--- | :--- |
+| **이메일 메타데이터 및 로그** | 귀하의 Supabase 프로젝트 | 귀하만 가능 |
+| **원시 이메일 파일 (.eml)** | 귀하의 로컬 시스템 | 오프라인 액세스만 가능 |
+| **규칙 첨부 파일** | 귀하의 Supabase 스토리지 | 귀하만 가능 |
+| **AI 처리** | RealTimeX Desktop | 로컬/API 직접 연결 |
+
+**중요**: Email Automator(회사)는 귀하의 이메일, 자격 증명 또는 AI 로그에 절대 액세스할 수 없습니다. 모든 데이터는 귀하의 개인 인프라 내에 유지됩니다.
+
+---
+
+**다음 단계:** [문제 해결 및 지원](./TROUBLESHOOTING.md)

package/docs/ko/user-guide/AUTOMATION.md

@@ -0,0 +1,93 @@
+# 자동화 및 오토파일럿
+
+**오토파일럿** 탭은 AI 에이전트의 동작을 관리하기 위한 중앙 허브입니다. 여기에는 "시스템 규칙"(전역 토글)과 고유한 "사용자 지정 규칙"과 함께 **26개의 내장 지능형 규칙** 라이브러리가 통합되어 있습니다.
+
+---
+
+## 🛡️ 내장 시스템 규칙
+
+Email Automator에는 일반적인 편지함 문제를 처리하기 위해 AI 전문가가 설계한 26개의 사전 구성된 규칙이 포함되어 있습니다. 이러한 규칙은 체계적으로 유지될 수 있도록 기능별 범주로 구성되어 있습니다.
+
+### 📧 이메일 정리
+*   **Newsletter Sweeper**: 편지함을 깨끗하게 유지하기 위해 뉴스레터 및 마케팅 이메일을 자동으로 보관합니다.
+*   **Receipt Organizer**: 영수증 및 주문 확인서를 자동으로 분류합니다.
+*   **CC Organizer**: 빠른 분류를 위해 귀하가 참조(CC)된 이메일에 라벨을 붙입니다.
+*   **Cold Outreach Filter**: 콜드 영업 이메일을 별도의 폴더로 이동합니다.
+*   **Social Noise**: LinkedIn 및 소셜 네트워크 알림을 최소화합니다.
+*   **Stack Overflow Digests**: 즉각적인 주의가 필요한 경우를 제외하고 기술 요약본을 자동으로 보관합니다.
+
+### 🚨 우선순위 및 알림
+*   **VIP Urgent Messages**: 주요 이해관계자(CEO, 이사회 구성원)의 긴급 메시지에 별표를 표시합니다.
+*   **Critical Alerts**: 프로덕션 인시던트 및 P0/P1 중대 알림을 표면화합니다.
+*   **Urgent Support Tickets**: 즉각적인 조치가 필요한 높은 우선순위의 고객 문제를 강조합니다.
+
+### 💻 개발
+*   **GitHub Mentions**: Pull Request 또는 Issue에서 귀하가 구체적으로 언급될 때를 추적합니다.
+*   **CI/CD Failures**: CircleCI 또는 GitHub Actions와 같은 도구의 빌드 및 배포 실패를 강조합니다.
+*   **Code Review Requests**: 들어오는 코드 리뷰 요청을 정리합니다.
+*   **Dependabot Noise**: 보안 알림은 표시하면서 낮은 우선순위의 종속성 업데이트를 자동으로 보관합니다.
+*   **Monitoring Alerts**: 긴급하지 않은 모니터링 및 로깅 알림을 정리합니다.
+
+### 💼 영업 및 비즈니스
+*   **Hot Leads**: 긍정적인 감정을 바탕으로 의도가 높은 잠재 고객의 답변에 우선순위를 둡니다.
+*   **Follow-up Reminders**: 후속 조치를 구체적으로 요청하는 잠재 고객의 답변을 추적합니다.
+*   **Referrals & Intros**: 따뜻한 소개나 추천을 절대 놓치지 않도록 합니다.
+*   **Contracts & Proposals**: 중요한 계약 커뮤니케이션 및 법률 문서를 강조합니다.
+*   **Objections & Concerns**: 신중한 처리가 필요한 우려나 망설임을 표현하는 이메일을 표시합니다.
+*   **Nurture Campaigns**: 개인적인 답변에 우선순위를 두기 위해 자동 드립 캠페인 이메일을 보관합니다.
+*   **Financial Updates**: 수익 보고서 및 분기별 예산 업데이트를 쉽게 액세스할 수 있도록 유지합니다.
+
+### ⚙️ 운영
+*   **Internal Requests**: 팀 간 요청 및 작업 항목을 정리합니다.
+*   **Vendor Communications**: 송장, 배송 및 공급업체 관련 업데이트를 추적합니다.
+*   **System Alerts**: 인프라 및 시스템 알림을 정리합니다.
+*   **Meeting Invites**: 더 쉬운 일정 관리를 위해 캘린더 초대를 분리합니다.
+*   **Weekly Reports**: 정기 상태 보고서 및 진행 상황 업데이트를 자동으로 분류합니다.
+
+---
+
+## 🛠️ 사용자 지정 규칙 작성
+
+사용자 지정 규칙을 사용하면 정확한 AI 구동 워크플로를 생성할 수 있습니다. **오토파일럿** 탭 내에서 직접 규칙을 생성, 편집 및 관리할 수 있습니다.
+
+### 1. 조건 ("If")
+메타데이터와 AI 구동 조건을 조합할 수 있습니다.
+*   **AI 인사이트**: 카테고리(예: 뉴스레터, 영수증, 개인), 감정(긍정적, 부정적, 중립) 또는 우선순위(높음, 중간, 낮음).
+*   **메타데이터**: 보낸 사람 도메인(예: `github.com`), 제목의 특정 키워드 또는 보낸 사람 이름.
+*   **보존 필터**: "이메일이 X일보다 오래된 경우에만 작업 수행". 이는 오래된 뉴스레터나 알림을 정리하는 데 적합합니다.
+
+### 2. 작업 ("Then")
+이메일이 조건과 일치할 때 수행할 작업을 선택합니다.
+*   **보관 / 삭제**: 편지함을 자동으로 깨끗하게 유지합니다.
+*   **별표 / 플래그**: 수동 검토를 위해 중요한 항목을 강조합니다.
+*   **초안 생성 (Draft)**: 가장 강력한 작업입니다. AI에게 답장을 준비하도록 지시합니다.
+
+---
+
+## ✍️ 스마트 문맥 및 고스트라이팅
+
+**초안 생성** 작업을 사용할 때 답장이 귀하의 필요에 부합하도록 AI에게 구체적인 지침을 제공할 수 있습니다.
+
+*   **고스트라이팅 지침**: AI에게 *어떻게* 답장할지 알려줍니다(예: "정중하지만 단호하게 초대를 거절하세요" 또는 "다음 주 화요일에 시간이 되는지 물어보세요").
+*   **규칙 첨부 파일**: 이 규칙이 초안을 트리거할 때마다 AI가 자동으로 포함할 표준 문서(예: 가격표 또는 프로필)를 업로드할 수 있습니다.
+
+---
+
+## 🚀 오토파일럿 탭
+
+**오토파일럿** 탭은 자동화 엔진에 대한 조감도를 제공합니다.
+*   **그룹화된 보기**: 규칙은 기본 의도에 따라 구성됩니다.
+*   **빠른 토글**: 규칙을 삭제하지 않고 즉시 활성화하거나 비활성화합니다.
+*   **상태 표시기**: 현재 활성화된 규칙과 처리된 이메일 수를 확인합니다.
+
+---
+
+## 💡 모범 사례
+
+*   **수동적으로 시작하기**: AI의 카테고리 분류에 확신이 생길 때까지 첫 번째 규칙을 **삭제** 대신 **별표 표시** 또는 **보관**으로 설정하십시오.
+*   **소음에 보존 규칙 사용**: 다음과 같은 규칙을 사용하십시오. `만약 카테고리 = 뉴스레터이고 기간 > 30일이면 삭제`. 이렇게 하면 "읽은" 뉴스레터가 보관함에 영원히 쌓이는 것을 방지할 수 있습니다.
+*   **피드백으로 개선하기**: 규칙이 올바르게 일치하지 않는 경우 대시보드의 **Feedback** 아이콘을 사용하여 해당 특정 이메일 유형에 대한 AI의 이해도를 높이십시오.
+
+---
+
+**다음 단계:** [계정 및 보안 관리](./ACCOUNT.md)

package/docs/ko/user-guide/CONFIGURATION.md

@@ -0,0 +1,61 @@
+# 구성
+
+**구성(Configuration)** 탭은 Email Automator의 제어 센터입니다. 여기에서 이메일 제공업체를 연결하고, AI의 동작을 정의하며, 자동화를 구동하는 규칙을 설정합니다.
+
+---
+
+## 📧 이메일 계정 (BYOK)
+
+Email Automator는 **"Bring Your Own Key" (BYOK)** 모델을 따릅니다. 귀하의 고유한 OAuth 자격 증명을 제공하여 데이터 액세스 권한을 전적으로 귀하의 제어 하에 유지할 수 있습니다.
+
+### 🔴 Gmail 설정 (OAuth 2.0)
+1.  **Google Cloud Console**: 프로젝트를 생성하고 **Gmail API**를 활성화합니다.
+2.  **동의 화면**: OAuth 동의 화면을 구성하고 귀하의 이메일을 **테스트 사용자**로 추가합니다.
+3.  **자격 증명**: **OAuth 2.0 클라이언트 ID**를 생성합니다(유형: 웹 애플리케이션).
+    *   **승인된 리디렉션 URI**: `https://<your-project-ref>.supabase.co/functions/v1/auth-gmail/callback`
+4.  **연결**: Email Automator에서 **Connect Gmail**을 클릭합니다.
+5.  **승인**: 클라이언트 ID와 비밀번호(또는 JSON 업로드)를 붙여넣은 다음 링크를 따라 계정을 승인합니다.
+
+### 🔵 Outlook 설정 (디바이스 코드)
+1.  **Azure Portal**: **App Registrations**(앱 등록)에서 새 애플리케이션을 등록합니다.
+2.  **계정 유형**: "모든 조직 디렉터리의 계정 및 개인 Microsoft 계정"을 선택합니다.
+3.  **인증**: "공용 클라이언트 흐름 허용"이 **예**로 설정되어 있는지 확인합니다.
+4.  **연결**: Email Automator에서 **Connect Outlook**을 클릭하고 **클라이언트 ID**를 입력합니다.
+5.  **승인**: 브라우저의 **디바이스 코드** 프롬프트를 따라 로그인을 완료합니다.
+
+---
+
+## 📅 동기화 범위 및 제한
+
+첫 동기화를 시작하기 전에 성능과 비용 효율성을 보장하기 위해 경계를 설정하십시오.
+
+*   **Sync From(동기화 시작 시점)**: 시작 날짜를 선택합니다(예: "지금부터" 또는 특정 과거 날짜).
+*   **Max Emails(최대 이메일 수)**: 단일 배치에서 처리할 최대 이메일 수를 설정합니다(기본값: 50).
+*   **Sync Interval(동기화 간격)**: 백그라운드 스케줄러가 새 메일을 확인하는 빈도를 정의합니다(예: 15분마다).
+
+> [!TIP]
+> **작게 시작하기**: 첫 실행 시에는 "Sync From"을 "Now"로, "Max Emails"를 10~20으로 설정하여 규칙이 예상대로 작동하는지 확인하는 것이 좋습니다.
+
+---
+
+## 🤖 자동화 및 오토파일럿
+
+사용자 지정 규칙 빌드, 시스템 자동화 토글, 보존 정책 설정을 포함한 AI 동작 관리는 **[오토파일럿](./AUTOMATION.md)** 탭으로 통합되었습니다.
+
+---
+
+## 🧠 AI 및 시스템 설정
+
+### 제공업체 구성
+Email Automator는 **RealTimeX Desktop**을 통해 사용 가능한 모델을 감지합니다.
+*   **LLM 제공업체**: 선호하는 AI 엔진(예: OpenAI, Anthropic 또는 로컬 모델)을 선택합니다.
+*   **임베딩 모델**: AI가 특정 문맥을 이해하도록 돕는 RAG(검색 증강 생성) 시스템에 사용됩니다.
+
+### 음성 및 접근성 (TTS)
+AI가 요약이나 중요한 알림을 소리 내어 읽어주도록 **텍스트 음성 변환(TTS)**을 활성화합니다.
+*   **자동 읽기(Auto-Speak)**: 우선순위가 높은 알림을 자동으로 읽어줍니다.
+*   **음성 프로필**: RealTimeX를 통해 사용 가능한 다양한 고품질 음성 중에서 선택합니다.
+
+---
+
+**다음 단계:** [대시보드 모니터링](./DASHBOARD.md)

package/docs/ko/user-guide/DASHBOARD.md

@@ -0,0 +1,71 @@
+# 대시보드 및 실시간 활동
+
+**대시보드**는 AI 에이전트의 활동을 모니터링하고 분석된 편지함을 관리하기 위한 기본 인터페이스입니다. AI가 어떻게 생각하고 행동하는지에 대한 완전한 투명성을 제공하도록 설계되었습니다.
+
+---
+
+## 📊 분석 피드
+
+AI가 편지함을 처리함에 따라 실시간 상태 업데이트 및 지능형 인사이트와 함께 이메일이 피드에 표시됩니다.
+
+*   **스마트 검색**: 키워드나 보낸 사람으로 이메일을 빠르게 찾습니다.
+*   **AI 필터**: 카테고리(예: 뉴스레터, 개인), 감정 또는 우선순위별로 보기를 필터링합니다.
+*   **동적 정렬**: 이메일이 *수신된* 시간과 AI에 의해 *처리된* 시간 사이를 전환합니다.
+
+### 📌 이메일 상세 사이드바
+이메일 카드를 클릭하면 다음을 포함하는 상세 사이드 패널이 열립니다.
+*   **AI 요약**: 이메일 내용에 대한 간결한 개요.
+*   **핵심 포인트**: AI가 추출한 글머리 기호 하이라이트.
+*   **초안 미리보기**: 답장 초안이 생성된 경우 전송하기 전에 여기에서 검토할 수 있습니다.
+*   **빠른 링크**: Gmail 또는 Outlook 웹 인터페이스의 원본 이메일로 직접 이동합니다.
+
+---
+
+## 🛡️ 신뢰 및 투명성
+
+Email Automator는 **"글래스 박스(Glass Box) AI"** 원칙에 따라 제작되었습니다. 사용자는 항상 작업이 수행된 *이유*를 알 수 있어야 합니다.
+
+### 📟 실시간 활동 터미널
+오른쪽 하단 모서리에 있는 **Live Activity** 버튼을 클릭하여 실시간 처리 피드를 엽니다.
+*   **사고 로그**: AI가 콘텐츠를 분석하고, 규칙을 평가하고, 작업을 결정하는 과정을 지켜보세요.
+*   **기술 세부 정보**: 원시 API 호출, 처리 시간 및 백그라운드 동기화 상태를 확인합니다.
+*   **제어**: 터미널에서 직접 활성 동기화를 수동으로 중지할 수 있습니다.
+
+### 🕵️ AI 추적
+이메일 카드의 **눈 아이콘**을 클릭하여 **AI 추적 모달**을 엽니다.
+*   **결정 로직**: AI가 특정 카테고리나 우선순위를 할당한 이유에 대한 단계별 분석을 봅니다.
+*   **원시 데이터**: LLM에 전송된 정확한 프롬프트와 반환된 원시 JSON 응답을 확인합니다.
+*   **성능 통계**: 해당 이메일에 대한 토큰 사용량 및 처리 시간을 검토합니다.
+
+---
+
+## ⚡ 빠른 작업
+
+모든 이메일 카드에서 클릭 한 번으로 사용할 수 있는 작업으로 제어하세요.
+*   🗑️ **삭제 / 📦 보관**: 즉각적인 정리.
+*   ⭐ **별표 / 플래그**: 나중에 확인하기 위해 중요한 항목 표시.
+*   🔄 **재처리**: 규칙을 업데이트한 경우 AI에게 이메일을 다시 분석하도록 요청할 수 있습니다.
+*   💬 **피드백**: 잘못된 카테고리 분류나 감정 분석을 보고하여 AI의 학습을 돕습니다.
+
+---
+
+## 🔔 알림 및 피드백
+
+앱은 다감각 피드백을 사용하여 백그라운드 활동을 알려줍니다.
+*   **시각적**: 실시간 상태 배지 및 토스트 알림.
+*   **오디오**: 새 이메일, 높은 우선순위 알림 및 동기화 완료를 위한 미묘하고 고품질의 알림음.
+*   **햅틱**: 지원되는 장치에서의 물리적 피드백.
+
+> **참고**: 소리 및 햅틱 설정은 [**계정 설정**](./ACCOUNT.md)에서 사용자 지정할 수 있습니다.
+
+---
+
+## 📈 분석 및 기록
+
+에이전트의 성능에 대한 정보를 유지하세요.
+*   **동기화 기록**: 처리된 이메일 수와 수행된 작업을 포함하여 최근 동기화 실행 로그를 봅니다.
+*   **효율성 통계**: 시간에 따른 자동 삭제, 보관 및 초안 생성 총계를 확인합니다.
+
+---
+
+**다음 단계:** [자동화 규칙 생성](./AUTOMATION.md)

package/docs/ko/user-guide/GETTING-STARTED.md

@@ -0,0 +1,61 @@
+# 시작하기
+
+AI 기반 개인 이메일 비서인 **Email Automator**에 오신 것을 환영합니다. 이 가이드는 **"Bring Your Own Key" (BYOK)** 모델을 사용하여 애플리케이션을 설정하는 방법을 도와줍니다. 이 모델은 귀하의 데이터가 귀하의 고유한 Supabase 인프라 내에서 제어되도록 보장합니다.
+
+## 🛠 사전 요구 사항
+
+시작하기 전에 다음 사항을 확인하십시오.
+
+1.  **RealTimeX Desktop**: 설치 및 실행 중이어야 합니다. 이는 AI 처리(LLM) 및 텍스트 음성 변환(TTS) 기능에 필요합니다.
+2.  **Supabase 계정**: [supabase.com](https://supabase.com)의 무료 또는 유료 계정.
+
+---
+
+## 🚀 설정 마법사를 통한 빠른 설정
+
+내장된 **설정 마법사(Setup Wizard)**는 권장되는 시작 방법입니다. 기술적인 복잡한 작업을 자동화해 줍니다.
+
+### 1. 구매 및 실행
+*   **RealTimeX Desktop**을 엽니다.
+*   **Marketplace** 탭 → **Local Apps**로 이동합니다.
+*   **"Email Automator"**를 검색하여 구매합니다(이미 소유한 경우 활성화).
+*   구매가 완료되면 로컬 앱 목록에서 **Launch**(실행)를 클릭합니다.
+
+### 2. 설정 마법사 실행
+처음 실행하면 앱이 초기 구성을 안내합니다.
+
+*   **설정 경로 선택**:
+    *   **관리형 프로비저닝(권장)**: **Supabase 액세스 토큰**을 제공합니다. 마법사가 자동으로 새 프로젝트를 생성하고, 데이터베이스 마이그레이션을 실행하며, Edge Functions를 배포하고, 초기 지식 베이스를 수집합니다.
+    *   **기존 프로젝트 연결**: **프로젝트 URL**과 **Anon Key**를 제공하여 기존 Supabase 프로젝트를 사용합니다. 선택적으로 액세스 토큰을 제공하여 마법사가 마이그레이션을 대신 실행하게 할 수도 있습니다.
+
+### 3. 계정 생성
+데이터베이스가 준비되면 로컬 사용자 계정을 생성하고 로그인하여 **대시보드**에 액세스하라는 메시지가 표시됩니다.
+
+---
+
+## 🔍 Supabase 자격 증명 찾기
+
+기존 프로젝트를 수동으로 연결하기로 선택한 경우, [Supabase 대시보드](https://supabase.com/dashboard)에서 자격 증명을 찾을 수 있습니다.
+
+1.  프로젝트를 선택합니다.
+2.  **Settings**(설정) → **API**로 이동합니다.
+3.  **Project URL**: "Project URL" 아래에 있는 URL을 복사합니다.
+4.  **API Key**: "Project API keys" 아래에 있는 **anon (public)** 키를 복사합니다.
+
+> [!WARNING]
+> **보안 주의**: `service_role` 키를 절대 사용하지 마십시오. 이 키는 완전한 관리자 우회 권한을 가지고 있으며 클라이언트 측 애플리케이션에서 노출되어서는 안 됩니다.
+
+---
+
+## 🪪 액세스 토큰 생성
+
+액세스 토큰을 사용하면 설정 마법사가 귀하를 대신하여 Supabase 프로젝트(생성, 마이그레이션, 기능 배포)를 관리할 수 있습니다.
+
+1.  Supabase 대시보드에서 **Account**(계정) → **Access Tokens**(액세스 토큰)으로 이동합니다.
+2.  **Generate new token**을 클릭하고 이름(예: "Email Automator")을 입력한 후 결과를 복사합니다.
+3.  메시지가 표시되면 이 토큰을 설정 마법사에 붙여넣습니다.
+
+---
+
+**다음 단계:** [이메일 계정 구성](./CONFIGURATION.md)  
+**용어 사전:** [공통 용어](./GLOSSARY.md)