HIMS · 재고 및 입출고 관리 시스템 백화점 본사 · 지점 · 입점매장 · 외부 발주처를 하나의 흐름으로 연결하는 발주–승인–입고–판매 재고 관리 시스템
Java(Swing) 기반 데스크톱 애플리케이션으로, 발주 요청부터 판매 처리까지의 전체 업무 흐름을 역할별로 구현했습니다. 내부 재고 DB(Oracle)와 외부 발주처 DB(MariaDB)를 물리적으로 분리하여 실제 운영 환경과 유사한 외부 시스템 연동 구조를 표현합니다.
FutureNet Fullstack 1차 프로젝트 · 2팀 (김영만 · Annie · 유상록 · 최우진)
- 프로젝트 개요
- 주요 기능
- 전체 업무 흐름
- 역할(권한) 구성
- 아키텍처
- 데이터베이스 설계
- DB 자동화
- 기술 스택
- 실행 방법
- 프로젝트 구조
- 리팩토링 & 트러블 슈팅
- 한계 및 확장 방향
- 팀 & 협업
HIMS는 백화점 재고 관리 도메인을 재고 관리 기능에 집중하여 설계한 프로젝트입니다.
- 재고를 상품의 속성이 아니라 매장(STORE)과 상품(PRODUCT) 사이에서 발생하는 상태 데이터(
STORE_INVENTORY)로 모델링 - 내부 백화점 DB와 외부 발주처 DB를 분리하여 실제 파트너사/물류 대행사가 분리된 운영 환경을 재현
- 반복되는 상태 변경·재고 보충 로직을 DB 계층(Trigger / Procedure / Scheduler) 에 위임하여 Java 코드는 핵심 업무 흐름에 집중
| 도메인 | 기능 |
|---|---|
| 인증 | 로그인 / 비밀번호 변경, 역할 기반 화면 분기 |
| 발주 요청 | 재고 부족 확인, 발주 요청 생성, 내 발주 요청 현황 조회 |
| 발주 승인 | 발주처 담당자의 발주 요청 승인 / 반려 (승인 수량 지정) |
| 외부 발주처 연동 | 외부 발주처 접수 목록 조회, 접수 승인 / 거절, 출고 처리 |
| 입고 처리 | 입고 검수(정상 입고 / 수량 차이 / 입고 반려), 입고 이력 조회 |
| 판매 처리 | 판매 처리에 따른 매장 재고 차감 |
| 재고 조회 | 지점·브랜드·카테고리·매장별 재고 현황 조회 |
| 매장/상품 관리 | 입점매장 등록, 상품 등록 |
| 직원/계정 관리 | 계정 생성, 권한 변경, 소속 매장 변경, 계정 정지, 비밀번호 초기화 |
발주 요청부터 판매 처리까지, 4개 역할이 하나의 흐름으로 연결됩니다.
- 발주 요청 생성 — 입점매장 담당자가 재고 부족을 확인하고 발주를 요청
- 발주 승인 / 반려 — 발주처 담당자가 요청을 검토하여 승인 수량 지정 또는 반려
- 외부 발주처 전송 — 승인된 발주가 외부 발주처 DB로 접수
- 외부 출고 처리 — 외부 발주처 담당자가 출고 승인/거절 처리
- 매장 입고 확인 — 매장 담당자가 입고 검수(정상/차이/반려) 후 재고 반영
- 판매 처리 — 판매에 따라 매장 재고 차감
발주 상태(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를 분리했습니다.
| 구분 | 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) 로 분리 → 매장별 현재 수량 / 안전재고 수량을 개별 관리
db/
├── ddl/
│ ├── mainDDL.sql # 내부(Oracle) 테이블·트리거 정의
│ └── outsideDDL.sql # 외부 발주처(MariaDB) 테이블 정의
├── dml/
│ ├── mainDML.sql # 내부 초기 데이터
│ └── outsideDML.sql # 외부 발주처 초기 데이터
└── procedure/
├── procRestockSupplierInventory.sql # 공급처 재고 보충 프로시저
└── setupProductionEvent.sql # 일일 생산 자동화 이벤트 스케줄러
반복되는 상태 변경과 재고 보충 작업을 DB 계층에 위임하여, Java 코드는 핵심 업무 흐름에 집중하도록 설계했습니다.
| 기술 | 역할 | 예시 |
|---|---|---|
| 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) |
- JDK 11 이상
- Oracle Database (XE) 및 MariaDB 로컬 인스턴스
# 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 실행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");# 빌드
./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개 테이블(입점매장 · 상품 · 발주요청 · 발주요청승인 · 외부발주접수 · 매장입고확인)을 조인해야 하는 복잡도를,
중복 컬럼 / 파생 컬럼(예: 차이수량 = 출고수량 - 입고수량)을 선택적으로 추가하여 완화했습니다.
발주 흐름 전반에 걸친 5개 테이블의 상태값을 트리거로 자동 전이시켜 정합성을 확보했습니다.
- 한계: Swing 기반 GUI로 화면 확장성과 비동기 UX에 제약
- 확장: POS 연동, 자동 발주 추천, 동시성 제어, 권한별 감사 로그
- 개선: 화면별 비동기 로딩, 중복 조회 캐싱, 외부 연동 실패 재처리
- 보강: 테스트 코드와 예외 케이스 검증 강화
FutureNet Fullstack — 1차 프로젝트 · 2팀
- 이슈 생성 — 작업 전 GitHub Issue 생성
- PR 생성 — 기능 구현 후 Pull Request 생성
- 코드 리뷰 — 네이밍 · 예외 처리 · SQL · null 처리 검토 (Review Rotation)
- 수정 반영 — 리뷰 코멘트 반영 후 재검토 요청
- Merge — 승인 후
develop브랜치 병합
Review Point: enum 사용 · null 처리 · 공통 유틸 메서드 사용 · 상태값 관리










