@realtimex/email-automator 2.22.1 → 2.22.2

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

@@ -0,0 +1,160 @@
+# 용어 사전
+
+Email Automator 및 설정 마법사에서 사용되는 일반적인 용어의 정의입니다.
+
+## Supabase
+호스팅된 Postgres 데이터베이스, 인증, 스토리지 및 API를 제공하는 백엔드 플랫폼입니다. Email Automator는 Supabase를 데이터베이스 및 인증 레이어로 사용합니다.
+
+## BYOK (Bring Your Own Key)
+공유 백엔드를 사용하는 대신 고유한 Supabase 프로젝트를 연결하는 설정 모델입니다. 이를 통해 데이터를 고유한 인프라에 유지할 수 있습니다.
+
+## Supabase 프로젝트 ID
+Supabase 프로젝트의 고유 식별자입니다(종종 프로젝트 URL 또는 설정에 표시됨).
+
+## Supabase 프로젝트 URL
+앱이 데이터베이스 및 API에 연결하는 데 사용하는 Supabase 프로젝트의 기본 URL입니다.
+
+## Anon Key (공개 API 키)
+Supabase 프로젝트의 공개 API 키입니다. 클라이언트 쪽에서 사용하기에 안전하지만 여전히 행 레벨 보안(RLS)의 적용을 받습니다.
+
+## 액세스 토큰
+설정 마법사가 귀하를 대신하여 프로젝트를 생성하거나 관리할 수 있도록 하는 Supabase 계정의 토큰입니다(빠른 시작에서 사용됨).
+
+## 관리형 프로비저닝 (빠른 시작)
+설정 마법사가 귀하의 액세스 토큰을 사용하여 자동으로 Supabase 프로젝트를 생성하고, 마이그레이션을 적용하고, Edge Functions를 배포하고, 지식 베이스를 수집합니다.
+
+## 수동 동기화 (기존 프로젝트 연결)
+프로젝트 URL과 Anon Key를 제공하여 기존 Supabase 프로젝트를 연결합니다. 액세스 토큰이 제공된 경우 마법사에서 마이그레이션을 실행할 수 있습니다.
+
+## 관리형 프로비저닝 vs 수동 동기화
+**관리형 프로비저닝**은 액세스 토큰을 사용하여 자동으로 새 Supabase 프로젝트를 생성합니다.
+**수동 동기화**는 프로젝트 URL과 Anon Key를 사용하여 기존 Supabase 프로젝트에 연결합니다.
+
+## 마이그레이션
+테이블, 보기, 함수 및 정책을 생성하거나 업데이트하는 데이터베이스 변경 사항입니다. 마이그레이션은 데이터베이스 스키마를 앱과 일치하게 유지합니다.
+
+## 스키마
+테이블, 열, 유형, 인덱스, 함수 및 정책과 같은 데이터베이스의 구조입니다.
+
+## SQL
+데이터베이스 구조 및 데이터를 정의하고 쿼리하는 데 사용되는 언어입니다.
+
+## 버전 불일치 (Version Mismatch)
+앱의 예상 스키마 버전이 데이터베이스의 실제 버전과 다를 때 발생합니다. 설정 마법사 또는 마이그레이션 도구에서 정규화를 요청합니다.
+
+## 데이터베이스 버전 (계정 설정)
+계정 설정에 표시되는 데이터베이스 메이저 버전입니다. 마이그레이션을 안내하는 데 사용되며 Supabase 프로젝트의 Postgres 버전과 일치해야 합니다.
+
+## 롤백
+마이그레이션을 되돌리는 것입니다. Supabase에서 롤백은 수동이며 신중하게 사용해야 합니다.
+
+## RLS (Row Level Security)
+사용자가 읽거나 쓸 수 있는 행을 제한하는 Postgres 보안 기능입니다. Supabase는 RLS를 사용하여 데이터를 보호합니다.
+
+## Edge Functions
+Supabase에서 호스팅하는 서버리스 함수입니다. Email Automator는 이를 OAuth 흐름 및 보안 작업에 사용합니다.
+
+## Service Role Key
+RLS를 우회하는 강력한 Supabase 키입니다. 클라이언트에 절대 노출되어서는 안 됩니다.
+
+## Anon Key vs Service Role Key
+**anon key**는 클라이언트 사용에 안전하며 RLS를 준수합니다. **service role key**는 RLS를 우회하며 신뢰할 수 있는 서버에서만 사용해야 합니다.
+
+## RealTimeX Desktop
+Email Automator에서 사용하는 AI 서비스(LLM, 임베딩, TTS)를 제공하는 로컬 앱입니다.
+
+## 디지털 페르소나
+AI 생성 초안 및 응답에 대한 톤, 스타일 및 기본 설정을 정의하는 프로필입니다.
+
+## 페르소나 톤
+응답의 감정적 특성입니다(예: 친근함, 공식적, 직접적).
+
+## 페르소나 스타일
+글쓰기 스타일 기본 설정입니다(예: 간결함, 상세함, 글머리 기호).
+
+## 페르소나 보이스
+문구와 리듬을 포함한 글쓰기의 전반적인 "소리"입니다.
+
+## 페르소나 서명
+응답에 사용되는 표준화된 맺음말입니다(이름, 직함, 회사).
+
+## 페르소나 역할
+응답 프레임을 형성하는 데 사용되는 귀하의 직함 또는 역할입니다.
+
+## 페르소나 회사
+적절한 경우 응답에 사용되는 조직 이름입니다.
+
+## 페르소나 언어
+생성된 초안의 기본 언어입니다.
+
+## Express API
+이메일 동기화, AI 처리 및 자동화 실행을 처리하는 로컬 백엔드입니다.
+
+## Realtime (Supabase)
+데이터베이스에서 앱으로의 실시간 업데이트입니다. 새로 고침 없이 새 이메일, 동기화 상태 또는 활동을 반영하는 데 사용됩니다.
+
+## LLM (Large Language Model)
+분석 및 응답 생성(예: 카테고리 분류, 답장 초안 작성)에 사용되는 AI 모델입니다.
+
+## 임베딩 모델
+텍스트를 의미 체계 검색을 위한 벡터로 변환하는 모델입니다. 지식 베이스 및 RAG에서 사용됩니다.
+
+## 임베딩
+지식 베이스의 의미 체계 검색에 사용되는 텍스트의 벡터 표현입니다.
+
+## RAG (Retrieval-Augmented Generation)
+관련 문서를 검색하여 AI에게 제공함으로써 응답이 귀하의 문서에 기반을 두게 하는 방법입니다.
+
+## 지식 베이스 수집 (Ingestion)
+문서를 검색 가능한 임베딩으로 변환하여 데이터베이스에 저장하는 프로세스입니다.
+
+## TTS (Text-to-Speech)
+AI 응답을 음성 오디오로 변환합니다.
+
+## TTS 제공업체 vs 음성
+제공업체는 음성을 생성하는 서비스이고, 음성은 해당 제공업체 내의 특정 화자/페르소나입니다.
+
+## OAuth
+비밀번호를 저장하지 않고 앱이 이메일 계정에 액세스할 수 있도록 하는 권한 부여 표준입니다.
+
+## OAuth 동의 화면
+Email Automator에게 이메일 계정 액세스 권한을 부여하는 화면입니다.
+
+## 액세스 토큰 (OAuth)
+이메일 제공업체 API를 호출하는 데 사용되는 단기 토큰입니다. 만료되면 자동으로 갱신됩니다.
+
+## 리프레시 토큰
+재인증 없이 새 액세스 토큰을 얻는 데 사용되는 장기 토큰입니다.
+
+## Gmail API
+Gmail 데이터에 액세스하고 이메일을 보내기 위한 Google의 공식 API입니다.
+
+## Microsoft Graph
+Outlook 및 Microsoft 365 데이터(메일, 캘린더, 연락처)를 위한 Microsoft의 API입니다.
+
+## IMAP / SMTP
+이메일 프로토콜입니다. IMAP은 메일을 읽고 SMTP는 메일을 보냅니다. (Email Automator는 원시 IMAP/SMTP 대신 제공업체 API를 사용합니다.)
+
+## 앱 등록 (Microsoft)
+Microsoft Graph 액세스를 위한 자격 증명을 제공하는 Azure의 앱 구성입니다.
+
+## 클라이언트 ID
+OAuth 앱(Google/Microsoft)의 공개 식별자입니다.
+
+## 클라이언트 보안 비밀번호 (Client Secret)
+OAuth 앱의 개인 비밀번호입니다. 비밀번호와 동일하게 취급하십시오.
+
+## 리디렉션 URI
+OAuth 인증 후 이메일 제공업체가 사용자를 보내는 콜백 URL입니다.
+
+## 디바이스 코드 흐름
+짧은 코드를 사용하여 브라우저에서 인증하는 OAuth 흐름으로, 종종 데스크톱 앱에서 사용됩니다.
+
+## 테넌트 ID
+Microsoft 테넌트 식별자입니다. 다중 테넌트의 경우 "common"을 사용하거나 조직 전용 액세스의 경우 특정 테넌트 ID를 사용합니다.
+
+## 동기화 범위
+동기화할 기록의 양(예: 지난 X일)과 포함된 계정을 정의합니다.
+
+## 라벨 (Gmail) / 폴더 (Outlook)
+이메일 제공업체의 조직 구성 요소입니다. 라벨은 메시지에 태그를 지정하고 폴더는 메시지를 컨테이너로 구성합니다.

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

@@ -0,0 +1,65 @@
+# 문제 해결 및 지원
+
+문제가 발생한 경우 이 가이드에서 가장 일반적인 함정과 해결 방법을 다룹니다.
+
+---
+
+## 📡 동기화 문제
+
+### 대시보드에 이메일이 나타나지 않음
+*   **"Sync From" 날짜 확인**: AI는 이 날짜 *이후*에 수신된 이메일만 처리합니다.
+*   **검사점 재설정(Reset Checkpoint)**: 시작 날짜를 변경하고 이전 이메일을 다시 검사하려면 동기화 범위 패널에서 **Reset Checkpoint** 버튼을 클릭하세요.
+*   **배치 제한**: **Max Emails** 설정은 실행당 처리되는 이메일 수를 제한합니다. 백로그가 많은 경우 따라잡는 데 여러 번의 동기화 주기가 걸릴 수 있습니다.
+*   **수동 트리거**: 대시보드에서 **Run Sync Now**를 클릭하여 즉시 확인을 강제합니다.
+
+### "Sync Failed" 또는 "Backend Not Connected"
+*   **로컬 서버**: Email Automator 애플리케이션이 열려 있고 실행 중인지 확인하세요.
+*   **실시간 활동 피드**: **Live Activity** 터미널을 엽니다. 여기에는 종종 구체적인 기술적 오류 메시지(예: "Network Error" 또는 "401 Unauthorized")가 포함되어 있습니다.
+
+---
+
+## 🔑 인증 및 권한
+
+### Google/Gmail: `redirect_uri_mismatch`
+*   **해결 방법**: Google Cloud Console의 리디렉션 URI가 Email Automator에 표시된 것과 *정확히* 일치해야 합니다.
+*   **예**: `https://your-ref.supabase.co/functions/v1/auth-gmail/callback` (후행 슬래시나 공백이 없는지 확인하세요).
+
+### Microsoft/Outlook: 로그인 실패 또는 시간 초과
+*   **앱 등록**: Azure 앱 등록에서 "공용 클라이언트 흐름 허용"이 **예**로 설정되어 있는지 확인하세요.
+*   **계정 유형**: 등록 시 "모든 조직 디렉터리의 계정 및 개인 Microsoft 계정"을 선택했는지 확인하세요.
+
+### Supabase: "Invalid API Key"
+*   **해결 방법**: 항상 **anon (public)** 키를 사용하세요. **service_role** 키는 보안상의 이유로 앱에서 거부됩니다.
+
+---
+
+## 🤖 AI 및 RealTimeX 통합
+
+### AI가 느리거나 응답하지 않음
+*   **로컬 모델**: Ollama 또는 LM Studio를 사용하는 경우 컴퓨터에 충분한 RAM이 있고 GPU 부하가 너무 크지 않은지 확인하세요.
+*   **검색**: 드롭다운에 모델이 나타나지 않으면 **RealTimeX Desktop**이 실행 중인지, 그 안에 하나 이상의 AI 제공업체가 구성되어 있는지 확인하세요.
+
+### "스마트 초안"이 생성되지 않음
+*   **시스템 토글**: Auto-Pilot 탭에서 **Smart Drafts**가 **ON**으로 설정되어 있는지 확인하세요.
+*   **규칙 충돌**: 이메일과 일치하는 규칙에 실제로 **Draft**(초안) 작업이 포함되어 있는지 확인하세요.
+*   **안전 필터**: AI는 "봇 루프"를 방지하기 위해 `no-reply` 주소 및 특정 자동 알림에 대한 초안 작성을 자동으로 건너뜁니다.
+
+---
+
+## 🗄️ 데이터베이스 및 마이그레이션
+
+### "데이터베이스 마이그레이션 필요" 배너
+*   **발생 원인**: 로컬 앱이 업데이트되어 새 기능을 지원하기 위해 Supabase 데이터베이스 스키마를 업데이트해야 합니다.
+*   **해결 방법**: 배너에서 **Update Now**를 클릭하세요. 자동 업데이트를 실행하려면 **Supabase 액세스 토큰**이 필요합니다.
+
+### 실시간 터미널이 비어 있거나 "404"가 표시됨
+*   **실시간 권한**: 최신 마이그레이션을 실행했는지 확인하세요. `processing_events` 테이블이 존재하고 올바른 RLS(행 레벨 보안) 정책이 활성화되어 있어야 합니다.
+
+---
+
+## 🆘 여전히 도움이 필요하신가요?
+
+문제가 여기에 나열되어 있지 않은 경우:
+1.  기술 스택 추적을 확인하려면 계정 설정에서 **시스템 로그(System Logs)**를 확인하세요.
+2.  고급 설정 세부 정보는 [개발자 문서](../docs-dev/README.md)를 검토하세요.
+3.  프로젝트 저장소에서 티켓을 생성하거나 토론을 시작하세요.

package/docs/vi/README.md

@@ -0,0 +1,23 @@
+# Tài liệu Email Automator
+
+Chào mừng bạn đến với tài liệu của **Email Automator**, trợ lý email cá nhân hỗ trợ bởi AI của bạn. Công cụ này chạy cục bộ trên máy tính của bạn, đảm bảo dữ liệu của bạn luôn riêng tư trong khi vẫn tận dụng sức mạnh của AI để sắp xếp, ưu tiên và tự động hóa hộp thư đến của bạn.
+
+## 📖 Hướng dẫn sử dụng
+
+Hướng dẫn toàn diện để thiết lập và làm chủ tác nhân email AI của bạn.
+
+1.  [**Bắt đầu**](./user-guide/GETTING-STARTED.md) - Điều kiện tiên quyết, cài đặt và Setup Wizard.
+2.  [**Cấu hình**](./user-guide/CONFIGURATION.md) - Kết nối Gmail/Outlook (BYOK) và giới hạn đồng bộ hóa.
+3.  [**Dashboard & Hoạt động trực tiếp**](./user-guide/DASHBOARD.md) - Giám sát AI, Live Terminal và AI Trace.
+4.  [**Auto-Pilot & Quy tắc**](./user-guide/AUTOMATION.md) - Tạo quy tắc do AI điều khiển, viết nháp hộ và chính sách lưu trữ.
+5.  [**Tài khoản & Quyền riêng tư**](./user-guide/ACCOUNT.md) - Quản lý cá tính (persona), bảo mật và chủ quyền dữ liệu.
+6.  [**Khắc phục sự cố & Hỗ trợ**](./user-guide/TROUBLESHOOTING.md) - Các vấn đề thường gặp và cách giải quyết.
+7.  [**Thuật ngữ**](./user-guide/GLOSSARY.md) - Các thuật ngữ và định nghĩa phổ biến.
+
+## 🚀 Các tính năng chính
+
+*   **Quyền riêng tư là trên hết**: Email của bạn không bao giờ chạm vào máy chủ của chúng tôi. Việc xử lý là cục bộ hoặc thông qua các khóa AI của riêng bạn.
+*   **Phân tích thông minh**: Tự động phân loại, phân tích cảm xúc và tóm tắt.
+*   **AI "Hộp kính"**: Minh bạch hoàn toàn thông qua Live Terminal và các cửa sổ AI Trace.
+*   **Auto-Pilot**: Quản lý tập trung cho các quy tắc "Nếu thế này thì thế kia" do AI điều khiển.
+*   **Phản hồi đa giác quan**: Âm thanh và rung (haptic) chất lượng cao cho các hoạt động nền.

package/docs/vi/marketplace/listing.md

@@ -0,0 +1,34 @@
+# Niêm yết RealTimeX Marketplace: Email Automator
+
+## Siêu dữ liệu (Metadata)
+- **Tên hiển thị**: Email Automator
+- **Mô tả ngắn**: Một nền tảng quản lý email theo hướng tác nhân, hỗ trợ bởi AI, có khả năng học cách xử lý hộp thư đến của bạn. "Làm chủ hộp thư đến của bạn" với chi phí đám mây bằng không và quyền riêng tư tuyệt đối.
+- **Thẻ**: Năng suất, Email, Tự động hóa, Tác nhân AI, Quyền riêng tư
+
+---
+
+## Mô tả đầy đủ
+
+### 📧 Làm chủ hộp thư đến của bạn
+**Email Automator** là quản gia email cá nhân của bạn. Nó không chỉ lọc thư rác; nó coi hộp thư đến của bạn như một danh sách công việc cần quản lý. Bằng cách tận dụng AI cục bộ, nó phân loại, ưu tiên và thậm chí soạn thảo các câu trả lời cho bạn—tất cả mà không bao giờ để dữ liệu của bạn rời khỏi tầm kiểm soát của bạn.
+
+### 🚀 Các tính năng chính
+
+-   **Phân loại thông minh**: AI tự động phân loại các email gửi đến thành các Danh mục (Bản tin, Giao dịch, Xã hội, v.v.) và Mức độ ưu tiên (Cao, Trung bình, Thấp) dựa trên các tiêu đề trực quan và phân tích nội dung.
+-   **Công cụ Inbox Zero**: Định nghĩa các quy tắc tự động hóa như "Lưu trữ bản tin sau 7 ngày" hoặc "Xóa thư rác ngay lập tức." Công cụ hoạt động không mệt mỏi trong nền để giữ cho hộp thư đến của bạn luôn sạch sẽ.
+-   **Tác nhân nhận biết ngữ cảnh**: Nói chuyện với hộp thư đến của bạn. Sử dụng **Tác nhân (Agent)** để xem xét các bản nháp qua giọng nói ("Đọc các bản nháp của tôi", "Gửi bản này"), yêu cầu trợ giúp cấu hình hoặc nhận giải thích cho các quy tắc phức tạp.
+-   **Phản hồi chiến thắng (Winning Responses)**: Đối với các email quan trọng, Auto-Pilot tạo ra các bản nháp "Phản hồi chiến thắng"—các câu trả lời được viết sẵn nắm bắt được giọng điệu và ý định của bạn, sẵn sàng để bạn phê duyệt.
+-   **Terminal trực tiếp**: Xem AI suy nghĩ. Terminal trực tiếp tích hợp sẵn cho bạn thấy chính xác những gì Tác nhân đang phân tích, quyết định và thực hiện trong thời gian thực.
+
+### 🛡️ Quyền riêng tư là trên hết: Dữ liệu của bạn, Cơ sở hạ tầng của bạn
+Được xây dựng trên triết lý **"Làm chủ dữ liệu của bạn"**.
+-   **Chi phí đám mây bằng không**: Chạy hoàn toàn trên phiên bản Supabase miễn phí của riêng bạn và máy cục bộ của bạn.
+-   **AI cục bộ**: Sử dụng **RealTimeX SDK** để khai thác các mô hình cục bộ (hoặc các khóa API) của bạn một cách an toàn. Không bị phụ thuộc vào nhà cung cấp.
+
+### 🔌 Tích hợp liền mạch
+Được thiết kế để chạy song song với **RealTimeX Desktop**. Nó tự động phát hiện các nhà cung cấp AI cục bộ của bạn và đồng bộ hóa qua hệ sinh thái RealTimeX.
+
+---
+
+## Tài sản hình ảnh
+- **Ảnh bìa phong cảnh**: `../../images/cover-landscape.webp`

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

@@ -0,0 +1,52 @@
+# Tài khoản & Quyền riêng tư
+
+Quản lý hồ sơ, cá tính AI (AI persona) và các cài đặt bảo mật của bạn trong trang **Account Settings** (truy cập qua biểu tượng hồ sơ ở góc trên bên phải).
+
+---
+
+## 👤 Hồ sơ & Trải nghiệm
+Cá nhân hóa tương tác của bạn với ứng dụng:
+*   **Danh tính**: Cập nhật tên hiển thị của bạn và tải lên ảnh đại diện tùy chỉnh.
+*   **Phản hồi cảm giác**: Bật/tắt **Hiệu ứng âm thanh** và **Phản hồi xúc giác** cho các hoạt động nền (như phân tích email mới hoặc hoàn thành đồng bộ hóa).
+
+---
+
+## 🧬 Cá tính AI của bạn
+**Persona** là cài đặt quan trọng nhất để có được các **Smart Drafts** chất lượng cao. Nó đóng vai trò là "Danh tính" mà AI sử dụng khi viết nháp các câu trả lời.
+
+*   **Vai trò & Ngữ cảnh**: Xác định chức danh chuyên môn và ngành nghề bạn đang làm việc.
+*   **Giọng điệu (Tone of Voice)**: Chỉ định cách bạn muốn giọng điệu của mình thể hiện (ví dụ: "Chuyên nghiệp nhưng thân thiện", "Ngắn gọn và trực tiếp").
+*   **Phong cách trả lời**: Thiết lập các sở thích về độ dài câu trả lời và việc sử dụng chữ ký.
+*   **Các thực thể tin cậy**: Liệt kê các người gửi VIP và các miền tin cậy để giúp AI ưu tiên chính xác.
+
+---
+
+## 🗄️ Kết nối Supabase (BYOK)
+Là một phần của mô hình **"Bring Your Own Key"**, bạn có thể theo dõi và quản lý kết nối của mình với cơ sở dữ liệu chuyên dụng:
+*   **Trạng thái**: Xem URL dự án Supabase và phiên bản Schema hiện tại của bạn.
+*   **Trung tâm di chuyển (Migration Center)**: Kiểm tra xem schema cơ sở dữ liệu của bạn có được cập nhật hay không.
+*   **Ngắt kết nối**: Nếu bạn cần chuyển đổi dự án, bạn có thể xóa cấu hình của mình tại đây (điều này sẽ đăng xuất bạn và đặt lại trạng thái ứng dụng cục bộ).
+
+---
+
+## 🔐 Bảo mật
+*   **Quản lý mật khẩu**: Cập nhật mật khẩu tài khoản cục bộ của bạn bất kỳ lúc nào.
+*   **Mã hóa**: Tất cả thông tin xác thực của nhà cung cấp email (token Gmail/Outlook) đều được mã hóa trước khi được lưu trữ trong dự án Supabase của bạn.
+
+---
+
+## 🛡️ Quyền riêng tư & Chủ quyền dữ liệu
+Email Automator được thiết kế với kiến trúc **ưu tiên quyền riêng tư**. Dữ liệu của bạn được phân phối như sau:
+
+| Loại dữ liệu | Vị trí | Quyền truy cập |
+| :--- | :--- | :--- |
+| **Siêu dữ liệu Email & Nhật ký** | Dự án Supabase của bạn | Riêng tư đối với bạn |
+| **Tệp Email thô (.eml)** | Máy cục bộ của bạn | Chỉ truy cập ngoại tuyến |
+| **Tệp đính kèm quy tắc** | Lưu trữ Supabase của bạn | Riêng tư đối với bạn |
+| **Xử lý AI** | RealTimeX Desktop | Cục bộ/API trực tiếp |
+
+**Quan trọng**: Email Automator (công ty) không bao giờ có quyền truy cập vào email, thông tin xác thực hoặc nhật ký AI của bạn. Mọi thứ đều nằm trong cơ sở hạ tầng riêng tư của chính bạn.
+
+---
+
+**Bước tiếp theo:** [Khắc phục sự cố & Hỗ trợ](./TROUBLESHOOTING.md)

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

@@ -0,0 +1,93 @@
+# Tự động hóa & Auto-Pilot
+
+Tab **Auto-Pilot** là trung tâm quản lý hành vi của tác nhân AI. Nó hợp nhất các "Quy tắc hệ thống" (chế độ chuyển đổi toàn cầu) và một thư viện gồm **26 quy tắc thông minh tích hợp** cùng với các "Quy tắc tùy chỉnh" của riêng bạn.
+
+---
+
+## 🛡️ Quy tắc hệ thống tích hợp
+
+Email Automator đi kèm với 26 quy tắc được cấu hình sẵn do các chuyên gia AI thiết kế để xử lý các thách thức phổ biến trong hộp thư đến. Chúng được sắp xếp thành các danh mục chức năng để giúp bạn luôn ngăn nắp.
+
+### 📧 Tổ chức Email
+*   **Newsletter Sweeper**: Tự động lưu trữ các bản tin và email tiếp thị để giữ cho hộp thư đến của bạn sạch sẽ.
+*   **Receipt Organizer**: Tự động lưu hồ sơ biên lai và xác nhận đơn hàng.
+*   **CC Organizer**: Gán nhãn cho các email mà bạn được gửi kèm (CC) để nhanh chóng phân loại.
+*   **Cold Outreach Filter**: Di chuyển các email bán hàng lạ sang một thư mục riêng.
+*   **Social Noise**: Giảm thiểu các thông báo từ LinkedIn và mạng xã hội.
+*   **Stack Overflow Digests**: Tự động lưu trữ các bản tin kỹ thuật trừ khi chúng yêu cầu sự chú ý ngay lập tức.
+
+### 🚨 Ưu tiên & Cảnh báo
+*   **VIP Urgent Messages**: Gắn sao cho các tin nhắn khẩn cấp từ các bên liên quan chính (CEOs, thành viên Hội đồng quản trị).
+*   **Critical Alerts**: Làm nổi bật các sự cố sản xuất và các cảnh báo quan trọng P0/P1.
+*   **Urgent Support Tickets**: Làm nổi bật các vấn đề của khách hàng có mức độ ưu tiên cao cần hành động ngay lập tức.
+
+### 💻 Phát triển
+*   **GitHub Mentions**: Theo dõi khi bạn được nhắc đến cụ thể trong Pull Requests hoặc Issues.
+*   **CI/CD Failures**: Làm nổi bật các lỗi xây dựng (build) và triển khai từ các công cụ như CircleCI hoặc GitHub Actions.
+*   **Code Review Requests**: Tổ chức các yêu cầu đánh giá mã (code review) gửi đến.
+*   **Dependabot Noise**: Tự động lưu trữ các bản cập nhật phụ thuộc có mức độ ưu tiên thấp trong khi vẫn giữ các cảnh báo bảo mật ở chế độ hiển thị.
+*   **Monitoring Alerts**: Tổ chức các cảnh báo giám sát và ghi nhật ký không khẩn cấp.
+
+### 💼 Bán hàng & Kinh doanh
+*   **Hot Leads**: Ưu tiên các câu trả lời từ khách hàng tiềm năng có ý định cao dựa trên cảm xúc tích cực.
+*   **Follow-up Reminders**: Theo dõi các phản hồi từ khách hàng tiềm năng yêu cầu cụ thể việc theo dõi (follow-up).
+*   **Referrals & Intros**: Đảm bảo bạn không bao giờ bỏ lỡ một lời giới thiệu hoặc đề cử nồng nhiệt.
+*   **Contracts & Proposals**: Làm nổi bật các trao đổi hợp đồng quan trọng và các tài liệu pháp lý.
+*   **Objections & Concerns**: Gắn cờ các email bày tỏ mối quan ngại hoặc sự ngần ngại để xử lý cẩn thận.
+*   **Nurture Campaigns**: Lưu trữ các email chiến dịch tự động để ưu tiên các câu trả lời cá nhân.
+*   **Financial Updates**: Giữ cho các báo cáo doanh thu và cập nhật ngân sách hàng quý dễ dàng truy cập.
+
+### ⚙️ Vận hành
+*   **Internal Requests**: Tổ chức các yêu cầu liên nhóm và các đầu mục công việc.
+*   **Vendor Communications**: Theo dõi hóa đơn, lô hàng và các cập nhật liên quan đến nhà cung cấp.
+*   **System Alerts**: Tổ chức các thông báo về cơ sở hạ tầng và hệ thống.
+*   **Meeting Invites**: Tách riêng các lời mời lịch để quản lý lịch trình dễ dàng hơn.
+*   **Weekly Reports**: Tự động phân loại các báo cáo tình trạng định kỳ và cập nhật tiến độ.
+
+---
+
+## 🛠️ Xây dựng các quy tắc tùy chỉnh
+
+Các quy tắc tùy chỉnh cho phép bạn tạo ra các quy trình làm việc chính xác, hướng bởi AI. Bạn có thể tạo, chỉnh sửa và quản lý các quy tắc này trực tiếp trong tab **Auto-Pilot**.
+
+### 1. Điều kiện (Cái "Nếu")
+Bạn có thể kết hợp các siêu dữ liệu (metadata) và các điều kiện hỗ trợ bởi AI:
+*   **Thông tin AI**: Danh mục (ví dụ: Bản tin, Biên lai, Cá nhân), Cảm xúc (Tích cực, Tiêu cực, Trung lập), hoặc Mức độ ưu tiên (Cao, Trung bình, Thấp).
+*   **Siêu dữ liệu**: Miền người gửi (ví dụ: `github.com`), các từ khóa cụ thể trong tiêu đề, hoặc tên người gửi.
+*   **Bộ lọc lưu trữ**: "Chỉ hành động nếu email cũ hơn X ngày." Điều này hoàn hảo để dọn dẹp các bản tin hoặc thông báo cũ.
+
+### 2. Hành động (Cái "Thì")
+Chọn điều gì sẽ xảy ra khi một email khớp với các điều kiện của bạn:
+*   **Lưu trữ / Xóa**: Giữ cho hộp thư đến của bạn sạch sẽ một cách tự động.
+*   **Gắn sao / Gắn cờ**: Làm nổi bật các mục quan trọng để xem xét thủ công.
+*   **Draft (Viết nháp)**: Hành động mạnh mẽ nhất. Nó yêu cầu AI chuẩn bị một câu trả lời.
+
+---
+
+## ✍️ Ngữ cảnh thông minh & Ghostwriting
+
+Khi bạn sử dụng hành động **Draft**, bạn có thể cung cấp cho AI các hướng dẫn cụ thể để đảm bảo câu trả lời phù hợp với nhu cầu của bạn:
+
+*   **Hướng dẫn Ghostwriting**: Nói cho AI biết *cách* trả lời (ví dụ: "Hãy lịch sự nhưng kiên quyết từ chối lời mời," hoặc "Hỏi xem họ có rảnh vào thứ Ba tới không").
+*   **Tệp đính kèm quy tắc**: Bạn có thể tải lên các tài liệu chuẩn (như bảng giá hoặc tiểu sử) mà AI sẽ tự động bao gồm dưới dạng tệp đính kèm bất cứ khi nào quy tắc này kích hoạt một bản nháp.
+
+---
+
+## 🚀 Tab Auto-Pilot
+
+Tab **Auto-Pilot** cung cấp cái nhìn toàn cảnh về công cụ tự động hóa của bạn.
+*   **Chế độ xem nhóm**: Các quy tắc được sắp xếp theo mục đích chính của chúng.
+*   **Chế độ chuyển đổi nhanh**: Bật hoặc tắt các quy tắc ngay lập tức mà không cần xóa chúng.
+*   **Chỉ số trạng thái**: Xem quy tắc nào hiện đang hoạt động và chúng đã xử lý bao nhiêu email.
+
+---
+
+## 💡 Các phương pháp hay nhất
+
+*   **Bắt đầu thụ động**: Thiết lập các quy tắc đầu tiên của bạn ở chế độ **Star** hoặc **Archive** thay vì **Delete** cho đến khi bạn tin tưởng vào khả năng phân loại của AI.
+*   **Sử dụng Lưu trữ cho Tiếng ồn**: Sử dụng một quy tắc như: `Nếu Danh mục = Bản tin VÀ Tuổi > 30 Ngày THÌ Xóa`. Điều này giữ cho các bản tin "đã đọc" của bạn không làm lộn xộn kho lưu trữ của bạn mãi mãi.
+*   **Tinh chỉnh với Phản hồi**: Nếu một quy tắc không khớp chính xác, hãy sử dụng biểu tượng **Feedback** trên Dashboard để cải thiện sự hiểu biết của AI về loại email cụ thể đó.
+
+---
+
+**Bước tiếp theo:** [Quản lý Tài khoản & Bảo mật](./ACCOUNT.md)

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

@@ -0,0 +1,61 @@
+# Cấu hình
+
+Tab **Configuration** là trung tâm điều khiển của Email Automator. Tại đây, bạn kết nối các nhà cung cấp email, xác định hành vi của AI và thiết lập các quy tắc thúc đẩy quá trình tự động hóa.
+
+---
+
+## 📧 Tài khoản Email (BYOK)
+
+Email Automator tuân theo mô hình **"Bring Your Own Key" (BYOK)**. Bạn cung cấp thông tin xác thực OAuth của riêng mình, đảm bảo rằng quyền truy cập dữ liệu hoàn toàn nằm trong tầm kiểm soát của bạn.
+
+### 🔴 Thiết lập Gmail (OAuth 2.0)
+1.  **Google Cloud Console**: Tạo một dự án và bật **Gmail API**.
+2.  **Consent Screen**: Cấu hình màn hình đồng ý OAuth và thêm email của bạn làm **Test User**.
+3.  **Credentials**: Tạo một **OAuth 2.0 Client ID** (Loại: Web Application).
+    *   **Authorized Redirect URI**: `https://<your-project-ref>.supabase.co/functions/v1/auth-gmail/callback`
+4.  **Kết nối**: Trong Email Automator, nhấp vào **Connect Gmail**.
+5.  **Ủy quyền**: Dán Client ID và Secret của bạn (hoặc tải lên tệp JSON), sau đó làm theo liên kết để ủy quyền cho tài khoản của bạn.
+
+### 🔵 Thiết lập Outlook (Device Code)
+1.  **Azure Portal**: Đăng ký một ứng dụng mới trong **App Registrations**.
+2.  **Account Type**: Chọn "Accounts in any organizational directory and personal Microsoft accounts".
+3.  **Authentication**: Đảm bảo "Allow public client flows" được đặt thành **Yes**.
+4.  **Kết nối**: Trong Email Automator, nhấp vào **Connect Outlook** và nhập **Client ID** của bạn.
+5.  **Ủy quyền**: Làm theo thông báo **Device Code** trong trình duyệt để hoàn tất đăng nhập.
+
+---
+
+## 📅 Phạm vi & Giới hạn đồng bộ
+
+Trước khi bắt đầu lần đồng bộ đầu tiên, hãy cấu hình các giới hạn để đảm bảo hiệu suất và hiệu quả chi phí:
+
+*   **Sync From**: Chọn ngày bắt đầu (ví dụ: "Từ bây giờ" hoặc một ngày cụ thể trong quá khứ).
+*   **Max Emails**: Đặt số lượng email tối đa để xử lý trong một đợt (Mặc định: 50).
+*   **Sync Interval**: Xác định tần suất bộ lập lịch nền sẽ kiểm tra thư mới (ví dụ: mỗi 15 phút).
+
+> [!TIP]
+> **Bắt đầu nhỏ**: Đối với lần chạy đầu tiên, chúng tôi khuyên bạn nên đặt "Sync From" thành "Now" và "Max Emails" thành 10-20 để xác minh các quy tắc của bạn hoạt động như mong đợi.
+
+---
+
+## 🤖 Tự động hóa & Auto-Pilot
+
+Việc quản lý hành vi của AI—bao gồm xây dựng các quy tắc tùy chỉnh, chuyển đổi tự động hóa hệ thống và thiết lập các chính sách lưu trữ—đã được hợp nhất vào tab **[Auto-Pilot](./AUTOMATION.md)**.
+
+---
+
+## 🧠 Cài đặt AI & Hệ thống
+
+### Cấu hình nhà cung cấp
+Email Automator phát hiện các mô hình có sẵn thông qua **RealTimeX Desktop**.
+*   **LLM Provider**: Chọn công cụ AI ưa thích của bạn (ví dụ: OpenAI, Anthropic hoặc các mô hình cục bộ).
+*   **Embedding Model**: Được sử dụng cho hệ thống RAG (Retrieval-Augmented Generation) để giúp AI hiểu ngữ cảnh cụ thể của bạn.
+
+### Giọng nói & Khả năng tiếp cận (TTS)
+Bật **Text-to-Speech** để AI đọc to các bản tóm tắt hoặc các cảnh báo quan trọng.
+*   **Auto-Speak**: Tự động đọc các thông báo có mức độ ưu tiên cao.
+*   **Voice Profile**: Chọn từ nhiều giọng nói chất lượng cao khác nhau có sẵn thông qua RealTimeX.
+
+---
+
+**Bước tiếp theo:** [Theo dõi Dashboard](./DASHBOARD.md)

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

@@ -0,0 +1,71 @@
+# Dashboard & Hoạt động trực tiếp
+
+**Dashboard** là giao diện chính để theo dõi hoạt động của tác nhân AI và quản lý hộp thư đến đã được phân tích. Nó được thiết kế để cung cấp sự minh bạch hoàn toàn về cách AI suy nghĩ và hành động.
+
+---
+
+## 📊 Nguồn cấp dữ liệu phân tích
+
+Khi AI xử lý hộp thư đến của bạn, các email sẽ xuất hiện trong nguồn cấp dữ liệu với các cập nhật trạng thái theo thời gian thực và thông tin chi tiết thông minh.
+
+*   **Tìm kiếm thông minh**: Tìm nhanh email theo từ khóa hoặc người gửi.
+*   **Bộ lọc AI**: Lọc chế độ xem của bạn theo Danh mục (ví dụ: Bản tin, Cá nhân), Cảm xúc hoặc Mức độ ưu tiên.
+*   **Sắp xếp động**: Chuyển đổi giữa thời gian email được *nhận* và thời gian email được *xử lý* bởi AI.
+
+### 📌 Thanh bên chi tiết Email
+Nhấp vào bất kỳ thẻ email nào sẽ mở ra một bảng điều khiển chi tiết bên cạnh chứa:
+*   **Tóm tắt AI**: Một cái nhìn tổng quan ngắn gọn về nội dung của email.
+*   **Các điểm chính**: Các điểm nổi bật được liệt kê dưới dạng danh sách do AI trích xuất.
+*   **Xem trước bản nháp**: Nếu một bản nháp trả lời đã được tạo, bạn có thể xem lại tại đây trước khi nó được gửi.
+*   **Liên kết nhanh**: Nhảy trực tiếp đến email gốc trong giao diện web Gmail hoặc Outlook của bạn.
+
+---
+
+## 🛡️ Sự tin tưởng & Tính minh bạch
+
+Email Automator được xây dựng trên nguyên tắc **"Glass Box AI."** Bạn luôn có thể biết *tại sao* một hành động đã được thực hiện.
+
+### 📟 Terminal hoạt động trực tiếp
+Nhấp vào nút **Live Activity** ở góc dưới bên phải để mở nguồn cấp dữ liệu xử lý theo thời gian thực.
+*   **Nhật ký tư duy (Thinking Logs)**: Xem AI phân tích nội dung, đánh giá các quy tắc và quyết định các hành động.
+*   **Chi tiết kỹ thuật**: Xem các cuộc gọi API thô, thời gian xử lý và trạng thái đồng bộ hóa nền.
+*   **Điều khiển**: Bạn có thể dừng quá trình đồng bộ hóa đang hoạt động một cách thủ công ngay từ terminal.
+
+### 🕵️ Dấu vết AI (AI Trace)
+Nhấp vào **biểu tượng Con mắt** trên bất kỳ thẻ email nào để mở **AI Trace Modal**.
+*   **Logic quyết định**: Xem bảng phân tích từng bước về lý do tại sao AI gán một danh mục hoặc mức độ ưu tiên cụ thể.
+*   **Dữ liệu thô**: Xem lời nhắc (prompt) chính xác được gửi tới LLM và phản hồi JSON thô mà nó trả về.
+*   **Số liệu hiệu suất**: Xem lại việc sử dụng token và thời gian xử lý cho email cụ thể đó.
+
+---
+
+## ⚡ Hành động nhanh
+
+Kiểm soát với các hành động một lần nhấp có sẵn trên mỗi thẻ email:
+*   🗑️ **Xóa / 📦 Lưu trữ**: Dọn dẹp tức thì.
+*   ⭐ **Gắn sao / Gắn cờ**: Đánh dấu các mục quan trọng để xem sau.
+*   🔄 **Xử lý lại**: Nếu bạn đã cập nhật các quy tắc của mình, bạn có thể yêu cầu AI phân tích lại một email.
+*   💬 **Phản hồi**: Giúp AI học hỏi bằng cách báo cáo các phân loại hoặc phân tích cảm xúc không chính xác.
+
+---
+
+## 🔔 Thông báo & Phản hồi
+
+Ứng dụng sử dụng phản hồi đa giác quan để thông báo cho bạn về hoạt động nền:
+*   **Hình ảnh**: Các huy hiệu trạng thái trực tiếp và thông báo toast.
+*   **Âm thanh**: Tiếng chuông tinh tế, chất lượng cao cho email mới, cảnh báo ưu tiên cao và hoàn thành đồng bộ hóa.
+*   **Xúc giác**: Phản hồi vật lý trên các thiết bị được hỗ trợ.
+
+> **Lưu ý**: Các cài đặt Âm thanh và Xúc giác có thể được tùy chỉnh trong [**Cài đặt tài khoản**](./ACCOUNT.md).
+
+---
+
+## 📈 Phân tích & Lịch sử
+
+Luôn nắm bắt thông tin về hiệu suất của tác nhân:
+*   **Lịch sử đồng bộ hóa**: Xem nhật ký các lần chạy đồng bộ gần đây, bao gồm số lượng email được xử lý và bất kỳ hành động nào được thực hiện.
+*   **Thống kê hiệu quả**: Xem tổng số các lần xóa, lưu trữ và bản nháp tự động theo thời gian.
+
+---
+
+**Bước tiếp theo:** [Tạo các quy tắc tự động hóa](./AUTOMATION.md)

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

@@ -0,0 +1,61 @@
+# Bắt đầu
+
+Chào mừng bạn đến với **Email Automator**, trợ lý email cá nhân hỗ trợ bởi AI của bạn. Hướng dẫn này sẽ giúp bạn thiết lập ứng dụng bằng mô hình **"Bring Your Own Key" (BYOK)**, đảm bảo dữ liệu của bạn luôn nằm trong tầm kiểm soát của bạn trong cơ sở hạ tầng Supabase của riêng bạn.
+
+## 🛠 Điều kiện tiên quyết
+
+Trước khi bắt đầu, hãy đảm bảo bạn có các thứ sau:
+
+1.  **RealTimeX Desktop**: Đã được cài đặt và đang chạy. Đây là yêu cầu bắt buộc cho việc xử lý AI (LLMs) và các tính năng Chuyển văn bản thành giọng nói (TTS).
+2.  **Tài khoản Supabase**: Một tài khoản miễn phí hoặc trả phí tại [supabase.com](https://supabase.com).
+
+---
+
+## 🚀 Thiết lập nhanh với Wizard
+
+**Setup Wizard** tích hợp sẵn là cách được khuyến nghị để bắt đầu. Nó tự động hóa các công việc kỹ thuật nặng nhọc.
+
+### 1. Mua & Khởi chạy
+*   Mở **RealTimeX Desktop**.
+*   Đi tới tab **Marketplace** → **Local Apps**.
+*   Tìm kiếm **"Email Automator"** và mua nó (hoặc kích hoạt nếu đã sở hữu).
+*   Sau khi mua, nhấp vào **Launch** từ danh sách Local Apps của bạn.
+
+### 2. Chạy Setup Wizard
+Trong lần khởi chạy đầu tiên, ứng dụng sẽ hướng dẫn bạn qua cấu hình ban đầu:
+
+*   **Chọn đường dẫn thiết lập**:
+    *   **Managed Provisioning (Khuyến nghị)**: Cung cấp **Supabase Access Token**. Wizard sẽ tự động tạo một dự án mới, chạy các di chuyển cơ sở dữ liệu (migrations), triển khai Edge Functions và nạp cơ sở kiến thức ban đầu.
+    *   **Connect Existing Project**: Sử dụng một dự án Supabase hiện có bằng cách cung cấp **Project URL** và **Anon Key**. Bạn cũng có thể tùy chọn cung cấp Access Token để Wizard chạy các di chuyển cho bạn.
+
+### 3. Tạo tài khoản của bạn
+Sau khi cơ sở dữ liệu đã sẵn sàng, bạn sẽ được nhắc tạo tài khoản người dùng cục bộ và đăng nhập để truy cập **Dashboard**.
+
+---
+
+## 🔍 Tìm thông tin xác thực Supabase của bạn
+
+Nếu bạn chọn kết nối thủ công một dự án hiện có, bạn có thể tìm thấy thông tin xác thực của mình trong [Supabase Dashboard](https://supabase.com/dashboard):
+
+1.  Chọn dự án của bạn.
+2.  Điều hướng đến **Settings** → **API**.
+3.  **Project URL**: Sao chép URL tìm thấy trong mục "Project URL".
+4.  **API Key**: Sao chép khóa **anon (public)** trong mục "Project API keys".
+
+> [!WARNING]
+> **Lưu ý bảo mật**: Không bao giờ sử dụng khóa `service_role`. Nó có toàn quyền quản trị và không bao giờ được để lộ trong các ứng dụng phía khách hàng (client-side).
+
+---
+
+## 🪪 Tạo Access Token
+
+Access Token cho phép Setup Wizard quản lý các dự án Supabase của bạn (tạo, di chuyển, triển khai chức năng) thay mặt bạn.
+
+1.  Trong Supabase Dashboard, đi tới **Account** → **Access Tokens**.
+2.  Nhấp vào **Generate new token**, đặt tên cho nó (ví dụ: "Email Automator") và sao chép kết quả.
+3.  Dán token này vào Setup Wizard khi được nhắc.
+
+---
+
+**Bước tiếp theo:** [Cấu hình tài khoản Email của bạn](./CONFIGURATION.md)  
+**Thuật ngữ:** [Các thuật ngữ phổ biến](./GLOSSARY.md)