@realtimex/email-automator 2.22.1 → 2.22.2

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

@@ -0,0 +1,160 @@
+# Glosario
+
+Definiciones de términos comunes utilizados en Email Automator y el Asistente de configuración.
+
+## Supabase
+Una plataforma backend que proporciona una base de datos Postgres alojada, autenticación, almacenamiento y APIs. Email Automator utiliza Supabase como su base de datos y capa de autenticación.
+
+## BYOK (Bring Your Own Key)
+Un modelo de configuración en el que conectas tu propio proyecto de Supabase en lugar de usar un backend compartido. Esto mantiene tus datos en tu propia infraestructura.
+
+## ID de proyecto de Supabase
+El identificador único de su proyecto de Supabase (a menudo se muestra en la URL del proyecto o en la configuración).
+
+## URL del proyecto de Supabase
+La URL base de su proyecto de Supabase, utilizada por la aplicación para conectarse a la base de datos y a las APIs.
+
+## Clave Anon (Clave API pública)
+La clave API pública de su proyecto de Supabase. Es segura para su uso en el lado del cliente, pero sigue estando sujeta a la Seguridad de Nivel de Fila (RLS).
+
+## Token de acceso
+Un token de su cuenta de Supabase que permite que el asistente de configuración cree o gestione proyectos en su nombre (utilizado en el Inicio rápido).
+
+## Aprovisionamiento gestionado (Inicio rápido)
+El asistente de configuración utiliza su token de acceso para crear automáticamente un proyecto de Supabase, aplicar migraciones, desplegar Edge Functions e ingerir la base de conocimientos.
+
+## Sincronización manual (Conectar proyecto existente)
+Usted conecta un proyecto de Supabase existente proporcionando la URL del proyecto y la clave Anon. El asistente puede ejecutar las migraciones si se proporciona un token de acceso.
+
+## Aprovisionamiento gestionado vs. Sincronización manual
+El **Aprovisionamiento gestionado** crea un nuevo proyecto de Supabase para usted utilizando un token de acceso.
+La **Sincronización manual** se conecta a un proyecto de Supabase existente utilizando su URL de proyecto y su clave Anon.
+
+## Migración
+Cambios en la base de datos que crean o actualizan tablas, vistas, funciones y políticas. Las migraciones mantienen el esquema de su base de datos alineado con la aplicación.
+
+## Esquema
+La estructura de su base de datos: tablas, columnas, tipos, índices, funciones y políticas.
+
+## SQL
+El lenguaje utilizado para definir y consultar estructuras de bases de datos y datos.
+
+## Desajuste de versión (Version Mismatch)
+Cuando la versión del esquema esperada por la aplicación difiere de la versión real de la base de datos. El asistente de configuración o la herramienta de migración le pedirán que normalice.
+
+## Versión de la base de datos (Configuración de la cuenta)
+La versión principal de la base de datos que se muestra en la Configuración de la cuenta. Se utiliza para guiar las migraciones y debe coincidir con la versión de Postgres de su proyecto de Supabase.
+
+## Rollback
+Revertir una migración. En Supabase, las reversiones son manuales y deben usarse con cuidado.
+
+## RLS (Row Level Security)
+Una característica de seguridad de Postgres que restringe qué filas puede leer o escribir un usuario. Supabase utiliza RLS para proteger los datos.
+
+## Edge Functions
+Funciones sin servidor alojadas por Supabase. Email Automator las utiliza para flujos de OAuth y operaciones seguras.
+
+## Clave Service Role
+Una potente clave de Supabase que omite RLS. Nunca debe exponerse a los clientes.
+
+## Clave Anon vs. Clave Service Role
+La **clave anon** es segura para el uso del cliente y respeta RLS. La **clave service role** omite RLS y solo debe usarse en servidores de confianza.
+
+## RealTimeX Desktop
+La aplicación local que proporciona servicios de IA (LLM, embeddings, TTS) utilizados por Email Automator.
+
+## Persona digital
+Un perfil que define su tono, estilo y preferencias para borradores y respuestas generados por IA.
+
+## Tono de la Persona
+El carácter emocional de las respuestas (por ejemplo, amigable, formal, directo).
+
+## Estilo de la Persona
+Las preferencias de estilo de escritura (por ejemplo, conciso, detallado, puntos clave).
+
+## Voz de la Persona
+El "sonido" general de su escritura, incluyendo el fraseo y el ritmo.
+
+## Firma de la Persona
+Un cierre estandarizado utilizado en las respuestas (nombre, cargo, empresa).
+
+## Rol de la Persona
+Su cargo o puesto de trabajo, utilizado para dar forma al encuadre de la respuesta.
+
+## Empresa de la Persona
+El nombre de la organización utilizado en las respuestas cuando sea apropiado.
+
+## Idioma de la Persona
+El idioma principal para los borradores generados.
+
+## API Express
+El backend local que maneja la sincronización de correos, el procesamiento de IA y la ejecución de la automatización.
+
+## Realtime (Supabase)
+Actualizaciones en vivo desde la base de datos a la aplicación. Se utiliza para reflejar nuevos correos electrónicos, el estado de la sincronización o la actividad sin refrescar la página.
+
+## LLM (Large Language Model)
+Un modelo de IA utilizado para el análisis y la generación de respuestas (por ejemplo, categorización, redacción de borradores).
+
+## Modelo de embedding
+Un modelo que convierte el texto en vectores para la búsqueda sémántica. Utilizado por la base de conocimientos y RAG.
+
+## Embeddings
+Representaciones vectoriales de texto utilizadas para la búsqueda sémántica en la base de conocimientos.
+
+## RAG (Retrieval-Augmented Generation)
+Un método que recupera la documentación relevante y la entrega a la IA para que las respuestas se mantengan basadas en sus documentos.
+
+## Ingestión de la base de conocimientos
+El proceso de convertir la documentación en embeddings consultables y almacenarlos en la base de datos.
+
+## TTS (Text-to-Speech)
+Convierte las respuestas de la IA en audio hablado (texto a voz).
+
+## Proveedor de TTS vs. Voz
+El proveedor es el servicio que genera el habla; la voz es el locutor/persona específico dentro de ese proveedor.
+
+## OAuth
+Un estándar de autorización que permite que la aplicación acceda a su cuenta de correo electrónico sin almacenar su contraseña.
+
+## Pantalla de consentimiento de OAuth
+La pantalla donde usted otorga permiso a Email Automator para acceder a su cuenta de correo electrónico.
+
+## Token de acceso (OAuth)
+Un token de corta duración utilizado para llamar a las APIs de los proveedores de correo electrónico. Caduca y se renueva automáticamente.
+
+## Token de actualización (Refresh Token)
+Un token de larga duración utilizado para obtener nuevos tokens de acceso sin volver a autenticarse.
+
+## API de Gmail
+La API oficial de Google para acceder a los datos de Gmail y enviar correos electrónicos.
+
+## Microsoft Graph
+La API de Microsoft para los datos de Outlook y Microsoft 365 (correo, calendario, contactos).
+
+## IMAP / SMTP
+Protocolos de correo electrónico. IMAP lee el correo; SMTP envía el correo. (Email Automator utiliza las APIs de los proveedores en lugar de IMAP/SMTP sin procesar).
+
+## Registro de aplicación (Microsoft)
+Una configuración de aplicación en Azure que proporciona credenciales para el acceso a Microsoft Graph.
+
+## ID de cliente (Client ID)
+El identificador público de su aplicación OAuth (Google/Microsoft).
+
+## Secreto de cliente (Client Secret)
+Un secreto privado para su aplicación OAuth. Trátelo como una contraseña.
+
+## URI de redireccionamiento
+La URL de retorno a la que el proveedor de correo electrónico envía a los usuarios después de la autorización de OAuth.
+
+## Flujo de código de dispositivo (Device Code Flow)
+Un flujo de OAuth en el que usted se autentica en un navegador utilizando un código corto, a menudo utilizado para aplicaciones de escritorio.
+
+## ID de inquilino (Tenant ID)
+El identificador de inquilino de Microsoft. Utilice "common" para multi-inquilino o un ID de inquilino específico para acceso exclusivo de la organización.
+
+## Alcance de sincronización
+Define cuánto historial sincronizar (por ejemplo, los últimos X días) y qué cuentas están incluidas.
+
+## Etiquetas (Gmail) / Carpetas (Outlook)
+Constructos de organización en los proveedores de correo electrónico. Las etiquetas marcan los mensajes; las carpetas los organizan en contenedores.

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

@@ -0,0 +1,65 @@
+# Solución de problemas y soporte
+
+Si encuentra problemas, esta guía cubre los obstáculos más comunes y sus soluciones.
+
+---
+
+## 📡 Problemas de sincronización
+
+### Los correos electrónicos no aparecen en el Panel de control
+*   **Compruebe la fecha "Sincronizar desde"**: La IA solo procesa los correos electrónicos recibidos *después* de esta fecha.
+*   **Restablecer punto de control (Reset Checkpoint)**: Si ha cambiado su fecha de inicio y desea volver a escanear correos antiguos, haga clic en el botón **Reset Checkpoint** en el panel de Alcance de sincronización.
+*   **Límites de lotes**: El ajuste **Máximo de correos** limita cuántos correos se procesan por ejecución. Si tiene un gran volumen acumulado, puede llevar varios ciclos de sincronización ponerse al día.
+*   **Activación manual**: Haga clic en **Run Sync Now** en el Panel de control para forzar una comprobación inmediata.
+
+### "Sync Failed" o "Backend Not Connected"
+*   **Servidor local**: Asegúrese de que la aplicación Email Automator esté abierta y en funcionamiento.
+*   **Flujo de actividad en vivo**: Abra la terminal **Live Activity**. A menudo contiene mensajes de error técnicos específicos (p. ej., "Network Error" o "401 Unauthorized").
+
+---
+
+## 🔑 Autenticación y permisos
+
+### Google/Gmail: `redirect_uri_mismatch`
+*   **La solución**: Su URI de redireccionamiento en Google Cloud Console debe coincidir *exactamente* con la que se muestra en Email Automator.
+*   **Ejemplo**: `https://tu-ref.supabase.co/functions/v1/auth-gmail/callback` (asegúrese de que no haya barras diagonales finales ni espacios).
+
+### Microsoft/Outlook: El inicio de sesión falla o agota el tiempo de espera
+*   **Registro de la aplicación**: Asegúrese de que su registro de aplicación de Azure tenga "Permitir flujos de clientes públicos" configurado en **Sí**.
+*   **Tipo de cuenta**: Asegúrese de haber seleccionado "Cuentas en cualquier directorio organizativo y cuentas personales de Microsoft" durante el registro.
+
+### Supabase: "Invalid API Key"
+*   **La solución**: Utilice siempre la clave **anon (public)**. La clave **service_role** será rechazada por la aplicación por razones de seguridad.
+
+---
+
+## 🤖 Integración de IA y RealTimeX
+
+### La IA es lenta o no responde
+*   **Modelos locales**: Si utiliza Ollama o LM Studio, asegúrese de que su máquina tenga suficiente RAM y que su GPU no esté bajo una carga pesada.
+*   **Descubrimiento**: Si no aparece ningún modelo en el menú desplegable, asegúrese de que **RealTimeX Desktop** esté funcionando y de haber configurado al menos un proveedor de IA en él.
+
+### No se están creando "Borradores inteligentes"
+*   **Interruptor del sistema**: Asegúrese de que **Smart Drafts** esté activado (**ON**) en la pestaña Auto-Pilot.
+*   **Conflicto de reglas**: Verifique que la regla que coincide con el correo electrónico incluya realmente la acción de **Borrador** (Draft).
+*   **Filtro de seguridad**: La IA omite automáticamente la creación de borradores para direcciones `no-reply` y ciertas notificaciones automatizadas para evitar "bucles de bots".
+
+---
+
+## 🗄️ Base de datos y migraciones
+
+### Banner "Se requiere migración de base de datos"
+*   **Por qué sucede**: Su aplicación local se ha actualizado y el esquema de su base de datos de Supabase debe actualizarse para admitir nuevas funciones.
+*   **La solución**: Haga clic en **Update Now** en el banner. Necesitará su **Token de acceso de Supabase** para ejecutar la actualización automáticamente.
+
+### La Terminal en vivo está vacía o muestra "404"
+*   **Permisos de Realtime**: Asegúrese de haber ejecutado las últimas migraciones. La tabla `processing_events` debe existir y tener habilitadas las políticas de RLS (Seguridad de Nivel de Fila) correctas.
+
+---
+
+## 🆘 ¿Aún necesita ayuda?
+
+Si su problema no aparece aquí:
+1.  Consulte los **Registros del sistema** (System Logs) en la Configuración de la cuenta para ver los rastreos técnicos.
+2.  Revise la [Documentación para desarrolladores](../docs-dev/README.md) para obtener detalles de configuración avanzada.
+3.  Abra un ticket o una discusión en el repositorio del proyecto.

package/docs/fr/README.md

@@ -0,0 +1,23 @@
+# Documentation Email Automator
+
+Bienvenue dans la documentation d'**Email Automator**, votre assistant e-mail personnel alimenté par l'IA. Cet outil fonctionne localement sur votre machine, garantissant la confidentialité de vos données tout en exploitant la puissance de l'IA pour organiser, prioriser et automatiser votre boîte de réception.
+
+## 📖 Guide de l'utilisateur
+
+Un guide complet pour configurer et maîtriser votre agent e-mail IA.
+
+1.  [**Commencer**](./user-guide/GETTING-STARTED.md) - Prérequis, installation et Assistant de configuration.
+2.  [**Configuration**](./user-guide/CONFIGURATION.md) - Connexion Gmail/Outlook (BYOK) et limites de synchronisation.
+3.  [**Tableau de bord**](./user-guide/DASHBOARD.md) - Surveillance de l'IA, Terminal en direct et Trace IA.
+4.  [**Auto-Pilot & Règles**](./user-guide/AUTOMATION.md) - Création de règles IA, ghostwriting et politiques de rétention.
+5.  [**Compte & Confidentialité**](./user-guide/ACCOUNT.md) - Gestion de votre persona, sécurité et souveraineté des données.
+6.  [**Dépannage & Support**](./user-guide/TROUBLESHOOTING.md) - Problèmes courants et solutions.
+7.  [**Glossaire**](./user-guide/GLOSSARY.md) - Termes courants et définitions.
+
+## 🚀 Fonctionnalités clés
+
+*   **Confidentialité d'abord** : Vos e-mails ne touchent jamais nos serveurs. Le traitement est local ou via vos propres clés IA.
+*   **Analyse intelligente** : Catégorisation automatique, analyse de sentiment et résumé.
+*   **IA "Boîte de Verre"** : Transparence totale via le Terminal en direct et les modaux Trace IA.
+*   **Auto-Pilot** : Gestion centralisée pour les règles "If This Then That" pilotées par l'IA.
+*   **Retour multi-sensoriel** : Indices audio et haptiques de haute qualité pour l'activité en arrière-plan.

package/docs/fr/marketplace/listing.md

@@ -0,0 +1,34 @@
+# Fiche Marketplace RealTimeX : Email Automator
+
+## Métadonnées
+- **Nom d'affichage** : Email Automator
+- **Description courte** : Une plateforme de gestion d'e-mails agentique, alimentée par l'IA, qui apprend à gérer votre boîte de réception. "Maîtrisez votre boîte" avec zéro coût cloud et une confidentialité totale.
+- **Mots-clés** : Productivité, E-mail, Automatisation, Agents IA, Confidentialité
+
+---
+
+## Description complète
+
+### 📧 Maîtrisez votre boîte de réception
+**Email Automator** est votre majordome personnel pour vos e-mails. Il ne se contente pas de filtrer les spams ; il traite votre boîte de réception comme une liste de tâches à gérer. En exploitant l'IA locale, il catégorise, priorise et rédige même des réponses pour vous — le tout sans que vos données ne quittent jamais votre contrôle.
+
+### 🚀 Fonctionnalités clés
+
+-   **Catégorisation intelligente** : L'IA classe automatiquement les e-mails entrants par catégories (Newsletter, Transactionnel, Social, etc.) et par priorités (Haute, Moyenne, Basse) en se basant sur les en-têtes et l'analyse du contenu.
+-   **Moteur Inbox Zero** : Définissez des règles d'automatisation comme "Archiver les newsletters après 7 jours" ou "Supprimer les spams immédiatement". Le moteur travaille sans relâche en arrière-plan pour garder votre boîte de réception propre.
+-   **Agent conscient du contexte** : Parlez à votre boîte de réception. Utilisez l'**Agent** pour passer en revue les brouillons par la voix ("Lis mes brouillons", "Envoie celui-là"), demander de l'aide pour la configuration ou obtenir des explications sur des règles complexes.
+-   **Réponses gagnantes** : Pour les e-mails importants, l'Auto-Pilot génère des brouillons de "Réponses gagnantes" — des réponses pré-rédigées qui capturent votre ton et votre intention, prêtes pour votre approbation.
+-   **Terminal en direct** : Regardez l'IA réfléchir. Le Terminal en direct intégré vous montre exactement ce que l'Agent analyse, décide et fait en temps réel.
+
+### 🛡️ Priorité à la confidentialité : Vos données, votre infrastructure
+Conçu selon la philosophie **"Possédez vos données"**.
+-   **Zéro coût Cloud** : Fonctionne entièrement sur votre propre instance Supabase (offre gratuite) et votre machine locale.
+-   **IA locale** : Utilise le **SDK RealTimeX** pour exploiter vos modèles locaux (ou vos clés API) en toute sécurité. Pas de dépendance vis-à-vis d'un fournisseur unique.
+
+### 🔌 Intégration transparente
+Conçu pour fonctionner aux côtés de **RealTimeX Desktop**. Il détecte automatiquement vos fournisseurs d'IA locaux et se synchronise via l'écosystème RealTimeX.
+
+---
+
+## Ressources visuelles
+- **Couverture paysage** : `../../images/cover-landscape.webp`

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

@@ -0,0 +1,52 @@
+# Compte et Confidentialité
+
+Gérez votre profil, votre persona IA et vos paramètres de sécurité dans la page **Paramètres du compte** (accessible via l'icône de profil en haut à droite).
+
+---
+
+## 👤 Profil et Expérience
+Personnalisez votre interaction avec l'application :
+*   **Identité** : Mettez à jour votre nom d'affichage et téléchargez un avatar personnalisé.
+*   **Retour sensoriel** : Activez ou désactivez les **Effets sonores** et le **Retour haptique** pour les activités en arrière-plan (comme l'analyse de nouveaux e-mails ou la fin de synchronisation).
+
+---
+
+## 🧬 Votre Persona IA
+Le **Persona** est le paramètre le plus critique pour obtenir des **Brouillons intelligents** de haute qualité. Il agit comme l'identité que l'IA utilise lors de la rédaction de réponses.
+
+*   **Rôle et Contexte** : Définissez votre titre professionnel et le secteur dans lequel vous travaillez.
+*   **Ton de voix** : Spécifiez comment vous souhaitez sonner (ex : "Professionnel mais amical", "Concis et direct").
+*   **Style de réponse** : Définissez vos préférences pour la longueur des réponses et l'utilisation de la signature.
+*   **Entités de confiance** : Listez les expéditeurs VIP et les domaines de confiance pour aider l'IA à prioriser correctement.
+
+---
+
+## 🗄️ Connexion Supabase (BYOK)
+Dans le cadre du modèle **"Bring Your Own Key"**, vous pouvez surveiller et gérer votre connexion à votre base de données dédiée :
+*   **Statut** : Visualisez l'URL de votre projet Supabase actuel et la version du schéma.
+*   **Centre de migration** : Vérifiez si le schéma de votre base de données est à jour.
+*   **Déconnexion** : Si vous devez changer de projet, vous pouvez effacer votre configuration ici (cela vous déconnectera et réinitialisera l'état local de l'application).
+
+---
+
+## 🔐 Sécurité
+*   **Gestion du mot de passe** : Mettez à jour le mot de passe de votre compte local à tout moment.
+*   **Chiffrement** : Tous les identifiants de fournisseur de messagerie (jetons Gmail/Outlook) sont chiffrés avant d'être stockés dans votre projet Supabase.
+
+---
+
+## 🛡️ Confidentialité et souveraineté des données
+Email Automator est conçu avec une architecture **priorisant la confidentialité**. Vos données sont réparties comme suit :
+
+| Type de donnée | Emplacement | Accès |
+| :--- | :--- | :--- |
+| **Métadonnées e-mail et journaux** | Votre projet Supabase | Privé pour vous |
+| **Fichiers e-mail bruts (.eml)** | Votre machine locale | Accès hors ligne uniquement |
+| **Pièces jointes aux règles** | Votre stockage Supabase | Privé pour vous |
+| **Traitement IA** | RealTimeX Desktop | Local / API direct |
+
+**Important** : Email Automator (l'entreprise) n'a jamais accès à vos e-mails, vos identifiants ou vos journaux d'IA. Tout reste au sein de votre propre infrastructure privée.
+
+---
+
+**Étape suivante :** [Dépannage et Support](./TROUBLESHOOTING.md)

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

@@ -0,0 +1,93 @@
+# Automatisation et Auto-Pilot
+
+L'onglet **Auto-Pilot** est le centre névralgique pour la gestion du comportement de votre agent IA. Il regroupe les "Règles Système" (interrupteurs globaux) et une bibliothèque de **26 règles intelligentes intégrées** ainsi que vos propres "Règles Personnalisées".
+
+---
+
+## 🛡️ Règles système intégrées
+
+Email Automator est livré avec 26 règles pré-configurées conçues par des experts en IA pour gérer les défis courants de la boîte de réception. Elles sont organisées en catégories fonctionnelles pour vous aider à rester organisé.
+
+### 📧 Organisation des e-mails
+*   **Newsletter Sweeper** : Archive automatiquement les newsletters et e-mails marketing pour garder votre boîte propre.
+*   **Receipt Organizer** : Classe automatiquement les reçus et confirmations de commande.
+*   **CC Organizer** : Étiquette les e-mails où vous êtes en copie (CC) pour un tri rapide.
+*   **Cold Outreach Filter** : Déplace les e-mails de vente non sollicités vers un dossier séparé.
+*   **Social Noise** : Minimise les notifications de LinkedIn et des réseaux sociaux.
+*   **Stack Overflow Digests** : Archive les résumés techniques à moins qu'ils ne nécessitent une attention immédiate.
+
+### 🚨 Priorité et alertes
+*   **VIP Urgent Messages** : Marque d'une étoile les messages urgents des parties prenantes clés (PDG, membres du conseil).
+*   **Critical Alerts** : Fait ressortir les incidents de production et les alertes critiques P0/P1.
+*   **Urgent Support Tickets** : Met en évidence les problèmes clients de haute priorité nécessitant une action immédiate.
+
+### 💻 Développement
+*   **GitHub Mentions** : Suit quand vous êtes spécifiquement mentionné dans des Pull Requests ou des Issues.
+*   **Échecs CI/CD** : Met en évidence les échecs de build et de déploiement d'outils comme CircleCI ou GitHub Actions.
+*   **Demandes de revue de code** : Organise les demandes entrantes pour les revues de code.
+*   **Bruit Dependabot** : Archive les mises à jour de dépendances de faible priorité tout en gardant les alertes de sécurité visibles.
+*   **Alertes de monitoring** : Organise les alertes de surveillance et de journalisation non urgentes.
+
+### 💼 Ventes et affaires
+*   **Hot Leads** : Priorise les réponses de prospects à fort intérêt basées sur un sentiment positif.
+*   **Rappels de suivi** : Suit les réponses des prospects qui demandent spécifiquement un suivi.
+*   **Referrals & Intros** : Garantit que vous ne manquez jamais une introduction ou une recommandation chaleureuse.
+*   **Contrats et propositions** : Met en évidence les communications contractuelles importantes et les documents juridiques.
+*   **Objections et préoccupations** : Signale les e-mails exprimant des préoccupations ou des hésitations pour un traitement attentif.
+*   **Nurture Campaigns** : Archive les e-mails de campagnes automatisées pour prioriser les réponses personnelles.
+*   **Mises à jour financières** : Garde les rapports de revenus et les mises à jour budgétaires trimestrielles facilement accessibles.
+
+### ⚙️ Opérations
+*   **Demandes internes** : Organise les demandes entre équipes et les éléments d'action.
+*   **Communications fournisseurs** : Suit les factures, les expéditions et les mises à jour liées aux fournisseurs.
+*   **Alertes système** : Organise les notifications d'infrastructure et de système.
+*   **Invitations aux réunions** : Sépare les invitations de calendrier pour une gestion plus facile de l'emploi du temps.
+*   **Rapports hebdomadaires** : Classe automatiquement les rapports de statut réguliers et les mises à jour de progression.
+
+---
+
+## 🛠️ Créer des règles personnalisées
+
+Les règles personnalisées vous permettent de créer des workflows précis pilotés par l'IA. Vous pouvez les créer, les éditer et les gérer directement dans l'onglet **Auto-Pilot**.
+
+### 1. Conditions (Le "Si")
+Vous pouvez combiner des métadonnées et des conditions basées sur l'IA :
+*   **Analyses IA** : Catégorie (ex: Newsletter, Reçu, Personnel), Sentiment (Positif, Négatif, Neutre) ou Priorité (Haute, Moyenne, Basse).
+*   **Métadonnées** : Domaine de l'expéditeur (ex: `github.com`), mots-clés spécifiques dans le sujet ou nom de l'expéditeur.
+*   **Filtre de rétention** : "N'agir que si l'e-mail a plus de X jours." C'est parfait pour nettoyer les vieilles newsletters ou notifications.
+
+### 2. Actions (Le "Alors")
+Choisissez ce qui se passe lorsqu'un e-mail correspond à vos conditions :
+*   **Archiver / Supprimer** : Gardez votre boîte propre automatiquement.
+*   **Suivre / Signaler** : Mettez en évidence les éléments importants pour une revue manuelle.
+*   **Brouillon** : L'action la plus puissante. Elle demande à l'IA de préparer une réponse.
+
+---
+
+## ✍️ Contexte intelligent et Ghostwriting
+
+Lorsque vous utilisez l'action **Brouillon**, vous pouvez fournir à l'IA des instructions spécifiques pour garantir que la réponse correspond à vos besoins :
+
+*   **Instructions de Ghostwriting** : Dites à l'IA *comment* répondre (ex: "Soyez poli mais ferme pour décliner l'invitation," ou "Demandez leurs disponibilités pour mardi prochain").
+*   **Pièces jointes aux règles** : Vous pouvez télécharger des documents standards (comme une fiche tarifaire ou une bio) que l'IA inclura automatiquement en tant que pièces jointes chaque fois que cette règle déclenche un brouillon.
+
+---
+
+## 🚀 L'onglet Auto-Pilot
+
+L'onglet **Auto-Pilot** offre une vue d'ensemble de votre moteur d'automatisation.
+*   **Vue groupée** : Les règles sont organisées par leur intention principale.
+*   **Interrupteurs rapides** : Activez ou désactivez les règles instantanément sans les supprimer.
+*   **Indicateurs de statut** : Voyez quelles règles sont actuellement actives et combien d'e-mails elles ont traités.
+
+---
+
+## 💡 Bonnes pratiques
+
+*   **Commencez passivement** : Configurez vos premières règles pour **Suivre** ou **Archiver** au lieu de **Supprimer** jusqu'à ce que vous soyez confiant dans la catégorisation de l'IA.
+*   **Utilisez la rétention pour le bruit** : Utilisez une règle comme : `Si Catégorie = Newsletter ET Âge > 30 Jours ALORS Supprimer`. Cela évite que vos newsletters "lues" n'encombrent votre archive pour toujours.
+*   **Affinez avec le feedback** : Si une règle ne correspond pas correctement, utilisez l'icône **Feedback** sur le Tableau de bord pour améliorer la compréhension de l'IA pour ce type d'e-mail spécifique.
+
+---
+
+**Étape suivante :** [Gestion du compte et de la sécurité](./ACCOUNT.md)

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

@@ -0,0 +1,61 @@
+# Configuration
+
+L'onglet **Configuration** est le centre de commande d'Email Automator. Ici, vous connectez vos fournisseurs de messagerie, définissez le comportement de votre IA et configurez les règles qui pilotent l'automatisation.
+
+---
+
+## 📧 Comptes e-mail (BYOK)
+
+Email Automator suit un modèle **"Bring Your Own Key" (BYOK)**. Vous fournissez vos propres identifiants OAuth, garantissant que l'accès à vos données reste entièrement sous votre contrôle.
+
+### 🔴 Configuration Gmail (OAuth 2.0)
+1.  **Google Cloud Console** : Créez un projet et activez l'**API Gmail**.
+2.  **Écran de consentement** : Configurez l'écran de consentement OAuth et ajoutez votre adresse e-mail en tant qu'**Utilisateur de test**.
+3.  **Identifiants** : Créez un **ID client OAuth 2.0** (Type : Application Web).
+    *   **URI de redirection autorisée** : `https://<votre-ref-projet>.supabase.co/functions/v1/auth-gmail/callback`
+4.  **Connecter** : Dans Email Automator, cliquez sur **Connect Gmail**.
+5.  **Autoriser** : Collez votre ID client et votre Secret (ou téléchargez le JSON), puis suivez le lien pour autoriser votre compte.
+
+### 🔵 Configuration Outlook (Code d'appareil)
+1.  **Portail Azure** : Enregistrez une nouvelle application dans **App Registrations** (Enregistrements d'applications).
+2.  **Type de compte** : Sélectionnez "Comptes dans n'importe quel annuaire organisationnel et comptes Microsoft personnels".
+3.  **Authentification** : Assurez-vous que "Autoriser les flux de clients publics" est défini sur **Oui**.
+4.  **Connecter** : Dans Email Automator, cliquez sur **Connect Outlook** et entrez votre **ID client**.
+5.  **Autoriser** : Suivez l'invite de **Code d'appareil** dans votre navigateur pour terminer la connexion.
+
+---
+
+## 📅 Portée et limites de synchronisation
+
+Avant de lancer votre première synchronisation, configurez les limites pour assurer la performance et l'efficacité des coûts :
+
+*   **Synchroniser depuis** : Choisissez la date de début (par exemple, "Depuis maintenant" ou une date historique spécifique).
+*   **E-mails max** : Définissez le nombre maximum d'e-mails à traiter dans un seul lot (Par défaut : 50).
+*   **Intervalle de synchronisation** : Définissez la fréquence à laquelle le planificateur en arrière-plan doit vérifier les nouveaux messages (par exemple, toutes les 15 minutes).
+
+> [!TIP]
+> **Commencez petit** : Pour votre premier lancement, nous vous recommandons de régler "Synchroniser depuis" sur "Maintenant" et "E-mails max" sur 10-20 pour vérifier que vos règles fonctionnent comme prévu.
+
+---
+
+## 🤖 Automatisation et Auto-Pilot
+
+La gestion du comportement de votre IA — y compris la création de règles personnalisées, l'activation des automatisations du système et la définition des politiques de rétention — a été consolidée dans l'onglet **[Auto-Pilot](./AUTOMATION.md)**.
+
+---
+
+## 🧠 Paramètres de l'IA et du système
+
+### Configuration du fournisseur
+Email Automator détecte les modèles disponibles via **RealTimeX Desktop**.
+*   **Fournisseur LLM** : Choisissez votre moteur d'IA préféré (par exemple, OpenAI, Anthropic ou des modèles locaux).
+*   **Modèle d'intégration** : Utilisé pour le système RAG (Génération augmentée par récupération) pour aider l'IA à comprendre votre contexte spécifique.
+
+### Voix et Accessibilité (TTS)
+Activez la **synthèse vocale** (TTS) pour que l'IA lise à haute voix les résumés ou les alertes importantes.
+*   **Lecture automatique** : Lit automatiquement les notifications de haute priorité.
+*   **Profil de voix** : Choisissez parmi diverses voix de haute qualité disponibles via RealTimeX.
+
+---
+
+**Étape suivante :** [Surveillance du tableau de bord](./DASHBOARD.md)

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

@@ -0,0 +1,71 @@
+# Tableau de bord et activité en direct
+
+Le **Tableau de bord** est votre interface principale pour surveiller l'activité de votre agent IA et gérer votre boîte de réception analysée. Il est conçu pour offrir une transparence totale sur la façon dont l'IA pense et agit.
+
+---
+
+## 📊 Le flux d'analyse
+
+À mesure que l'IA traite votre boîte de réception, les e-mails apparaissent dans le flux avec des mises à jour de statut en temps réel et des informations intelligentes.
+
+*   **Recherche intelligente** : Trouvez rapidement des e-mails par mot-clé ou par expéditeur.
+*   **Filtres IA** : Filtrez votre vue par catégorie (par exemple, Newsletter, Personnel), sentiment ou priorité.
+*   **Tri dynamique** : Basculez entre l'heure de *réception* de l'e-mail et l'heure à laquelle il a été *traité* par l'IA.
+
+### 📌 Volet latéral des détails de l'e-mail
+Cliquer sur une carte d'e-mail ouvre un panneau latéral détaillé contenant :
+*   **Résumé IA** : Un aperçu concis du contenu de l'e-mail.
+*   **Points clés** : Les points forts extraits par l'IA.
+*   **Aperçu du brouillon** : Si une réponse a été générée, vous pouvez la consulter ici avant qu'elle ne soit envoyée.
+*   **Liens rapides** : Accédez directement à l'e-mail original dans votre interface web Gmail ou Outlook.
+
+---
+
+## 🛡️ Confiance et Transparence
+
+Email Automator repose sur le principe de l'**"IA Boîte de Verre"**. Vous devriez toujours savoir *pourquoi* une action a été entreprise.
+
+### 📟 Terminal d'activité en direct
+Cliquez sur le bouton **Live Activity** (Activité en direct) dans le coin inférieur droit pour ouvrir le flux de traitement en temps réel.
+*   **Journaux de réflexion** : Observez l'IA analyser le contenu, évaluer les règles et décider des actions.
+*   **Détails techniques** : Consultez les appels API bruts, les durées de traitement et les statuts de synchronisation en arrière-plan.
+*   **Contrôle** : Vous pouvez arrêter manuellement une synchronisation active directement depuis le terminal.
+
+### 🕵️ Trace IA (AI Trace)
+Cliquez sur l'**icône Œil** sur n'importe quelle carte d'e-mail pour ouvrir le **Modal Trace IA**.
+*   **Logique de décision** : Consultez une décomposition étape par étape de la raison pour laquelle l'IA a attribué une catégorie ou une priorité spécifique.
+*   **Données brutes** : Visualisez le prompt exact envoyé au LLM et la réponse JSON brute qu'il a retournée.
+*   **Stats de performance** : Consultez l'utilisation des jetons et le temps de traitement pour cet e-mail spécifique.
+
+---
+
+## ⚡ Actions rapides
+
+Prenez le contrôle avec des actions en un clic disponibles sur chaque carte d'e-mail :
+*   🗑️ **Supprimer / 📦 Archiver** : Nettoyage instantané.
+*   ⭐ **Suivre / Signaler** : Marquez les éléments importants pour plus tard.
+*   🔄 **Retraiter** : Si vous avez mis à jour vos règles, vous pouvez demander à l'IA d'analyser à nouveau un e-mail.
+*   💬 **Feedback** : Aidez l'IA à apprendre en signalant les erreurs de catégorisation ou d'analyse de sentiment.
+
+---
+
+## 🔔 Notifications et retours
+
+L'application utilise un retour multi-sensoriel pour vous tenir informé de l'activité en arrière-plan :
+*   **Visual** : Badges de statut en direct et notifications toast.
+*   **Audio** : Carillons subtils de haute qualité pour les nouveaux e-mails, les alertes de haute priorité et la fin de synchronisation.
+*   **Haptique** : Retour physique sur les appareils compatibles.
+
+> **Note** : Les paramètres sonores et haptiques peuvent être personnalisés dans les [**Paramètres du compte**](./ACCOUNT.md).
+
+---
+
+## 📈 Analyses et historique
+
+Restez informé des performances de votre agent :
+*   **Historique de synchronisation** : Consultez un journal des cycles de synchronisation récents, incluant le nombre d'e-mails traités et les actions entreprises.
+*   **Stats d'efficacité** : Visualisez le total des suppressions, archivages et brouillons automatisés au fil du temps.
+
+---
+
+**Étape suivante :** [Création de règles d'automatisation](./AUTOMATION.md)

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

@@ -0,0 +1,61 @@
+# Commencer
+
+Bienvenue dans **Email Automator**, votre assistant e-mail personnel alimenté par l'IA. Ce guide vous aidera à configurer l'application en utilisant le modèle **"Bring Your Own Key" (BYOK)**, qui garantit que vos données restent sous votre contrôle au sein de votre propre infrastructure Supabase.
+
+## 🛠 Prérequis
+
+Avant de commencer, assurez-vous d'avoir les éléments suivants :
+
+1.  **RealTimeX Desktop** : Installé et en cours d'exécution. Ceci est requis pour le traitement de l'IA (LLM) et les capacités de synthèse vocale (TTS).
+2.  **Compte Supabase** : Un compte gratuit ou payant sur [supabase.com](https://supabase.com).
+
+---
+
+## 🚀 Configuration rapide avec l'Assistant
+
+L'**Assistant de configuration** intégré est le moyen recommandé pour commencer. Il automatise les tâches techniques complexes.
+
+### 1. Achat et Lancement
+*   Ouvrez **RealTimeX Desktop**.
+*   Allez dans l'onglet **Marketplace** → **Local Apps**.
+*   Recherchez **"Email Automator"** et achetez-le (ou activez-le s'il est déjà possédé).
+*   Une fois acheté, cliquez sur **Launch** (Lancer) depuis votre liste d'applications locales.
+
+### 2. Exécuter l'Assistant de configuration
+Lors du premier lancement, l'application vous guidera à travers la configuration initiale :
+
+*   **Choisir un chemin de configuration** :
+    *   **Provisionnement géré (Recommandé)** : Fournissez un **Jeton d'accès Supabase**. L'assistant créera automatiquement un nouveau projet, exécutera les migrations de base de données, déploiera les Edge Functions et intégrera la base de connaissances initiale.
+    *   **Connecter un projet existant** : Utilisez un projet Supabase existant en fournissant votre **URL de projet** et votre **Clé Anon**. Vous pouvez optionnellement fournir un jeton d'accès ici pour que l'assistant exécute les migrations pour vous.
+
+### 3. Créer votre compte
+Une fois que la base de données est prête, vous serez invité à créer votre compte utilisateur local et à vous connecter pour accéder au **Tableau de bord**.
+
+---
+
+## 🔍 Trouver vos identifiants Supabase
+
+Si vous choisissez de connecter un projet existant manuellement, vous pouvez trouver vos identifiants dans le [Tableau de bord Supabase](https://supabase.com/dashboard) :
+
+1.  Sélectionnez votre projet.
+2.  Naviguez vers **Settings** (Paramètres) → **API**.
+3.  **URL de projet** : Copiez l'URL trouvée sous "Project URL".
+4.  **Clé API** : Copiez la clé **anon (public)** sous "Project API keys".
+
+> [!WARNING]
+> **Note de sécurité** : N'utilisez jamais la clé `service_role`. Elle possède des privilèges d'administration complets et ne doit jamais être exposée dans des applications côté client.
+
+---
+
+## 🪪 Générer un jeton d'accès
+
+Un jeton d'accès permet à l'Assistant de configuration de gérer vos projets Supabase (création, migrations, déploiement de fonctions) en votre nom.
+
+1.  Dans votre tableau de bord Supabase, allez dans **Account** (Compte) → **Access Tokens** (Jetons d'accès).
+2.  Cliquez sur **Generate new token**, donnez-lui un nom (par exemple, "Email Automator"), et copiez le résultat.
+3.  Collez ce jeton dans l'Assistant de configuration lorsque vous y êtes invité.
+
+---
+
+**Étape suivante :** [Configurez vos comptes e-mail](./CONFIGURATION.md)  
+**Glossaire :** [Termes courants](./GLOSSARY.md)