년월 (yearMonth)
타입: string
설명: 청구월이 속한 연도와 월을 나타냅니다. 예를 들어, 2023년 10월은 “2023-10”로 표현됩니다.
목적: 상태를 청구월로 구분하기 위해 필요합니다. 이 값은 청구월의 식별자로 사용됩니다.
청구월은 특정 기간 동안 발생한 관리비를 청구하기 위한 기준이 되는 월을 의미합니다.
이 월은 관리비 부과 및 수납의 기준이 됩니다.
항상 다음과 같은 형식으로 작성됩니다:
YYYY-MMTypeScript로 보여주는 청구월의 인터페이스입니다.
interface BillingMonth { yearMonth: string; // 청구월 (YYYY-MM) status: "prepare" | "process" | "complete"; // 상태 ("prepare" | "process" | "complete")}Kotlin으로 보여주는 청구월의 데이터 클래스입니다.
data class BillingMonth( val yearMonth: String, // 청구월 (YYYY-MM) val status: String, // 상태 ("prepare" | "process" | "complete"))년월 (yearMonth)
타입: string
설명: 청구월이 속한 연도와 월을 나타냅니다. 예를 들어, 2023년 10월은 “2023-10”로 표현됩니다.
목적: 상태를 청구월로 구분하기 위해 필요합니다. 이 값은 청구월의 식별자로 사용됩니다.
상태 (status)
타입: "prepare" | "process" | "complete"
설명: 청구월의 현재 상태를 나타냅니다. 아래에서 상태별 의미를 설명합니다.
목적: 청구월의 청구의 관리를 위해 필요합니다. 상태에 따라 청구월에서 수행할 수 있는 작업이 달라집니다.
청구월은 다음 네 가지 상태로 구분됩니다:
prepare: 관리비 부과를 준비하는 상태process: 고시서 발행을 완료해서 수납을 기다리는 상태complete: 청구월이 최종적으로 마감된 상태각 상태는 다음과 같은 의미를 가집니다:
prepare관리비 부과를 준비하는 상태입니다.
이 상태에서는 호실별로 계량기 지침을 입력할 수 있고 청구월의 관리비 항목을 설정할 수 있습니다.
산출 단계에서는 청구월에 대한 관리비를 계산하고 검토합니다.
사용자에게 기대되는 워크플로우는 다음과 같습니다.
flowchart TD
A[검침/비용 입력] --> B[산출]
B --> C[검토/확정]
C -->|오류 발견시| A
C -->|확정 완료| D[고지/수납 상태 전환]
style A fill:#e1f5fe
style B fill:#f3e5f5
style C fill:#fff3e0
style D fill:#e8f5e8
검침/비용 입력: 담당자는 다음과 같은 데이터를 입력합니다.
산출: 입력된 검침 데이터와 비용 데이터를 바탕으로 관리비를 산출합니다.
process처리 단계에서는 산출된 관리비를 바탕으로 고지서를 발행하고 수납을 진행합니다. 고지/수납 단계라고도 불립니다.
사용자에게 기대되는 워크플로우는 다음과 같습니다.
flowchart TD
A[고지서 발행] --> B[수납]
B --> C[수납 완료]
style A fill:#e1f5fe
style B fill:#f3e5f5
style C fill:#e8f5e8
complete로 변경됩니다. 이 상태에서는 더 이상 데이터 수정이 제한됩니다.complete청구월이 최종적으로 마감된 상태입니다.
모든 검침 데이터 입력, 관리비 계산, 고지서 발행 등의 작업이 완료된 상태입니다.