이슈

정의

이슈는 관리 현장에서 발생하는 다양한 시설 민원을 기록하고, 처리 상태 및 이력을 관리하는 데이터입니다.
각 이슈는 건물, 담당자, 처리 내역 등과 연계되어 관리 효율성을 높입니다.

정보

이슈는 다음과 같은 주요 속성으로 구성됩니다.

기본 정보: 고유 식별자, 제목, 설명, 생성일 등
상태 정보: 처리 상태(접수, 진행중, 완료, 긴급 등), 우선순위
담당자 정보: 담당자 지정 및 미배정 상태
이력 정보: 처리 내역, 처리자, 처리 일시 등

예시: “엘리베이터 고장” 이슈가 접수되어 담당자가 배정되고, 처리 이력이 기록됨

interface Issue {
    id: number;
    building_id: number;
    title: string;
    description: string;
    status: "RECEIVED" | "IN_PROGRESS" | "COMPLETED";
    priority: "LOW" | "MEDIUM" | "HIGH";
    assigneeId: Long | null;
    created_at: string; // date-time
    updated_at: string; // date-time
    histories: {
        content: string;
        created_at: string; // date-time
        handlerId: Long;
    }[];
}

data class Issue(
    val id: Int,
    val buildingId: Int,
    val title: String,
    val description: String,
    val status: String, // "RECEIVED" | "IN_PROGRESS" | "COMPLETED"
    val priority: String, // "LOW" | "MEDIUM" | "HIGH"
    val assigneeId: Long? = null,
    val createdAt: String, // date-time
    val updatedAt: String, // date-time
    val histories: List<History>
) {
    data class History(
        val content: String,
        val createdAt: String, // date-time
        val handlerId: Long
    )
}

기본 정보

제목 (title)

타입: string

설명: 이슈의 제목입니다. (예: “엘리베이터 고장”, “관리비 문의”)

목적: 이슈를 한눈에 식별하고 분류할 수 있도록 합니다.

설명 (description)

타입: string

설명: 이슈에 대한 상세 설명입니다.

예시: “3호기 엘리베이터에서 운행 중 소음이 발생합니다. 특히 10층에서 15층 사이에서 소음이 심합니다. 입주민들의 불편 신고가 있었습니다.”

목적: 이슈의 원인, 상황, 요청사항 등 구체적 내용을 기록합니다.

건물 ID (building_id)

타입: number

설명: 이슈가 발생한 건물의 고유 식별자입니다.

목적: 이슈와 건물을 연계하여 관리합니다.

상태 및 우선순위

상태 (status)

타입: string ("RECEIVED" | "IN_PROGRESS" | "COMPLETED")

설명: 이슈의 현재 처리 상태입니다.

"RECEIVED": 접수됨
"IN_PROGRESS": 처리 중
"COMPLETED": 처리 완료

목적: 이슈의 진행 상황을 파악하고, 우선 처리 대상을 구분합니다.

예시: "IN_PROGRESS" 상태의 이슈만 대시보드에 강조 표시

우선순위 (priority)

타입: string ("LOW" | "MEDIUM" | "HIGH")

설명: 이슈의 중요도 또는 처리 우선순위입니다.

목적: 처리 순서 결정 및 자원 배분에 활용됩니다.

예시: "HIGH" 우선순위 이슈는 알림 배지로 표시

담당자 (assigneeId)

타입: Long | null 설명: 이슈를 처리하는 주 담당자의 ID입니다. 미배정 시 null입니다.

목적: 담당자 지정 및 미배정 상태를 명확히 관리합니다. 알림 용도로 사용될 수 있습니다.

이력 정보

이력 (histories)

타입: { content: string; created_at: string; handlerId: Long; }[]

설명: 이슈 처리 내역의 목록입니다. 각 이력에는 아래 정보가 포함됩니다.

content: 처리 내용 (예: “엘리베이터 수리 완료”, “업체에 점검 요청”)
created_at: 처리 일시 (date-time)
handlerId: 처리자 ID (담당자와 연결). 실제 처리 담당자를 식별합니다.

목적: 처리 과정을 투명하게 기록하고, 추후 이슈 재발 시 참고 자료로 활용합니다.

예시: 처리 이력이 누적되어 이슈 해결 과정을 한눈에 파악할 수 있음

기타 정보

생성일 (created_at)

타입: string (date-time)

설명: 이슈가 최초 등록된 일시입니다.

수정일 (updated_at)