TecheDoc
테이블 (47)
API 호출 건수, 응답시간, 오류율 산출을 위한 사용 로그 테이블 (api_usage_logs)
- id — UUID
- api_key_id — UUID — 외래 키 → 외부 연동 및 API 호출용 API 키 관리 테이블.id
- user_id — UUID — 외래 키 → 사용자 관리.id — 호출
- endpoint — VARCHAR(240) — NOT NULL — 호출
- method — VARCHAR(12) — NOT NULL — HTTP
- status_code — INTEGER — NOT NULL — HTTP
- latency_ms — INTEGER — API
- request_id — VARCHAR(120) — 요청
- client_ip — INET — 호출
- error_code — VARCHAR(120) — 오류
- created_at — TIMESTAMPTZ — NOT NULL
Grafana, PagerDuty 등 외부 알림 Webhook 수신 설정 테이블 (webhook_endpoints)
- id — UUID
- name — VARCHAR(200) — NOT NULL
- provider — VARCHAR(80) — NOT NULL — Webhook
- secret_ref — TEXT — 서명
- enabled — BOOLEAN — NOT NULL — Webhook
- mapping_rules — JSONB — NOT NULL — 수신
- created_by — UUID — 외래 키 → 사용자 관리.id
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
Jira, ServiceNow 등 ITSM 연동 설정 테이블 (itsm_integrations)
- id — UUID
- provider — VARCHAR(80) — NOT NULL
- name — VARCHAR(200) — NOT NULL — 연동
- base_url — TEXT — NOT NULL — ITSM
- credentials_ref — TEXT — ITSM
- enabled — BOOLEAN — NOT NULL — 연동
- mapping_rules — JSONB — NOT NULL — 티켓
- created_by — UUID — 외래 키 → 사용자 관리.id
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
SharePoint, Google Drive, NAS 등 외부 문서 소스 설정 테이블 (external_sources)
- id — UUID
- name — VARCHAR(200) — NOT NULL
- source_type — VARCHAR(80) — NOT NULL — 외부
- base_uri — TEXT — NOT NULL — 동기화
- sync_enabled — BOOLEAN — NOT NULL — 자동
- sync_cron — VARCHAR(120) — 동기화
- credentials_ref — TEXT — 자격
- created_by — UUID — 외래 키 → 사용자 관리.id
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
검색 답변 또는 챗봇 답변에 대한 사용자 품질 피드백 테이블 (answer_feedback)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- query_id — UUID — 외래 키 → 사용자 검색 및 RAG 답변 요청 로그 테이블.id — 피드백
- chat_message_id — UUID — 외래 키 → 챗봇 대화 메시지 이력 테이블.id — 피드백
- rating — feedback_rating — NOT NULL — 도움됨
- comment — TEXT — 사용자
- label — JSONB — NOT NULL — RLHF
- created_at — TIMESTAMPTZ — NOT NULL
- CHECK — (query_id IS NOT NULL OR chat_message_id IS NOT NULL) — NOT NULL
검색 질의별 반환 문서와 청크 순위 결과 테이블 (search_results)
- id — UUID
- query_id — UUID — 외래 키 → 사용자 검색 및 RAG 답변 요청 로그 테이블.id — NOT NULL
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — 검색
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 검색
- rank — INTEGER — NOT NULL — 결과
- bm25_score — NUMERIC(12,6) — 키워드
- vector_score — NUMERIC(12,6) — 벡터
- rerank_score — NUMERIC(12,6) — 재랭킹
- confidence_score — NUMERIC(5,4) — 결과별
- snippet — TEXT — 검색
- created_at — TIMESTAMPTZ — NOT NULL
권한관리 (roles)
- id — UUID
- code — VARCHAR(80) — NOT NULL
- name — VARCHAR(120) — NOT NULL — 역할
- description — TEXT — 역할
- is_system — BOOLEAN — NOT NULL — 시스템
- created_at — TIMESTAMPTZ — NOT NULL
내부 장애와 외부 ITSM 티켓의 연결 상태 테이블 (itsm_ticket_links)
- id — UUID
- integration_id — UUID — 외래 키 → Jira, ServiceNow 등 ITSM 연동 설정 테이블.id — NOT NULL
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — 연결된
- external_ticket_key — VARCHAR(160) — NOT NULL — 외부
- external_status — VARCHAR(80) — 외부
- synced_at — TIMESTAMPTZ — 마지막
- metadata — JSONB — NOT NULL — 외부
멀티턴 AI 챗봇 대화 세션 테이블 (chat_sessions)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- title — VARCHAR(300) — 대화
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
문서 개정 이력과 버전별 파일 위치를 저장하는 테이블 (document_versions)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- version — VARCHAR(40) — NOT NULL — 버전
- storage_path — TEXT — NOT NULL — 해당
- file_hash — CHAR(64) — NOT NULL — 버전
- change_note — TEXT — 개정
- diff_summary — JSONB — NOT NULL — 이전
- created_id — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블 (document_chunks)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- document_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id — 청크가
- job_id — UUID — 외래 키 → 문서 파싱, 정제, 청킹, 임베딩, 인덱싱 비동기 작업 테이블.id — 청크를
- parent_chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 병합
- chunk_index — INTEGER — NOT NULL — 문서
- chunk_key — VARCHAR(120) — NOT NULL — 문서
- section_path — TEXT — 문서
- page_start — INTEGER — 청크
- page_end — INTEGER — 청크
- paragraph_start — VARCHAR(120) — 원본
- paragraph_end — VARCHAR(120) — 원본
- bbox — JSONB — PDF
- content — TEXT — NOT NULL — 청크
- content_tsv — TSVECTOR — 전문
- token_count — INTEGER — NOT NULL — 청크
- coherence_score — NUMERIC(5,4) — 청크
- quality_flag — BOOLEAN — NOT NULL — 품질
- status — chunk_status — NOT NULL — 청크
- metadata — JSONB — NOT NULL — 청크
- created_at — TIMESTAMPTZ — NOT NULL
문서 검색과 필터링에 사용하는 태그 마스터 테이블 (tags)
- id — UUID
- name — VARCHAR(120) — NOT NULL
- created_by — UUID — 외래 키 → 사용자 관리.id — 태그를
- created_at — TIMESTAMPTZ — NOT NULL
문서 단위 예외 접근 권한 설정 테이블 (document_acl)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- role_id — UUID — 외래 키 → 권한관리.id — 권한
- user_id — UUID — 외래 키 → 사용자 관리.id — 권한
- department_id — UUID — 외래 키 → 부서관리.id — 권한
- can_read — BOOLEAN — NOT NULL — 문서
- can_write — BOOLEAN — NOT NULL — 문서
- can_approve — BOOLEAN — NOT NULL — 문서
- created_at — TIMESTAMPTZ — NOT NULL
- CHECK — (role_id IS NOT NULL OR user_id IS NOT NULL OR department_id IS NOT NULL) — NOT NULL
문서 만료, 승인 요청, 처리 오류 등 사용자 알림 테이블 (notifications)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — 알림
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — 알림
- type — VARCHAR(80) — NOT NULL — 알림
- title — VARCHAR(300) — NOT NULL — 알림
- body — TEXT — 알림
- channel — VARCHAR(40) — NOT NULL — 알림
- status — notification_status — NOT NULL — 알림
- scheduled_at — TIMESTAMPTZ — 알림
- sent_at — TIMESTAMPTZ — 알림
- created_at — TIMESTAMPTZ — NOT NULL
문서 분류 (categories)
- id — UUID
- parent_id — UUID — 외래 키 → 문서 분류.id
- name — VARCHAR(200) — NOT NULL — 카테고리명
- slug — VARCHAR(200) — NOT NULL — URL
- sort_order — INTEGER — NOT NULL — 동일
- created_dt — TIMESTAMPTZ — NOT NULL — 등록일시
- created_id — UUID — NOT NULL — 등록자
- updated_dt — TIMESTAMPTZ — 수정일시
- updated_id — UUID — 수정자
문서 열람 이력과 최근 열람 기록을 저장하는 테이블 (document_view_events)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL — 열람한
- document_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id — 열람한
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 검색
- viewed_at — TIMESTAMPTZ — NOT NULL — 열람
- client_ip — INET — 열람
- user_agent — TEXT — 브라우저
문서 파싱, 정제, 청킹, 임베딩, 인덱싱 비동기 작업 테이블 (pipeline_jobs)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- document_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id — 처리
- source_sync_run_id — UUID — 외래 키 → 외부 소스 동기화 실행 이력 테이블.id — 외부
- chunking_profile_id — UUID — 외래 키 → 청킹 전략과 파라미터를 저장하는 프로파일 테이블.id — 작업에
- status — pipeline_status — NOT NULL — 작업
- current_stage — pipeline_stage — NOT NULL — 현재
- priority — INTEGER — NOT NULL — 작업
- attempt_count — INTEGER — NOT NULL — 재시도
- progress_percent — NUMERIC(5,2) — NOT NULL — 작업
- error_code — VARCHAR(120) — 오류
- error_message — TEXT — 오류
- resolved — BOOLEAN — NOT NULL — 관리자가 오류를 확인 또는 조치했는지 여부
- requested_id — UUID — NOT NULL — 작업을 요청한 사용자
- started_at — TIMESTAMPTZ
- finished_at — TIMESTAMPTZ
- created_at — TIMESTAMPTZ — NOT NULL
문서, 사용자, 권한 등 주요 엔티티 변경 감사 로그 테이블 (audit_logs)
- id — UUID
- actor_user_id — UUID — 외래 키 → 사용자 관리.id
- action — VARCHAR(120) — NOT NULL — 수행
- entity_type — VARCHAR(120) — NOT NULL — 대상
- entity_id — UUID — 대상
- before_data — JSONB — 변경
- after_data — JSONB — 변경
- client_ip — INET — 작업
- user_agent — TEXT — 작업
- created_at — TIMESTAMPTZ — NOT NULL
문서와 태그의 다대다 매핑 테이블 (document_tags)
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- tag_id — UUID — 외래 키 → 문서 검색과 필터링에 사용하는 태그 마스터 테이블.id — NOT NULL — 문서에
- created_at — TIMESTAMPTZ — NOT NULL
문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블 (documents)
- id — UUID
- category_id — UUID — 외래 키 → 문서 분류.id
- current_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id — 현재
- title — VARCHAR(500) — NOT NULL — 문서
- original_name — VARCHAR(500) — 업로드
- format — document_format — NOT NULL — 문서
- storage_path — TEXT — NOT NULL — MinIO
- file_hash — CHAR(64) — NOT NULL — 중복
- version — VARCHAR(40) — NOT NULL — 현재
- status — document_status — NOT NULL — 문서
- visibility — visibility_type — NOT NULL — 문서
- language_code — VARCHAR(20) — 자동
- page_count — INTEGER — 문서
- metadata — JSONB — NOT NULL — 자동
- confidence_score — NUMERIC(5,4) — 문서
- created_by — UUID — 외래 키 → 사용자 관리.id — 등록자 ID
- approved_by — UUID — 외래 키 → 사용자 관리.id — 문서 승인자 ID
- approved_at — TIMESTAMPTZ — 문서
- review_requested_at — TIMESTAMPTZ — 검토
- published_at — TIMESTAMPTZ — 게시
- expires_at — TIMESTAMPTZ — 문서
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
- deleted_at — TIMESTAMPTZ — 소프트
부서관리 (departments)
- id — UUID
- parent_id — UUID — 외래 키 → 부서관리.id — 상위
- name — VARCHAR(200) — NOT NULL — 부서명
- code — VARCHAR(80) — 부서
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
사용자 검색 및 RAG 답변 요청 로그 테이블 (search_queries)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- query_text — TEXT — NOT NULL — 사용자
- query_language — VARCHAR(20) — 질의
- search_mode — VARCHAR(40) — NOT NULL — 검색
- filters — JSONB — NOT NULL — 검색
- confidence_score — NUMERIC(5,4) — 생성
- response_text — TEXT — RAG
- latency_ms — INTEGER — 검색
- created_at — TIMESTAMPTZ — NOT NULL
사용자 관리 (users)
- id — UUID
- department_id — UUID — 외래 키 → 부서관리.id — 사용자가
- email — VARCHAR(320) — NOT NULL — 로그인
- display_name — VARCHAR(200) — NOT NULL — 화면에
- password_hash — TEXT — 비밀번호
- status — user_status — NOT NULL — 사용자
- mfa_enabled — BOOLEAN — NOT NULL — 다중
- last_login_at — TIMESTAMPTZ — 마지막
- invited_at — TIMESTAMPTZ
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
사용자 역할 맵핑 (user_roles)
- user_id — UUID — 외래 키 → 사용자 관리.id — NOT NULL
- role_id — UUID — 외래 키 → 권한관리.id — NOT NULL — 사용자에게
- assigned_by — UUID — 외래 키 → 사용자 관리.id — 역할을
- assigned_at — TIMESTAMPTZ — NOT NULL — 역할
사용자별 즐겨찾기 문서 매핑 테이블 (document_favorites)
- user_id — UUID — 외래 키 → 사용자 관리.id — NOT NULL
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL — 즐겨찾기한
- created_at — TIMESTAMPTZ — NOT NULL
세부 권한 코드 (permissions)
- id — UUID
- code — VARCHAR(120) — NOT NULL
- description — TEXT — 권한
수신된 Webhook 이벤트와 처리 결과 로그 테이블 (webhook_events)
- id — UUID
- endpoint_id — UUID — 외래 키 → Grafana, PagerDuty 등 외부 알림 Webhook 수신 설정 테이블.id
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — Webhook으로
- provider_event_id — VARCHAR(200) — 외부
- signature_valid — BOOLEAN — NOT NULL — 서명
- payload — JSONB — NOT NULL — 원본
- status — pipeline_status — NOT NULL — Webhook
- error_message — TEXT — Webhook
- received_at — TIMESTAMPTZ — NOT NULL — Webhook
- processed_at — TIMESTAMPTZ — Webhook
역할과 권한의 다대다 매핑 테이블 (role_permissions)
- role_id — UUID — 외래 키 → 권한관리.id — NOT NULL
- permission_id — UUID — 외래 키 → 세부 권한 코드.id — NOT NULL — 역할에
외부 소스 동기화 실행 이력 테이블 (source_sync_runs)
- id — UUID
- source_id — UUID — 외래 키 → SharePoint, Google Drive, NAS 등 외부 문서 소스 설정 테이블.id — NOT NULL
- status — pipeline_status — NOT NULL — 동기화
- started_at — TIMESTAMPTZ
- finished_at — TIMESTAMPTZ
- scanned_count — INTEGER — NOT NULL — 스캔한
- changed_count — INTEGER — NOT NULL — 변경
- error_message — TEXT — 동기화
- metrics — JSONB — NOT NULL — 동기화
외부 연동 및 API 호출용 API 키 관리 테이블 (api_keys)
- id — UUID
- owner_user_id — UUID — 외래 키 → 사용자 관리.id
- name — VARCHAR(200) — NOT NULL — API
- key_prefix — VARCHAR(32) — NOT NULL — 식별용
- key_hash — TEXT — NOT NULL — API
- status — api_key_status — NOT NULL — API
- scopes — TEXT — NOT NULL — API
- rate_limit_per_minute — INTEGER — 분당
- last_used_at — TIMESTAMPTZ — 마지막
- expires_at — TIMESTAMPTZ — API
- created_by — UUID — 외래 키 → 사용자 관리.id
- created_at — TIMESTAMPTZ — NOT NULL
- revoked_at — TIMESTAMPTZ — API
운영 대시보드와 알림 판단에 사용하는 시스템 지표 스냅샷 테이블 (system_metric_snapshots)
- id — UUID
- metric_name — VARCHAR(160) — NOT NULL
- metric_value — NUMERIC(18,6) — NOT NULL — 지표값
- dimensions — JSONB — NOT NULL — 서비스
- measured_at — TIMESTAMPTZ — NOT NULL — 지표
운영 지표별 경고와 위험 임계값 설정 테이블 (alert_thresholds)
- id — UUID
- metric_name — VARCHAR(160) — NOT NULL
- warning_threshold — NUMERIC(18,6) — 경고
- danger_threshold — NUMERIC(18,6) — 위험
- comparison_operator — VARCHAR(8) — NOT NULL — 임계값
- notify_channels — TEXT — NOT NULL — 임계값
- enabled — BOOLEAN — NOT NULL — 임계값
- updated_by — UUID — 외래 키 → 사용자 관리.id — 임계값을
- updated_at — TIMESTAMPTZ — NOT NULL
임베딩 모델 제공자, 모델명, 차원 정보를 관리하는 테이블 (embedding_models)
- id — UUID
- provider — VARCHAR(120) — NOT NULL
- model_name — VARCHAR(200) — NOT NULL — 임베딩
- dimensions — INTEGER — NOT NULL — 임베딩
- is_default — BOOLEAN — NOT NULL — 기본
- config — JSONB — NOT NULL — 모델
- created_at — TIMESTAMPTZ — NOT NULL
자주 발생하는 장애 유형을 구조화한 지식 카드 테이블 (knowledge_cards)
- id — UUID
- title — VARCHAR(300) — NOT NULL
- symptoms — TEXT — 대표
- root_causes — JSONB — NOT NULL — 주요
- action_plan — JSONB — NOT NULL — 대응
- confidence_score — NUMERIC(5,4) — 지식
- status — VARCHAR(40) — NOT NULL — 지식
- created_by — UUID — 외래 키 → 사용자 관리.id — 지식
- approved_by — UUID — 외래 키 → 사용자 관리.id — 지식
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
장애 간 유사 사례 추천 결과 테이블 (incident_similar_cases)
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — NOT NULL
- similar_incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — NOT NULL — 유사
- similarity_score — NUMERIC(6,5) — NOT NULL — 장애
- rank — INTEGER — NOT NULL — 유사
- created_at — TIMESTAMPTZ — NOT NULL
장애 대응 방안에 대한 사용자 피드백 테이블 (incident_feedback)
- id — UUID
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — NOT NULL
- user_id — UUID — 외래 키 → 사용자 관리.id — 피드백을
- rating — feedback_rating — NOT NULL — 대응
- comment — TEXT — 피드백
- created_at — TIMESTAMPTZ — NOT NULL
장애 분석 결과가 인용한 문서와 청크 근거 테이블 (incident_references)
- id — UUID
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블.id — NOT NULL
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — 참조
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 참조
- page_number — INTEGER — 참조
- confidence_score — NUMERIC(5,4) — 참조
- rank — INTEGER — NOT NULL — 참조
- created_at — TIMESTAMPTZ — NOT NULL
장애 증상 분석 요청과 RAG 기반 대응 결과를 저장하는 테이블 (incidents)
- id — UUID
- incident_no — VARCHAR(80) — NOT NULL
- requested_by — UUID — 외래 키 → 사용자 관리.id — 장애
- api_key_id — UUID — 외래 키 → 외부 연동 및 API 호출용 API 키 관리 테이블.id — 요청에
- system_name — VARCHAR(200) — NOT NULL — 장애가
- severity — severity_level — NOT NULL — 장애
- environment — VARCHAR(80) — 운영
- symptoms — TEXT — NOT NULL — 입력된
- symptoms_analysis — TEXT — AI가
- root_causes — JSONB — NOT NULL — 추정
- action_plan — JSONB — NOT NULL — 대응
- tags — TEXT — NOT NULL — 장애
- confidence_score — NUMERIC(5,4) — 장애
- processing_time_ms — INTEGER — 장애
- occurred_at — TIMESTAMPTZ — 장애
- resolved_at — TIMESTAMPTZ — 장애
- external_ticket_key — VARCHAR(160) — Jira
- created_at — TIMESTAMPTZ — NOT NULL
지식 카드와 근거 문서, 청크의 연결 테이블 (knowledge_card_documents)
- id — UUID
- knowledge_card_id — UUID — 외래 키 → 자주 발생하는 장애 유형을 구조화한 지식 카드 테이블.id — NOT NULL
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL — 근거
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 근거
챗봇 대화 메시지 이력 테이블 (chat_messages)
- id — UUID
- session_id — UUID — 외래 키 → 멀티턴 AI 챗봇 대화 세션 테이블.id — NOT NULL
- user_id — UUID — 외래 키 → 사용자 관리.id — 메시지를
- role — VARCHAR(40) — NOT NULL — 메시지
- content — TEXT — NOT NULL — 메시지
- referenced_query_id — UUID — 외래 키 → 사용자 검색 및 RAG 답변 요청 로그 테이블.id — 메시지
- metadata — JSONB — NOT NULL — 스트리밍
- created_at — TIMESTAMPTZ — NOT NULL
청크 병합, 제외, 재활성화 등 수동 편집 이력 테이블 (chunk_edit_history)
- id — UUID
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — NOT NULL
- action — VARCHAR(40) — NOT NULL — 편집
- previous_status — chunk_status — 편집
- new_status — chunk_status — 편집
- note — TEXT — 편집
- edited_by — UUID — 외래 키 → 사용자 관리.id — 편집한
- edited_at — TIMESTAMPTZ — NOT NULL
청크별 임베딩 벡터를 저장하는 pgvector 테이블 (chunk_embeddings)
- id — UUID
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — NOT NULL
- embedding_model_id — UUID — 외래 키 → 임베딩 모델 제공자, 모델명, 차원 정보를 관리하는 테이블.id — NOT NULL — 임베딩
- embedding — vector(3072) — NOT NULL — 청크
- metadata — JSONB — NOT NULL — 임베딩
- created_at — TIMESTAMPTZ — NOT NULL
청킹 전략과 파라미터를 저장하는 프로파일 테이블 (chunking_profiles)
- id — UUID
- name — VARCHAR(160) — NOT NULL
- strategy — VARCHAR(40) — NOT NULL — 청킹
- max_tokens — INTEGER — NOT NULL — 청크
- overlap_tokens — INTEGER — NOT NULL — 청크
- min_tokens — INTEGER — NOT NULL — 청크
- quality_threshold — NUMERIC(4,3) — NOT NULL — Coherence
- include_tables — BOOLEAN — NOT NULL — 표
- include_images_ocr — BOOLEAN — NOT NULL — 이미지
- created_id — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
카테고리 단위 (category_permissions)
- id — UUID
- category_id — UUID — 외래 키 → 문서 분류.id — NOT NULL
- role_id — UUID — 외래 키 → 권한관리.id — 권한
- user_id — UUID — 외래 키 → 사용자 관리.id — 권한
- can_read — BOOLEAN — NOT NULL — 읽기
- can_write — BOOLEAN — NOT NULL — 등록
- can_delete — BOOLEAN — NOT NULL — 삭제
- created_at — TIMESTAMPTZ — NOT NULL — 등록일시
- CHECK — (role_id IS NOT NULL OR user_id IS NOT NULL) — NOT NULL
통합 문서 뷰어에서 작성한 주석과 검토 의견 테이블 (viewer_annotations)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- document_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id — 주석
- chunk_id — UUID — 외래 키 → 문서 검색과 RAG 근거로 사용하는 청크 본문 및 위치 메타데이터 테이블.id — 주석이
- author_id — UUID — 외래 키 → 사용자 관리.id — 주석
- page_number — INTEGER — 주석
- anchor — JSONB — NOT NULL — 뷰어
- body — TEXT — NOT NULL — 주석
- is_resolved — BOOLEAN — NOT NULL — 주석
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
파싱, 정제, 변환 결과 파일의 저장 위치를 관리하는 테이블 (parsing_artifacts)
- id — UUID
- document_id — UUID — 외래 키 → 문서의 현재 메타데이터, 상태, 저장 위치를 관리하는 핵심 테이블.id — NOT NULL
- document_version_id — UUID — 외래 키 → 문서 개정 이력과 버전별 파일 위치를 저장하는 테이블.id
- job_id — UUID — 외래 키 → 문서 파싱, 정제, 청킹, 임베딩, 인덱싱 비동기 작업 테이블.id
- artifact_type — VARCHAR(40) — NOT NULL
- storage_path — TEXT — NOT NULL — 산출물
- parser_name — VARCHAR(120) — 사용한
- parser_version — VARCHAR(80) — 사용한
- metadata — JSONB — NOT NULL — 파싱
- created_at — TIMESTAMPTZ — NOT NULL
파이프라인 단계별 상태 변경 이벤트 로그 테이블 (pipeline_job_events)
- id — UUID
- job_id — UUID — 외래 키 → 문서 파싱, 정제, 청킹, 임베딩, 인덱싱 비동기 작업 테이블.id — NOT NULL
- stage — pipeline_stage — NOT NULL — 이벤트
- status — pipeline_status — NOT NULL — 이벤트
- message — TEXT — 처리
- metrics — JSONB — NOT NULL — 단계별
- occurred_at — TIMESTAMPTZ — NOT NULL