농가 오피스·마스터 관리 콘솔

농가 담당자가 오늘 확인할 일반 주문과 예약 주문, 출고 대기 건을 한 화면에서 보고 송장 번호를 입력해 출고 처리합니다.

• 주문을 농가 단위로 격리 조회하는 서버 필터와 역할 검증 미들웨어 구현
• 출고 처리 시 송장 번호 저장과 주문 상태 전이를 하나의 트랜잭션으로 묶는 구조 설계
• 예약 주문을 수확 예정일 순으로 정렬해 출고 대기 목록과 분리해 보여 주는 쿼리 구현

농가 계정은 자기 상품의 주문만 읽도록 서버에서 소유 농가를 검증해, 같은 주문 테이블을 구매자·농가·관리자가 서로 다른 범위로 보도록 구현합니다.

농가 담당자는 상품 정보와 가격·재고, 판매 방식을 직접 등록하고, 마스터 관리자는 직접 등록이 어려운 농가를 대신해 상품을 등록하며 대리 등록 표시가 남습니다.

• 상품 등록자와 소유 농가를 별도 컬럼으로 저장해 대리 등록 여부를 이력으로 남기는 모델 설계
• 판매 방식에 따라 예약 마감일·수확 예정일 입력란이 나타나는 조건부 폼과 제출 시 검사 구현
• 상품 이미지를 업로드 전에 크기 검증하고 S3 호환 저장소에 저장하는 업로드 흐름 설계

등록자 역할과 소유 농가를 분리해 저장하여, 관리자의 대리 등록 상품에도 농가 본인 상품과 같은 권한 규칙이 적용되도록 구현합니다.

마스터 관리자가 농가의 입점 신청을 서류 내용과 함께 검토해 승인하거나 반려하고, 승인된 농가 계정의 상태를 관리합니다.

• 입점 신청 상태를 대기·승인·반려로 정의하고 상태 변경 이력을 감사 테이블에 남기는 구조 구현
• 반려는 사유 입력을 필수로 하고 승인은 되돌리기 토스트를 제공하는 처리 흐름 설계
• 마스터 관리자 역할에만 승인 API를 열어 두는 역할 기반 라우트 검증 구현

승인·반려 결과를 신청 레코드와 농가 계정 상태에 한 번에 반영하는 트랜잭션을 구성해, 승인된 농가만 오피스 메뉴가 열리도록 구현합니다.

마스터 관리자가 기간을 정해 농가별 판매 금액을 집계해 보고 수동 정산에 쓸 엑셀 파일로 내려받습니다. 정산 자동화는 확장 로드맵 항목으로 안내합니다.

• 기간 조건으로 농가별 판매 금액을 집계하고 취소·환불 건을 차감하는 SQL 집계 쿼리 구현
• ExcelJS로 농가별 시트와 합계 행을 가진 엑셀 파일을 서버에서 생성하는 다운로드 API 설계
• 대량 기간 조회는 Redis에 집계 결과를 짧게 보관해 같은 조건의 재조회를 줄이는 캐시 구조 적용

화면의 집계 표와 엑셀 파일이 같은 집계 쿼리를 쓰도록 구성해, 화면에서 본 금액과 내려받은 파일의 금액이 어긋나지 않게 구현합니다.