← 포트폴리오 목록

아파트 정기배송 운영 콘솔

MVP 이후 점포 운영자가 쓰게 될 운영 콘솔 확장 프로젝트입니다.

프로젝트 납품 요약

아래 프로젝트 개요와 핵심 기능에서 구현 화면을 확인할 수 있습니다.

서비스 타입Web
업종물류 시스템
기술 스택
React 18TypeScriptTailwind CSSNode.jsExpressPrismaPostgreSQL
주요 기능
  • 모집·개시 승인
  • 배송 회차·주문
  • 생산·포장 집계
  • 배송 명단·권한

프로젝트 개요

범위: 개발, 디자인, 기획

MVP 이후 점포 운영자가 쓰게 될 운영 콘솔 확장 프로젝트입니다. 아파트 모집·개시 승인, 배송 회차, 주문·환불, 생산·포장 집계, 배송 명단을 한 콘솔에서 처리하며 역할별로 보이는 메뉴와 개인정보 범위가 달라지는 구조를 제안합니다.

작업 범위

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

주요 업무

  • 모집·개시 승인 화면: 처리할 일 카드, 아파트별 모집 표, 참여 신청·구매 세대 구분 표시, 개시 승인 대화상자, 담당 점포 연결 구조를 설계합니다
  • 배송 회차·주문 화면: 회차 달력, 회차 상세 설정, 상품별 공급 한도 표, 주문 목록과 필터, 환불 처리 대화상자, 마감 후 변경 이력 구조를 설계합니다
  • 생산·포장 집계 화면: 상품별 집계 표, 배송·매장 수령 준비 수량 구분, 작업표 미리보기, 엑셀 다운로드, 산란·선별·포장 등록 폼, 최근 판매 추이 차트 구조를 설계합니다
  • 배송 명단·권한 화면: 배송 명단 표, 담당자 배정 대화상자, 매장 수령 전달 처리, 역할 전환별 메뉴 변화와 접근 제한 안내 구조를 설계합니다
아파트 정기배송 운영 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

주문 변경·환불이 생산·포장·배송 자료에 어긋남 없이 반영되

단일 주문 데이터 기준 집계 구조 설계 필요

담당자별 개인정보 접근 범위를 역할로 나누는 정책이 바뀔 수

설정 가능한 권한 구조 설계 필요

점포별 생산 방식이 달라질 수

산란·선별·포장 등록 항목을 확장 가능한 형태로 설계 필요

배송 회차 휴무·일정 변경 시 안내와 취소 처리를 회차 단위로 일괄 적용하는 흐름 설계

구현 내용

핵심 기능 상세

핵심 기능 1

모집·개시 승인

운영자가 첫 화면에서 아파트별 모집 현황을 보고 목표를 달성한 아파트의 서비스 개시를 승인합니다. 참여 신청 세대수와 실제 구매 세대수를 구분해 확인합니다.

  • 참여 신청 세대수와 구매 세대수를 별도 집계 쿼리로 분리해 승인 판단 지표를 구성
  • 개시 승인 시 아파트 상태 변경과 첫 배송 회차 생성을 한 트랜잭션으로 처리
  • 점포와 아파트의 담당 연결을 관리 화면에서 변경하고 변경 이력을 기록

개시 승인 조건을 목표 세대수와 구매 세대수 기준으로 서버가 판정해, 조건 미달 아파트는 승인 버튼이 비활성화되도록 구현합니다.

모집·개시 승인
모집·개시 승인 실제 화면
핵심 기능 2

배송 회차·주문

운영자가 배송 요일·주문 마감·휴무일을 설정하고 회차별 판매 상품과 공급 한도를 관리합니다. 회차의 주문 목록에서 결제·취소·부분 환불을 처리하고 변경 이력을 확인합니다.

  • 회차 설정(요일·마감·한도)을 회차 테이블로 분리하고 변경 시 영향 범위를 미리 계산해 안내
  • 부분 환불을 상품 단위로 처리하고 결제 취소 요청과 주문 이력을 함께 기록
  • 마감 후 주문 변경을 사유 필수 입력과 변경 이력 기록으로 제한

회차별 주문 변경이 생산·포장·배송 자료에 바로 반영되도록 같은 주문 데이터를 공유하는 구조로 구성합니다.

배송 회차·주문
배송 회차·주문 실제 화면
핵심 기능 3

생산·포장 집계

운영자가 확정 주문량으로 상품별 총 계란 개수를 계산하고 배송분과 매장 수령분을 구분한 준비 수량을 확인합니다. 작업표를 출력하거나 엑셀로 내려받고 산란·선별·포장 정보를 등록합니다.

  • 확정 주문을 상품 규격(구 수)으로 환산해 총 계란 개수를 집계하는 쿼리 구성
  • 작업표를 인쇄용 레이아웃과 엑셀 내보내기로 함께 제공
  • 생산 묶음 정보를 주문과 연결해 어떤 묶음이 어느 주문에 나가는지 추적하는 구조 설계

주문 변경과 환불이 집계에 즉시 반영되도록 집계를 확정 주문 기준 뷰로 구성해 주문량과 준비 수량이 어긋나지 않게 구현합니다.

생산·포장 집계
생산·포장 집계 실제 화면
핵심 기능 4

배송 명단·권한

운영자가 아파트·동별 배송 명단을 만들어 담당자를 배정하고 매장 수령 주문의 전달 완료를 처리합니다. 역할별로 볼 수 있는 메뉴와 개인정보 범위가 달라집니다.

  • 배송 명단을 아파트·동 단위로 생성하고 담당자 배정을 변경 이력과 함께 저장
  • 전달 완료 처리를 주문 단위 상태 전이로 제한해 중복 전달 방지
  • 역할 기반 접근 제어를 라우트·API·화면 요소 3단계로 적용

담당자별 개인정보 접근 범위를 서버 응답 단계에서 제한해, 권한 밖 정보가 화면 코드에 내려가지 않도록 구현합니다.

배송 명단·권한
배송 명단·권한 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

운영 권한 체계와 회차 데이터 설계 · 2026.11

역할별 접근 범위, 회차·공급 한도·생산 묶음 테이블과 변경 이력 구조 정의

STEP 2

개시 승인·회차 관리 API 구현 · 2026.11

모집 집계, 개시 승인 트랜잭션, 회차 설정과 휴무일 처리 API 구현

STEP 3

주문·환불·집계 콘솔 화면 구현 · 2026.11

주문 목록, 부분 환불 처리, 생산 집계, 작업표 출력과 엑셀 내보내기 화면 구현

STEP 4

배송 명단·권한 적용과 통계 · 2026.11

배송 명단 생성·배정, 매장 수령 전달 처리, 역할 기반 접근 제어, 운영 통계 구성

개발 결과

참여·구매 세대 분리 승인 지표 설계참여 신청과 실제 구매 세대수를 분리 집계해 개시 승인 판단 지표로 쓰는 구조를 설계합니다.
확정 주문 기준 생산 집계 뷰 구성확정 주문을 규격별 계란 개수로 환산하는 집계 뷰로 환불·변경이 준비 수량에 바로 반영되도록 구성합니다.
3단계 역할 기반 접근 제어 구축라우트·API·화면 요소 3단계로 권한을 검증하고 개인정보 범위를 서버 응답에서 제한하는 체계를 구축합니다.
중복 전달 방지 수령 처리 구현주문 단위 상태 전이로 매장 수령 전달 완료를 한 번만 처리하는 흐름을 구현합니다.

기술적 주안점

  • 개시 승인 조건을 목표 세대수와 구매 세대수 기준으로 서버가 판정해, 조건 미달 아파트는 승인 버튼이 비활성화되도록 구현합니다
  • 회차별 주문 변경이 생산·포장·배송 자료에 바로 반영되도록 같은 주문 데이터를 공유하는 구조로 구성합니다
  • 주문 변경과 환불이 집계에 즉시 반영되도록 집계를 확정 주문 기준 뷰로 구성해 주문량과 준비 수량이 어긋나지 않게 구현합니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의