@realtimex/email-automator 2.22.1 → 2.22.2

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

@@ -0,0 +1,163 @@
+# Glossary
+
+Definitions of common terms used in Email Automator and the Setup Wizard.
+
+## Supabase
+A backend platform that provides a hosted Postgres database, authentication, storage, and APIs. Email Automator uses Supabase as its database and auth layer.
+
+## BYOK (Bring Your Own Key)
+A setup model where you connect your own Supabase project instead of using a shared backend. This keeps your data in your own infrastructure.
+
+## Supabase Project ID
+The unique identifier for your Supabase project (often shown in the project URL or settings).
+
+## Supabase Project URL
+The base URL for your Supabase project, used by the app to connect to the database and APIs.
+
+## Anon Key (Public API Key)
+The public API key for your Supabase project. It is safe for client-side use but still subject to Row Level Security (RLS).
+
+## Access Token
+A token from your Supabase account that lets the Setup Wizard create or manage projects on your behalf (used in Quick Start).
+
+## Managed Provisioning (Quick Start)
+The Setup Wizard uses your Access Token to automatically create a Supabase project, apply migrations, deploy Edge Functions, and ingest the knowledge base.
+
+## Manual Sync (Connect Existing Project)
+You connect an existing Supabase project by providing the Project URL and Anon Key. Migrations can be run by the wizard if an Access Token is provided.
+
+## Managed Provisioning vs Manual Sync
+**Managed Provisioning** creates a new Supabase project for you using an Access Token.  
+**Manual Sync** connects to an existing Supabase project using your Project URL and Anon Key.
+
+## Migration
+Database changes that create or update tables, views, functions, and policies. Migrations keep your database schema aligned with the app.
+
+## Schema
+The structure of your database: tables, columns, types, indexes, functions, and policies.
+
+## SQL
+The language used to define and query database structures and data.
+
+## Version Mismatch
+When the app’s expected schema version differs from the database’s actual version. The Setup Wizard or migration tool will prompt you to normalize.
+
+## Database Version (Account Settings)
+The database major version shown in Account Settings. It’s used to guide migrations and should match your Supabase project’s Postgres version.
+
+## Rollback
+Reverting a migration. In Supabase, rollbacks are manual and should be used carefully.
+
+## RLS (Row Level Security)
+A Postgres security feature that restricts which rows a user can read or write. Supabase uses RLS to protect data.
+
+## Edge Functions
+Serverless functions hosted by Supabase. Email Automator uses them for OAuth flows and secure operations.
+
+## Service Role Key
+A powerful Supabase key that bypasses RLS. It must never be exposed to clients.
+
+## Anon Key vs Service Role Key
+The **anon key** is safe for client use and respects RLS. The **service role key** bypasses RLS and must only be used on trusted servers.
+
+## RealTimeX Desktop
+The local app that provides AI services (LLMs, embeddings, TTS) used by Email Automator.
+
+## Digital Persona
+A profile that defines your tone, style, and preferences for AI-generated drafts and responses.
+
+## Persona Tone
+The emotional character of replies (e.g., friendly, formal, direct).
+
+## Persona Style
+The writing style preferences (e.g., concise, detailed, bullet points).
+
+## Persona Voice
+The overall “sound” of your writing, including phrasing and rhythm.
+
+## Persona Signature
+A standardized sign-off used in replies (name, title, company).
+
+## Persona Role
+Your job title or role, used to shape response framing.
+
+## Persona Company
+The organization name used in replies when appropriate.
+
+## Persona Language
+The primary language for generated drafts.
+
+## Edge Functions
+Serverless functions hosted by Supabase. Email Automator uses them for OAuth flows and secure operations.
+
+## Express API
+The local backend that handles email syncing, AI processing, and automation execution.
+
+## Realtime (Supabase)
+Live updates from the database to the app. Used to reflect new emails, sync status, or activity without refreshing.
+
+## LLM (Large Language Model)
+An AI model used for analysis and generating responses (e.g., categorization, drafting replies).
+
+## Embedding Model
+A model that converts text into vectors for semantic search. Used by the knowledge base and RAG.
+
+## Embeddings
+Vector representations of text used for semantic search in the knowledge base.
+
+## RAG (Retrieval-Augmented Generation)
+A method that retrieves relevant documentation and feeds it to the AI so responses stay grounded in your docs.
+
+## Knowledge Base Ingestion
+The process of converting documentation into searchable embeddings and storing them in the database.
+
+## TTS (Text-to-Speech)
+Converts AI responses into spoken audio.
+
+## TTS Provider vs Voice
+The provider is the service that generates speech; the voice is the specific speaker/persona within that provider.
+
+## OAuth
+An authorization standard that lets the app access your email account without storing your password.
+
+## OAuth Consent Screen
+The screen where you grant Email Automator permission to access your email account.
+
+## Access Token (OAuth)
+A short-lived token used to call email provider APIs. It expires and is refreshed automatically.
+
+## Refresh Token
+A long-lived token used to obtain new access tokens without re‑authenticating.
+
+## Gmail API
+Google’s official API for accessing Gmail data and sending emails.
+
+## Microsoft Graph
+Microsoft’s API for Outlook and Microsoft 365 data (mail, calendar, contacts).
+
+## IMAP / SMTP
+Email protocols. IMAP reads mail; SMTP sends mail. (Email Automator uses provider APIs rather than raw IMAP/SMTP.)
+
+## App Registration (Microsoft)
+An app configuration in Azure that provides credentials for Microsoft Graph access.
+
+## Client ID
+The public identifier for your OAuth app (Google/Microsoft).
+
+## Client Secret
+A private secret for your OAuth app. Treat it like a password.
+
+## Redirect URI
+The callback URL where the email provider sends users after OAuth authorization.
+
+## Device Code Flow
+An OAuth flow where you authenticate in a browser using a short code, often used for desktop apps.
+
+## Tenant ID
+The Microsoft tenant identifier. Use “common” for multi‑tenant or a specific tenant for org‑only access.
+
+## Sync Scope
+Defines how much history to sync (e.g., last X days) and which accounts are included.
+
+## Labels (Gmail) / Folders (Outlook)
+Organization constructs in email providers. Labels tag messages; folders organize them into containers.

package/docs/es/README.md

@@ -0,0 +1,23 @@
+# Documentación de Email Automator
+
+Bienvenido a la documentación de **Email Automator**, su asistente de correo electrónico personal impulsado por IA. Esta herramienta se ejecuta localmente en su máquina, garantizando que sus datos permanezcan privados mientras aprovecha el poder de la IA para organizar, priorizar y automatizar su bandeja de entrada.
+
+## 📖 Guía del usuario
+
+Una guía completa para configurar y dominar su agente de correo electrónico con IA.
+
+1.  [**Primeros pasos**](./user-guide/GETTING-STARTED.md) - Requisitos previos, instalación y el Asistente de configuración.
+2.  [**Configuración**](./user-guide/CONFIGURATION.md) - Conexión de Gmail/Outlook (BYOK) y límites de sincronización.
+3.  [**Panel de control y actividad en vivo**](./user-guide/DASHBOARD.md) - Monitoreo de la IA, Terminal en vivo y Traza de IA.
+4.  [**Auto-Pilot y reglas**](./user-guide/AUTOMATION.md) - Creación de reglas impulsadas por IA, redacción fantasma y políticas de retención.
+5.  [**Cuenta y privacidad**](./user-guide/ACCOUNT.md) - Gestión de su persona, seguridad y soberanía de datos.
+6.  [**Solución de problemas y soporte**](./user-guide/TROUBLESHOOTING.md) - Problemas comunes y cómo resolverlos.
+7.  [**Glosario**](./user-guide/GLOSSARY.md) - Términos comunes y definiciones.
+
+## 🚀 Características clave
+
+*   **Privacidad primero**: Sus correos electrónicos nunca tocan nuestros servidores. El procesamiento es local o a través de sus propias claves de IA.
+*   **Análisis inteligente**: Categorización automática, análisis de sentimientos y resumen.
+*   **IA de "Caja de cristal"**: Transparencia total a través de la Terminal en vivo y los modales de Traza de IA.
+*   **Auto-Pilot**: Gestión centralizada para reglas "Si sucede esto, entonces haz aquello" impulsadas por IA.
+*   **Retroalimentación multisensorial**: Señales de audio y hápticas de alta calidad para la actividad en segundo plano.

package/docs/es/marketplace/listing.md

@@ -0,0 +1,34 @@
+# Ficha del Marketplace RealTimeX: Email Automator
+
+## Metadatos
+- **Nombre visible**: Email Automator
+- **Descripción corta**: Una plataforma de gestión de correo electrónico agéntica impulsada por IA que aprende a manejar su bandeja de entrada. "Sea dueño de su bandeja de entrada" con cero costos de nube y total privacidad.
+- **Etiquetas**: Productividad, Correo electrónico, Automatización, Agentes de IA, Privacidad
+
+---
+
+## Descripción completa
+
+### 📧 Sea dueño de su bandeja de entrada
+**Email Automator** es su mayordomo personal de correo electrónico. No solo filtra el spam; trata su bandeja de entrada como una lista de tareas que necesita ser gestionada. Al aprovechar la IA local, categoriza, prioriza e incluso redacta respuestas por usted, todo sin que sus datos salgan de su control.
+
+### 🚀 Características clave
+
+-   **Categorización inteligente**: La IA clasifica automáticamente los correos electrónicos entrantes en categorías (Boletines, Transaccionales, Sociales, etc.) y prioridades (Alta, Media, Baja) basándose en los encabezados visuales y el análisis de contenido.
+-   **Motor Inbox Zero**: Defina reglas de automatización como "Archivar boletines después de 7 días" o "Eliminar spam inmediatamente". El motor trabaja incansablemente en segundo plano para mantener limpia su bandeja de entrada.
+-   **Agente consciente del contexto**: Hable con su bandeja de entrada. Use el **Agente** para revisar borradores mediante voz ("Lee mis borradores", "Envía este"), pida ayuda con la configuración o reciba explicaciones sobre reglas complejas.
+-   **Respuestas ganadoras**: Para correos electrónicos importantes, el Auto-Pilot genera borradores de "Respuestas ganadoras": respuestas preescritas que capturan su tono e intención, listas para su aprobación.
+-   **Terminal en vivo**: Observe cómo piensa la IA. El Terminal en vivo integrado le muestra exactamente qué está analizando, decidiendo y haciendo el Agente en tiempo real.
+
+### 🛡️ Privacidad primero: sus datos, su infraestructura
+Construido bajo la filosofía **"Sea dueño de sus datos"**.
+-   **Cero costos de nube**: Funciona completamente en su propia instancia gratuita de Supabase y en su máquina local.
+-   **IA local**: Utiliza el **SDK de RealTimeX** para conectarse a sus modelos locales (o claves API) de forma segura. Sin dependencia de proveedores.
+
+### 🔌 Integración fluida
+Diseñado para funcionar junto a **RealTimeX Desktop**. Detecta sus proveedores de IA locales automáticamente y se sincroniza a través del ecosistema RealTimeX.
+
+---
+
+## Activos visuales
+- **Portada horizontal**: `../../images/cover-landscape.webp`

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

@@ -0,0 +1,52 @@
+# Cuenta y Privacidad
+
+Gestione su perfil, su persona de IA y la configuración de seguridad dentro de la página **Configuración de la cuenta** (se accede a través del icono de perfil en la esquina superior derecha).
+
+---
+
+## 👤 Perfil y Experiencia
+Personalice su interacción con la aplicación:
+*   **Identidad**: Actualice su nombre de pantalla y cargue un avatar personalizado.
+*   **Retroalimentación sensorial**: Active o desactive los **Efectos de sonido** y la **Retroalimentación háptica** para actividades en segundo plano (como el análisis de nuevos correos o la finalización de la sincronización).
+
+---
+
+## 🧬 Su Persona de IA
+La **Persona** es el ajuste más crítico para obtener **Borradores inteligentes** de alta calidad. Actúa como la "Identidad" que la IA utiliza al redactar respuestas.
+
+*   **Rol y contexto**: Defina su título profesional y la industria en la que trabaja.
+*   **Tono de voz**: Especifique cómo desea sonar (por ejemplo, "Profesional pero amigable", "Conciso y directo").
+*   **Estilo de respuesta**: Establezca preferencias para la longitud de la respuesta y el uso de la firma.
+*   **Entidades de confianza**: Enumere remitentes VIP y dominios de confianza para ayudar a la IA a priorizar correctamente.
+
+---
+
+## 🗄️ Conexión con Supabase (BYOK)
+Como parte del modelo **"Bring Your Own Key"**, puede monitorear y gestionar su conexión a su base de datos dedicada:
+*   **Estado**: Vea la URL de su proyecto de Supabase actual y la versión del esquema.
+*   **Centro de migración**: Compruebe si el esquema de su base de datos está actualizado.
+*   **Desconectar**: Si necesita cambiar de proyecto, puede borrar su configuración aquí (esto cerrará su sesión y restablecerá el estado de la aplicación local).
+
+---
+
+## 🔐 Seguridad
+*   **Gestión de contraseñas**: Actualice la contraseña de su cuenta local en cualquier momento.
+*   **Cifrado**: Todas las credenciales del proveedor de correo electrónico (tokens de Gmail/Outlook) se cifran antes de almacenarse en su proyecto de Supabase.
+
+---
+
+## 🛡️ Privacidad y soberanía de datos
+Email Automator está diseñado con una arquitectura que **prioriza la privacidad**. Sus datos se distribuyen de la siguiente manera:
+
+| Tipo de dato | Ubicación | Acceso |
+| :--- | :--- | :--- |
+| **Metadatos de correo y registros** | Su proyecto de Supabase | Privado para usted |
+| **Archivos de correo sin procesar (.eml)** | Su máquina local | Solo acceso fuera de línea |
+| **Adjuntos de reglas** | Su almacenamiento de Supabase | Privado para usted |
+| **Procesamiento de IA** | RealTimeX Desktop | Local/API directa |
+
+**Importante**: Email Automator (la empresa) nunca tiene acceso a sus correos electrónicos, sus credenciales o sus registros de IA. Todo permanece dentro de su propia infraestructura privada.
+
+---
+
+**Siguiente paso:** [Solución de problemas y soporte](./TROUBLESHOOTING.md)

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

@@ -0,0 +1,93 @@
+# Automatización y Auto-Pilot
+
+La pestaña **Auto-Pilot** es el centro neurálgico para gestionar el comportamiento de su agente de IA. Consolida las "Reglas del sistema" (interruptores globales) y una biblioteca de **26 reglas inteligentes integradas** junto con sus propias "Reglas personalizadas".
+
+---
+
+## 🛡️ Reglas integradas del sistema
+
+Email Automator viene con 26 reglas preconfiguradas diseñadas por expertos en IA para manejar los desafíos comunes de la bandeja de entrada. Estas se organizan en categorías funcionales para ayudarlo a mantenerse organizado.
+
+### 📧 Organización del correo electrónico
+*   **Newsletter Sweeper**: Archiva automáticamente boletines y correos de marketing para mantener limpia su bandeja de entrada.
+*   **Receipt Organizer**: Clasifica automáticamente recibos y confirmaciones de pedidos.
+*   **CC Organizer**: Etiqueta correos electrónicos donde está en copia (CC) para un triaje rápido.
+*   **Cold Outreach Filter**: Mueve los correos de ventas fríos a una carpeta separada.
+*   **Social Noise**: Minimiza las notificaciones de LinkedIn y redes sociales.
+*   **Stack Overflow Digests**: Archiva automáticamente resúmenes técnicos a menos que requieran atención inmediata.
+
+### 🚨 Prioridad y alertas
+*   **VIP Urgent Messages**: Destaca mensajes urgentes de partes interesadas clave (CEOs, miembros de la junta).
+*   **Critical Alerts**: Saca a la superficie incidentes de producción y alertas críticas P0/P1.
+*   **Urgent Support Tickets**: Resalta problemas de clientes de alta prioridad que necesitan acción inmediata.
+
+### 💻 Desarrollo
+*   **GitHub Mentions**: Rastrea cuando se le menciona específicamente en Pull Requests o Issues.
+*   **CI/CD Failures**: Resalta fallos de compilación y despliegue de herramientas como CircleCI o GitHub Actions.
+*   **Code Review Requests**: Organiza las solicitudes entrantes para revisiones de código.
+*   **Dependabot Noise**: Archiva automáticamente actualizaciones de dependencias de baja prioridad mientras mantiene visibles las alertas de seguridad.
+*   **Monitoring Alerts**: Organiza alertas de monitoreo y registro no urgentes.
+
+### 💼 Ventas y negocios
+*   **Hot Leads**: Prioriza respuestas de prospectos con alta intención basadas en sentimientos positivos.
+*   **Follow-up Reminders**: Rastrea respuestas de prospectos que solicitan específicamente un seguimiento.
+*   **Referrals & Intros**: Asegura que nunca se pierda una introducción o referencia cálida.
+*   **Contracts & Proposals**: Resalta comunicaciones contractuales importantes y documentos legales.
+*   **Objections & Concerns**: Marca correos electrónicos que expresan inquietudes o dudas para un manejo cuidadoso.
+*   **Nurture Campaigns**: Archiva correos de campañas de goteo automatizadas para priorizar respuestas personales.
+*   **Financial Updates**: Mantiene fácilmente accesibles los informes de ingresos y las actualizaciones presupuestarias trimestrales.
+
+### ⚙️ Operaciones
+*   **Internal Requests**: Organiza solicitudes entre equipos y elementos de acción.
+*   **Vendor Communications**: Rastrea facturas, envíos y actualizaciones relacionadas con proveedores.
+*   **System Alerts**: Organiza notificaciones de infraestructura y del sistema.
+*   **Meeting Invites**: Separa las invitaciones de calendario para una gestión más fácil de la programación.
+*   **Weekly Reports**: Clasifica automáticamente informes de estado regulares y actualizaciones de progreso.
+
+---
+
+## 🛠️ Creación de reglas personalizadas
+
+Las reglas personalizadas le permiten crear flujos de trabajo precisos impulsados por la IA. Puede crear, editar y gestionar estas directamente en la pestaña **Auto-Pilot**.
+
+### 1. Condiciones (El "Si")
+Puede combinar metadatos y condiciones impulsadas por la IA:
+*   **Información de IA**: Categoría (p. ej., Newsletter, Recibo, Personal), Sentimiento (Positivo, Negativo, Neutral) o Prioridad (Alta, Media, Baja).
+*   **Metadatos**: Dominio del remitente (p. ej., `github.com`), palabras clave específicas en el asunto o nombre del remitente.
+*   **Filtro de retención**: "Solo actuar si el correo electrónico es más antiguo que X días". Esto es perfecto para limpiar boletines o notificaciones antiguas.
+
+### 2. Acciones (El "Entonces")
+Elija qué sucede cuando un correo electrónico coincide con sus condiciones:
+*   **Archivar / Eliminar**: Mantenga limpia su bandeja de entrada automáticamente.
+*   **Destacar / Marcar**: Resalte elementos importantes para revisión manual.
+*   **Borrador**: La acción más poderosa. Le dice a la IA que prepare una respuesta.
+
+---
+
+## ✍️ Contexto inteligente y Ghostwriting
+
+Cuando utiliza la acción de **Borrador**, puede proporcionar a la IA instrucciones específicas para asegurar que la respuesta satisfaga sus necesidades:
+
+*   **Instrucciones de Ghostwriting**: Dígale a la IA *cómo* responder (p. ej., "Sea amable pero firme al rechazar la invitación" o "Pregunte por su disponibilidad el próximo martes").
+*   **Adjuntos de reglas**: Puede cargar documentos estándar (como una lista de precios o una biografía) que la IA incluirá automáticamente como adjuntos cada vez que esta regla active un borrador.
+
+---
+
+## 🚀 La pestaña Auto-Pilot
+
+La pestaña **Auto-Pilot** proporciona una vista panorámica de su motor de automatización.
+*   **Vista agrupada**: Las reglas se organizan por su intención principal.
+*   **Interruptores rápidos**: Habilite o deshabilite reglas instantáneamente sin eliminarlas.
+*   **Indicadores de estado**: Vea qué reglas están activas actualmente y cuántos correos electrónicos han procesado.
+
+---
+
+## 💡 Mejores prácticas
+
+*   **Comience de forma pasiva**: Configure sus primeras reglas para **Destacar** o **Archivar** en lugar de **Eliminar** hasta que confíe en la categorización de la IA.
+*   **Use la retención para el ruido**: Use una regla como: `Si Categoría = Newsletter Y Antigüedad > 30 Días ENTONCES Eliminar`. Esto evita que sus boletines "leídos" saturen su archivo para siempre.
+*   **Refine con comentarios**: Si una regla no coincide correctamente, use el icono de **Comentarios** en el Panel de control para mejorar la comprensión de la IA de ese tipo específico de correo electrónico.
+
+---
+
+**Siguiente paso:** [Gestión de cuenta y seguridad](./ACCOUNT.md)

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

@@ -0,0 +1,61 @@
+# Configuración
+
+La pestaña **Configuración** es el centro de mando de Email Automator. Aquí, conectará a sus proveedores de correo electrónico, definirá el comportamiento de su IA y configurará las reglas que impulsan la automatización.
+
+---
+
+## 📧 Cuentas de correo electrónico (BYOK)
+
+Email Automator sigue un modelo **"Bring Your Own Key" (BYOK)**. Usted proporciona sus propias credenciales de OAuth, garantizando que el acceso a sus datos permanezca totalmente bajo su control.
+
+### 🔴 Configuración de Gmail (OAuth 2.0)
+1.  **Google Cloud Console**: Cree un proyecto y habilite la **API de Gmail**.
+2.  **Pantalla de consentimiento**: Configure la pantalla de consentimiento de OAuth y agregue su correo electrónico como **Usuario de prueba**.
+3.  **Credenciales**: Cree un **ID de cliente de OAuth 2.0** (Tipo: Aplicación web).
+    *   **URI de redireccionamiento autorizada**: `https://<vuestra-ref-proyecto>.supabase.co/functions/v1/auth-gmail/callback`
+4.  **Conectar**: En Email Automator, haga clic en **Connect Gmail**.
+5.  **Autorizar**: Pegue su ID de cliente y el Secreto (o cargue el JSON), luego siga el enlace para autorizar su cuenta.
+
+### 🔵 Configuración de Outlook (Código de dispositivo)
+1.  **Portal de Azure**: Registre una nueva aplicación en **App Registrations** (Registros de aplicaciones).
+2.  **Tipo de cuenta**: Seleccione "Cuentas en cualquier directorio organizativo y cuentas personales de Microsoft".
+3.  **Autenticación**: Asegúrese de que "Permitir flujos de clientes públicos" esté configurado en **Sí**.
+4.  **Conectar**: En Email Automator, haga clic en **Connect Outlook** e introduzca su **ID de cliente**.
+5.  **Autorizar**: Siga el aviso de **Código de dispositivo** en su navegador para completar el inicio de sesión.
+
+---
+
+## 📅 Alcance y límites de sincronización
+
+Antes de iniciar su primera sincronización, configure los límites para garantizar el rendimiento y la rentabilidad:
+
+*   **Sincronizar desde**: Elija la fecha de inicio (por ejemplo, "Desde ahora" o una fecha histórica específica).
+*   **Máximo de correos**: Establezca el número máximo de correos electrónicos a procesar en un solo lote (Predeterminado: 50).
+*   **Intervalo de sincronización**: Defina la frecuencia con la que el programador en segundo plano debe buscar nuevos correos (por ejemplo, cada 15 minutos).
+
+> [!TIP]
+> **Empiece poco a poco**: Para su primera ejecución, recomendamos configurar "Sincronizar desde" en "Ahora" y "Máximo de correos" entre 10 y 20 para verificar que sus reglas funcionan según lo previsto.
+
+---
+
+## 🤖 Automatización y Auto-Pilot
+
+La gestión del comportamiento de su IA —incluida la creación de reglas personalizadas, el cambio de automatizaciones del sistema y la configuración de políticas de retención — se ha consolidado en la pestaña **[Auto-Pilot](./AUTOMATION.md)**.
+
+---
+
+## 🧠 Configuración del sistema e IA
+
+### Configuración del proveedor
+Email Automator detecta los modelos disponibles a través de **RealTimeX Desktop**.
+*   **Proveedor de LLM**: Elija su motor de IA preferido (por ejemplo, OpenAI, Anthropic o modelos locales).
+*   **Modelo de embedding**: Se utiliza para el sistema RAG (Generación aumentada por recuperación) para ayudar a la IA a comprender su contexto específico.
+
+### Voz y accesibilidad (TTS)
+Habilite **Texto a voz** para que la IA lea resúmenes o alertas importantes en voz alta.
+*   **Hablar automáticamente**: Lee automáticamente las notificaciones de alta prioridad.
+*   **Perfil de voz**: Elija entre varias voces de alta calidad disponibles a través de RealTimeX.
+
+---
+
+**Siguiente paso:** [Monitoreo del Panel de control](./DASHBOARD.md)

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

@@ -0,0 +1,71 @@
+# Panel de control y actividad en vivo
+
+El **Panel de control** es su interfaz principal para monitorear la actividad de su agente de IA y gestionar su bandeja de entrada analizada. Está diseñado para proporcionar una transparencia total sobre cómo piensa y actúa la IA.
+
+---
+
+## 📊 El flujo de análisis
+
+A medida que la IA procesa su bandeja de entrada, los correos electrónicos aparecen en el flujo con actualizaciones de estado en tiempo real e información inteligente.
+
+*   **Búsqueda inteligente**: Encuentre rápidamente correos electrónicos por palabra clave o remitente.
+*   **Filtros de IA**: Filtre su vista por Categoría (por ejemplo, Newsletter, Personal), Sentimiento o Prioridad.
+*   **Clasificación dinámica**: Alterne entre la hora en que se *recibió* un correo electrónico y la hora en que fue *procesado* por la IA.
+
+### 📌 Barra lateral de detalles del correo electrónico
+Al hacer clic en cualquier tarjeta de correo electrónico se abre un panel lateral detallado que contiene:
+*   **Resumen de IA**: Una descripción concisa del contenido del correo electrónico.
+*   **Puntos clave**: Aspectos destacados extraídos por la IA.
+*   **Vista previa del borrador**: Si se generó un borrador de respuesta, puede revisarlo aquí antes de enviarlo.
+*   **Enlaces rápidos**: Salte directamente al correo electrónico original en su interfaz web de Gmail o Outlook.
+
+---
+
+## 🛡️ Confianza y transparencia
+
+Email Automator se basa en el principio de **"IA de caja de cristal" (Glass Box AI).** Siempre debe saber *por qué* se tomó una acción.
+
+### 📟 Terminal de actividad en vivo
+Haga clic en el botón **Live Activity** (Actividad en vivo) en la esquina inferior derecha para abrir el flujo de procesamiento en tiempo real.
+*   **Registros de pensamiento**: Observe cómo la IA analiza el contenido, evalúa las reglas y decide las acciones.
+*   **Detalles técnicos**: Vea las llamadas de API sin procesar, las duraciones del procesamiento y los estados de sincronización en segundo plano.
+*   **Control**: Puede detener manualmente una sincronización activa directamente desde la terminal.
+
+### 🕵️ Traza de IA (AI Trace)
+Haga clic en el **icono del ojo** en cualquier tarjeta de correo electrónico para abrir el **Modal de Traza de IA**.
+*   **Lógica de decisión**: Vea un desglose paso a paso de por qué la IA asignó una categoría o prioridad específica.
+*   **Datos sin procesar**: Vea el prompt exacto enviado al LLM y la respuesta JSON sin procesar que devolvió.
+*   **Estadísticas de rendimiento**: Revise el uso de tokens y el tiempo de procesamiento para ese correo electrónico específico.
+
+---
+
+## ⚡ Acciones rápidas
+
+Tome el control con acciones de un solo clic disponibles en cada tarjeta de correo electrónico:
+*   🗑️ **Eliminar / 📦 Archivar**: Limpieza instantánea.
+*   ⭐ **Destacar / Marcar**: Marque elementos importantes para más tarde.
+*   🔄 **Reprocesar**: Si ha actualizado sus reglas, puede pedirle a la IA que analice un correo electrónico nuevamente.
+*   💬 **Comentarios**: Ayude a la IA a aprender informando categorizaciones o análisis de sentimientos incorrectos.
+
+---
+
+## 🔔 Notificaciones y retroalimentación
+
+La aplicación utiliza retroalimentación multisensorial para mantenerlo informado sobre la actividad en segundo plano:
+*   **Visual**: Insignias de estado en vivo y notificaciones emergentes.
+*   **Audio**: Campanas sutiles y de alta calidad para nuevos correos electrónicos, alertas de alta prioridad y finalización de la sincronización.
+*   **Háptica**: Retroalimentación física en dispositivos compatibles.
+
+> **Nota**: Los ajustes de sonido y háptica se pueden personalizar en la **[Configuración de la cuenta](./ACCOUNT.md)**.
+
+---
+
+## 📈 Análisis e historial
+
+Manténgase informado sobre el rendimiento de su agente:
+*   **Historial de sincronización**: Vea un registro de las ejecuciones de sincronización recientes, incluido el número de correos electrónicos procesados y cualquier acción tomada.
+*   **Estadísticas de eficiencia**: Vea los totales de eliminaciones, archivos y borradores automatizados a lo largo del tiempo.
+
+---
+
+**Siguiente paso:** [Creación de reglas de automatización](./AUTOMATION.md)

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

@@ -0,0 +1,61 @@
+# Primeros pasos
+
+Bienvenido a **Email Automator**, su asistente de correo electrónico personal impulsado por IA. Esta guía le ayudará a configurar la aplicación utilizando el modelo **"Bring Your Own Key" (BYOK)**, que garantiza que sus datos permanezcan bajo su control dentro de su propia infraestructura de Supabase.
+
+## 🛠 Requisitos previos
+
+Antes de comenzar, asegúrese de tener lo siguiente:
+
+1.  **RealTimeX Desktop**: Instalado y en funcionamiento. Esto es necesario para el procesamiento de IA (LLM) y las capacidades de texto a voz (TTS).
+2.  **Cuenta de Supabase**: Una cuenta gratuita o de pago en [supabase.com](https://supabase.com).
+
+---
+
+## 🚀 Configuración rápida con el asistente
+
+El **Asistente de configuración** integrado es la forma recomendada de comenzar. Automatiza el trabajo técnico pesado.
+
+### 1. Compra y lanzamiento
+*   Abra **RealTimeX Desktop**.
+*   Vaya a la pestaña **Marketplace** → **Local Apps**.
+*   Busque **"Email Automator"** y cómprelo (o actívelo si ya es de su propiedad).
+*   Una vez comprado, haga clic en **Launch** (Lanzar) desde su lista de aplicaciones locales.
+
+### 2. Ejecutar el asistente de configuración
+En el primer lanzamiento, la aplicación le guiará a través de la configuración inicial:
+
+*   **Elija una ruta de configuración**:
+    *   **Aprovisionamiento gestionado (Recomendado)**: Proporcione un **Token de acceso de Supabase**. El asistente creará automáticamente un nuevo proyecto, ejecutará las migraciones de la base de datos, desplegará las Edge Functions e ingerirá la base de conocimientos inicial.
+    *   **Conectar proyecto existente**: Utilice un proyecto de Supabase existente proporcionando su **URL del proyecto** y su **Clave Anon**. Opcionalmente, puede proporcionar un token de acceso aquí para que el asistente ejecute las migraciones por usted.
+
+### 3. Crear su cuenta
+Una vez que la base de datos esté lista, se le pedirá que cree su cuenta de usuario local e inicie sesión para acceder al **Panel de control**.
+
+---
+
+## 🔍 Cómo encontrar sus credenciales de Supabase
+
+Si elige conectar un proyecto existente manualmente, puede encontrar sus credenciales en el [Panel de control de Supabase](https://supabase.com/dashboard):
+
+1.  Seleccione su proyecto.
+2.  Vaya a **Settings** (Configuración) → **API**.
+3.  **URL del proyecto**: Copie la URL que se encuentra en "Project URL".
+4.  **Clave API**: Copie la clave **anon (public)** en "Project API keys".
+
+> [!WARNING]
+> **Nota de seguridad**: Nunca use la clave `service_role`. Tiene privilegios de omisión administrativa total y nunca debe exponerse en aplicaciones del lado del cliente.
+
+---
+
+## 🪪 Generación de un token de acceso
+
+Un token de acceso permite que el asistente de configuración gestione sus proyectos de Supabase (creación, migraciones, despliegue de funciones) en su nombre.
+
+1.  En su panel de control de Supabase, vaya a **Account** (Cuenta) → **Access Tokens** (Tokens de acceso).
+2.  Haga clic en **Generate new token**, asígnele un nombre (por ejemplo, "Email Automator") y copie el resultado.
+3.  Pegue este token en el asistente de configuración cuando se le solicite.
+
+---
+
+**Siguiente paso:** [Configure sus cuentas de correo electrónico](./CONFIGURATION.md)  
+**Glosario:** [Términos comunes](./GLOSSARY.md)