chore: 학습용 코드 외부에 노출되지 않도록 수정

Author: robinjoon

.claude/skills/graphql-schema/SKILL.md

@@ -125,4 +125,4 @@ type Task {
 
 ## 제외 대상
 
-`src/main/resources/schema/learning.graphqls`는 학습용 스키마이므로 이 규칙을 적용하지 않습니다 (수정 금지 코드).
+`src/test/resources/schema/learning.graphqls`는 학습용 스키마이므로 이 규칙을 적용하지 않습니다 (수정 금지 코드, 테스트 전용 classpath).

CLAUDE.md

@@ -27,9 +27,9 @@
 
 다음 경로의 코드는 학습/참고용이므로 **절대 수정하지 않습니다**:
 
-- `src/main/kotlin/kr/io/team/loop/learning/` — DGS GraphQL 학습 예제 코드
+- `src/main/kotlin/kr/io/team/loop/learning/` — DGS GraphQL 학습 예제 코드 (ComponentScan에서 제외되어 엔드포인트 비활성화)
 - `src/test/kotlin/kr/io/team/loop/learning/` — DGS GraphQL 학습 테스트 코드
-- `src/main/resources/schema/learning.graphqls` — 학습용 GraphQL 스키마
+- `src/test/resources/schema/learning.graphqls` — 학습용 GraphQL 스키마 (테스트 전용 classpath, 프로덕션 미포함)
 - `docs/learning/` — 학습 가이드 문서
 - `docs/dgs-graphql-execution.md` — GraphQL 실행 파이프라인 문서
 

docs/graphql-api-documentation-tools.md

@@ -52,7 +52,7 @@ project-root/
 
 ### SpectaQL 설정 (`spectaql/config.yml`)
 
-BC별 스키마가 추가되면 `schemaFile` 목록에 경로를 추가합니다. `learning.graphqls`는 학습용이므로 제외합니다.
+BC별 스키마가 추가되면 `schemaFile` 목록에 경로를 추가합니다. `learning.graphqls`는 학습용이므로 제외합니다 (위치: `src/test/resources/schema/learning.graphqls`).
 
 ### 로컬 실행
 

docs/learning/dgs-graphql-guide.md

@@ -589,7 +589,7 @@ HTTP 응답
 
 | 파일 | 설명 |
 |---|---|
-| `src/main/resources/schema/learning.graphqls` | GraphQL 스키마 정의 (주석 포함) |
+| `src/test/resources/schema/learning.graphqls` | GraphQL 스키마 정의 (주석 포함, 테스트 전용 classpath) |
 | `src/main/kotlin/.../learning/LearningModels.kt` | 도메인 모델 (data class) |
 | `src/main/kotlin/.../learning/ShowDataFetcher.kt` | DataFetcher 구현 (Query, Mutation, 자식 필드) |
 | `src/main/kotlin/.../learning/ShowDataLoader.kt` | DataLoader 구현 (BatchLoader, MappedBatchLoader) |
@@ -600,8 +600,12 @@ HTTP 응답
 ### 실행 방법
 
 1. **테스트 실행**: `./gradlew test --tests "kr.io.team.loop.learning.*"`
-2. **서버 시작 후 GraphiQL**: `./gradlew bootRun` → http://localhost:8080/graphiql
-3. **Codegen 실행**: `./gradlew generateJava`
+2. **Codegen 실행**: `./gradlew generateJava`
+
+> **참고**: 학습용 코드는 프로덕션 엔드포인트에 노출되지 않도록 비활성화되어 있습니다.
+> - `learning.graphqls`는 DGS 스캔 경로(`src/main/resources/schema/`) 밖인 `docs/learning/`에 위치
+> - `learning` 패키지는 `ServerApplication.kt`의 `@ComponentScan` excludeFilter로 빈 등록에서 제외
+> - 테스트는 `@SpringBootTest`로 별도 컨텍스트를 로드하므로 정상 동작
 
 ### 다음 단계
 

src/main/kotlin/kr/io/team/loop/ServerApplication.kt

@@ -2,8 +2,18 @@ package kr.io.team.loop
 
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.runApplication
+import org.springframework.context.annotation.ComponentScan
+import org.springframework.context.annotation.FilterType
 
 @SpringBootApplication
+@ComponentScan(
+    excludeFilters = [
+        ComponentScan.Filter(
+            type = FilterType.REGEX,
+            pattern = ["kr\\.io\\.team\\.loop\\.learning\\..*"],
+        ),
+    ],
+)
 class ServerApplication
 
 fun main(args: Array<String>) {