Zip-da-project-property-v2

Tables (31)

apartment_complex

  • apartment_complex_id — BIGINT — Primary key — NOT NULL — 단지 ID
  • region_id — BIGINT — Foreign key → region.region_id — NOT NULL — 단지가 위치한 법정동
  • complex_name — VARCHAR(200) — NOT NULL — 단지명 검색·상세 표시
  • road_address — VARCHAR(300) — 단지 도로명 주소
  • jibun_address — VARCHAR(300) — 단지 지번 주소
  • center_location — POINT — NOT NULL — 단지 대표 위치
  • total_buildings — INT — 총 동 수
  • total_households — INT — 총 세대 수
  • total_parking_spaces — INT — 단지 전체 주차대수
  • approval_date — DATE — 단지 사용승인일
  • source_name — VARCHAR(100) — 데이터 출처
  • source_updated_at — DATETIME(6) — 출처 기준 갱신 시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

apartment_complex_facility

  • complex_facility_id — BIGINT — Primary key — NOT NULL — 단지 시설 연결 ID
  • apartment_complex_id — BIGINT — Foreign key → apartment_complex.apartment_complex_id — NOT NULL — 대상 단지
  • facility_code — VARCHAR(50) — NOT NULL — GYM, PLAYGROUND, SECURITY, COMMUNITY_CENTER 등
  • facility_name — VARCHAR(100) — NOT NULL — 화면 표시명
  • description — VARCHAR(500) — 시설 보충 설명
  • is_verified — BOOLEAN — NOT NULL — 출처 검증 완료 여부
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property

  • property_id — BIGINT — Primary key — NOT NULL — 매물 ID. 모든 매물 API의 기준
  • region_id — BIGINT — Foreign key → region.region_id — NOT NULL — 법정동 지역
  • apartment_complex_id — BIGINT — Foreign key → apartment_complex.apartment_complex_id — 아파트일 때 연결. 다른 유형은 NULL
  • author_member_id — BIGINT — NOT NULL — 최초 작성 Member. 교차 FK 없음
  • publisher_type — VARCHAR(30) — NOT NULL — DIRECT_OWNER, DIRECT_TENANT, AGENT_BROKERAGE
  • property_type — VARCHAR(30) — NOT NULL — APARTMENT, OFFICETEL, VILLA, ROOM
  • transaction_type — VARCHAR(30) — NOT NULL — SALE, JEONSE, MONTHLY_RENT,
  • sale_price — BIGINT — 매매가 원 단위. SALE일 때 필수
  • deposit — BIGINT — 보증금 원 단위. JEONSE·월세에서 사용
  • monthly_rent — BIGINT — 월세 원 단위. 월세에서 사용
  • maintenance_fee — BIGINT — 월 관리비 원 단위
  • supply_area — DECIMAL(10, 2) — 공급면적 ㎡
  • exclusive_area — DECIMAL(10, 2) — NOT NULL — 전용면적 ㎡
  • room_count — TINYINT — 방 수. ROOM 화면 분류에 사용
  • bathroom_count — TINYINT — 욕실 수
  • floor — SMALLINT — 해당 층. 지하는 음수 정책 또는 별도 floor_type 사용
  • total_floor — SMALLINT — 건물 전체 층수
  • floor_condition — VARCHAR(30) — LOW, MIDDLE, HIGH, TOP, BASEMENT 등 파생 검색값
  • direction — VARCHAR(20) — 주실 기준 방향
  • approval_date — DATE — 사용승인일. 신축 필터에 사용
  • building_use — VARCHAR(100) — 건축물 용도
  • parking_status — VARCHAR(30) — NOT NULL — AVAILABLE, UNAVAILABLE, UNKNOWN
  • elevator_status — VARCHAR(30) — NOT NULL — 엘리베이터 여부
  • pet_policy — VARCHAR(30) — NOT NULL — ALLOWED, NEGOTIABLE, NOT_ALLOWED, UNKNOWN
  • move_in_status — VARCHAR(30) — NOT NULL — IMMEDIATE, DATE_SPECIFIED, NEGOTIABLE
  • available_move_in_date — DATE — 입주 지정일. 상태가 DATE_SPECIFIED면 필요
  • jeonse_loan_available — VARCHAR(30) — NOT NULL — AVAILABLE, UNAVAILABLE, UNKNOWN
  • title — VARCHAR(200) — 카드·상세 제목. 서버 금칙어·길이 검증
  • description — TEXT — NOT NULL — 매물 설명. HTML 원문 저장 금지, XSS 방지
  • publication_status — VARCHAR(30) — NOT NULL — 공개 상태: 초안·검수·공개·숨김·반려
  • transaction_status — VARCHAR(30) — NOT NULL — 거래 상태: 가능·예약·완료
  • verification_status — VARCHAR(30) — NOT NULL — 인증 상태. 다른 두 상태와 섞지 않음
  • risk_score — DECIMAL(5, 2) — 중복·허위 위험 점수. 공개 DTO 미노출
  • published_at — DATETIME(6) — 실제 공개 시작 시각. 최신순 기준 후보
  • version — BIGINT — NOT NULL — 낙관적 잠금 버전
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_address

  • property_address_id — BIGINT — Primary key — NOT NULL — 주소 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 매물 1:1
  • legal_dong_code — CHAR(10) — NOT NULL — Kakao 응답과 내부 Region 검증
  • exact_road_address — VARCHAR(300) — 정확 도로명 주소. 권한 API만 사용
  • exact_jibun_address — VARCHAR(300) — 정확 지번 주소
  • detail_address_encrypted — VARBINARY(1000) — 동·호 등 상세주소 암호문. 평문 로그 금지
  • exact_location — POINT — NOT NULL — 정확 좌표. 공개 DTO 금지
  • public_address — VARCHAR(300) — NOT NULL — 공개 가능한 동 수준 주소
  • public_location — POINT — NOT NULL — 지도 공개용 비식별 좌표
  • disclosure_level — VARCHAR(30) — NOT NULL — DONG, APPROXIMATE, COMPLEX_CENTER 등
  • location_verified_at — DATETIME(6) — NOT NULL — 좌표·법정동·Region 검증 완료 시각
  • location_source — VARCHAR(30) — NOT NULL — KAKAO_LOCAL, ADMIN, BATCH
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_audit_event

  • audit_event_id — BIGINT — Primary key — NOT NULL — 감사사건 ID
  • target_type — VARCHAR(50) — NOT NULL — PROPERTY, REPORT, EXACT_LOCATION 등
  • target_id — VARCHAR(100) — NOT NULL — 대상 ID
  • action_code — VARCHAR(100) — NOT NULL — VIEW_EXACT_LOCATION, ADMIN_REPORT_VIEW 등
  • actor_member_id — BIGINT — 행위자
  • actor_role — VARCHAR(30) — 당시 역할
  • action_source — VARCHAR(20) — NOT NULL — MEMBER/SYSTEM/BATCH
  • reason — VARCHAR(1000) — 민감조회 감사 사유
  • trace_id — VARCHAR(100) — NOT NULL — 요청 로그 연결
  • client_ip_hash — CHAR(64) — 필요 시 원 IP 대신 정책상 hash
  • occurred_at — DATETIME(6) — NOT NULL — 사건 시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유

property_favorite

  • favorite_id — BIGINT — Primary key — NOT NULL — 찜 ID
  • member_id — BIGINT — NOT NULL — 찜한 회원
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 찜한 매물
  • active_favorite_key — VARCHAR(150) — 활성 행일 때 memberId:propertyId, 삭제행이면 NULL
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_file

  • property_file_id — BIGINT — Primary key — NOT NULL — API에서 사용하는 fileId
  • upload_session_id — VARCHAR(100) — NOT NULL — 업로드 세션 식별자
  • owner_member_id — BIGINT — NOT NULL — 파일 업로드 사용자. 연결 전 소유권 확인
  • object_key — VARCHAR(500) — NOT NULL — MinIO 내부 객체 키. 외부 DTO 노출 금지
  • original_file_name — VARCHAR(255) — NOT NULL — 사용자 파일명. 경로 제거·길이 제한
  • mime_type — VARCHAR(100) — NOT NULL — 서버 검증된 MIME
  • file_size — BIGINT — NOT NULL — 바이트 크기
  • checksum_sha256 — CHAR(64) — NOT NULL — 업로드 완료 무결성 검사
  • file_purpose — VARCHAR(30) — NOT NULL — PROPERTY_IMAGE, VERIFICATION, REPORT_EVIDENCE
  • upload_status — VARCHAR(30) — NOT NULL — CREATED, UPLOADED, VERIFIED, LINKED, EXPIRED, FAILED
  • expires_at — DATETIME(6) — 미연결 세션 만료시각
  • linked_at — DATETIME(6) — 업무 데이터에 연결된 시각
  • object_deleted_at — DATETIME(6) — MinIO 물리삭제 완료시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_idempotency

  • idempotency_id — BIGINT — Primary key — NOT NULL — 내부 ID
  • member_id — BIGINT — NOT NULL — 요청한 사용자
  • endpoint_key — VARCHAR(200) — NOT NULL — 예: POST:/api/properties
  • idempotency_key — VARCHAR(100) — NOT NULL — 클라이언트 헤더값
  • request_hash — CHAR(64) — NOT NULL — 정규화 요청본문 hash
  • processing_status — VARCHAR(20) — NOT NULL — PROCESSING, COMPLETED, FAILED
  • resource_type — VARCHAR(50) — PROPERTY, REPORT 등
  • resource_id — BIGINT — 생성된 업무 ID
  • response_status — SMALLINT — 재현할 HTTP 상태
  • response_body_json — JSON — 필요한 최소 응답. 민감정보 금지
  • expires_at — DATETIME(6) — NOT NULL — 키 보존 만료시각
  • created_at — DATETIME(6) — NOT NULL — 처리 추적
  • updated_at — DATETIME(6) — NOT NULL — 처리 추적
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_image

  • property_image_id — BIGINT — Primary key — NOT NULL — 매물 이미지 연결 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • property_file_id — BIGINT — Foreign key → property_file.property_file_id — NOT NULL — 연결할 검증 완료 파일
  • sort_order — INT — NOT NULL — 이미지 표시 순서, 0부터 시작
  • is_representative — BOOLEAN — NOT NULL — 대표 이미지 여부. 활성 1개만 허용
  • alt_text — VARCHAR(300) — 접근성 대체텍스트
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_option

  • property_option_id — BIGINT — Primary key — NOT NULL — 옵션 연결 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • option_code_id — BIGINT — Foreign key → property_option_code.option_code_id — NOT NULL — property_option_code 기준 ID
  • boolean_value — BOOLEAN — BOOLEAN 옵션 값
  • number_value — DECIMAL(12, 2) — NUMBER 옵션 값
  • text_value — VARCHAR(300) — TEXT·SINGLE_SELECT 값
  • display_order — INT — NOT NULL — 상세 화면 표시 순서
  • verified — BOOLEAN — NOT NULL — 증빙·관리자 확인 여부
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_option_code

  • option_code_id — BIGINT — Primary key — NOT NULL — 내부 옵션 기준 ID
  • option_code — VARCHAR(50) — NOT NULL — API·DB에서 사용하는 영문 코드
  • option_name — VARCHAR(100) — NOT NULL — 사용자 화면 한글 표시명
  • option_category — VARCHAR(30) — NOT NULL — APPLIANCE, FURNITURE, SECURITY, STRUCTURE, LIVING, ETC
  • value_type — VARCHAR(20) — NOT NULL — BOOLEAN, NUMBER, TEXT, SINGLE_SELECT
  • unit — VARCHAR(20) — 대, 개 등 숫자 값의 단위
  • allowed_values_json — JSON — SINGLE_SELECT 허용값. 서버가 검증한 배열만 저장
  • description — VARCHAR(500) — 등록자와 개발자를 위한 정의
  • is_filterable — BOOLEAN — NOT NULL — 검색 필터 제공 여부. 핵심 정형필드와 중복 필터 금지
  • is_detail_visible — BOOLEAN — NOT NULL — 매물 상세 노출 여부
  • is_registration_enabled — BOOLEAN — NOT NULL — 등록·수정 화면 선택 가능 여부
  • display_order — INT — NOT NULL — 카테고리 내부 표시 순서
  • is_active — BOOLEAN — NOT NULL — 신규 사용 가능 여부
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_outbox

  • event_id — VARCHAR(100) — Primary key — NOT NULL — 전역 이벤트 ID, 소비자 멱등키
  • aggregate_type — VARCHAR(50) — NOT NULL — PROPERTY, REPORT 등
  • aggregate_id — BIGINT — NOT NULL — 대상 업무 ID
  • event_type — VARCHAR(100) — NOT NULL — PROPERTY_CREATED, PROPERTY_UPDATED 등
  • payload_json — JSON — NOT NULL — 이벤트 계약 데이터. 정확주소·증빙 원문 제외
  • schema_version — INT — NOT NULL — 이벤트 구조 버전
  • status — VARCHAR(20) — NOT NULL — PENDING, PUBLISHED, FAILED, ARCHIVED
  • retry_count — INT — NOT NULL — 재시도 횟수
  • next_retry_at — DATETIME(6) — 다음 발행 예정시각
  • published_at — DATETIME(6) — 발행 성공시각
  • last_error_code — VARCHAR(100) — 마지막 실패 분류
  • trace_id — VARCHAR(100) — NOT NULL — 원 요청 추적
  • created_at — DATETIME(6) — NOT NULL — 로컬 트랜잭션 저장시각
  • archived_at — DATETIME(6) — 보존 전환시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_publisher_snapshot

  • publisher_snapshot_id — BIGINT — Primary key — NOT NULL — 스냅샷 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 매물 1:1 현재 광고 스냅샷
  • publisher_type — VARCHAR(30) — NOT NULL — 등록주체 유형
  • publisher_member_id — BIGINT — NOT NULL — 등록 Member 외부 ID
  • agent_id — BIGINT — Member가 제공한 중개사 ID 외부 참조
  • agency_id — BIGINT — Member가 제공한 사무소 ID 외부 참조
  • office_name — VARCHAR(200) — 중개사무소 명칭 스냅샷
  • office_address — VARCHAR(300) — 법정 광고 주소
  • office_contact — VARCHAR(50) — 중개매물 전화연결용 번호
  • registration_number — VARCHAR(100) — 중개사무소 등록번호
  • broker_name — VARCHAR(100) — 개업공인중개사 이름
  • snapshot_json — JSON — 계약 확장용 정규화 스냅샷. 민감필드 제한
  • captured_at — DATETIME(6) — NOT NULL — Member 권한·광고정보를 확인한 시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_report

  • report_id — BIGINT — Primary key — NOT NULL — 신고 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 신고 대상 매물
  • reporter_member_id — BIGINT — NOT NULL — 신고자 외부 ID
  • reason_code — VARCHAR(50) — NOT NULL — FALSE_INFO, DUPLICATE 등
  • detail — TEXT — NOT NULL — 신고 상세. 민감정보 접근 제한
  • status — VARCHAR(30) — NOT NULL — RECEIVED, TRIAGED, IN_REVIEW, ACTIONED, REJECTED, CLOSED
  • risk_score — DECIMAL(5, 2) — 운영 우선순위 계산
  • assigned_admin_id — BIGINT — 담당 관리자 외부 ID
  • triaged_at — DATETIME(6) — 분류 시각
  • closed_at — DATETIME(6) — 종료 시각
  • version — BIGINT — NOT NULL — 동시 검수 충돌 방지
  • active_report_key — VARCHAR(250) — 신고자+매물+사유 활성 UNIQUE
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_report_action

  • report_action_id — BIGINT — Primary key — NOT NULL — 운영조치 ID
  • report_id — BIGINT — Foreign key → property_report.report_id — NOT NULL — 신고 사건
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • action_code — VARCHAR(50) — NOT NULL — HIDE_PROPERTY, RESTORE_PROPERTY, REQUEST_MEMBER_SANCTION 등
  • before_publication_status — VARCHAR(30) — 조치 전 공개상태
  • after_publication_status — VARCHAR(30) — 조치 후 공개상태
  • actor_member_id — BIGINT — NOT NULL — 처리 관리자 외부 ID
  • actor_role — VARCHAR(30) — NOT NULL — CS_ADMIN/SUPER_ADMIN
  • reason — VARCHAR(1000) — NOT NULL — 법적·운영 근거
  • member_sanction_request_id — VARCHAR(100) — Member 서비스 제재요청 추적 ID
  • trace_id — VARCHAR(100) — NOT NULL — 로그 연결
  • acted_at — DATETIME(6) — NOT NULL — 조치 시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_report_appeal

  • appeal_id — BIGINT — Primary key — NOT NULL — 이의 ID
  • report_id — BIGINT — Foreign key → property_report.report_id — NOT NULL — 원 신고
  • appellant_member_id — BIGINT — NOT NULL — 이의 신청자
  • detail — TEXT — NOT NULL — 이의 내용
  • status — VARCHAR(30) — NOT NULL — SUBMITTED, IN_REVIEW, ACCEPTED, REJECTED
  • reviewer_member_id — BIGINT — 재검토 관리자. 최초 처리자와 달라야 함
  • review_reason — VARCHAR(1000) — 재검토 결과 사유
  • reviewed_at — DATETIME(6) — 검토 완료시각
  • version — BIGINT — NOT NULL — 동시성 제어
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_report_evidence

  • report_evidence_id — BIGINT — Primary key — NOT NULL — 증빙 연결 ID
  • report_id — BIGINT — Foreign key → property_report.report_id — NOT NULL — 신고
  • property_file_id — BIGINT — Foreign key → property_file.property_file_id — NOT NULL — MinIO 파일 메타데이터
  • evidence_type — VARCHAR(50) — NOT NULL — SCREENSHOT, DOCUMENT 등
  • sort_order — INT — NOT NULL — 표시 순서
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_saved_search

  • saved_search_id — BIGINT — Primary key — NOT NULL — 저장검색 ID
  • member_id — BIGINT — NOT NULL — 소유 Member 외부 ID
  • name — VARCHAR(30) — NOT NULL — 사용자 지정명, trim 후 1~30자
  • normalized_condition_json — JSON — NOT NULL — 서버가 허용한 정규화 검색조건
  • condition_hash — CHAR(64) — NOT NULL — 조건 중복 비교·멱등성
  • schema_version — INT — NOT NULL — JSON 구조 버전
  • sort_condition — VARCHAR(30) — LATEST, PRICE_ASC 등
  • view_mode — VARCHAR(20) — MAP 또는 LIST
  • is_default — BOOLEAN — NOT NULL — 기본 검색 여부
  • version — BIGINT — NOT NULL — 낙관적 잠금
  • active_name_key — VARCHAR(200) — 활성 사용자+이름 UNIQUE
  • active_default_key — VARCHAR(100) — 기본이면 memberId, 아니면 NULL. 사용자당 기본 1개
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_search_history

  • search_history_id — BIGINT — Primary key — NOT NULL — 최근 검색 ID
  • member_id — BIGINT — NOT NULL — 로그인 회원. 비로그인은 저장하지 않음
  • keyword_summary — VARCHAR(200) — 화면용 검색 요약. 민감 원문 최소화
  • region_id — BIGINT — Foreign key → region.region_id — 검색 지역
  • normalized_condition_json — JSON — NOT NULL — 검색 복원 조건
  • condition_hash — CHAR(64) — NOT NULL — 10분 중복 억제 비교
  • sort_condition — VARCHAR(30) — 검색 정렬
  • center_location — POINT — 일반 탐색 지도 중심. 정확 현 위치 저장 금지
  • min_lat — DECIMAL(10, 7) — 검색 당시 bounds 위도
  • max_lat — DECIMAL(10, 7) — 검색 당시 bounds 위도
  • min_lng — DECIMAL(10, 7) — 검색 당시 bounds 경도
  • max_lng — DECIMAL(10, 7) — 검색 당시 bounds 경도
  • zoom_level — TINYINT — Kakao 1~14
  • result_count — INT — 검색 당시 결과 수
  • searched_at — DATETIME(6) — NOT NULL — 실제 검색 실행시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_search_preference

  • preference_id — BIGINT — Primary key — NOT NULL — 검색환경 ID
  • member_id — BIGINT — NOT NULL — 소유 회원 외부 ID
  • last_region_id — BIGINT — Foreign key → region.region_id — NOT NULL — 마지막 선택 지역
  • normalized_filter_state_json — JSON — NOT NULL — 마지막 필터
  • sort_condition — VARCHAR(30) — 마지막 정렬
  • view_mode — VARCHAR(20) — MAP/LIST
  • center_location — POINT — 일반 탐색 중심. Geolocation 정확좌표 금지
  • min_lat — DECIMAL(10, 7) — 마지막 viewport
  • max_lat — DECIMAL(10, 7) — 마지막 viewport
  • min_lng — DECIMAL(10, 7) — 마지막 viewport
  • max_lng — DECIMAL(10, 7) — 마지막 viewport
  • zoom_level — TINYINT — Kakao 1~14
  • last_searched_at — DATETIME(6) — 마지막 실제 검색시각
  • schema_version — INT — NOT NULL — 필터 JSON 버전
  • version — BIGINT — NOT NULL — 낙관적 잠금
  • active_member_key — BIGINT — 활성일 때 memberId, 삭제면 NULL; UNIQUE
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_status_history

  • property_status_history_id — BIGINT — Primary key — NOT NULL — 이력 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • status_type — VARCHAR(30) — NOT NULL — PUBLICATION, TRANSACTION, VERIFICATION
  • before_status — VARCHAR(30) — 최초 생성이면 NULL 가능
  • after_status — VARCHAR(30) — NOT NULL — 변경 후 상태
  • actor_member_id — BIGINT — Member 외부 ID
  • actor_role — VARCHAR(30) — 당시 역할
  • action_source — VARCHAR(20) — NOT NULL — MEMBER/SYSTEM/BATCH
  • reason_code — VARCHAR(50) — 표준 사유 코드
  • reason — VARCHAR(1000) — 상세 사유
  • property_version — BIGINT — NOT NULL — 상태변경 직후 매물 version
  • trace_id — VARCHAR(100) — NOT NULL — API 로그 추적
  • occurred_at — DATETIME(6) — NOT NULL — 사건 발생시각
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유

property_subway_access

  • property_subway_access_id — BIGINT — Primary key — NOT NULL — 파생정보 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • subway_station_id — BIGINT — Foreign key → subway_station.subway_station_id — NOT NULL — 최근접 역
  • distance_meters — INT — NOT NULL — 매물 기준점과 역 사이 직선거리 m
  • estimated_walking_minutes — SMALLINT — NOT NULL — CEIL(distance_meters / 80) 기본값
  • calculation_location_type — VARCHAR(30) — NOT NULL — EXACT, PUBLIC, COMPLEX_CENTER 중 어떤 좌표로 계산했는지
  • calculated_at — DATETIME(6) — NOT NULL — 계산 시각
  • source_date — DATE — NOT NULL — 역 기준정보 날짜
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_type_option

  • property_type_option_id — BIGINT — Primary key — NOT NULL — 유형-옵션 정책 ID
  • property_type — VARCHAR(30) — NOT NULL — APARTMENT, OFFICETEL, VILLA, ROOM
  • option_code_id — BIGINT — Foreign key → property_option_code.option_code_id — NOT NULL — 허용할 옵션 기준
  • is_required — BOOLEAN — NOT NULL — 해당 유형 등록 시 필수 여부
  • default_boolean_value — BOOLEAN — BOOLEAN 옵션의 기본값. 미확인과 false를 구분할 때 NULL
  • display_order — INT — NOT NULL — 유형별 등록 화면 순서
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_verification

  • property_verification_id — BIGINT — Primary key — NOT NULL — 인증 신청 ID
  • property_id — BIGINT — Foreign key → property.property_id — NOT NULL — 대상 매물
  • verification_type — VARCHAR(30) — NOT NULL — OWNER, TENANT, AGENT_BROKERAGE
  • applicant_member_id — BIGINT — NOT NULL — 신청자 외부 ID
  • status — VARCHAR(30) — NOT NULL — SUBMITTED, IN_REVIEW, VERIFIED, REJECTED, EXPIRED
  • submitted_at — DATETIME(6) — NOT NULL — 신청시각
  • reviewer_member_id — BIGINT — 검수 관리자 외부 ID
  • reviewer_role — VARCHAR(30) — 검수 당시 역할
  • reviewed_at — DATETIME(6) — 검수완료 시각
  • verified_at — DATETIME(6) — 인증 성공 시각
  • expires_at — DATETIME(6) — 인증 만료시각
  • result_code — VARCHAR(50) — 성공·실패 표준코드
  • result_reason — VARCHAR(1000) — 반려·실패 상세사유
  • verification_version — INT — NOT NULL — 재인증 회차
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

property_verification_evidence

  • verification_evidence_id — BIGINT — Primary key — NOT NULL — 인증-파일 연결 ID
  • property_verification_id — BIGINT — Foreign key → property_verification.property_verification_id — NOT NULL — 인증 신청
  • property_file_id — BIGINT — Foreign key → property_file.property_file_id — NOT NULL — 증빙 파일 메타데이터
  • evidence_type — VARCHAR(50) — NOT NULL — 등기·계약서 등 증빙 종류
  • retention_until — DATETIME(6) — 보존 종료 예정시각
  • destroyed_at — DATETIME(6) — MinIO 객체 파기 완료시각
  • sort_order — INT — NOT NULL — 증빙 순서
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

region

  • region_id — BIGINT — Primary key — NOT NULL — 내부 지역 ID. API의 regionId
  • parent_region_id — BIGINT — Foreign key → region.region_id — 상위 지역. 시·도는 NULL, 강남구는 서울특별시 ID
  • region_code — CHAR(10) — NOT NULL — 법정동 10자리 코드. 외부 데이터 매칭 기준
  • region_name — VARCHAR(100) — NOT NULL — 현재 단계 표시명 예: 강남구
  • full_region_name — VARCHAR(300) — NOT NULL — 전체 경로 예: 서울특별시 강남구 역삼동
  • region_level — TINYINT — NOT NULL — 1=시도, 2=시군구, 3=읍면동. 정렬·검증에 사용
  • region_type — VARCHAR(30) — NOT NULL — SIDO, SIGUNGU, EUPMYEONDONG
  • center_location — POINT — 대표 중심점. POINT(경도 위도) 순서
  • has_children — BOOLEAN — NOT NULL — 활성 직계 하위 지역 존재 여부. 프런트의 다음 단계 화살표 표시
  • is_active — BOOLEAN — NOT NULL — 폐지·비활성 지역을 신규 선택 목록에서 제외
  • effective_from — DATE — 행정구역 효력 시작일
  • effective_to — DATE — 종료일. 현재 유효하면 NULL
  • replacement_region_id — BIGINT — Foreign key → region.region_id — 폐지 지역을 대체하는 지역. 기존 참조 복원 안내에 사용
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

region_boundary

  • region_boundary_id — BIGINT — Primary key — NOT NULL — 경계 데이터 ID
  • region_id — BIGINT — Foreign key → region.region_id — NOT NULL — 어떤 지역의 경계인지 연결
  • geometry_type — VARCHAR(20) — NOT NULL — POLYGON 또는 MULTIPOLYGON
  • boundary_geometry — MULTIPOLYGON — NOT NULL — 실제 행정구역 경계. Polygon도 MultiPolygon으로 통일 저장 가능
  • south_west_latitude — DECIMAL(10, 7) — NOT NULL — bounds 남서쪽 위도
  • south_west_longitude — DECIMAL(10, 7) — NOT NULL — bounds 남서쪽 경도
  • north_east_latitude — DECIMAL(10, 7) — NOT NULL — bounds 북동쪽 위도
  • north_east_longitude — DECIMAL(10, 7) — NOT NULL — bounds 북동쪽 경도
  • source_name — VARCHAR(100) — NOT NULL — 경계 원본 제공기관
  • source_version — VARCHAR(50) — NOT NULL — 원본 기준 버전·일자
  • checksum — CHAR(64) — NOT NULL — 원본 또는 정규화 geometry SHA-256. 중복·변경 확인
  • simplification_level — TINYINT — NOT NULL — 지도 성능용 단순화 단계. 0은 원본
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

region_import_batch

  • region_import_batch_id — BIGINT — Primary key — NOT NULL — 적재 배치 ID
  • batch_version — VARCHAR(100) — NOT NULL — UNIQUE, 재처리 단위
  • source_name — VARCHAR(100) — NOT NULL — 원본 기관·파일
  • source_date — DATE — NOT NULL — 원본 기준일
  • source_checksum — CHAR(64) — NOT NULL — 원본 무결성
  • import_status — VARCHAR(30) — NOT NULL — CREATED, VALIDATING, VALIDATED, APPLIED, FAILED
  • archive_status — VARCHAR(30) — NOT NULL — ACTIVE, ARCHIVED
  • total_count — INT — NOT NULL — 전체 건수
  • valid_count — INT — NOT NULL — 검증 성공 건수
  • invalid_count — INT — NOT NULL — 제외 건수
  • error_summary_json — JSON — 오류 요약. 원본 전체 복사 금지
  • started_at — DATETIME(6) — 시작시각
  • completed_at — DATETIME(6) — 완료시각
  • created_at — DATETIME(6) — NOT NULL — 배치 등록시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

subway_line

  • subway_line_id — BIGINT — Primary key — NOT NULL — 노선 ID
  • line_code — VARCHAR(50) — NOT NULL — 노선 코드
  • line_name — VARCHAR(100) — NOT NULL — 2호선, 신분당선 등
  • display_color — CHAR(7) — 화면용 #RRGGBB; 핵심 데이터는 아님
  • is_active — BOOLEAN — NOT NULL — 운영 노선 여부
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

subway_station

  • subway_station_id — BIGINT — Primary key — NOT NULL — 역 ID
  • station_code — VARCHAR(50) — NOT NULL — 기준 데이터 역 코드
  • station_name — VARCHAR(100) — NOT NULL — 화면 역명
  • location — POINT — NOT NULL — 거리 계산 기준점
  • region_id — BIGINT — Foreign key → region.region_id — 역이 속한 지역
  • is_active — BOOLEAN — NOT NULL — 폐역 제외
  • source_date — DATE — NOT NULL — 기준 데이터 날짜
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH

subway_station_line

  • subway_station_line_id — BIGINT — Primary key — NOT NULL — 연결 ID
  • subway_station_id — BIGINT — Foreign key → subway_station.subway_station_id — NOT NULL — 역
  • subway_line_id — BIGINT — Foreign key → subway_line.subway_line_id — NOT NULL — 노선
  • display_order — INT — 노선 내 역 순서를 사용하는 경우
  • created_at — DATETIME(6) — NOT NULL — 행이 처음 생성된 UTC 시각
  • created_by_member_id — BIGINT — 생성한 Member 외부 ID
  • created_by_role — VARCHAR(30) — 생성 당시 역할 스냅샷
  • updated_at — DATETIME(6) — NOT NULL — 마지막 수정 UTC 시각
  • updated_by_member_id — BIGINT — 마지막 수정 Member 외부 ID
  • updated_by_role — VARCHAR(30) — 마지막 수정 당시 역할
  • deleted_at — DATETIME(6) — 소프트 삭제 시각, NULL이면 활성
  • deleted_by_member_id — BIGINT — 삭제한 Member 외부 ID
  • deleted_by_role — VARCHAR(30) — 삭제 당시 역할
  • delete_reason — VARCHAR(500) — 소프트 삭제 사유
  • action_source — VARCHAR(20) — NOT NULL — 작업 주체: MEMBER, SYSTEM, BATCH