초안
테이블 (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