@realtimex/email-automator 2.22.1 → 2.22.2

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

@@ -0,0 +1,160 @@
+# Glossaire
+
+Définitions des termes courants utilisés dans Email Automator et l'Assistant de configuration.
+
+## Supabase
+Une plateforme backend qui fournit une base de données Postgres hébergée, l'authentification, le stockage et des API. Email Automator utilise Supabase comme base de données et couche d'authentification.
+
+## BYOK (Bring Your Own Key)
+Un modèle de configuration où vous connectez votre propre projet Supabase au lieu d'utiliser un backend partagé. Cela conserve vos données dans votre propre infrastructure.
+
+## ID de projet Supabase
+L'identifiant unique de votre projet Supabase (souvent affiché dans l'URL du projet ou les paramètres).
+
+## URL de projet Supabase
+L'URL de base de votre projet Supabase, utilisée par l'application pour se connecter à la base de données et aux API.
+
+## Clé Anon (Clé API publique)
+La clé API publique de votre projet Supabase. Elle est sûre pour une utilisation côté client mais reste soumise à la sécurité au niveau des lignes (RLS).
+
+## Jeton d'accès (Access Token)
+Un jeton de votre compte Supabase qui permet à l'Assistant de configuration de créer ou de gérer des projets en votre nom (utilisé dans le démarrage rapide).
+
+## Provisionnement géré (Démarrage rapide)
+L'Assistant de configuration utilise votre jeton d'accès pour créer automatiquement un projet Supabase, appliquer les migrations, déployer les Edge Functions et intégrer la base de connaissances.
+
+## Synchronisation manuelle (Connecter un projet existant)
+Vous connectez un projet Supabase existant en fournissant l'URL du projet et la clé Anon. Les migrations peuvent être exécutées par l'assistant si un jeton d'accès est fourni.
+
+## Provisionnement géré vs Synchronisation manuelle
+**Le provisionnement géré** crée un nouveau projet Supabase pour vous à l'aide d'un jeton d'accès.
+**La synchronisation manuelle** se connecte à un projet Supabase existant à l'aide de votre URL de projet et de votre clé Anon.
+
+## Migration
+Changements de base de données qui créent ou mettent à jour des tables, des vues, des fonctions et des politiques. Les migrations maintiennent le schéma de votre base de données aligné avec l'application.
+
+## Schéma
+La structure de votre base de données : tables, colonnes, types, index, fonctions et politiques.
+
+## SQL
+Le langage utilisé pour définir et interroger les structures et les données de la base de données.
+
+## Incohérence de version (Version Mismatch)
+Lorsque la version du schéma attendue par l'application diffère de la version réelle de la base de données. L'Assistant de configuration ou l'outil de migration vous invitera à normaliser.
+
+## Version de la base de données (Paramètres du compte)
+La version majeure de la base de données affichée dans les Paramètres du compte. Elle est utilisée pour guider les migrations et doit correspondre à la version Postgres de votre projet Supabase.
+
+## Rollback
+Annulation d'une migration. Dans Supabase, les rollbacks sont manuels et doivent être utilisés avec précaution.
+
+## RLS (Row Level Security)
+Une fonctionnalité de sécurité Postgres qui restreint les lignes qu'un utilisateur peut lire ou écrire. Supabase utilise la RLS pour protéger les données.
+
+## Edge Functions
+Fonctions sans serveur (serverless) hébergées par Supabase. Email Automator les utilise pour les flux OAuth et les opérations sécurisées.
+
+## Clé de rôle de service (Service Role Key)
+Une clé Supabase puissante qui contourne la RLS. Elle ne doit jamais être exposée aux clients.
+
+## Clé Anon vs Clé de rôle de service
+La **clé anon** est sûre pour l'utilisation client et respecte la RLS. La **clé de rôle de service** contourne la RLS et ne doit être utilisée que sur des serveurs de confiance.
+
+## RealTimeX Desktop
+L'application locale qui fournit des services d'IA (LLM, embeddings, TTS) utilisés par Email Automator.
+
+## Persona numérique
+Un profil qui définit votre ton, votre style et vos préférences pour les brouillons et les réponses générés par l'IA.
+
+## Ton du Persona
+Le caractère émotionnel des réponses (ex : amical, formel, direct).
+
+## Style du Persona
+Les préférences de style d'écriture (ex : concis, détaillé, points clés).
+
+## Voix du Persona
+Le "son" global de votre écriture, incluant le phrasé et le rythme.
+
+## Signature du Persona
+Une formule de politesse standardisée utilisée dans les réponses (nom, titre, entreprise).
+
+## Rôle du Persona
+Votre titre de poste ou rôle, utilisé pour façonner le cadre de la réponse.
+
+## Entreprise du Persona
+Le nom de l'organisation utilisé dans les réponses lorsque c'est approprié.
+
+## Langue du Persona
+La langue principale pour les brouillons générés.
+
+## API Express
+Le backend local qui gère la synchronisation des e-mails, le traitement de l'IA et l'exécution de l'automatisation.
+
+## Realtime (Supabase)
+Mises à jour en direct de la base de données vers l'application. Utilisé pour refléter les nouveaux e-mails, le statut de synchronisation ou l'activité sans rafraîchir la page.
+
+## LLM (Large Language Model)
+Un modèle d'IA utilisé pour l'analyse et la génération de réponses (ex : catégorisation, rédaction de brouillons).
+
+## Modèle d'intégration (Embedding Model)
+Un modèle qui convertit le texte en vecteurs pour la recherche sémantique. Utilisé par la base de connaissances et le RAG.
+
+## Embeddings (Intégrations vectorielles)
+Représentations vectorielles de texte utilisées pour la recherche sémantique dans la base de connaissances.
+
+## RAG (Retrieval-Augmented Generation)
+Une méthode qui récupère la documentation pertinente et la transmet à l'IA pour que les réponses restent basées sur vos documents.
+
+## Ingestion de la base de connaissances
+Le processus de conversion de la documentation en embeddings consultables et leur stockage dans la base de données.
+
+## TTS (Text-to-Speech)
+Convertit les réponses de l'IA en audio parlé (synthèse vocale).
+
+## Fournisseur TTS vs Voix
+Le fournisseur est le service qui génère la parole ; la voix est le locuteur/persona spécifique au sein de ce fournisseur.
+
+## OAuth
+Une norme d'autorisation qui permet à l'application d'accéder à votre compte e-mail sans stocker votre mot de passe.
+
+## Écran de consentement OAuth
+L'écran où vous accordez à Email Automator la permission d'accéder à votre compte de messagerie.
+
+## Jeton d'accès (OAuth Access Token)
+Un jeton à courte durée de vie utilisé pour appeler les API des fournisseurs de messagerie. Il expire et est renouvelé automatiquement.
+
+## Jeton de rafraîchissement (Refresh Token)
+Un jeton à longue durée de vie utilisé pour obtenir de nouveaux jetons d'accès sans se ré-authentifier.
+
+## API Gmail
+L'API officielle de Google pour accéder aux données Gmail et envoyer des e-mails.
+
+## Microsoft Graph
+L'API de Microsoft pour les données Outlook et Microsoft 365 (courrier, calendrier, contacts).
+
+## IMAP / SMTP
+Protocoles de messagerie. IMAP lit le courrier ; SMTP envoie le courrier. (Email Automator utilise les API des fournisseurs plutôt que l'IMAP/SMTP brut.)
+
+## Enregistrement d'application (Microsoft)
+Une configuration d'application dans Azure qui fournit des identifiants pour l'accès à Microsoft Graph.
+
+## ID Client (Client ID)
+L'identifiant public de votre application OAuth (Google/Microsoft).
+
+## Secret Client (Client Secret)
+Un secret privé pour votre application OAuth. Traitez-le comme un mot de passe.
+
+## URI de redirection
+L'URL de rappel où le fournisseur de messagerie renvoie les utilisateurs après l'autorisation OAuth.
+
+## Flux de code d'appareil (Device Code Flow)
+Un flux OAuth où vous vous authentifiez dans un navigateur à l'aide d'un code court, souvent utilisé pour les applications de bureau.
+
+## ID de locataire (Tenant ID)
+L'identifiant de locataire Microsoft. Utilisez "common" pour le multi-locataire ou un ID spécifique pour un accès réservé à une organisation.
+
+## Portée de synchronisation (Sync Scope)
+Définit l'historique à synchroniser (ex : les X derniers jours) et les comptes inclus.
+
+## Libellés (Gmail) / Dossiers (Outlook)
+Constructions d'organisation chez les fournisseurs de messagerie. Les libellés marquent les messages ; les dossiers les organisent dans des conteneurs.

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

@@ -0,0 +1,65 @@
+# Dépannage et Support
+
+Si vous rencontrez des problèmes, ce guide couvre les pièges les plus courants et leurs solutions.
+
+---
+
+## 📡 Problèmes de synchronisation
+
+### Les e-mails n'apparaissent pas dans le tableau de bord
+*   **Vérifiez la date "Synchroniser depuis"** : L'IA ne traite que les e-mails reçus *après* cette date.
+*   **Réinitialiser le point de contrôle (Reset Checkpoint)** : Si vous avez changé votre date de début et souhaitez rescanner les anciens e-mails, cliquez sur le bouton **Reset Checkpoint** dans le panneau de portée de synchronisation.
+*   **Limites de lots** : Le paramètre **E-mails max** limite le nombre d'e-mails traités par cycle. Si vous avez un retard important, plusieurs cycles peuvent être nécessaires pour rattraper le retard.
+*   **Déclenchement manuel** : Cliquez sur **Run Sync Now** sur le tableau de bord pour forcer une vérification immédiate.
+
+### "Sync Failed" ou "Backend Not Connected"
+*   **Serveur local** : Assurez-vous que l'application Email Automator est ouverte et en cours d'exécution.
+*   **Flux d'activité en direct** : Ouvrez le terminal **Live Activity**. Il contient souvent des messages d'erreur techniques spécifiques (ex : "Network Error" ou "401 Unauthorized").
+
+---
+
+## 🔑 Authentification et Autorisations
+
+### Google/Gmail : `redirect_uri_mismatch`
+*   **La solution** : Votre URI de redirection dans la Google Cloud Console doit correspondre *exactement* à celle affichée dans Email Automator.
+*   **Exemple** : `https://votre-ref.supabase.co/functions/v1/auth-gmail/callback` (assurez-vous qu'il n'y a pas d'espace ou de barre oblique finale superflue).
+
+### Microsoft/Outlook : La connexion échoue ou expire
+*   **Enregistrement de l'application** : Assurez-vous que votre enregistrement d'application Azure a l'option "Autoriser les flux de clients publics" définie sur **Oui**.
+*   **Type de compte** : Assurez-vous d'avoir sélectionné "Comptes dans n'importe quel annuaire organisationnel et comptes Microsoft personnels" lors de l'enregistrement.
+
+### Supabase : "Invalid API Key"
+*   **La solution** : Utilisez toujours la clé **anon (public)**. La clé **service_role** sera rejetée par l'application pour des raisons de sécurité.
+
+---
+
+## 🤖 Intégration IA et RealTimeX
+
+### L'IA est lente ou ne répond pas
+*   **Modèles locaux** : Si vous utilisez Ollama ou LM Studio, assurez-vous que votre machine a suffisamment de RAM et que votre GPU n'est pas trop sollicité.
+*   **Découverte** : Si aucun modèle n'apparaît dans la liste déroulante, assurez-vous que **RealTimeX Desktop** est en cours d'exécution et que vous y avez configuré au moins un fournisseur d'IA.
+
+### Les "Brouillons intelligents" ne sont pas créés
+*   **Interrupteur système** : Assurez-vous que l'option **Smart Drafts** est activée (ON) dans l'onglet Auto-Pilot.
+*   **Conflit de règles** : Vérifiez que la règle correspondant à l'e-mail inclut bien l'action **Draft** (Brouillon).
+*   **Filtre de sécurité** : L'IA ignore automatiquement la rédaction de brouillons pour les adresses `no-reply` et certaines notifications automatisées pour éviter les "boucles de robots".
+
+---
+
+## 🗄️ Base de données et Migrations
+
+### Bannière "Mise à jour de la base de données requise"
+*   **Pourquoi cela arrive** : Votre application locale a été mise à jour et le schéma de votre base de données Supabase doit être actualisé pour prendre en charge les nouvelles fonctionnalités.
+*   **La solution** : Cliquez sur **Update Now** dans la bannière. Vous aurez besoin de votre **Jeton d'accès Supabase** pour exécuter la mise à jour automatiquement.
+
+### Le Terminal en direct est vide ou affiche "404"
+*   **Autorisations Realtime** : Assurez-vous d'avoir exécuté les dernières migrations. La table `processing_events` doit exister et avoir les politiques RLS (Row Level Security) correctes activées.
+
+---
+
+## 🆘 Besoin d'aide supplémentaire ?
+
+Si votre problème n'est pas répertorié ici :
+1.  Consultez les **Journaux système** (System Logs) dans les Paramètres du compte pour les traces techniques.
+2.  Consultez la [Documentation développeur](../docs-dev/README.md) pour les détails de configuration avancés.
+3.  Ouvrez un ticket ou une discussion sur le dépôt du projet.

package/docs/ja/README.md

@@ -0,0 +1,23 @@
+# Email Automator ドキュメント
+
+**Email Automator** のドキュメントへようこそ。これは、AI を搭載したパーソナルメールアシスタントです。このツールはローカルマシン上で動作するため、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/ja/marketplace/listing.md

@@ -0,0 +1,34 @@
+# RealTimeX Marketplace 掲載情報: Email Automator
+
+## メタデータ
+- **表示名**: Email Automator
+- **短い説明**: 受信トレイの管理を学習する、エージェント型の AI 搭載メール管理プラットフォーム。クラウドコストゼロ、完全なプライバシーで「自分の受信トレイを所有」しましょう。
+- **タグ**: 生産性, メール, 自動化, AI エージェント, プライバシー
+
+---
+
+## 詳細説明
+
+### 📧 自分の受信トレイを所有する
+**Email Automator** は、あなたのパーソナルなメール執事です。単にスパムをフィルタリングするだけではありません。受信トレイを管理が必要なタスクリストとして扱います。ローカル AI を活用することで、データのコントロールを一切失うことなく、メールの分類、優先順位付け、さらには返信の下書き作成まで行います。
+
+### 🚀 主な機能
+
+-   **スマートな分類**: AI がヘッダー情報と内容分析に基づき、受信メールを自動的にカテゴリ（ニュースレター、取引関連、ソーシャルなど）と優先度（高、中、低）に分類します。
+-   **Inbox Zero エンジン**: 「7 日後にニュースレターをアーカイブする」や「スパムを即座に削除する」といった自動化ルールを定義できます。エンジンがバックグラウンドで絶え間なく働き、受信トレイをクリーンに保ちます。
+-   **コンテキストを理解するエージェント**: 受信トレイと対話しましょう。**エージェント**を使用して、音声で下書きを確認したり（「下書きを読んで」「これを送信して」）、設定のヘルプを求めたり、複雑なルールの説明を受けたりできます。
+-   **納得の回答 (Winning Responses)**: 重要なメールに対して、オートパイロットが「Winning Response」下書きを生成します。あなたのトーンと意図を捉えた事前作成済みの返信で、承認するだけで送信可能です。
+-   **ライブターミナル**: AI の思考プロセスを確認しましょう。内蔵のライブターミナルにより、エージェントが何を分析し、何を決定し、何を実行しているかをリアルタイムで正確に把握できます。
+
+### 🛡️ プライバシー優先: あなたのデータ、あなたのインフラ
+**「自分のデータを所有する」**という哲学に基づいて構築されています。
+-   **クラウドコストゼロ**: あなた自身の無料枠の Supabase インスタンスとローカルマシン上で完全に動作します。
+-   **ローカル AI**: **RealTimeX SDK** を使用して、ローカルモデル（または API キー）に安全にアクセスします。特定のベンダーに縛られることはありません。
+
+### 🔌 シームレスな統合
+**RealTimeX Desktop** と並行して動作するように設計されています。ローカルの AI プロバイダーを自動的に検出し、RealTimeX エコシステムを介して同期します。
+
+---
+
+## ビジュアルアセット
+- **ランドスケープカバー**: `../../images/cover-landscape.webp`

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

@@ -0,0 +1,52 @@
+# アカウントとプライバシー
+
+プロフィール、AI ペルソナ、およびセキュリティ設定は、**アカウント設定**ページ（右上のプロフィールアイコンからアクセス）で管理できます。
+
+---
+
+## 👤 プロフィールと体験
+アプリケーションとの対話をパーソナライズします。
+*   **ID**: 表示名を更新し、カスタムアバターをアップロードできます。
+*   **感覚フィードバック**: 新着メールの分析や同期完了などのバックグラウンドアクティビティに対する**効果音**と**触覚フィードバック**を切り替えます。
+
+---
+
+## 🧬 AI ペルソナ
+**ペルソナ**は、高品質な**スマートドラフト**を得るために最も重要な設定です。これは、AI が返信を代筆する際に使用する「アイデンティティ」として機能します。
+
+*   **役割とコンテキスト**: 役職や勤務している業界を定義します。
+*   **声のトーン**: どのような印象を与えたいかを指定します（例：「プロフェッショナルだが親しみやすい」「簡潔で直接的」など）。
+*   **返信スタイル**: 返信の長さや署名の使用に関する好みを設定します。
+*   **信頼できるエンティティ**: 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/ja/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**: プルリクエストやイシューで自分が具体的にメンションされたときを追跡します。
+*   **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. 条件 (もし〜なら)
+メタデータと AI 駆動の条件を組み合わせて設定できます。
+*   **AI Insights**: カテゴリ（例：ニュースレター、領収書、個人）、感情（ポジティブ、ネガティブ、ニュートラル）、または優先度（高、中、低）。
+*   **メタデータ**: 送信者ドメイン（例：`github.com`）、件名の特定のキーワード、または送信者名。
+*   **リテンションフィルター**: 「メールが X 日より古い場合のみ実行」。古いニュースレターや通知のクリーンアップに最適です。
+
+### 2. アクション (そのとき〜する)
+メールが条件に一致したときに何が起こるかを選択します。
+*   **アーカイブ / 削除**: 受信トレイを自動的にきれいに保ちます。
+*   **スター / フラグ**: 手動確認が必要な重要なアイテムをハイライトします。
+*   **下書き (Draft)**: 最も強力なアクションです。返信を準備するよう AI に指示します。
+
+---
+
+## ✍️ スマートコンテキストとゴーストライティング
+
+**下書き**アクションを使用する場合、返信がニーズに合致するように AI に具体的な指示を与えることができます。
+
+*   **ゴーストライティングの指示**: 返信の「方法」を AI に伝えます（例：「招待を断る際は丁寧かつ毅然とした態度で」「来週火曜日の都合を聞いて」など）。
+*   **ルールの添付ファイル**: このルールが下書きをトリガーするたびに AI が自動的に含める標準ドキュメント（価格表やプロフィールなど）をアップロードできます。
+
+---
+
+## 🚀 オートパイロットタブ
+
+**オートパイロット**タブでは、自動化エンジンの全体像を把握できます。
+*   **グループ表示**: ルールは主な目的に基づいて整理されています。
+*   **クイックトグル**: ルールを削除せずに即座に有効化または無効化できます。
+*   **ステータス表示**: どのルールが現在アクティブで、何通のメールを処理したかを確認できます。
+
+---
+
+## 💡 ベストプラクティス
+
+*   **受動的に始める**: AI のカテゴリ分けに自信が持てるまでは、最初のルールを **削除** ではなく **スター** や **アーカイブ** に設定してください。
+*   **ノイズにリテンションを使用する**: 「カテゴリ = ニュースレター かつ 経過日数 > 30 日 ならば 削除」といったルールを使用します。これにより、「読了」したニュースレターがアーカイブを永遠に埋め尽くすのを防げます。
+*   **フィードバックで洗練させる**: ルールが正しく一致しない場合は、ダッシュボードの **Feedback** アイコンを使用して、その特定のメールタイプに対する AI の理解を向上させてください。
+
+---
+
+**次のステップ:** [アカウントとセキュリティ管理](./ACCOUNT.md)

package/docs/ja/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)**: 1 回のバッチで処理するメールの最大数を設定します（デフォルト：50）。
+*   **同期インターバル**: バックグラウンドスケジューラが新しいメールをチェックする頻度を定義します（例：15 分ごと）。
+
+> [!TIP]
+> **小さく始める**: 初回の実行では、「同期開始日」を「今から」に、「最大メール数」を 10〜20 に設定して、ルールが期待通りに動作するか確認することをお勧めします。
+
+---
+
+## 🤖 自動化とオートパイロット
+
+カスタムルールの作成、システム自動化の切り替え、リテンションポリシーの設定など、AI の動作管理は**[オートパイロット](./AUTOMATION.md)**タブに統合されました。
+
+---
+
+## 🧠 AI とシステム設定
+
+### プロバイダー設定
+Email Automator は、**RealTimeX Desktop** 経由で利用可能なモデルを検出します。
+*   **LLM プロバイダー**: 好みの AI エンジンを選択します（例：OpenAI、Anthropic、またはローカルモデル）。
+*   **埋め込みモデル**: AI が特定のコンテキストを理解するのを助けるための RAG (検索拡張生成) システムで使用されます。
+
+### 音声とアクセシビリティ (TTS)
+**テキスト読み上げ (TTS)** を有効にすると、AI が要約や重要なアラートを読み上げます。
+*   **自動読み上げ**: 高優先度の通知を自動的に読み上げます。
+*   **音声プロファイル**: RealTimeX で利用可能なさまざまな高品質な音声から選択できます。
+
+---
+
+**次のステップ:** [ダッシュボードの監視](./DASHBOARD.md)

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

@@ -0,0 +1,71 @@
+# ダッシュボードとライブアクティビティ
+
+**ダッシュボード**は、AI エージェントのアクティビティを監視し、分析された受信トレイを管理するためのメインインターフェースです。AI がどのように考え、行動しているかを完全に透明化するように設計されています。
+
+---
+
+## 📊 分析フィード
+
+AI が受信トレイを処理すると、リアルタイムのステータス更新とインテリジェントな洞察とともにメールがフィードに表示されます。
+
+*   **スマート検索**: キーワードや送信者でメールを素早く見つけます。
+*   **AI フィルター**: カテゴリ（例：ニュースレター、個人）、感情、または優先度で表示をフィルタリングします。
+*   **動的な並べ替え**: メールの「受信時刻」と AI による「処理時刻」を切り替えます。
+
+### 📌 メール詳細サイドバー
+メールカードをクリックすると、詳細サイドパネルが開きます。
+*   **AI 要約**: メールの内容の簡潔な概要。
+*   **キーポイント**: AI によって抽出された箇条書きのハイライト。
+*   **ドラフトプレビュー**: 返信ドラフトが生成された場合、送信前にここで確認できます。
+*   **クイックリンク**: Gmail または Outlook の Web インターフェースで元のメールに直接ジャンプします。
+
+---
+
+## 🛡️ 信頼と透明性
+
+Email Automator は、**「ガラスボックス AI」**の原則に基づいています。アクションが実行された「理由」を常に知ることができます。
+
+### 📟 ライブアクティビティターミナル
+右下の **Live Activity** ボタンをクリックして、リアルタイムの処理フィードを開きます。
+*   **思考ログ**: AI が内容を分析し、ルールを評価し、アクションを決定する様子を確認できます。
+*   **技術的な詳細**: 生の API コール、処理時間、バックグラウンド同期ステータスを確認できます。
+*   **コントロール**: ターミナルから直接、アクティブな同期を手動で停止できます。
+
+### 🕵️ AI トレース
+メールカードの**目のアイコン**をクリックして、**AI トレースモーダル**を開きます。
+*   **判断ロジック**: AI が特定のカテゴリや優先度を割り当てた理由をステップバイステップで確認できます。
+*   **生データ**: LLM に送信された正確なプロンプトと、返された生の JSON レスポンスを確認できます。
+*   **パフォーマンス統計**: そのメールのトークン使用量と処理時間を確認できます。
+
+---
+
+## ⚡ クイックアクション
+
+各メールカードで利用可能なワンクリックアクションでコントロールできます。
+*   🗑️ **削除 / 📦 アーカイブ**: 即座にクリーンアップします。
+*   ⭐ **スター / フラグ**: 重要なアイテムを後で確認できるようにマークします。
+*   🔄 **再処理**: ルールを更新した場合、AI にメールを再度分析させることができます。
+*   💬 **フィードバック**: 誤ったカテゴリ分けや感情分析を報告することで、AI の学習を助けます。
+
+---
+
+## 🔔 通知とフィードバック
+
+アプリは、バックグラウンドアクティビティを知らせるために多感覚フィードバックを使用します。
+*   **視覚**: ライブステータスバッジとトースト通知。
+*   **音声**: 新着メール、高優先度アラート、同期完了を知らせる高品質なチャイム。
+*   **触覚**: 対応デバイスでの物理的なフィードバック。
+
+> **注意**: 音声と触覚の設定は、**[アカウント設定](./ACCOUNT.md)**でカスタマイズできます。
+
+---
+
+## 📈 アナリティクスと履歴
+
+エージェントのパフォーマンスを把握できます。
+*   **同期履歴**: 処理されたメール数や実行されたアクションを含む、最近の同期実行のログを表示します。
+*   **効率統計**: 自動化された削除、アーカイブ、ドラフトの合計数を時系列で確認できます。
+
+---
+
+**次のステップ:** [自動化ルールの作成](./AUTOMATION.md)

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

@@ -0,0 +1,61 @@
+# はじめに
+
+**Email Automator** へようこそ。AI を搭載したパーソナルメールアシスタントです。このガイドでは、**「Bring Your Own Key」 (BYOK)** モデルを使用してアプリケーションをセットアップする方法を説明します。これにより、データはあなた自身の Supabase インフラストラクチャ内で管理され、プライバシーが守られます。
+
+## 🛠 前提条件
+
+開始する前に、以下の準備ができていることを確認してください。
+
+1.  **RealTimeX Desktop**: インストールされ、実行されていること。これは AI 処理 (LLM) およびテキスト読み上げ (TTS) 機能に必要です。
+2.  **Supabase アカウント**: [supabase.com](https://supabase.com) の無料または有料アカウント。
+
+---
+
+## 🚀 セットアップウィザードによるクイックセットアップ
+
+内蔵の**セットアップウィザード**を使用するのが、最も推奨される開始方法です。技術的な重労働を自動化してくれます。
+
+### 1. 購入と起動
+*   **RealTimeX Desktop** を開きます。
+*   **Marketplace** タブ → **Local Apps** に移動します。
+*   **"Email Automator"** を検索して購入します（すでに所有している場合はアクティブ化します）。
+*   購入後、ローカルアプリリストから **Launch** (起動) をクリックします。
+
+### 2. セットアップウィザードの実行
+初回起動時に、アプリが初期設定をガイドします。
+
+*   **セットアップパスの選択**:
+    *   **マネージド・プロビジョニング (推奨)**: **Supabase アクセストークン**を提供します。ウィザードが自動的に新しいプロジェクトを作成し、データベースのマイグレーションを実行し、Edge Functions をデプロイし、初期ナレッジベースを取り込みます。
+    *   **既存のプロジェクトに接続**: **プロジェクト URL** と **Anon キー**を提供して、既存の 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)