아파트 정기배송 계란 주문 서비스

입주민이 첫 화면에서 우리 아파트의 모집 상태와 목표 대비 참여 세대수, 다음 배송일과 주문 마감 시각을 한 화면에서 봅니다.

• 아파트별 모집 상태를 상태 머신으로 정의하고 화면 문구와 버튼이 상태에서 파생되도록 구현
• 동·호수 단위 참여 신청의 중복 세대 집계 방지를 DB 유니크 제약과 서버 검증으로 구현
• 공유 링크와 QR 생성을 아파트 식별 코드 기반으로 구성

참여 세대수 집계를 세대 단위 유니크 키로 계산해, 같은 세대의 중복 신청이 목표 달성 수치에 반영되지 않도록 구현합니다.

입주민이 이번 회차 상품의 규격·포장 단위·보관 방법을 확인하고 장바구니에 담아 주문서를 작성합니다. 결제 전 배송일·수령 방식·배송비·마감 시각을 한 번 더 확인합니다.

• 회차별 판매 상품과 공급 한도를 조회해 한도 초과 수량의 장바구니 담기를 서버에서 차단
• 주문 확정 시 재고 차감과 결제 요청 생성을 하나의 트랜잭션으로 묶어 중복 주문 방지
• 결제 연동은 PG 테스트 환경 기준 결제 요청·승인·웹훅 흐름으로 구성

마감 시각과 공급 한도를 서버 시간 기준으로 검증해, 화면이 열려 있는 동안 마감이 지나도 주문이 접수되지 않도록 구현합니다.

입주민이 주문 내역에서 배송 진행 상태를 확인하고 문 앞 배송 요청사항을 남깁니다. 매장 수령 주문은 주문번호 확인 화면으로 수령 상태를 확인합니다.

• 주문 상태를 접수·준비·배송 중·완료 단계로 정의하고 상태 변경 이력을 기록하는 구조 설계
• 매장 수령 확인 화면에서 주문번호 조회와 전달 완료 상태가 서버 값으로 표시되도록 구현
• 다시 담기 시 현재 가격과 재고를 재조회해 변경된 항목을 안내하는 로직 구현

배송 상태와 매장 수령 상태를 같은 주문 상태 모델로 관리해, 입주민 화면과 운영 화면이 같은 값을 보도록 구성합니다.

입주민이 마감 전에는 주문을 변경·취소하고, 마감 후에는 처리 기준 안내를 확인합니다. 파손·누락 문제는 사진을 첨부해 문의하고 부분 환불 결과를 확인합니다.

• 마감 시각 기준으로 변경·취소 가능 여부를 서버가 판정하고 화면 버튼 상태를 응답값으로 제어
• 문의 사진 첨부를 업로드 용량·형식 검증과 함께 구성
• 부분 환불 금액을 상품 단위로 계산해 환불 안내 문구에 그대로 표시

취소·환불 결과를 주문 이력에 남겨 입주민이 문의 내역에서 처리 결과를 그대로 확인하도록 구현합니다.