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 근거)