초안

테이블 (57)

account

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • email — VARCHAR(255) — NOT NULL — 로그인 아이디(소문자 정규화 후 저장)
  • password_hash — VARCHAR(60) — BCrypt 해시. 소셜 전용 계정은 NULL
  • role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER / ADMIN
  • name — VARCHAR(50) — NOT NULL — 이름(클라=대표자명)
  • phone — VARCHAR(20) — NOT NULL — 휴대폰번호(숫자만 정규화 저장)
  • signup_type — VARCHAR(20) — NOT NULL — EMAIL / SOCIAL
  • status — VARCHAR(20) — NOT NULL — PENDING/ACTIVE/LOCKED/WITHDRAWN
  • email_verified — TINYINT(1) — NOT NULL — 이메일 인증 완료 여부
  • login_fail_count — INT — NOT NULL — 연속 로그인 실패 횟수(5회 잠금)
  • locked_at — DATETIME — 계정 잠금 시각
  • is_temp_password — TINYINT(1) — NOT NULL — 임시 비밀번호 상태(로그인 후 변경 강제)
  • password_updated_at — DATETIME — 비밀번호 최종 변경 시각
  • last_login_at — DATETIME — 최종 로그인 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — soft delete(탈퇴 후 14일 유예)

account_withdrawal

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK
  • email_hash — VARCHAR(64) — NOT NULL — 재가입 제한 판별용 이메일 해시
  • phone_hash — VARCHAR(64) — NOT NULL — 재가입 제한 판별용 전화번호 해시
  • reason_code — VARCHAR(50) — 탈퇴 사유 코드
  • reason_text — VARCHAR(500) — 탈퇴 사유 상세
  • withdrawn_at — DATETIME — NOT NULL — 탈퇴 신청 시각
  • rejoin_available_at — DATETIME — NOT NULL — 재가입 가능 시각(탈퇴 +30일)
  • hard_delete_at — DATETIME — NOT NULL — 개인정보 완전 삭제 예정일(탈퇴 +1년)
  • purged_at — DATETIME — 실제 파기 완료 시각

admin_action_log

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • admin_id — BIGINT — 외래 키 → account.id — NOT NULL — 관리자 FK
  • action_type — VARCHAR(50) — NOT NULL — 작업 유형
  • target_type — VARCHAR(30) — 대상 도메인
  • target_id — BIGINT — 대상 리소스 ID
  • detail — TEXT — 작업 상세
  • ip_address — VARCHAR(45) — 접속 IP(개인정보 접속기록 보관 의무)
  • created_at — DATETIME — NOT NULL

ai_agent_log

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • agent_type — VARCHAR(30) — NOT NULL — PARSER/EMBEDDING/MATCHER/NEGOTIATOR/CONTRACT/CHATBOT
  • ref_type — VARCHAR(30) — 연관 도메인
  • ref_id — BIGINT — 연관 리소스 ID
  • model — VARCHAR(50) — 사용 모델명
  • request_json — JSON — 요청 페이로드
  • response_json — JSON — 응답 페이로드
  • prompt_tokens — INT — 입력 토큰 수
  • output_tokens — INT — 출력 토큰 수
  • cost_amount — DECIMAL(12, 4) — 호출 비용
  • latency_ms — INT — 응답 소요 시간(ms)
  • status — VARCHAR(20) — NOT NULL — SUCCESS / FAILED
  • error_message — TEXT — 오류 메시지
  • created_at — DATETIME — NOT NULL

chat_message

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • chat_room_id — BIGINT — 외래 키 → chat_room.id — NOT NULL — 채팅방 FK
  • sender_id — BIGINT — 외래 키 → account.id — 발신자 FK(NULL=시스템)
  • content — VARCHAR(500) — NOT NULL — 메시지(최대 500자)
  • created_at — DATETIME — NOT NULL

chat_room

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • negotiation_id — BIGINT — 외래 키 → negotiation.id — NOT NULL — 협상 FK(1:1)
  • input_enabled — TINYINT(1) — NOT NULL — 사람 입력창 활성화(AI Out 이후 1)
  • status — VARCHAR(20) — NOT NULL — ACTIVE/CLOSED
  • created_at — DATETIME — NOT NULL
  • closed_at — DATETIME

chat_room_member

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • chat_room_id — BIGINT — 외래 키 → chat_room.id — NOT NULL — 채팅방 FK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 참여자 FK
  • party_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • last_read_at — DATETIME — 마지막 읽은 시각
  • left_at — DATETIME — 나가기 시각. 본인 조회에서만 숨김(데이터는 5년 보존)

chatbot_message

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • session_id — BIGINT — 외래 키 → chatbot_session.id — NOT NULL — 세션 FK
  • sender_type — VARCHAR(20) — NOT NULL — USER / BOT
  • content — TEXT — NOT NULL — 메시지
  • created_at — DATETIME — NOT NULL

chatbot_quota

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 사용자 FK
  • quota_date — DATE — NOT NULL — 기준 일자
  • used_count — INT — NOT NULL — 사용 횟수(1일 10회 충전)
  • updated_at — DATETIME — NOT NULL

chatbot_session

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 사용자 FK
  • status — VARCHAR(20) — NOT NULL — ACTIVE/CLOSED/ESCALATED
  • started_at — DATETIME — NOT NULL
  • closed_at — DATETIME

client_profile

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK(1:1)
  • company_name — VARCHAR(100) — NOT NULL — 기업명
  • business_no — CHAR(10) — NOT NULL — 사업자등록번호(하이픈 없는 10자리)
  • business_field — VARCHAR(50) — NOT NULL — 사업 분야(IT_CONTENTS_AI/GAME/FINANCE 등 20종)
  • employee_count — VARCHAR(30) — NOT NULL — 직원수 구간(UNDER_10/10_49/50_99 등)
  • address — VARCHAR(255) — 기업 주소(계약서 갑 표시용)
  • logo_file_id — BIGINT — 외래 키 → file.id — 기업 사진 FK
  • grade — VARCHAR(20) — NOT NULL — SILVER/GOLD/DIAMOND
  • grade_expires_at — DATETIME — 등급 만료일(구독)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

contract

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_no — VARCHAR(50) — NOT NULL — 계약 번호
  • negotiation_id — BIGINT — 외래 키 → negotiation.id — NOT NULL — 협상 FK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • client_id — BIGINT — 외래 키 → client_profile.id — NOT NULL — 클라이언트 FK(갑)
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — NOT NULL — 프리랜서 FK(을)
  • total_amount — DECIMAL(15, 0) — NOT NULL — 총 계약 금액(부가세 별도)
  • down_amount — DECIMAL(15, 0) — NOT NULL — 착수금
  • final_amount — DECIMAL(15, 0) — NOT NULL — 성공보수(잔금)
  • start_date — DATE — NOT NULL — 착수일
  • end_date — DATE — NOT NULL — 완료일
  • work_style — VARCHAR(20) — NOT NULL — 근무 방식
  • work_form — VARCHAR(20) — NOT NULL — 근무 형태
  • work_location — VARCHAR(255) — 근무 장소(상주 시)
  • inspection_days — INT — NOT NULL — 검수 기한(일)
  • payment_days — INT — NOT NULL — 검수 후 지급 기한(일)
  • confidential_years — INT — NOT NULL — 비밀유지 존속 연수
  • penalty_rate — DECIMAL(5, 2) — NOT NULL — 중도 해지 위약금율(%)
  • special_terms — TEXT — 제15조 특약사항(협상 로그 기반)
  • content_json — JSON — 계약서 렌더링용 조항 스냅샷
  • pdf_file_id — BIGINT — 외래 키 → file.id — 생성된 계약서 PDF FK(S3)
  • esign_provider — VARCHAR(30) — 외부 전자서명 서비스명
  • esign_doc_id — VARCHAR(255) — 외부 서비스 문서 ID
  • status — VARCHAR(20) — NOT NULL — DRAFT/PENDING_SIGN/SIGNED/IN_PROGRESS/COMPLETED/TERMINATED
  • signed_at — DATETIME — 양측 서명 완료 시각
  • completed_at — DATETIME — 프로젝트 완료 확정 시각
  • terminated_at — DATETIME — 중도 해지 시각
  • retention_until — DATE — 보존 만료일(완료 +5년)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

contract_signature

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 서명자 FK
  • party_role — VARCHAR(20) — NOT NULL — CLIENT(갑) / FREELANCER(을)
  • signed_at — DATETIME — 서명 시각
  • ip_address — VARCHAR(45) — 서명 시점 IP
  • user_agent — VARCHAR(500) — 서명 시점 User-Agent
  • signature_image_id — BIGINT — 외래 키 → file.id — 서명 이미지 FK(자체 구현 시)
  • provider_signer_id — VARCHAR(255) — 외부 서명 서비스 참여자 ID
  • status — VARCHAR(20) — NOT NULL — PENDING/SIGNED/REJECTED

deliverable

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • milestone_id — BIGINT — 외래 키 → milestone.id — 마일스톤 FK
  • title — VARCHAR(200) — NOT NULL — 산출물명
  • description — TEXT — 설명
  • file_id — BIGINT — 외래 키 → file.id — 산출물 파일 FK
  • submitted_at — DATETIME — NOT NULL — 제출 시각
  • status — VARCHAR(20) — NOT NULL — SUBMITTED/APPROVED/REJECTED
  • reviewed_at — DATETIME — 검수 시각
  • review_comment — TEXT — 검수 의견/보완 요청

dispute

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • raised_by — BIGINT — 외래 키 → account.id — NOT NULL — 신청자 FK
  • dispute_type — VARCHAR(30) — NOT NULL — PAYMENT/QUALITY/SCHEDULE/TERMINATION/ETC
  • title — VARCHAR(200) — NOT NULL — 제목
  • content — TEXT — NOT NULL — 클레임 내용
  • ai_suggestion — JSON — AI 조정 제안 목록
  • status — VARCHAR(20) — NOT NULL — OPEN/IN_REVIEW/MEDIATING/RESOLVED/CLOSED
  • resolution — TEXT — 조정 결과
  • handled_by — BIGINT — 외래 키 → account.id — 처리 관리자 FK
  • created_at — DATETIME — NOT NULL
  • resolved_at — DATETIME

email_send_log

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • email — VARCHAR(255) — NOT NULL — 수신 이메일
  • purpose — VARCHAR(30) — NOT NULL — 발송 목적
  • ip_address — VARCHAR(45) — 요청 IP(이메일+IP 이중 제한)
  • created_at — DATETIME — NOT NULL

email_verification

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • email — VARCHAR(255) — NOT NULL — 대상 이메일
  • purpose — VARCHAR(30) — NOT NULL — SIGNUP / PASSWORD_RESET / UNLOCK
  • code_hash — VARCHAR(255) — NOT NULL — 인증코드 해시(평문 저장 금지)
  • expires_at — DATETIME — NOT NULL — 만료 시각(발송 +3분)
  • verified_at — DATETIME — 인증 완료 시각
  • attempt_count — INT — NOT NULL — 코드 입력 시도 횟수(5회 초과 시 폐기)
  • created_at — DATETIME — NOT NULL

fee_policy

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • phase — VARCHAR(20) — NOT NULL — DOWN_PAYMENT(착수금) / SUCCESS_FEE(성공보수)
  • amount_min — DECIMAL(15, 0) — NOT NULL — 적용 계약금액 하한(포함)
  • amount_max — DECIMAL(15, 0) — 적용 계약금액 상한(미만), NULL=무제한
  • client_rate — DECIMAL(5, 2) — NOT NULL — 클라이언트 수수료율(%)
  • freelancer_rate — DECIMAL(5, 2) — NOT NULL — 프리랜서 수수료율(%)
  • effective_from — DATE — NOT NULL — 적용 시작일

file

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • file_group — VARCHAR(30) — NOT NULL — PROFILE_IMAGE / PORTFOLIO / PROJECT_DOC / CONTRACT_PDF
  • original_name — VARCHAR(255) — NOT NULL — 업로드 원본 파일명
  • storage_key — VARCHAR(500) — NOT NULL — S3 오브젝트 키
  • mime_type — VARCHAR(100) — NOT NULL — MIME 타입
  • size_bytes — BIGINT — NOT NULL — 파일 크기(byte)
  • uploaded_by — BIGINT — 업로더 account.id
  • created_at — DATETIME — NOT NULL

freelancer_profile

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK(1:1)
  • birth_date — DATE — NOT NULL — 생년월일(만 18세 이상 검증, 연도 하드코딩 금지)
  • address — VARCHAR(255) — 주소
  • profile_file_id — BIGINT — 외래 키 → file.id — 프로필 사진 FK(5MB 이하)
  • ai_matching_agreed — TINYINT(1) — NOT NULL — AI 매칭 대상 포함 여부
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

grade_policy

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • grade — VARCHAR(20) — NOT NULL — SILVER / GOLD / DIAMOND
  • expose_count — INT — NOT NULL — 후보 노출 인원(실버2/골드3/다이아5)
  • monthly_price — DECIMAL(15, 0) — NOT NULL — 구독 월 요금(원)
  • free_reroll — INT — NOT NULL — 무료 리롤 횟수
  • paid_reroll_max — INT — NOT NULL — 유료 리롤 최대 횟수
  • effective_from — DATE — NOT NULL — 적용 시작일

inquiry

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 문의자 FK
  • session_id — BIGINT — 외래 키 → chatbot_session.id — 에스컬레이션된 챗봇 세션 FK
  • category — VARCHAR(30) — NOT NULL — 문의 유형
  • title — VARCHAR(200) — NOT NULL — 제목
  • content — TEXT — NOT NULL — 내용
  • status — VARCHAR(20) — NOT NULL — RECEIVED/IN_PROGRESS/ANSWERED/CLOSED
  • answer — TEXT — 답변
  • answered_by — BIGINT — 외래 키 → account.id — 답변 관리자 FK
  • answered_at — DATETIME
  • created_at — DATETIME — NOT NULL

job_category

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(50) — NOT NULL — 직군명(개발/디자인)
  • sort_order — INT — NOT NULL
  • is_active — TINYINT(1) — NOT NULL

job_role

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • job_category_id — BIGINT — 외래 키 → job_category.id — NOT NULL — 직군 FK
  • name — VARCHAR(80) — NOT NULL — 직무명(백엔드 개발자 등)
  • sort_order — INT — NOT NULL
  • is_active — TINYINT(1) — NOT NULL

login_attempt_log

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • email — VARCHAR(255) — 시도 이메일
  • ip_address — VARCHAR(45) — NOT NULL — 요청 IP
  • is_success — TINYINT(1) — NOT NULL — 성공 여부
  • fail_reason — VARCHAR(50) — NO_ACCOUNT / WRONG_PASSWORD / LOCKED
  • created_at — DATETIME — NOT NULL

matching_candidate

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • round_id — BIGINT — 외래 키 → matching_round.id — NOT NULL — 매칭 회차 FK
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — NOT NULL — freelancer_profile FK
  • stage — VARCHAR(20) — NOT NULL — EMBEDDING(1차)/LLM_FINAL(최종)
  • similarity — DECIMAL(6, 4) — 임베딩 코사인 유사도
  • fit_score — DECIMAL(5, 2) — LLM 적합도 점수
  • fit_reason — TEXT — LLM 적합 근거(노출 시 함께 표시)
  • rank_no — INT — 최종 순위
  • is_exposed — TINYINT(1) — NOT NULL — 클라이언트에게 노출 여부
  • created_at — DATETIME — NOT NULL

matching_request

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • candidate_id — BIGINT — 외래 키 → matching_candidate.id — NOT NULL — 후보 FK
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — NOT NULL — freelancer_profile FK(조회 편의)
  • status — VARCHAR(20) — NOT NULL — PENDING/ACCEPTED/REJECTED/EXPIRED
  • requested_at — DATETIME — NOT NULL — 요청 발송 시각
  • expires_at — DATETIME — NOT NULL — 응답 기한(요청 +3일)
  • responded_at — DATETIME — 응답 시각
  • reject_reason — VARCHAR(255) — 거절 사유

matching_round

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • round_no — INT — NOT NULL — 회차(1=최초 추천)
  • round_type — VARCHAR(20) — NOT NULL — INITIAL / FREE_REROLL / PAID_REROLL
  • requested_count — INT — 유료 리롤 시 요청 인원 수
  • cost_amount — DECIMAL(15, 0) — NOT NULL — 리롤 비용(인원당 20,000원)
  • expose_count — INT — NOT NULL — 등급에 따른 노출 인원(2/3/5)
  • low_score_warned — TINYINT(1) — NOT NULL — 적합도 임계값 미달 경고 표시 여부
  • status — VARCHAR(20) — NOT NULL — RUNNING/COMPLETED/FAILED/EXHAUSTED
  • created_at — DATETIME — NOT NULL

matching_snapshot

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — freelancer_profile FK(프리랜서 스냅샷일 때)
  • snapshot_type — VARCHAR(20) — NOT NULL — PROJECT / FREELANCER
  • snapshot_json — JSON — NOT NULL — 매칭중 전환 시점의 원본 데이터 동결본
  • created_at — DATETIME — NOT NULL

milestone

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • title — VARCHAR(200) — NOT NULL — 마일스톤명
  • description — TEXT — 설명
  • due_date — DATE — 목표일
  • progress — INT — NOT NULL — 진행률(%)
  • status — VARCHAR(20) — NOT NULL — TODO/IN_PROGRESS/DONE
  • sort_order — INT — NOT NULL
  • created_at — DATETIME — NOT NULL

negotiation

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — NOT NULL — freelancer_profile FK
  • request_id — BIGINT — 외래 키 → matching_request.id — NOT NULL — 수락된 매칭 요청 FK
  • status — VARCHAR(20) — NOT NULL — IN_PROGRESS/AI_OUT/AGREED/GIVEN_UP/BROKEN_DOWN
  • total_round — INT — NOT NULL — 누적 AI 제안 라운드(상한 15)
  • agreed_amount — DECIMAL(15, 0) — 최종 타결 금액
  • budget_cap — DECIMAL(15, 0) — NOT NULL — 클라 예산 상한(가드)
  • floor_amount — DECIMAL(15, 0) — NOT NULL — 프리 최저 수용가(가드)
  • ai_out_at — DATETIME — AI Out 시각(사람 채팅 활성화)
  • started_at — DATETIME — NOT NULL
  • ended_at — DATETIME — 협상 종료 시각
  • end_reason — VARCHAR(255) — 종료 사유

negotiation_approval

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • negotiation_id — BIGINT — 외래 키 → negotiation.id — NOT NULL — 협상 FK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 응답자 FK
  • party_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • approved — TINYINT(1) — NOT NULL — Y/N (양측 Y여야 승인)
  • responded_at — DATETIME — NOT NULL

negotiation_condition

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • negotiation_id — BIGINT — 외래 키 → negotiation.id — NOT NULL — 협상 FK
  • condition_type — VARCHAR(30) — NOT NULL — AMOUNT/PERIOD/START_DATE/WORK_STYLE/WORK_FORM/SKILL 등
  • client_value — VARCHAR(255) — 클라이언트 조건값
  • freelancer_value — VARCHAR(255) — 프리랜서 조건값
  • agreed_value — VARCHAR(255) — 합의된 값
  • status — VARCHAR(20) — NOT NULL — PENDING/IN_PROGRESS/AGREED/FAILED
  • round_count — INT — NOT NULL — 해당 조건 협상 라운드 수
  • sort_order — INT — NOT NULL — 협상 순서
  • agreed_at — DATETIME

negotiation_message

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • negotiation_id — BIGINT — 외래 키 → negotiation.id — NOT NULL — 협상 FK
  • condition_id — BIGINT — 외래 키 → negotiation_condition.id — 협상 조건 FK
  • round_no — INT — NOT NULL — 라운드 번호
  • sender_type — VARCHAR(20) — NOT NULL — AI_AGENT / CLIENT / FREELANCER / SYSTEM
  • message_type — VARCHAR(20) — NOT NULL — PROPOSAL/RESPONSE/QUESTION/NOTICE
  • content — TEXT — NOT NULL — 메시지 본문
  • reason — TEXT — 제안 근거. ※AI 제안은 NULL 금지
  • proposed_value — VARCHAR(255) — 제안 값(금액/조건)
  • response — VARCHAR(20) — YES/NO/CUSTOM
  • created_at — DATETIME — NOT NULL

notification

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 수신자 FK
  • type — VARCHAR(50) — NOT NULL — RECOMMEND_DONE/REQUEST_RECEIVED/REQUEST_ACCEPTED/REQUEST_REJECTED/NEGOTIATION_START/AI_PROPOSAL/NEGOTIATION_BROKEN/CONT…
  • title — VARCHAR(200) — NOT NULL — 알림 제목
  • content — VARCHAR(500) — 알림 내용
  • link_url — VARCHAR(500) — 클릭 시 이동 경로
  • ref_type — VARCHAR(30) — 연관 도메인(PROJECT/NEGOTIATION/CONTRACT)
  • ref_id — BIGINT — 연관 리소스 ID
  • is_read — TINYINT(1) — NOT NULL — 읽음 여부
  • read_at — DATETIME — 읽은 시각
  • created_at — DATETIME — NOT NULL

payment_method

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK
  • method_type — VARCHAR(20) — NOT NULL — CARD(수수료 결제) / BANK_ACCOUNT(정산 수령)
  • billing_key — VARCHAR(255) — PG 빌링키. ※카드번호 원문 저장 금지
  • card_brand — VARCHAR(30) — 카드사명
  • card_last4 — CHAR(4) — 카드 끝 4자리(표시용)
  • bank_code — VARCHAR(10) — 은행 코드
  • account_no_enc — VARBINARY(255) — 계좌번호 암호화(AES, KMS 키 관리)
  • account_holder — VARCHAR(50) — 예금주
  • is_default — TINYINT(1) — NOT NULL — 기본 수단 여부
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME

penalty

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • terminator_role — VARCHAR(20) — NOT NULL — 파기 주체 CLIENT / FREELANCER
  • worked_amount — DECIMAL(15, 0) — NOT NULL — 수행분 정산 금액
  • penalty_rate — DECIMAL(5, 2) — NOT NULL — 위약금율(%)
  • penalty_amount — DECIMAL(15, 0) — NOT NULL — 위약금 금액
  • payer_account_id — BIGINT — 외래 키 → account.id — NOT NULL — 위약금 지급자 FK
  • payee_account_id — BIGINT — 외래 키 → account.id — NOT NULL — 위약금 수령자 FK
  • status — VARCHAR(20) — NOT NULL — PENDING/PAYABLE/PAID/DISPUTED
  • paid_at — DATETIME
  • created_at — DATETIME — NOT NULL

project

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • client_id — BIGINT — 외래 키 → client_profile.id — NOT NULL — client_profile FK
  • title — VARCHAR(200) — NOT NULL — 프로젝트 이름
  • job_category_id — BIGINT — 외래 키 → job_category.id — NOT NULL — 직군 FK
  • job_role_id — BIGINT — 외래 키 → job_role.id — NOT NULL — 직무 FK
  • required_headcount — INT — NOT NULL — 필요 인력(최소 1)
  • min_career_years — INT — NOT NULL — 희망 연차(최소 1)
  • start_desired_date — DATE — 시작 희망일
  • start_negotiable — TINYINT(1) — NOT NULL — 시작일 협의 가능
  • period_value — INT — NOT NULL — 예상 기간 값(최대 24)
  • period_unit — VARCHAR(10) — NOT NULL — MONTH / WEEK
  • budget_amount — DECIMAL(15, 0) — NOT NULL — 예산(원, 500만~10억, 부가세 별도)
  • work_style — VARCHAR(20) — NOT NULL — REMOTE/ONSITE/ANY
  • work_form — VARCHAR(20) — NOT NULL — FULL_TIME/PART_TIME/ANY
  • work_location — VARCHAR(255) — 근무 장소(상주 시)
  • current_situation — VARCHAR(1500) — 현재 프로젝트 진행 상황
  • main_task — VARCHAR(1500) — 주요 담당 업무
  • detail_scope — VARCHAR(1500) — 세부 업무범위
  • extra_note — VARCHAR(1500) — 기타 전달사항/우대사항
  • status — VARCHAR(20) — NOT NULL — DRAFT/RECRUITING(모집중)/MATCHING(매칭중)/NEGOTIATING(협상중)/COMPLETED/CANCELED
  • matched_count — INT — NOT NULL — 수락 확정 인원
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — 매칭 전 삭제 시 즉시 hard delete, 이후는 보존

project_embedding

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • model — VARCHAR(50) — NOT NULL — 임베딩 모델명
  • dimension — INT — NOT NULL — 벡터 차원 수
  • vector — JSON — NOT NULL — 벡터 값
  • source_text — TEXT — 임베딩 원본 텍스트
  • created_at — DATETIME — NOT NULL

project_file

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • file_id — BIGINT — 외래 키 → file.id — NOT NULL — 파일 FK(100MB 이하, 최대 10개)
  • sort_order — INT — NOT NULL

project_parse

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • raw_text — TEXT — NOT NULL — 자연어 입력 원문
  • parsed_json — JSON — 구조화 결과(직군/직무/스킬/예산/기간/근무방식)
  • status — VARCHAR(20) — NOT NULL — PENDING/SUCCESS/FAILED
  • fail_reason — VARCHAR(255) — 실패 사유
  • confirmed_at — DATETIME — 클라이언트 확인·수정 완료 시각
  • created_at — DATETIME — NOT NULL

project_skill

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • project_id — BIGINT — 외래 키 → project.id — NOT NULL — 프로젝트 FK
  • skill_id — BIGINT — 외래 키 → skill.id — NOT NULL — 스킬 FK

resume

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • freelancer_id — BIGINT — 외래 키 → freelancer_profile.id — NOT NULL — freelancer_profile FK
  • job_category_id — BIGINT — 외래 키 → job_category.id — NOT NULL — 직군 FK
  • job_role_id — BIGINT — 외래 키 → job_role.id — NOT NULL — 직무 FK
  • affiliation — VARCHAR(100) — 소속(선택)
  • work_style — VARCHAR(20) — NOT NULL — REMOTE(재택)/ONSITE(상주)/ANY
  • work_form — VARCHAR(20) — NOT NULL — FULL_TIME/PART_TIME/ANY
  • pay_unit — VARCHAR(20) — NOT NULL — HOURLY/DAILY/MONTHLY
  • pay_amount — DECIMAL(15, 0) — NOT NULL — 희망 급여(원, 만원 단위 입력 / 최소 10000)
  • min_accept_amount — DECIMAL(15, 0) — 최저 수용가(협상 하한 가드)
  • available_from — DATE — 프로젝트 시작 가능일
  • start_negotiable — TINYINT(1) — NOT NULL — 시작일 협의 가능
  • period_value — INT — NOT NULL — 예상 기간 값(최대 24)
  • period_unit — VARCHAR(10) — NOT NULL — MONTH / WEEK
  • has_freelance_exp — TINYINT(1) — NOT NULL — 프리랜서 경험 유무
  • career_years — INT — NOT NULL — 경력 연차(최소 1)
  • self_introduction — TEXT — 간단 자기소개
  • portfolio_file_id — BIGINT — 외래 키 → file.id — 포트폴리오 PDF FK(20MB 권장)
  • status — VARCHAR(20) — NOT NULL — DRAFT(임시저장)/COMPLETED
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_career

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • start_date — DATE — NOT NULL — 근무 시작일
  • end_date — DATE — 근무 종료일(NULL=재직중)
  • company_name — VARCHAR(100) — NOT NULL — 회사/기관명
  • department_rank — VARCHAR(100) — 부서 및 직급
  • job_description — TEXT — 담당 업무
  • sort_order — INT — NOT NULL

resume_certificate

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • acquired_date — DATE — NOT NULL — 취득일자
  • name — VARCHAR(100) — NOT NULL — 자격/어학 시험명
  • issuer_score — VARCHAR(100) — 발급기관 또는 점수
  • note — VARCHAR(255) — 비고
  • sort_order — INT — NOT NULL

resume_education

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • start_date — DATE — NOT NULL — 입학일
  • end_date — DATE — 졸업일
  • school_name — VARCHAR(100) — NOT NULL — 학교명
  • major — VARCHAR(100) — 전공
  • graduation_status — VARCHAR(20) — NOT NULL — GRADUATED/ENROLLED/LEAVE/DROPOUT/EXPECTED
  • campus_type — VARCHAR(20) — MAIN(본교)/BRANCH(분교)
  • sort_order — INT — NOT NULL

resume_embedding

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • model — VARCHAR(50) — NOT NULL — 임베딩 모델명
  • dimension — INT — NOT NULL — 벡터 차원 수
  • vector — JSON — NOT NULL — 벡터 값. ※MySQL 8.0은 벡터 검색 미지원 - 운영은 외부 벡터 DB 권장
  • source_text — TEXT — 임베딩 원본 텍스트(폼 텍스트만, 첨부 PDF 제외)
  • created_at — DATETIME — NOT NULL

resume_link

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • link_type — VARCHAR(30) — NOT NULL — GITHUB/PORTFOLIO/NOTION/LINKEDIN/ETC
  • url — VARCHAR(500) — NOT NULL — URL

resume_skill

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • resume_id — BIGINT — 외래 키 → resume.id — NOT NULL — 이력서 FK
  • skill_id — BIGINT — 외래 키 → skill.id — NOT NULL — 스킬 FK
  • level — VARCHAR(20) — NOT NULL — BEGINNER(초급)/INTERMEDIATE(중급)/ADVANCED(고급)

review

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • reviewer_id — BIGINT — 외래 키 → account.id — NOT NULL — 작성자 FK
  • reviewee_id — BIGINT — 외래 키 → account.id — NOT NULL — 대상자 FK
  • rating — TINYINT — NOT NULL — 별점 1~5(1점 단위, 필수)
  • content — VARCHAR(500) — 리뷰(선택, 500자 이하)
  • created_at — DATETIME — NOT NULL — 작성 후 수정·삭제 불가

review_summary

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 대상 계정 FK
  • review_count — INT — NOT NULL — 받은 리뷰 건수
  • rating_sum — INT — NOT NULL — 별점 합계
  • rating_avg — DECIMAL(3, 2) — NOT NULL — 평균 별점
  • updated_at — DATETIME — NOT NULL

settlement

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • payer_account_id — BIGINT — 외래 키 → account.id — NOT NULL — 수수료 납부자 FK
  • payer_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • phase — VARCHAR(20) — NOT NULL — DOWN_PAYMENT / SUCCESS_FEE
  • base_amount — DECIMAL(15, 0) — NOT NULL — 수수료 산정 기준 금액
  • fee_rate — DECIMAL(5, 2) — NOT NULL — 적용 수수료율(%)
  • fee_amount — DECIMAL(15, 0) — NOT NULL — 수수료 금액(원)
  • payment_method_id — BIGINT — 외래 키 → payment_method.id — 결제 수단 FK
  • status — VARCHAR(20) — NOT NULL — PENDING(버튼 비활성)/PAYABLE(활성)/PAID/FAILED/REFUNDED
  • pg_tid — VARCHAR(255) — PG 거래 ID
  • paid_at — DATETIME — 결제 완료 시각
  • due_date — DATE — 납부 기한(미납 시 탈퇴 제한)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

site_review

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • contract_id — BIGINT — 외래 키 → contract.id — NOT NULL — 계약 FK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 작성자 FK
  • rating — TINYINT — NOT NULL — 별점 1~5(필수)
  • content — VARCHAR(500) — 이용후기(선택, 500자 이하)
  • is_exposed — TINYINT(1) — NOT NULL — 메인/홍보 노출 여부
  • created_at — DATETIME — NOT NULL

skill

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • name — VARCHAR(50) — NOT NULL — 스킬명(React, Spring Boot 등)
  • group_name — VARCHAR(50) — 스킬 분류(FRONTEND/BACKEND/DATA/INFRA/DESIGN/TOOL)
  • sort_order — INT — NOT NULL
  • is_active — TINYINT(1) — NOT NULL

social_account

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK
  • provider — VARCHAR(20) — NOT NULL — KAKAO / GOOGLE
  • provider_uid — VARCHAR(255) — NOT NULL — 공급자 고유 ID(카카오 id / 구글 sub)
  • provider_email — VARCHAR(255) — 공급자가 준 이메일(마스킹/미인증 가능)
  • email_verified — TINYINT(1) — NOT NULL — 공급자 이메일 인증 여부
  • connected_at — DATETIME — NOT NULL

terms

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • code — VARCHAR(50) — NOT NULL — 약관 코드(SERVICE/PRIVACY/REVIEW_EXPOSURE/MARKETING 등)
  • version — VARCHAR(20) — NOT NULL — 약관 버전(v1.0)
  • title — VARCHAR(200) — NOT NULL — 약관 제목
  • content — LONGTEXT — NOT NULL — 약관 전문(버전별 INSERT, UPDATE 금지)
  • is_required — TINYINT(1) — NOT NULL — 필수 동의 여부
  • target_role — VARCHAR(20) — CLIENT / FREELANCER / NULL(공통)
  • effective_at — DATETIME — NOT NULL — 시행일
  • created_at — DATETIME — NOT NULL

terms_agreement

  • id — BIGINT — 기본 키 — NOT NULL — PK
  • account_id — BIGINT — 외래 키 → account.id — NOT NULL — 계정 FK
  • terms_id — BIGINT — 외래 키 → terms.id — NOT NULL — 약관 FK(버전 포함)
  • agreed — TINYINT(1) — NOT NULL — 동의 여부
  • agreed_at — DATETIME — NOT NULL — 동의 시각
  • ip_address — VARCHAR(45) — 동의 시점 IP(IPv6 대응)
  • user_agent — VARCHAR(500) — 동의 시점 User-Agent