프로젝트 개요
MVP 이후 점포 운영자가 쓰게 될 운영 콘솔 확장 프로젝트입니다. 아파트 모집·개시 승인, 배송 회차, 주문·환불, 생산·포장 집계, 배송 명단을 한 콘솔에서 처리하며 역할별로 보이는 메뉴와 개인정보 범위가 달라지는 구조를 제안합니다.
작업 범위
- 모집·개시 승인: 운영자가 첫 화면에서 아파트별 모집 현황을 보고 목표를 달성한 아파트의 서비스 개시를 승인합니다. 참여 신청 세대수와 실제 구매 세대수를 구분해 확인합니다
- 배송 회차·주문: 운영자가 배송 요일·주문 마감·휴무일을 설정하고 회차별 판매 상품과 공급 한도를 관리합니다. 회차의 주문 목록에서 결제·취소·부분 환불을 처리하고 변경 이력을 확인합니다
- 생산·포장 집계: 운영자가 확정 주문량으로 상품별 총 계란 개수를 계산하고 배송분과 매장 수령분을 구분한 준비 수량을 확인합니다. 작업표를 출력하거나 엑셀로 내려받고 산란·선별·포장 정보를 등록합니다
- 배송 명단·권한: 운영자가 아파트·동별 배송 명단을 만들어 담당자를 배정하고 매장 수령 주문의 전달 완료를 처리합니다. 역할별로 볼 수 있는 메뉴와 개인정보 범위가 달라집니다
주요 업무
- 모집·개시 승인 화면: 처리할 일 카드, 아파트별 모집 표, 참여 신청·구매 세대 구분 표시, 개시 승인 대화상자, 담당 점포 연결 구조를 설계합니다
- 배송 회차·주문 화면: 회차 달력, 회차 상세 설정, 상품별 공급 한도 표, 주문 목록과 필터, 환불 처리 대화상자, 마감 후 변경 이력 구조를 설계합니다
- 생산·포장 집계 화면: 상품별 집계 표, 배송·매장 수령 준비 수량 구분, 작업표 미리보기, 엑셀 다운로드, 산란·선별·포장 등록 폼, 최근 판매 추이 차트 구조를 설계합니다
- 배송 명단·권한 화면: 배송 명단 표, 담당자 배정 대화상자, 매장 수령 전달 처리, 역할 전환별 메뉴 변화와 접근 제한 안내 구조를 설계합니다



프로젝트 핵심 과제
주문 변경·환불이 생산·포장·배송 자료에 어긋남 없이 반영되
단일 주문 데이터 기준 집계 구조 설계 필요
담당자별 개인정보 접근 범위를 역할로 나누는 정책이 바뀔 수
설정 가능한 권한 구조 설계 필요
점포별 생산 방식이 달라질 수
산란·선별·포장 등록 항목을 확장 가능한 형태로 설계 필요
배송 회차 휴무·일정 변경 시 안내와 취소 처리를 회차 단위로 일괄 적용하는 흐름 설계
핵심 기능 상세
모집·개시 승인
운영자가 첫 화면에서 아파트별 모집 현황을 보고 목표를 달성한 아파트의 서비스 개시를 승인합니다. 참여 신청 세대수와 실제 구매 세대수를 구분해 확인합니다.
- 참여 신청 세대수와 구매 세대수를 별도 집계 쿼리로 분리해 승인 판단 지표를 구성
- 개시 승인 시 아파트 상태 변경과 첫 배송 회차 생성을 한 트랜잭션으로 처리
- 점포와 아파트의 담당 연결을 관리 화면에서 변경하고 변경 이력을 기록
개시 승인 조건을 목표 세대수와 구매 세대수 기준으로 서버가 판정해, 조건 미달 아파트는 승인 버튼이 비활성화되도록 구현합니다.


배송 회차·주문
운영자가 배송 요일·주문 마감·휴무일을 설정하고 회차별 판매 상품과 공급 한도를 관리합니다. 회차의 주문 목록에서 결제·취소·부분 환불을 처리하고 변경 이력을 확인합니다.
- 회차 설정(요일·마감·한도)을 회차 테이블로 분리하고 변경 시 영향 범위를 미리 계산해 안내
- 부분 환불을 상품 단위로 처리하고 결제 취소 요청과 주문 이력을 함께 기록
- 마감 후 주문 변경을 사유 필수 입력과 변경 이력 기록으로 제한
회차별 주문 변경이 생산·포장·배송 자료에 바로 반영되도록 같은 주문 데이터를 공유하는 구조로 구성합니다.


생산·포장 집계
운영자가 확정 주문량으로 상품별 총 계란 개수를 계산하고 배송분과 매장 수령분을 구분한 준비 수량을 확인합니다. 작업표를 출력하거나 엑셀로 내려받고 산란·선별·포장 정보를 등록합니다.
- 확정 주문을 상품 규격(구 수)으로 환산해 총 계란 개수를 집계하는 쿼리 구성
- 작업표를 인쇄용 레이아웃과 엑셀 내보내기로 함께 제공
- 생산 묶음 정보를 주문과 연결해 어떤 묶음이 어느 주문에 나가는지 추적하는 구조 설계
주문 변경과 환불이 집계에 즉시 반영되도록 집계를 확정 주문 기준 뷰로 구성해 주문량과 준비 수량이 어긋나지 않게 구현합니다.


배송 명단·권한
운영자가 아파트·동별 배송 명단을 만들어 담당자를 배정하고 매장 수령 주문의 전달 완료를 처리합니다. 역할별로 볼 수 있는 메뉴와 개인정보 범위가 달라집니다.
- 배송 명단을 아파트·동 단위로 생성하고 담당자 배정을 변경 이력과 함께 저장
- 전달 완료 처리를 주문 단위 상태 전이로 제한해 중복 전달 방지
- 역할 기반 접근 제어를 라우트·API·화면 요소 3단계로 적용
담당자별 개인정보 접근 범위를 서버 응답 단계에서 제한해, 권한 밖 정보가 화면 코드에 내려가지 않도록 구현합니다.


프로젝트 진행 단계
운영 권한 체계와 회차 데이터 설계 · 2026.11
역할별 접근 범위, 회차·공급 한도·생산 묶음 테이블과 변경 이력 구조 정의
개시 승인·회차 관리 API 구현 · 2026.11
모집 집계, 개시 승인 트랜잭션, 회차 설정과 휴무일 처리 API 구현
주문·환불·집계 콘솔 화면 구현 · 2026.11
주문 목록, 부분 환불 처리, 생산 집계, 작업표 출력과 엑셀 내보내기 화면 구현
배송 명단·권한 적용과 통계 · 2026.11
배송 명단 생성·배정, 매장 수령 전달 처리, 역할 기반 접근 제어, 운영 통계 구성
개발 결과
기술적 주안점
- 개시 승인 조건을 목표 세대수와 구매 세대수 기준으로 서버가 판정해, 조건 미달 아파트는 승인 버튼이 비활성화되도록 구현합니다
- 회차별 주문 변경이 생산·포장·배송 자료에 바로 반영되도록 같은 주문 데이터를 공유하는 구조로 구성합니다
- 주문 변경과 환불이 집계에 즉시 반영되도록 집계를 확정 주문 기준 뷰로 구성해 주문량과 준비 수량이 어긋나지 않게 구현합니다