Arcana

Tables (11)

data_source_sync_state (노션 동기화 진행 지점(커서/증분만 저장))

  • idx — BIGINT — Primary key — 동기화 상태 PK
  • data_source_idx — BIGINT — Foreign key → data_sources.idx — NOT NULL — 대상 데이터 소스 FK(1:1)
  • last_full_sync — DATETIME — 마지막 전체 스캔 완료 시각
  • since — DATETIME — 증분 기준 시각(예: last_edited_time)
  • next_cursor — VARCHAR(255) — 노션 페이지네이션 재개 커서
  • rate_limited_until — DATETIME — 레이트 리밋 해제 예상 시각
  • created — DATETIME — NOT NULL — 레코드 생성 시각
  • updated — DATETIME — NOT NULL — 마지막 갱신 시각

data_sources (외부 데이터 소스 연결)

  • idx — BIGINT — Primary key — 데이터 소스 인스턴스 PK
  • workspace_idx — BIGINT — Foreign key → workspaces.idx — NOT NULL — 소스가 귀속되는 워크스페이스 FK
  • type — ENUM('notion','local') — NOT NULL — 소스 종류(MVP: notion, local)
  • name — VARCHAR(200) — NOT NULL — 소스 표시명(구분용)
  • status — ENUM('connected', 'disconnected', 'error') — NOT NULL — 연결 상태
  • synced — DATETIME — 마지막 성공 동기화 시각
  • created — DATETIME — NOT NULL — 생성 시각

google_drive_file_snapshots (구글 드라이브 파일 스냅숏)

  • idx — BIGINT — Primary key — 파일 스냅샷 PK
  • data_source_idx — BIGINT — Foreign key → data_sources.idx — NOT NULL — Google Drive 데이터 소스 FK
  • file_id — VARCHAR(128) — NOT NULL — Google Drive 파일 ID
  • name — VARCHAR(1024) — 파일 이름
  • mime_type — VARCHAR(255) — NOT NULL — MIME 타입
  • md5_checksum — VARCHAR(128) — 바이너리 체크섬
  • version — BIGINT — Google Workspace 파일 버전
  • modified_time — DATETIME — 마지막 수정 시각
  • web_view_link — VARCHAR(1024) — 웹 링크
  • last_synced — DATETIME — NOT NULL — 마지막 인덱싱 시각
  • created — DATETIME — NOT NULL — 레코드 생성 시각
  • updated — DATETIME — NOT NULL — 레코드 갱신 시각

google_drive_oauth_credentials (구글 드라이브 인증)

  • idx — BIGINT — Primary key — 자격증명 PK
  • user_idx — BIGINT — Foreign key → users.idx — NOT NULL — 승인한 사용자 FK
  • data_source_idx — BIGINT — Foreign key → data_sources.idx — NOT NULL — 연결된 데이터 소스 FK
  • provider — VARCHAR(50) — NOT NULL — 제공자 식별
  • google_user_id — VARCHAR(255) — 구글 사용자 식별자(sub)
  • email — VARCHAR(255) — 구글 계정 이메일
  • token_type — VARCHAR(20) — NOT NULL — 토큰 타입
  • access_token — TEXT — NOT NULL — 액세스 토큰
  • refresh_token — TEXT — 리프레시 토큰
  • scope — TEXT — 동의된 스코프
  • id_token — TEXT — ID 토큰(JWT)
  • expires — DATETIME — 액세스 토큰 만료 시각
  • created — DATETIME — NOT NULL — 자격증명 생성 시각
  • updated — DATETIME — NOT NULL — 자격증명 갱신 시각
  • provider_payload — JSON — 원본 응답(JSON)

google_drive_sync_state (구글 드라이브 파일 동기화)

  • idx — BIGINT — Primary key — 동기화 상태 PK
  • data_source_idx — BIGINT — Foreign key → data_sources.idx — NOT NULL — Google Drive 데이터 소스 FK
  • start_page_token — VARCHAR(255) — Changes API startPageToken
  • pending_page_token — VARCHAR(255) — Changes API nextPageToken pagination cursor
  • latest_history_id — VARCHAR(255) — 마지막 historyId(미사용 가능)
  • bootstrapped_at — DATETIME — 최초 전체 스캔 완료 시각
  • last_synced — DATETIME — 마지막 증분 동기화 시각
  • created — DATETIME — NOT NULL — 레코드 생성 시각
  • updated — DATETIME — NOT NULL — 레코드 갱신 시각

memberships (조직 권한)

  • idx — BIGINT — Primary key — 멤버십 PK
  • user_idx — BIGINT — Foreign key → users.idx — NOT NULL — 사용자 FK
  • organization_idx — BIGINT — Foreign key → organizations.idx — NOT NULL — 조직 FK
  • role — ENUM('owner', 'admin', 'member') — NOT NULL — 조직 내 역할
  • created — DATETIME — NOT NULL — 가입(생성) 시각

notion_oauth_credentials (노션 OAuth 토큰/메타(비밀 값))

  • idx — BIGINT — Primary key — 자격증명 PK
  • user_idx — BIGINT — Foreign key → users.idx — NOT NULL — 승인한 사용자 FK(누가 연결했는지)
  • data_source_idx — BIGINT — Foreign key → data_sources.idx — NOT NULL — 연결된 데이터 소스 FK
  • provider — VARCHAR(50) — NOT NULL — 제공자 식별(예: notion)
  • bot_id — VARCHAR(100) — NOT NULL — 설치/authorization 고유 ID(Notion 권장)
  • provider_workspace_id — VARCHAR(64) — Notion 워크스페이스 ID(참고 메타)
  • workspace_name — VARCHAR(255) — 승인 당시 워크스페이스 이름(표시용)
  • workspace_icon — VARCHAR(1000) — 승인 당시 워크스페이스 아이콘 URL(표시용)
  • token_type — VARCHAR(20) — NOT NULL — 토큰 타입(일반적으로 bearer)
  • access_token — TEXT — NOT NULL — 액세스 토큰(암호화 저장 권장)
  • refresh_token — TEXT — 리프레시 토큰(암호화 저장 권장)
  • expires — DATETIME — 액세스 토큰 만료 시각
  • created — DATETIME — NOT NULL — 자격증명 생성 시각
  • updated — DATETIME — NOT NULL — 자격증명 갱신 시각
  • provider_payload — JSON — 원문 응답 보관(디버그/추적용)

organizations (조직(회사/팀))

  • idx — BIGINT — Primary key — 조직 PK
  • name — VARCHAR(200) — NOT NULL — 조직명
  • created — DATETIME — NOT NULL — 조직 생성 시각

rag_indexes (워크스페이스별 RAG 인덱스)

  • idx — BIGINT — Primary key — RAG 인덱스 메타 PK
  • workspace_idx — BIGINT — Foreign key → workspaces.idx — NOT NULL — 귀속 워크스페이스 FK
  • name — VARCHAR(200) — NOT NULL — 인덱스 이름(예: default)
  • index_type — ENUM('faiss', 'qdrant', 'weaviate', 'pgvector') — NOT NULL — 인덱스 엔진 종류
  • storage_uri — VARCHAR(1000) — 파일형(Faiss) 사용 시 저장 경로(S3/로컬)
  • dim — INT — NOT NULL — 임베딩 차원 수
  • status — ENUM('ready', 'building', 'failed') — NOT NULL — 인덱스 상태
  • object_count — INT — NOT NULL — 색인된 외부 오브젝트 수(예: 노션 페이지 수)
  • vector_count — INT — NOT NULL — 저장된 벡터 엔트리 수
  • updated — DATETIME — NOT NULL — 마지막 갱신 시각

users

  • idx — BIGINT — Primary key — 내부 PK(시스템 식별자)
  • id — VARCHAR(255) — NOT NULL — 로그인용 사용자 ID(사용자 입력값)
  • email — VARCHAR(255) — NOT NULL — 이메일(로그인/알림/비밀번호 재설정)
  • nickname — VARCHAR(100) — 표시 이름(닉네임)
  • password_hash — VARCHAR(255) — NOT NULL — 비밀번호 해시(bcrypt/Argon2 등)
  • type — ENUM('personal', 'organization') — NOT NULL — 사용자 타입(personal/organization)
  • active — TINYINT(1) — NOT NULL — 계정 활성 여부(1=활성, 0=비활성/차단)
  • created — DATETIME — NOT NULL — 계정 생성 시각
  • last_login — DATETIME — 마지막 로그인 시각

workspaces (사용자 워크스페이스)

  • idx — BIGINT — Primary key — 워크스페이스 PK
  • owner_user_idx — BIGINT — Foreign key → users.idx — 개인 워크스페이스 소유자 FK(personal일 때만)
  • organization_idx — BIGINT — Foreign key → organizations.idx — 조직 워크스페이스 소속 조직 FK(organization일 때만)
  • type — ENUM('personal', 'organization') — NOT NULL — 워크스페이스 종류(personal/organization)
  • name — VARCHAR(200) — NOT NULL — 워크스페이스 표시 이름
  • created — DATETIME — NOT NULL — 생성 시각