A305 ERD

테이블 (21)

QA_RAG AI평가점수 (query_qa_eval)

  • 질문id (id) — UUID — 기본 키 — NOT NULL
  • 다이어그램id (arch_idv) — VARCHAR(255)
  • 질문 (question) — TEXT
  • graphRAG점수 (graph_score) — INT
  • vectorRAG점수 (vector_score) — INT
  • 생성 시각 (created_at) — TIMESTAMPTZ

QA_답변AB테스트 (query_compare_feedback)

  • 질문id (id) — UUID — 기본 키 — NOT NULL
  • 다이어그램id (arch_idv) — VARCHAR(255)
  • 질문 (question) — TEXT
  • graphRAG답변 (answer_a) — TEXT
  • vectorRAG답변 (answer_b) — TEXT
  • 질문자 (questioner) — VARCHAR(255)
  • 선택한답 (selected_answer) — VARCHAR(1)
  • 답변 생성시간 (response_time) — FLOAT
  • 생성 시각 (created_at) — TIMESTAMPTZ

QA_답변점수피드백 (query_rating_feedback)

  • 질문id (id) — UUID — 기본 키 — NOT NULL
  • 다이어그램id (arch_idv) — VARCHAR(255)
  • 질문 (question) — TEXT
  • 답변종류 (type) — VARCHAR(32) — "graph" "vector"
  • ai답변 (answer) — TEXT
  • 질문자 (questioner) — VARCHAR(255)
  • 답변 생성시간 (response_time) — FLOAT
  • 사용자 점수 (score) — INT
  • 사용자 피드백 (comment) — TEXT
  • 생성 시각 (created_at) — TIMESTAMPTZ

관측기록 (observes)

  • 관측기록 ID (observe_id) — BIGINT — 기본 키 — NOT NULL
  • 프로필 ID (gitprofile_id) — BIGINT — 외래 키 → 프로필.프로필 ID — NOT NULL
  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 외래 키 → 깃허브 레포.서비스 기준 저장소 ID — NOT NULL — 시스템 내부 PK
  • 관측기록 UUID (observe_uuid) — UUID — UNIQUE NOT NULL

기술스택 (tech_stack)

  • 기술스택 ID (techstack_id) — BIGINT — 기본 키 — NOT NULL
  • 이름 (name) — varchar(255)
  • 카테고리 (category) — varchar(255) — LANGUAGE, FRAMEWORK, DB, INFRA, TOOL
  • 아이콘 주소 (icon_url) — varchar(255)
  • 기술스택 UUID (techstack_uuid) — UUID — UNIQUE NOT NULL

기술스택 매핑 (github_repository_tech_stack_mapping)

  • 레포 기술스택 매핑 아이디 (repo_techstack_mapping_id) — bigint — 기본 키 — NOT NULL
  • 기술스택 ID (techstack_id) — BIGINT — 외래 키 → 기술스택.기술스택 ID — NOT NULL
  • 분석 캐시 id (cache_id) — bigint — 외래 키 → 레포지토리 분석 캐시.분석 캐시 id — NOT NULL

기술스택 매핑 (tech_stack_mapping)

  • 기술스택매핑 ID (techstack_mapping_id) — BIGINT — 기본 키 — NOT NULL
  • 프로필 ID (profile_id) — BIGINT — 외래 키 → 프로필.프로필 ID — NOT NULL
  • 기술스택 ID (techstack_id2) — BIGINT — 외래 키 → 기술스택.기술스택 ID — NOT NULL

깃허브 레포 (github_repository)

  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 기본 키 — NOT NULL — 시스템 내부 PK
  • GitHub 저장소 ID (github_repo_id) — BIGINT — Github가 부여한 저장소 식별자
  • 소유자 로그인명 (owner_login) — VARCHAR(30) — 저장소 소유자 혹은 조직의 GitHub 로그인명
  • 저장소명 (repo_name) — VARCHAR(30) — 저장소의 이름
  • 기본 브랜치명 (default_branch) — VARCHAR(10) — 저장소의 기본 브랜치명(main, master)
  • 저장소 설명 (description) — TEXT — GitHub저장소 설명 본문
  • 비공개 여부 (is_private) — BOOLEAN — 저장소가 Private인지 여부
  • 저장소 웹 URL (html_url) — TEXT — 브라우저에서 접근하는 GitHub 저장소 주소
  • GitHub 수정 시각 (updated_at_github) — TIMESTAMPTZ — GitHub메타데이터가 마지막으로 수정된 시각
  • GitHub 푸시 시각 (pushed_at_github) — TIMESTAMPTZ — 저장소에 마지막으로 push된 시각
  • 마지막 동기화 시각 (last_synced_at) — TIMESTAMPTZ — 우리 서비스가 이 저장소 메타데이터(스냅샷)를 마지막으로 동기화한 시각
  • 생성시각 (created_at) — TIMESTAMPTZ — 우리 DB에 이 레코드가 생성된 시각
  • 수정 시각 (updated_at) — TIMESTAMPTZ — 우리 DB에서 레코드가 마지막으로 갱신된 시각
  • 서비스 기준 저장소 UUID (repo_uuid) — UUID — UNIQUE NOT NULL

깃허브 트리 캐시 (github_repository_tree_cache)

  • 깃허브 트리 ID (tree_cache_id) — BIGINT — 기본 키 — NOT NULL
  • 메인브랜치 (ref) — varchar(255) — 메인브랜치
  • 트리 SHA (tree_sha) — varchar(64) — 깃허브 트리 API의 SHA
  • 잘림 여부 (truncated) — boolean — 응답이 잘렸는지 여부
  • 트리 JSON (tree_json) — TEXT — tree api 응답 전체 JSON, 구현 단순화로 TEXT
  • 가져온 시각 (fetched_at) — TIMESTAMPTZ
  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 외래 키 → 깃허브 레포.서비스 기준 저장소 ID — NOT NULL — 시스템 내부 PK

깃허브 파싱 캐시 (github_repository_parse_cache)

  • 파싱 캐시 ID (parse_cache_id) — BIGINT — 기본 키 — NOT NULL
  • 커밋 SHA (commit_sha) — varchar(64)
  • 캐시된 응답 JSON (cached_response_json) — TEXT
  • 파싱 시각 (parsed_at) — TIMESTAMPTZ — GitHub API를 호출해서 ParsedRepositoryResponse를 새로 만든 시각
  • SHA 최신 확인시각 (last_checkd_at) — TIMESTAMPTZ — 최신 Commit SHA 확인을 마지막으로 수행한 시각
  • 생성시각 (created_at) — TIMESTAMPTZ — 이 row가 생성된 시각
  • 수정 시각 (updated_at) — TIMESTAMPTZ — 이 Row가 마지막으로 업데이트된 시각
  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 외래 키 → 깃허브 레포.서비스 기준 저장소 ID — NOT NULL — 시스템 내부 PK

깃허브 파일 캐시 (github_file_content_cache)

  • 깃허브 파일 캐시 ID (file_content_cache_id) — BIGINT — 기본 키 — NOT NULL
  • 메인 브랜치 (ref) — varchar(255)
  • 파일 경로 (path) — TEXT
  • 파일명 (file_name) — varchar(255)
  • 파일 SHA (sha) — varchar(64)
  • 콘텐츠 타입 (type) — varchar(30)
  • 파일 크기 (size) — BIGINT
  • 인코딩 (encoding) — varchar(50)
  • 파일 내용 (content) — TEXT
  • 내용 사용 가능 여부 (content_available) — boolean — type은 코드, 이미지 모두 file로 처리함
  • 바이너리 여부 (is_binary) — boolean
  • 사용 불가 사유 (unavailable_reason) — varchar(50) — FILE_TOO_LARGE, BINARY_FILE, CONTENT_NOT_PROVIDED...
  • HTML URL (html_url) — TEXT
  • 가져온 시각 (fetched_at) — TIMESTAMP
  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 외래 키 → 깃허브 레포.서비스 기준 저장소 ID — NOT NULL — 시스템 내부 PK

다이어그램 임베딩 (graphrag_embeddings)

  • 임베딩 ID (embedding_id) — UUID — 기본 키 — NOT NULL
  • 다이어그램 ID (arch_id) — VARCHAR(255)
  • 그래프 원소 종류 (kind) — VARCHAR(32) — group | node | edge
  • 원소 식별자 (ref_id) — VARCHAR(512)
  • 원소 이름 (label) — VARCHAR(512)
  • 원소 설명 (content) — TEXT
  • 임베딩 백터 (embedding) — VECTOR(3072)
  • 생성시각 (created_at) — TIMESTAMP

다이어그램 정보 (github_repository_diagam)

  • 다이어그램 ID (diagram_id) — BIGINT — 기본 키 — NOT NULL
  • 분석 캐시 id (cache_id) — bigint — 외래 키 → 레포지토리 분석 캐시.분석 캐시 id — NOT NULL
  • 설명 (explanation) — text
  • 생성시각 (created_at) — TIMESTAMPTZ

대화 메세지 (agent_message)

  • 메세지 ID (message_id) — BIGINT — 기본 키
  • 대화방 ID (conversation_id) — BIGINT — 외래 키 → 에이전트 대화방.대화방 ID
  • 사용자 pk (appuser_id) — BIGINT — 외래 키 → 에이전트 대화방.사용자 pk — NOT NULL
  • 메세지 역할 (role) — ENUM — USER, ASSISTANT, SYSTEM
  • 메세지 본문 (content) — TEXT
  • 에러 메세지 (error_message) — TEXT — 채팅 API 문제가 있다거나 하는 상황
  • 생성 시각 (created_at) — TIMESTAMPTZ
  • 메세지 UUID (message_uuid) — UUID — UNIQUE NOT NULL

레포지토리 (my_github_repositories)

  • 레포 id (myrepo_id) — BIGINT — 기본 키 — NOT NULL
  • 프로필 ID (profile_id) — BIGINT — 외래 키 → 프로필.프로필 ID — NOT NULL
  • github 내부 아이디 (github_id) — varchar(255)
  • 이름 (name) — varchar(255)
  • 설명 (description) — varchar(255)
  • 클릭 이동용 주소 (html_url) — varchar(255)
  • 주 사용 언어 (language) — varchar(255)
  • 스타 수 (stargazer_cnt) — int
  • 마지막 커밋 시간 (pushed_at) — TIMESTAMPTZ
  • 레포 생성일 (created_at) — TIMESTAMPTZ
  • 레포 수정일 (updated_at) — TIMESTAMPTZ
  • 레포 UUID (myrepo_uuid) — UUID — UNIQUE NOT NULL

레포지토리 분석 캐시 (github_repository_analyze_cache)

  • 분석 캐시 id (cache_id) — bigint — 기본 키 — NOT NULL
  • 깃허브 저장소 id (github_repo_id) — bigint

사용자 (app_user)

  • 사용자 pk (app_user_id) — BIGINT — 기본 키 — NOT NULL
  • github 유저네임 (username) — varchar(255)
  • 이메일 (email) — varchar(255)
  • github 액세스 토큰 (github_access_token) — varchar(255)
  • github 내부 아이디 (github_id) — BIGINT
  • github 프로필사진 url (avatar_url) — varchar(255)
  • 생성일자 (created_at) — timestamp
  • 수정일자 (updated_at) — timestamp
  • 사용자 UUID (appuser_uuid) — UUID — NOT NULL — UNIQUE NOT NULL
  • 탈퇴 여부 (is_deleted) — boolean

스트릭 (github_streak)

  • 스트릭 id (streak_id) — BIGINT — 기본 키 — NOT NULL
  • 프로필 ID (profile_id) — BIGINT — 외래 키 → 프로필.프로필 ID — NOT NULL
  • 올해 연도 (year) — int
  • 올해 커밋 수 (total_commit_contributions) — int
  • 올해 기여 수 (total_contributions) — int
  • 현재 연속 기여 일수 (current_streak_days) — int
  • 데이터 패치일 (fetched_at) — TIMESTAMPTZ
  • 스트릭 UUID (streak_uuid) — UUID — UNIQUE NOT NULL

에이전트 대화방 (agent_conversation)

  • 대화방 ID (conversation_id) — BIGINT — 기본 키
  • 사용자 pk (appuser_id) — BIGINT — 외래 키 → 사용자.사용자 pk — NOT NULL
  • 대화 제목 (title) — VARCHAR(200) — 채팅방 제목
  • 생성시각 (created_at) — TIMESTAMPTZ
  • 수정시각 (updated_at) — TIMESTAMPTZ
  • 대화방 UUID (conversation_uuid) — UUID — UNIQUE NOT NULL
  • 서비스 기준 저장소 ID (repo_id) — BIGINT — 외래 키 → 깃허브 레포.서비스 기준 저장소 ID — NOT NULL — 시스템 내부 PK

잔디 (github_contribution_days)

  • 잔디 ID (grass_id) — BIGINT — 기본 키 — NOT NULL
  • 프로필 ID (profile_id) — BIGINT — 외래 키 → 프로필.프로필 ID — NOT NULL
  • 기여한 날짜 (contribution_date) — DATE
  • 기여 수 (contribution_cnt) — int
  • 기여 단계 (contribution_level) — int — 0-4
  • 잔디 UUID (grass_uuid) — UUID — UNIQUE NOT NULL

프로필 (github_profile)

  • 프로필 ID (gitprofile_id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 pk (appuser_id) — BIGINT — 외래 키 → 사용자.사용자 pk — NOT NULL
  • github 유저네임 (username) — varchar(255)
  • 이름 (name) — varchar(255)
  • github 프로필사진 url (github_avatar_url) — varchar(255)
  • 계정 타입 (type) — varchar(255) — User, Organization
  • 회사 (company) — varchar(255)
  • 블로그 url (blog) — varchar(255)
  • 공개 위치 (location) — varchar(255)
  • 이메일 (email) — varchar(255)
  • 자기소개 (bio) — varchar(255)
  • 레포지토리 개수 (public_repos_count) — int
  • 계정 생성일 (createdAt) — timestamp
  • 올해 총 커밋 수 (commit_count_this_year) — SMALLINT
  • 프로필 UUID (gitprofile_uuid) — UUID — UNIQUE NOT NULL
  • 계정 업데이트일 (updatedAt) — timestamp