COGI ERD

Tables (31)

admin_activity_logs

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 활동 사용자
  • action — VARCHAR(100) — NOT NULL — 활동 유형
  • detail — TEXT — 활동 상세 내용 추론
  • created_at — DATETIME — NOT NULL — 발생 일시

ai_skill_recommendations

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • input_text — TEXT — NOT NULL — 약점/요구사항 입력(FR-70 근거)
  • recommendation_result — TEXT — NOT NULL — 추천 결과
  • created_at — DATETIME — NOT NULL — 요청 일시 추론

ai_usage_logs

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — 요청 사용자(비로그인 게스트는 NULL) 추론
  • model_name — VARCHAR(50) — NOT NULL — Monica 구독 제공 모델명(예: claude-opus-4-8, gpt-5, gemini-3-pro)
  • input_tokens — INT — NOT NULL — 입력 토큰 수 추론
  • output_tokens — INT — NOT NULL — 출력 토큰 수 추론
  • cost — DECIMAL(10, 4) — NOT NULL — 예상 비용
  • request_type — VARCHAR(50) — REVIEW/LEARNING_CARD/SKILL_RECOMMEND/GUEST_REVIEW 등 추론
  • created_at — DATETIME — NOT NULL — 요청 일시 추론

courses

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • platform — VARCHAR(50) — NOT NULL — INFLEARN/UDEMY/OFFICIAL(FR-66~69 근거)
  • title — VARCHAR(255) — NOT NULL — 강의명
  • price — INT — 가격(단위: 원, FR-66~69 근거)
  • duration — INT — 강의 시간(단위: 분) 추론
  • level — VARCHAR(20) — 난이도(FR-66~69 근거)
  • category — VARCHAR(50) — 관련 키워드/카테고리 추론
  • url — VARCHAR(500) — NOT NULL — 강의 링크
  • crawled_at — DATETIME — NOT NULL — 크롤링 일시(배치 저장 기반, FR-69 근거)

credit_usage

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • usage_date — DATE — NOT NULL — 기준일(자정 초기화 배치 기준) 추론
  • used_credits — INT — NOT NULL — 사용 크레딧(세부 소모 수치는 확인 필요, FR-81 근거) 불확실
  • daily_limit — INT — NOT NULL — 플랜별 한도(20/40/70, FR-81 근거)
  • notified_90 — BOOLEAN — NOT NULL — 90% 도달 알림 여부(FR-80 근거)
  • notified_100 — BOOLEAN — NOT NULL — 100% 도달 알림 여부(FR-80 근거)

email_verifications

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • email — VARCHAR(255) — NOT NULL — 인증 대상 이메일
  • code — VARCHAR(10) — NOT NULL — 인증 코드
  • purpose — VARCHAR(20) — NOT NULL — SIGNUP/FIND_ID/RESET_PW 구분 추론
  • expires_at — DATETIME — NOT NULL — 만료 일시(5분 만료, FR-08 근거)
  • verified — BOOLEAN — NOT NULL — 인증 완료 여부 추론
  • created_at — DATETIME — NOT NULL — 발송 일시 추론

growth_trends

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • repo_id — BIGINT — Foreign key → repositories.id — NOT NULL — 대상 팀(레포) 추론
  • member_id — BIGINT — Foreign key → users.id — 팀원별 조회 시 사용(FR-72 근거)
  • period_date — DATE — NOT NULL — 집계 기준일 추론
  • issue_count — INT — NOT NULL — 이슈 빈도(FR-71,72 근거)
  • created_at — DATETIME — NOT NULL — 집계 생성 일시 추론

learning_card_quizzes

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • card_id — BIGINT — Foreign key → learning_cards.id — NOT NULL — 소속 학습카드(FR-60 근거)
  • question_type — VARCHAR(30) — NOT NULL — 문제 유형(MULTIPLE_CHOICE/SHORT/OX/FILL_IN/LOGIC 등, FR-64 근거)
  • question — TEXT — NOT NULL — 문제 내용
  • options — VARCHAR(1000) — 선택형 보기(저장 형식 추론, 객관식/OX 전용) 추론
  • answer — VARCHAR(255) — NOT NULL — 정답
  • created_at — DATETIME — NOT NULL — 생성 일시(생성 횟수는 크레딧 소진 여부로 제한, FR-60 근거)

learning_cards

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • category — VARCHAR(50) — NOT NULL — 약점 카테고리(FR-58 근거)
  • level — VARCHAR(20) — NOT NULL — 수준(BEGINNER/INTERMEDIATE/ADVANCED, FR-58 근거)
  • language — VARCHAR(50) — 프로그래밍 언어(FR-65 자동 판별 반영)
  • concept_content — TEXT — NOT NULL — 개념 설명(FR-59 근거, Claude API 사용)
  • example_content — TEXT — NOT NULL — 예제 코드(FR-59 근거)
  • grade — VARCHAR(10) — NOT NULL — 신호등 등급(RED/YELLOW/GREEN, FR-61,62 근거)
  • correct_count — INT — NOT NULL — 누적 정답 수(RED→YELLOW 3개, YELLOW→GREEN 7개, FR-61 근거)
  • is_bookmarked — BOOLEAN — NOT NULL — 북마크 여부
  • is_completed — BOOLEAN — NOT NULL — 완료 체크 여부(등급과 별개 상태)
  • created_at — DATETIME — NOT NULL — 생성 일시 추론

notice_email_logs

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • subject — VARCHAR(255) — NOT NULL — 제목
  • content — TEXT — NOT NULL — 내용
  • success_count — INT — NOT NULL — 발송 성공 건수
  • fail_count — INT — NOT NULL — 발송 실패 건수
  • sent_at — DATETIME — NOT NULL — 발송 일시

password_reset_tokens

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • email — VARCHAR(255) — NOT NULL — 대상 이메일
  • reset_token — VARCHAR(255) — NOT NULL — 재설정 토큰(FR-09 근거)
  • expires_at — DATETIME — NOT NULL — 토큰 만료 일시(만료 기준 시간 미확정) 불확실
  • used — BOOLEAN — NOT NULL — 사용 여부(사용 완료 시 is_locked=false 처리) 추론
  • created_at — DATETIME — NOT NULL — 생성 일시 추론

payment_methods

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • card_info — VARCHAR(255) — NOT NULL — 테스트용 카드 정보, 실결제 미적용(FR-86 근거)
  • created_at — DATETIME — NOT NULL — 등록 일시 추론

plans

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • name — VARCHAR(20) — NOT NULL — FREE/PRO/MAX (FR-84 근거)
  • daily_credit_limit — INT — NOT NULL — 일일 크레딧 한도(20/40/70, FR-84,85 근거)
  • allowed_models — VARCHAR(255) — NOT NULL — 허용 모델 범위(콤마 구분, Monica 노출 모델명 기준)
  • price — INT — NOT NULL — 가격(단위: 원, 월간 기준) 추론
  • created_at — DATETIME — NOT NULL — 등록 일시 추론

pull_requests

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • repo_id — BIGINT — Foreign key → repositories.id — NOT NULL — 레포
  • github_pr_number — INT — NOT NULL — GitHub PR 번호
  • title — VARCHAR(255) — PR 제목 추론
  • author_id — BIGINT — Foreign key → users.id — 작성자(FR-40,43 근거)
  • selected_model — VARCHAR(50) — 리뷰에 사용할 AI 모델(API-028, FR-34,35 근거. NULL=기본 모델)
  • status — VARCHAR(20) — NOT NULL — PR 처리 상태 추론
  • webhook_retry_count — INT — NOT NULL — 웹훅 재처리 횟수(재시도 기준 미확정, FR-29 근거) 불확실
  • created_at — DATETIME — NOT NULL — PR 생성 감지 일시
  • updated_at — DATETIME — 최종 업데이트 일시 추론

quiz_submissions

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • quiz_id — BIGINT — Foreign key → learning_card_quizzes.id — NOT NULL — 대상 퀴즈
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 제출자
  • submitted_answer — VARCHAR(255) — NOT NULL — 제출 답안
  • is_correct — BOOLEAN — NOT NULL — 정답 여부(등급 승급 판단 기준, streak 갱신은 정답 여부와 무관)
  • grade_after — VARCHAR(10) — NOT NULL — 제출 후 등급(RED→YELLOW 3문제, YELLOW→GREEN 7문제, FR-61,62 근거)
  • submitted_at — DATETIME — NOT NULL — 제출 일시(user_streaks 갱신 기준 시각)

repo_invitations

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • repo_id — BIGINT — Foreign key → repositories.id — NOT NULL — 레포
  • inviter_id — BIGINT — Foreign key → users.id — NOT NULL — 초대한 팀장
  • invited_github_username — VARCHAR(100) — NOT NULL — 초대 대상 GitHub 아이디(FR-36 근거)
  • invited_user_id — BIGINT — Foreign key → users.id — 수락 후 매핑될 users.id(수락 시점 설정) 추론
  • status — VARCHAR(20) — NOT NULL — PENDING/ACCEPTED/REJECTED(API-030-1 반영) 추론
  • created_at — DATETIME — NOT NULL — 초대 일시
  • responded_at — DATETIME — 수락/거절 일시(FR-37 근거)

repo_members

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • repo_id — BIGINT — Foreign key → repositories.id — NOT NULL — 레포
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 팀원
  • role — VARCHAR(20) — NOT NULL — OWNER/MEMBER(FR-36,37 근거)
  • joined_at — DATETIME — NOT NULL — 합류 일시 추론

repositories

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 연동 등록자(팀장)
  • github_repo_id — VARCHAR(100) — NOT NULL — GitHub 레포 식별자
  • repo_name — VARCHAR(255) — NOT NULL — 레포 이름
  • is_private — BOOLEAN — NOT NULL — private 여부(FR-26,27 근거)
  • webhook_id — VARCHAR(100) — Webhook 자동 등록 ID(FR-27 근거)
  • linked_at — DATETIME — NOT NULL — 연동 일시 추론

review_exports

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • review_id — BIGINT — Foreign key → reviews.id — NOT NULL — 대상 리뷰(FR-45 근거)
  • export_type — VARCHAR(20) — NOT NULL — MD/TXT/PDF/NOTION/PREVIEW
  • status — VARCHAR(20) — NOT NULL — 처리 상태(PDF/Notion/미리보기는 MVP 이후 검토 명시) 불확실
  • result_url — VARCHAR(500) — 다운로드/연동 링크 추론
  • created_at — DATETIME — NOT NULL — 요청 일시 추론

review_guidelines

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • level — VARCHAR(20) — NOT NULL — BEGINNER/INTERMEDIATE/ADVANCED
  • prompt_guideline — TEXT — NOT NULL — 프롬프트 지침 내용
  • updated_at — DATETIME — NOT NULL — 저장 즉시 다음 리뷰부터 적용(FR-25 근거)

review_issues

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • review_id — BIGINT — Foreign key → reviews.id — NOT NULL — 소속 리뷰
  • category — VARCHAR(50) — NOT NULL — BUG/PERFORMANCE/CODE_SMELL/CONVENTION/SECURITY(FR-38,39 근거)
  • severity — VARCHAR(20) — NOT NULL — CRITICAL/MAJOR/MINOR(FR-38,39 근거)
  • file_path — VARCHAR(500) — 이슈 발생 파일 경로(FR-38,39 근거)
  • line_number — INT — 이슈 라인(FR-38,39 근거)
  • description — TEXT — NOT NULL — 이슈 설명/코멘트 내용(FR-38,39 근거)
  • status — VARCHAR(20) — NOT NULL — OPEN/PENDING/RESOLVED/IGNORED(FR-43,44 근거)
  • acknowledged — BOOLEAN — NOT NULL — 의도적 코드 인지 여부(FR-40 근거)
  • request_type — VARCHAR(20) — RESOLVE_REQUEST/IGNORE_REQUEST(FR-43 근거)
  • approved_by — BIGINT — Foreign key → users.id — 팀장 최종 승인자(FR-44 근거)
  • created_at — DATETIME — NOT NULL — 이슈 생성 일시 추론
  • updated_at — DATETIME — 상태 변경 일시 추론

reviews

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • target_type — VARCHAR(20) — NOT NULL — PR/GUEST/PASTE/UPLOAD 구분 추론
  • pr_id — BIGINT — Foreign key → pull_requests.id — target_type=PR인 경우 추론
  • user_id — BIGINT — Foreign key → users.id — 비로그인 게스트는 NULL(FR-50~52 근거)
  • model_name — VARCHAR(50) — NOT NULL — 선택된 AI 모델(FR-34,35 근거)
  • language — VARCHAR(50) — 코드 언어(FR-53,54,65 근거)
  • status — VARCHAR(20) — NOT NULL — 리뷰 처리 상태(PENDING/COMPLETED/FAILED) 추론
  • source_code — TEXT — 원본 코드 스냅샷(PASTE/UPLOAD 시 저장, PR은 GitHub 재조회 가능하여 NULL 허용) 추론
  • original_filename — VARCHAR(255) — 업로드 파일명(UPLOAD 전용) 추론
  • created_at — DATETIME — NOT NULL — 요청 일시

subscription_history

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • subscription_id — BIGINT — Foreign key → subscriptions.id — NOT NULL — 대상 구독 건
  • previous_plan_id — BIGINT — Foreign key → plans.id — NOT NULL — 변경 전 플랜
  • new_plan_id — BIGINT — Foreign key → plans.id — NOT NULL — 변경 후 플랜
  • change_type — VARCHAR(20) — NOT NULL — UPGRADE/DOWNGRADE/CANCEL 추론
  • prorated_amount — INT — 일할계산 기준 표시 금액(테스트용 계산값, 실제 청구 아님, 단위: 원) 불확실
  • changed_at — DATETIME — NOT NULL — 변경 일시

subscriptions

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • plan_id — BIGINT — Foreign key → plans.id — NOT NULL — 현재 구독 플랜(변경 시 이 값만 갱신, 이전 값은 subscription_history 보존)
  • payment_method_id — BIGINT — Foreign key → payment_methods.id — NOT NULL — 결제 수단
  • status — VARCHAR(20) — NOT NULL — ACTIVE/CANCELLED(FR-86 근거)
  • started_at — DATETIME — NOT NULL — 구독 시작 일시
  • cancelled_at — DATETIME — 해지 일시

system_metrics

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • metric_type — VARCHAR(50) — NOT NULL — 측정 항목(목표 수치·엔드포인트 자체 미확정, FR-77 근거) 불확실
  • value — DECIMAL(10, 2) — NOT NULL — 측정값 불확실
  • measured_at — DATETIME — NOT NULL — 측정 일시 추론

terms

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • type — VARCHAR(30) — NOT NULL — SERVICE/PRIVACY/PAYMENT/MARKETING
  • version — VARCHAR(20) — NOT NULL — 약관 버전(예: 1.0, 1.1)
  • title — VARCHAR(255) — NOT NULL — 약관 제목
  • content — TEXT — NOT NULL — 약관 본문
  • is_required — BOOLEAN — NOT NULL — 필수 여부(MARKETING만 FALSE)
  • effective_date — DATE — NOT NULL — 시행일

user_agreements

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • term_id — BIGINT — Foreign key → terms.id — NOT NULL — 동의한 시점의 약관 버전
  • agreed — BOOLEAN — NOT NULL — 동의 여부
  • channel_preference — VARCHAR(20) — 마케팅 수신 채널(EMAIL/NONE, type=MARKETING 전용) 추론
  • agreed_at — DATETIME — NOT NULL — 동의 일시

user_streaks

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자(1:1)
  • current_streak — INT — NOT NULL — 현재 streak(FR-74 근거)
  • last_completed_date — DATE — 마지막 제출일(퀴즈 제출 기준) 추론
  • updated_at — DATETIME — NOT NULL — 갱신 일시(자정 경과 시 초기화 배치, FR-74 근거)

users

  • id — BIGINT — Primary key — NOT NULL — 회원 고유 ID
  • email — VARCHAR(255) — 이메일(일반가입 로그인ID, GitHub 전용가입 시 NULL 가능) 추론
  • password — VARCHAR(255) — 암호화된 비밀번호(GitHub 전용가입 시 NULL, FR-78 근거)
  • github_id — VARCHAR(100) — GitHub 고유 ID(OAuth 식별자) 추론
  • github_username — VARCHAR(100) — GitHub 아이디(팀원 초대 시 사용, FR-36 근거)
  • github_access_token — VARCHAR(500) — GitHub OAuth 액세스 토큰(암호화 저장, FR-13,26,27,78 근거)
  • totp_secret — VARCHAR(255) — TOTP 2단계 인증 시크릿 키(암호화 저장, FR-06-1 근거)
  • totp_enabled — BOOLEAN — NOT NULL — TOTP 2단계 인증 활성화 여부(FR-06-1,06-2 근거)
  • level — VARCHAR(20) — 현재 기술 수준(BEGINNER/INTERMEDIATE/ADVANCED, FR-11,12,15~17 근거)
  • interests — VARCHAR(500) — 관심기술 목록(JSON/CSV 저장 방식은 추론, FR-11,12 근거) 추론
  • onboarding_completed — BOOLEAN — NOT NULL — 온보딩 완료 여부(FR-15,16 근거)
  • guide_confirmed — BOOLEAN — NOT NULL — 가이드 확인 여부(FR-16,17 근거)
  • login_fail_count — INT — NOT NULL — 로그인 연속 실패 횟수(5회 초과 시 잠금, FR-08 근거)
  • is_locked — BOOLEAN — NOT NULL — 계정 잠금 여부(FR-08,10 근거)
  • plan_id — BIGINT — Foreign key → plans.id — 현재 구독 플랜 캐시(비정규화, subscriptions가 원천, SUB-001 근거) 추론
  • role — VARCHAR(20) — NOT NULL — 권한(USER/ADMIN, API-017/FR-21 근거)
  • status — VARCHAR(20) — NOT NULL — 계정 상태(ACTIVE/SUSPENDED, API-016/FR-21 근거)
  • created_at — DATETIME — NOT NULL — 가입 일시 추론
  • updated_at — DATETIME — 정보 수정 일시 추론

weakness_stats

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자
  • category — VARCHAR(50) — NOT NULL — 약점 카테고리
  • language — VARCHAR(50) — 프로그래밍 언어(FR-65 자동 판별 근거)
  • occurrence_count — INT — NOT NULL — 누적 발생 횟수(3회 이상 집계 기준, FR-56 근거)
  • updated_at — DATETIME — NOT NULL — 최종 갱신 일시 추론

weekly_email_batches

  • id — BIGINT — Primary key — NOT NULL — 고유 ID
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 수신자
  • email_type — VARCHAR(30) — NOT NULL — WEEKLY_ANALYSIS/IMPROVEMENT(FR-75,76 근거)
  • sent_at — DATETIME — NOT NULL — 발송 일시(매주 월요일 10시, Spring Scheduler, FR-75 근거)