호실 번호 (name)
타입: string
설명: 해당 호실을 식별하는 번호 또는 명칭입니다. (예: “101호”, “B203호”, “상가 A동 102호”)
목적: 사용자가 특정 호실을 쉽게 찾고 관리하기 위해 필요합니다. 고지서 발급 등에도 사용됩니다.
호실
RoomDetail 인터페이스는 건물 내 개별 호실(사무실, 상가, 주거 공간 등)의 상세 정보를 정의합니다.
호실은 건물 내에서 독립적으로 구분되어 사용되거나 임대될 수 있는 개별 공간 단위를 의미합니다. 각 호실은 고유한 번호, 면적, 용도 등의 정보를 가집니다.
TypeScript로 보여주는 호실의 인터페이스입니다.
interface RoomDetail { name: string; // 호실 번호 buildingId: Long; // 건물 ID floor: number; // 층수 private_area: number; // 전용 면적 (m²) shared_area: number; // 공용 면적 (m²) parking_area: number; // 주차 면적 (m²) purpose: "OFFICE" | "STORE" | "RESIDENTIAL" | "WAREHOUSE" | "ETC"; // 호실 용도 has_electric_meter?: boolean; // 별도 전기 계량기 필요 여부 has_water_meter?: boolean; // 별도 수도 계량기 필요 여부 has_gas_meter?: boolean; // 별도 가스 계량기 필요 여부}Kotlin으로 보여주는 호실의 데이터 클래스입니다.
data class RoomDetail( val name: String, // 호실 번호 val buildingId: Long, // 건물 ID val floor: Int, // 층수 val privateArea: Double, // 전용 면적 (m²) val sharedArea: Double, // 공용 면적 (m²) val parkingArea: Double, // 주차 면적 (m²) val purpose: String, // 호실 용도 ("OFFICE", "STORE", "RESIDENTIAL", "WAREHOUSE", "ETC") val hasElectricMeter: Boolean? = null, // 별도 전기 계량기 필요 여부 val hasWaterMeter: Boolean? = null, // 별도 수도 계량기 필요 여부 val hasGasMeter: Boolean? = null // 별도 가스 계량기 필요 여부)건물 ID (buildingId)
타입: number
설명: 해당 호실이 속한 건물의 고유 식별자입니다. 이 값은 건물 관리 시스템에서 호실을 특정 건물과 연결하는 데 사용됩니다.
목적: 호실 정보를 건물 정보와 연동하여 관리하기 위해 필요합니다.
층수 (floor)
타입: number
설명: 해당 호실이 위치한 층의 번호입니다. 1층부터 시작하여 음수는 지하층을 나타냅니다.
목적: 호실의 위치를 파악하고, 건물 내 층별 관리 및 안내에 사용됩니다.
전용 면적 (private_area)
타입: number (단위: m²)
설명: 해당 호실의 소유자 또는 임차인이 배타적으로 사용하는 공간의 면적입니다.
목적: 임대료 산정, 관리비 배분, 면적 대비 효율 분석 등의 기초 자료로 사용됩니다.
공용 면적 (shared_area)
타입: number (단위: m²)
설명: 건물의 복도, 계단, 로비 등 여러 호실이 공동으로 사용하는 공간 중 해당 호실에 배분된 면적입니다.
목적: 관리비 배분, 건물 전체 면적 대비 비율 계산 등에 사용됩니다.
주차 면적 (parking_area)
타입: number (단위: m²)
설명: 해당 호실에 할당된 주차 공간의 면적입니다. 주차 공간이 없는 경우 0으로 설정됩니다.
목적: 주차 공간 관리 및 주차 요금 산정에 사용됩니다. 주차 공간이 있는 호실과 없는 호실을 구분하는 데 필요합니다.
호실 용도 (purpose)
타입: "OFFICE" | "STORE" | "RESIDENTIAL" | "WAREHOUSE" | "ETC"
설명: 해당 호실의 주된 사용 목적 또는 계약상 용도입니다.
목적: 호실의 특성에 따른 관리(예: 상가 업종 관리, 주거 시설 민원 처리) 및 통계 분석에 활용됩니다.
별도 전기 계량기 필요 여부 (has_electric_meter)
타입: boolean
설명: 해당 호실이 독립적인 전기 사용량 측정을 위한 별도 계량기를 필요로 하는지 여부를 나타냅니다. true이면 별도 계량기가 필요(또는 설치됨)를 의미합니다.
목적: 개별 전기 요금 부과 및 계량기 관리 필요 여부를 판단하는 데 사용됩니다.
별도 수도 계량기 필요 여부 (has_water_meter)
타입: boolean
설명: 해당 호실이 독립적인 수도 사용량 측정을 위한 별도 계량기를 필요로 하는지 여부를 나타냅니다. true이면 별도 계량기가 필요(또는 설치됨)를 의미합니다.
목적: 개별 수도 요금 부과 및 계량기 관리 필요 여부를 판단하는 데 사용됩니다.
별도 가스 계량기 필요 여부 (has_gas_meter)
타입: boolean
설명: 해당 호실이 독립적인 가스 사용량 측정을 위한 별도 계량기를 필요로 하는지 여부를 나타냅니다. true이면 별도 계량기가 필요(또는 설치됨)를 의미합니다.
목적: 개별 가스 요금 부과 및 계량기 관리 필요 여부를 판단하는 데 사용됩니다.