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