# 코드 생성 가이드 (QueryDSL Q-class / MapStruct)

## 개요

Eclipse APT(Annotation Processing Tool)를 비활성화하고, **Gradle이 코드 생성을 전담**하도록 설정되어 있습니다.

- **Q-class (QueryDSL)**, **MapStruct 구현체** 모두 Gradle `compileJava` 태스크로 생성됩니다.
- 생성된 파일 위치: `build/generated/java/`
- Eclipse는 `build/generated/java`를 소스 폴더로만 참조합니다 (직접 생성하지 않음).

---

## 코드 재생성이 필요한 경우

| 상황 | 설명 |
|------|------|
| JPA 엔티티 추가 또는 수정 | Q-class 재생성 필요 |
| MapStruct Mapper 인터페이스 추가 또는 수정 | 구현체 재생성 필요 |
| `gradlew clean` 실행 후 | `build/` 디렉토리가 삭제되므로 재생성 필요 |
| 프로젝트 최초 설정 시 | 생성된 파일이 없으므로 반드시 실행 필요 |

---

## 코드 생성 명령어

```bash
# eapim-admin 디렉토리에서 실행
cd D:\eActive\workspaces\elink-djbank\eapim-admin

# Q-class 및 MapStruct 구현체 생성
gradlew.bat compileJava

# 전체 클린 후 재생성
gradlew.bat clean compileJava
```

---

## Eclipse 작업 흐름

1. Java 소스 수정 (엔티티, Mapper 인터페이스 등)
2. `gradlew.bat compileJava` 실행
3. Eclipse에서 프로젝트 선택 후 **Refresh** (`F5`)
4. Eclipse가 `build/generated/java`의 새 파일을 인식하여 에러 해소

---

## 배경 (왜 Gradle로만 생성하는가)

Eclipse APT와 Gradle APT가 동일한 파일을 각자 생성하려 할 때 `FilerException: Source file already created` 오류가 발생합니다.

이를 해결하기 위해 다음과 같이 설정을 변경했습니다:

- `.settings/org.eclipse.jdt.apt.core.prefs`: `aptEnabled=false`
- `.classpath`: `.apt_generated` 소스 폴더 제거, `build/generated/java` 유지
- `.factorypath`: 삭제 (APT 프로세서 등록 해제)