건물

정의

건물은 관리 대상이 되는 물리적 구조물입니다. 건물은 여러 개의 호실로 구성될 수 있으며, 각 호실은 개별적인 공간을 나타냅니다.

정보

건물에 대한 정보는 시스템에서 관리되는 다양한 속성으로 구성됩니다. 이 정보들은 건물의 관리, 유지보수, 안전 점검 등 다양한 목적으로 사용됩니다.

다음과 같은 정보들이 포함됩니다:

• 기본 정보: 건물의 고유 식별자, 이름, 주소 등
• 건축물 정보: 층수, 사용 승인일, 총 면적 등
• 시설 정보: 주차장 면적, 주차 면수, 엘리베이터 수 등
• 건축물 원장 정보: 건물 원장에 등록된 경우의 고유 식별자 등
• 관리 정보: 관리비 고지서 발행일 등

다음 정보는 관련된 정보입니다.

• 안전 관리자 정보: 건물의 안전 관리자를 지정하는 정보
• 보험 정보: 건물에 대한 보험 관련 정보
• 호실 정보: 건물 내 개별 호실에 대한 정보

기본정보의 전체적인 구조는 다음과 같습니다:

TypeScript

TypeScript로 보여주는 건물의 인터페이스입니다.

interface Building {
    id: number;
    building_name: string;
    status: "MANAGING" | "SCHEDULED" | "ENDED";
    /** @example 10 */
    invoice_date: number;
    remark?: string;
    road_address: string;
    building_address: string;
    facility: {
        /** @example 200.5 */
        parking_area: number;
        /** @example 50 */
        parking_count: number;
        /** @example 3 */
        elevator_count: number;
    };
    specification: {
        /** @example 5 */
        ground_floor: number;
        /** @example 2 */
        basement_floor: number;
        /**
         * Format: date
         * @example 2023-01-01
         */
        approval_date: string;
        purpose: "OFFICE" | "RESIDENTIAL" | "COMMERCIAL" | "COMPLEX" | "ETC";
        /** @example 500 */
        plat_area: number;
        /** @example 2550 */
        total_area: number;
    };
    ledger_registration: {
        /** @example PK123456789 */
        building_ledger_pk?: string;
        /** @example 5211312100 */
        regal_code?: string;
    };
    /** Format: date-time */
    created_at: string;
    /** Format: date-time */
    updated_at: string;
};

Kotlin

Kotlin으로 보여주는 건물의 데이터 클래스입니다.

data class Building(
    val id: Int,
    val buildingName: String,
    val status: String, // "MANAGING" | "SCHEDULED" | "ENDED"
    val invoiceDate: Int, // 1 ~ 31
    val remark: String? = null,
    val roadAddress: String,
    val buildingAddress: String,
    val facility: Facility,
    val specification: Specification,
    val ledgerRegistration: LedgerRegistration? = null,
    val createdAt: String, // date-time
    val updatedAt: String // date-time
) {
    data class Facility(
        val parkingArea: Double, // m²
        val parkingCount: Int, // 차량 대수
        val elevatorCount: Int // 엘리베이터 수
    )

    data class Specification(
        val groundFloor: Int, // 지상 층수
        val basementFloor: Int, // 지하 층수
        val approvalDate: String, // YYYY-MM-DD 형식
        val purpose: String, // "OFFICE" | "RESIDENTIAL" | "COMMERCIAL" | "COMPLEX" | "ETC"
        val platArea: Double, // m²
        val totalArea: Double // m²
    )

    data class LedgerRegistration(
        val buildingLedgerPk: String? = null, // 건물 원장 PK
        val regalCode: String? = null // 법정코드
    )
}

기본 정보

건물명 (name)

타입: string

설명: 건물의 이름 또는 명칭입니다. (예: “강남 빌딩”, “테헤란로 오피스텔”)

목적: 사용자가 건물을 쉽게 식별하고 검색할 수 있도록 합니다.

주소 (address)

타입: string

설명: 건물의 실제 주소입니다. (예: “서울특별시 강남구 테헤란로 123”)

목적: 건물의 위치를 파악하고, 필요시 지도 연동이나 위치 기반 서비스에 활용될 수 있습니다.

도로명 주소 (road_ㅁddress)

타입: string

설명: 건물의 도로명 주소입니다. (예: “서울특별시 강남구 테헤란로 123”)

목적: 도로명 주소는 행정적, 법적 용도로 사용되며, 우편물 발송이나 공공기관 신고 등에 필요합니다.

상태 (status)

타입: string ("MANAGING" | "SCHEDULED" | "ENDED")

설명: 건물의 관리 상태를 나타냅니다.

• "MANAGING": 현재 관리 중인 건물
• "SCHEDULED": 관리 예정인 건물
• "ENDED": 관리가 종료된 건물 목적: 건물의 관리 상태를 파악하고, 관리 작업(예: 유지보수, 청소 등)을 계획하는 데 사용됩니다.

비고 (remarks)

타입: string

설명: 건물에 대한 추가적인 설명이나 특이사항을 기록하는 필드입니다. 기본값은 빈 문자열입니다.

목적: 표준 속성 외에 관리상 필요한 메모나 정보를 자유롭게 기입하기 위해 사용됩니다.

건축물 정보

지상 층수 (groundFloor)

타입: int

설명: 건물의 지상에 있는 층의 수입니다. (예: 5층 건물은 5)

목적: 건물의 구조적 특성을 이해하고, 관리비 산정, 안전 점검 등의 기준으로 사용됩니다.

지하 층수 (basementFloor)

타입: int

설명: 건물의 지하에 있는 층의 수입니다. (예: 2층 지하 주차장)

목적: 건물의 구조적 특성을 이해하고, 관리비 산정, 안전 점검 등의 기준으로 사용됩니다.

관리상 용도 (purpose)

타입: string ("OFFICE" | "RESIDENTIAL" | "COMMERCIAL" | "COMPLEX" | "ETC")

설명: 건물의 주된 관리 목적상 용도입니다. 법적 건축물 용도와는 다를 수 있으며, 내부 관리 편의를 위해 사용됩니다.

목적: 건물의 특성(예: 상업 시설 중심, 주거 시설 중심)에 따른 관리 방식이나 리포트 분류 등에 활용될 수 있습니다.

사용승인일 (approval_date)

타입: string (YYYY-MM-DD 형식)

설명: 건물이 건축법에 따라 사용 허가를 받은 날짜입니다. (예: “2023-01-02”)

목적: 건물의 법적 요구사항(예: 정기 점검 주기) 확인 등에 기준이 됩니다.

대지 면적 (plat_area)

타입: double (단위: m²)

설명: 건물이 위치한 대지의 면적입니다. (예: 500.0 m²)

목적: 건물의 규모를 나타내며, 관리비 산정, 보험 가입 등 다양한 계산의 기초 자료로 사용됩니다.

연면적 (total_area)

타입: double (단위: m²)

설명: 건물의 총 연면적입니다. (예: 2550.5 m²)

목적: 건물의 전체 규모를 나타내며, 관리비 산정, 보험 가입 등 다양한 계산의 기초 자료로 사용됩니다.

시설 정보

주차장 면적 (parkingArea)

타입: double (단위: m²)

설명: 건물 내 주차 공간의 총 면적입니다.

목적: 주차 관련 관리(주차비 정산, 주차 가능 대수 예측 등) 및 시설 관리에 필요한 정보입니다.

주차 면수 (parkingLots)

타입: int

설명: 건물에 마련된 총 주차 가능 면수입니다.

목적: 건물의 주차 수용 능력을 나타내며, 입주사 또는 방문객 안내에 활용됩니다.

엘리베이터 수 (elevators)

타입: int

설명: 건물에 설치된 엘리베이터(승강기)의 총 개수입니다.

목적: 시설 관리(정기 점검 대상 파악) 및 건물 편의성 지표로 활용됩니다.

건축물 원장 정보

건물 원장 PK (buildingLedgerPk)

타입: string | undefined

설명: 건물이 등록된 원장의 고유 식별자입니다. (예: “PK123456789”)

목적: 건축물대장 api와 연동 시, 건물 정보를 고유하게 식별하기 위해 사용됩니다. 이 값은 선택 사항이며, 건물 원장에 등록된 경우에만 포함됩니다.

법정코드 (regalCode)

타입: string | undefined

설명: 지번 주소에서 지번을 제외한 주소의 코드입니다. (예: “5211312100”)

목적: 건축물대장 api와 연동 시, 건물 정보를 고유하게 식별하기 위해 사용됩니다. 이 값은 선택 사항이며, 건물 원장에 등록된 경우에만 포함됩니다.

관리 정보

예상 고지서 발행일 (invoiceDate)

타입: int (1 ~ 31)

설명: 매달 관리비 고지서가 발행될 것으로 예상되는 날짜입니다. 실제 발행일과 다를 수 있으며, 주로 알림 목적으로 사용됩니다. (예: 15는 매월 15일)

목적: 관리비 정산 및 고지서 발행 일정 관리에 도움을 주기 위한 참고 정보입니다.

관련 데이터 목록

• safetyManagers: SafetyManager[] - 건물에 선임된 안전관리자 목록입니다.
• insurances: Insurance[] - 건물에 가입된 보험 목록입니다.
• roomDetails: RoomDetail[] - 건물 내 각 호실의 상세 정보 목록입니다.