농산물 직거래 중개 플랫폼

구매자가 첫 화면에서 지금 바로 살 수 있는 상품과 수확 일정에 맞춰 미리 주문하는 예약 상품을 나란히 보고, 카테고리와 판매 방식으로 걸러 상품 상세까지 이동합니다.

• 판매 방식(즉시·예약)과 카테고리를 쿼리 파라미터로 저장해 새로고침과 공유 링크에서도 같은 목록을 복원하는 필터 구조 구현
• 상품과 농가를 한 번에 조회하는 Prisma 관계 쿼리와 커서 기반 목록 페이지네이션 설계
• 예약 상품의 수확 예정일과 마감일을 상품 상세에 계산해 표시하는 판매 방식 컴포넌트 구현

상품 단위로 판매 방식과 예약 마감 정보를 한 모델에 담아, 같은 상품 카드가 즉시 구매 버튼과 예약 구매 버튼 중 맞는 쪽으로 바뀌도록 구현합니다.

구매자가 즉시 구매 상품은 바로 결제하고, 예약 구매 상품은 사전 주문으로 결제하는 두 흐름을 한 장바구니에서 구분해 진행합니다.

• 장바구니를 농가·판매 방식 단위로 묶어 주문서를 나누고 합계와 배송비를 서버에서 다시 계산하는 구조 구현
• 토스페이먼츠 결제 승인 API를 서버에서 호출하고 금액 일치를 확인한 뒤 주문 상태를 확정하는 흐름 설계
• 예약 주문에 결제 시점과 환불 규정을 주문 레코드로 저장해 마이페이지와 관리 콘솔이 같은 값을 읽도록 모델링

클라이언트가 보낸 금액을 믿지 않고 승인 단계에서 서버 계산 금액과 대조하는 결제 확정 흐름을 구현해, 즉시 구매와 예약 구매가 같은 승인 로직을 공유하도록 설계합니다.

구매자가 마음에 든 농가를 팔로우하고, 팔로우한 농가의 새 상품과 예약 오픈 소식을 모아 봅니다. 농가 프로필 화면, 팔로우·해제 토글, 팔로우 농가 목록과 농가별 신규 상품 묶음 구조를 설계합니다.

• 구매자와 농가의 팔로우 관계를 별도 테이블로 두고 토글 요청을 낙관적 업데이트로 반영하는 구조 구현
• 팔로우한 농가의 신규 상품을 최근 등록순으로 묶어 조회하는 복합 인덱스 쿼리 설계
• 팔로우 해제는 묻지 않고 처리하고 되돌리기 토스트로 복구하는 흐름 구현

팔로우 관계 하나로 농가 프로필, 팔로우 목록, 신규 상품 묶음이 모두 갱신되도록 같은 상태를 공유하게 구현합니다.

구매자가 주문 내역과 예약 내역을 탭으로 나눠 보고, 배송 상태와 예약 상품의 수확·발송 예정을 확인합니다.

• 주문 상태를 결제 완료·상품 준비·출고·배송 완료로 정의하고 상태 전이 규칙을 서버에서 검증하는 모델 구현
• 주문과 예약을 하나의 주문 테이블에서 판매 방식 컬럼으로 구분해 탭별로 조회하는 쿼리 설계
• 취소 가능한 상태에서만 취소 버튼을 노출하고 취소 시 PG 취소 API 호출과 주문 상태 갱신을 한 흐름으로 처리

주문 상태 전이 규칙을 서버 한 곳에 두어, 구매자 화면의 취소 버튼 노출과 농가 오피스의 출고 처리가 같은 규칙을 따르도록 구현합니다.