# 用語集

Email Automator およびセットアップウィザードで使用される一般的な用語の定義。

## Supabase
ホストされた Postgres データベース、認証、ストレージ、および API を提供するバックエンドプラットフォーム。Email Automator は、Supabase をデータベースおよび認証レイヤーとして使用します。

## BYOK (Bring Your Own Key)
共有バックエンドを使用する代わりに、独自の Supabase プロジェクトを接続するセットアップモデル。これにより、データはあなた自身のインフラストラクチャ内に保持されます。

## Supabase プロジェクト ID
Supabase プロジェクトの一意の識別子（多くの場合、プロジェクト URL または設定に表示されます）。

## Supabase プロジェクト URL
アプリがデータベースや API に接続するために使用する、Supabase プロジェクトのベース URL。

## Anon キー (公開 API キー)
Supabase プロジェクトの公開 API キー。クライアント側での使用は安全ですが、行レベルセキュリティ (RLS) の対象となります。

## アクセストークン
セットアップウィザードがあなたに代わってプロジェクトを作成または管理できるようにする、Supabase アカウントからのトークン（クイックスタートで使用）。

## マネージド・プロビジョニング (クイックスタート)
セットアップウィザードがアクセストークンを使用して、Supabase プロジェクトの作成、マイグレーションの適用、Edge Functions のデプロイ、およびナレッジベースの取り込みを自動的に行います。

## 手動同期 (既存のプロジェクトに接続)
プロジェクト URL と Anon キーを提供して、既存の Supabase プロジェクトに接続します。アクセストークンが提供されている場合は、ウィザードでマイグレーションを実行できます。

## マネージド・プロビジョニング vs 手動同期
**マネージド・プロビジョニング**は、アクセストークンを使用して新しい Supabase プロジェクトを作成します。
**手動同期**は、プロジェクト URL と Anon キーを使用して既存の Supabase プロジェクトに接続します。

## マイグレーション
テーブル、ビュー、関数、およびポリシーを作成または更新するデータベースの変更。マイグレーションにより、データベーススキーマがアプリと整合した状態に保たれます。

## スキーマ
テーブル、列、タイプ、インデックス、関数、およびポリシーなど、データベースの構造。

## SQL
データベースの構造やデータを定義およびクエリするために使用される言語。

## バージョンの不一致 (Version Mismatch)
アプリが期待するスキーマバージョンと、データベースの実際のバージョンが異なる状態。セットアップウィザードまたはマイグレーションツールから正規化を求められます。

## データベースバージョン (アカウント設定)
アカウント設定に表示されるデータベースのメジャーバージョン。マイグレーションのガイドに使用され、Supabase プロジェクトの Postgres バージョンと一致する必要があります。

## ロールバック
マイグレーションを元に戻すこと。Supabase ではロールバックは手動であり、慎重に使用する必要があります。

## RLS (行レベルセキュリティ)
ユーザーが読み書きできる行を制限する Postgres のセキュリティ機能。Supabase は RLS を使用してデータを保護します。

## Edge Functions
Supabase によってホストされるサーバーレス関数。Email Automator は、OAuth フローや安全な操作のためにこれらを使用します。

## サービスロールキー (Service Role Key)
RLS をバイパスする強力な Supabase キー。クライアントに公開してはいけません。

## Anon キー vs サービスロールキー
**Anon キー**はクライアントでの使用に安全で、RLS を尊重します。**サービスロールキー**は RLS をバイパスし、信頼できるサーバー上でのみ使用する必要があります。

## RealTimeX Desktop
Email Automator が使用する AI サービス (LLM、埋め込み、TTS) を提供するローカルアプリ。

## デジタルペルソナ
AI が生成するドラフトや返信のトーン、スタイル、好みを定義するプロファイル。

## ペルソナのトーン
返信の感情的な特徴（例：フレンドリー、フォーマル、直接的）。

## ペルソナのスタイル
文章スタイルの好み（例：簡潔、詳細、箇条書き）。

## ペルソナのボイス
言い回しやリズムを含む、あなたの文章全体の「響き」。

## ペルソナの署名
返信で使用される標準化された結びの言葉（名前、役職、会社名）。

## ペルソナの役割
返信の枠組みを形作るために使用される、あなたの役職や役割。

## ペルソナの会社
適切な場合に返信で使用される組織名。

## ペルソナの言語
生成されるドラフトの主要言語。

## Express API
メールの同期、 AI 処理、および自動化の実行を処理するローカルバックエンド。

## Realtime (Supabase)
データベースからアプリへのライブアップデート。リフレッシュすることなく、新しいメール、同期ステータス、またはアクティビティを反映するために使用されます。

## LLM (大規模言語モデル)
分析や回答の生成（例：カテゴリ分け、返信のドラフト作成）に使用される AI モデル。

## 埋め込みモデル
テキストを意味検索用のベクトルに変換するモデル。ナレッジベースと RAG で使用されます。

## 埋め込み (Embeddings)
ナレッジベースでの意味検索に使用されるテキストのベクトル表現。

## RAG (検索拡張生成)
関連するドキュメントを検索して AI に提供することで、回答がドキュメントに基づいた内容になるようにする手法。

## ナレッジベースの取り込み
ドキュメントを検索可能な埋め込みに変換し、データベースに保存するプロセス。

## TTS (テキスト読み上げ)
AI の回答を音声に変換します。

## TTS プロバイダー vs 音声
プロバイダーは音声を生成するサービスであり、音声はそのプロバイダー内の特定のスピーカー/ペルソナです。

## OAuth
パスワードを保存せずに、アプリがあなたのメールアカウントにアクセスできるようにする認可標準。

## OAuth 同意画面
Email Automator にメールアカウントへのアクセス許可を与える画面。

## アクセストークン (OAuth)
メールプロバイダーの API を呼び出すために使用される短期間のトークン。期限が切れると自動的にリフレッシュされます。

## リフレッシュトークン
再認証することなく新しいアクセストークンを取得するために使用される長期間のトークン。

## Gmail API
Gmail のデータにアクセスし、メールを送信するための Google の公式 API。

## Microsoft Graph
Outlook および Microsoft 365 のデータ（メール、カレンダー、連絡先）にアクセスするための Microsoft の API。

## IMAP / SMTP
メールプロトコル。IMAP はメールを読み取り、SMTP はメールを送信します（Email Automator は生の IMAP/SMTP ではなく、プロバイダーの API を使用します）。

## アプリの登録 (Microsoft)
Microsoft Graph へのアクセスのための認証情報を提供する Azure 内のアプリ構成。

## クライアント ID
OAuth アプリ（Google/Microsoft）の公開識別子。

## クライアントシークレット
OAuth アプリのプライベートな秘密鍵。パスワードのように扱ってください。

## リダイレクト URI
OAuth 認可後にメールプロバイダーがユーザーをリダイレクトするコールバック URL。

## デバイスコードフロー
ブラウザで短縮コードを使用して認証する OAuth フロー。デスクトップアプリでよく使用されます。

## テナント ID
Microsoft のテナント識別子。マルチテナントの場合は「common」を、組織限定アクセスの場合は特定のテナント ID を使用します。

## 同期範囲
同期する履歴の量（例：過去 X 日分）や、含まれるアカウントを定義します。

## ラベル (Gmail) / フォルダ (Outlook)
メールプロバイダーにおける整理の仕組み。ラベルはメッセージにタグを付け、フォルダはメッセージをコンテナに整理します。