TecheDoc2
테이블 (53)
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) — 오류
- source — VARCHAR(20) — API 요청 위치
- created_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 (Field) — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
LLM 호출 이력 (llm_call_logs)
- id — UUID
- query_id — UUID — 외래 키 → 사용자 검색 및 RAG 답변 요청 로그.id
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청, 결과 저장.id — 연관
- provider — llm_provider — NOT NULL — LLM
- model_name — VARCHAR(200) — NOT NULL — 호출한
- prompt_tokens — INTEGER — NOT NULL — 프롬프트
- completion_tokens — INTEGER — NOT NULL — 생성
- total_tokens — INTEGER — NOT NULL — 총
- latency_ms — INTEGER — LLM
- status_code — INTEGER
- error_message — TEXT
- created_at — TIMESTAMPTZ — NOT NULL
- CHECK — (query_id IS NOT NULL OR incident_id IS NOT NULL) — NOT NULL
RBAC 역할 정의 (roles)
- id — UUID
- code — VARCHAR(80) — NOT NULL
- name — VARCHAR(120) — NOT NULL — 역할
- description — TEXT — 역할
- is_system — BOOLEAN — NOT NULL — 시스템
- use_yn — CHAR(1) — NOT NULL — 사용여부
- created_at — TIMESTAMPTZ — NOT NULL
document_history
- id — UUID — 기본 키 — NOT NULL
- original_id — UUID — NOT NULL
- category_id — UUID
- title — VARCHAR(500) — NOT NULL
- original_name — VARCHAR(500)
- format — VARCHAR(20) — NOT NULL
- storage_path — TEXT — NOT NULL
- file_hash — VARCHAR(64) — NOT NULL
- version — VARCHAR(40) — NOT NULL
- status — VARCHAR(20) — NOT NULL
- visibility — VARCHAR(20) — NOT NULL
- language_code — VARCHAR(20)
- page_count — INT
- metadata — JSONB — NOT NULL
- confidence_score — NUMERIC(5,4)
- created_by — UUID — NOT NULL
- approved_by — UUID
- approved_at — TIMESTAMPTZ
- published_at — TIMESTAMPTZ
- expires_at — TIMESTAMPTZ
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
- deleted_by — UUID — NOT NULL
- deleted_at — TIMESTAMPTZ — NOT NULL
갱신 토큰 관리 (refresh_tokens)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id — NOT NULL — 토큰 소유 사용자
- token_hash — TEXT — NOT NULL — 갱신 토큰 해시값
- device_info — TEXT — 발급 디바이스 정보
- client_ip — INET — 접속 IP
- expires_at — TIMESTAMPTZ — NOT NULL — 토큰 만료 일시
- revoked_at — TIMESTAMPTZ — 토큰 폐기 일시
- created_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 — 품질 개선용 레이블 JSON
- 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 — 외래 키 → 문서 청크 및 메타데이터.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
권한 정의 코드 (permissions)
- id — UUID
- code — VARCHAR(120) — NOT NULL
- description — TEXT — 권한
- use_yn — CHAR(1) — 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 — 외래 키 → 장애 증상 분석 요청, 결과 저장.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_tags)
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL
- tag_id — UUID — 외래 키 → 문서 검색 필터링 태그.id — NOT NULL — 문서에
- created_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_by (Field) — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
문서 검색 필터링 태그 (tags)
- id — UUID
- name — VARCHAR(120) — NOT NULL
- created_by — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
문서 관련 사용자 알림 (notifications)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- document_id — UUID — 외래 키 → 문서 정보.id — 알림
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청, 결과 저장.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
문서 단위 예외 접근 권한 설정 (document_acl)
- id — UUID
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL
- role_id — UUID — 외래 키 → RBAC 역할 정의.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
문서 분류 (categories)
- id — UUID
- parent_id — UUID — 외래 키 → 문서 분류.id
- name — VARCHAR(200) — NOT NULL — 카테고리명
- slug — VARCHAR(200) — NOT NULL — URL
- sort_order — INTEGER — NOT NULL — 동일
- created_by — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
문서 분류 단위 읽기, 쓰기, 삭제 권한 설정 (category_permissions)
- id — UUID
- category_id — UUID — 외래 키 → 문서 분류.id — NOT NULL
- role_id — UUID — 외래 키 → RBAC 역할 정의.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
문서 열람 이력 및 최근 열람 기록 (document_view_events)
- id — UUID
- user_id — UUID — 외래 키 → 사용자 관리.id
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL — 열람한
- document_version_id — UUID — 외래 키 → 문서 개정 이력.id — 열람한
- chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.id — 검색
- viewed_at — TIMESTAMPTZ — NOT NULL — 열람
- client_ip — INET — 열람
- user_agent — TEXT — 브라우저
문서 정보 (documents)
- id — UUID
- category_id — UUID — 외래 키 → 문서 분류.id — 카테고리 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 — S3 오브젝트 저장 경로
- file_hash — CHAR(64) — NOT NULL — 중복 감지를 위한 SHA-256 해시값
- 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 — 자동 추출 메타데이터 JSON
- confidence_score — NUMERIC(5,4) — 문서 또는 인덱싱 품질 신뢰도 점수
- created_by — UUID — NOT NULL — 문서 등록 사용자
- approved_by — UUID — 외래 키 → 사용자 관리.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 — 소프트 삭제 일시
문서 청크 및 메타데이터 (document_chunks)
- id — UUID
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL
- document_version_id — UUID — 외래 키 → 문서 개정 이력.id — 청크가
- job_id — UUID — 외래 키 → 청킹 작업 상태 및 이력.id — 청크를
- parent_chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.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 — 품질
- es_indexed — BOOLEAN — NOT NULL — Elasticsearch
- status — chunk_status — NOT NULL — 청크
- metadata — JSONB — NOT NULL — 청크
- 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
부서 관리 (departments)
- id — UUID — 부서 고유 식별자
- parent_id — UUID — 외래 키 → 부서 관리.id — 상위 부서 식별자
- name — VARCHAR(200) — NOT NULL — 부서명
- code — VARCHAR(80) — 부서 코드
- use_yn — CHAR(1) — NOT NULL — 부서 코드 사용여부
- 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
- input_tokens — INTEGER — 검색
- output_tokens — INTEGER — LLM
- 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 — 외래 키 → RBAC 역할 정의.id — NOT NULL — 사용자에게
- assigned_by — UUID — 외래 키 → 사용자 관리.id — 역할을
- assigned_at — TIMESTAMPTZ — NOT NULL — 역할
사용자별 검색, 알람 설정 (user_preferences)
- user_id — UUID — 외래 키 → 사용자 관리.id
- search_mode — VARCHAR(40) — NOT NULL
- result_page_size — INTEGER — NOT NULL — 검색
- notify_doc_expiry — BOOLEAN — NOT NULL — 문서
- notify_doc_approved — BOOLEAN — NOT NULL — 문서
- notify_pipeline_error — BOOLEAN — NOT NULL — 파이프라인
- notify_channels — TEXT — NOT NULL — 알림
- ui_language — VARCHAR(20) — NOT NULL — UI
- extra — JSONB — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
사용자별 즐겨찾기 문서 매핑 (document_favorites)
- user_id — UUID — 외래 키 → 사용자 관리.id — NOT NULL
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL — 즐겨찾기한
- created_at — TIMESTAMPTZ — NOT NULL
수신된 Webhook 이벤트와 처리 결과 로그 (webhook_events)
- id — UUID
- endpoint_id — UUID — 외래 키 → 수신된 Webhook 이벤트와 처리 결과 로그.id
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청, 결과 저장.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
수신된 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 — NOT NULL — 등록자
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
역할과 권한 매핑 (role_permissions)
- role_id — UUID — 외래 키 → RBAC 역할 정의.id — NOT NULL
- permission_id — UUID — 외래 키 → 권한 정의 코드.id — NOT NULL — 역할에
외부 문서 소스 설정 (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 (Field) — UUID — NOT NULL — 등록자 id
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
외부 소스 동기화 실행 이력 (source_sync_runs)
- id — UUID
- source_id — UUID — 외래 키 → 외부 문서 소스 설정.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 — NOT NULL — 등록자 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 (Field) — UUID — NOT NULL — 수정자 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 — knowledge_card_status — NOT NULL — 지식
- created_by (Field) — UUID — NOT NULL — 등록자 ID
- approved_by — UUID — 외래 키 → 사용자 관리.id — 지식
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
장애 간 유사 사례 추천 결과 (incident_similar_cases)
- incident_id — UUID — 외래 키 → 장애 증상 분석 요청, 결과 저장.id — NOT NULL
- similar_incident_id — UUID — 외래 키 → 장애 증상 분석 요청, 결과 저장.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 — 외래 키 → 장애 증상 분석 요청, 결과 저장.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 — 외래 키 → 장애 증상 분석 요청, 결과 저장.id — NOT NULL
- document_id — UUID — 외래 키 → 문서 정보.id — 참조
- chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.id — 참조
- page_number — INTEGER — 참조
- confidence_score — NUMERIC(5,4) — 참조
- rank — INTEGER — NOT NULL — 참조
- created_at — TIMESTAMPTZ — NOT NULL
장애 증상 분석 요청, 결과 저장 (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 — 추정 원인 목록 JSON
- action_plan — JSONB — NOT NULL — 대응 방안 목록 JSON
- diagnostic_commands — JSONB — 진단 명령 목록 JSON
- 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 — 외래 키 → 문서 청크 및 메타데이터.id — 근거
챗봇 대화 메시지 이력 (chat_messages)
- id — UUID
- session_id — UUID — 외래 키 → 멀티턴 AI 챗봇 대화 세션.id — NOT NULL — 챗봇 세션 ID
- user_id — UUID — 외래 키 → 사용자 관리.id — 사용자 ID
- role — VARCHAR(40) — NOT NULL — 메시지 역할
- content — TEXT — NOT NULL — 메시지 본문
- token_count — INTEGER — 메시지 토큰 수
- referenced_query_id — UUID — 외래 키 → 사용자 검색 및 RAG 답변 요청 로그.id — 검색질의
- metadata — JSONB — NOT NULL — 메시지 메타데이터
- created_at — TIMESTAMPTZ — NOT NULL
청크 문서 표 (chunk_tables)
- id — UUID — 기본 키 — NOT NULL
- document_id — UUID — NOT NULL
- document_version_id — UUID
- chunk_id — UUID
- page_number — INTEGER
- table_index — INTEGER — NOT NULL
- headers — JSONB
- rows — JSONB — NOT NULL
- source_type — VARCHAR(20) — NOT NULL
- created_at — TIMESTAMPTZ — NOT NULL
청크 병합, 제외, 재활성화 수동 편집 이력 (chunk_edit_history)
- id — UUID
- chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.id — NOT NULL — 편집된 청크
- action — VARCHAR(40) — NOT NULL — 편집 작업 유형
- previous_status — chunk_status — 편집 전 청크 상태
- new_status — chunk_status — 편집 후 청크 상태
- note — TEXT — 편집 사유 또는 설명
- edited_by (Field) — UUID — NOT NULL — 수정자 ID
- edited_at — TIMESTAMPTZ — NOT NULL
청크 이미지 (chunk_images)
- id — UUID — 기본 키 — NOT NULL
- document_id — UUID — NOT NULL
- document_version_id — UUID
- chunk_id — UUID — 근접 텍스트 청크 연결(매칭 실패 시 NULL)
- page_number — INTEGER
- image_index — INTEGER — NOT NULL
- storage_path — TEXT — NOT NULL — SeaweedFS 경로
- content_type — varchar(80)
- width — INTEGER
- height — INTEGER
- ocr_text — TEXT — 검색용 텍스트
- ocr_confidence — NUMERIC(5,4)
- created_at — TIMESTAMPTZ — NOT NULL
청크별 임베딩 벡터 저장 pgvector (chunk_embeddings)
- id — UUID
- chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.id — NOT NULL
- embedding_model_id — UUID — 외래 키 → 임베딩 모델 제공자, 모델명, 차원 정보를 관리.id — NOT NULL — 임베딩
- embedding — vector(3072) — NOT NULL — 청크
- 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
청킹 작업 상태 및 이력 (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_by — UUID — 외래 키 → 사용자 관리.id — 작업을
- started_at — TIMESTAMPTZ
- finished_at — TIMESTAMPTZ
- 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_by (Field) — UUID — NOT NULL — 등록자 ID
- created_at — TIMESTAMPTZ — NOT NULL
통합 문서 뷰어에서 작성한 주석과 검토 의견 (viewer_annotations)
- id — UUID
- document_id — UUID — 외래 키 → 문서 정보.id — NOT NULL — 주석 대상 문서
- document_version_id — UUID — 외래 키 → 문서 개정 이력.id — 주석 대상 문서 버전
- chunk_id — UUID — 외래 키 → 문서 청크 및 메타데이터.id — 주석이 연결된 청크
- author_id — UUID — 외래 키 → 사용자 관리.id — 주석 작성자
- page_number — INTEGER — 주석 위치 페이지
- anchor — JSONB — NOT NULL — 뷰어 좌표 또는 텍스트 앵커 JSON
- 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