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