셀프빌_SCHEMA

테이블 (12)

건물 (buildings)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 건물 주소 (address) — text — NOT NULL
  • 건물 상세 주소 (address_detail) — text — NOT NULL
  • 계획 세대 수 (planned_units_count) — numeric — NOT NULL
  • 실제 세대 수 (building_units_count) — numeric — NOT NULL
  • 정산 방식 (billing_method) — text — NOT NULL
  • 사용 기간 기준 (billing_period_type) — text — NOT NULL
  • 정산 기준 기간 시작일 (billing_period_start) — numeric — NOT NULL
  • 정산 기준 기간 마지막일 (billing_period_end) — numeric — NOT NULL
  • 납부 마감일 기준 일자 (billing_due_day) — numeric
  • 연체율 (late_fee_rate_percent) — numeric
  • 은행명 (bank_name) — text
  • 계좌번호 (bank_account) — text
  • 계좌 소유자 (bank_holder) — text
  • 월 기본 관리비 (billing_monthly_fee_krw) — numeric
  • 셀프빌 요금제 확정일 (selfbill_plan_confirmed_at) — timestamptz — NOT NULL
  • 셀프빌 자동이체용 계좌 은행명 (selfbill_auto_bank_name) — text — NOT NULL
  • 셀프빌 자동이체용 계좌번호 (selfbill_auto_bank_account) — text — NOT NULL
  • 셀프빌 자동이체용 계좌 소유자 (selfbill_auto_bank_holder) — text — NOT NULL
  • 셀프빌 요금제 자동이체 시작일 (selfbill_auto_start_date) — date — NOT NULL
  • 건물 초기 설정 단계 (setup_step) — numeric
  • 건물 설정 상태 (status) — text
  • 등록일 (created_at) — timestamptz
  • 건물 설정 변경일 (updated_at) — timestamptz

납부 현황 (payment_statuses)

  • ID (Key) — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 세대 ID (unit_id) — uuid — 외래 키 → 세대 정보.ID — NOT NULL
  • 세대별 청구서 ID (unit_charges_id) — uuid — 외래 키 → 세대별 청구서.ID — NOT NULL
  • 청구(연도 월) (year_month) — text — NOT NULL
  • 납부 상태 (status) — text
  • 청구 금액 (charged_amount) — numeric
  • 납부 금액 (paid_amount) — numeric
  • 납부 시각 (paid_at) — timestamptz
  • 메모 (memo) — text
  • 생성일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz

대표자 권한 위임 요청 (role_change_requests)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 요청자 ID (from_user_id) — uuid
  • 대상자 ID (to_user_id) — uuid
  • 대표자 권한 위임 상태 (status) — text
  • 요청 시각 (requested_at) — timestamptz
  • 응답 시각 (responded_at) — timestamptz
  • 요청 생성일 (created_at) — timestamptz
  • 요청 상태 변경일 (updated_at) — timestamptz

사용자 (user)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 이름 (name) — text — NOT NULL
  • 이메일 (email) — text — NOT NULL
  • 연락처 (phone) — text — NOT NULL
  • 사용자인증 (auth_provider) — text — NOT NULL
  • 등록일 (created_at) — uuid — NOT NULL
  • 수정일 (updated_at) — uuid — NOT NULL

세대 정보 (units)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 동 (dong) — text — NOT NULL
  • 호수 (ho) — text — NOT NULL
  • 층수 (floor) — text — NOT NULL
  • 입주자 이름 (unit_name) — text — NOT NULL
  • 청구서 수신인 (tenant_name) — text — NOT NULL
  • 청구서 수신번호 (tenant_phone) — text — NOT NULL
  • 청구서 수신이메일 (tenant_email) — text — NOT NULL
  • 소유자 여부 (is_owner) — boolean
  • 거주 인원 수 (residents_count) — numeric
  • 입주일 (move_in_date) — date
  • 차량 수 (car_count) — numeric
  • 차량 번호 (car_numbers) — text
  • 지분률 (share_ratio) — numeric
  • 검토 여부 필요 (needs_review) — boolean
  • 세대 상태 (status) — text
  • 등록일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz

세대별 청구서 (unit_charges)

  • ID (Key) — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 세대 ID (unit_id) — uuid — 외래 키 → 세대 정보.ID — NOT NULL
  • 청구 주기 ID (bill_cycle_id) — uuid — 외래 키 → 청구 주기(월/회차).ID — NOT NULL
  • 청구(연도 월) (year_month) — text
  • 총 청구액 (amount_total) — numeric
  • 항목별 상세 내역 (breakdown_json) — jsonb — 청구서 핵심 데이터
  • 연체료 (late_fee_amount) — numeric
  • 기한 후 납부 금액 (after_due_amount) — numeric — 총액 + 연체료
  • 발송 여부 (is_sent) — boolean
  • 발송일 (sent_at) — timestamptz
  • 생성일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz

실제 청구 항목 (bill_items)

  • ID (Key) — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 템플릿 ID (bill_item_template_id) — uuid — 외래 키 → 청구 항목 템플릿 - 고정/변동 설정.ID — NOT NULL
  • 청구 주기 ID (bill_cycle_id) — uuid — 외래 키 → 청구 주기(월/회차).ID — NOT NULL
  • 청구 항목 (name) — text — NOT NULL
  • 청구 항목 분류 (category) — text
  • 항목 총액 (amount_total) — numeric
  • 배분 방식 (allocation_method) — text
  • 항목 타입 (type) — text
  • 특정 세대 IDs (target_unit_ids) — uuid
  • 세대별 금액 (unit_amounts) — jsonb
  • 생성일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz

알림 (notification_logs)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — uuid — 외래 키 → 사용자.ID — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 수신 연락처 (to_phone) — text — NOT NULL
  • 발송 채널 (channel) — text — NOT NULL
  • 이벤트 유형 (event_type) — text — NOT NULL
  • 이벤트 참조 (event_ref_id) — text — NOT NULL — event_type에 따라 참조 대상이 바뀜
  • 알림 제목 (title) — text
  • 알림 메세지 내용 (body) — text
  • 발송 상태 (status) — text
  • 외부 발송 ID (provider_message_id) — text
  • 오류 메세지 (error_message) — text — API를 통한 발송 ID
  • 발송일 (sent_at) — timestamptz
  • 생성일 (created_at) — timestamptz
  • 알림 상태 변경일 (updated_at) — timestamptz

입주자 (building_members)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 사용자.ID — NOT NULL
  • 사용자 ID (user_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 세대 ID (unit_id) — uuid — 외래 키 → 세대 정보.ID — NOT NULL
  • 사용자이메일 (user_email) — text — NOT NULL
  • 역할 (role) — varchar(20) — NOT NULL
  • 대표자 여부 (is_primary_representative) — boolean
  • 입주자 상태 (status) — text
  • 등록일 (created_at) — timestamptz — NOT NULL
  • 상태 변경일 (updated_at) — timestamptz — NOT NULL

청구 주기(월/회차) (bill_cycles)

  • ID (Key) — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 청구 연도 (year) — numeric — NOT NULL
  • 청구 월 (month) — numeric — NOT NULL
  • 청구(연도 월) (year_month) — text
  • 납부 마감일 (due_date) — date
  • 청구 시작일 (period_start) — date
  • 청구 마지막일 (period_end) — date
  • 잠금 여부 (is_locked) — boolean — NOT NULL
  • 청구 상태 (status) — text — NOT NULL
  • 총액 (total_amount) — numeric
  • 생성일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz
  • 첫 발송일 (first_sent_at) — timestamptz

청구 항목 템플릿 - 고정/변동 설정 (bill_item_templates)

  • ID (Key) — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 청구 항목 (name) — text — NOT NULL — 대표자 직접 설정
  • 청구 항목 분류 (category) — text
  • 금액 유형 (amount_type) — text
  • 총액(초기값) (default_amount) — numeric
  • 개월 수/기간 단위(초기값) (default_months) — numeric
  • 부과 방식(초기값) (default_type) — text — allocation_method 겹칠 수 있음을 주의(같지 않음)
  • 특정 세대 IDs (default_target_unit_ids) — uuid
  • 생성일 (created_at) — timestamptz
  • 수정일 (updated_at) — timestamptz

초대 링크 관리 (invitations)

  • ID (Key) — uuid — 기본 키 — NOT NULL
  • 건물 ID (building_id) — uuid — 외래 키 → 건물.ID — NOT NULL
  • 세대 ID (unit_id) — uuid — 외래 키 → 세대 정보.ID — NOT NULL
  • 입주자 이름 (tenant_name) — text — NOT NULL
  • 입주자 연락처 (tenant_phone) — text — NOT NULL
  • 초대 상태 (status) — text
  • 초대 발송일 (invited_at) — timestamptz
  • 초대 수령일 (accepted_at) — timestamptz
  • 생성일 (created_at) — timestamptz
  • 초대 상태 변경일 (updated_at) — timestamptz