pairing

Tables (49)

account

  • id — BIGINT — Primary key — 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 / SUSPENDED / 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 — 최종 로그인 시각
  • suspended_at — DATETIME — 정지 시각(관리자)
  • suspend_reason — VARCHAR(500) — 정지 사유
  • suspended_by — BIGINT — Foreign key → account.id — 정지 처리 관리자 FK
  • released_at — DATETIME — 정지 해제 시각
  • released_by — BIGINT — Foreign key → account.id — 해제 처리 관리자 FK
  • withdrawn_at — DATETIME — 탈퇴 시각
  • withdraw_reason — VARCHAR(500) — 탈퇴 사유
  • email_hash — VARCHAR(64) — 탈퇴 시 원본 이메일 SHA-256(재가입 30일 판정용)
  • phone_hash — VARCHAR(64) — 탈퇴 시 원본 전화번호 SHA-256
  • rejoin_available_at — DATETIME — 재가입 가능 시각(탈퇴 +30일)
  • purge_at — DATETIME — 등록 내용 삭제 예정일(탈퇴 +1년)
  • purged_at — DATETIME — 실제 파기 완료 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — soft delete 표시

ai_agent_log

  • id — BIGINT — Primary key — 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 — Primary key — NOT NULL — PK
  • chat_room_id — BIGINT — Foreign key → chat_room.id — NOT NULL — 채팅방 FK
  • sender_id — BIGINT — Foreign key → account.id — 발신자 FK(NULL=시스템)
  • content — VARCHAR(500) — NOT NULL — 메시지(최대 500자)
  • created_at — DATETIME — NOT NULL

chat_room

  • id — BIGINT — Primary key — NOT NULL — PK
  • negotiation_id — BIGINT — Foreign key → 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
  • updated_at — DATETIME — NOT NULL
  • closed_at — DATETIME

chat_room_member

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

chatbot_message

  • id — BIGINT — Primary key — NOT NULL — PK
  • session_id — BIGINT — Foreign key → 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 — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 사용자 FK
  • quota_date — DATE — NOT NULL — 기준 일자
  • used_count — INT — NOT NULL — LLM 호출 사용 횟수(1일 10회 충전)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

chatbot_session

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 사용자 FK
  • status — VARCHAR(20) — NOT NULL — ACTIVE / CLOSED / ESCALATED(문의 전환)
  • started_at — DATETIME — NOT NULL
  • closed_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

client_profile

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 계정 FK(1:1)
  • company_name — VARCHAR(100) — NOT NULL — 기업명(수정 가능)
  • business_no — CHAR(10) — NOT NULL — 사업자등록번호(하이픈 없는 10자리, 국세청 API 검증)
  • business_field — VARCHAR(40) — NOT NULL — 사업 분야 코드 20종(IT_CONTENTS_AI / GAME / FINANCE / MEDICAL 등)
  • employee_count — VARCHAR(30) — NOT NULL — 직원수 구간 코드(UNDER_10 / 10_49 / 50_99 / 100_299 / OVER_300)
  • address — VARCHAR(255) — 기업 주소(계약서 갑 표시용)
  • logo_file_id — BIGINT — Foreign key → file.id — 기업 사진 FK
  • grade — VARCHAR(20) — NOT NULL — SILVER / GOLD / DIAMOND
  • grade_checked_at — DATETIME — 최근 등급 산정 시각(월 1회 배치)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME

contract

  • id — BIGINT — Primary key — NOT NULL — PK
  • contract_no — VARCHAR(50) — NOT NULL — 계약 번호
  • negotiation_id — BIGINT — Foreign key → negotiation.id — NOT NULL — 협상 FK(1:1)
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK
  • client_id — BIGINT — Foreign key → client_profile.id — NOT NULL — 클라이언트 FK(갑)
  • freelancer_id — BIGINT — Foreign key → freelancer_profile.id — NOT NULL — 프리랜서 FK(을)
  • template_version — VARCHAR(20) — NOT NULL — 적용 계약서 템플릿 버전(과거 계약 입증용)
  • 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 — 제8조 검수 기한(일)
  • payment_days — INT — NOT NULL — 제5조 검수 후 지급 기한(일)
  • confidential_years — INT — NOT NULL — 제10조 비밀유지 존속 연수
  • penalty_rate — DECIMAL(5, 2) — NOT NULL — 제12조 위약금율(%). 상대방 10% + 플랫폼 10%
  • special_terms — TEXT — 제15조 특약사항(협상 로그 기반)
  • content_json — JSON — 계약서 조항 스냅샷(렌더링용)
  • pdf_file_id — BIGINT — Foreign key → file.id — 생성된 계약서 PDF FK(S3)
  • pdf_hash — CHAR(64) — 계약서 PDF SHA-256(위변조 검증)
  • esign_provider — VARCHAR(30) — 외부 전자서명 서비스명
  • esign_doc_id — VARCHAR(255) — 외부 서비스 문서 ID
  • status — VARCHAR(30) — NOT NULL — DRAFT / PENDING_SIGN / SIGNED / IN_PROGRESS / COMPLETION_PENDING / CLOSED / TERMINATED
  • signed_at — DATETIME — 양측 서명 완료 시각(계약 체결)
  • completed_at — DATETIME — 검수 완료 시각
  • terminated_at — DATETIME — 중도 해지 시각
  • terminated_by — VARCHAR(20) — 파기 주체 CLIENT / FREELANCER
  • retention_until — DATE — 보존 만료일(정산 완료 +5년)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

contract_signature

  • id — BIGINT — Primary key — NOT NULL — PK
  • contract_id — BIGINT — Foreign key → contract.id — NOT NULL — 계약 FK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 서명자 FK
  • party_role — VARCHAR(20) — NOT NULL — CLIENT(갑) / FREELANCER(을)
  • status — VARCHAR(20) — NOT NULL — PENDING / SIGNED / REJECTED
  • verification_method — VARCHAR(30) — EMAIL / PHONE / CERT(인증서). 증거력 수준 기록
  • signed_at — DATETIME — 서명 시각
  • ip_address — VARCHAR(45) — 서명 시점 IP
  • user_agent — VARCHAR(500) — 서명 시점 User-Agent
  • timestamp_token — TEXT — 타임스탬프 토큰(제3자 시각 보증)
  • signature_file_id — BIGINT — Foreign key → file.id — 서명 이미지 FK(자체 구현 시)
  • provider_signer_id — VARCHAR(255) — 외부 서명 서비스 참여자 ID
  • reject_reason — VARCHAR(255) — 서명 거절 사유
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

deliverable

  • id — BIGINT — Primary key — NOT NULL — PK
  • contract_id — BIGINT — Foreign key → contract.id — NOT NULL — 계약 FK
  • title — VARCHAR(200) — NOT NULL — 산출물명
  • description — TEXT — 설명
  • file_id — BIGINT — Foreign key → file.id — 산출물 파일 FK
  • submitted_at — DATETIME — NOT NULL — 제출 시각
  • status — VARCHAR(20) — NOT NULL — SUBMITTED / APPROVED / REJECTED
  • reviewed_at — DATETIME — 검수 시각
  • review_comment — TEXT — 검수 의견/보완 요청
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

email_verification

  • id — BIGINT — Primary key — NOT NULL — PK
  • email — VARCHAR(255) — NOT NULL — 대상 이메일
  • purpose — VARCHAR(30) — NOT NULL — SIGNUP / PASSWORD_RESET / UNLOCK / PROFILE_UPDATE
  • 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
  • updated_at — DATETIME — NOT NULL

file

  • id — BIGINT — Primary key — NOT NULL — PK
  • file_group — VARCHAR(30) — NOT NULL — PROFILE_IMAGE / COMPANY_LOGO / PORTFOLIO / PROJECT_DOC / DELIVERABLE / CONTRACT_PDF / SIGNATURE
  • 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
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME

freelancer_profile

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 계정 FK(1:1)
  • birth_date — DATE — NOT NULL — 생년월일(만 18세 이상, 연도 하드코딩 금지). 수정 불가
  • address — VARCHAR(255) — 주소(수정 가능)
  • profile_file_id — BIGINT — Foreign key → file.id — 프로필 사진 FK(5MB 이하)
  • ai_matching_agreed — TINYINT(1) — NOT NULL — AI 매칭 대상 포함 여부(본인 선택)
  • grade — VARCHAR(20) — NOT NULL — JUNIOR / SENIOR / MASTER
  • grade_checked_at — DATETIME — 최근 등급 산정 시각(월 1회 배치)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME

inquiry

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 문의자 FK
  • session_id — BIGINT — Foreign key → 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 — Foreign key → account.id — 답변 관리자 FK
  • answered_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

ledger_entry

  • id — BIGINT — Primary key — NOT NULL — PK
  • entry_no — VARCHAR(50) — NOT NULL — 거래 번호
  • virtual_account_id — BIGINT — Foreign key → virtual_account.id — NOT NULL — 가상 계좌 FK
  • direction — VARCHAR(10) — NOT NULL — CREDIT(입금·증가) / DEBIT(출금·차감)
  • entry_type — VARCHAR(30) — NOT NULL — CHARGE(충전) / SETTLEMENT(수수료) / PENALTY(위약금) / REROLL(유료 리롤) / REFUND(환불)
  • amount — DECIMAL(15, 0) — NOT NULL — 거래 금액(원)
  • balance_after — DECIMAL(15, 0) — NOT NULL — 거래 후 잔액(감사 추적용)
  • ref_type — VARCHAR(30) — SETTLEMENT / PENALTY / REROLL_PURCHASE
  • ref_id — BIGINT — 연관 리소스 ID
  • memo — VARCHAR(255) — 적요
  • status — VARCHAR(20) — NOT NULL — COMPLETED / FAILED(잔액 부족) / CANCELED
  • fail_reason — VARCHAR(255) — 실패 사유(잔액 부족 등)
  • created_at — DATETIME — NOT NULL

matching_candidate

  • id — BIGINT — Primary key — NOT NULL — PK
  • round_id — BIGINT — Foreign key → matching_round.id — NOT NULL — 매칭 회차 FK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK(중복 노출 차단 조회용)
  • freelancer_id — BIGINT — Foreign key → 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 — 추천 근거(후보 카드에 표시)
  • rank_no — INT — 최종 순위
  • is_exposed — TINYINT(1) — NOT NULL — 클라이언트 노출 여부
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

matching_request

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK
  • candidate_id — BIGINT — Foreign key → matching_candidate.id — NOT NULL — 후보 FK
  • freelancer_id — BIGINT — Foreign key → freelancer_profile.id — NOT NULL — freelancer_profile FK
  • status — VARCHAR(30) — NOT NULL — 인원별 상태: REQUEST_PENDING / REJECTED / ACCEPTED / NEGOTIATING / CONTRACT_PENDING / CONTRACTED / IN_PROGRESS / COMPLETION_…
  • requested_at — DATETIME — NOT NULL — 요청 발송 시각
  • expires_at — DATETIME — NOT NULL — 응답 기한(요청 +3일). 초과 시 자동 만료
  • responded_at — DATETIME — 응답 시각
  • reject_reason — VARCHAR(255) — 거절 사유
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

matching_round

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.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 — 리롤 비용(추천 1명당 10,000원)
  • expose_count — INT — NOT NULL — 노출 후보 수 = 해당 포지션 모집 인원(1:1, 등급 무관)
  • low_score_warned — TINYINT(1) — NOT NULL — 적합도 임계값 미달 경고 노출 여부
  • status — VARCHAR(20) — NOT NULL — RUNNING / COMPLETED / FAILED / EXHAUSTED(후보 소진)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

matching_snapshot

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.id — 포지션 FK
  • freelancer_id — BIGINT — Foreign key → freelancer_profile.id — freelancer_profile FK(프리랜서 스냅샷일 때)
  • snapshot_type — VARCHAR(20) — NOT NULL — PROJECT / POSITION / FREELANCER
  • snapshot_json — JSON — NOT NULL — 매칭 전환 시점 데이터 동결본. 이후 수정은 미반영
  • created_at — DATETIME — NOT NULL

negotiation

  • id — BIGINT — Primary key — NOT NULL — PK
  • request_id — BIGINT — Foreign key → matching_request.id — NOT NULL — 수락된 매칭 요청 FK(1:1)
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK
  • freelancer_id — BIGINT — Foreign key → freelancer_profile.id — NOT NULL — freelancer_profile 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) — 종료 사유
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

negotiation_approval

  • id — BIGINT — Primary key — NOT NULL — PK
  • negotiation_id — BIGINT — Foreign key → negotiation.id — NOT NULL — 협상 FK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 응답자 FK
  • party_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • approved — TINYINT(1) — NOT NULL — Y/N. 양측 Y여야 승인, 한 명이라도 N이면 포기 판정
  • responded_at — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL

negotiation_condition

  • id — BIGINT — Primary key — NOT NULL — PK
  • negotiation_id — BIGINT — Foreign key → negotiation.id — NOT NULL — 협상 FK
  • condition_type — VARCHAR(30) — NOT NULL — AMOUNT / PERIOD / START_DATE / WORK_STYLE / WORK_FORM / CAREER / 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

negotiation_message

  • id — BIGINT — Primary key — NOT NULL — PK
  • negotiation_id — BIGINT — Foreign key → negotiation.id — NOT NULL — 협상 FK
  • condition_id — BIGINT — Foreign key → 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 — Primary key — NOT NULL — PK
  • account_id — BIGINT — NOT NULL — 수신자 FK
  • type — VARCHAR(50) — NOT NULL — RECOMMEND_DONE / REQUEST_RECEIVED / REQUEST_ACCEPTED / REQUEST_REJECTED / NEGOTIATION_START / AI_PROPOSAL / NEGOTIATION…
  • title — VARCHAR(200) — NOT NULL — 알림 제목
  • content — VARCHAR(500) — 알림 내용
  • link_url — VARCHAR(500) — 클릭 시 이동 경로
  • ref_type — VARCHAR(30) — PROJECT / POSITION / NEGOTIATION / CONTRACT / SETTLEMENT
  • ref_id — BIGINT — 연관 리소스 ID
  • is_read — TINYINT(1) — NOT NULL — 읽음 여부
  • read_at — DATETIME — 읽은 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

payment_method

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 계정 FK
  • method_type — VARCHAR(20) — NOT NULL — CARD(수수료 결제) / BANK_ACCOUNT(용역비 수령)
  • card_number_enc — VARBINARY(255) — 카드번호 암호화(AES, KMS 키 관리). ※평문 저장 금지
  • 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 — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • contract_id — BIGINT — Foreign key → contract.id — 계약 FK. 모집 기간 초과 후 클라 파기는 계약 전이라 NULL
  • terminator_role — VARCHAR(20) — NOT NULL — 파기 주체 CLIENT / FREELANCER
  • payee_type — VARCHAR(20) — NOT NULL — 수령 대상 COUNTERPARTY(상대방) / PLATFORM(페어링)
  • worked_amount — DECIMAL(15, 0) — NOT NULL — 수행분 정산 기준 금액(계약 전 파기 시 0)
  • penalty_rate — DECIMAL(5, 2) — NOT NULL — 위약금율(%). 상대방 10 + 플랫폼 10
  • penalty_amount — DECIMAL(15, 0) — NOT NULL — 위약금 금액(원)
  • payer_account_id — BIGINT — Foreign key → account.id — NOT NULL — 위약금 지급자 FK
  • payee_account_id — BIGINT — Foreign key → account.id — 위약금 수령자 FK(플랫폼이면 NULL)
  • ledger_entry_id — BIGINT — Foreign key → ledger_entry.id — 원장 거래 FK
  • status — VARCHAR(20) — NOT NULL — PENDING / PAYABLE / PAID / OVERDUE
  • paid_at — DATETIME
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

position_embedding

  • id — BIGINT — Primary key — NOT NULL — PK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK(1:1)
  • model — VARCHAR(50) — NOT NULL — 임베딩 모델명
  • dimension — INT — NOT NULL — 벡터 차원 수
  • vector — JSON — NOT NULL — 벡터 값
  • source_text — TEXT — 임베딩 원본 텍스트
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

position_skill

  • id — BIGINT — Primary key — NOT NULL — PK
  • position_id — BIGINT — Foreign key → project_position.id — NOT NULL — 포지션 FK
  • skill_code — VARCHAR(50) — NOT NULL — 스킬 코드. Java enum Skill
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

project

  • id — BIGINT — Primary key — NOT NULL — PK
  • client_id — BIGINT — Foreign key → client_profile.id — NOT NULL — client_profile FK
  • title — VARCHAR(200) — NOT NULL — 프로젝트 이름
  • 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) — 현재 프로젝트 진행 상황(1500자)
  • main_task — VARCHAR(1500) — 주요 담당 업무(1500자)
  • detail_scope — VARCHAR(1500) — 세부 업무범위(1500자)
  • extra_note — VARCHAR(1500) — 기타 전달사항/우대사항(1500자)
  • status — VARCHAR(30) — NOT NULL — REGISTERED(등록완료) / RECRUITING(모집중) / NEGOTIATING(협상중) / CONTRACT_PENDING(계약대기) / IN_PROGRESS(진행중) / COMPLETION_PENDING(…
  • payment_status — VARCHAR(30) — NOT NULL — DEPOSIT_PENDING / DEPOSIT_PAID / SUCCESS_FEE_PENDING / SUCCESS_FEE_PAID / REFUND_PENDING / REFUNDED / PAYMENT_FAILED
  • total_headcount — INT — NOT NULL — 총 모집 인원(등록 후 증가 불가)
  • confirmed_headcount — INT — NOT NULL — 계약 확정 인원
  • recruit_started_at — DATETIME — 모집 시작(착수금 수수료 결제 완료 시각)
  • recruit_deadline — DATETIME — 모집 마감(기본 2주, 연장 반영)
  • extension_count — INT — NOT NULL — 모집 기간 연장 횟수(최대 2)
  • free_reroll_used — INT — NOT NULL — 무료 리롤 사용 횟수(최대 1)
  • paid_reroll_used — INT — NOT NULL — 유료 리롤 사용 횟수(최대 5)
  • partial_start_agreed — TINYINT(1) — NOT NULL — 확정 인원만으로 진행 선택 여부
  • notice_agreed_at — DATETIME — 등록 전 안내 동의 시각
  • canceled_at — DATETIME — 취소 시각
  • closed_at — DATETIME — 종료 시각
  • retention_until — DATE — 보존 만료일(종료 +5년)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL
  • deleted_at — DATETIME — 매칭 전 탈퇴/삭제 시 즉시 hard delete, 이후는 보존

project_file

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • file_id — BIGINT — Foreign key → file.id — NOT NULL — 파일 FK(100MB 이하, 최대 10개)
  • sort_order — INT — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

project_parse

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_id — BIGINT — Foreign key → project_position.id — 포지션 FK(포지션별 파싱)
  • raw_text — TEXT — NOT NULL — 파싱 입력 원문
  • parsed_json — JSON — 구조화 결과(직군/직무/스킬/경력/예산/기간/근무방식/근무형태)
  • status — VARCHAR(20) — NOT NULL — PENDING / SUCCESS / FAILED
  • fail_reason — VARCHAR(255) — 실패 사유(필수 조건 누락 등)
  • preview_count — INT — 사전 안내용 매칭 가능 프리랜서 수
  • confirmed_at — DATETIME — 클라이언트 확인·수정 완료 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

project_position

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • position_no — INT — NOT NULL — 포지션 번호(1부터)
  • job_category — VARCHAR(30) — NOT NULL — 직군 코드(DEVELOPMENT / DESIGN). Java enum JobCategory
  • job_role — VARCHAR(40) — NOT NULL — 직무 코드 26종. Java enum JobRole
  • min_career_years — INT — NOT NULL — 희망 연차(최소 1)
  • headcount — INT — NOT NULL — 해당 포지션 모집 인원(최소 1)
  • confirmed_count — INT — NOT NULL — 확정 인원
  • status — VARCHAR(30) — NOT NULL — RECRUITING / FILLED(정원 충족, 매칭 종료) / CLOSED(잔여 모집 종료)
  • closed_at — DATETIME — 모집 종료 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

reroll_purchase

  • id — BIGINT — Primary key — NOT NULL — PK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • round_id — BIGINT — Foreign key → matching_round.id — NOT NULL — 매칭 회차 FK
  • ledger_entry_id — BIGINT — Foreign key → ledger_entry.id — 원장 거래 FK
  • unit_price — DECIMAL(15, 0) — NOT NULL — 추천 1명당 단가(원)
  • quantity — INT — NOT NULL — 추천 요청 인원 수
  • amount — DECIMAL(15, 0) — NOT NULL — 총 결제 금액
  • status — VARCHAR(20) — NOT NULL — PENDING / PAID / FAILED / REFUNDED
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume

  • id — BIGINT — Primary key — NOT NULL — PK
  • freelancer_id — BIGINT — Foreign key → freelancer_profile.id — NOT NULL — freelancer_profile FK(1:1)
  • job_category — VARCHAR(30) — NOT NULL — 직군 코드(DEVELOPMENT / DESIGN). Java enum JobCategory
  • job_role — VARCHAR(40) — NOT NULL — 직무 코드 26종(BACKEND_DEV / UX_UI_DESIGNER ...). Java enum JobRole
  • 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 — Foreign key → file.id — 포트폴리오 PDF FK(20MB 권장)
  • status — VARCHAR(20) — NOT NULL — DRAFT(임시저장) / COMPLETED
  • completed_at — DATETIME — 등록 완료 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_career

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_certificate

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_education

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_embedding

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → resume.id — NOT NULL — 이력서 FK(1:1)
  • 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
  • updated_at — DATETIME — NOT NULL

resume_link

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → resume.id — NOT NULL — 이력서 FK
  • link_type — VARCHAR(30) — NOT NULL — GITHUB / PORTFOLIO / NOTION / LINKEDIN / ETC
  • url — VARCHAR(500) — NOT NULL — URL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

resume_skill

  • id — BIGINT — Primary key — NOT NULL — PK
  • resume_id — BIGINT — Foreign key → resume.id — NOT NULL — 이력서 FK
  • skill_code — VARCHAR(50) — NOT NULL — 스킬 코드(REACT / SPRING_BOOT ...). Java enum Skill
  • skill_level — VARCHAR(20) — NOT NULL — BEGINNER(초급) / INTERMEDIATE(중급) / ADVANCED(고급)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

review

  • id — BIGINT — Primary key — NOT NULL — PK
  • contract_id — BIGINT — Foreign key → contract.id — NOT NULL — 계약 FK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK(조회 편의)
  • reviewer_id — BIGINT — Foreign key → account.id — NOT NULL — 작성자 FK
  • reviewee_id — BIGINT — Foreign key → account.id — NOT NULL — 대상자 FK
  • rating — TINYINT — NOT NULL — 별점 1~5(1점 단위, 필수)
  • content — VARCHAR(500) — 리뷰(선택, 500자 이하)
  • created_at — DATETIME — NOT NULL — 작성 후 수정·삭제 불가. 탈퇴해도 삭제 안 함

settlement

  • id — BIGINT — Primary key — NOT NULL — PK
  • settlement_no — VARCHAR(50) — NOT NULL — 정산 번호(관리자 검색용)
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • contract_id — BIGINT — Foreign key → contract.id — 계약 FK(클라 착수금은 계약 전이라 NULL 가능)
  • payer_account_id — BIGINT — Foreign key → account.id — NOT NULL — 수수료 납부자 FK
  • payer_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • phase — VARCHAR(20) — NOT NULL — DEPOSIT(착수금) / SUCCESS_FEE(성공보수)
  • base_amount — DECIMAL(15, 0) — NOT NULL — 수수료 산정 기준 금액
  • fee_rate — DECIMAL(5, 2) — NOT NULL — 적용 요율(%). 등급 인하 반영 후
  • grade_discount — DECIMAL(5, 2) — NOT NULL — 등급 인하율(%)
  • fee_amount — DECIMAL(15, 0) — NOT NULL — 수수료 금액(원)
  • ledger_entry_id — BIGINT — Foreign key → ledger_entry.id — 원장 거래 FK
  • status — VARCHAR(30) — NOT NULL — PENDING(버튼 비활성) / PAYABLE(활성) / PAID / OVERDUE(미납) / FAILED / REFUNDED
  • due_date — DATE — 납부 기한(미납 시 탈퇴 제한)
  • paid_at — DATETIME — 결제 완료 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

site_review

  • id — BIGINT — Primary key — NOT NULL — PK
  • contract_id — BIGINT — Foreign key → contract.id — NOT NULL — 계약 FK
  • project_id — BIGINT — Foreign key → project.id — NOT NULL — 프로젝트 FK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 작성자 FK
  • writer_role — VARCHAR(20) — NOT NULL — CLIENT / FREELANCER
  • rating — TINYINT — NOT NULL — 별점 1~5(필수)
  • content — VARCHAR(500) — 이용후기(선택, 500자 이하)
  • is_public — TINYINT(1) — NOT NULL — 공개 여부. 기본 비공개, 관리자가 설정
  • is_promoted — TINYINT(1) — NOT NULL — 메인·홍보 활용 여부(가입 시 동의)
  • managed_by — BIGINT — Foreign key → account.id — 공개 설정 관리자 FK
  • managed_at — DATETIME — 공개 설정 시각
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

social_account

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

terms

  • id — BIGINT — Primary key — NOT NULL — PK
  • code — VARCHAR(50) — NOT NULL — SERVICE_CLIENT / SERVICE_FREELANCER / PRIVACY / REVIEW_EXPOSURE / FEE_NOTICE / 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
  • updated_at — DATETIME — NOT NULL

terms_agreement

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 계정 FK
  • terms_id — BIGINT — Foreign key → 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
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

virtual_account

  • id — BIGINT — Primary key — NOT NULL — PK
  • account_id — BIGINT — Foreign key → account.id — NOT NULL — 계정 FK(1:1)
  • balance — DECIMAL(15, 0) — NOT NULL — 현재 잔액(원). 실제 PG 미연동, 값 증감만 처리
  • total_charged — DECIMAL(15, 0) — NOT NULL — 누적 충전액
  • total_withdrawn — DECIMAL(15, 0) — NOT NULL — 누적 차감액
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL