Homefit_ERD

테이블 (22)

가이드 (guides)

  • 가이드 ID (guide_id) — BIGSERIAL — 기본 키 — NOT NULL — 가이드 pk
  • 카테고리ID (category_id) — BIGINT — 외래 키 → 가이드 카테고리.카테고리ID — NOT NULL — 가이드 카테고리pk
  • 가이드 제목 (title) — varchar(255) — NOT NULL — 예)청년안심주택 최초 신청 절차 안내
  • 가이드 종류 (content_type) — ENUM('TEXT', 'IMAGE', 'CHECKLIST') — NOT NULL — 가이드 종류
  • 본문 (content_body) — text — NOT NULL — TEXT는 일반 문단, IMAGE는 이미지 URL 한 줄, CHECKLIST는 줄마다 체크 아이콘을 붙여서 표시
  • 공고종류 (announcement_type) — ENUM('YOUTH_SAFE_HOUSE', 'ADDITIONAL_RECRUIT', 'COMMON') — NOT NULL — 공고종류
  • 노출순서 (display_order) — INT — NOT NULL — 노출순서
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정시각

가이드 카테고리 (guide_categories)

  • 카테고리ID (category_id) — BIGSERIAL — 기본 키 — NOT NULL — 가이드 카테고리 PK, PostgreSQL sequence 기반 자동 증가
  • 카테고리 이름 (category_name) — varchar(100) — NOT NULL — 카테고리명 (신청절차/자격조건/서류준비/계약절차 등)
  • 노출순서 (display_order) — INT — NOT NULL — 노출순서

공고 (notices)

  • 공고 ID (notice_id) — BIGSERIAL — 기본 키 — NOT NULL — 공고 PK
  • 단지 ID (complex_id) — BIGINT — 외래 키 → 단지.단지 ID — NOT NULL — FK → housing_complexes.complex_id
  • 공고 번호 (announcement_no) — VARCHAR(100) — 외부 공고 번호
  • 공고 제목 (title) — VARCHAR(255) — NOT NULL — 공고명
  • 공고 원문 URL (source_url) — TEXT — NOT NULL — 원문 링크
  • 중복 판별 해시 (dedup_hash) — VARCHAR(255) — NOT NULL — 크롤링 공고 중복 방지용 UNIQUE 적용
  • 내용 해시 (content_hash) — VARCHAR(255) — 변경 감지용
  • 추가모집 여부 (is_additional_recruitment) — BOOLEAN — NOT NULL — 0: 일반 공고, 1: 추가모집 공고
  • 접수 시작일 (application_start_at) — TIMESTAMP(0) — 신청 시작 시각. 공고 상태는 DB에 저장하지 않고 현재 시각과 비교하여 API에서 계산 (시작 전: SCHEDULED, KST 기준)
  • 접수 마감일 (application_end_at) — TIMESTAMP(0) — 신청 마감 시각. API 상태 계산 기준 (마감까지 72시간 초과: RECRUITING, 0시간 초과 72시간 이하: CLOSING_SOON, 마감 시각부터: CLOSED, KST 기준)
  • 원문 내용 (raw_content) — TEXT — 크롤링 원문 텍스트
  • 파싱 결과 (parsed_json) — TEXT — HTML → JSON 변환 결과
  • 마지막 크롤링 시각 (last_crawled_at) — TIMESTAMP(0) — 마지막 수집 시각
  • 조회 수 (views) — INT — NOT NULL — 조회 수 캐시
  • 관심 수 (interested_count) — INT — NOT NULL — 전체 사용자 저장 수 캐시 컬럼, saved_notices 기준 집계
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각

공고 자격 조건 (notice_conditions)

  • 조건 ID (condition_id) — BIGSERIAL — 기본 키 — NOT NULL — 조건 PK
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — NOT NULL — FK → notices.notice_id
  • 대상 유형 (target_type) — ENUM('YOUTH','NEWLYWED','COMMON','OTHER') — NOT NULL — enum: YOUTH(청년), NEWLYWED(신혼부부), COMMON(공통), OTHER(기타)
  • 최소 나이 (min_age) — INT — 연령 조건
  • 최대 나이 (max_age) — INT — 연령 조건
  • 소득 기준 금액 (income_limit_amount) — BIGINT — 원 단위
  • 소득 기준 설명 (income_limit_text) — TEXT — 원문 설명
  • 자산 기준 금액 (asset_limit_amount) — BIGINT — 원 단위
  • 자산 기준 설명 (asset_limit_text) — TEXT — 원문 설명
  • 무주택 필요 여부 (requires_homeless) — BOOLEAN — 0: 무관, 1: 무주택 필요
  • 주택 소유 조건 (housing_ownership_requirement) — TEXT — 화면 표시용
  • 거주지 조건 (residence_requirement) — TEXT — 거주지 조건
  • 가구 조건 (household_requirement) — TEXT — 가구원/세대 조건
  • 청약 조건 (subscription_requirement) — TEXT — 청약 관련 조건
  • 원문 조건 (raw_condition_text) — TEXT — 파싱 전 조건 원문
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각

공고 주택형 (notice_units)

  • 주택형 ID (unit_id) — BIGSERIAL — 기본 키 — NOT NULL — 주택형 PK
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — NOT NULL — FK → notices.notice_id
  • 주택형명 (unit_name) — VARCHAR(100) — A타입, 24㎡ 등
  • 전용면적 (exclusive_area_m2) — DECIMAL(6,2) — 전용면적, 단위: ㎡
  • 공급면적 (supply_area_m2) — DECIMAL(6,2) — 공급면적, 단위: ㎡
  • 최소 보증금 (deposit_min) — BIGINT — 원 단위
  • 최대 보증금 (deposit_max) — BIGINT — 원 단위
  • 최소 월세 (monthly_rent_min) — BIGINT — 원 단위
  • 최대 월세 (monthly_rent_max) — BIGINT — 원 단위
  • 공급 세대수 (supply_count) — INT — 세대수
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각

공고 첨부파일 (notice_files)

  • 파일 ID (file_id) — BIGSERIAL — 기본 키 — NOT NULL — 파일 PK
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — NOT NULL — FK → notices.notice_id
  • 파일명 (file_name) — VARCHAR(255) — NOT NULL — 파일 이름
  • 파일 유형 (file_type) — ENUM('PDF','IMAGE','LINK','DOC','OTHER') — NOT NULL — enum: PDF, IMAGE, LINK, DOC, OTHER
  • 파일 URL (file_url) — TEXT — NOT NULL — 첨부파일 URL
  • 등록일 (registered_at) — TIMESTAMP(0) — 공고 사이트 등록일
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각

금융상품 (loan_products)

  • 상품ID (product_id) — bigint — 기본 키 — NOT NULL — 금융상품 pk
  • 상품명 (product_name) — varchar(255) — NOT NULL — 상품명 예) 청년 버팀목 전세자금대출
  • 제공기관유형 (provider_type) — ENUM('POLICY', 'BANK') — NOT NULL — 제공기관유형 POLICY는 정책금융, BANK는 1금융권
  • 취급기관명 (provider_name) — varchar(100) — NOT NULL — 취급기관명 예) 국민은행, 서울시
  • 최저금리 (min_rate) — decimal(5, 2) — 최저금리 (%)
  • 최고금리 (max_rate) — decimal(5, 2) — 최고금리 (%)
  • 최대한도 (max_limit_amount) — bigint — 최대한도
  • 신청최소연령 (min_age) — int — 신청최소연령 | 만 나이 기준
  • 신청최대연령 (max_age) — int — 신청최대연령 | 만 나이 기준
  • 소득상한 (max_income) — bigint — 소득상한
  • 자산상한 (max_asset) — bigint — 자산상한
  • 무주택 조건 필요 여부 (require_no_house) — boolean — 무주택 조건 필요 여부
  • 공식 사이트 링크 (official_url) — varchar(500) — 공식 사이트 링크
  • 상품설명 (description) — text — 상품설명
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성일 | 생성시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정시각
  • 보증비율(%) (guarantee_ratio) — INT — 보증비율(%). 은행 대출상품 전용, provider_name, product_name과 함께 COMPOSITE UNIQUE 적용
  • 전세 보증금 상환 (max_deposit_amount) — BIGINT — 전세보증금 상한 (원 단위), 예) 청년전용 버팀목 3억원
  • 임차전용면적 상한 (max_area_m2) — DECIMAL(6,2) — 임차 전용면적 상한 (㎡), notice_units.exclusive_area_m2와 비교
  • 최소 소득기준 (min_income) — BIGINT — 소득 하한 (원 단위), 하한 없는 상품은 NULL (확장성 고려)
  • 최소자산 (min_asset) — BIGINT — 자산 하한 (원 단위), 하한 없는 상품은 NULL (확장성 고려)
  • 상품카테고리 (product_category) — ENUM('MORTGAGE_LOAN', 'JEONSE_LOAN', 'SUBSCRIPTION_SAVINGS') — 담보대출/전세대출/청약저축
  • 생애최초전용여부 (first_time_buyer_only) — boolean — 생애최초 전용 여부. require_no_house(무주택)와 별개 조건
  • 담보인정비율 (ltv_ratio) — int — 담보가치 대비 대출 비율(%)
  • 총부채상환비율 (dti_ratio) — int — 소득 대비 원리금 상환 비율(%). 대출 상품 전용
  • 최소대출기간 (loan_term_min_years) — int — 대출 최소 기간 (년)
  • 최대대출기간 (loan_term_max_years) — int — 대출 최대 기간 (년)
  • 우대금리할인폭 (preferential_rate_discount) — decimal(4,2) — 우대금리 최대 할인폭 (%p)
  • 최소월납입액 (min_monthly_deposit) — bigint — 청약저축 전용: 월 최소 납입액
  • 최대월납입액 (max_monthly_deposit) — bigint — 청약저축 전용: 월 최대 납입액
  • 신혼부부전용여부 (require_married) — boolean — 신혼부부전용상품 여부
  • 혼인기간 조건 (max_marriage_years) — INT — 혼인기간 조건(예: 7년 이내), require_married=true일 때만 의미
  • 신생아 특례대상 여부 (require_recent_newborn) — boolean — 신생아 특례 대상 여부
  • 출산 후 몇년 이내 조건 (newborn_within_years) — INT — 출산 후 몇년 이내 조건
  • 소득공제 여부 (income_tax_deductible) — boolean — 소득공제 여부
  • 생애최초 구입자 전용 추가 우대금리 (first_time_buyer_rate_discount) — DECIMAL(4,2) — 생애최초 구입자 전용 추가 우대금리(%p). 기존 preferential_rate_discount(일반 우대금리)와 별개 필드
  • 세대주(예비세대주 포함) 전용 여부 (require_household_head) — boolean — 세대주(예비세대주 포함) 전용 여부
  • 제공기관 로고 이미지 URL (provider_logo_url) — VARCHAR(500) — 제공기관 로고 이미지 URL (S3 public-read), 현재 Seed 데이터는 NULL이며 저장소 공개 여부와 별도로 관리

금융용어 (finance_terms)

  • 용어D (term_id) — BIGSERIAL — 기본 키 — NOT NULL — 용어 pk
  • 용어명 (term) — varchar(50) — NOT NULL — 금융 용어 중복 방지용 UNIQUE 적용
  • 용어 설명 (detail_description) — text — 설명
  • 생성시각 (created_at) — TIMESTAMP(0) — NOT NULL — 생성시각

단지 (housing_complexes)

  • 단지 ID (complex_id) — BIGSERIAL — 기본 키 — NOT NULL — 단지 PK
  • 단지명 (name) — VARCHAR(255) — NOT NULL — 예: 어반허브 서울스테이션
  • 지역 (region) — VARCHAR(100) — NOT NULL — 시/도
  • 구/군 (district) — VARCHAR(100) — 시/군/구
  • 주소 (address) — VARCHAR(255) — 단지 주소
  • 크롤링 URL (source_url) — TEXT — 공고 수집 대상 URL
  • 활성 여부 (is_active) — BOOLEAN — NOT NULL — 0: 비활성, 1: 활성
  • 크롤링 활성 여부 (crawl_enabled) — BOOLEAN — NOT NULL — 0: 제외, 1: 크롤링 대상
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각

사용자 (users)

  • 사용자 ID (user_id) — BIGSERIAL — 기본 키 — NOT NULL — PK: 사용자 ID (camelCase: userId)
  • 이메일 (email) — VARCHAR(255) — 로그인 이메일. NULL 허용, 비NULL 이메일 중복 방지를 위한 UNIQUE 적용
  • 비밀번호 (password) — VARCHAR(255) — 로컬 가입자용 비밀번호
  • 로그인 제공자 (provider) — ENUM('LOCAL','KAKAO','GOOGLE') — NOT NULL — enum: LOCAL(이메일·비밀번호), KAKAO(카카오), GOOGLE(구글)
  • 로그인 제공자 ID (provider_id) — VARCHAR(255) — COMPOSITE UNIQUE: 소셜 로그인 식별자 (provider와 결합)
  • 상태 (status) — ENUM('ACTIVE','INACTIVE') — NOT NULL — enum: ACTIVE(활성 계정), INACTIVE(비활성 계정)
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 계정 생성 시각(ISO 8601 문자열 기준)
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 계정 수정 시각, Prisma @updatedAt으로 갱신 (ISO 8601 문자열 기준)

사용자 조건 프로필 (user_condition_profiles)

  • 사용자 조건 프로필 ID (user_condition_profile_id) — BIGSERIAL — 기본 키 — NOT NULL — PK: 사용자 조건 프로필 ID (camelCase: userConditionProfileId)
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — FK: 사용자 ID, UNIQUE : 사용자 ID (1:1 매핑)(camelCase: userId)
  • 연간 총소득 (monthly_income_amount) — BIGINT — NOT NULL — 월간 총소득 (원 단위 정수)
  • 총 보유 자산 (total_asset_amount) — BIGINT — NOT NULL — 총 보유 자산 (원 단위 정수, 부부 총합)
  • 총 부채 금액 (total_debt_amount) — BIGINT — NOT NULL — 총 부채 금액 (원 단위 정수, 부부 총합)
  • 월 상환액 (monthly_debt_payment_amount) — BIGINT — NOT NULL — 월 상환액 (원 단위 정수)
  • 보유 현금 (cash_savings) — BIGINT — NOT NULL — 보유 현금 (원 단위 정수)
  • 주택 소유 상태 (housing_ownership_status) — VARCHAR(50) — NOT NULL — enum: HOMELESS(본인·가족 모두 무주택), OWNED(본인 명의 유주택), FAMILY_OWNED(본인은 무주택이나 배우자·가족 명의 유주택), UNKNOWN(미입력)
  • 무주택 여부 (is_homeless) — BOOLEAN — NOT NULL — 1: 무주택, 0: 무주택 아님
  • 거주 지역 (residence_region_code) — VARCHAR(100) — 거주 지역 (검색용 지역 코드)
  • 직장/학교 지역 (workplace_region_code) — VARCHAR(100) — 직장/학교 지역 (검색용 지역 코드)
  • 생성 일시 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각, 생성 시 현재 시각 자동 입력 (ISO 8601 문자열 기준)
  • 수정 일시 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각, 생성 시 현재 시각 입력 후 Prisma @updatedAt으로 갱신 (ISO 8601 문자열 기준)
  • 세대주 여부 (household_head_status) — VARCHAR(30) — NOT NULL — enum: HEAD(세대주) / HEAD_EXPECTED(세대주 예정자) / RECOGNIZED(세대주 인정자) / MEMBER(세대원) / UNKNOWN
  • 혼인여부 (marital_status) — VARCHAR(30) — NOT NULL — enum: SINGLE(미혼) / MARRIED(기혼) / MARRIAGE_EXPECTED(3개월 이내 결혼예정) / UNKNOWN
  • 혼인날짜 (marriage_date) — DATE — 혼인일자, 신혼가구(혼인 7년 이내) 판정용. marital_status=MARRIED일 때만 값 존재
  • 미성년 자녀수 (minor_children_count) — INT — NOT NULL — 미성년(만 19세 미만) 자녀 수, 우대금리·소득기준 완화 판정용
  • 최근 출산/입양 여부 (has_recent_newborn) — BOOLEAN — NOT NULL — 신생아 특례 대상 여부, 0: 해당없음, 1: 대출접수일 기준 2년 내 출산·입양
  • 자녀 출생일 (newborn_birth_date) — DATE — 최근 출생/입양일, has_recent_newborn=1일 때만 값 존재
  • 기존 대출 보유 여부 (has_existing_housing_loan) — BOOLEAN — NOT NULL — 기금대출/전세대출/이주비대출/주택담보대출 보유 여부, 0: 없음, 1: 있음 (버팀목 중복대출 제한 판정용)
  • 생애최초 주택 구입자 여부 (is_first_time_buyer) — BOOLEAN — loan_products.first_time_buyer_only 조건 판정용
  • 직업상태 (employment_status) — varchar(30) — enum(안): STUDENT(대학생) / JOB_SEEKER(취업준비생) / EMPLOYED(직장인) / SELF_EMPLOYED(자영업) — 값 컨벤션 기획 확인 필요, 실제 사용처 미정

사용자 프로필 (user_profiles)

  • 프로필 ID (profile_id) — BIGSERIAL — 기본 키 — NOT NULL — PK: 프로필 고유 식별자 (camelCase: profile_id)
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — FK: 사용자 ID, UNIQUE : 사용자 ID (1:1 매핑)(camelCase: userId)
  • 사용자 별명 (nickname) — VARCHAR(50) — 별명 (camelCase: nickname)
  • 생년월일 (birth_date) — DATE — 생년월일 (camelCase: birthDate, ISO 8601)
  • 연락처 정보 (phone_number) — VARCHAR(20) — 연락처 (camelCase: phoneNumber)
  • 프로필 이미지 경로 (profile_image_url) — VARCHAR(255) — 프로필 이미지 URL (camelCase: profileImageUrl)
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 프로필 생성 시각 (ISO 8601 문자열 기준)
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 프로필 수정 시각, Prisma @updatedAt으로 갱신 ((ISO 8601 문자열 기준)

상품/공고와 서류 매핑 (document_mappings)

  • 서류매핑ID (mapping_id) — BIGSERIAL — 기본 키 — NOT NULL — 서류매핑 pk
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — document_id와 함께 COMPOSITE UNIQUE(notice_id, document_id) 적용, FK → notices.notice_id, ON DELETE SET NULL
  • 상품ID (product_id) — bigint — 외래 키 → 금융상품.상품ID — document_id와 함께 COMPOSITE UNIQUE(product_id, document_id) 적용, FK → loan_products.product_id, ON DELETE SET NULL
  • 서류id (document_id) — bigint — 외래 키 → 필수 서류.서류id — NOT NULL — 필요서류
  • 대상구분 (target_type) — ENUM('ANNOUNCEMENT', 'PRODUCT') — NOT NULL — 대상 유형: ANNOUNCEMENT / PRODUCT. PRODUCT이면 product_id만 NOT NULL이고 notice_id는 NULL, ANNOUNCEMENT이면 notice_id만 NOT NULL이고 p…
  • 필수여부 (is_required) — boolean — NOT NULL — 필수여부

알림 로그 (notification_logs)

  • 알림 로그 ID (notification_log_id) — BIGSERIAL — 기본 키 — NOT NULL — 알림 로그 PK
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — FK → users.user_id
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — FK → notices.notice_id, ON DELETE SET NULL
  • 알림 유형 (notification_type) — VARCHAR(30) — NOT NULL — enum: NEW_NOTICE, CLOSING_SOON
  • 읽음 여부 (is_read) — BOOLEAN — NOT NULL — 알림 읽음 여부, 0: 읽지 않음, 1: 읽음
  • 제목 (title) — VARCHAR(255) — NOT NULL — 푸시 제목
  • 내용 (body) — TEXT — 푸시 내용
  • 발송 상태 (status) — ENUM('PENDING','SENT','FAILED','RETRYING') — NOT NULL — enum: PENDING(발송 대기), SENT(발송 성공), FAILED(발송 실패), RETRYING(재시도 중)
  • 발송 시각 (sent_at) — TIMESTAMP(0) — 실제 발송 시각
  • 실패 사유 (failure_reason) — TEXT — 실패 메시지
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 로그 생성 시각

알림설정 (alert_settings)

  • 알림 설정 ID (alert_setting_id) — BIGSERIAL — 기본 키 — NOT NULL — 알림 설정 고유 ID
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — users.user_id 참조, 사용자 1명당 알림 설정 1개, UNIQUE 필요: 사용자 1명당 알림 설정 1개
  • 전체 푸시 알림 여부 (push_enabled) — BOOLEAN — NOT NULL — 전체 푸시 알림 여부, 0: 비활성, 1: 활성
  • 신규 공고 알림 여부 (notice_alert_enabled) — BOOLEAN — NOT NULL — 신규 공고 알림 여부, 0: 비활성, 1: 활성
  • 청약 일정 알림 여부 (schedule_alert_enabled) — BOOLEAN — NOT NULL — 청약 일정 알림 여부, 0: 비활성, 1: 활성
  • 금융상품 알림 여부 (finance_alert_enabled) — BOOLEAN — NOT NULL — 금융상품 알림 여부, 0: 비활성, 1: 활성
  • 관심 지역 (interested_region) — VARCHAR(100) — 신규 공고 알림 대상자 조회 기준
  • 생성 시각 (created_at) — TIMESTAMP(0) — NOT NULL — 생성 시각
  • 수정 시각 (updated_at) — TIMESTAMP(0) — NOT NULL — 수정 시각

외부api 로그 (external_api_call_logs)

  • 외부 api 로그 ID (external_api_log_id) — BIGSERIAL — 기본 키 — NOT NULL — 외부 api로그 PK
  • api이름 (api_name) — VARCHAR(50) — NOT NULL — API 식별자 (예: LOAN_RATE_API, LOAN_GUARANTEE_INFO_API)
  • 에러유형 (error_type) — ENUM('HTTP_ERROR', 'RESULT_CODE_ERROR','INVALID_RESPONSE', 'NETWORK_ERROR') — 오류 유형 (HTTP_ERROR / RESULT_CODE_ERROR / INVALID_RESPONSE / NETWORK_ERROR)
  • http상태유형 (http_status_code) — INTEGER — 응답 HTTP 상태 코드 (네트워크 단계 오류 시 NULL)
  • 요청url (request_url) — VARCHAR(500) — 요청 URL. serviceKey 등 인증정보는 반드시 제외하고 저장
  • 에러메세지 (error_message) — TEXT — 오류 메시지 상세
  • 시작시각 (started_at) — TIMESTAMP(0) — NOT NULL — API 호출 시작 시각
  • 실패시각 (failed_at) — TIMESTAMP(0) — NOT NULL — 실패 기록 시각
  • 생성시각 (created_at) — TIMESTAMP(0) — NOT NULL — 로그생성 시각

유저 디바이스 (user_device)

  • 기기 ID (device_id) — BIGSERIAL — 기본 키 — NOT NULL — PK: 기기 고유 식별자
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — FK: 사용자 ID
  • FCM 토큰 (fcm_token) — VARCHAR(255) — NOT NULL — 전역 UNIQUE, 같은 기기 토큰 재등록 시 사용자에게 재할당
  • 기기 종류 (device_type) — ENUM('ANDROID','IOS') — enum: ANDROID(안드로이드), IOS(iOS)
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 디바이스 토큰 등록 시각 (ISO 8601 문자열 기준)
  • 수정일 (updated_at) — TIMESTAMP(0) — NOT NULL — 디바이스 토큰 수정·재할당 시각, Prisma @updatedAt으로 갱신 (ISO 8601 문자열 기준)

입주 가능성 분석 (eligibility_analyses)

  • 입주 가능성 분석 ID (eligibility_analysis_id) — BIGSERIAL — 기본 키 — NOT NULL — 입주 가능성 분석 PK
  • 사용자 조건 프로필 ID (user_condition_profile_id) — BIGINT — 외래 키 → 사용자 조건 프로필.사용자 조건 프로필 ID — NOT NULL — FK → user_condition_profiles.user_condition_profile_id
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — NOT NULL — FK → notices.notice_id
  • 주택형 ID (unit_id) — BIGINT — 외래 키 → 공고 주택형.주택형 ID — NOT NULL — FK → units.unit_id
  • 입주 가능성 등급 (result_level) — ENUM('HIGH','MEDIUM','LOW','NOT_ELIGIBLE','NEED_CHECK') — NOT NULL — enum: HIGH(높음), MEDIUM(보통), LOW(낮음), NOT_ELIGIBLE(자격 미달), NEED_CHECK(추가 확인 필요)
  • 입주 가능성 점수 (eligibility_score) — DECIMAL(5,2) — NOT NULL — 입주 가능성 점수(0~100)
  • 예상 보증금 (expected_deposit_amount) — BIGINT — NOT NULL — 원 단위
  • 예상 월세 (expected_monthly_rent_amount) — BIGINT — 원 단위
  • 예상 관리비 (maintenance_fee_amount) — BIGINT — 원 단위
  • 사용자 보유 현금 (user_cash_amount) — BIGINT — NOT NULL — 분석 실행 시점의 사용자 보유 현금 스냅샷(원 단위)
  • 사용자 월소득 (monthly_income_amount) — BIGINT — NOT NULL — 분석 실행 시점의 사용자 월소득 스냅샷(원 단위)
  • 부족 자금 (shortage_amount) — BIGINT — NOT NULL — 원 단위 (부족 자금 = max(예상 보증금 - 사용자 보유 현금, 0))
  • 월세 부담률 (rent_burden_rate) — DECIMAL(5,2) — % 단위 (월세 부담률 = 월 주거비 / 사용자 월소득 × 100)
  • 분석 요약 문구 (summary_message) — VARCHAR(500) — 분석 결과 요약 메시지
  • 분석 일시 (analyzed_at) — TIMESTAMP(0) — NOT NULL — 분석 수행 시각
  • 조건 프로필 스냅샷 (condition_profile_snapshot) — JSONB — 분석 시점의 사용자 조건 프로필 스냅샷. 분석 후 프로필 변경과 무관하게 분석 당시 값을 보존하며, 기존 분석 이력은 NULL 가능

입주 조건별 비교 결과 (eligibility_condition_results)

  • 조건별 비교 결과 ID (eligibility_condition_result_id) — BIGSERIAL — 기본 키 — NOT NULL — 조건별 비교 결과 PK
  • 입주 가능성 분석 ID (eligibility_analysis_id) — BIGINT — 외래 키 → 입주 가능성 분석.입주 가능성 분석 ID — NOT NULL — FK → eligibility_analyses.eligibility_analysis_id
  • 조건 ID (condition_id) — BIGINT — 외래 키 → 공고 자격 조건.조건 ID — FK → notice_conditions.condition_id, ON DELETE SET NULL (공고 조건 존재 시 참조)
  • 조건 코드 (condition_code) — ENUM('INCOME','ASSET','CASH','HOMELESS','RENT_BURDEN','DEBT','REGION','AGE','HOUSEHOLD','SUBSCRIPTION','OTHER') — NOT NULL — enum: INCOME(소득), ASSET(자산), CASH(보유 현금), HOMELESS(무주택), RENT_BURDEN(월세 부담률), DEBT(부채), REGION(지역), AGE(나이 조건), HOUSEHO…
  • 조건명 (condition_name) — VARCHAR(100) — NOT NULL — 조건명
  • 공고 기준값 (required_value) — VARCHAR(255) — 공고에서 요구하는 조건값
  • 사용자 입력값 (user_value) — VARCHAR(255) — 사용자 입력값
  • 비교 결과 (result_status) — ENUM('PASS','FAIL','NEED_CHECK') — NOT NULL — enum: PASS(조건 충족), FAIL(조건 미충족), NEED_CHECK(추가 확인 필요)
  • 불충족 사유 (fail_reason) — VARCHAR(500) — 조건 미충족 사유

저장 공고 (saved_notices)

  • 저장 ID (saved_notice_id) — BIGSERIAL — 기본 키 — NOT NULL — 저장 PK
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — FK → users.user_id, UNIQUE(user_id, notice_id) 적용: 같은 사용자의 같은 공고 중복 저장 방지
  • 공고 ID (notice_id) — BIGINT — 외래 키 → 공고.공고 ID — NOT NULL — FK → notices.notice_id, UNIQUE(user_id, notice_id) 적용: 같은 사용자의 같은 공고 중복 저장 방지
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 저장 시각

크롤링 로그 (crawl_logs)

  • 크롤링 로그 ID (crawl_log_id) — BIGSERIAL — 기본 키 — NOT NULL — 크롤링 로그 PK
  • 단지 ID (complex_id) — BIGINT — 외래 키 → 단지.단지 ID — FK → housing_complexes.complex_id, ON DELETE SET NULL
  • 상태 (status) — ENUM('SUCCESS','FAILED','PARTIAL') — NOT NULL — enum: SUCCESS(성공), FAILED(실패), PARTIAL(일부 성공)
  • 크롤러 유형 (crawler_type) — ENUM('PLAYWRIGHT','CHEERIO','MANUAL') — enum: PLAYWRIGHT, CHEERIO, MANUAL(수동 등록)
  • 에러 유형 (error_type) — VARCHAR(50) — 운영 중 확장 가능한 오류 분류 (예: NETWORK_ERROR, PARSE_ERROR, TIMEOUT, UNKNOWN)
  • 시작 시각 (started_at) — TIMESTAMP(0) — NOT NULL — 크롤링 시작 시각
  • 종료 시각 (finished_at) — TIMESTAMP(0) — 크롤링 종료 시각
  • 재시도 횟수 (attempt_count) — INT — NOT NULL — 최대 3회
  • 에러 메시지 (error_message) — TEXT — 실패 사유
  • 신규 공고 수 (created_notice_count) — INT — NOT NULL — 신규 INSERT 수
  • 변경 공고 수 (updated_notice_count) — INT — NOT NULL — 변경 UPDATE 수
  • 생성일 (created_at) — TIMESTAMP(0) — NOT NULL — 로그 생성 시각

필수 서류 (required_documents)

  • 서류id (document_id) — BIGSERIAL — 기본 키 — NOT NULL — 필요서류 pk
  • 서류명 (document_name) — varchar(255) — NOT NULL — 서류명
  • 발급처 (issuer) — varchar(100) — 발급처 예) 정부24, 주민센터
  • 발급방법 (issue_method) — ENUM('ONLINE', 'OFFLINE', 'BOTH') — NOT NULL — 발급방법
  • 유효기간 (validity_period_days) — int — 유효기간
  • 서류구분 (document_type) — ENUM('COMMON', 'PRODUCT', 'ANNOUNCEMENT') — NOT NULL — 서류구분 | COMMON은 공통, PRODUCT는 상품별, ANNOUNCEMENT는 공고별
  • 서류설명 (description) — text — 서류설명
  • 생성시각 (created_at) — TIMESTAMP(0) — NOT NULL — 생성시각