NextErp 프로젝트 백엔드입니다.

💡 1. 서비스 한 줄 요약

NexERP는 중소·중견기업(SME)를 타켓으로, 전사적 자원 통합과 데이터 분석 기능을 제공하는 ERP 프로그램입니다.

---

🔧 2. 기술 스택

분류	스택
Backend	Spring Boot
Database	MySQL
DevOps	GitHub Actions, AWS EC2

---

📁 3. 폴더 구조

com.example.app
├─ domain   // 비즈니스 로직이 기능별로 위치 (유저, 주문 등)               
│  ├─ user            
│  │  ├─ controller
│  │  ├─ service
│  │  ├─ repository
│  │  ├─ model
│  │  │  ├─ entity
│  │  │  ├─ request
│  │  │  └─ response
│  └─ order
│     └─ ... (동일 패턴)
└─ global   // 프로젝트 전반에 걸쳐 사용되는 공통 인프라 및 정책                
   ├─ config            
   ├─ security          
   ├─ exception         
   ├─ handler         
   ├─ common           
   ├─ s3            
   └─ notification    

---

🤝 4. Git 협업 규칙

✅ 4-1. 이슈 타입 분류

타입	설명
[Feature]	새로운 기능 추가
[Refactor]	기능 변화 없는 코드 구조 개선
[Proposal]	협업 개선
[Bug]	발견된 버그 수정 사항
[Help]	도움 요청

✅ 4-2. 커밋 메시지 컨벤션

4-2-1. 커밋 메시지 구조

<타입>: <제목>

본문 내용 (선택)

• 커밋 메시지는 한글로 작성합니다.
• 커밋은 하나의 작업 단위로 구분됩니다.

4-2-2. 커밋 메시지 유형

유형	설명
feature	새로운 기능 추가
refactor	코드 리팩토링 (기능 변화 없이 구조 개선)
fix	일반적인 버그 수정
docs	문서 수정 (README, 주석, 위키 등)
test	테스트 코드 추가
style	코드 포맷팅 (공백, 세미콜론 등 스타일 변경)
chore	기타 관리 작업 (라이브러리 업데이트 등)
comment	주석 추가 및 변경
rename	파일/폴더명 수정 및 위치 이동
remove	파일 삭제
!BREAKING CHANGE	큰 API 변경
!HOTFIX	긴급한 버그 수정

4-2-3. 커밋 메시지 예시

feature: 로그인 API 구현
refactor: UserService 로직 분리

---

🌱 5. Git 브랜치 전략

✅ 5-1. 기본 브랜치

5-1-1. 유형

• main: 실제 운영 배포 브랜치
• dev: 개발 통합 브랜치

5-1-2. 보호 규칙

• main, dev 브랜치에 대한 직접적인 커밋 또는 푸시 금지
• 모든 변경 사항은 반드시 Pull Request(PR)를 통해 코드 리뷰 후 병합
• PR 병합 전에 필수 CI 테스트 통과

✅ 5-2. 작업 브랜치 네이밍 규칙

5-2-1. 브랜치명 구조

<브랜치 유형>/<이슈 번호>/<기능명>

5-2-2. 브랜치명 유형

유형	설명
feature/이슈번호/요약	새로운 기능 추가
refactor/이슈번호/요약	코드 리팩토링 (기능 변화 없이 구조 개선)
fix/이슈번호/요약	일반적인 버그 수정
docs/이슈번호/요약	문서 수정 (README, 주석, 위키 등)
test/이슈번호/요약	테스트 코드 추가
chore/이슈번호/요약	기타 관리 작업 (라이브러리 업데이트 등)
hotfix/이슈번호/요약	긴급한 버그 수정

5-2-3. 브랜치명 예시

chore/1/github-initial-setup
fix/57/image-preview

✅ 5-3. PR 및 이슈 연동 규칙

• PR 생성 시 반드시 관련 이슈를 연결합니다.

ex) 관련 이슈: #3

---