feat: jpa, messaging, notification, mongo, graphql 어댑터터 리펙토링

docs/superpowers/packages/graphql/VALIDATION.md

@@ -0,0 +1,98 @@
+# GraphQL Superpowers 문서 정적 검증 결과
+
+- **검증 시각 기준:** 2026-08-12
+- **검증 대상:** 설계서 1개, Stable 구현 계획서 1개, Advanced·Experimental 확장 계획서 1개
+- **검증 명령:** `python3 validate_graphql_docs.py`
+- **결과:** **PASS**
+- **실행 검사:** 1,475
+- **통과:** 1,475
+- **실패:** 0
+
+## 문서 규모
+
+| 문서 | 행 수 | 크기 |
+|---|---:|---:|
+| GraphQL API 실행 플랫폼 설계서 | 2,553 | 93,359 bytes |
+| Stable 구현 계획서 | 4,560 | 209,041 bytes |
+| Advanced 확장 계획서 | 1,976 | 105,717 bytes |
+
+## 계획 구조
+
+| 항목 | Stable | Advanced |
+|---|---:|---:|
+| Task 수 | 48 | 19 |
+| Create 경로 수 | 227 | 113 |
+| Task 번호 연속성 | PASS | PASS |
+| 모든 Task의 `Files`·`Interfaces` | PASS | PASS |
+| 모든 Task의 Implementation Requirements | PASS | PASS |
+| 모든 Task의 Step 1–5 | PASS | PASS |
+| 실패·통과 예상 결과 | PASS | PASS |
+| Task별 Git commit 명령 | PASS | PASS |
+| Create 경로 중복 | 없음 | 없음 |
+| Stable·Advanced 경로 충돌 | 없음 | 없음 |
+
+## 핵심 계약 검증
+
+```text
+SDL-first external contract
+Single Executable Schema Stable default
+HTTP POST Stable profile
+application/graphql-response+json preferred
+Validation 이후 Field Error·Partial Data는 HTTP 200
+Draft 294는 Stable에서 제외
+JPA Entity·MongoDB Document 직접 노출 금지
+GraphQL Multipart Upload 미지원·Fileserver 사용
+request-wide database transaction 금지
+DataLoader request scope
+Finite Fetch Profile
+HMAC-signed cursor
+Mutation idempotency·expected version 분리
+Parser·shape·complexity·runtime response budget
+Actor·Field·Object·Tenant authorization
+Low-cardinality observability
+Stable/Advanced dependency isolation
+Persisted Operation·WebSocket·SSE·Federation 분리
+RSocket·HTTP GET·Incremental Delivery Experimental
+```
+
+위 계약은 설계서와 계획서의 필수 문자열·모듈 경로·Task별 파일·테스트를 대조해 검증했습니다.
+
+## 입력 리서치 추적성
+
+- 첨부된 `GraphQL API 실행 플랫폼 심층 리서치` 원문 전체가 설계서의 `부록 B`에 포함되어 있습니다.
+- 설계 본문은 원문의 용어와 결론을 유지하면서 구현 판단을 Stable·Advanced·Experimental로 고정합니다.
+- 설계서와 입력 원문의 exact text 포함 검사를 별도로 통과했습니다.
+
+## 패키지 검증 항목
+
+```text
+문서 파일 존재
+Markdown code fence 균형
+Task 1–48 / 1–19 연속성
+Task별 테스트·명령·commit
+정확한 Create 경로
+Placeholder 금지
+Stable module에 WebSocket·Federation·Persisted Operation 경로 부재
+Advanced module에 feature flag와 capability 경로 존재
+금지 API pattern 부재
+문서 SHA-256 계산
+```
+
+## 검증 범위의 한계
+
+현재 PASS는 **문서의 정적 구조, 요구사항 추적성, 내부 계약과 실행 계획의 완결성**을 의미합니다. 실제 Backend Skeleton 저장소가 입력으로 제공되지 않았으므로 다음은 실행하지 않았습니다.
+
+```text
+Gradle configuration·compile
+Spring Boot ApplicationContext 기동
+SchemaMappingInspector 실제 결과
+GraphQlTester HTTP·WebFlux contract
+JPA·MongoDB statement/query-count integration
+query bomb·complexity load test
+Virtual Thread·event-loop blocking test
+WebSocket·SSE soak test
+Federation composition·router integration
+actual Git commit
+```
+
+실제 구현에서는 Stable Task 1–48을 먼저 수행해 Stable Release Gate를 통과한 뒤 Advanced Task 1–19를 시작해야 합니다.