From e536e3dfc83bbd7360feaf2f24a5e2aad38ff2fe Mon Sep 17 00:00:00 2001
From: wonho <hyeda2020@gmail.com>
Date: Thu, 23 Oct 2025 17:22:43 +0900
Subject: [PATCH] =?UTF-8?q?CLAUDE.md=EC=97=90=20Lessons=20Learned=20?=
 =?UTF-8?q?=EC=84=B9=EC=85=98=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Spring Boot 설정 관리 가이드 추가
- 개발 워크플로우 핵심 원칙 추가
- 설정 파일 구조 및 환경 변수 관리 방법 명시
- 컴파일 및 서버 시작 프로세스 정리

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CLAUDE.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 069a2c2..54b7a99 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -611,3 +611,20 @@
 - "@develop-help": "개발실행프롬프트 내용을 터미널에 출력"
 - "@deploy-help": "배포실행프롬프트 내용을 터미널에 출력"
 ```
+
+## Lessons Learned 
+
+### Spring Boot 설정 관리
+- **설정 파일 구조**: `application.yml` + IntelliJ 실행 프로파일(`.run/*.run.xml`)로 관리
+- **금지 사항**: `application-{profile}.yml` 같은 프로파일별 설정 파일 생성 금지
+- **환경 변수 관리**: IntelliJ 실행 프로파일의 `<option name="env">` 섹션에서 관리
+- **application.yml 작성**: 환경 변수 플레이스홀더 사용 (`${DB_HOST:default}` 형식)
+- **실행 방법**:
+  - IntelliJ: 실행 프로파일 선택 후 실행 (환경 변수 자동 적용)
+  - 명령줄: 환경 변수 또는 `--args` 옵션으로 전달 (`--spring.profiles.active` 불필요)
+
+### 개발 워크플로우 
+- **❗ 핵심 원칙**: 코드 수정 → 컴파일 → 사람에게 서버 시작 요청 → 테스트
+- **소스 수정**: Spring Boot는 코드 변경 후 반드시 컴파일 + 재시작 필요
+- **컴파일**: 최상위 루트에서 `./gradlew {service-name}:compileJava` 명령 사용
+- **서버 시작**: AI가 직접 서버를 시작하지 말고 반드시 사람에게 요청할것
\ No newline at end of file