OBP 과금용 gw metric 데이터 추가

CLAUDE.md

@@ -1,6 +1,17 @@
-# CLAUDE.md
+# AI-Assisted Development Guide
 
-이 파일은 Claude Code (claude.ai/code)가 이 저장소의 코드를 작업할 때 참고할 가이드를 제공합니다.
+이 문서는 AI 어시스턴트가 이 저장소의 코드를 이해하고 기여하는 데 필요한 가이드를 제공합니다.
+
+## 프로젝트 주요 특징
+
+AI 어시스턴트가 작업을 시작하기 전에 반드시 이해해야 할 핵심적인 특징들입니다.
+
+- **하이브리드 데이터 액세스**: 이 프로젝트는 **JPA(Hibernate)와 iBATIS를 함께 사용**합니다.
+  - **신규 기능**: 항상 **JPA**와 Spring Data 리포지토리를 사용해야 합니다.
+  - **레거시 코드**: 기존 iBATIS (`*.xml` 매퍼) 코드를 수정할 때는 해당 패턴을 따라야 합니다.
+- **멀티 모듈 Gradle 프로젝트**: `settings.gradle`에 정의된 것처럼 여러 하위 모듈(`elink-online-*`, `kjb-*` 등)로 구성되어 있습니다. 특정 기능은 다른 모듈에 위치할 수 있습니다.
+- **QueryDSL 코드 생성**: 빌드 시 `QueryDSL`을 사용하여 Q-class가 자동으로 생성됩니다. IDE에서 엔티티를 찾을 수 없다고 표시되면, `gradle compileJava`를 먼저 실행하여 코드를 생성해야 합니다.
+- **고객사별 커스터마이징**: `ext.kjb` 또는 `custom` 패키지는 특정 고객사(광주은행)를 위한 코드를 포함하므로, 일반적인 기능 수정 시에는 주의가 필요합니다.
 
 ## 프로젝트 개요
 
@@ -69,6 +80,39 @@ gradle dependencies
 gradle tasks --all
 ```
 
+## 로컬 개발 빠른 시작
+
+새로운 환경에서 프로젝트를 처음 설정하고 실행하는 권장 절차입니다.
+
+1.  **IDE 설정 파일 생성 (최초 1회)**
+    ```bash
+    # IntelliJ IDEA 사용 시
+    gradle idea
+    
+    # Eclipse 사용 시
+    gradle eclipse
+    ```
+
+2.  **QueryDSL 등 소스 코드 생성**
+    ```bash
+    gradle compileJava
+    ```
+
+3.  **전체 빌드 및 테스트 실행**
+    ```bash
+    gradle build
+    ```
+
+4.  **IDE에서 프로젝트 열기**
+    - `gradle idea` 또는 `gradle eclipse` 실행 후, IDE에서 프로젝트를 엽니다.
+
+5.  **실행 구성(Run Configuration) 설정**
+    - 사용하는 WAS(Tomcat 등)에 `eapim-admin` 프로젝트를 배포하도록 설정합니다.
+    - **VM Options**에 위에 명시된 "필수 환경 변수 (Tomcat)"를 모두 추가합니다.
+
+6.  **서버 실행**
+    - IDE에서 설정한 실행 구성을 시작하여 서버를 실행합니다.
+
 ## 아키텍처 및 모듈 의존성
 
 ### 멀티 모듈 구조
@@ -132,6 +176,9 @@ eapim-admin (root project)
 
 ### 필수 환경 변수 (Tomcat)
 
+다음은 로컬 Tomcat 환경에서 개발 시 필요한 시스템 프로퍼티(-D)입니다.
+**설정 방법**: IntelliJ, Eclipse 등 IDE의 실행 구성(Run Configuration)에서 'VM options'에 추가하거나, 사용하는 Tomcat의 `bin` 폴더에 `setenv.bat` (Windows) 또는 `setenv.sh` (Linux/macOS) 파일을 생성하여 아래 내용들을 `CATALINA_OPTS` 또는 `JAVA_OPTS` 환경 변수에 추가합니다.
+
 ```
 -Deai.datasource.type=DEV
 -Dinst.Name=emsSvr99