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