백엔드
청구/수납 서비스 개발기
두줄요약
키친보드는 식자재 시장의 현실에 맞게 청구/수납 서비스를 설계했습니다.\n미납금, 청구 없이 수납되는 상황, 대량 알림 전송 제약을 고려해 관계를 느슨하게 풀어냈습니다.
문제 상황
- 청구/수납 서비스를 새로 만들면서 기존 카카오톡·문자 기반 업무 흐름을 해치지 않는 요구사항 정리 필요
- 가상계좌 청구, 미납금 관리, 청구 없이 수납되는 상황 등 일반적인 청구/수납과 다른 현실적 제약 존재
- 다수 매장에 청구 메시지를 동시에 발송할 때 Sendbird Platform API의 초당 요청 제한으로 실패 가능성 발생
원인 분석
- 식자재 유통 환경에서는 청구 금액과 실제 수납 금액이 반드시 일치하지 않음
- ERP의 미납금을 키친보드가 정확히 동기화·추적하기 어려워, 청구 종료 시점과 미납금 계산이 모호함
- 채팅 알림이 매장별 청구 금액·계좌 정보에 맞춰 달라야 해서 일괄 공지 메시지로 대체하기 어려움
해결 방법
- 미납금 자동 관리 대신 고객이 청구 금액을 직접 입력하는 방식으로 자유도 확대
- 청구서 생명주기를 다음 청구서 생성 시점까지로 두어 만료 시점을 우회 처리
- 청구와 수납의 관계를 느슨하게 설계하고, 활성 청구서가 있을 때만 선택적으로 연결
- 대량 메시지 발송 이슈는 Sendbird 제약을 고려해 별도 처리 방안을 검토
