01. 프로젝트 배경과 개요

1. 배경

취미로 운동삼아, 부업삼아 월 수 금 밤에 우유 배달을 하고 있는데 고객리스트 및 배달 주소지 관리할 겸 만들었다. 배포하거나 공유하는건 아니고 필요할 때만 혼자 로컬에서 쓰는 용도로 가볍게 만들어보는 프로젝트.

사실 엑셀로 해도 되긴하는데 안 써본 기술들 사용해보고 싶어서 만들어보게 됐다.

아래 내용들은 GPT와 대화하면서 정리한 것들. 이제 이대로 개발 시작 

 

2. 프로젝트 개요

우유 배달 관리 시스템은 우유 배달 업무를 효율적으로 관리하기 위한 웹 기반 관리자 시스템입니다. 고객 정보 관리, 배달 일정 관리, 배달 이력 관리 등의 기능을 제공하여 업무 효율성을 높이는 것을 목표로 합니다.

 

3. 개발 스택

Frontend

• Next.js 14 (React Framework)
• TypeScript
• Tailwind CSS
• shadcn/ui (UI Components)
• Recharts (차트 라이브러리)

Backend

• FastAPI
• Python
• SQLAlchemy (ORM)
• MySQL (Database)
• Pandas (데이터 처리)

 

4. 목표

1. 배달 리스트 사진에서 배달 정보를 자동으로 추출.
2. 일일 배달 내역을 간편하게 확인하고 기록.
3. 전체 배달 리스트를 관리하고 업데이트 가능.
4. 날짜별 데이터 조회로 근무 일지 작성 효율화.

 

5. 주요 기능

 

5.1 배달 리스트 업로드 및 관리

• 배달 리스트 사진 업로드 (JPEG/PNG).
• 네이버 OCR API를 활용해 리스트 텍스트를 추출.
• 추출된 데이터를 데이터베이스에 저장.
• 사용자 검토 및 수정 기능 제공.

5.2 배달 현황 관리

• 일일 배달 리스트에서 완료된 배달 체크.
• 완료된 배달 데이터를 시간과 함께 저장.

5.3 전체 배달 리스트 관리

• 모든 배달 주소를 저장한 마스터 리스트 관리.
• 배달 장소를 추가, 수정, 삭제 가능.
• 각 배달 주소의 속성:
  • 순번: 고유 번호
  • 주소명: 사용자가 지정한 이름
  • 동/호: 세부 정보
  • 주소: 실제 주소
  • 이름: 고객 이름
  • 월/수/금: 요일별 배달 여부 (True/False)
  • 구역: 배달 구역
  • 특이사항: 기타 정보

5.4 데이터 조회 및 근무 일지 작성

• 날짜별 배달 기록 조회.
• 일일 배달 완료 현황 보고서 생성.