Skip to content
dbtkdfhrPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

HIMS — 현대백화점 매장 재고 관리 시스템

HIMS · 재고 및 입출고 관리 시스템 백화점 본사 · 지점 · 입점매장 · 외부 발주처를 하나의 흐름으로 연결하는 발주–승인–입고–판매 재고 관리 시스템

Java(Swing) 기반 데스크톱 애플리케이션으로, 발주 요청부터 판매 처리까지의 전체 업무 흐름을 역할별로 구현했습니다. 내부 재고 DB(Oracle)와 외부 발주처 DB(MariaDB)를 물리적으로 분리하여 실제 운영 환경과 유사한 외부 시스템 연동 구조를 표현합니다.

FutureNet Fullstack 1차 프로젝트 · 2팀 (김영만 · Annie · 유상록 · 최우진)


목차


프로젝트 개요

HIMS는 백화점 재고 관리 도메인을 재고 관리 기능에 집중하여 설계한 프로젝트입니다.

  • 재고를 상품의 속성이 아니라 매장(STORE)과 상품(PRODUCT) 사이에서 발생하는 상태 데이터(STORE_INVENTORY)로 모델링
  • 내부 백화점 DB와 외부 발주처 DB를 분리하여 실제 파트너사/물류 대행사가 분리된 운영 환경을 재현
  • 반복되는 상태 변경·재고 보충 로직을 DB 계층(Trigger / Procedure / Scheduler) 에 위임하여 Java 코드는 핵심 업무 흐름에 집중

주요 기능

도메인 기능
인증 로그인 / 비밀번호 변경, 역할 기반 화면 분기
발주 요청 재고 부족 확인, 발주 요청 생성, 내 발주 요청 현황 조회
발주 승인 발주처 담당자의 발주 요청 승인 / 반려 (승인 수량 지정)
외부 발주처 연동 외부 발주처 접수 목록 조회, 접수 승인 / 거절, 출고 처리
입고 처리 입고 검수(정상 입고 / 수량 차이 / 입고 반려), 입고 이력 조회
판매 처리 판매 처리에 따른 매장 재고 차감
재고 조회 지점·브랜드·카테고리·매장별 재고 현황 조회
매장/상품 관리 입점매장 등록, 상품 등록
직원/계정 관리 계정 생성, 권한 변경, 소속 매장 변경, 계정 정지, 비밀번호 초기화

전체 업무 흐름

발주 요청부터 판매 처리까지, 4개 역할이 하나의 흐름으로 연결됩니다.

전체 업무 흐름

  1. 발주 요청 생성 — 입점매장 담당자가 재고 부족을 확인하고 발주를 요청
  2. 발주 승인 / 반려 — 발주처 담당자가 요청을 검토하여 승인 수량 지정 또는 반려
  3. 외부 발주처 전송 — 승인된 발주가 외부 발주처 DB로 접수
  4. 외부 출고 처리 — 외부 발주처 담당자가 출고 승인/거절 처리
  5. 매장 입고 확인 — 매장 담당자가 입고 검수(정상/차이/반려) 후 재고 반영
  6. 판매 처리 — 판매에 따라 매장 재고 차감

발주 상태(OrderStatus)는 흐름에 따라 REQUESTED → APPROVED → RECEIVED → DONE (또는 REJECTED / CANCELED) 로 관리됩니다.


역할(권한) 구성

ID 역할 주요 화면
1 지점관리자 (BRANCH_MANAGER) 지점/브랜드/카테고리별 재고 조회, 입점매장·상품 등록
2 발주처담당자 (SUPPLIER_MANAGER) 발주 요청 목록 조회, 발주 승인/반려, 외부 발주처 시스템
3 입점매장담당자 (STORE_MANAGER) 매장 재고 조회, 발주 요청, 입고 검수/이력, 판매 처리
4 시스템담당자 (SYSTEM_MANAGER) 직원 계정·권한 관리, 전체 재고 현황 조회
5 일반직원 (STAFF) 판매 처리 등 매장 업무 지원

로그인 시 역할에 따라 대시보드 메뉴가 동적으로 구성되며, 발주처 담당자에게는 별도의 외부 발주처 시스템 창이 추가로 열립니다.

역할별 업무 흐름

역할별 업무 흐름


아키텍처

3-Tier 아키텍처로 관심사를 분리하고, 도메인 단위로 패키지를 구성했습니다.

아키텍처 설계

  • Presentation Layer (ui.*) — Swing 화면 구성 및 사용자 인터페이스
  • Business Layer (*.Service) — 비즈니스 로직 처리 및 트랜잭션 관리
  • Data Access Layer (*.DAO) — JDBC 기반 DB 접근
  • Database — Oracle(내부) / MariaDB(외부 발주처)

도메인 패키지: auth, branch, brand, category, employee, inventory, order, product, role, store

클래스 다이어그램

각 도메인은 Service → DAO → DTO 구조로 구성되며, UI는 UiServiceStore를 통해 서비스에 접근합니다.

클래스 다이어그램

시퀀스 다이어그램

① 매장 재고 조회 & 등록 · ② 승인 및 발주 처리 · ③ 발주 확정 및 입고 처리

시퀀스 다이어그램


데이터베이스 설계

DB 분리 전략

재고 관리 기능에 집중하기 위해 내부 재고 DB와 외부 발주처 DB를 분리했습니다.

ERD 설계

구분 DBMS 주요 테이블
백화점 내부 DB Oracle ROLE, BRANCH, BRAND, CATEGORY, STORE, EMPLOYEE, PRODUCT, STORE_INVENTORY, ORDER_REQUEST, ORDER_APPROVAL, STORE_RECEIPT, SUPPLIER_INTEGRATION
외부 발주처 DB MariaDB SUPPLIER, SUPPLIER_PRODUCT, SUPPLIER_INVENTORY, EXTERNAL_ORDER_RECEIPT, EXTERNAL_SHIPMENT

핵심 설계 포인트

  • DB 무결성 확보와 효율적인 정규화를 통한 지속 가능한 데이터베이스
  • 재고는 상품 속성이 아닌 STORE ↔ PRODUCT 관계 테이블(STORE_INVENTORY) 로 분리 → 매장별 현재 수량 / 안전재고 수량을 개별 관리

DDL / DML

db/
├── ddl/
│   ├── mainDDL.sql       # 내부(Oracle) 테이블·트리거 정의
│   └── outsideDDL.sql    # 외부 발주처(MariaDB) 테이블 정의
├── dml/
│   ├── mainDML.sql       # 내부 초기 데이터
│   └── outsideDML.sql    # 외부 발주처 초기 데이터
└── procedure/
    ├── procRestockSupplierInventory.sql  # 공급처 재고 보충 프로시저
    └── setupProductionEvent.sql          # 일일 생산 자동화 이벤트 스케줄러

DB 자동화

반복되는 상태 변경과 재고 보충 작업을 DB 계층에 위임하여, Java 코드는 핵심 업무 흐름에 집중하도록 설계했습니다.

DB 자동화 기술

기술 역할 예시
Trigger 데이터 변경 순간 자동 반응 TRG_*_UPD_AT(UPDATED_AT 자동 갱신), TRG_ORDER_APPR_AI(승인/반려 상태 자동 변경), TRG_STORE_RCPT_AI(입고 완료 시 발주 DONE 처리)
Procedure 반복 업무 로직의 DB 함수화 procRestockSupplierInventory — 현재 재고 1,000개 미만 상품에 대해 1,000개 자동 보충
Scheduler 정해진 시간에 자동 실행 MariaDB EVENT eventDailyProductionCheck — 매일 자정 공급처 재고 정상화

핵심 효과: 상태값 정합성 보장 · Java Service의 중복 update 제거 · 일일 재고 보충 자동화


기술 스택

구분 사용 기술
Language Java (JDK 11)
UI Java Swing
Build Gradle 8.14.4 (Wrapper 포함)
Database Oracle Database (XE / XEPDB1), MariaDB
JDBC Driver ojdbc11 21.8.0.0, mariadb-java-client 3.5.3
Library Lombok 1.18.34
Test JUnit 5
협업 Git / GitHub (Issue · PR · Code Review)

실행 방법

1. 사전 준비

  • JDK 11 이상
  • Oracle Database (XE) 및 MariaDB 로컬 인스턴스

2. 데이터베이스 초기화

# Oracle (내부 DB)
#   1) HIMS 계정 준비 후
#   2) db/ddl/mainDDL.sql → db/dml/mainDML.sql 실행

# MariaDB (외부 발주처 DB)
#   1) hims_serve 스키마 준비 후
#   2) db/ddl/outsideDDL.sql → db/dml/outsideDML.sql 실행
#   3) db/procedure/procRestockSupplierInventory.sql → setupProductionEvent.sql 실행

3. DB 접속 정보 설정

src/main/java/common/DBConnection.java 는 접속 정보를 포함하므로 .gitignore 로 관리됩니다. 아래 형태로 로컬 환경에 맞게 작성하세요.

// Oracle
DriverManager.getConnection("jdbc:oracle:thin:@//localhost:1521/XEPDB1", "HIMS", "hims");
// MariaDB
DriverManager.getConnection("jdbc:mariadb://localhost:3307/hims_serve", "HIMS", "hims");

4. 빌드 & 실행

# 빌드
./gradlew build

빌드 후 진입점 Main.java(HimsApplication.launch())를 실행합니다. (IntelliJ 등 IDE에서 Main 실행)

Windows 환경에서는 gradlew.bat 을 사용하세요.


프로젝트 구조

src/main/java/
├── Main.java                  # 진입점
├── auth/                      # 로그인 / 비밀번호 변경
├── branch/                    # 지점
├── brand/                     # 브랜드
├── category/                  # 카테고리
├── employee/                  # 직원
├── inventory/                 # 재고
├── order/
│   ├── request/               # 발주 요청
│   ├── approval/              # 발주 승인
│   └── external/              # 외부 발주처 발주/입고
├── product/                   # 상품
├── role/                      # 권한
├── store/
│   ├── inventory/             # 매장 재고
│   ├── receipt/               # 입고
│   └── sales/                 # 판매
├── common/                    # DBConnection, TransactionHelper, 상태 enum 등
│   └── type/                  # RoleType, OrderStatus, ReceiptStatus ...
├── exception/                 # 커스텀 예외
└── ui/                        # Swing 화면 (역할별 Panel)
    ├── common/                # UiExceptionHandler, UiTableFactory ...
    └── data/                  # UiServiceStore

각 도메인은 대체로 DTO / DAO / Service 3계층으로 구성됩니다.


리팩토링 & 트러블 슈팅

리팩토링

리팩토링의 기준은 “어디에서 고칠 수 있나”가 아니라 “어디에서 책임져야 하나” 였습니다.

리팩토링 사례

방향 Before After
트랜잭션 공통화 Service마다 commit/rollback/close 반복, rollback 코드 분산 TransactionHelper.execute(conn -> ...) 로 위임, 실패 시 전체 rollback으로 정합성 보장
UI 예외 처리 버튼 이벤트마다 try-catch·JOptionPane 반복 UiExceptionHandler.run(logger, () -> ...) 공통 핸들러로 위임
Lazy Loading 로그인 직후 모든 화면·데이터를 한 번에 생성 → 초기 진입 지연 화면 Factory 저장 후 메뉴 클릭 시 Panel 최초 생성(loadedViews)

내부 DB와 외부 DB에 걸친 작업은 TransactionHelper.executeTwo(...) 로 두 커넥션을 함께 트랜잭션으로 묶어 처리합니다.

트러블 슈팅 ① — 선택적 반정규화

발주 목록 화면 하나를 위해 6개 테이블(입점매장 · 상품 · 발주요청 · 발주요청승인 · 외부발주접수 · 매장입고확인)을 조인해야 하는 복잡도를, 중복 컬럼 / 파생 컬럼(예: 차이수량 = 출고수량 - 입고수량)을 선택적으로 추가하여 완화했습니다.

선택적 반정규화

트러블 슈팅 ② — 발주 흐름에 따른 Status 정합성 관리

발주 흐름 전반에 걸친 5개 테이블의 상태값을 트리거로 자동 전이시켜 정합성을 확보했습니다.

Status 정합성 관리


한계 및 확장 방향

  • 한계: Swing 기반 GUI로 화면 확장성과 비동기 UX에 제약
  • 확장: POS 연동, 자동 발주 추천, 동시성 제어, 권한별 감사 로그
  • 개선: 화면별 비동기 로딩, 중복 조회 캐싱, 외부 연동 실패 재처리
  • 보강: 테스트 코드와 예외 케이스 검증 강화

팀 & 협업

FutureNet Fullstack — 1차 프로젝트 · 2팀

협업 프로세스

협업 프로세스

  1. 이슈 생성 — 작업 전 GitHub Issue 생성
  2. PR 생성 — 기능 구현 후 Pull Request 생성
  3. 코드 리뷰 — 네이밍 · 예외 처리 · SQL · null 처리 검토 (Review Rotation)
  4. 수정 반영 — 리뷰 코멘트 반영 후 재검토 요청
  5. Merge — 승인 후 develop 브랜치 병합

Review Point: enum 사용 · null 처리 · 공통 유틸 메서드 사용 · 상태값 관리

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages