Metriever_260810

Tables (35)

api_histories

  • id — bigserial — Primary key — NOT NULL — 기본키
  • api_key_id — uuid — Foreign key → api_keys.id — NOT NULL — 요청에 사용된 키
  • req_id — varchar(64) — NOT NULL — 요청 고유 식별자
  • status — varchar(20) — NOT NULL — RECEIVED/PROCESSING/SUCCESS/FAILED/TIMED_OUT
  • requested_at — timestamptz — NOT NULL — 요청 수신 시각
  • completed_at — timestamptz — 처리 완료 시각
  • status_code — int — HTTP 응답 상태 코드
  • error_code — varchar(50) — 내부 오류 코드
  • input_tokens — int — 입력 토큰 수
  • output_tokens — int — 출력 토큰 수
  • trace_id — varchar(64) — 외부 트레이스 식별자, 내부 trace와 무관
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

api_keys

  • id — uuid — Primary key — NOT NULL — 기본키
  • api_organization_id — uuid — Foreign key → api_organizations.id — NOT NULL — 이 키가 속한 기관별 이용 권한
  • name — varchar(255) — NOT NULL — 사람이 구분할 라벨
  • key_prefix — varchar(20) — NOT NULL — 화면 노출용 일부 문자열
  • key_hash — varchar(255) — NOT NULL — 실제 키의 해시
  • status — varchar(20) — NOT NULL — ACTIVE/REVOKED/EXPIRED
  • issued_by — uuid — Foreign key → users.id — NOT NULL — 발급한 관리자
  • issued_at — timestamptz — NOT NULL — 발급 시각
  • expires_at — timestamptz — 만료 예정일
  • last_used_at — timestamptz — 마지막 사용 시각
  • revoked_by — uuid — Foreign key → users.id — 폐기한 관리자
  • revoked_at — timestamptz — 폐기 시각
  • monthly_limit — int — 키별 월간 한도, 없으면 기관 기본값 적용
  • rate_limit — int — 키별 요청 한도, 없으면 기관 기본값 적용
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

api_organizations

  • id — uuid — Primary key — NOT NULL — 기본키
  • api_id — uuid — Foreign key → apis.id — NOT NULL — 대상 API
  • organization_id — uuid — Foreign key → organizations.id — NOT NULL — 대상 기관
  • monthly_limit — int — 월간 요청 한도(기관 기본값)
  • rate_limit — int — 초당/분당 요청 한도(기관 기본값)
  • start_date — date — 이용 시작일
  • end_date — date — 이용 종료일
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

apis

  • id — uuid — Primary key — NOT NULL — 기본키
  • name — varchar(255) — NOT NULL — API 이름
  • status — varchar(50) — NOT NULL — 제공 상태
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

atoms

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chunk_id — bigint — Foreign key → chunks.id — NOT NULL — 소속 청크
  • atom_text — text — NOT NULL — 검색 대상 텍스트
  • embedding — vector(1536) — 벡터 임베딩
  • atom_tsv — tsvector — BM25용 인덱스
  • embedding_tokens — int — 임베딩 API 호출 토큰 수
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

audit_logs

  • id — uuid — Primary key — NOT NULL — 기본키
  • actor_type — varchar(20) — NOT NULL — 작업 주체 유형: USER/SYSTEM/API_KEY
  • actor_user_id — uuid — 작업을 수행한 사람, FK 없음(탈퇴 시 개인정보 삭제 의무로 원본 행이 사라져도 로그는 보존)
  • actor_api_key_id — uuid — Foreign key → api_keys.id — 작업을 수행한 API Key, actor_type=API_KEY일 때만 값 존재
  • organization_id — uuid — Foreign key → organizations.id — 작업 범위 기관, 전역이면 NULL
  • action — varchar(100) — NOT NULL — 작업 종류
  • target_type — varchar(50) — NOT NULL — 대상 엔티티 타입
  • target_id — varchar(255) — NOT NULL — 대상 엔티티 id
  • before_data — jsonb — 변경 전 값, 개인정보 필드는 저장하지 않음
  • after_data — jsonb — 변경 후 값, 개인정보 필드는 저장하지 않음
  • reason — varchar(255) — 조치 사유(운영자 수동 개입 등), nullable
  • created_at — timestamptz — NOT NULL — 생성 시각 — append-only

auth_sessions

  • id — uuid — Primary key — NOT NULL — 기본키, Access Token sid claim과 매칭
  • user_id — uuid — Foreign key → users.id — NOT NULL — 세션 소유 사용자
  • refresh_token_hash — varchar(255) — NOT NULL — refresh token 해시값(원문 미저장)
  • token_family_id — uuid — NOT NULL — 토큰 회전 체인 식별자 — 재사용 탐지 시 이 값 기준으로 전체 revoke
  • device_name — varchar(255) — 기기 표시명, nullable
  • user_agent_hash — varchar(255) — User-Agent 해시, nullable
  • created_at — timestamptz — NOT NULL — 세션 시작(로그인) 시각
  • last_used_at — timestamptz — NOT NULL — 마지막 활동(리프레시) 시각
  • expires_at — timestamptz — NOT NULL — 세션 만료 시각
  • revoked_at — timestamptz — 무효화 시각, nullable
  • revocation_reason — varchar(50) — 무효화 사유(code 관리): LOGOUT/LOGOUT_ALL/PASSWORD_CHANGE/TOKEN_REUSE_DETECTED/ADMIN_SUSPEND/MAX_SESSIONS_EXCEEDED 등
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_detail_claim_references

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chat_detail_claim_id — bigint — Foreign key → chat_detail_claims.id — NOT NULL — 인용을 포함한 문장
  • chat_detail_document_id — bigint — Foreign key → chat_detail_documents.id — NOT NULL — 그 문장이 인용한 참조
  • created_at — timestamptz — NOT NULL — 생성 시각

chat_detail_claims

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 소속 메시지(AI 답변)
  • claim_text — text — NOT NULL — 생성된 문장 원문(인용 마커 제외)
  • sentence_index — int — NOT NULL — 답변 전체 기준 문장 순번(인용 없는 문장도 포함해서 셌, 인용 붙은 문장만 행으로 존재)
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_detail_document_evidences

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chat_detail_document_id — bigint — Foreign key → chat_detail_documents.id — NOT NULL — 소속 참조
  • chunk_id — bigint — 근거 청크, FK 제약 없음(문서 재처리 시 청크 재생성 대비)
  • atom_id — bigint — 근거 원자, FK 제약 없음
  • source_version_ref — timestamptz — 인용 시점 문서 버전 스낵샷 — 산출 방식 미정(documents 버전 컴럼 신설 vs documents.updated_at 스낵샷)
  • page — int — 페이지 번호, nullable
  • section — varchar(255) — 섹션명, nullable
  • retrieved_text_hash — varchar(128) — 검색 시점 원문 해시, 무결성 검증용
  • citation_text — text — 인용된 원문 문장(원본 소스 쪽)
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_detail_documents

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 인용한 메시지(AI 답변)
  • document_id — uuid — Foreign key → documents.id — NOT NULL — 인용된 문서
  • reference_number — int — NOT NULL — 답변 본문 n 인용 순서, 메시지 내 유일
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_detail_feedbacks

  • id — uuid — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 대상 메시지(AI 답변)
  • user_id — uuid — Foreign key → users.id — NOT NULL — 피드백을 남긴 사용자
  • rating — varchar(10) — NOT NULL — LIKE 또는 DISLIKE
  • comment — text — 선택적 코멘트
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_detail_reports

  • id — uuid — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 신고 대상 메시지(AI 답변)
  • reporter_user_id — uuid — Foreign key → users.id — NOT NULL — 신고한 사용자
  • reason — text — 신고 사유
  • status — varchar(20) — NOT NULL — PENDING/REVIEWED/DISMISSED
  • reviewed_by — uuid — Foreign key → users.id — 검토한 운영자
  • reviewed_at — timestamptz — 검토 시각
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_details

  • id — bigserial — Primary key — NOT NULL — 기본키(전역 순번)
  • chat_id — uuid — Foreign key → chats.chat_id — NOT NULL — 소속 채팅방
  • sender_type — varchar(20) — NOT NULL — USER 또는 AI
  • in_reply_to_id — bigint — Foreign key → chat_details.id — 답한 USER 메시지, AI 행에만 값(nullable) — 채팅창 렌더링용 직접 참조
  • message — text — 원문 메시지 본문 — 보존기간 만료 시 chat_details_masked의 마스킹본으로 덮어쓰여짐. 암호화 안 함(고빈도 조회 테이블, 작성자·RAG 후속질문 컸텍스트용으로 원문이 필요해 성능 우선)
  • masking_status — varchar(20) — 원문 보관 상태(code 관리): STORED(message에 원문 보관 중)/PURGED(보존기간 만료로 message가 마스킹본으로 교체됨)/NOT_APPLICABLE — 마스킹본은 chat_details_ma…
  • status — varchar(20) — COMPLETE/PARTIAL/FAILED/CANCELLED/REFUSED/NO_CONTEXT — AI 행에만 의미있음
  • answer_mode — varchar(10) — FAST/AUTO(F081) — USER 행에만 값, 질문 보낼 때 선택
  • chat_message_no — int — 이 채팅방 안에서 몇 번째 메시지인지 — 전역 id 노출 부담 없는 Request ID 대안, chat_id 기준 UNIQUE
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chat_details_masked

  • id — uuid — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 대상 메시지, 1:1(UNIQUE)
  • masked_message — text — NOT NULL — 마스킹 처리된 메시지 본문
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chats

  • chat_id — uuid — Primary key — NOT NULL — 기본키
  • user_id — uuid — Foreign key → users.id — NOT NULL — 채팅방 소유자
  • title — varchar(255) — 채팅방 제목(자동 생성)
  • deleted_at — timestamptz — 소프트 삭제 시각
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

chunks

  • id — bigserial — Primary key — NOT NULL — 기본키
  • document_id — uuid — Foreign key → documents.id — NOT NULL — 소속 문서
  • chunk_index — int — NOT NULL — 문서 내 순서
  • chunk_text — text — NOT NULL — 청크 본문
  • token_count — int — 향후 청크 단위 LLM 처리용
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

contact_inquiries

  • id — uuid — Primary key — NOT NULL — 기본키
  • user_id — uuid — Foreign key → users.id — 문의자, 비로그인 문의는 NULL 가능
  • email — varchar(255) — NOT NULL — 문의자 연락 이메일
  • category — varchar(50) — 답변오류/API장애/계정문제/개인정보보안/일반문의(code 관리)
  • message — text — NOT NULL — 문의 내용
  • status — varchar(20) — NOT NULL — PENDING/IN_PROGRESS/RESOLVED
  • reviewed_by — uuid — Foreign key → users.id — 처리한 운영자
  • reviewed_at — timestamptz — 처리 시각
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

contact_inquiry_attachments

  • id — uuid — Primary key — NOT NULL — 기본키
  • contact_inquiry_id — uuid — Foreign key → contact_inquiries.id — NOT NULL — 소속 문의
  • file_name — varchar(255) — 파일명
  • mime_type — varchar(100) — 파일 종류
  • file_path — text — NOT NULL — 오브젝트 스토리지(S3) 경로
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

documents

  • id — uuid — Primary key — NOT NULL — 기본키
  • name — varchar(255) — NOT NULL — 문서명
  • source_type — varchar(50) — NOT NULL — 출처 유형(code 관리)
  • status — varchar(50) — NOT NULL — 운영자 관점 처리 상태: PROCESSING/READY/SEARCH_DISABLED/DELETED
  • current_file_id — uuid — 원본 파일 스키마 확정 전 자리표시자, FK 없음
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

login_histories

  • id — bigserial — Primary key — NOT NULL — 기본키
  • user_id — uuid — Foreign key → users.id — NOT NULL — 로그인 시도한 사용자
  • login_ip — varchar(64) — 접속 IP
  • login_time — timestamptz — NOT NULL — 시도 시각
  • try_cnt — int — NOT NULL — 직전 연속 실패 횟수(생성 시점 스냅샷), 성공 시 0
  • created_at — timestamptz — NOT NULL — 생성 시각

material_chunks

  • id — uuid — Primary key — NOT NULL — 기본키
  • material_id — uuid — Foreign key → materials.id — NOT NULL — 참조된 표/이미지
  • chunk_id — bigint — Foreign key → chunks.id — NOT NULL — 참조하는 청크
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

materials

  • id — uuid — Primary key — NOT NULL — 기본키
  • document_id — uuid — Foreign key → documents.id — NOT NULL — 소속 문서
  • file_name — varchar(100) — NOT NULL — 파일명
  • mime_type — varchar(100) — MIME 타입
  • file_path — text — 오브젝트 스토리지 경로 예정
  • page_number — int — 원문 페이지 번호
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

metadata

  • id — uuid — Primary key — NOT NULL — 기본키
  • document_id — uuid — Foreign key → documents.id — NOT NULL — 대상 문서
  • field_name — varchar(100) — NOT NULL — EAV 필드명
  • field_value — text — EAV 필드값
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

organization_documents

  • id — uuid — Primary key — NOT NULL — 기본키
  • organization_id — uuid — Foreign key → organizations.id — NOT NULL — 대상 기관
  • document_id — uuid — Foreign key → documents.id — NOT NULL — 대상 문서
  • status — varchar(50) — NOT NULL — 계약 관점 노출 상태: ACTIVE/SUSPENDED
  • is_used — boolean — NOT NULL — 사용여부(운영자가 실사용 여부를 별도 표시)
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

organizations

  • id — uuid — Primary key — NOT NULL — 기본키
  • name — varchar(255) — NOT NULL — 기관명
  • display_name — varchar(255) — 화면 표시용 이름
  • slug — varchar(255) — NOT NULL — URL·식별용 고유 문자열
  • status — varchar(50) — NOT NULL — 기관 상태(code 관리 예정)
  • is_system — boolean — NOT NULL — "소속없음" 등 시스템용 sentinel row 여부 — 일반 목록 조회 시 제외
  • contact_email — varchar(255) — 기본 연락처 이메일
  • contact_phone — varchar(50) — 기본 연락처 전화번호
  • user_limit — int — 최대 사용자 수, NULL이면 무제한
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

role_categories

  • code — varchar(50) — Primary key — NOT NULL — 기본키(카테고리 코드)
  • name — varchar(100) — NOT NULL — 화면 표시명
  • description — text — 설명
  • display_order — int — NOT NULL — 화면 정렬 순서
  • is_active — boolean — NOT NULL — 비활성화 시 신규 역할에 사용 금지(기존 참조는 유지)
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

roles

  • id — uuid — Primary key — NOT NULL — 기본키
  • code — varchar(100) — NOT NULL — 권한 코드
  • category — varchar(50) — Foreign key → role_categories.code — NOT NULL — 기능 영역, role_categories(code) 참조
  • description — text — 권한 설명
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

sensitive_access_logs

  • id — uuid — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — 열람된 원문 메시지
  • actor_user_id — uuid — Foreign key → users.id — NOT NULL — 열람한 운영자
  • reason — varchar(255) — NOT NULL — 열람 사유(필수 입력)
  • accessed_at — timestamptz — NOT NULL — 열람 시각

spans

  • id — uuid — Primary key — NOT NULL — 기본키
  • trace_id — bigint — Foreign key → traces.id — NOT NULL — 소속 traces
  • no — int — NOT NULL — traces 내 단계 순번
  • type — varchar(100) — NOT NULL — 단계 종류
  • artifacts — jsonb — 단계별 파라미터
  • created_at — timestamptz — NOT NULL — 생성 시각

system_logs

  • id — uuid — Primary key — NOT NULL — 기본키
  • job_type — varchar(100) — NOT NULL — 작업 종류
  • status — varchar(20) — NOT NULL — PENDING/SUCCESS/FAILED
  • related_type — varchar(50) — 연관 대상 타입
  • related_id — varchar(255) — 연관 대상 id
  • started_at — timestamptz — NOT NULL — 시작 시각
  • completed_at — timestamptz — 종료 시각
  • error_message — text — 실패 시 오류 메시지
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

traces

  • id — bigserial — Primary key — NOT NULL — 기본키
  • chat_detail_id — bigint — Foreign key → chat_details.id — NOT NULL — USER 질문 메시지 — 항상 존재, 같은 질문에 대한 시도(재시도 포함)를 묶는 앞커
  • output_chat_detail_id — bigint — Foreign key → chat_details.id — 생성 성공 시 만들어진 AI 답변 메시지, nullable — 생성 완료 시점에 UPDATE로 채움
  • attempt_no — int — NOT NULL — 재시도 횟수, 같은 chat_detail_id 안에서 1부터 증가
  • status — varchar(20) — NOT NULL — QUEUED/RUNNING/SUCCESS/FAILED/CANCELLED/TIMED_OUT
  • started_at — timestamptz — 실행 시작 시각
  • completed_at — timestamptz — 실행 종료 시각
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

user_credential_tokens

  • id — uuid — Primary key — NOT NULL — 기본키
  • user_id — uuid — Foreign key → users.id — NOT NULL — 대상 사용자
  • token — varchar(255) — NOT NULL — 설정/재설정 링크 토큰
  • purpose — varchar(20) — NOT NULL — 용도: INITIAL_SETUP(관리자 생성 계정 최초 설정)/PASSWORD_RESET(비밀번호 찾기)
  • expires_at — timestamptz — NOT NULL — 토큰 만료 시각
  • used_at — timestamptz — 사용(비밀번호 설정 완료) 시각, nullable — 사용 전까지만 활성 토큰
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각 — used_at이 UPDATE로 채워지는 시점 판단 기준

user_roles

  • id — uuid — Primary key — NOT NULL — 기본키
  • user_id — uuid — Foreign key → users.id — NOT NULL — 권한을 받은 사용자
  • role_id — uuid — Foreign key → roles.id — NOT NULL — 부여된 권한
  • granted_by — uuid — Foreign key → users.id — NOT NULL — 부여한 관리자
  • granted_at — timestamptz — NOT NULL — 부여 시각
  • revoked_by — uuid — Foreign key → users.id — 회수한 관리자, nullable
  • revoked_at — timestamptz — NULL이면 현재 활성 상태
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각

users

  • id — uuid — Primary key — NOT NULL — 기본키
  • organization_id — uuid — Foreign key → organizations.id — NOT NULL — 소속 기관. 소속 없는 경우 is_system=true인 기관을 가리킴
  • email — varchar(255) — NOT NULL — 로그인 이메일
  • name — varchar(255) — NOT NULL — 이름
  • password — varchar(255) — NOT NULL — bcrypt 해시, 원문 저장 안 함. PENDING_SETUP 생성 시에는 추측 불가능한 랜덤 placeholder 해시로 채움(로그인 불가)
  • status — varchar(50) — NOT NULL — 계정 상태: PENDING(자가가입 승인대기, F055)/PENDING_SETUP(관리자 생성 계정, 최초 설정 대기)/ACTIVE/SUSPENDED/DELETED
  • role — varchar(50) — NOT NULL — 일반사용자/기관관리자/운영자(code 관리) — 관리 범위 판단 기준
  • last_login_at — timestamptz — 최근 로그인 시각
  • created_at — timestamptz — NOT NULL — 생성 시각
  • updated_at — timestamptz — NOT NULL — 수정 시각 — 비밀번호·상태 변경 시 토큰 자동무효화 판단 기준으로도 사용