ProcureHub[#]

스마트팩토리, ERP 시스템 구현 실습을 위한 자재 관리 및 조달(발주, 입•출고) 자동화 웹 애플리케이션 제작 프로젝트

👤 GoldenKids

GoldenKids [금쪽이파티]는 아래와 같은 멤버로 구성되었습니다.

정지원	최병준	장연희	최지우

📋 목차

1. 소개
2. 기술 스택
3. 설계
4. 구현
   4-1. 사용자 인증(로그인) 및 세션 관리
   4-2. 대시보드
   4-3. 계약 관리
   4-4. 자재 관리
   4-5. 조달 관리
   4-6. 발주 관리
   4-7. 입•출고 관리
   4-8. 생산 계획 계산기
   4-9. 업무 현황 관리
   
   

소개

프로젝트 목표

이 프로젝트는 엠아이티능력개발원[#]에서 진행한 KDT 과정의 일환으로, 주요 목표는 다음과 같습니다.

• 웹 어플리케이션 개발 지식 습득: 웹 어플리케이션 개발과 관련된 이론과 실무 지식을 습득하고 이를 실천하여 숙달화하는 것을 목표로 하였습니다.
• 팀 단위 활동 경험: 팀원들과 협력하여 프로젝트를 진행하면서 조직 내 활동 경험을 쌓고, 효과적인 소통 및 협업 능력을 향상시키는 것을 목표로 하였습니다.
• 개발 과정의 체계화 및 문서화: 개발 과정을 체계적으로 관리하고, 문서화를 통해 프로젝트의 흐름을 명확히 하고 표준화하는 것을 목표로 하였습니다.

이 프로젝트는 위의 목표를 달성하기 위해 진행되었으며, 실질적인 개발 경험과 팀워크, 그리고 문서화의 중요성을 강조하고자 하였습니다.

기술 스택

이 프로젝트는 여러 웹 기술을 사용하여 개발되었습니다. 주요 기술 스택은 다음과 같습니다.

프로그래밍 언어

• Java: openJDK 17
• JavaScript: Vanilla JS, jQuery 3.7.1

프레임워크 및 라이브러리

• Spring Boot: 3.3.1 (Spring Core 6.1.10)
• JPA Hibernate: ORM 솔루션
• Spring Security: 사용자 로그인 처리
• Thymeleaf: 3.1.2, 서버 사이드 템플릿 엔진
• Bootstrap: 5.2.3, CSS 프레임워크, 반응형 디자인 및 UI 구성
• Lombok: 1.18.32, 코드 간결화
• QueryDSL: 5.1.0, 복잡한 쿼리 생성
• HikariCP: 5.1.0, 고성능 JDBC 커넥션 풀

데이터베이스

• MariaDB: 10.6.18
• Redis: 6.0.16 (통합 세션 스토리지)

빌드 도구

• Gradle: 빌드 및 의존성 관리

서버 환경

• Ubuntu Server: 22.04 LTS
• Nginx: 웹 서버 및 리버스 프록시
• Tomcat: 서블릿 컨테이너

도구

• Git: 버전 관리
• GitHub: 원격 저장소 호스팅
• IntelliJ IDEA: 통합 개발 환경(IDE)
• Trello: 프로젝트 관리 [#]
• Notion: 문서화 및 협업
• Jenkins: 지속적 통합 및 배포 자동화
• dbdiagam.io: ERD 제작 도구
  
  

설계

이 프로젝트의 설계는 다음과 같은 주요 구성 요소로 이루어져 있습니다.

아키텍쳐

이 웹 애플리케이션은 MVC (Model-View-Controller) 패턴을 사용하여 개발되었으며, 구조도는 아래와 같습니다.

클릭하여 펼치기

클릭하여 펼치기

데이터베이스 모델링

Trello - DB 테이블 정의서

Trello - DB ER다이어그램

화면 별 기능 정의 및 정책

Trello - 화면 기능 정의 및 정책서

UI

• 효율적인 데이터 입력: 사용자가 여러 값을 반복적으로 입력할 필요 없이, 최소한의 화면 이동으로 여러 작업을 한 화면에서 수행할 수 있도록 구성했습니다. (모달)
• 직관적인 데이터 시각화: 표를 사용하여 다양한 데이터를 한눈에 확인할 수 있게 하여, 정보 접근성을 높였습니다. (목록)
• 진행 상태 확인: 영역을 분할하여 각 프로세스의 진행 상황을 명확히 시각화하여, 사용자가 현재 상태를 쉽게 파악할 수 있도록 디자인했습니다. (발주, 입고)
• 색상 기반 상태 표시: 색상으로 상태를 구분하여 빠른 인식과 시각적 피드백을 제공합니다. (견적, 조달 계획)

Trello - 디자인 시안 확정

클릭하여 펼치기

테스트

Trello - 테스트 계획서

URL 설계

URL 설계

서버 및 배포

클릭하여 펼치기

클릭하여 펼치기

구현

사용자 인증(로그인) 및 세션 관리

• 사용자 인증: Spring Security를 통해 사용자 인증을 처리합니다.
• 암호 보호: 사용자의 암호는 Bcrypt를 사용하여 단방향 암호화됩니다.
• 접근 제어: 로그인이 이루어지기 전에는 모든 URL 접근이 차단됩니다.
• 세션 관리: 로그인 성공 후, 사용자 정보는 Redis를 이용한 통합 세션 스토리지에 저장됩니다.

클릭하여 펼치기

대시보드

• 사용자 정보: 화면 상단에 로그인한 사용자의 정보가 표시됩니다.
• 업무 현황:
  • 조달 계획, 발주, 입고: 긴급, 경고, 자동 수정됨, 전체 진행중인 건의 수가 표시됩니다.
  • 출고: 요청 건수와 전체 건수가 표시됩니다.
• 생산 계획: 캘린더를 통해 생산 계획을 한눈에 확인하고, 즉시 추가하거나 변경할 수 있습니다.
• 생산 제품 현황: 월별 생산 제품 현황(수량)을 나타내는 그래프가 있습니다.
• 업무 현황 표: 월별 로그인한 사원의 업무 처리 현황이 표로 나타납니다.
• 발주, 입고, 출고 통계: 6개월간의 월별 발주, 입고, 출고 건수가 그래프로 표시됩니다.

클릭하여 펼치기

대시보드	생산 계획 추가 및 수정

계약 관리

업체

• 업체 목록:
  • 업체 명, 주소, 내선 번호를 확인할 수 있습니다.
  • 등록된 업체를 클릭하면 상세정보 페이지로 이동하여, 해당 업체의 정보와 주고받은 견적 목록을 확인할 수 있습니다.
• 업체 등록:
  • 사업자 등록번호, 업체 명, 내선번호, 주소를 입력받습니다.
  • 주소는 카카오 우편번호 서비스를 통해 손쉽게 입력할 수 있습니다.
  • 담당자 이름, 연락처, 거래 은행, 계좌번호도 입력받아 등록할 수 있습니다.

클릭하여 펼치기

업체 목록 및 상세정보	업체 등록
업체 정보 수정	업체 상세정보 내 견적 추가 시

견적

• 견적 목록:
  • 전체 주고받은 견적 목록을 표 형태로 표시하며, 상태 부분에는 색상을 통해 견적의 상태를 나타냅니다.
  • 목록 검색 기능이 제공되어 원하는 견적을 쉽게 찾을 수 있습니다. (견적 코드, 견적 제목, 사업자등록번호, 회사명, 자재코드, 자재명으로 검색)
  • 견적 목록 행을 클릭하면 견적의 상세정보 페이지로 이동하며, 상세정보를 확인할 수 있습니다.
    • 견적 상세정보:
      • 견적의 상세 정보를 확인할 수 있습니다.
      • 우측 상단의 출력 버튼을 통해 견적서를 출력할 수 있으며, 상대 업체로부터 받은 견적서 파일을 첨부할 수 있습니다.
      • 견적 수정이 가능하며, 계약 추가 버튼을 눌러 계약을 체결할 수 있습니다.
      • 계약 체결 시, 계약 날짜를 확인할 수 있습니다.
• 견적 등록:
  • 업체의 사업자 등록번호 또는 업체명을 입력하면 자동완성 목록이 표시되며, 이를 선택하여 업체 정보를 입력합니다.
  • 한 견적에 여러 자재를 추가할 수 있으며, 자재 코드 또는 자재명을 입력하면 자동완성 목록이 나타나고, 이를 선택하여 자재를 추가합니다.
  • 견적서 파일을 첨부할 수 있습니다.

클릭하여 펼치기

견적 목록 (검색) 및 상세정보	견적서 출력 및 파일 업로드
견적 등록	견적 수정
계약 등록 실패 시	계약 등록 성공 시

자재 관리

자재 관리 기능은 자재 목록, 자재 등록, 그룹 목록, 창고 목록으로 구성되어 있으며, 각 메뉴의 세부 사항은 다음과 같습니다:

자재 목록

• 자재를 검색할 수 있으며, 자재의 상세 정보를 표 형태로 확인할 수 있습니다.
• 표의 행을 클릭하면 자재의 상세정보 페이지로 이동합니다. 여기서 자재의 도면을 추가하거나 기존 도면을 확인할 수 있습니다.
  • 상세정보:
    • 자재의 상세정보와 도면을 확인할 수 있습니다.
    • 자재가 사용되는 제품의 목록과 6개월간 입고 및 출고 내역을 그래프로 시각화하여 수량 변화를 분석할 수 있습니다.

자재 등록

• 자재의 상세 정보를 입력하여 자재를 등록합니다.
• 자재 등록 시, 자재가 속할 그룹과 저장할 창고를 선택해야 합니다.
• 자재 등록 시 도면 파일을 첨부하여 자재의 시각적 정보를 추가할 수 있습니다.

그룹 목록

• 자재를 대중소 그룹으로 분류합니다.
• 그룹 이름 선택 시, 해당 그룹에 속한 자재의 목록을 표시합니다.
• 그룹을 추가하거나 그룹 이름을 변경할 수 있습니다.

창고 목록

• 창고 목록을 관리합니다.
• 창고를 추가하거나 이름을 변경할 수 있습니다.
• 창고 삭제 시, 해당 창고에 포함된 자재는 자동으로 ‘기타 창고’로 이동됩니다.

클릭하여 펼치기

자재 목록 및 검색	상세정보 및 도면
자재 등록	자재 수정
그룹 목록	창고 목록

조달 관리

조달 관리 기능은 조달 계획 목록으로 구성되어 있으며, 메뉴의 세부 사항은 다음과 같습니다.

자동 생성 및 관리

• 자동 생성: 생산 계획이 추가되면, 필요한 자재의 조달 계획이 자동으로 생성됩니다. 이 과정은 DB 트리거 기능을 통해 이루어지며, 조달 계획은 납기일을 기준으로 자동 정렬됩니다.
• 납기일 설정: 조달 납기일은 생산 시작일 2일 전으로 자동 설정되어, 자재가 차질 없이 준비될 수 있도록 합니다.
• 생산 계획 수정: 생산 계획이 수정되면, DB 트리거를 통해 조달 계획의 자재 필요 수량 및 가용 재고가 자동으로 업데이트됩니다.

상태 표시 및 경고

• 리드타임 및 버퍼:
  • 리드타임은 해당 자재의 공급 계약 중 가장 리드타임이 긴 값이 적용되어 표시됩니다.
  • 납기일 - (리드타임 + 버퍼 2일)이 5일 이하일 경우, 해당 항목은 노란색으로 표시되어 주의가 필요한 상태를 나타냅니다.
  • 납기일 - (리드타임 + 버퍼 2일)이 3일 이하일 경우, 빨간색으로 표시되어 매우 긴급한 상황임을 경고합니다.
  • 리드타임이 존재하지 않는 경우, 납기일 - (7일 + 버퍼 2일)로 계산합니다.
• 스케줄러 기능: 매일 00시에 스프링 프레임워크의 스케줄러 기능을 통해 조달 계획을 다시 불러오고, 리드타임을 자동으로 계산하여 상태를 업데이트합니다.

자재 및 발주 관리

• 자재 리스트: 각 제품에 필요한 자재는 리스트로 표시되며, 자재 코드, 명칭, 규격, 현재 수량, 납품 소요 기간 등의 정보가 포함됩니다. 또한 리스트는 납기일이 가장 빠른 순으로 우선 정렬됩니다.
• 가용 재고 계산: 동일한 제품에 대해 여러 조달 계획이 생성될 수 있으며, 가용 재고를 계산하여 현재 조달 계획에 필요한 자재 수량을 계산합니다.
• 발주 자동 생성: 가용 재고를 바탕으로 발주가 필요한 경우, 미달 수량만큼 발주 항목이 자동으로 생성되고 발주 수량도 자동으로 수정됩니다.
• 계약 없는 자재: 리드타임이 없는 자재는 유효한 계약이 없음을 의미하며, '계약 추가' 버튼을 통해 견적 목록으로 이동하여 필요한 경우 계약을 체결할 수 있습니다.

조달 상태 관리

• 발주 추가: 재고가 충분하지 않을 경우 발주가 자동으로 추가됩니다. 상태는 '발주 추가됨'으로 표시됩니다.
• 발주 실행: 발주 실행 후 상태는 '발주됨'으로 업데이트되어 실제 발주가 진행 중임을 나타냅니다.
• 입고 처리: 입고 항목이 도착 처리되면 상태는 '입고 중'으로 변경되며, 자재가 창고로 입고되는 과정입니다.
• 출고 완료: 출고가 완료되면 상태는 '완료'로 변경되며, 조달 프로세스가 최종적으로 완료되었음을 의미합니다.

클릭하여 펼치기

조달 계획 목록 및 가용 재고 계산	조달 계획 내 계약 추가
리드타임 계산	조달 계획의 상태
조달 계획 목록 내 발주 수동 추가

발주 관리

발주 관리 기능은 발주 현황과 발주 전체 내역 메뉴로 구성됩니다.

발주 현황

• 대기 현황

  • 발주 대기 현황은 조달 계획을 통해 자동으로 생성된 발주 항목을 관리합니다. 사용자는 발주할 회사, 수량, 금액을 확인하고 필요에 따라 수정할 수 있습니다.
  • 각 발주 항목은 다음과 같은 정보를 제공합니다:
    • 회사명 및 단가: 유효한 견적 데이터(계약 완료 상태)에서 자동으로 불러옵니다.
    • 총 금액: 발주 수량과 단가를 곱한 값.
  • 사용자는 수정 버튼을 통해 발주할 회사와 발주 수량을 변경할 수 있으며, 선택된 회사에 따라 단가가 자동으로 업데이트됩니다.
  • 저장 버튼을 클릭하면 수정된 데이터가 서버로 전송되어 데이터베이스에 반영됩니다.

• 발주 수동 추가

  • 조달 계획과 관계없이 가용 재고를 확보하고 싶을 경우, 발주 추가 버튼을 눌러 수동으로 발주를 추가할 수 있습니다.
  • 자재 코드를 입력하면 발주 가능한 회사 목록이 표시되며, 해당 회사의 발주 가능 수량, 단가, 리드 타임 정보가 자동으로 불러와집니다.
  • 발주 수량을 입력하면 총 금액이 자동으로 계산됩니다. 발주 가능 수량을 초과할 경우, 안내 메시지와 함께 발주 수량이 수정됩니다.
  • 수동 발주를 취소하려면 수정 버튼을 누르고 취소할 발주 건을 선택한 후 발주 취소 버튼을 클릭하여 발주 상태를 '반려'로 변경합니다.

• 발주 실행

  • 발주 가능한 회사가 존재하는 발주 대기 항목만 발주 실행 처리로 전환할 수 있습니다.
  • 발주 실행 시 자동으로 발주 진척 검수 항목과 입고 대기 현황의 항목이 생성됩니다.
  • 발주 날짜와 처리 사원 정보가 데이터베이스에 저장됩니다.
  • 발주가 완료되면 발주 대기 현황에서 진행 현황으로 이동하며, 발주 상태가 '검수전'으로 변경됩니다.

• 진행 현황

  • 발주 항목을 클릭하면 발주 상세 정보와 진척 검수 내용이 표시됩니다.
  • 진척 검수:
    • 추가 버튼을 눌러 검수 예정일, 검수 상태, 검수 내용을 입력할 수 있습니다.
    • 검수 상태가 '검수전'일 경우 '수정' 버튼을 통해 검수 상태를 수정할 수 있습니다.
    • 검수가 완료된 경우 '정상'으로 상태가 변경되며, 이후에는 수정이 불가능합니다.

발주 전체 내역

• 발주 전체 내역 화면에서는 발주 상태와 관계없이 모든 발주 목록이 발주 코드 기준으로 내림차순 정렬되어 표시됩니다.
• 발주 항목을 클릭하면 발주 상세 정보와 진척 검수 내용이 모달 창으로 표시됩니다.

클릭하여 펼치기

발주 대기 화면	발주 대기 수정
발주 수동 추가 및 취소	발주 실행
발주 상세 정보 및 진척 검수 추가	발주 진척 검수 진행
발주 전체 내역 및 상세 정보

입•출고 관리

입•출고 관리 기능은 입고과 출고 메뉴로 구성되며, 하위 메뉴로 입고 현황, 입고 전체내역, 요청 현황, 출고 전체 내역 으로 구성됩니다.

입고 현황

• 입고 대기

  • 입고 대기 현황에서는 발주 실행 시 자동으로 생성된 입고 대기 항목을 확인할 수 있습니다.
  • 사용자는 수정 버튼을 클릭하여 입고 수량을 변경할 수 있으며, 단일 항목 또는 여러 항목을 동시에 수정할 수 있습니다.
  • 도착 및 진행 버튼을 클릭 시, 입고 진행 현황으로 자동으로 이동하며, 도착일 및 도착 처리한 사원 정보가 추가됩니다.

• 입고 진행 현황

  • 입고 진행 현황 화면에서 항목을 클릭하면 모달 창으로 입고 상세 정보와 검수 모달 창이 표시됩니다.
  • 입고 검수 항목은 입고 도착 처리 시, 자동으로 한 건 생성됩니다.
  • 검수 상태는 초기 값으로 '검수 전'으로 설정되며, 자재가 불량일 경우 불량을 입력하고, 불량 자재 수를 기록할 수 있습니다.
  • 검수 상세 내용을 입력 후 저장 버튼을 클릭하면 입고 진행이 완료되며, 입고일과 입고 처리자가 자동으로 기록되고 해당 자재의 수량이 변경됩니다.
  • 로그인한 사용자의 정보가 자동으로 반영되어 정확한 기록이 유지됩니다.

입고 전체 내역

• 입고 전체 내역 화면에서는 모든 입고 정보를 확인할 수 있으며, 검색 기능을 통해 빠르게 원하는 정보를 찾을 수 있습니다.
• 각 행을 클릭하면 입고 내역의 상세 정보를 확인할 수 있으며, 명세서 발행 버튼을 통해 입고 정보를 포함한 명세서를 자동으로 발행할 수 있습니다.

클릭하여 펼치기

입고 대기 현황 및 수정	입고 도착 및 진행
입고 검수 불량	입고 검수 정상
입고 도착 처리 시, 발주 완료 처리	입고 전체 내역
입고 전체 내역 검색	입고 명세서 발행

(출고) 요청 현황

• 출고 현황 화면에서는 출고 요청 목록을 직관적으로 확인할 수 있습니다.
• 체크 박스를 통해 여러 항목을 동시에 선택하여 출고를 완료할 수 있으며, 자재 수량이 부족한 경우 체크 박스가 비활성화됩니다.
• 출고 처리 버튼을 클릭하면 출고 상태가 '자동 생성됨'에서 '완료'로 변경되며, 출고를 진행한 사원과 출고일이 자동으로 기록됩니다.
• 출고가 완료되면 현재 자재 수량에서 출고된 수량이 차감되어 재고 관리가 정확하게 이루어집니다.

출고 전체 내역

• 출고 전체 내역 화면에서는 출고 상태와 관계없이 모든 출고 정보를 확인할 수 있습니다.
• 검색 기능을 통해 특정 값을 입력하면 해당 행이 즉시 표시됩니다.
• 출고 처리 완료 항목은 '완료'로, 처리가 완료되지 않은 항목은 '자동 생성됨'으로 표시됩니다.

클릭하여 펼치기

출고 요청 현황	출고 처리
출고 전체 내역, 상세정보, 검색

생산 계획 계산기

생산 계획 계산기는 도구 메뉴의 세부 메뉴로, 사용자가 생산할 제품의 계획을 세우는 데 필요한 정보를 입력하고, 결과를 쉽게 확인할 수 있도록 설계된 도구입니다.

제품 선택 및 기본 정보 입력

• 사용자가 제품을 선택하면 해당 제품의 이름과 기본 정보가 자동으로 화면에 표시됩니다. 이를 통해 사용자는 별도의 데이터 입력 없이 제품명을 쉽게 가져올 수 있습니다.
• 사용자가 생산할 제품의 수량과 시작 날짜를 입력하면, 시스템은 필요한 자재 수량과 발주 가능 여부를 실시간으로 계산합니다.
• 자재 및 회사 목록에서는 발주 가능 수량이 필요 자재 수량보다 많고, 생산 시작 날짜를 기준으로 자재 리드 타임보다 기간이 길어야 "가능"으로 표시됩니다.
• 발주 조건 중 하나라도 맞지 않으면 "불가능"으로 표시됩니다.

실시간 업데이트 및 사용자 편의성

• 사용자가 생산 제품의 수량이나 시작 날짜를 변경하면, 자재 소요량과 발주 가능 여부가 자동으로 업데이트됩니다.
• 입력 필드가 변경될 때마다 이벤트를 감지하고, 필요한 데이터를 다시 계산하여 화면을 업데이트하도록 구현되어 사용자는 변경 사항을 즉시 반영하고 확인할 수 있습니다.

클릭하여 펼치기

업무 현황 관리

업무 현황 관리는 관리메뉴의 세부 메뉴로, 관리자 권한을 가진 부서만 접근할 수 있습니다. 이 페이지는 사원들의 일일 및 월간 업무 현황을 한눈에 파악할 수 있도록 설계되었습니다.

• 업무 현황 파악: 당일 업무와 월간 업무를 가장 많이 수행한 사원과 가장 적게 수행한 사원을 한눈에 파악할 수 있습니다.
  • 업무 수행은 견적 등록, 발주 실행, 입고 처리, 출고 처리 건이 집계됩니다.
• 권한 제한: 관리자 권한이 없는 사원이 관리자 페이지에 접근하려고 하면, 자동으로 대시보드 페이지로 리다이렉트됩니다.
• 권한 알림: 관리자 권한이 없는 사원이 관리자 페이지를 클릭하면, "관리자 권한이 없습니다"라는 메시지가 담긴 모달 창이 나타나 사용자가 접근할 수 없음을 명확히 알려줍니다.

클릭하여 펼치기