49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
> **보존 안내** — 이 파일은 저장소 루트 `graphql-superpowers-package/` 에 있던 납품 패키지의 README다.
|
||
> 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고,
|
||
> `validate_graphql_docs.py` 와 `MANIFEST.sha256` 은 제거했다.
|
||
> 아래 본문은 납품 시점의 기록이므로 제거된 파일을 가리키는 문장은 더 이상 유효하지 않다.
|
||
|
||
# GraphQL Superpowers 설계 패키지
|
||
|
||
이 패키지는 `GraphQL API 실행 플랫폼 심층 리서치`를 구현 기준선으로 변환한 설계서와 실행 계획서다.
|
||
|
||
## 문서
|
||
|
||
- `docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md`
|
||
- Stable·Advanced 전체 아키텍처, 공개 계약, 경계, 실패 의미론, 테스트와 지원 등급
|
||
- 입력 심층 리서치 원문을 추적 부록으로 포함
|
||
- `docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md`
|
||
- Stable 구현 Task 1–48
|
||
- `docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md`
|
||
- Stable Release Gate 이후 실행하는 Advanced·Experimental Task 1–19
|
||
- `VALIDATION.md`
|
||
- 정적 검증 결과와 검증 범위
|
||
- `validate_graphql_docs.py`
|
||
- 패키지 내부 문서 재검증 스크립트
|
||
- `MANIFEST.sha256`
|
||
- 패키지 파일 무결성 목록
|
||
|
||
## 구현 순서
|
||
|
||
```text
|
||
Stable Task 1–48
|
||
→ Stable Release Gate
|
||
→ Advanced Task 1–19
|
||
→ Capability별 Promotion Gate
|
||
```
|
||
|
||
## 명시적 전제
|
||
|
||
```text
|
||
Java 21
|
||
Gradle Kotlin DSL
|
||
Spring Boot 4.1 BOM
|
||
Spring for GraphQL 2.0
|
||
Boot-managed GraphQL Java v25 계열
|
||
Stable module root: modules/graphql
|
||
Advanced module root: modules/graphql-advanced
|
||
Root package: io.backend.skeleton.graphql
|
||
```
|
||
|
||
실제 저장소에 적용할 때 기존 package·version catalog·module naming에 맞춰 경로만 조정하고, 문서의 공개 계약·불변 조건·테스트 의미는 유지한다.
|