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 — 수정 시각 — 비밀번호·상태 변경 시 토큰 자동무효화 판단 기준으로도 사용