# 용어 사전

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)
이메일 제공업체의 조직 구성 요소입니다. 라벨은 메시지에 태그를 지정하고 폴더는 메시지를 컨테이너로 구성합니다.