관리비 산출

‘관리비 산출’ 단계에서 백엔드가 수행하는 주요 처리 과정을 정리해 드리겠습니다. 이 단계는 사용자가 ‘검침 및 비용 입력’을 완료하고 계산 시작을 요청했을 때 실행됩니다.

요청 수신 및 유효성 검사:
- 프론트엔드로부터 특정 년월(YYYY-MM)에 대한 관리비 산출 요청을 받습니다.
- 해당 청구월의 상태가 ‘검침/비용 입력 완료’ 또는 ‘산출 대기’ 상태인지 확인합니다.
- 계산에 필요한 모든 데이터(검침값, 고지서 정보 등)가 정상적으로 입력되었는지 기본적인 검증을 수행합니다.
- 유효성 검사에 실패하면 오류 메시지를 반환합니다.
데이터 로딩:
- 해당 청구월(YYYY-MM)에 연결된 기준 정보 스냅샷을 로드합니다. (관리비 항목, 배분 기준, 단가/처리 규칙, 통합 청구 설정 등)
- ‘검침 및 비용 입력’ 단계에서 입력된 데이터를 로드합니다.
  - 모든 호실의 계량기 검침 정보 (전월/당월 지침, 검침 기간)
  - 입력된 외부 고지서 정보 (총 금액, 총 사용량, 사용 기간, 비과세 금액 등)
  - 입력된 고정 비용 및 기타 월별 부과금액 정보
- ‘청구월 생성’ 시 준비된 각 호실(또는 통합 청구 단위)의 전월 미납/정산액 정보를 로드합니다.
개별 사용료 계산 (호실별):
- 모든 호실을 순회하며 개별 사용료 항목(전기, 수도, 가스 등)을 계산합니다.
- 각 항목에 대해 기준 정보 스냅샷에 정의된 계산 방식(예: 평균 단가 방식, 직접 단가 적용)을 확인합니다.
- 평균 단가 방식 적용 시 (예: 전기료):
  - 관련 외부 고지서 정보(총 금액, 총 사용량, 비과세액 등)를 가져옵니다.
  - 평균 단가 = 고지서 총 부과 금액 / 고지서 총 사용량 공식을 사용하여 평균 단가를 계산합니다.
  - 세대별 총 추정 사용료 = 세대별 사용량 (검침 기간 기준) * 평균 단가 공식을 사용하여 세대별 총 추정 사용료를 계산합니다.
  - (해당 시) 비과세 항목(예: 전력기금)이 있다면, 세대별 배분 비과세액 = 총 비과세액 * (세대별 사용량 / 건물 총 사용량) 공식을 사용하여 세대별 비과세액을 계산합니다. (건물 총 사용량 미파악 시 다른 기준 적용)
  - 세대별 과세 대상 사용료 = 세대별 총 추정 사용료 - 세대별 배분 비과세액 공식을 사용하여 최종 과세 대상 사용료를 계산합니다.
  - 계산된 과세 대상 사용료와 비과세액을 해당 호실의 해당 항목 데이터로 저장합니다.
- 직접 단가 적용 시:
  - 기준 정보 스냅샷에서 해당 항목의 단가(요금 테이블)를 가져옵니다.
  - 호실의 사용량과 단가 테이블을 이용하여 요금을 계산하고 저장합니다.
공용 관리비 총액 계산:
- 공용 관리비 항목(공용 전기료, 공용 수도료, 일반관리비, 경비비 등)별로 해당 월의 총 부과 금액을 계산/확정합니다.
- 평균 단가 방식 적용 항목 (예: 공용 전기료):
  - 3단계에서 계산된 평균 단가와 건물 전체 사용량(방법 A) 또는 고지서 총액과 세대별 추정 사용료 합계(방법 B)를 이용하여 공용 사용료 총액(추정)을 계산합니다.
  - (해당 시) 비과세 항목(예: 공용 전력기금) 총액을 계산합니다 (총 비과세액 - 모든 세대별 배분 비과세액 합계).
  - 과세 대상 공용 사용료를 계산합니다 (공용 사용료 총액(추정) - 공용 배분 비과세액).
  - 계산된 과세 대상 공용 사용료 총액과 공용 비과세액 총액을 저장합니다.
- 고정 비용 또는 직접 입력 항목 (예: 일반관리비, 경비비):
  - ‘검침 및 비용 입력’ 단계에서 입력/확인된 금액을 해당 항목의 총 부과 금액으로 확정하고 저장합니다.
공용 관리비 및 기타 부과금액 배분 (호실별):
- 4단계에서 계산/확정된 각 공용 관리비 항목 총액(과세/비과세 구분)과 입력된 기타 부과금액(장기수선충당금 등) 총액을 기준 정보 스냅샷에 정의된 배분 기준(예: 면적 비율, 균등 분할)에 따라 각 호실에 배분합니다.
- 배분된 금액을 해당 호실의 해당 항목 데이터로 저장합니다.
최종 납부 금액 계산 (호실별):
- 각 호실별로 다음 항목들을 모두 합산합니다.
  - 계산된 모든 개별 사용료 (과세 + 비과세)
  - 배분된 모든 공용 관리비 (과세 + 비과세)
  - 배분된 모든 기타 부과금액
- 합산된 금액에 해당 호실의 전월 미납/정산액을 가감하여 최종 ‘납부하실 금액’을 계산합니다.
- 계산된 최종 납부 금액을 해당 호실 데이터로 저장합니다.
통합 청구 대상 집계:
- 기준 정보 스냅샷의 통합 청구 설정을 확인하여, 동일한 청구 대상(Billing Entity)으로 묶인 호실들을 식별합니다.
- 각 통합 청구 대상별로 해당되는 모든 호실의 최종 납부 금액을 합산하여 통합 청구 총액을 계산하고 저장합니다.
상태 업데이트 및 로그 기록:
- 해당 청구월 관리 레코드의 상태를 ‘산출 완료’ 또는 ‘확정 대기’ 등으로 업데이트합니다.
- 관리비 산출 작업에 대한 상세 로그(실행 시간, 성공 여부, 주요 계산 결과 요약 등)를 기록합니다.
결과 반환:
- 모든 계산이 성공적으로 완료되면, 프론트엔드에 성공 메시지를 반환합니다. 이로써 관리자는 ‘검토 및 확정’ 단계로 진행하여 산출된 내역(총괄 부과표 등)을 확인할 수 있습니다.

이 과정을 통해 백엔드는 입력된 데이터를 바탕으로 복잡한 관리비 계산 로직을 수행하고, 각 세대(및 통합 청구 단위)별 최종 부과 금액을 정확하게 산출합니다.