twinsolution

테이블 (9)

API 로그 테이블 (API_Log)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — API 호출 로그 항목의 고유 ID입니다.
  • API아이디 (api_id) — FK — 외래 키 → 공공데이털 포털 API 테이블.아이디 — NOT NULL — 어떤 API에 대한 호출인지 나타냅니다. API 테이블의 api_id를 참조하는 외래 키입니다. 해당 API 설정이 삭제될 경우 로그들도 함께 삭제될 수 있습니다.
  • 상태 (status) — VARCHAR(10) — NOT NULL — 해당 호출의 결과 상태를 저장합니다. 예: 'success' (성공) 또는 'error' (실패) 등의 값으로 호출 결과를 표시합니다.
  • 상태코드 (status_CODE) — INT — NOT NULL — 필요하다면 HTTP 응답 코드를 문자열로 저장해도 됩니다 (예: '200', '404').
  • 메시지 (message) — TEXT — 호출 결과에 대한 부가 메시지나 요약 정보를 저장합니다. 예를 들어 성공 시 "OK", 실패 시 오류 유형이나 코드 (예: "Timeout", "Invalid Key") 등을 기록합니다.
  • 갱신일 (created_at) — DATETIME

공공데이털 포털 API 테이블 (API)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 외부 API 설정의 고유 식별자입니다.
  • 이름 (name) — VARCHAR(100) — NOT NULL — API의 이름 또는 설명입니다. 예를 들어 '공공데이터포털_건축비' 등 해당 API가 무엇인지 알 수 있는 명칭입니다.
  • 엔드포인트 (base_url) — VARCHAR(255) — NOT NULL — PI 호출에 사용할 기본 URL 엔드포인트입니다. 예를 들어 https://www.g2b.go.kr/api/construction-prices와 같은 전체 경로 또는 주요 도메인을 저장합니다.
  • 메소드 (method) — VARCHAR(10) — NOT NULL — API 호출 방식 (HTTP 메소드)을 저장합니다. 'GET', 'POST' 등 API 요청에 필요한 메소드를 명시합니다
  • 인증키 (auth_key) — VARCHAR(10) — API 호출에 필요한 인증 키 또는 토큰을 저장합니다. 공공데이터 포털의 인증키와 같이 필요 시 사용되며, 없는 API의 경우 NULL이 될 수 있습니다. (필요한 경우 암호화하여 저장을 고려)
  • 상태 (status) — VARCHAR(10) — NOT NULL — 해당 API의 상태를 나타냅니다. 'active'(활성) 또는 'inactive'(비활성) 등으로 사용 설정 여부를 표시하며, 만약 최근 호출에서 오류가 발생했다면 'error' 상태로 변경할 수 있습니다.
  • 생성일 (craeted_at) — DATETIME — NOT NULL
  • 갱신일 (updated_at) — DATETIME — NOT NULL

대화 메시지 (Chat_Message)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 개별 메시지의 고유 식별자입니다.
  • 세션 아이디 (session_id) — FK — 외래 키 → 대화 세션.아이디 — NOT NULL — 이 메시지가 속한 대화 세션의 ID입니다. Chat_Session 테이블의 session_id를 참조하는 외래 키로, 한 세션에 여러 메시지가 연결됩니다. 세션이 삭제되면 관련 메시지도 모두 삭제(ON DELETE…
  • 역할 (role) — VARCHAR(10) — NOT NULL — 메시지 보낸 주체를 나타냅니다. 'user' (사용자) 또는 'assistant' (AI) 등의 값을 가지며, 이를 통해 대화에서 누가 말한 내용인지 구분합니다.
  • 내용 (content) — TEXT — NOT NULL — 메시지의 실제 내용입니다. 사용자의 질문 텍스트 혹은 AI의 답변 텍스트가 여기에 저장됩니다.
  • 생성일 (created_at) — DATETIME — NOT NULL — 메시지가 시스템에 기록된 시간을 나타냅니다. 메시지 생성 시 자동으로 현재 시간으로 저장되며, 대화 순서를 시간 순으로 정렬하는데 사용됩니다.

대화 세션 (Chat_Session)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 대화 세션의 고유 식별자입니다.
  • 프로젝트아이디 (project_id) — FK — 외래 키 → 프로젝트.아이디 — NOT NULL — 해당 대화가 연관된 프로젝트의 ID입니다. Project 테이블의 project_id를 참조하는 외래 키입니다. (이번 설계에서는 사용자 권한을 다루지 않으므로 프로젝트 단위로 대화 컨텍스트를 구분합니다.)
  • 생성일 (created_at) — DATETIME — NOT NULL — 대화 세션이 시작된 시간입니다. 새로운 대화창을 열었을 때의 시간이 자동 저장됩니다.
  • 갱신일 (updated_at) — DATETIME — NOT NULL — 세션에서 마지막으로 대화가 오간 시각입니다. 사용자가 질문하거나 AI가 답변할 때마다 이 필드를 현재 시각으로 업데이트하여, 세션의 최신 활동 시간을 추적합니다. 대시보드 등에 최근 대화 목록을 표시할 때 사용됩니…
  • 빠른질문 (quick_question) — JSON — NOT NULL — 빠른 질문 예시데이터를 넣을 수 있는 필드입니다.

문서 (Document)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 문서의 고유 식별자이며, 기본 키입니다. 각 업로드된 또는 생성된 문서마다 부여됩니다.
  • 프로젝트아이디 (project_id) — FK — 외래 키 → 프로젝트.아이디 — NOT NULL — 당 문서가 속한 프로젝트의 ID입니다. Project 테이블의 project_id를 참조하는 외래 키로서, 문서는 반드시 하나의 프로젝트에 연결됩니다. 프로젝트가 삭제될 경우 해당 프로젝트의 문서들도 함께 삭제되도…
  • 이름 (name) — VARCHAR(255) — NOT NULL — 문서 이름 또는 파일명을 저장합니다. 예를 들어 업로드된 파일의 원래 이름이나 생성된 문서의 제목입니다.
  • 파일타입 (file_type) — VARCHAR(10) — NOT NULL — 문서 파일 형식을 저장합니다. 예: 'PDF', 'HWP', 'DOCX', 'TXT' 등 파일의 확장자나 유형을 나타냅니다.
  • 파일 경로 (file_path) — VARCHAR(255) — NOT NULL — 서버 내에 저장된 문서 파일의 경로 또는 식별자를 저장합니다. 예를 들어 파일시스템 경로나 클라우드 스토리지 URL 등이 될 수 있습니다.
  • 파일출처 (origin) — VARCHAR(10) — NOT NULL — 문서의 출처를 기록합니다. 'uploaded' (사용자 업로드 문서) 또는 'generated' (AI에 의해 생성된 문서) 등의 값을 가질 수 있습니다.
  • 처리상태 (status) — VARCHAR(20) — NOT NULL — 문서 처리 상태를 나타냅니다. 예를 들어 '업로드됨', '분할완료', '분석완료' 등의 상태를 정의하여 문서의 처리 단계 진행 상황을 추적합니다.
  • 청크크기 (chunk_size) — INT — 이 문서를 청크로 분할할 때 사용한 청크 크기를 저장합니다 (문서의 텍스트를 몇 글자 또는 몇 바이트 단위로 잘랐는지). 문서 업로드 시 사용자가 별도로 지정하지 않았다면 기본 청크 크기 값을 사용하며, 문서가 아…
  • 청크오버랩 (chunck_overlap) — INT — 청크 분할 시 겹쳐지는 부분의 크기를 저장합니다. 예를 들어 청크 간에 200자씩 중복된다면 200으로 기록합니다. 이 값도 문서 분할 수행 시 설정되며, 분할 전에는 NULL일 수 있습니다.
  • 생성일 (created_at) — DATETIME — NOT NULL — 문서가 시스템에 업로드되거나 생성된 날짜와 시간을 저장합니다.
  • 갱신일 (updated_at) — DATETIME

문서 청크 (Document_Chunk)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 청크의 고유 식별자이며 기본 키입니다.
  • 문서아이디 (document_id) — FK — 외래 키 → 문서.아이디 — NOT NULL — 해당 청크가 속한 원본 문서의 ID입니다. Document 테이블의 document_id를 참조하는 외래 키로, 청크는 반드시 하나의 문서에 귀속됩니다. 문서가 삭제되면 관련 청크들도 삭제되도록 ON DELETE…
  • 청크인덱스 (index) — INT — NOT NULL — 청크의 순서 인덱스입니다. 원본 문서에서 청크들이 생성된 순서를 나타내며, 0 또는 1부터 시작하는 일련번호로 저장됩니다. 이를 통해 원본 문서의 청크 순서를 복원할 수 있습니다.
  • 청크내용 (content) — TEXT — NOT NULL — 청크에 해당하는 실제 텍스트 내용입니다. 원본 문서에서 분리된 한 조각의 내용으로, 청크 크기(chunk_size)에 따라 잘라낸 문자열을 저장합니다. (주의: 텍스트가 매우 클 경우를 대비해 TEXT 타입으로 설…
  • 생성일 (created_at) — DATETIME — NOT NULL

분석 리포트 (Analysis_Report)

  • 아아디 (id) — PK — 기본 키 — NOT NULL — 분석 결과 레코드의 고유 식별자입니다
  • 문서아이디 (document_id) — FK — 외래 키 → 문서.아이디 — NOT NULL — 어떤 문서에 대한 분석 결과인지를 나타냅니다. Document 테이블의 해당 문서를 가리키는 외래 키입니다. 문서가 삭제될 경우 연결된 분석 결과도 삭제되도록 설정할 수 있습니다.
  • 내용 (content) — TEXT — NOT NULL — 분석 결과의 종류를 나타내는 필드입니다. 예를 들어 'summary' (요약), 'extraction' (정보 추출) 등 결과의 유형을 표시합니다. 하나의 문서에 대해 여러 종류의 분석 결과를 저장할 수 있음을 염…
  • 생성일 (created_at) — DATETIME — NOT NULL

설정 (setting)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 청크 설정 레코드의 식별자입니다. (일반적으로 하나의 설정 레코드만 사용됨)
  • 청크사이즈 (chunk_size) — INT — NOT NULL — 문서를 청크로 분할할 때 기본적으로 사용할 청크 크기 값입니다. 예를 들어 1000이라면 한 청크에 최대 1000자의 텍스트를 담습니다.
  • 청크오버랩 (chunk_overlap) — INT — NOT NULL — 청크 분할 시 겹치는 부분의 크기 값입니다. 예를 들어 200이라면 청크 간 200자의 중복이 발생하도록 분할합니다.
  • 갱신일 (updated_at) — DATETIME

프로젝트 (project)

  • 아이디 (id) — PK — 기본 키 — NOT NULL — 프로젝트를 식별하는 기본 키 식별자입니다. 각 프로젝트마다 고유한 값이며 NULL 값을 허용하지 않습니다.
  • 이름 (name) — VARCHAR(100 — NOT NULL — 프로젝트 이름을 저장합니다. 예를 들어, 특정 건축허가 신청 건의 이름이나 제목입니다.
  • 설명 (description) — JSON — 프로젝트에 대한 설명이나 부가 정보를 저장합니다. 길이에 제한이 없으며 필요할 경우 NULL일 수 있습니다.
  • 상태 (status) — VARCHAR(20) — NOT NULL — 프로젝트의 현재 상태를 나타냅니다. 예를 들어 '준비중', '진행중', '완료' 등의 값으로 프로젝트 진행 상태를 표현합니다
  • 생성일 (created_at) — DATETIME — NOT NULL — 프로젝트의 현재 상태를 나타냅니다. 예를 들어 '준비중', '진행중', '완료' 등의 값으로 프로젝트 진행 상태를 표현합니다
  • 갱신일 (updated_at) — DATETIME — 프로젝트가 완료된 시점을 기록합니다. 프로젝트 완료 시점에 이 필드가 채워지며, 완료 전에는 NULL로 남겨둡니다.