관리비 확정

‘관리비 확정’ 단계 이후, 관리자가 산출된 내역을 검토하고 최종적으로 ‘확정’하는 작업에 대한 백엔드 처리를 정리해 드리겠습니다.

1. 요청 수신 및 유효성 검사:

   • 프론트엔드로부터 특정 년월(YYYY-MM)에 대한 관리비 ‘확정’ 요청을 받습니다.
   • 해당 청구월의 상태가 ‘산출 완료’ 또는 ‘확정 대기’ 상태인지 확인합니다. (이미 확정된 월은 다시 확정할 수 없음)
   • 확정 권한이 있는 사용자의 요청인지 확인합니다.
   • 유효성 검사에 실패하면 오류 메시지를 반환합니다.

2. 데이터 확정 처리:

   • 해당 청구월(YYYY-MM) 관리 레코드의 상태를 **‘확정(Finalized)‘**으로 업데이트합니다.
   • 이 시점 이후로는 해당 청구월의 ‘검침 및 비용 입력(3-1)’ 및 ‘관리비 산출(3-2)’ 데이터는 수정이 불가능하도록 잠금(Lock) 처리합니다. 이는 확정된 데이터의 무결성을 보장하기 위함입니다.
   • 확정된 각 호실별(또는 통합 청구 단위별) 최종 납부 금액 및 해당 월의 미납/과납 발생액(최종 납부 금액 - 실제 수납액, 초기에는 납부 전이므로 최종 납부 금액이 미납액이 됨) 정보를 다음 달 이월을 위해 명확히 기록하거나 관련 원장(Ledger) 테이블에 반영 준비를 합니다.

3. 후속 작업 트리거 (선택 사항):

   • 관리비가 확정되었으므로, ‘부과내역 관리 및 고지(3-3)’ 단계에서 부과내역서(고지서) 생성이 가능하도록 관련 플래그를 활성화하거나 알림을 보낼 수 있습니다.
   • 회계 시스템 연동이 필요한 경우, 확정된 데이터를 회계 시스템으로 전송하거나 전송 준비 상태로 만들 수 있습니다.

4. 작업 로그 기록:

   • 관리비 확정 작업에 대한 로그(작업자, 확정 시간 등)를 상세히 기록하여 감사 추적이 가능하도록 합니다.

5. 응답 전송:

   • 모든 처리가 성공적으로 완료되면, 프론트엔드에 성공 메시지를 반환합니다. 사용자는 확정된 상태를 확인하고 다음 단계인 ‘부과내역 관리 및 고지’ 작업을 진행할 수 있습니다.

요약하면, ‘관리비 확정’ 백엔드 처리는 계산된 데이터를 최종 상태로 만들고, 데이터 변경을 방지하며, 다음 단계(고지 및 수납)를 위한 준비를 하는 과정입니다.