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