프로젝트 구조 ← 주말에 바꿔야해요 (크게바뀜)

**# 2025.12.26 ver.

.github** 
- 이슈 템플릿
- workflows(워크플로우)

**applications**
- api
			- application - user (Facade)
			- interface - api (controller, controllerAdvice, dto, responseMapper)
**config** 
- checkstyle
- eclipse

**cores** 
- domain
			- model (Model, Enum)
			- repository 
			- service
			- exception 
					

**gradle** 
	-wrapper 
	
**modules**
- external
		- config
- jpa
		- config
		- entity (entity, entityMapper)
		- repository

- kafka
	- config (비어있음)
	
- redis
	- config (비어있음)

**supports**
	- jackson
		- config
	- monitoring
		- interceptor (비어있음)
	

디렉토리별 어떤 역할을 하는가

# 2025.12.26 ver. (Refactored)

1. 📂 .github

프로젝트 관리 및 자동화 센터

• ISSUE_TEMPLATE: 깃허브 이슈 탭에서 'New Issue'를 누를 때 나오는 양식들입니다. (버그_리포트.md, 기능_요청.md 등)
• workflows: GitHub Actions의 심장부입니다.
  • 현재: Jira 연동, PR 리뷰어 자동 지정 및 슬랙 알림 (협업 도구 연동).
  • 미래: 코드 푸시 시 자동 테스트(CI), AWS 자동 배포(CD) 파이프라인이 추가될 예정입니다.

2. 📂 applications

애플리케이션의 진입점 & 조율자 (Presentation & Application Layer) (사용자의 요청을 받아서, 적절한 서비스를 호출하고 응답을 주는 곳)

• api
  • application - user (Facade): **"순수 비즈니스 조율자"**입니다.
    • 트랜잭션(@Transactional) 관리.
    • Request DTO → Model 변환만 담당합니다.
    • 중요: 결과값으로 DTO가 아닌 순수 UserModel을 반환합니다. (웹 응답 형태에 대해 전혀 모름)
  • interface - api (Web): **"최전방 창구(표현 계층)"**입니다.
    • controller: HTTP 요청을 받고, Facade가 준 UserModel을 받습니다. 여기서 Mapper를 사용해 UserResponse로 변환하여 응답합니다.
    • dto: UserCreateRequest(입력)와 UserResponse(출력, 구 UserDto)가 위치합니다.
    • mapper: **UserResponseMapper*가 위치합니다. (UserModel ➡️ UserResponse 변환 담당)
    • controllerAdvice: 전역 예외 처리(에러 발생 시 JSON 응답 변환).
    • apiSpec: Swagger 문서화용 인터페이스.

3. 📂 config

개발 환경 표준화 도구

• checkstyle: 코드 스타일 검사 규칙 (예: 들여쓰기는 4칸인가 2칸인가?).
• eclipse: IDE 포맷터 설정 파일. 팀원 간 코드 모양을 통일시켜 줍니다.

4. 📂 cores

비즈니스의 심장 (Domain Layer) (외부 기술(Spring, JPA 등) 없이 순수 Java로만 구성되는 것이 이상적입니다.)

• domain
  • model: **"핵심 데이터 객체"**입니다. 비즈니스 로직을 가진 순수 자바 객체(POJO)와 Enum이 위치합니다. (UserModel, Role 등)
  • repository: **"저장소 인터페이스(설계도)"**입니다. 구현체 없이 "저장은 이렇게 할 거야"라는 약속만 정의합니다. (UserRepository Interface)
  • service: **"순수 비즈니스 로직"**입니다. "비밀번호는 8자 이상이어야 한다" 같은 핵심 규칙을 수행합니다. (UserService)
  • exception: **"도메인 전용 에러"**입니다. 비즈니스 로직에서 발생할 수 있는 명시적인 예외들입니다. (UserNotFoundException, DuplicateEmailException)

5. 📂 gradle