33-Auto

🏎️ 33-Auto Organization

현대오토에버 모빌리티 SW 스쿨 3조 프로젝트
자동차 부품 관리 서비스 “삼품관리 (Sampoom Management)” 를 개발하는 조직입니다.

1. Project Overview (프로젝트 개요)

프로젝트 이름: 삼품관리 (Sampoom Management)
프로젝트 설명: 자동차 부품 관리 ERP 시스템

2. Team Members (팀원 및 팀 소개)

추창우	김태민	성현주	양지선	이종진	채상윤

FE	BE	BE	BE	BE	Mobile
GitHub	GitHub	GitHub	GitHub	GitHub	GitHub

📂 Repository Overview

Category	Repository	Description	Visibility
App	Sampoom-Management-Android	삼품관리 안드로이드 앱	🟢 Public
App	Sampoom-Management-iOS	삼품관리 iOS 앱	🟢 Public
Web	Sampoom-Management-Frontend	삼품관리 프론트엔드 웹 서비스	🟢 Public
Backend	Sampoom-Management-Backend-Auth	인증 서비스 API	🟢 Public
	Sampoom-Management-Backend-User	사용자 관리 API	🟢 Public
	Sampoom-Management-Backend-HR	인사 관리 API	🟢 Public
	Sampoom-Management-Backend-Part	부품 관리 API	🟢 Public
	Sampoom-Management-Backend-Order	주문 관리 API	🟢 Public
	Sampoom-Management-Backend-Agency	대리점 관리 API	🟢 Public
	Sampoom-Management-Backend-warehouse	창고 관리 API	🟢 Public
	Sampoom-Management-Backend-Material	자재 관리 API	🟢 Public
	Sampoom-Management-Backend-Factory	공장 관리 API	🟢 Public
Infra / DevOps	Sampoom-Management-Infra	삼품관리 인프라 구성 및 배포 설정	🟢 Public
Template / Utility	template-repository	삼품관리 템플릿 레포지토리	🟢 Public
Test / Misc	test	테스트용	⚪ Mixed
Test / Misc	test1	테스트용	⚪ Mixed
CI/CD	.github	공용 워크플로 및 이슈 템플릿	🟢 Public

3. Key Features (주요 기능)

엔터프라이즈 ERP 통합 비즈니스 프로세스 구현
- 구매, 생산, 창고(WMS), 판매, HR, MDM을 단일 플랫폼에서 통합 운영
- 모듈 간 중복 데이터 제거 및 실시간 데이터 정합성 확보
- 멀티 지점(Multi-Branch) + 조직 기반 업무/권한 분리 시스템 구축
Master Data Management(MDM) 기반 기준정보 표준화
- 제품(Item), BOM, 파트너, 작업장, 라우팅 등 모든 모듈의 공통 기준정보 설계
- MDM을 ERP의 “Ubiquitous Language” 로 정의하여 시스템 전체 데이터 무결성 확보
- 📌 기술 심화 포인트 (이종진 발표)
  - 도메인 언어 기반 설계, 공통 데이터셋 정의, 서비스 간 공유 정책 수립
WMS(입고/적치/재고/출고) 프로세스 자동화
- 창고 물류 흐름 전 과정 표준화 및 재고 실시간 반영
- ROP(재주문점) 기반 자동 재고 보충 요청 시스템 구축
- 📌 기술 심화 포인트 (성현주 발표)
  - 내부 함수 호출 시 @Transactional 미적용 이슈 분석
  - AOP 기반 트랜잭션 원리 이해 및 안전한 서비스 계층 구조 재설계
MPS/MRP 기반 생산 계획 및 공정 실행 기능 구현
- 판매 데이터 기반 생산 계획(MPS) 및 자재 소요량(MRP) 계산 로직 구현
- MES 기반 공정 실행 및 실적 데이터 집계 시스템 구축
데이터 정합성 보장을 위한 Kafka Outbox 패턴 적용
- DB 트랜잭션과 메시징 전송 간 데이터 일관성 문제 해결
- Outbox 테이블 기반 안전한 이벤트 발행 + 재시도 메커니즘 구축
- 📌 기술 심화 포인트 (김태민 발표)
  - 단일 트랜잭션 내 이벤트 저장 후 별도 퍼블리셔가 Kafka 발행
  - 장애 발생 상황에서도 데이터 유실 없는 MSA 이벤트 처리 설계
복잡한 재고/계층형 데이터 조회를 위한 QueryDSL 기반 검색 엔진 구현
- 카테고리 → 그룹 → 부품 구조의 계층형 응답 모델 구성
- 4개 이상 테이블 JOIN, DTO Projection, 동적 조건 검색, Nested 구조 변환 구현
- 📌 기술 심화 포인트 (양지선 발표)
  - 문자열 JPQL 대비 컴파일 타임 검증 + 유지보수성 확보
  - Java Stream 활용 Nested Tree 구조 변환 로직 구축
Android·iOS·Web·Backend 공통 로직 정합성을 위한 Clean Architecture 적용
- UI·Data·Domain 계층 분리 및 플랫폼 독립 비즈니스 로직 유지
- Kotlin & Swift 간 도메인·UseCase·Repository 인터페이스 구조 공유
- 📌 기술 심화 포인트 (채상윤 발표)
  - 플랫폼별 UI/프레임워크 의존성 제거
  - 비즈니스 로직 복제 없이 확장 가능한 구조 설계
웹 프론트엔드 도메인 단위 설계를 위한 Feature-Sliced Design 적용
- 기술 기반 폴더링이 아닌 비즈니스 도메인 기반 UI/로직 분리
- 재사용성, 유지보수성, 확장성 개선을 위한 구조 확립
- 📌 기술 심화 포인트 (추창우 발표)
  - Slice/Segment 기반 의존성 관리 및 사고 구조 정렬
  - 반복 패턴 기반 리팩토링 시점 정의 및 공통 UI 컴포넌트 TDD 적용

4. Tasks & Responsibilities (작업 및 역할 분담)


추창우		팀 리딩 및 커뮤니케이션 프론트엔드 개발
김태민		백엔드 개발 공장 서비스 구매관리 서비스
성현주		백엔드 개발 창고관리 서비스 판매관리 서비스
양지선		백엔드 개발 대리점 서비스 기준정보관리 서비스
이종진		백엔드 개발 인증/인가 인사관리 서비스
채상윤		모바일 개발 Android iOS